npm install @tbagtapp/sdk

import { Bag } from "@tbagtapp/sdk";

const bag = new Bag({
  apiKey: process.env.BAG_API_KEY!,
});

const link = await bag.paymentLinks.create({
  name: "Pro Plan",
  amount: 29.99,
  network: "base_sepolia",
});

console.log(link.id);     // "a1b2c3d4-..."
console.log(link.active); // true

const { data, hasMore } = await bag.paymentLinks.list({ limit: 10 });

// Paginate through all links
let cursor: string | undefined;
do {
  const page = await bag.paymentLinks.list({
    limit: 25,
    starting_after: cursor,
  });
  for (const link of page.data) {
    console.log(link.name, link.amount);
  }
  cursor = page.hasMore ? page.data[page.data.length - 1].id : undefined;
} while (cursor);

const link = await bag.paymentLinks.get("a1b2c3d4-e5f6-7890-abcd-ef1234567890");

const updated = await bag.paymentLinks.update("a1b2c3d4-e5f6-7890-abcd-ef1234567890", {
  amount: 39.99,
  active: false,
});

await bag.paymentLinks.delete("a1b2c3d4-e5f6-7890-abcd-ef1234567890");

const { data, hasMore } = await bag.transactions.list({ limit: 50 });

const tx = await bag.transactions.create({
  amount: 29.99,
  token: "USDC",
  network: "base_sepolia",
  txHash: "0xabc123...",
  walletAddress: "0xCustomerWallet",
  customerEmail: "customer@example.com",
  paymentLinkId: "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
});

const quote = await bag.checkout.getTaxQuote({
  paymentLinkId: "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  customerAddress: {
    address_line_1: "100 Main St",
    address_city: "San Francisco",
    address_province: "CA",
    address_postal_code: "94105",
    address_country: "US",
    address_type: "billing",
  },
});

const session = await bag.checkout.createSession({
  linkId: "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  quoteToken: quote.quoteToken,
  walletAddress: "0xCustomerWallet",
  walletType: "evm",
  network: "base_sepolia",
  customer: {
    name: "Jane Doe",
    email: "jane@example.com",
    address: "100 Main St, San Francisco, CA 94105",
    country: "US",
  },
  totalsSnapshot: {
    subtotalCents: quote.subtotalCents,
    taxCents: quote.taxCents,
    totalCents: quote.totalCents,
    calculationId: quote.calculationId,
  },
});

const status = await bag.checkout.getSession("session-uuid");
// status.status is a typed union:
// "payment_session_created" | "txn_broadcast" | "txn_confirming" |
// "txn_finalized" | "complete" | "failed" | "expired" | "manual_retry_needed"

await bag.checkout.submit("session-uuid", "0xabc123...");

const bag = new Bag({
  apiKey: process.env.BAG_API_KEY!,
  maxRetries: 3,  // up to 4 total attempts (default: 2)
});

// Disable retries entirely
const bag2 = new Bag({
  apiKey: process.env.BAG_API_KEY!,
  maxRetries: 0,
});

// Global timeout
const bag = new Bag({
  apiKey: process.env.BAG_API_KEY!,
  timeout: 10_000, // 10 seconds
});

// Per-request override
const link = await bag.paymentLinks.get("link-id", { timeout: 5000 });

// Manual abort
const controller = new AbortController();
setTimeout(() => controller.abort(), 3000);
const links = await bag.paymentLinks.list({}, { signal: controller.signal });

const link = await bag.paymentLinks.create(
  { name: "Pro Plan", amount: 29.99, network: "base" },
  { idempotencyKey: "create-pro-plan-user-123" },
);

import type { PaymentLink, PaginatedList } from "@tbagtapp/sdk";

async function getAllLinks(bag: Bag): Promise<PaymentLink[]> {
  const all: PaymentLink[] = [];
  let cursor: string | undefined;

  do {
    const page: PaginatedList<PaymentLink> = await bag.paymentLinks.list({
      limit: 100,
      starting_after: cursor,
    });
    all.push(...page.data);
    cursor = page.hasMore ? page.data[page.data.length - 1].id : undefined;
  } while (cursor);

  return all;
}

import { Bag, BagError } from "@tbagtapp/sdk";

try {
  await bag.paymentLinks.create({ name: "Test", amount: 0, network: "base" });
} catch (error) {
  if (error instanceof BagError) {
    console.error(`${error.statusCode}: ${error.message}`);
    console.error(`Code: ${error.code}`);
    console.error(`Request ID: ${error.requestId}`);
  }
}

type Network =
  | "base" | "ethereum" | "polygon" | "solana"
  | "base_sepolia" | "eth_sepolia" | "solana_devnet";

type TransactionStatus =
  | "broadcasted" | "pending" | "confirming"
  | "completed" | "failed" | "refunded";

type CheckoutSessionState =
  | "payment_session_created" | "txn_broadcast" | "txn_confirming"
  | "txn_finalized" | "complete" | "failed" | "expired" | "manual_retry_needed";

interface PaginatedList<T> {
  data: T[];
  hasMore: boolean;
}

interface RequestOptions {
  idempotencyKey?: string;
  timeout?: number;
  signal?: AbortSignal;
}