TypeScript SDK

pnpm add @reponseai/sdk
# or
npm install @reponseai/sdk

import { Reponse } from '@reponseai/sdk';

const reponse = new Reponse({
  apiKey: process.env.REPONSE_API_KEY!,
  // Optional overrides
  baseUrl: 'https://api.reponse.ai',   // default
  timeout: 10_000,                       // ms, default 30 000
  retries: 2,                            // auto-retry on 5xx, default 0
});

// List products (paginated)
const { data, meta } = await reponse.catalog.listProducts({
  query: { limit: 10, cursor: 'abc123' },
});

// Get a single product
const { data: product } = await reponse.catalog.getProduct({
  path: { id: 'prod_xxx' },
});

// List collections
const { data: collections } = await reponse.catalog.listCollections();

// Create a cart
const { data: cart } = await reponse.cart.create({
  body: { currency: 'EUR' },
});

// Get a cart
const { data: cart } = await reponse.cart.get({
  path: { id: cartId },
});

// Add item
await reponse.cart.addItem({
  path: { id: cartId },
  body: { variantId: 'var_xxx', quantity: 2 },
});

// Apply promo code
await reponse.cart.applyPromo({
  path: { id: cartId },
  body: { code: 'SAVE10' },
});

// List orders for a customer
const { data: orders } = await reponse.orders.list({
  query: { email: 'buyer@example.com', limit: 5 },
});

// Get order by ID
const { data: order } = await reponse.orders.get({
  path: { id: 'ord_xxx' },
});

// Get balance
const { data: balance } = await reponse.loyalty.getBalance({
  path: { contactId: 'ctc_xxx' },
});

// Redeem points
await reponse.loyalty.redeem({
  path: { contactId: 'ctc_xxx' },
  body: { points: 500, reason: 'checkout' },
});

// Create a support ticket
const { data: ticket } = await reponse.tickets.create({
  body: { subject: 'Missing item', email: 'buyer@example.com' },
});

// List subscriptions
const { data: subs } = await reponse.subscriptions.list({
  query: { status: 'active' },
});

// Delay next shipment
await reponse.subscriptions.manage({
  path: { id: 'sub_xxx' },
  body: { action: 'delay', days: 7 },
});

const { data, meta } = await reponse.catalog.listProducts({
  query: { limit: 20 },
});

console.log(meta.nextCursor);  // pass as `cursor` to fetch the next page
console.log(meta.hasMore);     // boolean

import { ReponseApiError } from '@reponseai/sdk';

try {
  await reponse.cart.get({ path: { id: 'invalid' } });
} catch (err) {
  if (err instanceof ReponseApiError) {
    console.error(err.status);   // 404
    console.error(err.code);     // "CART_NOT_FOUND"
    console.error(err.message);  // "Cart not found"
  }
}