zyropai 1.0.0

package/src/resources/payouts.ts

@@ -0,0 +1,136 @@
+/**
+ * Mass Payouts resource
+ */
+
+import { APIResource } from './base';
+
+export interface BatchPayoutParams {
+  withdrawals: Array<{
+    address: string;
+    amount: number;
+    currency: string;
+    extra_id?: string;
+    payout_description?: string;
+  }>;
+  verification_code?: string;
+  schedule_for?: string;
+  schedule_timezone?: string;
+  is_recurring?: boolean;
+  recurring_config?: {
+    type: 'daily' | 'weekly' | 'monthly' | 'yearly' | 'custom';
+    interval_days?: number;
+    day_of_week?: number;
+    day_of_month?: number;
+    end_date?: string;
+    max_occurrences?: number;
+  };
+  ipn_callback_url?: string;
+}
+
+export interface BatchResponse {
+  id: string;
+  batch_id: string;
+  total_amount: number;
+  total_withdrawals: number;
+  currency: string;
+  status: string;
+  requires_verification: boolean;
+  verification_attempts_remaining: number;
+  expires_at: string;
+  created_at: string;
+  scheduled_for: string | null;
+}
+
+export interface BatchStatusResponse {
+  batch_id: string;
+  batch_withdrawal_id: string;
+  status: string;
+  total_amount: string;
+  currency: string;
+  total_withdrawals: number;
+  processed: number;
+  successful: number;
+  failed: number;
+  pending: number;
+  created_at: string;
+  updated_at: string;
+  scheduled_for: string | null;
+  payouts: Array<{
+    id: string;
+    address: string;
+    currency: string;
+    amount: string;
+    status: string;
+    hash?: string;
+    error?: string;
+    created_at: string;
+  }>;
+}
+
+export class PayoutsResource extends APIResource {
+  async createBatch(params: BatchPayoutParams): Promise<BatchResponse> {
+    const data: Record<string, any> = {
+      withdrawals: params.withdrawals,
+    };
+
+    if (params.verification_code) data.verification_code = params.verification_code;
+    if (params.schedule_for) data.schedule_for = params.schedule_for;
+    if (params.schedule_timezone) data.schedule_timezone = params.schedule_timezone;
+    if (params.is_recurring) data.is_recurring = params.is_recurring;
+    if (params.recurring_config) data.recurring_config = params.recurring_config;
+    if (params.ipn_callback_url) data.ipn_callback_url = params.ipn_callback_url;
+
+    return this.request('POST', '/payout/batch', data);
+  }
+
+  async getBatchStatus(batchId: string): Promise<BatchStatusResponse> {
+    return this.request('GET', `/payout/batch/${batchId}/status`);
+  }
+
+  async listBatchPayouts(
+    batchId: string,
+    params?: { limit?: number; offset?: number }
+  ): Promise<{
+    batch_id: string;
+    total: number;
+    limit: number;
+    offset: number;
+    payouts: Array<{
+      id: string;
+      address: string;
+      amount: string;
+      currency: string;
+      status: string;
+      tx_hash?: string;
+      created_at: string;
+    }>;
+  }> {
+    const queryParams = new URLSearchParams();
+    if (params?.limit) queryParams.append('limit', String(params.limit));
+    if (params?.offset) queryParams.append('offset', String(params.offset));
+
+    const path = `/payout/batch/${batchId}/payouts${queryParams.toString() ? `?${queryParams.toString()}` : ''}`;
+    return this.request('GET', path);
+  }
+
+  async verifyBatch(batchId: string, verificationCode: string): Promise<{
+    success: boolean;
+    message: string;
+    batch_id: string;
+    status: string;
+    scheduled_for?: string;
+  }> {
+    return this.request('POST', `/payout/batch/${batchId}/verify`, {
+      verification_code: verificationCode,
+    });
+  }
+
+  async cancelBatch(batchId: string): Promise<{ success: boolean; message: string }> {
+    return this.request('POST', `/payout/batch/${batchId}/cancel`);
+  }
+
+  async cancelPayout(payoutId: string): Promise<{ success: boolean; message: string }> {
+    return this.request('POST', `/payout/${payoutId}/cancel`);
+  }
+}
+

package/src/resources/pos.ts

