hive-react-kit 0.9.0 → 0.9.2

package/dist/services/userService.d.ts

@@ -2,6 +2,19 @@ import { Follower, Following, UserProfileResponse, Account } from "@/types/user"
 import { Post } from "@/types/post";
 import type { Poll } from "@/types/poll";
 import type { PendingAuthorRow, PendingCurationRow } from "@/types/reward";
+/** Default "parent" container for getUserSnaps (kept for backwards compatibility). */
+export declare const DEFAULT_SNAP_PARENT = "peak.snaps";
+/**
+ * Known snap-container parents supported by UserDetailProfile's segmented
+ * control. Values are the account names queried via `?parent=<account>`.
+ */
+export declare const SNAP_SUBTYPE_PARENTS: {
+    readonly snaps: "peak.snaps";
+    readonly ecency: "ecency.waves";
+    readonly threads: "leothreads";
+    readonly liketu: "liketu.moments";
+};
+export type SnapSubType = keyof typeof SNAP_SUBTYPE_PARENTS;
 declare class UserService {
     private readonly HIVE_API_URL;
     /** Central fetch wrapper — threads AbortSignal to every network request */
@@ -19,10 +32,15 @@ declare class UserService {
     getUserComments(username: string, limit?: number, startAuthor?: string, startPermlink?: string, signal?: AbortSignal): Promise<Post[]>;
     getUserReplies(username: string, limit?: number, startAuthor?: string, startPermlink?: string, signal?: AbortSignal): Promise<Post[]>;
     /**
-     * Fetch snap references for a user from PeakD API.
-     * Returns { id, author, permlink }[] with cursor for pagination.
+     * Fetch snap references for a user from the hreplier API.
+     * Returns `{ id, author, permlink }[]`. The endpoint does not support
+     * cursor-based pagination — it returns a single batch, so `startId`
+     * is accepted for call-site compatibility but ignored.
+     *
+     * `parent` selects the container account: `peak.snaps` (Snaps), `ecency.waves`
+     * (Ecency waves), `leothreads` (Threads), `liketu.moments` (Liketu moments).
      */
-    getSnapReferences(username: string, startId?: number, signal?: AbortSignal): Promise<{
+    getSnapReferences(username: string, _startId?: number, signal?: AbortSignal, parent?: string): Promise<{
         id: number;
         author: string;
         permlink: string;
@@ -33,11 +51,24 @@ declare class UserService {
      */
     private batchGetPosts;
     /**
-     * Fetch snaps for a user using PeakD API + Hive bridge.get_post.
-     * Step 1: Get snap references from PeakD (with pagination via startId)
-     * Step 2: Batch fetch full post data via bridge.get_post
+     * Fetch a page of snaps for a user via the hreplier API + Hive bridge.get_post.
+     *
+     * The hreplier endpoint returns the full snap-reference list in one shot and
+     * has no server-side pagination, so we cache it per (username, parent) and
+     * slice client-side. `startId` is repurposed as the slice offset (20-item
+     * pages):
+     *   - undefined / 0 → first 20 refs
+     *   - 20, 40, …     → subsequent pages
+     * `nextStartId` is the next offset to request, or null when exhausted.
+     *
+     * `parent` selects the container account — see SNAP_SUBTYPE_PARENTS
+     * (defaults to `peak.snaps`). Cache is keyed per parent so switching
+     * segments never collides.
+     *
+     * Only the current slice is materialised via bridge.get_post, so switching
+     * pages stays snappy.
      */
-    getUserSnaps(username: string, startId?: number, observer?: string, signal?: AbortSignal): Promise<{
+    getUserSnaps(username: string, startId?: number, observer?: string, signal?: AbortSignal, parent?: string): Promise<{
         snaps: Post[];
         nextStartId: number | null;
     }>;
@@ -73,7 +104,90 @@ declare class UserService {
     }>;
     /** Generic RPC call helper */
     private rpcCall;
+    /**
+     * Fetch daily growth analytics for an account over a `days` window
+     * (typically 7 or 30). Walks `get_account_history` backwards in pages of
+     * 1000 ops until the window cutoff is passed, buckets reward / power-up /
+     * power-down operations by UTC day, and reconstructs the cumulative HP
+     * trend by working back from the account's current effective HP.
+     *
+     * Reference: hivelytics (mrtats/hivelytics) — buildChartDays / addChartBucket / renderCharts.
+     */
+    getGrowthAnalytics(username: string, days?: number, onProgress?: (partial: GrowthAnalyticsResult) => void, signal?: AbortSignal): Promise<GrowthAnalyticsResult>;
+    private buildGrowthDays;
+    private initGrowthMap;
+    private dateKeyFromMs;
+    private vestsToHp;
+    private effectiveHp;
+    private buildGrowthResult;
     userAvatar(username: string): string;
 }
+export interface GrowthDay {
+    key: string;
+    label: string;
+}
+export interface GrowthBucket {
+    author: {
+        hp: number;
+        hive: number;
+        hbd: number;
+    };
+    curation: {
+        hp: number;
+        hive: number;
+        hbd: number;
+    };
+    witness: {
+        hp: number;
+        hive: number;
+        hbd: number;
+    };
+    benefactor: {
+        hp: number;
+        hive: number;
+        hbd: number;
+    };
+    hpDelta: number;
+    powerUp: number;
+    powerDown: number;
+    powerDownTo: number;
+}
+export interface GrowthDailyPoint {
+    key: string;
+    label: string;
+    cumulativeHp: number;
+    hpDelta: number;
+    powerUp: number;
+    powerDown: number;
+    powerDownTo: number;
+    authorHp: number;
+    curationHp: number;
+    witnessHp: number;
+    benefactorHp: number;
+    authorUsd: number;
+    curationUsd: number;
+    witnessUsd: number;
+    benefactorUsd: number;
+}
+export interface GrowthAnalyticsResult {
+    days: GrowthDay[];
+    series: GrowthDailyPoint[];
+    currentHp: number;
+    startHp: number;
+    hpDelta: number;
+    hivePrice: number;
+    totals: {
+        authorHp: number;
+        curationHp: number;
+        witnessHp: number;
+        benefactorHp: number;
+        powerUp: number;
+        powerDown: number;
+        authorUsd: number;
+        curationUsd: number;
+        witnessUsd: number;
+        benefactorUsd: number;
+    };
+}
 export declare const userService: UserService;
 export {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "hive-react-kit",
   "private": false,
-  "version": "0.9.0",
+  "version": "0.9.2",
   "type": "module",
   "main": "./dist/index.cjs.js",
   "module": "./dist/index.esm.js",