@hasna/microservices 0.0.4 → 0.0.6

package/microservices/microservice-domains/src/lib/brandsight.ts

@@ -0,0 +1,285 @@
+/**
+ * Brandsight API integration for brand monitoring and threat detection
+ *
+ * Requires environment variable:
+ *   BRANDSIGHT_API_KEY — API key for Brandsight
+ */
+
+// ============================================================
+// Types
+// ============================================================
+
+export interface BrandsightAlert {
+  domain: string;
+  type: "typosquat" | "homoglyph" | "keyword" | "tld_variation";
+  registered_at: string;
+}
+
+export interface BrandMonitorResult {
+  brand: string;
+  alerts: BrandsightAlert[];
+  stub: boolean;
+}
+
+export interface WhoisHistoryEntry {
+  registrant: string;
+  date: string;
+  changes: string[];
+}
+
+export interface WhoisHistoryResult {
+  domain: string;
+  history: WhoisHistoryEntry[];
+  stub: boolean;
+}
+
+export interface ThreatAssessment {
+  domain: string;
+  risk_level: "low" | "medium" | "high" | "critical";
+  threats: string[];
+  recommendation: string;
+  stub: boolean;
+}
+
+export class BrandsightApiError extends Error {
+  constructor(
+    message: string,
+    public statusCode?: number,
+    public responseBody?: string
+  ) {
+    super(message);
+    this.name = "BrandsightApiError";
+  }
+}
+
+// ============================================================
+// Configuration
+// ============================================================
+
+const API_BASE = "https://api.brandsight.com/v1";
+
+export function getApiKey(): string {
+  const key = process.env["BRANDSIGHT_API_KEY"];
+  if (!key) {
+    throw new BrandsightApiError(
+      "BRANDSIGHT_API_KEY environment variable is not set"
+    );
+  }
+  return key;
+}
+
+function getHeaders(apiKey: string): Record<string, string> {
+  return {
+    Authorization: `Bearer ${apiKey}`,
+    "Content-Type": "application/json",
+    Accept: "application/json",
+    "User-Agent": "microservice-domains/0.0.1",
+  };
+}
+
+// ============================================================
+// Internal fetch helper (allows test injection)
+// ============================================================
+
+type FetchFn = typeof globalThis.fetch;
+
+let _fetchFn: FetchFn = globalThis.fetch;
+
+/**
+ * Override the fetch implementation (for testing).
+ * Pass `null` to restore the default.
+ */
+export function _setFetch(fn: FetchFn | null): void {
+  _fetchFn = fn ?? globalThis.fetch;
+}
+
+async function apiRequest<T>(path: string, apiKey: string): Promise<{ data: T; stub: false } | { data: null; stub: true }> {
+  const url = `${API_BASE}${path}`;
+  const headers = getHeaders(apiKey);
+
+  try {
+    const response = await _fetchFn(url, {
+      method: "GET",
+      headers,
+      signal: AbortSignal.timeout(15000),
+    });
+
+    if (!response.ok) {
+      throw new BrandsightApiError(
+        `Brandsight API GET ${path} failed with status ${response.status}`,
+        response.status,
+        await response.text()
+      );
+    }
+
+    const data = (await response.json()) as T;
+    return { data, stub: false };
+  } catch (error) {
+    if (error instanceof BrandsightApiError) throw error;
+    // API unreachable — return stub indicator
+    return { data: null, stub: true };
+  }
+}
+
+// ============================================================
+// Stub Data Generators
+// ============================================================
+
+function generateStubAlerts(brandName: string): BrandsightAlert[] {
+  const now = new Date().toISOString();
+  return [
+    {
+      domain: `${brandName}-deals.com`,
+      type: "keyword",
+      registered_at: now,
+    },
+    {
+      domain: `${brandName.replace(/a/gi, "4").replace(/e/gi, "3")}.com`,
+      type: "homoglyph",
+      registered_at: now,
+    },
+    {
+      domain: `${brandName}s.com`,
+      type: "typosquat",
+      registered_at: now,
+    },
+  ];
+}
+
+function generateStubSimilarDomains(domain: string): string[] {
+  const base = domain.replace(/\.[^.]+$/, "");
+  const tld = domain.slice(base.length);
+  return [
+    `${base}-online${tld}`,
+    `${base}s${tld}`,
+    `${base.replace(/a/gi, "4")}${tld}`,
+    `${base}-app${tld}`,
+    `get${base}${tld}`,
+  ];
+}
+
+function generateStubWhoisHistory(domain: string): WhoisHistoryEntry[] {
+  return [
+    {
+      registrant: "Privacy Proxy Service",
+      date: "2023-01-15T00:00:00Z",
+      changes: ["registrant_changed", "nameserver_changed"],
+    },
+    {
+      registrant: "Original Owner LLC",
+      date: "2020-06-01T00:00:00Z",
+      changes: ["initial_registration"],
+    },
+  ];
+}
+
+function generateStubThreatAssessment(domain: string): Omit<ThreatAssessment, "stub"> {
+  return {
+    domain,
+    risk_level: "low",
+    threats: [],
+    recommendation: "No immediate threats detected. Continue routine monitoring.",
+  };
+}
+
+// ============================================================
+// API Functions
+// ============================================================
+
+/**
+ * Monitor a brand name for new domain registrations that are similar.
+ */
+export async function monitorBrand(brandName: string): Promise<BrandMonitorResult> {
+  const apiKey = getApiKey();
+  const result = await apiRequest<{ alerts: BrandsightAlert[] }>(
+    `/brands/${encodeURIComponent(brandName)}/monitor`,
+    apiKey
+  );
+
+  if (result.stub) {
+    return {
+      brand: brandName,
+      alerts: generateStubAlerts(brandName),
+      stub: true,
+    };
+  }
+
+  return {
+    brand: brandName,
+    alerts: result.data!.alerts,
+    stub: false,
+  };
+}
+
+/**
+ * Find typosquat/competing domains similar to the given domain.
+ */
+export async function getSimilarDomains(domain: string): Promise<{ domain: string; similar: string[]; stub: boolean }> {
+  const apiKey = getApiKey();
+  const result = await apiRequest<{ similar: string[] }>(
+    `/domains/${encodeURIComponent(domain)}/similar`,
+    apiKey
+  );
+
+  if (result.stub) {
+    return {
+      domain,
+      similar: generateStubSimilarDomains(domain),
+      stub: true,
+    };
+  }
+
+  return {
+    domain,
+    similar: result.data!.similar,
+    stub: false,
+  };
+}
+
+/**
+ * Get historical WHOIS records for a domain.
+ */
+export async function getWhoisHistory(domain: string): Promise<WhoisHistoryResult> {
+  const apiKey = getApiKey();
+  const result = await apiRequest<{ history: WhoisHistoryEntry[] }>(
+    `/domains/${encodeURIComponent(domain)}/whois-history`,
+    apiKey
+  );
+
+  if (result.stub) {
+    return {
+      domain,
+      history: generateStubWhoisHistory(domain),
+      stub: true,
+    };
+  }
+
+  return {
+    domain,
+    history: result.data!.history,
+    stub: false,
+  };
+}
+
+/**
+ * Get a threat assessment for a domain.
+ */
+export async function getThreatAssessment(domain: string): Promise<ThreatAssessment> {
+  const apiKey = getApiKey();
+  const result = await apiRequest<Omit<ThreatAssessment, "stub">>(
+    `/domains/${encodeURIComponent(domain)}/threats`,
+    apiKey
+  );
+
+  if (result.stub) {
+    return {
+      ...generateStubThreatAssessment(domain),
+      stub: true,
+    };
+  }
+
+  return {
+    ...result.data!,
+    stub: false,
+  };
+}

