@pear-protocol/hyperliquid-sdk 0.0.33 → 0.0.35

package/dist/clients/notifications.d.ts

@@ -0,0 +1,7 @@
+import type { ApiResponse } from '../types';
+/**
+ * Mark notifications as read up to a given timestamp (ms)
+ */
+export declare function markNotificationsRead(baseUrl: string, accessToken: string, timestampMs: number): Promise<ApiResponse<{
+    updated: number;
+}>>;

package/dist/hooks/useNotifications.d.ts

@@ -2,6 +2,9 @@ import type { NotificationDto } from '../types';
 export interface UseNotificationsResult {
     notifications: NotificationDto[] | null;
     unreadCount: number;
+    markReadUntil: (timestampMs: number) => Promise<{
+        updated: number;
+    }>;
 }
 /**
  * Provides notifications and fills checkpoint data sourced from the SDK WebSocket.

package/dist/index.d.ts

@@ -53,7 +53,7 @@ interface WebSocketDataMessage<T = unknown> {
     channel: WebSocketChannel;
     data: T;
 }
-type NotificationCategory = 'TRADE_OPENED_OUTSIDE_PEAR' | 'POSITION_LIQUIDATED' | 'LIMIT_ORDER_FILLED' | 'LIMIT_ORDER_FAILED' | 'TP_ORDER_FILLED' | 'TP_ORDER_FAILED' | 'SL_ORDER_FILLED' | 'SL_ORDER_FAILED';
+type NotificationCategory = 'TRADE_OPENED_OUTSIDE_PEAR' | 'TRADE_CLOSED_OUTSIDE_PEAR' | 'POSITION_LIQUIDATED' | 'LIMIT_ORDER_FILLED' | 'LIMIT_ORDER_FAILED' | 'TP_ORDER_FILLED' | 'TP_ORDER_FAILED' | 'SL_ORDER_FILLED' | 'SL_ORDER_FAILED';
 interface NotificationDto {
     id: string;
     address: string;
@@ -197,11 +197,12 @@ type OrderStatus = 'OPEN' | 'PARTIALLY_FILLED' | 'PROCESSING';
 /**
  * Order type
  */
-type OrderType = 'TP' | 'SL' | 'LIMIT' | 'MARKET';
+type OrderType = 'TP' | 'SL' | 'LIMIT' | 'MARKET' | 'LIMIT_BTCDOM' | 'TWAP';
 /**
  * TP/SL trigger type
  */
-type TpSlTriggerType = 'RATIO' | 'PERCENTAGE' | 'PNL';
+type TpSlTriggerType = 'PERCENTAGE' | 'DOLLAR' | 'POSITION_VALUE';
+type OrderDirection = 'MORE_THAN' | 'LESS_THAN' | null;
 /**
  * Open limit order data structure
  */
