Credits

interface GetBalanceResponseDto {
  balance: number;
}

interface GetTransactionsQueryDto {
  page?: number; // default: 1
  limit?: number; // default: 20, max: 100
  startDate?: string; // ISO date string
  endDate?: string; // ISO date string
}

interface CreditTransaction {
  id: string;
  organizationId: string;
  type: 'credit_add' | 'call_charge' | 'sms_charge' | 'adjustment' | 'initial';
  amount: number; // Positive for add, negative for charge
  balanceAfter: number;
  callId: string | null;       // Reference to call for call_charge transactions
  smsProgramId: string | null; // Reference to SMS program for sms_charge transactions
  description: string | null;
  createdBy: string | null;
  createdAt: string;
}

interface GetTransactionsResponseDto {
  data: CreditTransaction[];
  meta: PaginationMeta;
}

// Shared pagination meta (from @lib/shared/pagination)
interface PaginationMeta {
  page: number;
  limit: number;
  total: number;
  totalPages: number;
  hasNextPage: boolean;
  hasPreviousPage: boolean;
}