@hasna/connectors 0.6.0 → 0.7.0

package/connectors/connect-wise/src/api/client.ts

@@ -0,0 +1,151 @@
+import type { WiseConfig, OutputFormat } from '../types';
+import { WiseApiError } from '../types';
+
+// Wise API base URLs
+const DEFAULT_BASE_URL = 'https://api.transferwise.com';
+const SANDBOX_BASE_URL = 'https://api.sandbox.transferwise.tech';
+
+export interface RequestOptions {
+  method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+  params?: Record<string, string | number | boolean | undefined>;
+  body?: Record<string, unknown> | unknown[] | string;
+  headers?: Record<string, string>;
+  format?: OutputFormat;
+}
+
+export class WiseClient {
+  private readonly apiKey: string;
+  private readonly baseUrl: string;
+
+  constructor(config: WiseConfig) {
+    if (!config.apiKey) {
+      throw new Error('API key is required');
+    }
+    this.apiKey = config.apiKey;
+    this.baseUrl = config.baseUrl || DEFAULT_BASE_URL;
+  }
+
+  /**
+   * Get the sandbox base URL for testing
+   */
+  static getSandboxUrl(): string {
+    return SANDBOX_BASE_URL;
+  }
+
+  /**
+   * Get the production base URL
+   */
+  static getProductionUrl(): string {
+    return DEFAULT_BASE_URL;
+  }
+
+  private buildUrl(path: string, params?: Record<string, string | number | boolean | undefined>): string {
+    const url = new URL(`${this.baseUrl}${path}`);
+
+    if (params) {
+      Object.entries(params).forEach(([key, value]) => {
+        if (value !== undefined && value !== null && value !== '') {
+          url.searchParams.append(key, String(value));
+        }
+      });
+    }
+
+    return url.toString();
+  }
+
+  /**
+   * Make an authenticated request to the Wise API
+   * Wise uses Bearer token authentication
+   */
+  async request<T>(path: string, options: RequestOptions = {}): Promise<T> {
+    const { method = 'GET', params, body, headers = {} } = options;
+
+    const url = this.buildUrl(path, params);
+
+    // Wise uses Bearer token authentication
+    const requestHeaders: Record<string, string> = {
+      'Authorization': `Bearer ${this.apiKey}`,
+      'Accept': 'application/json',
+      ...headers,
+    };
+
+    if (body && ['POST', 'PUT', 'PATCH'].includes(method)) {
+      requestHeaders['Content-Type'] = 'application/json';
+    }
+
+    const fetchOptions: RequestInit = {
+      method,
+      headers: requestHeaders,
+    };
+
+    if (body && ['POST', 'PUT', 'PATCH'].includes(method)) {
+      fetchOptions.body = typeof body === 'string' ? body : JSON.stringify(body);
+    }
+
+    const response = await fetch(url, fetchOptions);
+
+    // Handle 204 No Content
+    if (response.status === 204) {
+      return {} as T;
+    }
+
+    // Parse response
+    let data: unknown;
+    const contentType = response.headers.get('content-type') || '';
+
+    if (contentType.includes('application/json')) {
+      const text = await response.text();
+      if (text) {
+        try {
+          data = JSON.parse(text);
+        } catch {
+          data = text;
+        }
+      }
+    } else {
+      data = await response.text();
+    }
+
+    // Handle errors
+    if (!response.ok) {
+      const errorData = data as { errors?: Array<{ code: string; message: string }> };
+      throw new WiseApiError(
+        errorData?.errors?.[0]?.message || `Wise API error: ${response.status}`,
+        response.status,
+        errorData?.errors
+      );
+    }
+
+    return data as T;
+  }
+
+  async get<T>(path: string, params?: Record<string, string | number | boolean | undefined>): Promise<T> {
+    return this.request<T>(path, { method: 'GET', params });
+  }
+
+  async post<T>(path: string, body?: Record<string, unknown> | unknown[] | string | object, params?: Record<string, string | number | boolean | undefined>): Promise<T> {
+    return this.request<T>(path, { method: 'POST', body: body as Record<string, unknown>, params });
+  }
+
+  async put<T>(path: string, body?: Record<string, unknown> | object, params?: Record<string, string | number | boolean | undefined>): Promise<T> {
+    return this.request<T>(path, { method: 'PUT', body: body as Record<string, unknown>, params });
+  }
+
+  async patch<T>(path: string, body?: Record<string, unknown> | object, params?: Record<string, string | number | boolean | undefined>): Promise<T> {
+    return this.request<T>(path, { method: 'PATCH', body: body as Record<string, unknown>, params });
+  }
+
+  async delete<T>(path: string, params?: Record<string, string | number | boolean | undefined>): Promise<T> {
+    return this.request<T>(path, { method: 'DELETE', params });
+  }
+
+  /**
+   * Get a preview of the API key (for display/debugging)
+   */
+  getApiKeyPreview(): string {
+    if (this.apiKey.length > 10) {
+      return `${this.apiKey.substring(0, 6)}...${this.apiKey.substring(this.apiKey.length - 4)}`;
+    }
+    return '***';
+  }
+}

