@rustrak/client 0.12.2 → 0.13.0

package/dist/index.cjs

@@ -363,6 +363,28 @@ var upsertProjectMemberSchema = zod.z.object({
   user_id: zod.z.number().int(),
   role: projectRoleSchema
 });
+var metricDeltaSchema = zod.z.object({
+  current: zod.z.number().int(),
+  /**
+   * The same window immediately before this one. Null only for all-time
+   * requests, where a `0` would render as a misleading "+100%".
+   */
+  previous: zod.z.number().int().nullable()
+});
+var projectListStatsSchema = zod.z.object({
+  /**
+   * Distinct issues active in each bucket, oldest first. A shape, not a
+   * total: an issue firing all day appears in every bucket it touched.
+   */
+  trend: zod.z.array(zod.z.number().int()),
+  events: metricDeltaSchema,
+  /** Issues first seen in the window. Drives the "getting worse" signal. */
+  new_issues: metricDeltaSchema,
+  /** Unresolved issues right now, independent of the window. */
+  open_issues: zod.z.number().int(),
+  /** The subset of `open_issues` at `fatal` level. */
+  fatal_issues: zod.z.number().int()
+});
 var projectSchema = zod.z.object({
   id: zod.z.number().int(),
   name: zod.z.string(),
@@ -373,15 +395,31 @@ var projectSchema = zod.z.object({
   digested_event_count: zod.z.number().int(),
   created_at: dateTimeSchema,
   updated_at: dateTimeSchema,
-  platform: zod.z.string().nullable()
+  platform: zod.z.string().nullable(),
+  stats: projectListStatsSchema.optional()
 });
 var createProjectSchema = zod.z.object({
   name: zod.z.string().min(1),
-  slug: zod.z.string().optional()
+  /**
+   * Slugified server-side. Supplying it means the user chose it, so a taken
+   * slug is a 409. Omitting it derives one from the name and silently
+   * de-duplicates, since nobody chose that value.
+   */
+  slug: zod.z.string().min(1).optional(),
+  /**
+   * Validated server-side against SELECTABLE_PLATFORMS. Omitting it leaves the
+   * project eligible for platform auto-detection from its first event.
+   */
+  platform: zod.z.string().min(1).optional()
 });
 var updateProjectSchema = zod.z.object({
   name: zod.z.string().min(1).optional(),
-  platform: zod.z.string().min(1).optional()
+  platform: zod.z.string().min(1).optional(),
+  /**
+   * Slugified server-side. Unlike on create, a taken slug is a 409 rather than
+   * being silently de-duplicated.
+   */
+  slug: zod.z.string().min(1).optional()
 });
 var releaseHealthRowSchema = zod.z.object({
   release: zod.z.string(),
@@ -394,7 +432,6 @@ var releaseHealthRowSchema = zod.z.object({
   crash_free_sessions_rate: zod.z.number().nullable(),
   crash_free_users_rate: zod.z.number().nullable()
 });
-var releaseHealthSchema = zod.z.array(releaseHealthRowSchema);
 var sessionSummarySchema = zod.z.object({
   total: zod.z.number().int(),
   errored: zod.z.number().int(),
@@ -435,6 +472,27 @@ var sourceMapFileSchema = zod.z.object({
 var listSourceMapsResponseSchema = zod.z.object({
   data: zod.z.array(sourceMapFileSchema)
 });
+var eventTimeseriesPointSchema = zod.z.object({
+  bucket: dateTimeSchema,
+  total: zod.z.number().int(),
+  fatal: zod.z.number().int(),
+  error: zod.z.number().int(),
+  warning: zod.z.number().int(),
+  info: zod.z.number().int()
+});
+var eventTimeseriesSchema = zod.z.array(eventTimeseriesPointSchema);
+var metricDeltaSchema2 = zod.z.object({
+  current: zod.z.number().int(),
+  previous: zod.z.number().int().nullable()
+});
+var projectStatsSummarySchema = zod.z.object({
+  /** Resolved window in hours, or `null` for all time. */
+  period_hours: zod.z.number().int().nullable(),
+  events: metricDeltaSchema2,
+  new_issues: metricDeltaSchema2,
+  /** Currently unresolved issues, independent of the window. */
+  open_issues: zod.z.number().int()
+});
 var sourceMapStorageSchema = zod.z.object({
   chunk_bytes: zod.z.number(),
   source_file_bytes: zod.z.number(),
@@ -1280,6 +1338,9 @@ var ProjectsResource = class extends BaseResource {
     if (options?.order) {
       searchParams.set("order", options.order);
     }
+    if (options?.stats_period) {
+      searchParams.set("stats_period", options.stats_period);
+    }
     const query = searchParams.toString();
     const url = query ? `api/projects?${query}` : "api/projects";
     const data = await this.http.get(url).json();
@@ -1339,22 +1400,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.
@@ -1471,6 +1540,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
@@ -1678,7 +1789,8 @@ function transformHttpError(error) {
   let errorMessage = `HTTP ${status} error`;
   const body = error.data;
   if (body) {
-    errorMessage = body.error || body.message || errorMessage;
+    const nested = typeof body.error === "object" ? body.error?.message : body.error;
+    errorMessage = nested || body.message || errorMessage;
   }
   switch (status) {
     case 400:
@@ -1807,6 +1919,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)
    */
@@ -1839,6 +1955,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);
   }