TypeScript SDK

npm install safefetch

export SAFEFETCH_API_KEY=sf_live_...

import { safeFetch } from "safefetch";

const action = await safeFetch({
  url: "https://api.example.com/send-email",
  method: "POST",
  body: { to: "user@example.com", subject: "Hello" },
});

console.log(action.id);     // act_...
console.log(action.status); // "pending" | "completed" | ...

// Get a single action
const action = await safeFetch.get("act_abc123");

// List recent actions
const { data, total } = await safeFetch.list({ status: "pending", limit: 10 });

// Approve an action waiting for human review
await safeFetch.approve("act_abc123");

// Cancel an action
await safeFetch.cancel("act_abc123");

// Retry a failed action (creates a new action)
const retried = await safeFetch.retry("act_abc123");

import { SafeFetch } from "safefetch";

const sf = new SafeFetch({
  apiKey: process.env.SAFEFETCH_API_KEY!,
  // baseUrl: "https://api.safefetch.dev", // optional override
});

const action = await sf.send({
  url: "https://api.example.com/send-email",
  method: "POST",
  body: { to: "user@example.com" },
});

const action = await safeFetch({
  url: "https://api.example.com/process",
  method: "POST",
  body: { input: "data" },
  sync: true,
  syncTimeout: 60_000, // 60 s
});

// action.status is guaranteed to be "completed" here
console.log(action.response_code); // e.g. 200

const action = await safeFetch({
  url: "https://api.example.com/delete-account",
  method: "DELETE",
  body: { userId: "u_123" },
  approve: true,
});

// action.status === "awaiting_approval"
// Approve later:
await safeFetch.approve(action.id);

import { safeFetch, SafeFetchError } from "safefetch";

try {
  await safeFetch({ url: "https://api.example.com/action", method: "POST" });
} catch (err) {
  if (err instanceof SafeFetchError) {
    console.error(err.message);
    console.error(err.source);       // "target" | "dispatch"
    console.error(err.statusCode);   // HTTP status from SafeFetch API
    console.error(err.errorCode);    // machine-readable code, e.g. "RATE_LIMITED"

    if (err.source === "target") {
      // The target endpoint returned a non-2xx response
      console.error(err.targetResponse?.code);  // target HTTP status
      console.error(err.targetResponse?.body);  // target response body
    }

    // The action object at the time of failure, if available
    console.error(err.action?.id);
  }
}

import type {
  Action,
  ActionStatus,
  SendOptions,
  ListOptions,
  ListResponse,
  SafeFetchOptions,
} from "safefetch";