funhi-chart 1.0.0

package/dist/dts/components/FunhiChart.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+export interface ChartProps {
+    mint: string;
+    ticker?: string;
+    tokenName?: string;
+    socket?: any;
+    isConnected?: boolean;
+    currentMarketCap?: number;
+    analyticsConnected?: boolean;
+    analyticsLoading?: boolean;
+}
+declare const FunhiChart: React.FC<ChartProps>;
+export default FunhiChart;

package/dist/dts/components/ProfessionalTradingChartRedux.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+export interface ChartProps {
+    mint: string;
+    ticker?: string;
+    tokenName?: string;
+    socket?: any;
+    isConnected?: boolean;
+    currentMarketCap?: number;
+    analyticsConnected?: boolean;
+    analyticsLoading?: boolean;
+}
+declare const ProfessionalTradingChartRedux: React.FC<ChartProps>;
+export default ProfessionalTradingChartRedux;

package/dist/dts/config/environment.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Environment Configuration for Funhi Chart
+ *
+ * This file provides configuration for the chart component
+ * Users can override these values by passing them as props
+ */
+export declare const API_CONFIG: {
+    readonly BASE_URL: any;
+    readonly TIMEOUT: 10000;
+    readonly MAX_RETRIES: 3;
+    readonly RETRY_DELAY: 1000;
+};

package/dist/dts/hooks/useOptimizedTokenAnalytics.d.ts

@@ -0,0 +1,94 @@
+interface ComprehensiveAnalytics {
+    performance: {
+        '24H': {
+            gain: number;
+            percentage: string;
+            isPositive: boolean;
+        };
+        '7D': {
+            gain: number;
+            percentage: string;
+            isPositive: boolean;
+        };
+        '1M': {
+            gain: number;
+            percentage: string;
+            isPositive: boolean;
+        };
+        'All Time': {
+            gain: number;
+            percentage: string;
+            isPositive: boolean;
+        };
+    };
+    market: {
+        marketValue: string;
+        price: string;
+        marketCap: string;
+        circulating: string;
+        totalSupply: string;
+    };
+    '24H': {
+        high: string;
+        low: string;
+        volume: string;
+        return: string;
+    };
+    volume: {
+        current: string;
+        '24h': string;
+        unit: string;
+    };
+    blockchain: {
+        currentRealSol: string;
+        realSolReserves: number;
+        virtualSolReserves: number;
+        tokenReserves: number;
+    };
+    additional: {
+        solUsdPrice: string;
+        timestamp: number;
+    };
+}
+interface EnhancedTokenAnalytics {
+    analytics: ComprehensiveAnalytics | null;
+    currentPrice: number;
+    currentMarketCap: number;
+    currentVolume: number;
+    performance24h: {
+        value: string;
+        isPositive: boolean;
+        raw: number;
+    };
+    performance7d: {
+        value: string;
+        isPositive: boolean;
+        raw: number;
+    };
+    performance1m: {
+        value: string;
+        isPositive: boolean;
+        raw: number;
+    };
+    performanceAllTime: {
+        value: string;
+        isPositive: boolean;
+        raw: number;
+    };
+    high24h: number;
+    low24h: number;
+    volume24h: number;
+    return24h: number;
+    loading: boolean;
+    error: string | null;
+    connected: boolean;
+    lastUpdate: number | null;
+    isRealVolume: (volume: number) => boolean;
+}
+/**
+ * Simplified hook for token analytics
+ * This is a stub version for the NPM package
+ * Users should provide their own analytics data or implement their own hook
+ */
+export declare function useOptimizedTokenAnalytics(mint: string | undefined, analyticsData?: any): EnhancedTokenAnalytics;
+export {};

package/dist/dts/hooks/useSocket.d.ts

@@ -0,0 +1,46 @@
+import { Socket } from 'socket.io-client';
+interface OHLCVCandle {
+    time: number;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+    volume: number;
+}
+interface OHLCVInitialData {
+    mint: string;
+    timeFrame: number;
+    data: OHLCVCandle[];
+    timestamp: number;
+    error?: string;
+}
+interface OHLCVUpdateData {
+    mint: string;
+    timeFrame: number;
+    candle: OHLCVCandle;
+    timestamp: number;
+}
+interface OHLCVNewCandleData {
+    mint: string;
+    timeFrame: number;
+    candle: OHLCVCandle;
+    timestamp: number;
+}
+/**
+ * Hook to manage socket connection
+ * This is a simplified version for the NPM package
+ * Users should provide their own socket instance via props
+ */
+export declare const useSocket: (socketInstance?: Socket | null) => {
+    socket: Socket<import("@socket.io/component-emitter").DefaultEventsMap, import("@socket.io/component-emitter").DefaultEventsMap> | null;
+    isConnected: boolean;
+    isConnecting: boolean;
+    connect: () => void;
+    disconnect: () => void;
+    subscribeToOHLCV: (mint: string, timeFrame?: number, onInitialData?: (data: OHLCVInitialData) => void, onUpdate?: (data: OHLCVUpdateData) => void, onNewCandle?: (data: OHLCVNewCandleData) => void) => boolean;
+    unsubscribeFromOHLCV: (mint: string, timeFrame?: number, onInitialData?: (data: OHLCVInitialData) => void, onUpdate?: (data: OHLCVUpdateData) => void, onNewCandle?: (data: OHLCVNewCandleData) => void) => boolean;
+    subscribeToPrice: (mint: string, onPriceUpdate?: (data: any) => void) => boolean;
+    unsubscribeFromPrice: (mint: string, onPriceUpdate?: (data: any) => void) => boolean;
+    testConnection: (message: string) => boolean;
+};
+export {};

