@hasna/connectors 0.0.1

package/connectors/connect-brandsight/src/index.ts

@@ -0,0 +1,11 @@
+// Brandsight/GoDaddy Domain API Connector
+// A TypeScript wrapper for domain management via the Brandsight/GoDaddy API
+
+export { Brandsight } from './api';
+export * from './types';
+
+// Re-export individual API classes for advanced usage
+export {
+  BrandsightClient,
+  DomainsApi,
+} from './api';

package/connectors/connect-brandsight/src/types/index.ts

@@ -0,0 +1,197 @@
+// Brandsight/GoDaddy Domain API Types
+
+// ============================================
+// Configuration
+// ============================================
+
+export interface BrandsightConfig {
+  apiKey: string;
+  apiSecret: string;
+  customerId?: string;
+  baseUrl?: string;
+}
+
+// ============================================
+// Common Types
+// ============================================
+
+export type OutputFormat = 'json' | 'xml';
+export type OptimizeFor = 'SPEED' | 'ACCURACY';
+export type CheckType = 'REGISTRATION' | 'RENEWAL' | 'TRANSFER';
+
+export interface PaginatedResponse<T> {
+  data: T[];
+  page: number;
+  hasMore: boolean;
+}
+
+// ============================================
+// Domain Availability Types
+// ============================================
+
+export interface DomainAvailabilityParams {
+  domain: string;
+  period?: number; // 1-10 years
+  checkType?: CheckType;
+  optimizeFor?: OptimizeFor;
+}
+
+export interface DomainAvailabilityResponse {
+  available: boolean;
+  domain: string;
+  definitive: boolean;
+  price?: number;
+  currency?: string;
+  period?: number;
+}
+
+export interface BulkAvailabilityResponse {
+  domains: DomainAvailabilityResponse[];
+  errors?: DomainAvailabilityError[];
+}
+
+export interface DomainAvailabilityError {
+  code: string;
+  domain: string;
+  message: string;
+  path: string;
+  status: number;
+}
+
+// ============================================
+// Domain Purchase Types
+// ============================================
+
+export interface Contact {
+  addressMailing: Address;
+  email: string;
+  fax?: string;
+  jobTitle?: string;
+  nameFirst: string;
+  nameLast: string;
+  nameMiddle?: string;
+  organization?: string;
+  phone: string;
+}
+
+export interface Address {
+  address1: string;
+  address2?: string;
+  city: string;
+  country: string;
+  postalCode: string;
+  state: string;
+}
+
+export interface Consent {
+  agreedAt: string;
+  agreedBy: string;
+  agreementKeys: string[];
+}
+
+export interface DomainPurchaseRequest {
+  domain: string;
+  consent: Consent;
+  contactAdmin?: Contact;
+  contactBilling?: Contact;
+  contactRegistrant: Contact;
+  contactTech?: Contact;
+  nameServers?: string[];
+  period?: number;
+  privacy?: boolean;
+  renewAuto?: boolean;
+}
+
+export interface DomainPurchaseResponse {
+  domain: string;
+  orderId: number;
+  itemCount: number;
+  total: number;
+  currency: string;
+}
+
+// ============================================
+// Domain Info Types
+// ============================================
+
+export interface DomainInfo {
+  domain: string;
+  domainId: number;
+  status: string;
+  expires: string;
+  expirationProtected: boolean;
+  holdRegistrar: boolean;
+  locked: boolean;
+  privacy: boolean;
+  renewAuto: boolean;
+  renewable: boolean;
+  transferProtected: boolean;
+  createdAt: string;
+  nameServers: string[];
+  contactAdmin?: Contact;
+  contactBilling?: Contact;
+  contactRegistrant?: Contact;
+  contactTech?: Contact;
+}
+
+// ============================================
+// Agreement Types
+// ============================================
+
+export interface Agreement {
+  agreementKey: string;
+  content: string;
+  title: string;
+  url?: string;
+}
+
+export interface AgreementParams {
+  tlds: string[];
+  privacy?: boolean;
+  forTransfer?: boolean;
+}
+
+// ============================================
+// Action Types
+// ============================================
+
+export interface DomainAction {
+  type: string;
+  status: string;
+  createdAt: string;
+  modifiedAt: string;
+}
+
+// ============================================
+// TLD Suggestions
+// ============================================
+
+export interface TldSuggestion {
+  domain: string;
+  available: boolean;
+  price?: number;
+  currency?: string;
+}
+
+// ============================================
+// API Error Types
+// ============================================
+
+export interface BrandsightError {
+  code: string;
+  message: string;
+  field?: string;
+  path?: string;
+}
+
+export class BrandsightApiError extends Error {
+  public readonly statusCode: number;
+  public readonly errors?: BrandsightError[];
+
+  constructor(message: string, statusCode: number, errors?: BrandsightError[]) {
+    super(message);
+    this.name = 'BrandsightApiError';
+    this.statusCode = statusCode;
+    this.errors = errors;
+  }
+}