@@ -209,16 +210,17 @@ interface OpenLimitOrderDto {
     orderId: string;
     address: string;
     clientId: string | null;
-    positionId: string;
+    positionId?: string | null;
     leverage: number;
     usdValue: number;
-    triggerValue: number;
-    twapDuration: number | null;
-    tpSlTriggerType: TpSlTriggerType;
+    triggerValue?: number | null;
+    twapDuration?: string | null;
+    tpSlTriggerType?: TpSlTriggerType | null;
     randomizeFlag: boolean;
     reduceOnlyFlag: boolean;
     status: OrderStatus;
     orderType: OrderType;
+    direction?: OrderDirection | null;
     longAssets: OrderAssetDto[];
     shortAssets: OrderAssetDto[];
     createdAt: string;
@@ -948,6 +950,9 @@ declare function useTwap(): {
 interface UseNotificationsResult {
     notifications: NotificationDto[] | null;
     unreadCount: number;
+    markReadUntil: (timestampMs: number) => Promise<{
+        updated: number;
+    }>;
 }
 /**
  * Provides notifications and fills checkpoint data sourced from the SDK WebSocket.
@@ -976,6 +981,13 @@ interface UseHyperliquidNativeWebSocketReturn {
 }
 declare const useHyperliquidNativeWebSocket: ({ address, }: UseHyperliquidNativeWebSocketProps) => UseHyperliquidNativeWebSocketReturn;
 
+/**
+ * Mark notifications as read up to a given timestamp (ms)
+ */
+declare function markNotificationsRead(baseUrl: string, accessToken: string, timestampMs: number): Promise<ApiResponse<{
+    updated: number;
+}>>;
+
 /**
  * Account summary calculation utility class
  */
@@ -1078,5 +1090,5 @@ declare function mapTradingViewIntervalToCandleInterval(interval: string): Candl
  */
 declare function mapCandleIntervalToTradingViewInterval(interval: CandleInterval): string;
 
-export { AccountSummaryCalculator, AuthStatus, ConflictDetector, PearHyperliquidProvider, TokenMetadataExtractor, adjustOrder, adjustPosition, calculateWeightedRatio, cancelOrder, cancelTwap, cancelTwapOrder, closePosition, computeBasketCandles, createCandleLookups, createPosition, getCompleteTimestamps, mapCandleIntervalToTradingViewInterval, mapTradingViewIntervalToCandleInterval, updateRiskParameters, useAccountSummary, useAddress, useAgentWallet, useAuth, useAutoSyncFills, useBasketCandles, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidNativeWebSocket, useHyperliquidWebSocket, useNotifications, useOpenOrders, useOrders, usePearAgentWallet, usePearAuth, usePearHyperliquid, usePerformanceOverlays, usePosition, useTokenSelectionMetadata, useTradeHistories, useTwap, useUserSelection, useWebData };
+export { AccountSummaryCalculator, AuthStatus, ConflictDetector, PearHyperliquidProvider, TokenMetadataExtractor, adjustOrder, adjustPosition, calculateWeightedRatio, cancelOrder, cancelTwap, cancelTwapOrder, closePosition, computeBasketCandles, createCandleLookups, createPosition, getCompleteTimestamps, mapCandleIntervalToTradingViewInterval, mapTradingViewIntervalToCandleInterval, markNotificationsRead, updateRiskParameters, useAccountSummary, useAddress, useAgentWallet, useAuth, useAutoSyncFills, useBasketCandles, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidNativeWebSocket, useHyperliquidWebSocket, useNotifications, useOpenOrders, useOrders, usePearAgentWallet, usePearAuth, usePearHyperliquid, usePerformanceOverlays, usePosition, useTokenSelectionMetadata, useTradeHistories, useTwap, useUserSelection, useWebData };
 export type { AccountSummaryResponseDto, AdjustExecutionType, AdjustOrderRequestInput, AdjustOrderResponseDto, AdjustPositionRequestInput, AdjustPositionResponseDto, AgentWalletDto, AgentWalletState, ApiErrorResponse, ApiResponse, AssetCtx, AssetInformationDetail, AssetMarketData, AssetPosition, AutoSyncFillsOptions, AutoSyncFillsState, BalanceSummaryDto, CancelOrderResponseDto, CancelTwapResponseDto, CandleChartData, CandleData, CandleInterval, CandleSnapshotRequest, ClearinghouseState, CloseExecutionType, ClosePositionRequestInput, ClosePositionResponseDto, CreatePositionRequestInput, CreatePositionResponseDto, CrossMarginSummaryDto, CumFundingDto, ExecutionType, HLWebSocketResponse, HistoricalRange, LadderConfigInput, MarginSummaryDto, NotificationCategory, NotificationDto, OpenLimitOrderDto, OpenPositionDto, OrderAssetDto, OrderStatus, PairAssetInput, PerformanceOverlay, PositionAdjustmentType, PositionAssetDetailDto, PositionAssetSummaryDto, PositionResponseStatus, RealtimeBar, RealtimeBarsCallback, TokenConflict, TokenHistoricalPriceData, TokenMetadata, TokenSelection, TpSlThresholdInput, TpSlThresholdType, TradeHistoryAssetDataDto, TradeHistoryDataDto, TwapChunkStatusDto, TwapMonitoringDto, UniverseAsset, UpdateRiskParametersRequestInput, UpdateRiskParametersResponseDto, UseAgentWalletOptions, UseAuthOptions, UseBasketCandlesReturn, UseHistoricalPriceDataReturn, UseNotificationsResult, UsePerformanceOverlaysReturn, UseTokenSelectionMetadataReturn, UserProfile, UserSelectionState, WebData2Response, WebSocketAckResponse, WebSocketChannel, WebSocketConnectionState, WebSocketDataMessage, WebSocketMessage, WebSocketSubscribeMessage, WsAllMidsData };

package/dist/index.js

@@ -8363,7 +8363,12 @@ const calculatePositionAsset = (asset, currentPrice, totalInitialPositionSize, l
 };
 const buildPositionValue = (rawPositions, webData2, allMids) => {
     return rawPositions.map((position) => {
-        const webData2Position = webData2.clearinghouseState.assetPositions.find(ap => ap.position.coin === position.longAssets[0].coin || ap.position.coin === position.shortAssets[0].coin);
+        const webData2Position = webData2.clearinghouseState.assetPositions.find(ap => {
+            var _a, _b, _c, _d;
+            const longCoin = (_b = (_a = position.longAssets) === null || _a === void 0 ? void 0 : _a[0]) === null || _b === void 0 ? void 0 : _b.coin;
+            const shortCoin = (_d = (_c = position.shortAssets) === null || _c === void 0 ? void 0 : _c[0]) === null || _d === void 0 ? void 0 : _d.coin;
+            return ap.position.coin === longCoin || ap.position.coin === shortCoin;
+        });
         let mappedPosition = {
             positionId: position.positionId,
             address: position.address,
@@ -8508,10 +8513,10 @@ function useOrders() {
         if (!openOrders)
             return null;
         return openOrders.map((ord) => {
-            var _a, _b, _c, _d;
+            var _a, _b, _c, _d, _e;
             const isTpSl = ord.orderType === 'TP' || ord.orderType === 'SL';
             const hasAssets = ((_b = (_a = ord.longAssets) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0) > 0 || ((_d = (_c = ord.shortAssets) === null || _c === void 0 ? void 0 : _c.length) !== null && _d !== void 0 ? _d : 0) > 0;
-            const pos = positionsById.get(ord.positionId);
+            const pos = positionsById.get((_e = ord.positionId) !== null && _e !== void 0 ? _e : '');
             if (!isTpSl || !pos)
                 return ord;
             // Build order assets from position weights when TP/SL has no assets
@@ -8564,12 +8569,28 @@ function useTwap() {
     return { orders, cancelTwap: cancelTwap$1 };
 }
 
+/**
+ * Mark notifications as read up to a given timestamp (ms)
+ */
+async function markNotificationsRead(baseUrl, accessToken, timestampMs) {
+    const url = joinUrl(baseUrl, '/notifications/read');
+    try {
+        const response = await axios$1.post(url, { timestamp: timestampMs }, { headers: { 'Content-Type': 'application/json', 'Authorization': `Bearer ${accessToken}` } });
+        return { data: response.data, status: response.status, headers: response.headers };
+    }
+    catch (error) {
+        throw toApiError(error);
+    }
+}
+
 /**
  * Provides notifications and fills checkpoint data sourced from the SDK WebSocket.
  * Data is persisted in the SDK's Zustand store.
  */
 function useNotifications() {
     const notifications = useUserData((state) => state.notifications);
+    const setNotifications = useUserData((state) => state.setNotifications);
+    const { apiBaseUrl, accessToken, isAuthenticated } = usePearHyperliquid();
     const unreadCount = useMemo(() => {
         if (!notifications)
             return 0;
@@ -8578,6 +8599,23 @@ function useNotifications() {
     return {
         notifications,
         unreadCount,
+        markReadUntil: useCallback(async (timestampMs) => {
+            if (!isAuthenticated || !accessToken)
+                throw new Error('Not authenticated');
+            const { data } = await markNotificationsRead(apiBaseUrl, accessToken, timestampMs);
+            // Optimistic local update for immediate UI feedback
+            if (notifications) {
+                const updated = notifications.map((n) => {
+                    const created = Date.parse(n.created_at);
+                    if (!isNaN(created) && created <= timestampMs) {
+                        return { ...n, is_read: true };
+                    }
+                    return n;
+                });
+                setNotifications(updated);
+            }
+            return data;
+        }, [apiBaseUrl, accessToken, isAuthenticated, notifications, setNotifications]),
     };
 }
 
@@ -8879,4 +8917,4 @@ function mapCandleIntervalToTradingViewInterval(interval) {
     }
 }
 
-export { AccountSummaryCalculator, AuthStatus, ConflictDetector, PearHyperliquidProvider, TokenMetadataExtractor, adjustOrder, adjustPosition, calculateWeightedRatio, cancelOrder, cancelTwap, cancelTwapOrder, closePosition, computeBasketCandles, createCandleLookups, createPosition, getCompleteTimestamps, mapCandleIntervalToTradingViewInterval, mapTradingViewIntervalToCandleInterval, updateRiskParameters, useAccountSummary, useAddress, useAgentWallet, useAuth, useAutoSyncFills, useBasketCandles, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidNativeWebSocket, useHyperliquidWebSocket, useNotifications, useOpenOrders, useOrders, usePearAgentWallet, usePearAuth, usePearHyperliquid, usePerformanceOverlays, usePosition, useTokenSelectionMetadata, useTradeHistories, useTwap, useUserSelection, useWebData };
+export { AccountSummaryCalculator, AuthStatus, ConflictDetector, PearHyperliquidProvider, TokenMetadataExtractor, adjustOrder, adjustPosition, calculateWeightedRatio, cancelOrder, cancelTwap, cancelTwapOrder, closePosition, computeBasketCandles, createCandleLookups, createPosition, getCompleteTimestamps, mapCandleIntervalToTradingViewInterval, mapTradingViewIntervalToCandleInterval, markNotificationsRead, updateRiskParameters, useAccountSummary, useAddress, useAgentWallet, useAuth, useAutoSyncFills, useBasketCandles, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidNativeWebSocket, useHyperliquidWebSocket, useNotifications, useOpenOrders, useOrders, usePearAgentWallet, usePearAuth, usePearHyperliquid, usePerformanceOverlays, usePosition, useTokenSelectionMetadata, useTradeHistories, useTwap, useUserSelection, useWebData };

package/dist/types.d.ts

@@ -74,7 +74,7 @@ export interface WebSocketDataMessage<T = unknown> {
     channel: WebSocketChannel;
     data: T;
 }
-export type NotificationCategory = 'TRADE_OPENED_OUTSIDE_PEAR' | 'POSITION_LIQUIDATED' | 'LIMIT_ORDER_FILLED' | 'LIMIT_ORDER_FAILED' | 'TP_ORDER_FILLED' | 'TP_ORDER_FAILED' | 'SL_ORDER_FILLED' | 'SL_ORDER_FAILED';
+export type NotificationCategory = 'TRADE_OPENED_OUTSIDE_PEAR' | 'TRADE_CLOSED_OUTSIDE_PEAR' | 'POSITION_LIQUIDATED' | 'LIMIT_ORDER_FILLED' | 'LIMIT_ORDER_FAILED' | 'TP_ORDER_FILLED' | 'TP_ORDER_FAILED' | 'SL_ORDER_FILLED' | 'SL_ORDER_FAILED';
 export interface NotificationDto {
     id: string;
     address: string;
@@ -218,11 +218,12 @@ export type OrderStatus = 'OPEN' | 'PARTIALLY_FILLED' | 'PROCESSING';
 /**
  * Order type
  */
-export type OrderType = 'TP' | 'SL' | 'LIMIT' | 'MARKET';
+export type OrderType = 'TP' | 'SL' | 'LIMIT' | 'MARKET' | 'LIMIT_BTCDOM' | 'TWAP';
 /**
  * TP/SL trigger type
  */
-export type TpSlTriggerType = 'RATIO' | 'PERCENTAGE' | 'PNL';
+export type TpSlTriggerType = 'PERCENTAGE' | 'DOLLAR' | 'POSITION_VALUE';
+export type OrderDirection = 'MORE_THAN' | 'LESS_THAN' | null;
 /**
  * Open limit order data structure
  */
@@ -230,16 +231,17 @@ export interface OpenLimitOrderDto {
     orderId: string;
     address: string;
     clientId: string | null;
-    positionId: string;
+    positionId?: string | null;
     leverage: number;
     usdValue: number;
-    triggerValue: number;
-    twapDuration: number | null;
-    tpSlTriggerType: TpSlTriggerType;
+    triggerValue?: number | null;
+    twapDuration?: string | null;
+    tpSlTriggerType?: TpSlTriggerType | null;
     randomizeFlag: boolean;
     reduceOnlyFlag: boolean;
     status: OrderStatus;
     orderType: OrderType;
+    direction?: OrderDirection | null;
     longAssets: OrderAssetDto[];
     shortAssets: OrderAssetDto[];
     createdAt: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pear-protocol/hyperliquid-sdk",
-  "version": "0.0.33",
+  "version": "0.0.35",
   "description": "React SDK for Pear Protocol Hyperliquid API integration",
   "type": "module",
   "main": "dist/index.js",