package/dist/dts/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Funhi Chart - Professional Real-Time Trading Chart Component
+ *
+ * A powerful React chart component powered by TradingView's Lightweight Charts
+ * with built-in WebSocket support for real-time data updates.
+ *
+ * @packageDocumentation
+ */
+export { default as FunhiChart } from './components/FunhiChart';
+export { default as ProfessionalTradingChartRedux } from './components/FunhiChart';
+export type { ChartProps } from './components/FunhiChart';
+export { useSocket } from './hooks/useSocket';
+export { useOptimizedTokenAnalytics } from './hooks/useOptimizedTokenAnalytics';
+export { candleStorageService } from './services/candleStorage';
+export type { CandleData, SaveCandlesRequest, GetCandlesRequest, SaveCandleRequest } from './services/candleStorage';
+export { candleAggregation } from './utils/candleAggregation';
+export type { TimeFrame } from './utils/candleAggregation';
+export { API_CONFIG } from './config/environment';

package/dist/dts/services/candleStorage.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Candle Storage Service
+ * Handles saving and retrieving candles from database via API
+ * Replaces localStorage with database storage for persistent candle data
+ */
+export interface CandleData {
+    time: number;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+    volume: number;
+}
+export interface SaveCandlesRequest {
+    mint: string;
+    candles: CandleData[];
+    timeFrame?: number;
+}
+export interface GetCandlesRequest {
+    mint: string;
+    timeFrame?: number;
+    limit?: number;
+}
+export interface SaveCandleRequest {
+    mint: string;
+    candle: CandleData;
+    timeFrame?: number;
+}
+declare class CandleStorageService {
+    private readonly baseURL;
+    private savingQueue;
+    private readonly BATCH_DELAY;
+    private readonly BATCH_SIZE;
+    /**
+     * Save multiple candles to database
+     * Uses batching to reduce API calls
+     */
+    saveCandles(request: SaveCandlesRequest): Promise<boolean>;
+    /**
+     * Save a single candle to database
+     * Batches candles to reduce API calls
+     */
+    saveCandle(request: SaveCandleRequest): Promise<boolean>;
+    /**
+     * Flush the batching queue and save to database
+     */
+    private flushQueue;
+    /**
+     * Get candles from database
+     */
+    getCandles(request: GetCandlesRequest): Promise<CandleData[]>;
+    /**
+     * Flush all pending queues before component unmount
+     */
+    flushAll(): Promise<void>;
+}
+export declare const candleStorageService: CandleStorageService;
+export {};

package/dist/dts/utils/candleAggregation.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Candle Aggregation Utility
+ *
+ * Client-side aggregation of 1-minute candles into larger timeframes
+ * This provides real-time aggregation without waiting for server responses
+ */
+export interface CandleData {
+    time: number;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+    volume: number;
+}
+export interface TimeFrame {
+    label: string;
+    value: string;
+    seconds: number;
+}
+declare class CandleAggregation {
+    private timeframes;
+    /**
+     * Aggregate 1-minute candles into a larger timeframe
+     */
+    aggregateCandles(oneMinuteCandles: CandleData[], targetTimeframe: number): CandleData[];
+    /**
+     * Aggregate a group of candles into a single candle
+     */
+    private aggregateGroup;
+    /**
+     * Get human-readable timeframe label
+     */
+    getTimeframeLabel(seconds: number): string;
+    /**
+     * Get timeframe in seconds from label
+     */
+    getTimeframeSeconds(label: string): number;
+    /**
+     * Fill gaps in candles with flat candles (same OHLC)
+     * This ensures continuous chart rendering
+     */
+    fillGaps(candles: CandleData[], timeframe: number): CandleData[];
+    /**
+     * Get the current incomplete candle for a timeframe
+     * This is used for real-time updates
+     */
+    getCurrentCandle(oneMinuteCandles: CandleData[], targetTimeframe: number): CandleData | null;
+    /**
+     * Update real-time candle with new 1-minute candle
+     * Returns updated array of aggregated candles
+     */
+    updateRealtimeCandle(aggregatedCandles: CandleData[], newOneMinuteCandle: CandleData, targetTimeframe: number): CandleData[];
+    /**
+     * Validate candle data structure
+     */
+    isValidCandle(candle: any): candle is CandleData;
+    /**
+     * Clean invalid candles from array
+     */
+    cleanCandles(candles: CandleData[]): CandleData[];
+    /**
+     * Get the minimum number of 1-minute candles needed for a timeframe
+     */
+    getRequiredOneMinuteCandles(targetTimeframe: number, targetCount?: number): number;
+}
+export declare const candleAggregation: CandleAggregation;
+export {};