package/microservices/microservice-domains/src/lib/godaddy.ts

@@ -0,0 +1,328 @@
+/**
+ * GoDaddy API integration for microservice-domains
+ *
+ * Environment variables:
+ *   GODADDY_API_KEY    — GoDaddy API key
+ *   GODADDY_API_SECRET — GoDaddy API secret
+ */
+
+import type {
+  CreateDomainInput,
+  UpdateDomainInput,
+  Domain,
+} from "../db/domains.js";
+
+// ============================================================
+// Types
+// ============================================================
+
+export interface GoDaddyDomain {
+  domain: string;
+  status: string;
+  expires: string;
+  renewAuto: boolean;
+  nameServers: 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>;
+}
+
+export interface GoDaddyDnsRecord {
+  type: string;
+  name: string;
+  data: string;
+  ttl: number;
+  priority?: number;
+}
+
+export interface GoDaddyAvailability {
+  available: boolean;
+  domain: string;
+  definitive: boolean;
+  price: number;
+  currency: string;
+  period: number;
+}
+
+export interface GoDaddySyncResult {
+  synced: number;
+  created: number;
+  updated: number;
+  errors: string[];
+}
+
+export class GoDaddyApiError extends Error {
+  constructor(
+    message: string,
+    public statusCode: number,
+    public responseBody?: string
+  ) {
+    super(message);
+    this.name = "GoDaddyApiError";
+  }
+}
+
+// ============================================================
+// Configuration
+// ============================================================
+
+const GODADDY_API_BASE = "https://api.godaddy.com";
+
+function getCredentials(): { key: string; secret: string } {
+  const key = process.env["GODADDY_API_KEY"];
+  const secret = process.env["GODADDY_API_SECRET"];
+
+  if (!key || !secret) {
+    throw new Error(
+      "GoDaddy API credentials not configured. Set GODADDY_API_KEY and GODADDY_API_SECRET environment variables."
+    );
+  }
+
+  return { key, secret };
+}
+
+function getHeaders(): Record<string, string> {
+  const { key, secret } = getCredentials();
+  return {
+    Authorization: `sso-key ${key}:${secret}`,
+    "Content-Type": "application/json",
+    Accept: "application/json",
+  };
+}
+
+// ============================================================
+// Internal fetch helper (allows test injection)
+// ============================================================
+
+type FetchFn = typeof globalThis.fetch;
+
+let _fetchFn: FetchFn = globalThis.fetch;
+
+/**
+ * Override the fetch implementation (for testing).
+ * Pass `null` to restore the default.
+ */
+export function _setFetch(fn: FetchFn | null): void {
+  _fetchFn = fn ?? globalThis.fetch;
+}
+
+async function apiRequest<T>(
+  method: string,
+  path: string,
+  body?: unknown
+): Promise<T> {
+  const url = `${GODADDY_API_BASE}${path}`;
+  const headers = getHeaders();
+
+  const options: RequestInit = { method, headers };
+  if (body !== undefined) {
+    options.body = JSON.stringify(body);
+  }
+
+  const response = await _fetchFn(url, options);
+
+  if (!response.ok) {
+    const text = await response.text();
+    throw new GoDaddyApiError(
+      `GoDaddy API ${method} ${path} failed with status ${response.status}: ${text}`,
+      response.status,
+      text
+    );
+  }
+
+  // Some endpoints return 204 No Content
+  if (response.status === 204) {
+    return undefined as unknown as T;
+  }
+
+  return (await response.json()) as T;
+}
+
+// ============================================================
+// API Functions
+// ============================================================
+
+/**
+ * List all domains in the GoDaddy account.
+ */
+export async function listGoDaddyDomains(): Promise<GoDaddyDomain[]> {
+  return apiRequest<GoDaddyDomain[]>("GET", "/v1/domains");
+}
+
+/**
+ * Get detailed info for a single domain.
+ */
+export async function getDomainInfo(
+  domain: string
+): Promise<GoDaddyDomainDetail> {
+  return apiRequest<GoDaddyDomainDetail>(
+    "GET",
+    `/v1/domains/${encodeURIComponent(domain)}`
+  );
+}
+
+/**
+ * Renew a domain for 1 year.
+ */
+export async function renewDomain(
+  domain: string
+): Promise<{ orderId: number; itemCount: number; total: number }> {
+  return apiRequest(
+    "POST",
+    `/v1/domains/${encodeURIComponent(domain)}/renew`,
+    { period: 1 }
+  );
+}
+
+/**
+ * Get DNS records for a domain, optionally filtered by type.
+ */
+export async function getDnsRecords(
+  domain: string,
+  type?: string
+): Promise<GoDaddyDnsRecord[]> {
+  const path = type
+    ? `/v1/domains/${encodeURIComponent(domain)}/records/${encodeURIComponent(type)}`
+    : `/v1/domains/${encodeURIComponent(domain)}/records`;
+  return apiRequest<GoDaddyDnsRecord[]>("GET", path);
+}
+
+/**
+ * Replace all DNS records for a domain.
+ */
+export async function setDnsRecords(
+  domain: string,
+  records: GoDaddyDnsRecord[]
+): Promise<void> {
+  await apiRequest<void>(
+    "PUT",
+    `/v1/domains/${encodeURIComponent(domain)}/records`,
+    records
+  );
+}
+
+/**
+ * Check domain availability for purchase.
+ */
+export async function checkAvailability(
+  domain: string
+): Promise<GoDaddyAvailability> {
+  return apiRequest<GoDaddyAvailability>(
+    "GET",
+    `/v1/domains/available?domain=${encodeURIComponent(domain)}`
+  );
+}
+
+// ============================================================
+// Sync to Local DB
+// ============================================================
+
+/**
+ * Maps GoDaddy status strings to local domain statuses.
+ */
+function mapGoDaddyStatus(
+  gdStatus: string
+): "active" | "expired" | "transferring" | "redemption" {
+  const s = gdStatus.toUpperCase();
+  if (s === "ACTIVE") return "active";
+  if (s === "EXPIRED") return "expired";
+  if (
+    s === "TRANSFERRED_OUT" ||
+    s === "TRANSFERRING" ||
+    s === "PENDING_TRANSFER"
+  )
+    return "transferring";
+  if (s === "REDEMPTION" || s === "PENDING_REDEMPTION") return "redemption";
+  return "active";
+}
+
+/**
+ * Sync all GoDaddy domains into the local database.
+ *
+ * Accepts DB helpers so the caller can inject the actual CRUD functions.
+ */
+export async function syncToLocalDb(dbFns: {
+  getDomainByName: (name: string) => Domain | null;
+  createDomain: (input: CreateDomainInput) => Domain;
+  updateDomain: (id: string, input: UpdateDomainInput) => Domain | null;
+}): Promise<GoDaddySyncResult> {
+  const result: GoDaddySyncResult = {
+    synced: 0,
+    created: 0,
+    updated: 0,
+    errors: [],
+  };
+
+  let gdDomains: GoDaddyDomain[];
+  try {
+    gdDomains = await listGoDaddyDomains();
+  } catch (err) {
+    result.errors.push(
+      `Failed to list domains: ${err instanceof Error ? err.message : String(err)}`
+    );
+    return result;
+  }
+
+  for (const gd of gdDomains) {
+    try {
+      // Fetch full detail for each domain
+      let detail: GoDaddyDomainDetail;
+      try {
+        detail = await getDomainInfo(gd.domain);
+      } catch {
+        // Fall back to list-level data if detail fetch fails
+        detail = gd as GoDaddyDomainDetail;
+      }
+
+      const existing = dbFns.getDomainByName(gd.domain);
+
+      const domainData = {
+        name: gd.domain,
+        registrar: "GoDaddy",
+        status: mapGoDaddyStatus(gd.status),
+        expires_at: gd.expires
+          ? new Date(gd.expires).toISOString()
+          : undefined,
+        auto_renew: gd.renewAuto,
+        nameservers: gd.nameServers || [],
+        registered_at: detail.createdAt
+          ? new Date(detail.createdAt).toISOString()
+          : undefined,
+        metadata: {
+          godaddy_domain_id: (detail as GoDaddyDomainDetail).domainId,
+          provider: "godaddy",
+          locked: (detail as GoDaddyDomainDetail).locked,
+          privacy: (detail as GoDaddyDomainDetail).privacy,
+        },
+      };
+
+      if (existing) {
+        dbFns.updateDomain(existing.id, domainData);
+        result.updated++;
+      } else {
+        dbFns.createDomain(domainData);
+        result.created++;
+      }
+      result.synced++;
+    } catch (err) {
+      result.errors.push(
+        `Failed to sync ${gd.domain}: ${err instanceof Error ? err.message : String(err)}`
+      );
+    }
+  }
+
+  return result;
+}