@rustrak/client 0.3.6 → 0.3.7

package/dist/index.d.cts

@@ -516,6 +516,55 @@ interface AssembleInput {
     projects: string[];
 }
 
+declare const sourceMapStorageSchema: z.ZodObject<{
+    chunk_bytes: z.ZodNumber;
+    source_file_bytes: z.ZodNumber;
+    total_bytes: z.ZodNumber;
+    file_count: z.ZodNumber;
+}, z.core.$strip>;
+declare const storageSummarySchema: z.ZodObject<{
+    total_db_size_bytes: z.ZodNumber;
+    events_count: z.ZodNumber;
+    transactions_count: z.ZodNumber;
+    spans_count: z.ZodNumber;
+    source_maps: z.ZodObject<{
+        chunk_bytes: z.ZodNumber;
+        source_file_bytes: z.ZodNumber;
+        total_bytes: z.ZodNumber;
+        file_count: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+declare const projectStorageSchema: z.ZodObject<{
+    project_id: z.ZodNumber;
+    project_name: z.ZodString;
+    events_count: z.ZodNumber;
+    transactions_count: z.ZodNumber;
+    spans_count: z.ZodNumber;
+    source_maps_count: z.ZodNumber;
+    estimated_bytes: z.ZodNumber;
+}, z.core.$strip>;
+declare const cleanupCountsSchema: z.ZodObject<{
+    events: z.ZodNumber;
+    transactions: z.ZodNumber;
+    spans: z.ZodNumber;
+    issues_removed: z.ZodNumber;
+}, z.core.$strip>;
+declare const sourceMapGcResultSchema: z.ZodObject<{
+    files_removed: z.ZodNumber;
+    bytes_freed: z.ZodNumber;
+}, z.core.$strip>;
+declare const cleanupOptionsSchema: z.ZodObject<{
+    older_than_days: z.ZodNumber;
+    project_id: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+
+type SourceMapStorage = z.infer<typeof sourceMapStorageSchema>;
+type StorageSummary = z.infer<typeof storageSummarySchema>;
+type ProjectStorage = z.infer<typeof projectStorageSchema>;
+type CleanupCounts = z.infer<typeof cleanupCountsSchema>;
+type SourceMapGcResult = z.infer<typeof sourceMapGcResultSchema>;
+type CleanupOptions = z.infer<typeof cleanupOptionsSchema>;
+
 declare const globalRoleSchema: z.ZodEnum<{
     admin: "admin";
     member: "member";
@@ -669,6 +718,15 @@ declare class SourceMapsResource extends BaseResource {
     list(orgSlug: string, projectSlug: string): Promise<ListSourceMapsResponse>;
 }
 
+declare class StorageResource extends BaseResource {
+    getSummary(): Promise<StorageSummary>;
+    getProjects(): Promise<ProjectStorage[]>;
+    previewCleanup(options: CleanupOptions): Promise<CleanupCounts>;
+    executeCleanup(options: CleanupOptions): Promise<CleanupCounts>;
+    previewGcSourceMaps(): Promise<SourceMapGcResult>;
+    gcSourceMaps(): Promise<SourceMapGcResult>;
+}
+
 declare class TeamResource extends BaseResource {
     list(): Promise<TeamMember[]>;
     updateRole(userId: number, role: GlobalRole): Promise<void>;
@@ -708,6 +766,7 @@ declare class RustrakClient {
     readonly members: MembersResource;
     readonly sessions: SessionsResource;
     readonly transactions: TransactionsResource;
+    readonly storage: StorageResource;
     readonly health: HealthResource;
     constructor(config: ClientConfig);
 }
@@ -752,4 +811,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 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 };
+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 CleanupCounts, type CleanupOptions, 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 ProjectStorage, type ProviderType, RateLimitError, type RegisterRequest, type ReleaseHealth, type ReleaseHealthRow, type RoutingOverride, RustrakClient, RustrakError, ServerError, type ServerVersion, type SortOrder, type SourceMapFile, type SourceMapGcResult, type SourceMapStorage, type Span, type StorageSummary, 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

@@ -516,6 +516,55 @@ interface AssembleInput {
     projects: string[];
 }
 
+declare const sourceMapStorageSchema: z.ZodObject<{
+    chunk_bytes: z.ZodNumber;
+    source_file_bytes: z.ZodNumber;
+    total_bytes: z.ZodNumber;
+    file_count: z.ZodNumber;
+}, z.core.$strip>;
+declare const storageSummarySchema: z.ZodObject<{
+    total_db_size_bytes: z.ZodNumber;
+    events_count: z.ZodNumber;
+    transactions_count: z.ZodNumber;
+    spans_count: z.ZodNumber;
+    source_maps: z.ZodObject<{
+        chunk_bytes: z.ZodNumber;
+        source_file_bytes: z.ZodNumber;
+        total_bytes: z.ZodNumber;
+        file_count: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+declare const projectStorageSchema: z.ZodObject<{
+    project_id: z.ZodNumber;
+    project_name: z.ZodString;
+    events_count: z.ZodNumber;
+    transactions_count: z.ZodNumber;
+    spans_count: z.ZodNumber;
+    source_maps_count: z.ZodNumber;
+    estimated_bytes: z.ZodNumber;
+}, z.core.$strip>;
+declare const cleanupCountsSchema: z.ZodObject<{
+    events: z.ZodNumber;
+    transactions: z.ZodNumber;
+    spans: z.ZodNumber;
+    issues_removed: z.ZodNumber;
+}, z.core.$strip>;
+declare const sourceMapGcResultSchema: z.ZodObject<{
+    files_removed: z.ZodNumber;
+    bytes_freed: z.ZodNumber;
+}, z.core.$strip>;
+declare const cleanupOptionsSchema: z.ZodObject<{
+    older_than_days: z.ZodNumber;
+    project_id: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+
+type SourceMapStorage = z.infer<typeof sourceMapStorageSchema>;
+type StorageSummary = z.infer<typeof storageSummarySchema>;
+type ProjectStorage = z.infer<typeof projectStorageSchema>;
+type CleanupCounts = z.infer<typeof cleanupCountsSchema>;
+type SourceMapGcResult = z.infer<typeof sourceMapGcResultSchema>;
+type CleanupOptions = z.infer<typeof cleanupOptionsSchema>;
+
 declare const globalRoleSchema: z.ZodEnum<{
     admin: "admin";
     member: "member";
@@ -669,6 +718,15 @@ declare class SourceMapsResource extends BaseResource {
     list(orgSlug: string, projectSlug: string): Promise<ListSourceMapsResponse>;
 }
 
+declare class StorageResource extends BaseResource {
+    getSummary(): Promise<StorageSummary>;
+    getProjects(): Promise<ProjectStorage[]>;
+    previewCleanup(options: CleanupOptions): Promise<CleanupCounts>;
+    executeCleanup(options: CleanupOptions): Promise<CleanupCounts>;
+    previewGcSourceMaps(): Promise<SourceMapGcResult>;
+    gcSourceMaps(): Promise<SourceMapGcResult>;
+}
+
 declare class TeamResource extends BaseResource {
     list(): Promise<TeamMember[]>;
     updateRole(userId: number, role: GlobalRole): Promise<void>;
@@ -708,6 +766,7 @@ declare class RustrakClient {
     readonly members: MembersResource;
     readonly sessions: SessionsResource;
     readonly transactions: TransactionsResource;
+    readonly storage: StorageResource;
     readonly health: HealthResource;
     constructor(config: ClientConfig);
 }
@@ -752,4 +811,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 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 };
+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 CleanupCounts, type CleanupOptions, 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 ProjectStorage, type ProviderType, RateLimitError, type RegisterRequest, type ReleaseHealth, type ReleaseHealthRow, type RoutingOverride, RustrakClient, RustrakError, ServerError, type ServerVersion, type SortOrder, type SourceMapFile, type SourceMapGcResult, type SourceMapStorage, type Span, type StorageSummary, 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

@@ -602,6 +602,42 @@ var sourceMapFileSchema = z.object({
 var listSourceMapsResponseSchema = z.object({
   data: z.array(sourceMapFileSchema)
 });
+var sourceMapStorageSchema = z.object({
+  chunk_bytes: z.number(),
+  source_file_bytes: z.number(),
+  total_bytes: z.number(),
+  file_count: z.number()
+});
+var storageSummarySchema = z.object({
+  total_db_size_bytes: z.number(),
+  events_count: z.number(),
+  transactions_count: z.number(),
+  spans_count: z.number(),
+  source_maps: sourceMapStorageSchema
+});
+var projectStorageSchema = z.object({
+  project_id: z.number(),
+  project_name: z.string(),
+  events_count: z.number(),
+  transactions_count: z.number(),
+  spans_count: z.number(),
+  source_maps_count: z.number(),
+  estimated_bytes: z.number()
+});
+var cleanupCountsSchema = z.object({
+  events: z.number(),
+  transactions: z.number(),
+  spans: z.number(),
+  issues_removed: z.number()
+});
+var sourceMapGcResultSchema = z.object({
+  files_removed: z.number(),
+  bytes_freed: z.number()
+});
+var cleanupOptionsSchema = z.object({
+  older_than_days: z.number().int().min(1),
+  project_id: z.number().int().optional()
+});
 var authTokenSchema = z.object({
   id: z.number().int(),
   token_prefix: z.string(),
@@ -935,6 +971,59 @@ var SourceMapsResource = class extends BaseResource {
     return this.validate(data, listSourceMapsResponseSchema);
   }
 };
+var StorageResource = class extends BaseResource {
+  /**
+   * Get the instance-wide storage summary: row counts per data category, the
+   * whole-DB size, and exact source-map weight.
+   */
+  async getSummary() {
+    const data = await this.http.get("api/storage/summary").json();
+    return this.validate(data, storageSummarySchema);
+  }
+  /**
+   * Get the per-project storage breakdown (one row per project, including
+   * empty ones).
+   */
+  async getProjects() {
+    const data = await this.http.get("api/storage/projects").json();
+    return this.validate(data, z.array(projectStorageSchema));
+  }
+  /**
+   * Dry-run: count the rows a cleanup would remove. Mutates nothing — use it to
+   * confirm impact before {@link executeCleanup}.
+   */
+  async previewCleanup(options) {
+    const json = cleanupOptionsSchema.parse(options);
+    const data = await this.http.post("api/storage/cleanup/preview", { json }).json();
+    return this.validate(data, cleanupCountsSchema);
+  }
+  /**
+   * Execute a cleanup: delete data older than `older_than_days` (optionally
+   * scoped to one project) and remove any issue left with zero events.
+   */
+  async executeCleanup(options) {
+    const json = cleanupOptionsSchema.parse(options);
+    const data = await this.http.post("api/storage/cleanup", { json }).json();
+    return this.validate(data, cleanupCountsSchema);
+  }
+  /**
+   * Dry-run for {@link gcSourceMaps}: count the orphaned source-map files and
+   * bytes a GC would reclaim. Mutates nothing.
+   */
+  async previewGcSourceMaps() {
+    const data = await this.http.post("api/storage/source-maps/gc/preview").json();
+    return this.validate(data, sourceMapGcResultSchema);
+  }
+  /**
+   * Garbage-collect orphaned source maps: files no longer referenced by any
+   * upload, removed from the DB and unlinked from disk. Safe — never touches
+   * referenced files.
+   */
+  async gcSourceMaps() {
+    const data = await this.http.post("api/storage/source-maps/gc").json();
+    return this.validate(data, sourceMapGcResultSchema);
+  }
+};
 
 // src/resources/team.ts
 var TeamResource = class extends BaseResource {
@@ -1199,6 +1288,10 @@ var RustrakClient = class {
    * Transactions API resource (performance monitoring)
    */
   transactions;
+  /**
+   * Storage API resource (usage + retention cleanup, admin only)
+   */
+  storage;
   /**
    * Health API resource (version info)
    */
@@ -1223,6 +1316,7 @@ var RustrakClient = class {
     this.members = new MembersResource(this.http);
     this.sessions = new SessionsResource(this.http);
     this.transactions = new TransactionsResource(this.http);
+    this.storage = new StorageResource(this.http);
     this.health = new HealthResource(this.http);
   }
 };