@thisispamela/sdk 1.0.3 → 1.1.0

package/src/index.ts

@@ -3,7 +3,6 @@
  */
 
 import axios, { AxiosInstance, AxiosError } from 'axios';
-import * as crypto from 'crypto';
 import {
   PamelaError,
   AuthenticationError,
@@ -12,68 +11,13 @@ import {
   ValidationError,
   CallError,
 } from './errors';
-
-export interface PamelaClientConfig {
-  apiKey: string;
-  baseUrl?: string;
-}
-
-export interface CreateCallRequest {
-  to: string;
-  country?: string;
-  locale?: string;
-  task: string;
-  instructions?: string;
-  voice?: 'male' | 'female' | 'auto';
-  agent_name?: string;
-  caller_name?: string;
-  end_user_id?: string;
-  metadata?: Record<string, any>;
-  tools?: Array<Record<string, any>>;
-  webhooks?: {
-    webhook_url?: string;
-    tool_webhook_url?: string;
-  };
-}
-
-export interface CallResponse {
-  id: string;
-  status: string;
-  call_session_id: string;
-  created_at: string;
-}
-
-export interface CallStatus {
-  id: string;
-  status: string;
-  to: string;
-  from_: string;  // Backend uses from_ (Python keyword)
-  country: string;
-  created_at: string;
-  started_at?: string;
-  completed_at?: string;
-  duration_seconds?: number;
-  transcript?: Array<Record<string, any>>;
-  summary?: string;
-  metadata: Record<string, any>;
-  end_user_id?: string;  // Marketplace end-user ID for privacy isolation
-}
-
-export interface ToolDefinition {
-  name: string;
-  description: string;
-  input_schema: Record<string, any>;
-  output_schema?: Record<string, any>;
-  timeout_ms?: number;
-}
-
-export interface WebhookPayload {
-  event: string;
-  call_id: string;
-  call_session_id: string;
-  timestamp: string;
-  data: Record<string, any>;
-}
+import type {
+  PamelaClientConfig,
+  CreateCallRequest,
+  CallResponse,
+  CallStatus,
+  ToolDefinition,
+} from './types';
 
 const mapAxiosError = (error: AxiosError, endpoint?: string): PamelaError => {
   const statusCode = error.response?.status;
@@ -225,6 +169,14 @@ export class PamelaClient {
     return response.data;
   }
 
+  /**
+   * Force hangup an in-progress call.
+   */
+  async hangupCall(callId: string): Promise<{ success: boolean; call_id: string; status: string }> {
+    const response = await this.client.post(`/calls/${callId}/hangup`);
+    return response.data;
+  }
+
   /**
    * Register a tool.
    */
@@ -249,25 +201,6 @@ export class PamelaClient {
     return response.data;
   }
 
-  /**
-   * Verify webhook signature.
-   */
-  static verifyWebhookSignature(
-    payload: string | object,
-    signature: string,
-    secret: string
-  ): boolean {
-    const payloadString = typeof payload === 'string' ? payload : JSON.stringify(payload);
-    const expectedSignature = crypto
-      .createHmac('sha256', secret)
-      .update(payloadString)
-      .digest('hex');
-    
-    return crypto.timingSafeEqual(
-      Buffer.from(signature),
-      Buffer.from(expectedSignature)
-    );
-  }
 }
 
 // Export as both default and named export for flexibility
@@ -281,4 +214,6 @@ export {
   ValidationError,
   CallError,
 };
+export * from './types';
+export * from './webhooks';
 

package/src/types.ts

@@ -0,0 +1,126 @@
+export interface PamelaClientConfig {
+  apiKey: string;
+  baseUrl?: string;
+}
+
+export interface CreateCallRequest {
+  to: string;
+  country?: string;
+  locale?: string;
+  task: string;
+  instructions?: string;
+  max_duration_seconds?: number;
+  voice?: 'male' | 'female' | 'auto';
+  agent_name?: string;
+  caller_name?: string;
+  end_user_id?: string;
+  metadata?: Record<string, any>;
+  tools?: Array<Record<string, any>>;
+  webhooks?: {
+    webhook_url?: string;
+    tool_webhook_url?: string;
+  };
+}
+
+export type CallStatusValue =
+  | 'initiating'
+  | 'queued'
+  | 'ringing'
+  | 'in_progress'
+  | 'completed'
+  | 'failed'
+  | 'cancelled'
+  | 'timeout_terminated'
+  | 'in-progress';
+
+export interface CallResponse {
+  id: string;
+  status: CallStatusValue | string;
+  call_session_id: string;
+  created_at: string;
+}
+
+export interface CallStatus {
+  id: string;
+  status: CallStatusValue | string;
+  to: string;
+  from_: string;  // Backend uses from_ (Python keyword)
+  country: string;
+  created_at: string;
+  started_at?: string;
+  completed_at?: string;
+  duration_seconds?: number;
+  max_duration_seconds?: number;
+  transcript?: Array<Record<string, any>>;
+  summary?: string;
+  metadata: Record<string, any>;
+  end_user_id?: string;  // Marketplace end-user ID for privacy isolation
+}
+
+export interface ToolDefinition {
+  name: string;
+  description: string;
+  input_schema: Record<string, any>;
+  output_schema?: Record<string, any>;
+  timeout_ms?: number;
+}
+
+export interface WebhookPayload {
+  event: string;
+  call_id: string;
+  call_session_id: string;
+  timestamp: string;
+  data: Record<string, any>;
+}
+
+/** Standard error codes (aligned with backend models/errors.py) */
+export const ErrorCodes = {
+  // Auth errors (1000-1999)
+  AUTH_REQUIRED: 1001,
+  AUTH_INVALID: 1002,
+  AUTH_EXPIRED: 1003,
+  AUTH_INSUFFICIENT_PERMISSIONS: 1004,
+  AUTH_FORBIDDEN: 1005,
+
+  // Validation errors (2000-2999)
+  VALIDATION_ERROR: 2001,
+  INVALID_PHONE: 2002,
+  INVALID_EMAIL: 2003,
+  INVALID_PASSWORD: 2004,
+  MISSING_REQUIRED_FIELD: 2005,
+  INVALID_JSON: 2006,
+  INVALID_REQUEST_BODY: 2007,
+
+  // Not found errors (3000-3999)
+  NOT_FOUND: 3001,
+  USER_NOT_FOUND: 3002,
+  CONVERSATION_NOT_FOUND: 3003,
+  CALL_SESSION_NOT_FOUND: 3004,
+  RESOURCE_NOT_FOUND: 3005,
+  MESSAGE_NOT_FOUND: 3006,
+
+  // Conflict errors (4000-4999)
+  RESOURCE_ALREADY_EXISTS: 4001,
+  EMAIL_ALREADY_REGISTERED: 4002,
+  ACCOUNT_LINKING_REQUIRED: 4003,
+
+  // Server errors (5000-5999)
+  INTERNAL_ERROR: 5001,
+  EXTERNAL_SERVICE_ERROR: 5002,
+  DATABASE_ERROR: 5003,
+  CONFIGURATION_ERROR: 5004,
+
+  // Rate limiting (6000-6999)
+  RATE_LIMIT_EXCEEDED: 6001,
+  QUOTA_EXCEEDED: 6002,
+
+  // B2B errors (7000-7999)
+  B2B_PARTNER_NOT_FOUND: 7001,
+  B2B_PROJECT_NOT_FOUND: 7002,
+  B2B_CALL_NOT_FOUND: 7003,
+  B2B_NO_PHONE_NUMBER: 7004,
+  B2B_UNSUPPORTED_COUNTRY: 7005,
+  B2B_TOOL_EXECUTION_FAILED: 7006,
+  B2B_WEBHOOK_DELIVERY_FAILED: 7007,
+  SUBSCRIPTION_EXPIRED: 7008,
+} as const;

package/src/webhooks.ts

@@ -0,0 +1,55 @@
+import * as crypto from 'crypto';
+
+export const verifyWebhookSignature = (
+  payload: string | object,
+  signature: string | undefined | null,
+  secret: string
+): boolean => {
+  if (!signature) {
+    return false;
+  }
+
+  if (!secret) {
+    throw new Error('Webhook secret cannot be empty');
+  }
+
+  const payloadString = typeof payload === 'string' ? payload : JSON.stringify(payload);
+  const expectedSignature = crypto
+    .createHmac('sha256', secret)
+    .update(payloadString)
+    .digest('hex');
+
+  return crypto.timingSafeEqual(
+    Buffer.from(signature),
+    Buffer.from(expectedSignature)
+  );
+};
+
+export const parseToolWebhook = (payload: Record<string, any>): {
+  tool_name: string;
+  arguments: Record<string, any>;
+  call_id: string;
+  correlation_id: string;
+  call_session_id?: string;
+  partner_id?: string;
+  project_id?: string;
+} => {
+  const requiredFields = ['tool_name', 'arguments', 'call_id', 'correlation_id'];
+  const missing = requiredFields.filter((field) => !(field in payload));
+
+  if (missing.length > 0) {
+    throw new Error(`Missing required fields: ${missing.join(', ')}`);
+  }
+
+  return {
+    tool_name: String(payload.tool_name),
+    arguments: typeof payload.arguments === 'object' && payload.arguments
+      ? payload.arguments
+      : {},
+    call_id: String(payload.call_id),
+    correlation_id: String(payload.correlation_id),
+    call_session_id: payload.call_session_id,
+    partner_id: payload.partner_id,
+    project_id: payload.project_id,
+  };
+};

package/tsup.config.ts

@@ -0,0 +1,10 @@
+import { defineConfig } from 'tsup';
+
+export default defineConfig({
+  entry: ['src/index.ts', 'src/webhooks.ts', 'src/types.ts', 'src/errors.ts'],
+  format: ['cjs', 'esm'],
+  dts: true,
+  clean: true,
+  sourcemap: true,
+  target: 'es2020',
+});