hive-react-kit 0.10.0 → 0.10.2

package/dist/services/communityService.d.ts

@@ -1,6 +1,8 @@
 import { CommunityItem, CommunityDetailsResponse, CommunitySubscriber, CommunityActivity } from '../types/community';
 declare class CommunityService {
-    private readonly HIVE_API_URL;
+    /** Always read the latest endpoint — `setHiveApiEndpoint()` may have been
+     * called after construction, and a stale instance field would miss it. */
+    private get HIVE_API_URL();
     getListOfCommunities(query?: string, limit?: number, last?: string): Promise<CommunityItem[]>;
     getCommunityDetails(communityId: string): Promise<CommunityDetailsResponse>;
     getCommunitySubscribers(communityId: string, limit?: number, last?: string): Promise<CommunitySubscriber[]>;

package/dist/services/userService.d.ts

@@ -16,7 +16,9 @@ export declare const SNAP_SUBTYPE_PARENTS: {
 };
 export type SnapSubType = keyof typeof SNAP_SUBTYPE_PARENTS;
 declare class UserService {
-    private readonly HIVE_API_URL;
+    /** Always read the latest endpoint — `setHiveApiEndpoint()` may have been
+     * called after construction, and a stale instance field would miss it. */
+    private get HIVE_API_URL();
     /** Central fetch wrapper — threads AbortSignal to every network request */
     private _fetch;
     getProfile(username: string, signal?: AbortSignal): Promise<UserProfileResponse>;

package/dist/utils/beneficiaries.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Beneficiary helpers used by PostComposer's BeneficiariesEditor and by
+ * apps that broadcast Hive `comment_options`. The composer emits the chosen
+ * list via `onBeneficiariesChange`; the consumer calls
+ * `buildBeneficiariesCommentOptions(...)` (or `mergeBeneficiariesIntoCommentOptions`)
+ * at broadcast time.
+ *
+ * In the UI we work in **whole percent** units (1–100). On the wire Hive uses
+ * basis points (1% = 100, 100% = 10_000). The conversion happens when we
+ * build the operation tuple.
+ */
+import type { RewardOption } from './commentOptions';
+/** 3Speak fund account that must receive 10% on any video post or video comment. */
+export declare const THREESPEAK_FUND_ACCOUNT = "threespeakfund";
+/** Locked weight for the 3Speak fund beneficiary, expressed in whole-percent UI units. */
+export declare const THREESPEAK_FUND_PERCENT = 10;
+export interface Beneficiary {
+    /** Hive account name (lowercase, no leading @). */
+    account: string;
+    /** Whole-percent weight in [1, 100]. Hive's basis-point weight is computed as `weight * 100`. */
+    weight: number;
+}
+/** Detect a 3Speak video embed in the body — matches the URLs the composer appends. */
+export declare function bodyHasVideo(body: string): boolean;
+/** Normalize an account name — lowercase, strip leading `@`, trim whitespace. */
+export declare function normalizeBeneficiaryAccount(account: string): string;
+/**
+ * Sanitize a beneficiary list:
+ * - normalize account names, drop empty/invalid entries
+ * - clamp weights to [1, 100] (whole percent)
+ * - dedupe by account (later entries override earlier)
+ */
+export declare function sanitizeBeneficiaries(list: Beneficiary[] | undefined): Beneficiary[];
+/** Sum of beneficiary weights in whole-percent units. */
+export declare function totalBeneficiaryWeight(list: Beneficiary[] | undefined): number;
+/**
+ * Enforce the 3Speak fund rule: when a post/comment has video content, the
+ * `threespeakfund` account must receive 10% and is non-removable, so the
+ * remaining user-controlled allocation is capped at 90%.
+ *
+ * Strategy:
+ * 1. Strip any existing `threespeakfund` entry from `userList`.
+ * 2. Scale the remaining entries proportionally so their sum ≤ 90%.
+ * 3. Prepend a locked `threespeakfund` 10% entry.
+ *
+ * If `hasVideo` is false, returns `sanitizeBeneficiaries(userList)` unchanged.
+ */
+export declare function enforceVideoBeneficiaries(userList: Beneficiary[] | undefined, hasVideo: boolean): Beneficiary[];
+type CommentOptionsOp = [
+    'comment_options',
+    {
+        author: string;
+        permlink: string;
+        allow_votes: boolean;
+        allow_curation_rewards: boolean;
+        max_accepted_payout: string;
+        percent_hbd: number;
+        extensions: unknown[];
+    }
+];
+/**
+ * Build a standalone `comment_options` op carrying the beneficiary list.
+ * Returns `null` when there are no beneficiaries.
+ *
+ * For most posts this is what consumers want when reward routing is `'default'`.
+ * To combine beneficiaries with non-default reward routing, use
+ * `mergeBeneficiariesIntoCommentOptions` instead.
+ */
+export declare function buildBeneficiariesCommentOptions(author: string, permlink: string, beneficiaries: Beneficiary[] | undefined): CommentOptionsOp | null;
+/**
+ * Combine reward routing (power_up / burn / decline / default) with a
+ * user-chosen beneficiary list into a single `comment_options` op.
+ *
+ * Notes:
+ * - For `'burn'`, all rewards already go to `null` — additional beneficiaries
+ *   are ignored to keep the burn intent clean.
+ * - For all other options, the user's beneficiary list is included verbatim.
+ * - Returns `null` when there is nothing to broadcast (default reward + no
+ *   beneficiaries).
+ */
+export declare function mergeBeneficiariesIntoCommentOptions(author: string, permlink: string, reward: RewardOption, beneficiaries: Beneficiary[] | undefined): CommentOptionsOp | null;
+export {};

package/package.json

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