package/connectors/connect-wise/src/api/index.ts

@@ -0,0 +1,279 @@
+import type {
+  WiseConfig,
+  WiseProfile,
+  Balance,
+  Quote,
+  CreateQuoteRequest,
+  Recipient,
+  CreateRecipientRequest,
+  Transfer,
+  CreateTransferRequest,
+  FundTransferRequest,
+  ExchangeRate,
+  Currency,
+} from '../types';
+import { WiseClient } from './client';
+
+/**
+ * Wise Connector
+ * International money transfers, multi-currency accounts, and exchange rates
+ */
+export class Wise {
+  private readonly client: WiseClient;
+
+  constructor(config: WiseConfig) {
+    this.client = new WiseClient(config);
+  }
+
+  /**
+   * Create a client from environment variables
+   * Looks for WISE_API_KEY
+   */
+  static fromEnv(): Wise {
+    const apiKey = process.env.WISE_API_KEY;
+    const baseUrl = process.env.WISE_BASE_URL;
+
+    if (!apiKey) {
+      throw new Error('WISE_API_KEY environment variable is required');
+    }
+    return new Wise({ apiKey, baseUrl });
+  }
+
+  /**
+   * Get a preview of the API key (for debugging)
+   */
+  getApiKeyPreview(): string {
+    return this.client.getApiKeyPreview();
+  }
+
+  /**
+   * Get the underlying client for direct API access
+   */
+  getClient(): WiseClient {
+    return this.client;
+  }
+
+  // ============================================
+  // Profiles API
+  // ============================================
+
+  /**
+   * Get all profiles for the authenticated user
+   */
+  async listProfiles(): Promise<WiseProfile[]> {
+    return this.client.get<WiseProfile[]>('/v1/profiles');
+  }
+
+  /**
+   * Get a profile by ID
+   */
+  async getProfile(profileId: number): Promise<WiseProfile> {
+    return this.client.get<WiseProfile>(`/v1/profiles/${profileId}`);
+  }
+
+  // ============================================
+  // Balances API
+  // ============================================
+
+  /**
+   * List all balances for a profile
+   */
+  async listBalances(profileId: number, types?: string[]): Promise<Balance[]> {
+    const params: Record<string, string> = {};
+    if (types && types.length > 0) {
+      params.types = types.join(',');
+    }
+    return this.client.get<Balance[]>(`/v4/profiles/${profileId}/balances`, params);
+  }
+
+  /**
+   * Get a single balance by ID
+   */
+  async getBalance(profileId: number, balanceId: number): Promise<Balance> {
+    return this.client.get<Balance>(`/v4/profiles/${profileId}/balances/${balanceId}`);
+  }
+
+  /**
+   * Get balance by currency
+   */
+  async getBalanceByCurrency(profileId: number, currency: string): Promise<Balance | undefined> {
+    const balances = await this.listBalances(profileId);
+    return balances.find(b => b.currency === currency);
+  }
+
+  // ============================================
+  // Quotes API
+  // ============================================
+
+  /**
+   * Create a quote
+   */
+  async createQuote(profileId: number, quote: CreateQuoteRequest): Promise<Quote> {
+    return this.client.post<Quote>(`/v3/profiles/${profileId}/quotes`, quote);
+  }
+
+  /**
+   * Get a quote by ID
+   */
+  async getQuote(profileId: number, quoteId: string): Promise<Quote> {
+    return this.client.get<Quote>(`/v3/profiles/${profileId}/quotes/${quoteId}`);
+  }
+
+  // ============================================
+  // Recipients (Accounts) API
+  // ============================================
+
+  /**
+   * List all recipients for a profile
+   */
+  async listRecipients(profileId: number, options?: {
+    currency?: string;
+    size?: number;
+    seekPosition?: number;
+  }): Promise<Recipient[]> {
+    const params: Record<string, string | number> = { profile: profileId };
+    if (options?.currency) params.currency = options.currency;
+    if (options?.size) params.size = options.size;
+    if (options?.seekPosition) params.seekPosition = options.seekPosition;
+    return this.client.get<Recipient[]>('/v1/accounts', params);
+  }
+
+  /**
+   * Get a recipient by ID
+   */
+  async getRecipient(recipientId: number): Promise<Recipient> {
+    return this.client.get<Recipient>(`/v1/accounts/${recipientId}`);
+  }
+
+  /**
+   * Create a new recipient
+   */
+  async createRecipient(recipient: CreateRecipientRequest): Promise<Recipient> {
+    return this.client.post<Recipient>('/v1/accounts', recipient);
+  }
+
+  /**
+   * Delete a recipient
+   */
+  async deleteRecipient(recipientId: number): Promise<void> {
+    await this.client.delete<void>(`/v1/accounts/${recipientId}`);
+  }
+
+  /**
+   * Get required fields for a recipient type
+   */
+  async getRecipientRequirements(options: {
+    source: string;
+    target: string;
+    sourceAmount?: number;
+  }): Promise<unknown[]> {
+    return this.client.get<unknown[]>('/v1/account-requirements', options as Record<string, string | number>);
+  }
+
+  // ============================================
+  // Transfers API
+  // ============================================
+
+  /**
+   * List all transfers for a profile
+   */
+  async listTransfers(profileId: number, options?: {
+    offset?: number;
+    limit?: number;
+    status?: string;
+    createdDateStart?: string;
+    createdDateEnd?: string;
+  }): Promise<Transfer[]> {
+    const params: Record<string, string | number> = { profile: profileId };
+    if (options?.offset) params.offset = options.offset;
+    if (options?.limit) params.limit = options.limit;
+    if (options?.status) params.status = options.status;
+    if (options?.createdDateStart) params.createdDateStart = options.createdDateStart;
+    if (options?.createdDateEnd) params.createdDateEnd = options.createdDateEnd;
+    return this.client.get<Transfer[]>('/v1/transfers', params);
+  }
+
+  /**
+   * Get a transfer by ID
+   */
+  async getTransfer(transferId: number): Promise<Transfer> {
+    return this.client.get<Transfer>(`/v1/transfers/${transferId}`);
+  }
+
+  /**
+   * Create a transfer
+   */
+  async createTransfer(transfer: CreateTransferRequest): Promise<Transfer> {
+    return this.client.post<Transfer>('/v1/transfers', transfer);
+  }
+
+  /**
+   * Fund a transfer (pay from balance)
+   */
+  async fundTransfer(profileId: number, transferId: number, options: FundTransferRequest = { type: 'BALANCE' }): Promise<{ status: string; errorCode?: string }> {
+    return this.client.post<{ status: string; errorCode?: string }>(
+      `/v3/profiles/${profileId}/transfers/${transferId}/payments`,
+      options
+    );
+  }
+
+  /**
+   * Cancel a transfer
+   */
+  async cancelTransfer(transferId: number): Promise<Transfer> {
+    return this.client.put<Transfer>(`/v1/transfers/${transferId}/cancel`);
+  }
+
+  /**
+   * Get transfer issues
+   */
+  async getTransferIssues(transferId: number): Promise<unknown[]> {
+    return this.client.get<unknown[]>(`/v1/transfers/${transferId}/issues`);
+  }
+
+  // ============================================
+  // Exchange Rates API
+  // ============================================
+
+  /**
+   * Get live exchange rate
+   */
+  async getExchangeRate(source: string, target: string): Promise<ExchangeRate[]> {
+    return this.client.get<ExchangeRate[]>('/v1/rates', { source, target });
+  }
+
+  /**
+   * Get historical exchange rates
+   */
+  async getHistoricalRates(source: string, target: string, options?: {
+    from?: string;
+    to?: string;
+    group?: 'day' | 'hour' | 'minute';
+  }): Promise<ExchangeRate[]> {
+    const params: Record<string, string> = { source, target };
+    if (options?.from) params.from = options.from;
+    if (options?.to) params.to = options.to;
+    if (options?.group) params.group = options.group;
+    return this.client.get<ExchangeRate[]>('/v1/rates', params);
+  }
+
+  // ============================================
+  // Currencies API
+  // ============================================
+
+  /**
+   * Get available currencies
+   */
+  async listCurrencies(): Promise<Currency[]> {
+    return this.client.get<Currency[]>('/v1/currencies');
+  }
+
+  /**
+   * Get currency pairs for a source currency
+   */
+  async getCurrencyPairs(source: string): Promise<{ sourceCurrency: string; targetCurrency: string }[]> {
+    return this.client.get<{ sourceCurrency: string; targetCurrency: string }[]>('/v1/currency-pairs', { source });
+  }
+}
+
+export { WiseClient } from './client';