package/connectors/connect-brandsight/src/utils/config.ts

@@ -0,0 +1,244 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync, readdirSync, unlinkSync, rmSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+
+export interface ProfileConfig {
+  apiKey?: string;
+  apiSecret?: string;
+  customerId?: string;
+  shopperId?: string;
+}
+
+interface GlobalConfig {
+  activeProfile?: string;
+}
+
+const CONFIG_DIR = join(homedir(), '.connect', 'connect-brandsight');
+const PROFILES_DIR = join(CONFIG_DIR, 'profiles');
+const GLOBAL_CONFIG_FILE = join(CONFIG_DIR, 'config.json');
+const DEFAULT_PROFILE = 'default';
+
+// In-memory profile override for --profile flag
+let profileOverride: string | undefined;
+
+export function ensureConfigDir(): void {
+  if (!existsSync(CONFIG_DIR)) {
+    mkdirSync(CONFIG_DIR, { recursive: true });
+  }
+  if (!existsSync(PROFILES_DIR)) {
+    mkdirSync(PROFILES_DIR, { recursive: true });
+  }
+}
+
+// Slugify profile name for filesystem
+function slugify(name: string): string {
+  return name.toLowerCase().replace(/[^a-z0-9_-]/g, '_');
+}
+
+function getProfilePath(name: string): string {
+  return join(PROFILES_DIR, `${slugify(name)}.json`);
+}
+
+// Global config (active profile)
+function loadGlobalConfig(): GlobalConfig {
+  ensureConfigDir();
+  if (!existsSync(GLOBAL_CONFIG_FILE)) {
+    return {};
+  }
+  try {
+    return JSON.parse(readFileSync(GLOBAL_CONFIG_FILE, 'utf-8'));
+  } catch {
+    return {};
+  }
+}
+
+function saveGlobalConfig(config: GlobalConfig): void {
+  ensureConfigDir();
+  writeFileSync(GLOBAL_CONFIG_FILE, JSON.stringify(config, null, 2));
+}
+
+// Profile management
+export function setProfileOverride(name: string | undefined): void {
+  profileOverride = name;
+}
+
+export function getActiveProfileName(): string {
+  return profileOverride || loadGlobalConfig().activeProfile || DEFAULT_PROFILE;
+}
+
+export function setActiveProfile(name: string): boolean {
+  const profilePath = getProfilePath(name);
+  if (!existsSync(profilePath) && name !== DEFAULT_PROFILE) {
+    return false;
+  }
+  const config = loadGlobalConfig();
+  config.activeProfile = name;
+  saveGlobalConfig(config);
+  return true;
+}
+
+export function loadProfile(name?: string): ProfileConfig {
+  ensureConfigDir();
+  const profileName = name || getActiveProfileName();
+  const profilePath = getProfilePath(profileName);
+
+  if (!existsSync(profilePath)) {
+    return {};
+  }
+
+  try {
+    return JSON.parse(readFileSync(profilePath, 'utf-8'));
+  } catch {
+    return {};
+  }
+}
+
+export function saveProfile(config: ProfileConfig, name?: string): void {
+  ensureConfigDir();
+  const profileName = name || getActiveProfileName();
+  const profilePath = getProfilePath(profileName);
+  writeFileSync(profilePath, JSON.stringify(config, null, 2));
+}
+
+export function createProfile(name: string, config: ProfileConfig = {}): boolean {
+  ensureConfigDir();
+  const profilePath = getProfilePath(name);
+  if (existsSync(profilePath)) {
+    return false; // Already exists
+  }
+  writeFileSync(profilePath, JSON.stringify(config, null, 2));
+  return true;
+}
+
+export function deleteProfile(name: string): boolean {
+  if (name === DEFAULT_PROFILE) {
+    return false; // Can't delete default
+  }
+  const profilePath = getProfilePath(name);
+  if (!existsSync(profilePath)) {
+    return false;
+  }
+  unlinkSync(profilePath);
+
+  // If this was the active profile, switch to default
+  if (getActiveProfileName() === name) {
+    setActiveProfile(DEFAULT_PROFILE);
+  }
+  return true;
+}
+
+export function listProfiles(): string[] {
+  ensureConfigDir();
+  const files = readdirSync(PROFILES_DIR).filter(f => f.endsWith('.json'));
+  return files.map(f => f.replace('.json', ''));
+}
+
+export function profileExists(name: string): boolean {
+  return existsSync(getProfilePath(name));
+}
+
+// Legacy compatibility - load from active profile
+export function loadConfig(): ProfileConfig {
+  return loadProfile();
+}
+
+export function saveConfig(config: ProfileConfig): void {
+  saveProfile(config);
+}
+
+// Getters - use environment variables first, then active profile
+export function getApiKey(): string | undefined {
+  return process.env.BRANDSIGHT_API_KEY || loadProfile().apiKey;
+}
+
+export function getApiSecret(): string | undefined {
+  return process.env.BRANDSIGHT_API_SECRET || loadProfile().apiSecret;
+}
+
+export function getCustomerId(): string | undefined {
+  return process.env.BRANDSIGHT_CUSTOMER_ID || loadProfile().customerId;
+}
+
+export function getShopperId(): string | undefined {
+  return process.env.BRANDSIGHT_SHOPPER_ID || loadProfile().shopperId;
+}
+
+// Setters - save to active profile
+export function setApiKey(apiKey: string): void {
+  const config = loadProfile();
+  config.apiKey = apiKey;
+  saveProfile(config);
+}
+
+export function setApiSecret(apiSecret: string): void {
+  const config = loadProfile();
+  config.apiSecret = apiSecret;
+  saveProfile(config);
+}
+
+export function setCustomerId(customerId: string): void {
+  const config = loadProfile();
+  config.customerId = customerId;
+  saveProfile(config);
+}
+
+export function setShopperId(shopperId: string): void {
+  const config = loadProfile();
+  config.shopperId = shopperId;
+  saveProfile(config);
+}
+
+// Legacy compatibility
+export function getDefaultAccount(): string | undefined {
+  return getActiveProfileName();
+}
+
+export function setDefaultAccount(account: string): void {
+  setActiveProfile(account);
+}
+
+export function clearConfig(): void {
+  saveProfile({});
+}
+
+// ============================================
+// Export/Import Directories
+// ============================================
+
+function getProfileExportsDir(profileName: string): string {
+  return join(PROFILES_DIR, `${slugify(profileName)}_exports`);
+}
+
+function getProfileImportsDir(profileName: string): string {
+  return join(PROFILES_DIR, `${slugify(profileName)}_imports`);
+}
+
+export function getExportsDir(profileName?: string): string {
+  const name = profileName || getActiveProfileName();
+  return getProfileExportsDir(name);
+}
+
+export function getImportsDir(profileName?: string): string {
+  const name = profileName || getActiveProfileName();
+  return getProfileImportsDir(name);
+}
+
+export function ensureExportsDir(profileName?: string): string {
+  const dir = getExportsDir(profileName);
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+  return dir;
+}
+
+export function ensureImportsDir(profileName?: string): string {
+  const dir = getImportsDir(profileName);
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+  return dir;
+}
+
+export function getBaseConfigDir(): string {
+  return CONFIG_DIR;
+}

