TypeScript SDK

npm install @podium-sdk/node-sdk

import { createPodiumClient } from '@podium-sdk/node-sdk'

const client = createPodiumClient({
  apiKey: process.env.PODIUM_API_KEY
})

# Get your key from https://app.podium.build/onboarding
PODIUM_API_KEY=podium_test_sk_your_key_here

const client = createPodiumClient({
  apiKey: process.env.PODIUM_API_KEY,
  baseUrl: 'http://localhost:3030/api/v1'
})

const creatorA = await client.merchant.getBySlug({ slug: 'brand-a' })
const creatorB = await client.merchant.getBySlug({ slug: 'brand-b' })

const products = await client.product.list({ page: 1, limit: 20 })

const creator = await client.merchant.getBySlug({ slug: 'clean-beauty-co' })

const user = await client.user.create({
  requestBody: {
    email: 'user@example.com',
    privyId: 'did:privy:abc123'
  }
})

const balance = await client.user.getPoints({ id: user.id })

const page1 = await client.product.list({ page: 1, limit: 20 })

const page2 = await client.product.list({ page: 2, limit: 20 })

interface PaginatedResponse<T> {
  data: T[];
  pagination: {
    page: number;
    limit: number;
    total: number;
  };
}

async function getAllProducts() {
  const products = []
  let page = 1
  let hasMore = true

  while (hasMore) {
    const result = await client.product.list({ page, limit: 100 })
    products.push(...result.data)
    hasMore = result.data.length === 100
    page++
  }

  return products
}

import { ApiError } from '@podium-sdk/node-sdk'

try {
  const products = await client.product.list({ page: 1 })
} catch (error) {
  if (error instanceof ApiError) {
    console.error(`API Error ${error.status}: ${error.message}`)
    console.error('Response body:', error.body)

    if (error.status === 401) console.log('Invalid API key')
    if (error.status === 429) console.log('Rate limited, retry later')
    if (error.status === 402) console.log('x402 payment required')
  }
}

{
  "status": 422,
  "error": "Validation Error",
  "details": [
    {
      "path": ["email"],
      "message": "Invalid email",
      "code": "invalid_string"
    },
    {
      "path": ["amount"],
      "message": "Expected number, received string",
      "code": "invalid_type"
    }
  ]
}

async function withRetry<T>(
  fn: () => Promise<T>,
  maxRetries = 3,
  baseDelayMs = 1000
): Promise<T> {
  for (let attempt = 0; attempt <= maxRetries; attempt++) {
    try {
      return await fn();
    } catch (error: any) {
      const isRetryable = [429, 500, 502, 503].includes(error.status);
      if (!isRetryable || attempt === maxRetries) throw error;

      const delay = baseDelayMs * Math.pow(2, attempt) + Math.random() * 500;
      await new Promise(r => setTimeout(r, delay));
    }
  }
  throw new Error('Unreachable');
}

const products = await withRetry(() =>
  client.product.list({ page: 1 })
)

X-RateLimit-Limit: 50
X-RateLimit-Remaining: 47
X-RateLimit-Reset: 1709827260

npm install @podium-sdk/node-sdk@latest