@hasna/connectors 1.3.3 → 1.3.5

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

@@ -1,237 +1,203 @@
-// Scaffold Connector Types
-// Replace CONNECTOR with your API name (e.g., Perplexity, Twitter, etc.)
+// GoDaddy API Types
 
 // ============================================
 // Configuration
 // ============================================
 
-export interface ConnectorConfig {
-  apiKey?: string;      // For API key authentication
-  token?: string;       // Alias for apiKey (some APIs use 'token')
-  apiSecret?: string;   // Optional - some APIs need only a key
-  accessToken?: string; // For OAuth2 authentication
-  baseUrl?: string;     // Override default base URL
+export interface GoDaddyConfig {
+  apiKey: string;
+  apiSecret: string;
+  baseUrl?: string;
 }
 
+export interface CliConfig {
+  apiKey?: string;
+  apiSecret?: string;
+}
+
+// ============================================
+// Common Types
+// ============================================
+
+export type OutputFormat = 'json' | 'pretty';
+
 // ============================================
-// OAuth2 Types
+// Domain Types
 // ============================================
 
-export interface OAuth2Config {
-  clientId: string;
-  clientSecret: string;
-  redirectUri?: string;
+export interface GoDaddyDomain {
+  domain: string;
+  status: string;
+  expires: string;
+  renewAuto: boolean;
+  nameServers: string[];
 }
 
-export interface OAuth2Tokens {
-  accessToken: string;
-  refreshToken?: string;
-  expiresAt: number;
-  tokenType?: string;
-  scope?: string;
+export interface GoDaddyDomainDetail extends GoDaddyDomain {
+  domainId: number;
+  createdAt: string;
+  expirationProtected: boolean;
+  holdRegistrar: boolean;
+  locked: boolean;
+  privacy: boolean;
+  registrarCreatedAt: string;
+  renewDeadline: string;
+  transferProtected: boolean;
+  contactAdmin?: Record<string, unknown>;
+  contactBilling?: Record<string, unknown>;
+  contactRegistrant?: Record<string, unknown>;
+  contactTech?: Record<string, unknown>;
 }
 
 // ============================================
-// Common Types
+// DNS Record Types
 // ============================================
 
-export type OutputFormat = 'json' | 'pretty';
+export type DnsRecordType = 'A' | 'AAAA' | 'CNAME' | 'MX' | 'NS' | 'SOA' | 'SRV' | 'TXT' | 'CAA';
 
-export interface PaginatedResponse<T> {
-  data: T[];
-  nextToken?: string;
-  hasMore: boolean;
+export interface GoDaddyDnsRecord {
+  type: string;
+  name: string;
+  data: string;
+  ttl: number;
+  priority?: number;
 }
 
 // ============================================
-// Example Resource Types
+// Availability Types
 // ============================================
 
-// Replace with your API's resource types
-export interface ExampleResource {
-  id: string;
-  name: string;
-  createdAt: string;
-  updatedAt: string;
-  // Add more fields as needed
+export interface GoDaddyAvailability {
+  available: boolean;
+  domain: string;
+  definitive: boolean;
+  price: number;
+  currency: string;
+  period: number;
 }
 
-export interface ExampleListResponse {
-  items: ExampleResource[];
-  nextPageToken?: string;
-  total?: number;
-}
+// ============================================
+// Renewal Types
+// ============================================
 
-export interface ExampleCreateParams {
-  name: string;
-  // Add more params as needed
+export interface GoDaddyRenewResponse {
+  orderId: number;
+  itemCount: number;
+  total: number;
 }
 
 // ============================================
 // API Error Types
 // ============================================
 
-export interface ApiErrorDetail {
+export interface GoDaddyErrorField {
   code: string;
   message: string;
-  field?: string;
-  resource?: string;
+  path?: string;
 }
 
-export class ConnectorApiError extends Error {
+export class GoDaddyApiError extends Error {
   public readonly statusCode: number;
-  public readonly errors?: ApiErrorDetail[];
-  public readonly documentationUrl?: string;
-  public readonly requestId?: string;
+  public readonly responseBody?: string;
+  public readonly errors?: GoDaddyErrorField[];
 
   constructor(
     message: string,
     statusCode: number,
     options?: {
-      errors?: ApiErrorDetail[];
-      documentationUrl?: string;
-      requestId?: string;
+      responseBody?: string;
+      errors?: GoDaddyErrorField[];
     }
   ) {
     super(message);
-    this.name = 'ConnectorApiError';
+    this.name = 'GoDaddyApiError';
     this.statusCode = statusCode;
+    this.responseBody = options?.responseBody;
     this.errors = options?.errors;
-    this.documentationUrl = options?.documentationUrl;
-    this.requestId = options?.requestId;
   }
 
-  /**
-   * Check if this is a rate limit error
-   */
   isRateLimited(): boolean {
     return this.statusCode === 429;
   }
 
-  /**
-   * Check if this is a server error
-   */
   isServerError(): boolean {
     return this.statusCode >= 500 && this.statusCode < 600;
   }
 
-  /**
-   * Check if this is a client error
-   */
   isClientError(): boolean {
     return this.statusCode >= 400 && this.statusCode < 500;
   }
 
-  /**
-   * Check if this is an authentication error
-   */
   isAuthError(): boolean {
     return this.statusCode === 401 || this.statusCode === 403;
   }
 
-  /**
-   * Check if this is a not found error
-   */
   isNotFound(): boolean {
     return this.statusCode === 404;
   }
 
-  /**
-   * Get a user-friendly error message
-   */
   getUserMessage(): string {
     switch (this.statusCode) {
-      case 400:
-        return 'Bad request. Please check your input.';
       case 401:
-        return 'Authentication failed. Please check your API key or login again.';
+        return 'Authentication failed. Check your GODADDY_API_KEY and GODADDY_API_SECRET.';
       case 403:
-        return 'Access denied. You do not have permission to perform this action.';
+        return 'Access denied. Your API credentials may not have permission for this action.';
       case 404:
-        return 'Resource not found.';
+        return 'Domain or resource not found.';
+      case 422:
+        return 'Validation error. Check your input parameters.';
       case 429:
         return 'Rate limit exceeded. Please wait and try again.';
-      case 500:
-        return 'Server error. Please try again later.';
-      case 502:
-      case 503:
-      case 504:
-        return 'Service temporarily unavailable. Please try again later.';
       default:
         return this.message;
     }
   }
 
-  /**
-   * Convert to JSON for logging/debugging
-   */
   toJSON(): Record<string, unknown> {
     return {
       name: this.name,
       message: this.message,
       statusCode: this.statusCode,
       errors: this.errors,
-      documentationUrl: this.documentationUrl,
-      requestId: this.requestId,
+      responseBody: this.responseBody,
     };
   }
 }
 
 /**
- * Parse an API error response into a ConnectorApiError
- * Handles various common API error response formats
+ * Parse a GoDaddy API error response
  */
 export function parseApiError(
   response: unknown,
   statusCode: number
-): ConnectorApiError {
-  // Handle string responses
+): GoDaddyApiError {
   if (typeof response === 'string') {
-    return new ConnectorApiError(response, statusCode);
+    return new GoDaddyApiError(response, statusCode, { responseBody: response });
   }
 
-  // Handle null/undefined
   if (!response || typeof response !== 'object') {
-    return new ConnectorApiError(`HTTP ${statusCode} Error`, statusCode);
+    return new GoDaddyApiError(`HTTP ${statusCode} Error`, statusCode);
   }
 
   const data = response as Record<string, unknown>;
 
-  // Extract message from various common formats
   const message =
     (data.message as string) ||
     (data.error as string) ||
     ((data.error as Record<string, unknown>)?.message as string) ||
-    (data.error_description as string) ||
-    (data.detail as string) ||
     `HTTP ${statusCode} Error`;
 
-  // Extract errors array if present
-  let errors: ApiErrorDetail[] | undefined;
-  if (Array.isArray(data.errors)) {
-    errors = data.errors.map((e: Record<string, unknown>) => ({
-      code: String(e.code || e.error || 'unknown'),
-      message: String(e.message || e.description || 'Unknown error'),
-      field: e.field as string,
-      resource: e.resource as string,
+  let errors: GoDaddyErrorField[] | undefined;
+  if (Array.isArray(data.fields)) {
+    errors = data.fields.map((f: Record<string, unknown>) => ({
+      code: String(f.code || 'unknown'),
+      message: String(f.message || 'Unknown error'),
+      path: f.path as string,
     }));
   }
 
-  // Extract documentation URL
-  const documentationUrl =
-    (data.documentation_url as string) ||
-    (data.docs_url as string) ||
-    (data.help_url as string);
-
-  // Extract request ID
-  const requestId =
-    (data.request_id as string) ||
-    (data.requestId as string) ||
-    (data.trace_id as string);
-
-  return new ConnectorApiError(message, statusCode, {
+  return new GoDaddyApiError(message, statusCode, {
+    responseBody: JSON.stringify(data),
     errors,
-    documentationUrl,
-    requestId,
   });
 }

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

@@ -1,36 +1,19 @@
 import { existsSync, readFileSync, writeFileSync, mkdirSync, readdirSync, rmSync } from 'fs';
 import { homedir } from 'os';
 import { join } from 'path';
-import type { OAuth2Config, OAuth2Tokens } from '../types';
 
-// TODO: Replace 'connector' with your connector name (e.g., 'connect-perplexity')
-const CONNECTOR_NAME = 'connector';
+const CONNECTOR_NAME = 'connect-godaddy';
 const DEFAULT_PROFILE = 'default';
 
 export interface ProfileConfig {
-  // API Key authentication
   apiKey?: string;
-  token?: string;       // Alias for apiKey
   apiSecret?: string;
-
-  // OAuth2 authentication
-  accessToken?: string;
-  refreshToken?: string;
-  expiresAt?: number;
-  tokenType?: string;
-  scope?: string;
-
-  // OAuth2 client credentials (stored separately for security)
-  clientId?: string;
-  clientSecret?: string;
-
-  // Add more config fields as needed for your API
 }
 
 // Store for --profile flag override (set by CLI before commands run)
 let profileOverride: string | undefined;
 
-// Config directory: ~/.connectors/{connector-name}/
+// Config directory: ~/.connectors/connect-godaddy/
 const CONFIG_DIR = join(homedir(), '.connectors', CONNECTOR_NAME);
 const PROFILES_DIR = join(CONFIG_DIR, 'profiles');
 const CURRENT_PROFILE_FILE = join(CONFIG_DIR, 'current_profile');
@@ -56,9 +39,6 @@ function getProfilePath(profile: string): string {
   return join(PROFILES_DIR, `${profile}.json`);
 }
 
-/**
- * Get the current active profile name
- */
 export function getCurrentProfile(): string {
   if (profileOverride) {
     return profileOverride;
@@ -80,9 +60,6 @@ export function getCurrentProfile(): string {
   return DEFAULT_PROFILE;
 }
 
-/**
- * Set the current active profile
- */
 export function setCurrentProfile(profile: string): void {
   ensureConfigDir();
 
@@ -93,16 +70,10 @@ export function setCurrentProfile(profile: string): void {
   writeFileSync(CURRENT_PROFILE_FILE, profile);
 }
 
-/**
- * Check if a profile exists
- */
 export function profileExists(profile: string): boolean {
   return existsSync(getProfilePath(profile));
 }
 
-/**
- * List all available profiles
- */
 export function listProfiles(): string[] {
   ensureConfigDir();
 
@@ -116,9 +87,6 @@ export function listProfiles(): string[] {
     .sort();
 }
 
-/**
- * Create a new profile
- */
 export function createProfile(profile: string, config: ProfileConfig = {}): boolean {
   ensureConfigDir();
 
@@ -126,7 +94,6 @@ export function createProfile(profile: string, config: ProfileConfig = {}): bool
     return false;
   }
 
-  // Validate profile name
   if (!/^[a-zA-Z0-9_-]+$/.test(profile)) {
     throw new Error('Profile name can only contain letters, numbers, hyphens, and underscores');
   }
@@ -135,9 +102,6 @@ export function createProfile(profile: string, config: ProfileConfig = {}): bool
   return true;
 }
 
-/**
- * Delete a profile
- */
 export function deleteProfile(profile: string): boolean {
   if (profile === DEFAULT_PROFILE) {
     return false;
@@ -147,7 +111,6 @@ export function deleteProfile(profile: string): boolean {
     return false;
   }
 
-  // Switch to default if deleting current profile
   if (getCurrentProfile() === profile) {
     setCurrentProfile(DEFAULT_PROFILE);
   }
@@ -156,9 +119,6 @@ export function deleteProfile(profile: string): boolean {
   return true;
 }
 
-/**
- * Load profile config
- */
 export function loadProfile(profile?: string): ProfileConfig {
   ensureConfigDir();
   const profileName = profile || getCurrentProfile();
@@ -175,9 +135,6 @@ export function loadProfile(profile?: string): ProfileConfig {
   }
 }
 
-/**
- * Save profile config
- */
 export function saveProfile(config: ProfileConfig, profile?: string): void {
   ensureConfigDir();
   const profileName = profile || getCurrentProfile();
@@ -185,12 +142,11 @@ export function saveProfile(config: ProfileConfig, profile?: string): void {
 }
 
 // ============================================
-// API Key Management
-// TODO: Update env var name for your API (e.g., PERPLEXITY_API_KEY)
+// GoDaddy Credentials
 // ============================================
 
 export function getApiKey(): string | undefined {
-  return process.env.CONNECTOR_API_KEY || loadProfile().apiKey;
+  return process.env.GODADDY_API_KEY || loadProfile().apiKey;
 }
 
 export function setApiKey(apiKey: string): void {
@@ -200,7 +156,7 @@ export function setApiKey(apiKey: string): void {
 }
 
 export function getApiSecret(): string | undefined {
-  return process.env.CONNECTOR_API_SECRET || loadProfile().apiSecret;
+  return process.env.GODADDY_API_SECRET || loadProfile().apiSecret;
 }
 
 export function setApiSecret(apiSecret: string): void {
@@ -209,6 +165,17 @@ export function setApiSecret(apiSecret: string): void {
   saveProfile(config);
 }
 
+export function setCredentials(apiKey: string, apiSecret: string): void {
+  const config = loadProfile();
+  config.apiKey = apiKey;
+  config.apiSecret = apiSecret;
+  saveProfile(config);
+}
+
+export function isAuthenticated(): boolean {
+  return !!(getApiKey() && getApiSecret());
+}
+
 // ============================================
 // Utility Functions
 // ============================================
@@ -220,107 +187,3 @@ export function clearConfig(): void {
 export function getConfigDir(): string {
   return CONFIG_DIR;
 }
-
-export function getActiveProfileName(): string {
-  return getCurrentProfile();
-}
-
-// ============================================
-// Token/API Key Alias Functions
-// TODO: Update env var name for your API
-// ============================================
-
-/**
- * Get token (alias for getApiKey - some connectors prefer 'token' naming)
- */
-export function getToken(): string | undefined {
-  return process.env.CONNECTOR_TOKEN || process.env.CONNECTOR_API_KEY || loadProfile().token || loadProfile().apiKey;
-}
-
-/**
- * Set token (alias for setApiKey)
- */
-export function setToken(token: string): void {
-  const config = loadProfile();
-  config.token = token;
-  config.apiKey = token; // Keep both in sync
-  saveProfile(config);
-}
-
-// ============================================
-// OAuth2 Configuration Functions
-// ============================================
-
-/**
- * Get OAuth2 client configuration
- */
-export function getOAuthConfig(): OAuth2Config | null {
-  const profile = loadProfile();
-  if (profile.clientId && profile.clientSecret) {
-    return {
-      clientId: profile.clientId,
-      clientSecret: profile.clientSecret,
-    };
-  }
-  return null;
-}
-
-/**
- * Set OAuth2 client credentials
- */
-export function setOAuthConfig(config: OAuth2Config): void {
-  const profile = loadProfile();
-  profile.clientId = config.clientId;
-  profile.clientSecret = config.clientSecret;
-  saveProfile(profile);
-}
-
-/**
- * Load OAuth2 tokens
- */
-export function loadOAuthTokens(): OAuth2Tokens | null {
-  const profile = loadProfile();
-  if (profile.accessToken) {
-    return {
-      accessToken: profile.accessToken,
-      refreshToken: profile.refreshToken,
-      expiresAt: profile.expiresAt || 0,
-      tokenType: profile.tokenType,
-      scope: profile.scope,
-    };
-  }
-  return null;
-}
-
-/**
- * Save OAuth2 tokens
- */
-export function saveOAuthTokens(tokens: OAuth2Tokens): void {
-  const profile = loadProfile();
-  profile.accessToken = tokens.accessToken;
-  profile.refreshToken = tokens.refreshToken;
-  profile.expiresAt = tokens.expiresAt;
-  profile.tokenType = tokens.tokenType;
-  profile.scope = tokens.scope;
-  saveProfile(profile);
-}
-
-/**
- * Clear OAuth2 tokens (logout)
- */
-export function clearOAuthTokens(): void {
-  const profile = loadProfile();
-  delete profile.accessToken;
-  delete profile.refreshToken;
-  delete profile.expiresAt;
-  delete profile.tokenType;
-  delete profile.scope;
-  saveProfile(profile);
-}
-
-/**
- * Get the access token (for OAuth2 authentication)
- */
-export function getAccessToken(): string | undefined {
-  return loadProfile().accessToken;
-}