Escalations

async listEscalations(): Promise<Escalation[]>

const list = await limits.listEscalations();
for (const e of list) {
  console.log(e.id, e.status, e.response?.message);
}

async listEscalationsByPolicyId(policyId: string): Promise<Escalation[]>

const byPolicy = await limits.listEscalationsByPolicyId(policyId);

async approveEscalation(escalationId: string): Promise<Escalation>

await limits.approveEscalation(escalationId);

async declineEscalation(escalationId: string): Promise<Escalation>

await limits.declineEscalation(escalationId);

interface Escalation {
  id: string;
  policy_id: string;
  organization_id: string;
  status: 'PENDING' | 'ALLOWED' | 'DECLINED';
  created_at: string;
  updated_at: string;
  request?: any;   // depends on what you sent (e.g. { transaction: { amount: 1000 } })
  response?: {     // policy result at time of escalation
    action: 'ALLOW' | 'BLOCK' | 'ESCALATE';
    message: string;
    success: boolean;
    violated: boolean;
  };
  action_by?: string | null;
}

import { Limits } from '@limits/js';

const limits = new Limits({ apiKey: process.env.LIMITS_API_KEY! });

// Check a policy that might escalate
const result = await limits.check('sensitive-action', {
  amount: 10000,
  currency: 'USD',
});

if (result.isEscalated) {
  console.log('Action escalated, waiting for approval...');

  const escalations = await limits.listEscalations();
  const pending = escalations.find((e) => e.status === 'PENDING');

  if (pending) {
    await limits.approveEscalation(pending.id);
    console.log(`Escalation ${pending.id} has been approved`);
  }
}

import { InvalidInputError, APIRequestError } from '@limits/js';

try {
  await limits.approveEscalation(escalationId);
} catch (error) {
  if (error instanceof InvalidInputError) {
    console.error('Invalid escalation ID');
  } else if (error instanceof APIRequestError) {
    console.error('API error:', error.statusCode, error.message);
  }
}