@rustrak/client 0.12.2 → 0.12.3

package/dist/index.d.cts

@@ -272,6 +272,12 @@ interface ListLogsOptions {
     level?: string;
     trace_id?: string;
 }
+interface ReleaseHealthStatsOptions {
+    page?: number;
+    per_page?: number;
+    period?: string;
+    release?: string;
+}
 
 declare const eventSchema: z.ZodObject<{
     id: z.ZodString;
@@ -596,17 +602,6 @@ declare const releaseHealthRowSchema: z.ZodObject<{
     crash_free_sessions_rate: z.ZodNullable<z.ZodNumber>;
     crash_free_users_rate: z.ZodNullable<z.ZodNumber>;
 }, z.core.$strip>;
-declare const releaseHealthSchema: z.ZodArray<z.ZodObject<{
-    release: z.ZodString;
-    environment: z.ZodString;
-    total: z.ZodNumber;
-    errored: z.ZodNumber;
-    crashed: z.ZodNumber;
-    abnormal: z.ZodNumber;
-    healthy: z.ZodNumber;
-    crash_free_sessions_rate: z.ZodNullable<z.ZodNumber>;
-    crash_free_users_rate: z.ZodNullable<z.ZodNumber>;
-}, z.core.$strip>>;
 declare const sessionSummarySchema: z.ZodObject<{
     total: z.ZodNumber;
     errored: z.ZodNumber;
@@ -630,7 +625,6 @@ declare const sessionTimeseriesSchema: z.ZodArray<z.ZodObject<{
 }, z.core.$strip>>;
 
 type ReleaseHealthRow = z.infer<typeof releaseHealthRowSchema>;
-type ReleaseHealth = z.infer<typeof releaseHealthSchema>;
 type SessionSummary = z.infer<typeof sessionSummarySchema>;
 type SessionTimeseriesPoint = z.infer<typeof sessionTimeseriesPointSchema>;
 type SessionTimeseries = z.infer<typeof sessionTimeseriesSchema>;
@@ -676,6 +670,44 @@ interface AssembleInput {
     projects: string[];
 }
 
+declare const eventTimeseriesPointSchema: z.ZodObject<{
+    bucket: z.ZodString;
+    total: z.ZodNumber;
+    fatal: z.ZodNumber;
+    error: z.ZodNumber;
+    warning: z.ZodNumber;
+    info: z.ZodNumber;
+}, z.core.$strip>;
+declare const eventTimeseriesSchema: z.ZodArray<z.ZodObject<{
+    bucket: z.ZodString;
+    total: z.ZodNumber;
+    fatal: z.ZodNumber;
+    error: z.ZodNumber;
+    warning: z.ZodNumber;
+    info: z.ZodNumber;
+}, z.core.$strip>>;
+declare const metricDeltaSchema: z.ZodObject<{
+    current: z.ZodNumber;
+    previous: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+declare const projectStatsSummarySchema: z.ZodObject<{
+    period_hours: z.ZodNullable<z.ZodNumber>;
+    events: z.ZodObject<{
+        current: z.ZodNumber;
+        previous: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>;
+    new_issues: z.ZodObject<{
+        current: z.ZodNumber;
+        previous: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>;
+    open_issues: z.ZodNumber;
+}, z.core.$strip>;
+
+type EventTimeseriesPoint = z.infer<typeof eventTimeseriesPointSchema>;
+type EventTimeseries = z.infer<typeof eventTimeseriesSchema>;
+type MetricDelta = z.infer<typeof metricDeltaSchema>;
+type ProjectStatsSummary = z.infer<typeof projectStatsSummarySchema>;
+
 declare const sourceMapStorageSchema: z.ZodObject<{
     chunk_bytes: z.ZodNumber;
     source_file_bytes: z.ZodNumber;
@@ -1013,7 +1045,7 @@ declare class ReleasesResource extends BaseResource {
 }
 
 declare class SessionsResource extends BaseResource {
-    stats(projectId: number, period?: string, release?: string): Promise<ReleaseHealth>;
+    stats(projectId: number, options?: ReleaseHealthStatsOptions): Promise<OffsetPaginatedResponse<ReleaseHealthRow>>;
     summary(projectId: number, period?: string): Promise<SessionSummary>;
     timeseries(projectId: number, period?: string, interval?: number): Promise<SessionTimeseries>;
 }
@@ -1032,6 +1064,11 @@ declare class SpansResource extends BaseResource {
     list(projectId: number, options?: ListSpansOptions): Promise<OffsetPaginatedResponse<Span>>;
 }
 
+declare class StatsResource extends BaseResource {
+    timeseries(projectId: number, period?: string, interval?: number): Promise<EventTimeseries>;
+    summary(projectId: number, period?: string): Promise<ProjectStatsSummary>;
+}
+
 declare class StorageResource extends BaseResource {
     getSummary(): Promise<StorageSummary>;
     getProjects(): Promise<ProjectStorage[]>;
@@ -1084,6 +1121,7 @@ declare class RustrakClient {
     readonly logs: LogsResource;
     readonly spans: SpansResource;
     readonly agents: AgentsResource;
+    readonly stats: StatsResource;
     readonly storage: StorageResource;
     readonly health: HealthResource;
     constructor(config: ClientConfig);
@@ -1129,4 +1167,4 @@ declare class ValidationError extends RustrakError {
     getValidationDetails(): string;
 }
 
-export { type AcceptInvitation, type ActivityEntry, type AgentBreakdownOptions, type AgentDurationPoint, type AgentTimeseriesOptions, type AgentTimeseriesPoint, type AgentTraceSummary, type AgentTracesOptions, 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 BulkDeleteIssues, type BulkUpdateIssues, type ChannelType, type ChunkUploadCapability, type CleanupCounts, type CleanupOptions, type ClientConfig, type CreateAlertIntegration, type CreateAlertRule, type CreateAuthToken, type CreateComment, type CreateInvitation, type CreateNotificationChannel, type CreateProject, type CreateUserReport, type Event, type EventDetail, type GenAiBreakdownRow, type GlobalRole, type Invitation, type InvitationInfo, type Issue, type IssueAggregates, type IssueFilter, type IssueHash, type IssuePriority, type IssueSort, type IssueStats, type IssueStatsWindow, type IssueStatus, type IssueTagValue, type ListAlertHistoryOptions, type ListEventsOptions, type ListIssuesOptions, type ListLogsOptions, type ListProjectsOptions, type ListSourceMapsResponse, type ListSpansOptions, type ListTransactionsOptions, type Log, type LoginRequest, type LoginResult, NetworkError, NotFoundError, type NotificationChannel, type OffsetPaginatedResponse, type PaginatedResponse, type Project, type ProjectMember, type ProjectRole, type ProjectStorage, type ProviderType, RateLimitError, type RegisterRequest, type ReleaseHealth, type ReleaseHealthRow, type RoutingOverride, RustrakClient, RustrakError, ServerError, type ServerVersion, type SessionSummary, type SessionTimeseries, type SessionTimeseriesPoint, type SortOrder, type SourceMapFile, type SourceMapGcResult, type SourceMapStorage, type Span, type StorageSummary, type TagSummary, type TagValueCount, 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, type UserReport, ValidationError };
+export { type AcceptInvitation, type ActivityEntry, type AgentBreakdownOptions, type AgentDurationPoint, type AgentTimeseriesOptions, type AgentTimeseriesPoint, type AgentTraceSummary, type AgentTracesOptions, 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 BulkDeleteIssues, type BulkUpdateIssues, type ChannelType, type ChunkUploadCapability, type CleanupCounts, type CleanupOptions, type ClientConfig, type CreateAlertIntegration, type CreateAlertRule, type CreateAuthToken, type CreateComment, type CreateInvitation, type CreateNotificationChannel, type CreateProject, type CreateUserReport, type Event, type EventDetail, type EventTimeseries, type EventTimeseriesPoint, type GenAiBreakdownRow, type GlobalRole, type Invitation, type InvitationInfo, type Issue, type IssueAggregates, type IssueFilter, type IssueHash, type IssuePriority, type IssueSort, type IssueStats, type IssueStatsWindow, type IssueStatus, type IssueTagValue, type ListAlertHistoryOptions, type ListEventsOptions, type ListIssuesOptions, type ListLogsOptions, type ListProjectsOptions, type ListSourceMapsResponse, type ListSpansOptions, type ListTransactionsOptions, type Log, type LoginRequest, type LoginResult, type MetricDelta, NetworkError, NotFoundError, type NotificationChannel, type OffsetPaginatedResponse, type PaginatedResponse, type Project, type ProjectMember, type ProjectRole, type ProjectStatsSummary, type ProjectStorage, type ProviderType, RateLimitError, type RegisterRequest, type ReleaseHealthRow, type ReleaseHealthStatsOptions, type RoutingOverride, RustrakClient, RustrakError, ServerError, type ServerVersion, type SessionSummary, type SessionTimeseries, type SessionTimeseriesPoint, type SortOrder, type SourceMapFile, type SourceMapGcResult, type SourceMapStorage, type Span, type StorageSummary, type TagSummary, type TagValueCount, 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, type UserReport, ValidationError };

package/dist/index.d.ts

@@ -272,6 +272,12 @@ interface ListLogsOptions {
     level?: string;
     trace_id?: string;
 }
+interface ReleaseHealthStatsOptions {
+    page?: number;
+    per_page?: number;
+    period?: string;
+    release?: string;
+}
 
 declare const eventSchema: z.ZodObject<{
     id: z.ZodString;
@@ -596,17 +602,6 @@ declare const releaseHealthRowSchema: z.ZodObject<{
     crash_free_sessions_rate: z.ZodNullable<z.ZodNumber>;
     crash_free_users_rate: z.ZodNullable<z.ZodNumber>;
 }, z.core.$strip>;
-declare const releaseHealthSchema: z.ZodArray<z.ZodObject<{
-    release: z.ZodString;
-    environment: z.ZodString;
-    total: z.ZodNumber;
-    errored: z.ZodNumber;
-    crashed: z.ZodNumber;
-    abnormal: z.ZodNumber;
-    healthy: z.ZodNumber;
-    crash_free_sessions_rate: z.ZodNullable<z.ZodNumber>;
-    crash_free_users_rate: z.ZodNullable<z.ZodNumber>;
-}, z.core.$strip>>;
 declare const sessionSummarySchema: z.ZodObject<{
     total: z.ZodNumber;
     errored: z.ZodNumber;
@@ -630,7 +625,6 @@ declare const sessionTimeseriesSchema: z.ZodArray<z.ZodObject<{
 }, z.core.$strip>>;
 
 type ReleaseHealthRow = z.infer<typeof releaseHealthRowSchema>;
-type ReleaseHealth = z.infer<typeof releaseHealthSchema>;
 type SessionSummary = z.infer<typeof sessionSummarySchema>;
 type SessionTimeseriesPoint = z.infer<typeof sessionTimeseriesPointSchema>;
 type SessionTimeseries = z.infer<typeof sessionTimeseriesSchema>;
@@ -676,6 +670,44 @@ interface AssembleInput {
     projects: string[];
 }
 
+declare const eventTimeseriesPointSchema: z.ZodObject<{
+    bucket: z.ZodString;
+    total: z.ZodNumber;
+    fatal: z.ZodNumber;
+    error: z.ZodNumber;
+    warning: z.ZodNumber;
+    info: z.ZodNumber;
+}, z.core.$strip>;
+declare const eventTimeseriesSchema: z.ZodArray<z.ZodObject<{
+    bucket: z.ZodString;
+    total: z.ZodNumber;
+    fatal: z.ZodNumber;
+    error: z.ZodNumber;
+    warning: z.ZodNumber;
+    info: z.ZodNumber;
+}, z.core.$strip>>;
+declare const metricDeltaSchema: z.ZodObject<{
+    current: z.ZodNumber;
+    previous: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+declare const projectStatsSummarySchema: z.ZodObject<{
+    period_hours: z.ZodNullable<z.ZodNumber>;
+    events: z.ZodObject<{
+        current: z.ZodNumber;
+        previous: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>;
+    new_issues: z.ZodObject<{
+        current: z.ZodNumber;
+        previous: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>;
+    open_issues: z.ZodNumber;
+}, z.core.$strip>;
+
+type EventTimeseriesPoint = z.infer<typeof eventTimeseriesPointSchema>;
+type EventTimeseries = z.infer<typeof eventTimeseriesSchema>;
+type MetricDelta = z.infer<typeof metricDeltaSchema>;
+type ProjectStatsSummary = z.infer<typeof projectStatsSummarySchema>;
+
 declare const sourceMapStorageSchema: z.ZodObject<{
     chunk_bytes: z.ZodNumber;
     source_file_bytes: z.ZodNumber;
@@ -1013,7 +1045,7 @@ declare class ReleasesResource extends BaseResource {
 }
 
 declare class SessionsResource extends BaseResource {
-    stats(projectId: number, period?: string, release?: string): Promise<ReleaseHealth>;
+    stats(projectId: number, options?: ReleaseHealthStatsOptions): Promise<OffsetPaginatedResponse<ReleaseHealthRow>>;
     summary(projectId: number, period?: string): Promise<SessionSummary>;
     timeseries(projectId: number, period?: string, interval?: number): Promise<SessionTimeseries>;
 }
@@ -1032,6 +1064,11 @@ declare class SpansResource extends BaseResource {
     list(projectId: number, options?: ListSpansOptions): Promise<OffsetPaginatedResponse<Span>>;
 }
 
+declare class StatsResource extends BaseResource {
+    timeseries(projectId: number, period?: string, interval?: number): Promise<EventTimeseries>;
+    summary(projectId: number, period?: string): Promise<ProjectStatsSummary>;
+}
+
 declare class StorageResource extends BaseResource {
     getSummary(): Promise<StorageSummary>;
     getProjects(): Promise<ProjectStorage[]>;
@@ -1084,6 +1121,7 @@ declare class RustrakClient {
     readonly logs: LogsResource;
     readonly spans: SpansResource;
     readonly agents: AgentsResource;
+    readonly stats: StatsResource;
     readonly storage: StorageResource;
     readonly health: HealthResource;
     constructor(config: ClientConfig);
@@ -1129,4 +1167,4 @@ declare class ValidationError extends RustrakError {
     getValidationDetails(): string;
 }
 
-export { type AcceptInvitation, type ActivityEntry, type AgentBreakdownOptions, type AgentDurationPoint, type AgentTimeseriesOptions, type AgentTimeseriesPoint, type AgentTraceSummary, type AgentTracesOptions, 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 BulkDeleteIssues, type BulkUpdateIssues, type ChannelType, type ChunkUploadCapability, type CleanupCounts, type CleanupOptions, type ClientConfig, type CreateAlertIntegration, type CreateAlertRule, type CreateAuthToken, type CreateComment, type CreateInvitation, type CreateNotificationChannel, type CreateProject, type CreateUserReport, type Event, type EventDetail, type GenAiBreakdownRow, type GlobalRole, type Invitation, type InvitationInfo, type Issue, type IssueAggregates, type IssueFilter, type IssueHash, type IssuePriority, type IssueSort, type IssueStats, type IssueStatsWindow, type IssueStatus, type IssueTagValue, type ListAlertHistoryOptions, type ListEventsOptions, type ListIssuesOptions, type ListLogsOptions, type ListProjectsOptions, type ListSourceMapsResponse, type ListSpansOptions, type ListTransactionsOptions, type Log, type LoginRequest, type LoginResult, NetworkError, NotFoundError, type NotificationChannel, type OffsetPaginatedResponse, type PaginatedResponse, type Project, type ProjectMember, type ProjectRole, type ProjectStorage, type ProviderType, RateLimitError, type RegisterRequest, type ReleaseHealth, type ReleaseHealthRow, type RoutingOverride, RustrakClient, RustrakError, ServerError, type ServerVersion, type SessionSummary, type SessionTimeseries, type SessionTimeseriesPoint, type SortOrder, type SourceMapFile, type SourceMapGcResult, type SourceMapStorage, type Span, type StorageSummary, type TagSummary, type TagValueCount, 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, type UserReport, ValidationError };
+export { type AcceptInvitation, type ActivityEntry, type AgentBreakdownOptions, type AgentDurationPoint, type AgentTimeseriesOptions, type AgentTimeseriesPoint, type AgentTraceSummary, type AgentTracesOptions, 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 BulkDeleteIssues, type BulkUpdateIssues, type ChannelType, type ChunkUploadCapability, type CleanupCounts, type CleanupOptions, type ClientConfig, type CreateAlertIntegration, type CreateAlertRule, type CreateAuthToken, type CreateComment, type CreateInvitation, type CreateNotificationChannel, type CreateProject, type CreateUserReport, type Event, type EventDetail, type EventTimeseries, type EventTimeseriesPoint, type GenAiBreakdownRow, type GlobalRole, type Invitation, type InvitationInfo, type Issue, type IssueAggregates, type IssueFilter, type IssueHash, type IssuePriority, type IssueSort, type IssueStats, type IssueStatsWindow, type IssueStatus, type IssueTagValue, type ListAlertHistoryOptions, type ListEventsOptions, type ListIssuesOptions, type ListLogsOptions, type ListProjectsOptions, type ListSourceMapsResponse, type ListSpansOptions, type ListTransactionsOptions, type Log, type LoginRequest, type LoginResult, type MetricDelta, NetworkError, NotFoundError, type NotificationChannel, type OffsetPaginatedResponse, type PaginatedResponse, type Project, type ProjectMember, type ProjectRole, type ProjectStatsSummary, type ProjectStorage, type ProviderType, RateLimitError, type RegisterRequest, type ReleaseHealthRow, type ReleaseHealthStatsOptions, type RoutingOverride, RustrakClient, RustrakError, ServerError, type ServerVersion, type SessionSummary, type SessionTimeseries, type SessionTimeseriesPoint, type SortOrder, type SourceMapFile, type SourceMapGcResult, type SourceMapStorage, type Span, type StorageSummary, type TagSummary, type TagValueCount, 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, type UserReport, ValidationError };

package/dist/index.js

@@ -388,7 +388,6 @@ var releaseHealthRowSchema = z.object({
   crash_free_sessions_rate: z.number().nullable(),
   crash_free_users_rate: z.number().nullable()
 });
-var releaseHealthSchema = z.array(releaseHealthRowSchema);
 var sessionSummarySchema = z.object({
   total: z.number().int(),
   errored: z.number().int(),
@@ -429,6 +428,27 @@ var sourceMapFileSchema = z.object({
 var listSourceMapsResponseSchema = z.object({
   data: z.array(sourceMapFileSchema)
 });
+var eventTimeseriesPointSchema = z.object({
+  bucket: dateTimeSchema,
+  total: z.number().int(),
+  fatal: z.number().int(),
+  error: z.number().int(),
+  warning: z.number().int(),
+  info: z.number().int()
+});
+var eventTimeseriesSchema = z.array(eventTimeseriesPointSchema);
+var metricDeltaSchema = z.object({
+  current: z.number().int(),
+  previous: z.number().int().nullable()
+});
+var projectStatsSummarySchema = z.object({
+  /** Resolved window in hours, or `null` for all time. */
+  period_hours: z.number().int().nullable(),
+  events: metricDeltaSchema,
+  new_issues: metricDeltaSchema,
+  /** Currently unresolved issues, independent of the window. */
+  open_issues: z.number().int()
+});
 var sourceMapStorageSchema = z.object({
   chunk_bytes: z.number(),
   source_file_bytes: z.number(),
@@ -1333,22 +1353,30 @@ var ReleasesResource = class extends BaseResource {
 // src/resources/sessions.ts
 var SessionsResource = class extends BaseResource {
   /**
-   * Get per-release health stats for a project.
+   * Get per-release health stats for a project, one offset-based page of
+   * (release, environment) rows at a time, ordered by session volume.
    * @param projectId - Project ID
-   * @param period - Time window (e.g. '24h', '7d'). Defaults to '24h'.
-   * @param release - Scope to a single release (all environments), computed
-   *   server-side. Omit to get every release in the project.
+   * @param options - Time window, release scoping and pagination.
    */
-  async stats(projectId, period, release) {
+  async stats(projectId, options) {
     const searchParams = {};
-    if (period) {
-      searchParams.period = period;
+    if (options?.period) {
+      searchParams.period = options.period;
     }
-    if (release) {
-      searchParams.release = release;
+    if (options?.release) {
+      searchParams.release = options.release;
+    }
+    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}/sessions/stats`, { searchParams }).json();
-    return this.validate(data, releaseHealthSchema);
+    return this.validate(
+      data,
+      offsetPaginatedResponseSchema(releaseHealthRowSchema)
+    );
   }
   /**
    * Get project-wide session health, aggregated across all releases and environments.
@@ -1465,6 +1493,48 @@ var SpansResource = class extends BaseResource {
     return this.validate(data, offsetPaginatedResponseSchema(spanSchema));
   }
 };
+
+// src/resources/stats.ts
+var StatsResource = class extends BaseResource {
+  /**
+   * Get time-bucketed error-event volume for a project, split by severity.
+   *
+   * Buckets are zero-filled across the window, so a quiet hour comes back as a
+   * point with `total: 0` rather than being absent. All-time requests (no
+   * `period`) are sparse: there is no lower bound to fill from.
+   *
+   * @param projectId - Project ID
+   * @param period - Time window (e.g. '24h', '7d'). Omit for all time.
+   * @param interval - Bucket width in hours (default: 1, max: 24).
+   */
+  async timeseries(projectId, period, interval) {
+    const searchParams = {};
+    if (period) {
+      searchParams.period = period;
+    }
+    if (interval !== void 0) {
+      searchParams.interval = interval.toString();
+    }
+    const data = await this.http.get(`api/projects/${projectId}/events/stats`, { searchParams }).json();
+    return this.validate(data, eventTimeseriesSchema);
+  }
+  /**
+   * Get project-wide counters for a window, each paired with the same counter
+   * over the window immediately before it.
+   *
+   * @param projectId - Project ID
+   * @param period - Time window (e.g. '24h', '7d'). Omit for all time, which
+   *   leaves every `previous` null.
+   */
+  async summary(projectId, period) {
+    const searchParams = {};
+    if (period) {
+      searchParams.period = period;
+    }
+    const data = await this.http.get(`api/projects/${projectId}/stats/summary`, { searchParams }).json();
+    return this.validate(data, projectStatsSummarySchema);
+  }
+};
 var StorageResource = class extends BaseResource {
   /**
    * Get the instance-wide storage summary: row counts per data category, the
@@ -1801,6 +1871,10 @@ var RustrakClient = class {
    * AI Agent Monitoring dashboard API resource
    */
   agents;
+  /**
+   * Stats API resource (project-wide overview aggregates)
+   */
+  stats;
   /**
    * Storage API resource (usage + retention cleanup, admin only)
    */
@@ -1833,6 +1907,7 @@ var RustrakClient = class {
     this.logs = new LogsResource(this.http);
     this.spans = new SpansResource(this.http);
     this.agents = new AgentsResource(this.http);
+    this.stats = new StatsResource(this.http);
     this.storage = new StorageResource(this.http);
     this.health = new HealthResource(this.http);
   }