package/dist/index.d.ts

@@ -0,0 +1,295 @@
+import React from 'react';
+import * as _socket_io_component_emitter from '@socket.io/component-emitter';
+import { Socket } from 'socket.io-client';
+
+interface ChartProps {
+    mint: string;
+    ticker?: string;
+    tokenName?: string;
+    socket?: any;
+    isConnected?: boolean;
+    currentMarketCap?: number;
+    analyticsConnected?: boolean;
+    analyticsLoading?: boolean;
+}
+declare const FunhiChart: React.FC<ChartProps>;
+
+interface OHLCVCandle {
+    time: number;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+    volume: number;
+}
+interface OHLCVInitialData {
+    mint: string;
+    timeFrame: number;
+    data: OHLCVCandle[];
+    timestamp: number;
+    error?: string;
+}
+interface OHLCVUpdateData {
+    mint: string;
+    timeFrame: number;
+    candle: OHLCVCandle;
+    timestamp: number;
+}
+interface OHLCVNewCandleData {
+    mint: string;
+    timeFrame: number;
+    candle: OHLCVCandle;
+    timestamp: number;
+}
+/**
+ * Hook to manage socket connection
+ * This is a simplified version for the NPM package
+ * Users should provide their own socket instance via props
+ */
+declare const useSocket: (socketInstance?: Socket | null) => {
+    socket: Socket<_socket_io_component_emitter.DefaultEventsMap, _socket_io_component_emitter.DefaultEventsMap> | null;
+    isConnected: boolean;
+    isConnecting: boolean;
+    connect: () => void;
+    disconnect: () => void;
+    subscribeToOHLCV: (mint: string, timeFrame?: number, onInitialData?: (data: OHLCVInitialData) => void, onUpdate?: (data: OHLCVUpdateData) => void, onNewCandle?: (data: OHLCVNewCandleData) => void) => boolean;
+    unsubscribeFromOHLCV: (mint: string, timeFrame?: number, onInitialData?: (data: OHLCVInitialData) => void, onUpdate?: (data: OHLCVUpdateData) => void, onNewCandle?: (data: OHLCVNewCandleData) => void) => boolean;
+    subscribeToPrice: (mint: string, onPriceUpdate?: (data: any) => void) => boolean;
+    unsubscribeFromPrice: (mint: string, onPriceUpdate?: (data: any) => void) => boolean;
+    testConnection: (message: string) => boolean;
+};
+
+interface ComprehensiveAnalytics {
+    performance: {
+        '24H': {
+            gain: number;
+            percentage: string;
+            isPositive: boolean;
+        };
+        '7D': {
+            gain: number;
+            percentage: string;
+            isPositive: boolean;
+        };
+        '1M': {
+            gain: number;
+            percentage: string;
+            isPositive: boolean;
+        };
+        'All Time': {
+            gain: number;
+            percentage: string;
+            isPositive: boolean;
+        };
+    };
+    market: {
+        marketValue: string;
+        price: string;
+        marketCap: string;
+        circulating: string;
+        totalSupply: string;
+    };
+    '24H': {
+        high: string;
+        low: string;
+        volume: string;
+        return: string;
+    };
+    volume: {
+        current: string;
+        '24h': string;
+        unit: string;
+    };
+    blockchain: {
+        currentRealSol: string;
+        realSolReserves: number;
+        virtualSolReserves: number;
+        tokenReserves: number;
+    };
+    additional: {
+        solUsdPrice: string;
+        timestamp: number;
+    };
+}
+interface EnhancedTokenAnalytics {
+    analytics: ComprehensiveAnalytics | null;
+    currentPrice: number;
+    currentMarketCap: number;
+    currentVolume: number;
+    performance24h: {
+        value: string;
+        isPositive: boolean;
+        raw: number;
+    };
+    performance7d: {
+        value: string;
+        isPositive: boolean;
+        raw: number;
+    };
+    performance1m: {
+        value: string;
+        isPositive: boolean;
+        raw: number;
+    };
+    performanceAllTime: {
+        value: string;
+        isPositive: boolean;
+        raw: number;
+    };
+    high24h: number;
+    low24h: number;
+    volume24h: number;
+    return24h: number;
+    loading: boolean;
+    error: string | null;
+    connected: boolean;
+    lastUpdate: number | null;
+    isRealVolume: (volume: number) => boolean;
+}
+/**
+ * Simplified hook for token analytics
+ * This is a stub version for the NPM package
+ * Users should provide their own analytics data or implement their own hook
+ */
+declare function useOptimizedTokenAnalytics(mint: string | undefined, analyticsData?: any): EnhancedTokenAnalytics;
+
+/**
+ * Candle Storage Service
+ * Handles saving and retrieving candles from database via API
+ * Replaces localStorage with database storage for persistent candle data
+ */
+interface CandleData$1 {
+    time: number;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+    volume: number;
+}
+interface SaveCandlesRequest {
+    mint: string;
+    candles: CandleData$1[];
+    timeFrame?: number;
+}
+interface GetCandlesRequest {
+    mint: string;
+    timeFrame?: number;
+    limit?: number;
+}
+interface SaveCandleRequest {
+    mint: string;
+    candle: CandleData$1;
+    timeFrame?: number;
+}
+declare class CandleStorageService {
+    private readonly baseURL;
+    private savingQueue;
+    private readonly BATCH_DELAY;
+    private readonly BATCH_SIZE;
+    /**
+     * Save multiple candles to database
+     * Uses batching to reduce API calls
+     */
+    saveCandles(request: SaveCandlesRequest): Promise<boolean>;
+    /**
+     * Save a single candle to database
+     * Batches candles to reduce API calls
+     */
+    saveCandle(request: SaveCandleRequest): Promise<boolean>;
+    /**
+     * Flush the batching queue and save to database
+     */
+    private flushQueue;
+    /**
+     * Get candles from database
+     */
+    getCandles(request: GetCandlesRequest): Promise<CandleData$1[]>;
+    /**
+     * Flush all pending queues before component unmount
+     */
+    flushAll(): Promise<void>;
+}
+declare const candleStorageService: CandleStorageService;
+
+/**
+ * Candle Aggregation Utility
+ *
+ * Client-side aggregation of 1-minute candles into larger timeframes
+ * This provides real-time aggregation without waiting for server responses
+ */
+interface CandleData {
+    time: number;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+    volume: number;
+}
+interface TimeFrame {
+    label: string;
+    value: string;
+    seconds: number;
+}
+declare class CandleAggregation {
+    private timeframes;
+    /**
+     * Aggregate 1-minute candles into a larger timeframe
+     */
+    aggregateCandles(oneMinuteCandles: CandleData[], targetTimeframe: number): CandleData[];
+    /**
+     * Aggregate a group of candles into a single candle
+     */
+    private aggregateGroup;
+    /**
+     * Get human-readable timeframe label
+     */
+    getTimeframeLabel(seconds: number): string;
+    /**
+     * Get timeframe in seconds from label
+     */
+    getTimeframeSeconds(label: string): number;
+    /**
+     * Fill gaps in candles with flat candles (same OHLC)
+     * This ensures continuous chart rendering
+     */
+    fillGaps(candles: CandleData[], timeframe: number): CandleData[];
+    /**
+     * Get the current incomplete candle for a timeframe
+     * This is used for real-time updates
+     */
+    getCurrentCandle(oneMinuteCandles: CandleData[], targetTimeframe: number): CandleData | null;
+    /**
+     * Update real-time candle with new 1-minute candle
+     * Returns updated array of aggregated candles
+     */
+    updateRealtimeCandle(aggregatedCandles: CandleData[], newOneMinuteCandle: CandleData, targetTimeframe: number): CandleData[];
+    /**
+     * Validate candle data structure
+     */
+    isValidCandle(candle: any): candle is CandleData;
+    /**
+     * Clean invalid candles from array
+     */
+    cleanCandles(candles: CandleData[]): CandleData[];
+    /**
+     * Get the minimum number of 1-minute candles needed for a timeframe
+     */
+    getRequiredOneMinuteCandles(targetTimeframe: number, targetCount?: number): number;
+}
+declare const candleAggregation: CandleAggregation;
+
+/**
+ * Environment Configuration for Funhi Chart
+ *
+ * This file provides configuration for the chart component
+ * Users can override these values by passing them as props
+ */
+declare const API_CONFIG: {
+    readonly BASE_URL: any;
+    readonly TIMEOUT: 10000;
+    readonly MAX_RETRIES: 3;
+    readonly RETRY_DELAY: 1000;
+};
+
+export { API_CONFIG, FunhiChart, FunhiChart as ProfessionalTradingChartRedux, candleAggregation, candleStorageService, useOptimizedTokenAnalytics, useSocket };
+export type { CandleData$1 as CandleData, ChartProps, GetCandlesRequest, SaveCandleRequest, SaveCandlesRequest, TimeFrame };