@@ -0,0 +1,90 @@
+/**
+ * POS Terminal resource
+ */
+
+import { APIResource } from './base';
+
+export interface POSMerchantResponse {
+  success: boolean;
+  merchant: {
+    username: string;
+    business_name: string;
+    name: string;
+    avatar?: string;
+    description?: string;
+  };
+  settings: {
+    theme: string;
+    enabled_currencies: string[];
+  };
+  currencies: Array<{
+    id: string;
+    symbol: string;
+    name: string;
+    network: string;
+    icon: string;
+    min_amount: number;
+    is_enabled: boolean;
+    decimals: number;
+  }>;
+  default_currency: string;
+}
+
+export interface POSPaymentResponse {
+  payment_id: string;
+  payment_status: string;
+  pay_address: string;
+  price_amount: number;
+  price_currency: string;
+  pay_amount: number | null;
+  pay_currency: string;
+  created_at: string;
+  expires_at: string;
+  invoice_url: string;
+  platform_fee_amount: number;
+  platform_fee_currency: string;
+  net_amount: number | null;
+}
+
+export interface POSPaymentStatusResponse {
+  payment_id: string;
+  payment_status: string;
+  pay_address: string;
+  price_amount: number;
+  price_currency: string;
+  pay_amount: number | null;
+  pay_currency: string;
+  actually_paid: number;
+  tx_signature?: string;
+  created_at: string;
+  confirmed_at?: string;
+  expires_at: string;
+  platform_fee_amount: number;
+  platform_fee_currency: string;
+}
+
+export class POSResource extends APIResource {
+  async getMerchant(username: string): Promise<POSMerchantResponse> {
+    return this.request('GET', `/pos-terminal/${username}`);
+  }
+
+  async createPayment(params: {
+    username: string;
+    price_amount: number;
+    price_currency?: string;
+    pay_currency?: string;
+  }): Promise<POSPaymentResponse> {
+    const data = {
+      username: params.username,
+      price_amount: params.price_amount,
+      price_currency: params.price_currency || 'USD',
+      pay_currency: params.pay_currency || 'SOL',
+    };
+    return this.request('POST', '/pos-terminal/payment', data);
+  }
+
+  async getPaymentStatus(paymentId: string): Promise<POSPaymentStatusResponse> {
+    return this.request('GET', `/pos-terminal/payment/${paymentId}/status`);
+  }
+}
+

package/src/resources/rates.ts

@@ -0,0 +1,36 @@
+/**
+ * Rates resource
+ */
+
+import { APIResource } from './base';
+
+export class RatesResource extends APIResource {
+  async getAll(): Promise<Record<string, number>> {
+    return this.request('GET', '/rates');
+  }
+
+  async getEstimate(params: {
+    amount: number;
+    currency_from?: string;
+    currency_to?: string;
+  }): Promise<{ estimated_amount: number; currency_from: string; currency_to: string }> {
+    const queryParams = new URLSearchParams({
+      amount: String(params.amount),
+      currency_from: params.currency_from || 'USD',
+      currency_to: params.currency_to || 'USDT',
+    });
+    return this.request('GET', `/estimate?${queryParams.toString()}`);
+  }
+
+  async getMinimumAmount(params?: {
+    currency_from?: string;
+    currency_to?: string;
+  }): Promise<{ currency_from: string; currency_to: string; min_amount: number; fiat_equivalent: number }> {
+    const queryParams = new URLSearchParams({
+      currency_from: params?.currency_from || 'USD',
+      currency_to: params?.currency_to || 'USDT',
+    });
+    return this.request('GET', `/estimate/min-amount?${queryParams.toString()}`);
+  }
+}
+

package/src/resources/status.ts

@@ -0,0 +1,30 @@
+/**
+ * Status resource
+ */
+
+import { APIResource } from './base';
+
+export interface APIStatusResponse {
+  message: string;
+}
+
+export interface RabbitMQStatusResponse {
+  connected: boolean;
+  channel: boolean;
+  consumer_tag: string | null;
+  rabbitmq_url: string;
+  queue_exists?: boolean;
+  queue_messages?: number;
+  queue_consumers?: number;
+  queue_error?: string;
+}
+
+export class StatusResource extends APIResource {
+  async getAPIStatus(): Promise<APIStatusResponse> {
+    return this.request('GET', '/status');
+  }
+
+  async getRabbitMQStatus(): Promise<RabbitMQStatusResponse> {
+    return this.request('GET', '/status/rabbitmq/status');
+  }
+}

