ugcinc 4.16.0 → 4.16.2

package/dist/stats.d.ts

@@ -242,6 +242,7 @@ export declare class StatsClient extends BaseClient {
      *
      * Returns one record per day with total changes across all filtered accounts.
      * Perfect for rendering time-series charts showing growth over time.
+     * Changes are measured against each account's previous reading, however old.
      *
      * @param params - Date range and filter parameters (startDate and endDate required)
      * @returns Array of daily aggregated statistics
@@ -266,6 +267,7 @@ export declare class StatsClient extends BaseClient {
      *
      * Returns per-account daily changes (deltas) for followers, following, views, likes.
      * Perfect for granular local filtering in dashboard charts.
+     * Changes are measured against each account's previous reading, however old.
      *
      * @param params - Date range and filter parameters (startDate and endDate required)
      * @returns Array of daily account statistics
@@ -277,6 +279,9 @@ export declare class StatsClient extends BaseClient {
      * Returns per-video daily stats with both cumulative values and daily changes.
      * Perfect for showing per-video performance in chart tooltips.
      *
+     * Gains between readings are spread evenly across the days between them, so each
+     * `*_change` is the post's share of that day. Requests over 100,000 rows return a 400.
+     *
      * @param params - Date range and filter parameters (startDate and endDate required)
      * @returns Array of daily post statistics with changes
      *
@@ -301,6 +306,7 @@ export declare class StatsClient extends BaseClient {
      * Designed for high-performance dashboard rendering — returns ~30-90 rows instead of thousands.
      *
      * Followers/following come from account stats, views/likes/comments/shares from post stats.
+     * Gains between readings are spread evenly across the days between them.
      *
      * @param params - Date range and filter parameters (startDate and endDate required)
      * @returns Array of pre-aggregated daily statistics

package/dist/stats.js

@@ -61,6 +61,7 @@ class StatsClient extends base_1.BaseClient {
      *
      * Returns one record per day with total changes across all filtered accounts.
      * Perfect for rendering time-series charts showing growth over time.
+     * Changes are measured against each account's previous reading, however old.
      *
      * @param params - Date range and filter parameters (startDate and endDate required)
      * @returns Array of daily aggregated statistics
@@ -87,6 +88,7 @@ class StatsClient extends base_1.BaseClient {
      *
      * Returns per-account daily changes (deltas) for followers, following, views, likes.
      * Perfect for granular local filtering in dashboard charts.
+     * Changes are measured against each account's previous reading, however old.
      *
      * @param params - Date range and filter parameters (startDate and endDate required)
      * @returns Array of daily account statistics
@@ -100,6 +102,9 @@ class StatsClient extends base_1.BaseClient {
      * Returns per-video daily stats with both cumulative values and daily changes.
      * Perfect for showing per-video performance in chart tooltips.
      *
+     * Gains between readings are spread evenly across the days between them, so each
+     * `*_change` is the post's share of that day. Requests over 100,000 rows return a 400.
+     *
      * @param params - Date range and filter parameters (startDate and endDate required)
      * @returns Array of daily post statistics with changes
      *
@@ -126,6 +131,7 @@ class StatsClient extends base_1.BaseClient {
      * Designed for high-performance dashboard rendering — returns ~30-90 rows instead of thousands.
      *
      * Followers/following come from account stats, views/likes/comments/shares from post stats.
+     * Gains between readings are spread evenly across the days between them.
      *
      * @param params - Date range and filter parameters (startDate and endDate required)
      * @returns Array of pre-aggregated daily statistics

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ugcinc",
-  "version": "4.16.0",
+  "version": "4.16.2",
   "description": "TypeScript/JavaScript client for the UGC Inc API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",