TypeScript SDK

npm install esaalat

import { Esaalat } from 'esaalat';

const client = new Esaalat({
  clientId: 'your-client-id',        // Your Esaalat client ID
  clientSecret: 'your-client-secret', // Your client secret
  baseUrl: 'https://api.esaalat.com', // API base URL (api.sandbox.esaalat.com for sandbox)
  timeout: 30000  // Optional: request timeout in milliseconds
});

// Get all subscriptions
const subscriptions = await client.getSubscriptions();

// Filter for active subscriptions that can receive payments
const activeSubs = subscriptions.filter(s => s.isActive && s.canReceive);

// Use the first active subscription
if (activeSubs.length > 0) {
  const subscriptionId = activeSubs[0].id;
  console.log(`Using: ${activeSubs[0].providerName} - ${activeSubs[0].username}`);
}

// Create an order with multiple items
const orderId = await client.createOrder({
  subscriptionId: 'f7430a9b-76c6-4c52-91c7-0337d8ca9e9c',
  items: [
    {
      name: 'T-Shirt',
      description: 'Premium cotton t-shirt',
      price: 29.99,
      quantity: 2
    },
    {
      name: 'Mug',
      description: 'Coffee mug',
      price: 9.99,
      quantity: 1
    }
  ],
  currency: 'USD'  // "USD" or "YER"
});

console.log(`Order created: ${orderId}`);

import {
  Esaalat,
  ValidationError,
  AuthenticationError,
  OrderNotFoundError,
  APIError
} from 'esaalat';

const client = new Esaalat({
  clientId: 'your-client-id',
  clientSecret: 'your-client-secret',
  baseUrl: 'https://api.esaalat.com' // api.sandbox.esaalat.com for sandbox
});

try {
  const orderId = await client.createOrder({
    subscriptionId: 'invalid-id',
    items: [
      {
        name: 'Product',
        description: 'Description',
        price: -10.50, // Invalid: negative price
        quantity: 1
      }
    ],
    currency: 'USD'
  });
} catch (error) {
  if (error instanceof ValidationError) {
    console.error(`Validation error: ${error.message}`);
    // Handle invalid input
  } else if (error instanceof AuthenticationError) {
    console.error(`Authentication failed: ${error.message}`);
    // Handle auth issues
  } else if (error instanceof OrderNotFoundError) {
    console.error(`Order not found: ${error.message}`);
    // Handle missing order
  } else if (error instanceof APIError) {
    console.error(`API error: ${error.message}`);
    console.error(`Status code: ${error.statusCode}`);
    // Handle API errors
  } else {
    console.error(`Unexpected error: ${error}`);
    // Handle other errors
  }
}

import { Esaalat } from 'esaalat';

// Initialize client
const client = new Esaalat({
  clientId: 'your-client-id',
  clientSecret: 'your-client-secret',
  baseUrl: 'https://api.esaalat.com' // api.sandbox.esaalat.com for sandbox
});

async function processCheckout() {
  // 1. Get active subscriptions
  const subscriptions = await client.getSubscriptions();
  const activeSub = subscriptions.find(s => s.isActive && s.canReceive);

  if (!activeSub) {
    console.log('No active subscriptions available');
    return;
  }

  console.log(`Using subscription: ${activeSub.providerName}`);

  // 2. Create order with shopping cart items
  const cartItems = [
    {
      name: 'Premium T-Shirt',
      description: '100% cotton, size L',
      price: 29.99,
      quantity: 2
    },
    {
      name: 'Coffee Mug',
      description: 'Ceramic mug, 350ml',
      price: 9.99,
      quantity: 1
    }
  ];

  const orderId = await client.createOrder({
    subscriptionId: activeSub.id,
    items: cartItems,
    currency: 'USD'
  });

  console.log(`Order created: ${orderId}`);

  // 3. Check order status
  const order = await client.getOrder(orderId);

  if (order.status === 'COMPLETED') {
    console.log('✓ Payment received!');
    console.log(`Total: ${order.total} ${order.currency}`);
  } else if (order.status === 'PENDING') {
    console.log('⏳ Waiting for payment...');
  } else {
    console.log(`Status: ${order.status}`);
  }
}

processCheckout();