package/connectors/connect-brandsight/src/utils/contacts.ts

@@ -0,0 +1,204 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync, readdirSync, unlinkSync } from 'fs';
+import { homedir } from 'os';
+import { join, basename } from 'path';
+
+export interface ContactInfo {
+  // Required fields
+  nameFirst: string;
+  nameLast: string;
+  email: string;
+  phone: string; // Format: +1.5551234567
+  address1: string;
+  city: string;
+  state: string;
+  postalCode: string;
+  country: string; // 2-letter code (US, UK, CA, etc.)
+
+  // Optional fields
+  nameMiddle?: string;
+  organization?: string;
+  jobTitle?: string;
+  address2?: string;
+  fax?: string;
+}
+
+export interface StoredContact extends ContactInfo {
+  name: string; // Contact identifier/name
+  createdAt: string;
+  updatedAt: string;
+}
+
+const CONFIG_DIR = join(homedir(), '.connect', 'connect-brandsight');
+const CONTACTS_DIR = join(CONFIG_DIR, 'contacts');
+const DEFAULT_CONTACT_FILE = join(CONFIG_DIR, 'default-contact.txt');
+
+export function ensureContactsDir(): void {
+  if (!existsSync(CONTACTS_DIR)) {
+    mkdirSync(CONTACTS_DIR, { recursive: true });
+  }
+}
+
+function getContactFilePath(name: string): string {
+  // Sanitize name for filesystem
+  const safeName = name.toLowerCase().replace(/[^a-z0-9_-]/g, '_');
+  return join(CONTACTS_DIR, `${safeName}.json`);
+}
+
+export function saveContact(name: string, contact: ContactInfo): StoredContact {
+  ensureContactsDir();
+
+  const filePath = getContactFilePath(name);
+  const now = new Date().toISOString();
+
+  const existing = existsSync(filePath);
+  const storedContact: StoredContact = {
+    ...contact,
+    name,
+    createdAt: existing ? loadContact(name)?.createdAt || now : now,
+    updatedAt: now,
+  };
+
+  writeFileSync(filePath, JSON.stringify(storedContact, null, 2));
+  return storedContact;
+}
+
+export function loadContact(name: string): StoredContact | null {
+  ensureContactsDir();
+
+  const filePath = getContactFilePath(name);
+
+  if (!existsSync(filePath)) {
+    return null;
+  }
+
+  try {
+    const content = readFileSync(filePath, 'utf-8');
+    return JSON.parse(content);
+  } catch {
+    return null;
+  }
+}
+
+export function listContacts(): StoredContact[] {
+  ensureContactsDir();
+
+  const files = readdirSync(CONTACTS_DIR).filter(f => f.endsWith('.json'));
+
+  return files.map(file => {
+    try {
+      const content = readFileSync(join(CONTACTS_DIR, file), 'utf-8');
+      return JSON.parse(content);
+    } catch {
+      return null;
+    }
+  }).filter(Boolean) as StoredContact[];
+}
+
+export function deleteContact(name: string): boolean {
+  ensureContactsDir();
+
+  const filePath = getContactFilePath(name);
+
+  if (!existsSync(filePath)) {
+    return false;
+  }
+
+  unlinkSync(filePath);
+
+  // Clear default if this was the default contact
+  if (getDefaultContactName() === name) {
+    clearDefaultContact();
+  }
+
+  return true;
+}
+
+export function setDefaultContact(name: string): boolean {
+  ensureContactsDir();
+
+  // Verify contact exists
+  if (!loadContact(name)) {
+    return false;
+  }
+
+  writeFileSync(DEFAULT_CONTACT_FILE, name);
+  return true;
+}
+
+export function getDefaultContactName(): string | null {
+  if (!existsSync(DEFAULT_CONTACT_FILE)) {
+    return null;
+  }
+
+  try {
+    return readFileSync(DEFAULT_CONTACT_FILE, 'utf-8').trim() || null;
+  } catch {
+    return null;
+  }
+}
+
+export function getDefaultContact(): StoredContact | null {
+  const name = getDefaultContactName();
+  if (!name) return null;
+  return loadContact(name);
+}
+
+export function clearDefaultContact(): void {
+  if (existsSync(DEFAULT_CONTACT_FILE)) {
+    unlinkSync(DEFAULT_CONTACT_FILE);
+  }
+}
+
+// Convert StoredContact to GoDaddy Contact format
+export function toGoDaddyContact(contact: StoredContact | ContactInfo): {
+  nameFirst: string;
+  nameLast: string;
+  nameMiddle?: string;
+  email: string;
+  phone: string;
+  fax?: string;
+  organization?: string;
+  jobTitle?: string;
+  addressMailing: {
+    address1: string;
+    address2?: string;
+    city: string;
+    state: string;
+    postalCode: string;
+    country: string;
+  };
+} {
+  return {
+    nameFirst: contact.nameFirst,
+    nameLast: contact.nameLast,
+    nameMiddle: contact.nameMiddle,
+    email: contact.email,
+    phone: contact.phone,
+    fax: contact.fax,
+    organization: contact.organization,
+    jobTitle: contact.jobTitle,
+    addressMailing: {
+      address1: contact.address1,
+      address2: contact.address2,
+      city: contact.city,
+      state: contact.state,
+      postalCode: contact.postalCode,
+      country: contact.country,
+    },
+  };
+}
+
+// Validate phone format (+1.5551234567)
+export function validatePhone(phone: string): boolean {
+  return /^\+\d{1,3}\.\d{6,14}$/.test(phone);
+}
+
+// Validate country code (2-letter)
+export function validateCountry(country: string): boolean {
+  return /^[A-Z]{2}$/i.test(country);
+}
+
+// Validate email
+export function validateEmail(email: string): boolean {
+  return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email);
+}