LiteSOC API

// lsoc.ts - TypeScript SDK wrapper
interface Actor {
  id?: string;
  email?: string;
}

interface TrackEventOptions {
  event: string;
  actor: Actor;
  userIP: string;
  metadata?: Record<string, unknown>;
}

const LSOC_API_KEY = process.env.LSOC_API_KEY!;
const LSOC_ENDPOINT = 'https://litesoc.io/api/v1/collect';

export async function trackEvent({
  event,
  actor,
  userIP,
  metadata = {},
}: TrackEventOptions): Promise<{ status: string; quota: { remaining: number } }> {
  const response = await fetch(LSOC_ENDPOINT, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': LSOC_API_KEY,
    },
    body: JSON.stringify({
      event,
      actor,
      user_ip: userIP,
      metadata,
    }),
  });

  if (!response.ok) {
    throw new Error(`LiteSOC API error: ${response.status}`);
  }

  return response.json();
}

// Extract user IP from headers (works with Express, Fastify, etc.)
export function getUserIP(headers: Record<string, string | string[] | undefined>): string {
  const forwarded = headers['x-forwarded-for'];
  if (forwarded) {
    const ip = Array.isArray(forwarded) ? forwarded[0] : forwarded.split(',')[0];
    return ip.trim();
  }
  
  const realIP = headers['x-real-ip'];
  if (realIP) {
    return Array.isArray(realIP) ? realIP[0] : realIP;
  }
  
  return '127.0.0.1';
}

// Usage example
await trackEvent({
  event: 'auth.login_success',
  actor: { id: 'user_123', email: 'user@example.com' },
  userIP: getUserIP(req.headers),
  metadata: { method: 'oauth', provider: 'google' },
});

{
  "status": "queued",
  "quota": {
    "remaining": 4999,
    "limit": 5000
  }
}