package/src/resources/timezones.ts

@@ -0,0 +1,38 @@
+/**
+ * Timezones resource
+ */
+
+import { APIResource } from './base';
+
+export interface Timezone {
+  value: string;
+  label: string;
+  offset: string;
+  full_name: string;
+}
+
+export interface TimezonesResponse {
+  timezones: Timezone[];
+  total: number;
+  default: string;
+}
+
+export interface SearchTimezonesResponse {
+  timezones: Timezone[];
+  total: number;
+  query: string;
+}
+
+export class TimezonesResource extends APIResource {
+  async getCommon(): Promise<TimezonesResponse> {
+    return this.request('GET', '/timezones/common');
+  }
+
+  async getAll(): Promise<TimezonesResponse> {
+    return this.request('GET', '/timezones/all');
+  }
+
+  async search(query: string): Promise<SearchTimezonesResponse> {
+    return this.request('GET', `/timezones/search?q=${encodeURIComponent(query)}`);
+  }
+}

package/src/resources/webhooks.ts

@@ -0,0 +1,28 @@
+/**
+ * Webhooks resource
+ */
+
+import crypto from 'crypto';
+import { APIResource } from './base';
+import { WebhookSignatureError } from '../errors';
+
+export class WebhooksResource extends APIResource {
+  verify(payload: any, signature: string, secret: string): any {
+    // Sort keys alphabetically
+    const sortedPayload = JSON.stringify(payload, Object.keys(payload).sort());
+    
+    // Generate expected signature
+    const expected = crypto
+      .createHmac('sha256', secret)
+      .update(sortedPayload)
+      .digest('hex');
+    
+    // Constant-time comparison
+    if (!crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(signature))) {
+      throw new WebhookSignatureError('Invalid webhook signature');
+    }
+    
+    return payload;
+  }
+}
+

package/src/types.ts

@@ -0,0 +1,79 @@
+/**
+ * Type definitions for ZyroPAI SDK
+ */
+
+export interface ZyroPAIConfig {
+  apiKey?: string;
+  mode?: 'test' | 'live';
+  baseUrl?: string;
+  timeout?: number;
+  maxRetries?: number;
+}
+
+export interface PaymentCreateParams {
+  price_amount: number;
+  price_currency?: string;
+  pay_currency?: string;
+  order_id?: string;
+  order_description?: string;
+  customer_email?: string;
+  ipn_callback_url?: string;
+  success_url?: string;
+  cancel_url?: string;
+  metadata?: Record<string, any>;
+}
+
+export interface PaymentResponse {
+  payment_id: string;
+  payment_status: string;
+  pay_address: string;
+  price_amount: number;
+  price_currency: string;
+  pay_amount: number | null;
+  pay_currency: string;
+  created_at: string;
+  expires_at: string;
+  invoice_url: string;
+  platform_fee_amount?: number;
+  platform_fee_currency?: string;
+  net_amount?: number;
+  platform_fee_percentage?: number;
+}
+
+export interface InvoiceCreateParams {
+  price_amount: number;
+  price_currency?: string;
+  pay_currency?: string;
+  order_id?: string;
+  order_description?: string;
+  customer_email?: string;
+  success_url?: string;
+  cancel_url?: string;
+  metadata?: Record<string, any>;
+}
+
+export interface InvoiceResponse {
+  invoice_id: string;
+  invoice_url: string;
+  payment_id: string;
+  payment_status: string;
+  price_amount: number;
+  price_currency: string;
+  pay_amount: number | null;
+  pay_currency: string;
+  created_at: string;
+  expires_at: string;
+}
+
+export interface CurrenciesListParams {
+  include_rates?: boolean;
+  include_networks?: boolean;
+}
+
+export interface WithdrawalCreateParams {
+  amount: number;
+  currency: string;
+  address: string;
+  network?: string;
+}
+

package/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "nodenext",
+    "moduleResolution": "nodenext",
+    "lib": ["ES2022"],
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "types": ["node", "jest"]
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "tests", "dist", "examples"]
+}