Albatross SDK - v0.2.0

albatross sdk - content selection, predictions, and event tracking

comprehensive sdk for integrating albatross apis into any infrastructure. provides type-safe methods for search, recommendations, predictions, event tracking, and catalog management.

key features:

• text, image, and vector-based content search
• personalized recommendations
• content ranking predictions
• event tracking and analytics
• catalog management
• automatic retries with exponential backoff
• runtime validation with zod
• full typescript support

quick start:

import { Client } from 'albatross-sdk';

const client = new Client("your-api-token", "your-tenant-id");

// search for content
const results = await client.search("red shoes", "product-search", {
  limit: 20
});

// get recommendations
const recs = await client.getRecommendations("user-recs", {
  user_id: "user-123",
  session_id: "session-456",
  limit: 10
});

// track events
await client.putEvent({
  eventType: "click",
  payload: { item_id: "product-789" }
});
Copy