hive-stream 2.0.6 → 3.0.1

package/dist/streamer.d.ts

@@ -1,93 +1,233 @@
-import { AdapterBase } from './adapters/base.adapter';
-import { TimeAction } from './actions';
-import { ConfigInterface } from './config';
-export declare class Streamer {
-    private customJsonSubscriptions;
-    private customJsonIdSubscriptions;
-    private customJsonHiveEngineSubscriptions;
-    private commentSubscriptions;
-    private postSubscriptions;
-    private transferSubscriptions;
-    private attempts;
-    private config;
-    private client;
-    private hive;
-    private username;
-    private postingKey;
-    private activeKey;
-    private blockNumberTimeout;
-    private latestBlockTimer;
-    private lastBlockNumber;
-    private blockId;
-    private previousBlockId;
-    private transactionId;
-    private blockTime;
-    private latestBlockchainTime;
-    private disableAllProcessing;
-    private contracts;
-    private adapter;
-    private actions;
-    private utils;
-    constructor(userConfig?: Partial<ConfigInterface>);
-    registerAdapter(adapter: any): void;
-    getAdapter(): AdapterBase;
-    /**
-     * Register a new action
-     *
-     */
-    registerAction(action: TimeAction): Promise<void>;
-    /**
-     * Resets a specific action time value
-     *
-     * @param id
-     *
-     */
-    resetAction(id: string): void;
-    registerContract(name: string, contract: any): this;
-    unregisterContract(name: string): void;
-    /**
-     * setConfig
-     *
-     * Allows specific configuration settings to be overridden
-     *
-     * @param config
-     */
-    setConfig(config: Partial<ConfigInterface>): this;
-    /**
-     * Start
-     *
-     * Starts the streamer bot to get blocks from the Hive API
-     *
-     */
-    start(): Promise<Streamer>;
-    /**
-     * Stop
-     *
-     * Stops the streamer from running
-     */
-    stop(): Promise<void>;
-    private getLatestBlock;
-    private getBlock;
-    private loadBlock;
-    processOperation(op: any, blockNumber: number, blockId: string, prevBlockId: string, trxId: string, blockTime: Date): void;
-    private processActions;
-    saveStateToDisk(): Promise<void>;
-    saveToHiveApi(from: string, data: string): Promise<import("@hiveio/dhive").TransactionConfirmation>;
-    getAccountTransfers(account: string, from?: number, limit?: number): Promise<any>;
-    transferHiveTokens(from: string, to: string, amount: string, symbol: string, memo?: string): Promise<import("@hiveio/dhive").TransactionConfirmation>;
-    transferHiveTokensMultiple(from: string, accounts: string[], amount: string, symbol: string, memo?: string): Promise<boolean>;
-    transferHiveEngineTokens(from: string, to: string, symbol: string, quantity: string, memo?: string): Promise<import("@hiveio/dhive").TransactionConfirmation>;
-    transferHiveEngineTokensMultiple(from: string, accounts: any[], symbol: string, memo?: string, amount?: string): Promise<void>;
-    issueHiveEngineTokens(from: string, to: string, symbol: string, quantity: string, memo?: string): Promise<import("@hiveio/dhive").TransactionConfirmation>;
-    issueHiveEngineTokensMultiple(from: string, accounts: any[], symbol: string, memo?: string, amount?: string): Promise<void>;
-    upvote(votePercentage: string, username: string, permlink: string): Promise<import("@hiveio/dhive").TransactionConfirmation>;
-    downvote(votePercentage: string, username: string, permlink: string): Promise<import("@hiveio/dhive").TransactionConfirmation>;
-    getTransaction(blockNumber: number, transactionId: string): Promise<import("@hiveio/dhive").SignedTransaction>;
-    verifyTransfer(transaction: any, from: string, to: string, amount: string): Promise<boolean>;
-    onComment(callback: any): void;
-    onPost(callback: any): void;
-    onTransfer(account: string, callback: () => void): void;
-    onCustomJson(callback: any): void;
-    onCustomJsonId(callback: any, id: string): void;
-    onHiveEngine(callback: any): void;
-}
+import { AdapterBase } from './adapters/base.adapter';
+import { TimeAction } from './actions';
+import { ConfigInterface } from './config';
+import { ContractDefinition, EscrowOperationType } from './types/hive-stream';
+export declare class Streamer {
+    private customJsonSubscriptions;
+    private customJsonIdSubscriptions;
+    private customJsonHiveEngineSubscriptions;
+    private commentSubscriptions;
+    private postSubscriptions;
+    private transferSubscriptions;
+    private escrowSubscriptions;
+    private attempts;
+    private config;
+    private client;
+    private hive;
+    private username;
+    private postingKey;
+    private activeKey;
+    private blockNumberTimeout;
+    private latestBlockTimer;
+    private lastBlockNumber;
+    private headBlockNumber;
+    private isPollingBlock;
+    private isCatchingUp;
+    private blockId;
+    private previousBlockId;
+    private transactionId;
+    private blockTime;
+    private latestBlockchainTime;
+    private disableAllProcessing;
+    private contracts;
+    private adapter;
+    private actions;
+    private lastStateSave;
+    private stateSaveInterval;
+    private blockProcessingQueue;
+    private isProcessingQueue;
+    private readonly maxSubscriptions;
+    private subscriptionCleanupInterval;
+    private actionFrequencyMap;
+    private contractCache;
+    private blockCache;
+    private transactionCache;
+    private accountCache;
+    private readonly cacheTimeout;
+    private readonly maxCacheSize;
+    private utils;
+    constructor(userConfig?: Partial<ConfigInterface>);
+    private _initializeAdapter;
+    registerAdapter(adapter: AdapterBase): Promise<void>;
+    getAdapter(): AdapterBase;
+    /**
+     * Register a new action with improved validation and persistence
+     */
+    registerAction(action: TimeAction): Promise<void>;
+    /**
+     * Validate that the contract and method exist for the action
+     */
+    private validateActionContract;
+    private isActionTriggerAllowed;
+    /**
+     * Remove an action by ID
+     */
+    removeAction(actionId: string): Promise<boolean>;
+    /**
+     * Get all registered actions
+     */
+    getActions(): TimeAction[];
+    /**
+     * Get action by ID
+     */
+    getAction(actionId: string): TimeAction | undefined;
+    /**
+     * Enable/disable an action
+     */
+    setActionEnabled(actionId: string, enabled: boolean): Promise<boolean>;
+    /**
+     * Save actions to disk asynchronously
+     */
+    private saveActionsToDisk;
+    /**
+     * Resets a specific action time value
+     */
+    resetAction(id: string): Promise<boolean>;
+    registerContract(contract: ContractDefinition): Promise<void>;
+    unregisterContract(name: string): Promise<void>;
+    /**
+     * setConfig
+     *
+     * Allows specific configuration settings to be overridden
+     *
+     * @param config
+     */
+    setConfig(config: Partial<ConfigInterface>): this;
+    /**
+     * Start
+     *
+     * Starts the streamer bot to get blocks from the Hive API
+     *
+     */
+    start(): Promise<Streamer>;
+    /**
+     * Stop
+     *
+     * Stops the streamer from running
+     */
+    stop(): Promise<void>;
+    private getLatestBlock;
+    private getBlock;
+    private loadBlock;
+    processOperation(op: [string, any], blockNumber: number, blockId: string, prevBlockId: string, trxId: string, blockTime: Date): Promise<void>;
+    private normalizeContractPayload;
+    private isEscrowOperationType;
+    private buildEscrowDetails;
+    private buildContractContext;
+    private dispatchContractAction;
+    private processActions;
+    /**
+     * Clean up completed or disabled actions to prevent memory leaks
+     */
+    private cleanupActions;
+    saveStateToDisk(): Promise<void>;
+    private saveStateThrottled;
+    saveToHiveApi(from: string, data: string): Promise<import("@hiveio/dhive").TransactionConfirmation>;
+    getAccountTransfers(account: string, from?: number, limit?: number): Promise<any[]>;
+    transferHiveTokens(from: string, to: string, amount: string, symbol: string, memo?: string): Promise<import("@hiveio/dhive").TransactionConfirmation>;
+    transferHiveTokensMultiple(from: string, accounts: string[], amount: string, symbol: string, memo?: string): Promise<boolean>;
+    broadcastOperations(operations: Array<[string, any]>, signingKeys?: string | string[]): Promise<import("@hiveio/dhive").TransactionConfirmation>;
+    broadcastMultiSigOperations(operations: Array<[string, any]>, signingKeys: string[]): any;
+    createAuthority(keyAuths?: Array<[string, number]>, accountAuths?: Array<[string, number]>, weightThreshold?: number): any;
+    updateAccountAuthorities(account: string, authorityUpdate: {
+        owner?: any;
+        active?: any;
+        posting?: any;
+        memo_key?: string;
+        json_metadata?: string;
+        posting_json_metadata?: string;
+        useAccountUpdate2?: boolean;
+    }, signingKeys?: string | string[]): Promise<any>;
+    escrowTransfer(options: {
+        from: string;
+        to: string;
+        agent: string;
+        escrow_id: number;
+        hive_amount?: string;
+        hbd_amount?: string;
+        fee: string;
+        ratification_deadline: string | Date;
+        escrow_expiration: string | Date;
+        json_meta?: string | Record<string, any>;
+    }, signingKeys?: string | string[]): any;
+    escrowApprove(options: {
+        from: string;
+        to: string;
+        agent: string;
+        who: string;
+        escrow_id: number;
+        approve: boolean;
+    }, signingKeys?: string | string[]): any;
+    escrowDispute(options: {
+        from: string;
+        to: string;
+        agent: string;
+        who: string;
+        escrow_id: number;
+    }, signingKeys?: string | string[]): any;
+    escrowRelease(options: {
+        from: string;
+        to: string;
+        agent: string;
+        who: string;
+        receiver: string;
+        escrow_id: number;
+        hive_amount?: string;
+        hbd_amount?: string;
+    }, signingKeys?: string | string[]): any;
+    recurrentTransfer(options: {
+        from: string;
+        to: string;
+        amount: string;
+        memo?: string;
+        recurrence: number;
+        executions: number;
+    }, signingKeys?: string | string[]): any;
+    createProposal(options: {
+        creator: string;
+        receiver: string;
+        start_date: string | Date;
+        end_date: string | Date;
+        daily_pay: string;
+        subject: string;
+        permlink: string;
+    }, signingKeys?: string | string[]): any;
+    updateProposalVotes(options: {
+        voter: string;
+        proposal_ids: number[];
+        approve: boolean;
+    }, signingKeys?: string | string[]): any;
+    removeProposals(options: {
+        proposal_owner: string;
+        proposal_ids: number[];
+    }, signingKeys?: string | string[]): any;
+    transferHiveEngineTokens(from: string, to: string, symbol: string, quantity: string, memo?: string): Promise<import("@hiveio/dhive").TransactionConfirmation>;
+    transferHiveEngineTokensMultiple(from: string, accounts: any[], symbol: string, memo?: string, amount?: string): Promise<void>;
+    issueHiveEngineTokens(from: string, to: string, symbol: string, quantity: string, memo?: string): Promise<import("@hiveio/dhive").TransactionConfirmation>;
+    issueHiveEngineTokensMultiple(from: string, accounts: any[], symbol: string, memo?: string, amount?: string): Promise<void>;
+    upvote(votePercentage: string, username: string, permlink: string): Promise<import("@hiveio/dhive").TransactionConfirmation>;
+    downvote(votePercentage: string, username: string, permlink: string): Promise<import("@hiveio/dhive").TransactionConfirmation>;
+    getTransaction(blockNumber: number, transactionId: string): Promise<import("@hiveio/dhive").SignedTransaction>;
+    getStatus(): {
+        lastBlockNumber: number;
+        headBlockNumber: number;
+        blocksBehind: number;
+        latestBlockchainTime: Date;
+        isCatchingUp: boolean;
+    };
+    verifyTransfer(transaction: any, from: string, to: string, amount: string): Promise<boolean>;
+    onComment(callback: any): void;
+    onPost(callback: any): void;
+    onTransfer(account: string, callback: () => void): void;
+    onCustomJson(callback: any): void;
+    onCustomJsonId(callback: any, id: string): void;
+    onHiveEngine(callback: any): void;
+    onEscrowTransfer(callback: any): void;
+    onEscrowApprove(callback: any): void;
+    onEscrowDispute(callback: any): void;
+    onEscrowRelease(callback: any): void;
+    private cleanupSubscriptions;
+    removeTransferSubscription(account: string): void;
+    removeCustomJsonIdSubscription(id: string): void;
+    removeEscrowSubscriptions(type?: EscrowOperationType): void;
+}