@rustrak/client

npm install @rustrak/client
# or
pnpm add @rustrak/client
# or
yarn add @rustrak/client

import { RustrakClient } from '@rustrak/client';
 
const client = new RustrakClient({
  baseUrl: 'https://your-rustrak-instance.example.com',
  token: process.env.RUSTRAK_API_TOKEN!,
});
 
const projects = await client.projects.list();
const { items } = await client.issues.list(1, { sort: 'last_seen', order: 'desc' });
await client.issues.updateState(1, 'issue-id', { is_resolved: true });

const client = new RustrakClient({
  baseUrl: 'https://rustrak.example.com', // required
  token: 'your-bearer-token',             // required — create one in Settings → Tokens
  timeout: 30000,                         // optional, ms (default: 30000)
  maxRetries: 2,                          // optional (default: 2)
  headers: {},                            // optional custom headers
});

const projects = await client.projects.list();
const project  = await client.projects.get(1);
const created  = await client.projects.create({ name: 'My App', slug: 'my-app' });
const updated  = await client.projects.update(1, { name: 'New Name' });
await client.projects.delete(1);

// List with filters
const { items, next_cursor, has_more } = await client.issues.list(projectId, {
  sort: 'last_seen',        // 'digest_order' | 'last_seen'
  order: 'desc',            // 'asc' | 'desc'
  include_resolved: false,
  cursor: 'eyJzb3J0...',    // from previous response
});
 
// Paginate through all issues
let cursor: string | undefined;
do {
  const { items, next_cursor } = await client.issues.list(projectId, { cursor });
  // process items...
  cursor = next_cursor;
} while (cursor);
 
const issue = await client.issues.get(projectId, issueId);
await client.issues.updateState(projectId, issueId, { is_resolved: true });
await client.issues.delete(projectId, issueId);

const { items } = await client.events.list(projectId, issueId, { order: 'desc' });
const event     = await client.events.get(projectId, issueId, eventId);
console.log(event.data); // Full Sentry event payload

const tokens  = await client.tokens.list();
const created = await client.tokens.create({ description: 'CI token' });
console.log(created.token); // Save this — shown only once
await client.tokens.delete(1);

import {
  AuthenticationError,
  NotFoundError,
  RateLimitError,
  NetworkError,
  ValidationError,
} from '@rustrak/client';
 
try {
  await client.projects.list();
} catch (error) {
  if (error instanceof RateLimitError)
    console.log(`Retry after ${error.retryAfter}s`);
  else if (error instanceof AuthenticationError)
    redirect('/login');
  else if (error instanceof NotFoundError)
    console.log('Not found');
  else if (error instanceof NetworkError)
    console.log('Will retry automatically');
  else if (error instanceof ValidationError)
    console.log(error.getValidationDetails());
}

import { RustrakClient } from '@rustrak/client';
 
export default async function ProjectsPage() {
  const client = new RustrakClient({
    baseUrl: process.env.RUSTRAK_API_URL!,
    token: process.env.RUSTRAK_API_TOKEN!,
  });
  const projects = await client.projects.list();
  return <ProjectsList projects={projects} />;
}

'use server';
import { RustrakClient } from '@rustrak/client';
 
export async function resolveIssue(projectId: number, issueId: string) {
  const client = new RustrakClient({
    baseUrl: process.env.RUSTRAK_API_URL!,
    token: process.env.RUSTRAK_API_TOKEN!,
  });
  return client.issues.updateState(projectId, issueId, { is_resolved: true });
}

import type {
  Project,
  Issue,
  Event,
  EventDetail,
  AuthToken,
  PaginatedResponse,
  CreateProject,
  UpdateIssueState,
} from '@rustrak/client';