@rustrak/client 0.3.4 → 0.3.6

package/dist/index.d.cts

@@ -334,7 +334,13 @@ interface ListProjectsOptions {
     order?: SortOrder;
 }
 interface ListTransactionsOptions {
-    cursor?: string;
+    page?: number;
+    per_page?: number;
+    name?: string;
+    op?: string;
+    status?: string;
+    environment?: string;
+    release?: string;
 }
 
 declare const eventSchema: z.ZodObject<{
@@ -583,9 +589,35 @@ declare const transactionDetailSchema: z.ZodObject<{
     ingested_at: z.ZodString;
     data: z.ZodRecord<z.ZodString, z.ZodAny>;
 }, z.core.$strip>;
+declare const spanSchema: z.ZodObject<{
+    id: z.ZodString;
+    span_id: z.ZodNullable<z.ZodString>;
+    trace_id: z.ZodNullable<z.ZodString>;
+    parent_span_id: z.ZodNullable<z.ZodString>;
+    op: z.ZodNullable<z.ZodString>;
+    description: z.ZodNullable<z.ZodString>;
+    status: z.ZodNullable<z.ZodString>;
+    start_timestamp: z.ZodNullable<z.ZodString>;
+    timestamp: z.ZodNullable<z.ZodString>;
+    duration_ms: z.ZodNullable<z.ZodNumber>;
+    exclusive_time_ms: z.ZodNullable<z.ZodNumber>;
+    is_segment: z.ZodBoolean;
+    segment_id: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+declare const transactionStatsSchema: z.ZodObject<{
+    transaction_name: z.ZodString;
+    op: z.ZodNullable<z.ZodString>;
+    count: z.ZodNumber;
+    p50_ms: z.ZodNumber;
+    p95_ms: z.ZodNumber;
+    p99_ms: z.ZodNumber;
+    failure_rate: z.ZodNumber;
+}, z.core.$strip>;
 
 type Transaction = z.infer<typeof transactionSchema>;
 type TransactionDetail = z.infer<typeof transactionDetailSchema>;
+type Span = z.infer<typeof spanSchema>;
+type TransactionStats = z.infer<typeof transactionStatsSchema>;
 
 declare class EventsResource extends BaseResource {
     list(projectId: number, issueId: string, options?: ListEventsOptions): Promise<PaginatedResponse<Event>>;
@@ -651,7 +683,13 @@ declare class TokensResource extends BaseResource {
 }
 
 declare class TransactionsResource extends BaseResource {
-    list(projectId: number, options?: ListTransactionsOptions): Promise<PaginatedResponse<Transaction>>;
+    list(projectId: number, options?: ListTransactionsOptions): Promise<OffsetPaginatedResponse<Transaction>>;
+    getSpans(projectId: number, transactionId: string): Promise<Span[]>;
+    getStats(projectId: number, options?: {
+        page?: number;
+        per_page?: number;
+    }): Promise<OffsetPaginatedResponse<TransactionStats>>;
+    getStatForGroup(projectId: number, name: string, op?: string): Promise<TransactionStats>;
     get(projectId: number, transactionId: string): Promise<TransactionDetail>;
 }
 
@@ -714,4 +752,4 @@ declare class ValidationError extends RustrakError {
     getValidationDetails(): string;
 }
 
-export { type AcceptInvitation, type AlertHistory, type AlertIntegration, type AlertRule, type AlertRuleChannelInput, type AlertStatus, type AlertType, type ApiError, type AssembleInput, type AssembleResponse, type AuthResponse, type AuthToken, type AuthTokenCreated, AuthenticationError, AuthorizationError, BadRequestError, type ChannelType, type ChunkUploadCapability, type ClientConfig, type CreateAlertIntegration, type CreateAlertRule, type CreateAuthToken, type CreateInvitation, type CreateNotificationChannel, type CreateProject, type Event, type EventDetail, type GlobalRole, type Invitation, type InvitationInfo, type Issue, type IssueFilter, type IssueSort, type ListAlertHistoryOptions, type ListEventsOptions, type ListIssuesOptions, type ListProjectsOptions, type ListSourceMapsResponse, type ListTransactionsOptions, type LoginRequest, type LoginResult, NetworkError, NotFoundError, type NotificationChannel, type OffsetPaginatedResponse, type PaginatedResponse, type Project, type ProjectMember, type ProjectRole, type ProviderType, RateLimitError, type RegisterRequest, type ReleaseHealth, type ReleaseHealthRow, type RoutingOverride, RustrakClient, RustrakError, ServerError, type ServerVersion, type SortOrder, type SourceMapFile, type TeamMember, type TestChannelResponse, type TestIntegrationBody, type Transaction, type TransactionDetail, type UpdateAlertIntegration, type UpdateAlertRule, type UpdateIssueState, type UpdateNotificationChannel, type UpdateProject, type UpdateUserRole, type UpsertProjectMember, type User, ValidationError };
+export { type AcceptInvitation, type AlertHistory, type AlertIntegration, type AlertRule, type AlertRuleChannelInput, type AlertStatus, type AlertType, type ApiError, type AssembleInput, type AssembleResponse, type AuthResponse, type AuthToken, type AuthTokenCreated, AuthenticationError, AuthorizationError, BadRequestError, type ChannelType, type ChunkUploadCapability, type ClientConfig, type CreateAlertIntegration, type CreateAlertRule, type CreateAuthToken, type CreateInvitation, type CreateNotificationChannel, type CreateProject, type Event, type EventDetail, type GlobalRole, type Invitation, type InvitationInfo, type Issue, type IssueFilter, type IssueSort, type ListAlertHistoryOptions, type ListEventsOptions, type ListIssuesOptions, type ListProjectsOptions, type ListSourceMapsResponse, type ListTransactionsOptions, type LoginRequest, type LoginResult, NetworkError, NotFoundError, type NotificationChannel, type OffsetPaginatedResponse, type PaginatedResponse, type Project, type ProjectMember, type ProjectRole, type ProviderType, RateLimitError, type RegisterRequest, type ReleaseHealth, type ReleaseHealthRow, type RoutingOverride, RustrakClient, RustrakError, ServerError, type ServerVersion, type SortOrder, type SourceMapFile, type Span, type TeamMember, type TestChannelResponse, type TestIntegrationBody, type Transaction, type TransactionDetail, type TransactionStats, type UpdateAlertIntegration, type UpdateAlertRule, type UpdateIssueState, type UpdateNotificationChannel, type UpdateProject, type UpdateUserRole, type UpsertProjectMember, type User, ValidationError };

package/dist/index.d.ts

@@ -334,7 +334,13 @@ interface ListProjectsOptions {
     order?: SortOrder;
 }
 interface ListTransactionsOptions {
-    cursor?: string;
+    page?: number;
+    per_page?: number;
+    name?: string;
+    op?: string;
+    status?: string;
+    environment?: string;
+    release?: string;
 }
 
 declare const eventSchema: z.ZodObject<{
@@ -583,9 +589,35 @@ declare const transactionDetailSchema: z.ZodObject<{
     ingested_at: z.ZodString;
     data: z.ZodRecord<z.ZodString, z.ZodAny>;
 }, z.core.$strip>;
+declare const spanSchema: z.ZodObject<{
+    id: z.ZodString;
+    span_id: z.ZodNullable<z.ZodString>;
+    trace_id: z.ZodNullable<z.ZodString>;
+    parent_span_id: z.ZodNullable<z.ZodString>;
+    op: z.ZodNullable<z.ZodString>;
+    description: z.ZodNullable<z.ZodString>;
+    status: z.ZodNullable<z.ZodString>;
+    start_timestamp: z.ZodNullable<z.ZodString>;
+    timestamp: z.ZodNullable<z.ZodString>;
+    duration_ms: z.ZodNullable<z.ZodNumber>;
+    exclusive_time_ms: z.ZodNullable<z.ZodNumber>;
+    is_segment: z.ZodBoolean;
+    segment_id: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+declare const transactionStatsSchema: z.ZodObject<{
+    transaction_name: z.ZodString;
+    op: z.ZodNullable<z.ZodString>;
+    count: z.ZodNumber;
+    p50_ms: z.ZodNumber;
+    p95_ms: z.ZodNumber;
+    p99_ms: z.ZodNumber;
+    failure_rate: z.ZodNumber;
+}, z.core.$strip>;
 
 type Transaction = z.infer<typeof transactionSchema>;
 type TransactionDetail = z.infer<typeof transactionDetailSchema>;
+type Span = z.infer<typeof spanSchema>;
+type TransactionStats = z.infer<typeof transactionStatsSchema>;
 
 declare class EventsResource extends BaseResource {
     list(projectId: number, issueId: string, options?: ListEventsOptions): Promise<PaginatedResponse<Event>>;
@@ -651,7 +683,13 @@ declare class TokensResource extends BaseResource {
 }
 
 declare class TransactionsResource extends BaseResource {
-    list(projectId: number, options?: ListTransactionsOptions): Promise<PaginatedResponse<Transaction>>;
+    list(projectId: number, options?: ListTransactionsOptions): Promise<OffsetPaginatedResponse<Transaction>>;
+    getSpans(projectId: number, transactionId: string): Promise<Span[]>;
+    getStats(projectId: number, options?: {
+        page?: number;
+        per_page?: number;
+    }): Promise<OffsetPaginatedResponse<TransactionStats>>;
+    getStatForGroup(projectId: number, name: string, op?: string): Promise<TransactionStats>;
     get(projectId: number, transactionId: string): Promise<TransactionDetail>;
 }
 
@@ -714,4 +752,4 @@ declare class ValidationError extends RustrakError {
     getValidationDetails(): string;
 }
 
-export { type AcceptInvitation, type AlertHistory, type AlertIntegration, type AlertRule, type AlertRuleChannelInput, type AlertStatus, type AlertType, type ApiError, type AssembleInput, type AssembleResponse, type AuthResponse, type AuthToken, type AuthTokenCreated, AuthenticationError, AuthorizationError, BadRequestError, type ChannelType, type ChunkUploadCapability, type ClientConfig, type CreateAlertIntegration, type CreateAlertRule, type CreateAuthToken, type CreateInvitation, type CreateNotificationChannel, type CreateProject, type Event, type EventDetail, type GlobalRole, type Invitation, type InvitationInfo, type Issue, type IssueFilter, type IssueSort, type ListAlertHistoryOptions, type ListEventsOptions, type ListIssuesOptions, type ListProjectsOptions, type ListSourceMapsResponse, type ListTransactionsOptions, type LoginRequest, type LoginResult, NetworkError, NotFoundError, type NotificationChannel, type OffsetPaginatedResponse, type PaginatedResponse, type Project, type ProjectMember, type ProjectRole, type ProviderType, RateLimitError, type RegisterRequest, type ReleaseHealth, type ReleaseHealthRow, type RoutingOverride, RustrakClient, RustrakError, ServerError, type ServerVersion, type SortOrder, type SourceMapFile, type TeamMember, type TestChannelResponse, type TestIntegrationBody, type Transaction, type TransactionDetail, type UpdateAlertIntegration, type UpdateAlertRule, type UpdateIssueState, type UpdateNotificationChannel, type UpdateProject, type UpdateUserRole, type UpsertProjectMember, type User, ValidationError };
+export { type AcceptInvitation, type AlertHistory, type AlertIntegration, type AlertRule, type AlertRuleChannelInput, type AlertStatus, type AlertType, type ApiError, type AssembleInput, type AssembleResponse, type AuthResponse, type AuthToken, type AuthTokenCreated, AuthenticationError, AuthorizationError, BadRequestError, type ChannelType, type ChunkUploadCapability, type ClientConfig, type CreateAlertIntegration, type CreateAlertRule, type CreateAuthToken, type CreateInvitation, type CreateNotificationChannel, type CreateProject, type Event, type EventDetail, type GlobalRole, type Invitation, type InvitationInfo, type Issue, type IssueFilter, type IssueSort, type ListAlertHistoryOptions, type ListEventsOptions, type ListIssuesOptions, type ListProjectsOptions, type ListSourceMapsResponse, type ListTransactionsOptions, type LoginRequest, type LoginResult, NetworkError, NotFoundError, type NotificationChannel, type OffsetPaginatedResponse, type PaginatedResponse, type Project, type ProjectMember, type ProjectRole, type ProviderType, RateLimitError, type RegisterRequest, type ReleaseHealth, type ReleaseHealthRow, type RoutingOverride, RustrakClient, RustrakError, ServerError, type ServerVersion, type SortOrder, type SourceMapFile, type Span, type TeamMember, type TestChannelResponse, type TestIntegrationBody, type Transaction, type TransactionDetail, type TransactionStats, type UpdateAlertIntegration, type UpdateAlertRule, type UpdateIssueState, type UpdateNotificationChannel, type UpdateProject, type UpdateUserRole, type UpsertProjectMember, type User, ValidationError };

package/dist/index.js

@@ -644,6 +644,30 @@ var transactionDetailSchema = z.object({
   data: z.record(z.string(), z.any())
   // Full Sentry transaction payload
 });
+var spanSchema = z.object({
+  id: uuidSchema,
+  span_id: z.string().nullable(),
+  trace_id: z.string().nullable(),
+  parent_span_id: z.string().nullable(),
+  op: z.string().nullable(),
+  description: z.string().nullable(),
+  status: z.string().nullable(),
+  start_timestamp: dateTimeSchema.nullable(),
+  timestamp: dateTimeSchema.nullable(),
+  duration_ms: z.number().nullable(),
+  exclusive_time_ms: z.number().nullable(),
+  is_segment: z.boolean(),
+  segment_id: z.string().nullable()
+});
+var transactionStatsSchema = z.object({
+  transaction_name: z.string(),
+  op: z.string().nullable(),
+  count: z.number().int(),
+  p50_ms: z.number(),
+  p95_ms: z.number(),
+  p99_ms: z.number(),
+  failure_rate: z.number()
+});
 
 // src/resources/events.ts
 var EventsResource = class extends BaseResource {
@@ -971,21 +995,81 @@ var TokensResource = class extends BaseResource {
     await this.http.delete(`api/tokens/${id}`);
   }
 };
-
-// src/resources/transactions.ts
 var TransactionsResource = class extends BaseResource {
   /**
-   * List transactions for a project with cursor-based pagination (newest first)
+   * List transactions for a project with offset-based pagination (newest first)
    */
   async list(projectId, options) {
     const searchParams = {};
-    if (options?.cursor) {
-      searchParams.cursor = options.cursor;
+    if (options?.page) {
+      searchParams.page = String(options.page);
+    }
+    if (options?.per_page) {
+      searchParams.per_page = String(options.per_page);
+    }
+    if (options?.name) {
+      searchParams.name = options.name;
+    }
+    if (options?.op) {
+      searchParams.op = options.op;
+    }
+    if (options?.status) {
+      searchParams.status = options.status;
+    }
+    if (options?.environment) {
+      searchParams.environment = options.environment;
+    }
+    if (options?.release) {
+      searchParams.release = options.release;
     }
     const data = await this.http.get(`api/projects/${projectId}/transactions`, {
       searchParams
     }).json();
-    return this.validate(data, paginatedResponseSchema(transactionSchema));
+    return this.validate(
+      data,
+      offsetPaginatedResponseSchema(transactionSchema)
+    );
+  }
+  /**
+   * Get the indexed spans extracted from a transaction, in waterfall order.
+   */
+  async getSpans(projectId, transactionId) {
+    const data = await this.http.get(`api/projects/${projectId}/transactions/${transactionId}/spans`).json();
+    return this.validate(data, z.array(spanSchema));
+  }
+  /**
+   * Get aggregate performance stats (count, p50/p95/p99 latency, failure rate)
+   * grouped by transaction name + op, most frequent first, with offset-based
+   * pagination — same shape as the other list endpoints.
+   */
+  async getStats(projectId, options) {
+    const searchParams = {};
+    if (options?.page) {
+      searchParams.page = String(options.page);
+    }
+    if (options?.per_page) {
+      searchParams.per_page = String(options.per_page);
+    }
+    const data = await this.http.get(`api/projects/${projectId}/transactions/stats`, { searchParams }).json();
+    return this.validate(
+      data,
+      offsetPaginatedResponseSchema(transactionStatsSchema)
+    );
+  }
+  /**
+   * Get aggregate stats for a single (transaction name, op) group — a direct
+   * lookup that works regardless of how many groups the project has. Throws
+   * NotFoundError when the group has no transactions.
+   */
+  async getStatForGroup(projectId, name, op) {
+    const searchParams = { name };
+    if (op) {
+      searchParams.op = op;
+    }
+    const data = await this.http.get(`api/projects/${projectId}/transactions/stats/group`, {
+      searchParams
+    }).json();
+    return this.validate(data, transactionStatsSchema);
   }
   /**
    * Get a single transaction by ID with its full Sentry payload (spans,