@delopay/sdk 0.66.2 → 0.67.0

package/dist/index.d.cts

@@ -2928,8 +2928,20 @@ interface AnalyticsScopeRequest {
      * both. Applies to the payment series/connectors; refunds are always included.
      */
     test_mode?: boolean | null;
+    /**
+     * Series bucket size: `"day"` (default) or `"hour"`. Hourly buckets are the
+     * intra-day view for a single selected day — allowed only when the window
+     * spans at most 48 hours — and are UTC hours. Requires a backend that
+     * supports intra-day analytics; older backends ignore the field and return
+     * daily buckets.
+     */
+    granularity?: string | null;
 }
-/** One day of aggregated payment activity. Volumes are in USD major units. */
+/**
+ * One bucket of aggregated payment activity — a calendar day, or a single UTC
+ * hour when the response's `granularity` is `"hour"`. Volumes are in USD major
+ * units.
+ */
 interface AnalyticsDayBucket {
     tx: number;
     success: number;
@@ -2942,6 +2954,9 @@ interface AnalyticsDayBucket {
     failed_vol: number;
     processing_vol: number;
     action_vol: number;
+    /** Payments that timed out unpaid (absent on older backends). */
+    expired_tx?: number;
+    expired_vol?: number;
 }
 /** One day of a processor's volume, split by outcome (major units). */
 interface AnalyticsConnectorDay {
@@ -2978,8 +2993,24 @@ interface AnalyticsScopeResponse {
     end_date: string;
     /** "root" | "merchant" | "project" | "shop". */
     level: string;
+    /**
+     * Bucket size of `series` / `previous_series` / `connectors[].days`: `"day"`
+     * or `"hour"` (intra-day view; one bucket per UTC hour). Absent on older
+     * backends, which always return daily buckets.
+     */
+    granularity?: string;
+    /**
+     * UTC instant of the first bucket's start when `granularity` is `"hour"`
+     * (`YYYY-MM-DDTHH:00:00Z`); absent for daily buckets, where `end_date` +
+     * `days` describe the axis.
+     */
+    bucket_start?: string | null;
     series: AnalyticsDayBucket[];
-    /** Equal-length previous window (for period-over-period deltas + comparison). */
+    /**
+     * Equal-length previous window (for period-over-period deltas + comparison).
+     * For hourly buckets this is the same time span exactly 24h earlier, so
+     * bucket `i` compares hour-for-hour with the previous day.
+     */
     previous_series: AnalyticsDayBucket[];
     connectors: AnalyticsConnectorSeries[];
     children: AnalyticsChild[];

package/dist/index.d.ts

@@ -2928,8 +2928,20 @@ interface AnalyticsScopeRequest {
      * both. Applies to the payment series/connectors; refunds are always included.
      */
     test_mode?: boolean | null;
+    /**
+     * Series bucket size: `"day"` (default) or `"hour"`. Hourly buckets are the
+     * intra-day view for a single selected day — allowed only when the window
+     * spans at most 48 hours — and are UTC hours. Requires a backend that
+     * supports intra-day analytics; older backends ignore the field and return
+     * daily buckets.
+     */
+    granularity?: string | null;
 }
-/** One day of aggregated payment activity. Volumes are in USD major units. */
+/**
+ * One bucket of aggregated payment activity — a calendar day, or a single UTC
+ * hour when the response's `granularity` is `"hour"`. Volumes are in USD major
+ * units.
+ */
 interface AnalyticsDayBucket {
     tx: number;
     success: number;
@@ -2942,6 +2954,9 @@ interface AnalyticsDayBucket {
     failed_vol: number;
     processing_vol: number;
     action_vol: number;
+    /** Payments that timed out unpaid (absent on older backends). */
+    expired_tx?: number;
+    expired_vol?: number;
 }
 /** One day of a processor's volume, split by outcome (major units). */
 interface AnalyticsConnectorDay {
@@ -2978,8 +2993,24 @@ interface AnalyticsScopeResponse {
     end_date: string;
     /** "root" | "merchant" | "project" | "shop". */
     level: string;
+    /**
+     * Bucket size of `series` / `previous_series` / `connectors[].days`: `"day"`
+     * or `"hour"` (intra-day view; one bucket per UTC hour). Absent on older
+     * backends, which always return daily buckets.
+     */
+    granularity?: string;
+    /**
+     * UTC instant of the first bucket's start when `granularity` is `"hour"`
+     * (`YYYY-MM-DDTHH:00:00Z`); absent for daily buckets, where `end_date` +
+     * `days` describe the axis.
+     */
+    bucket_start?: string | null;
     series: AnalyticsDayBucket[];
-    /** Equal-length previous window (for period-over-period deltas + comparison). */
+    /**
+     * Equal-length previous window (for period-over-period deltas + comparison).
+     * For hourly buckets this is the same time span exactly 24h earlier, so
+     * bucket `i` compares hour-for-hour with the previous day.
+     */
     previous_series: AnalyticsDayBucket[];
     connectors: AnalyticsConnectorSeries[];
     children: AnalyticsChild[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@delopay/sdk",
-  "version": "0.66.2",
+  "version": "0.67.0",
   "description": "Official Delopay TypeScript SDK",
   "type": "module",
   "sideEffects": false,