@0xmonaco/react 0.8.21 → 0.8.22

package/dist/coverage.d.ts

@@ -27,6 +27,7 @@ export declare const COVERED: {
     get_perp_market_config: string;
     get_perp_market_summary: string;
     get_position: string;
+    get_position_pnl_history: string;
     get_position_risk: string;
     get_trades: string;
     get_user_balance_by_asset: string;

package/dist/coverage.js

@@ -27,6 +27,7 @@ export const COVERED = {
     get_perp_market_config: "useMarket",
     get_perp_market_summary: "useMarket",
     get_position: "usePositions",
+    get_position_pnl_history: "usePositionPnlHistory",
     get_position_risk: "usePositions",
     get_trades: "useTradeFeed",
     get_user_balance_by_asset: "useProfile",

package/dist/hooks/index.d.ts

@@ -4,6 +4,7 @@ export * from "./useMarket";
 export * from "./useMonaco";
 export * from "./useOHLCV";
 export * from "./useOrderbook";
+export * from "./usePositionPnlHistory";
 export * from "./usePositions";
 export * from "./useProfile";
 export * from "./useTokenLifecycle";

package/dist/hooks/index.js

@@ -4,6 +4,7 @@ export * from "./useMarket";
 export * from "./useMonaco";
 export * from "./useOHLCV";
 export * from "./useOrderbook";
+export * from "./usePositionPnlHistory";
 export * from "./usePositions";
 export * from "./useProfile";
 export * from "./useTokenLifecycle";

package/dist/hooks/usePositionPnlHistory/index.d.ts

@@ -0,0 +1,2 @@
+export type { UsePositionPnlHistoryParams, UsePositionPnlHistoryReturn } from "./types";
+export { usePositionPnlHistory } from "./usePositionPnlHistory";

package/dist/hooks/usePositionPnlHistory/index.js

@@ -0,0 +1 @@
+export { usePositionPnlHistory } from "./usePositionPnlHistory";

package/dist/hooks/usePositionPnlHistory/types.d.ts

@@ -0,0 +1,15 @@
+import type { GetPositionPnlHistoryParams, PositionPnlPoint } from "@0xmonaco/types";
+export interface UsePositionPnlHistoryParams extends GetPositionPnlHistoryParams {
+    /** Position UUID to chart; pass null/undefined to defer fetching */
+    positionId: string | null | undefined;
+}
+export interface UsePositionPnlHistoryReturn {
+    /** Forward-filled PnL state samples, oldest first */
+    data: PositionPnlPoint[];
+    /** True while a fetch is in flight */
+    loading: boolean;
+    /** Last fetch error, if any */
+    error: Error | null;
+    /** Re-run the fetch with the current parameters */
+    refetch: () => Promise<void>;
+}

package/dist/hooks/usePositionPnlHistory/usePositionPnlHistory.d.ts

@@ -0,0 +1,12 @@
+import type { UsePositionPnlHistoryParams, UsePositionPnlHistoryReturn } from "./types";
+/**
+ * Hook for fetching a position's bucketed PnL history.
+ *
+ * Fetches the forward-filled PnL state samples for one owned position at the
+ * requested interval and refetches whenever the position or window changes.
+ * `cumFundingPaid`/`cumFees` are cost-positive on the wire — negate at render
+ * time to display funding as a signed PnL contribution.
+ *
+ * @param params - positionId plus the interval and optional start/end times
+ */
+export declare function usePositionPnlHistory(params: UsePositionPnlHistoryParams): UsePositionPnlHistoryReturn;

package/dist/hooks/usePositionPnlHistory/usePositionPnlHistory.js

@@ -0,0 +1,59 @@
+import { useCallback, useEffect, useRef, useState } from "react";
+import { useMonacoSDK } from "../useMonaco";
+/**
+ * Hook for fetching a position's bucketed PnL history.
+ *
+ * Fetches the forward-filled PnL state samples for one owned position at the
+ * requested interval and refetches whenever the position or window changes.
+ * `cumFundingPaid`/`cumFees` are cost-positive on the wire — negate at render
+ * time to display funding as a signed PnL contribution.
+ *
+ * @param params - positionId plus the interval and optional start/end times
+ */
+export function usePositionPnlHistory(params) {
+    const { positionId, interval, startTime, endTime } = params;
+    const { sdk } = useMonacoSDK();
+    const [data, setData] = useState([]);
+    const [loading, setLoading] = useState(false);
+    const [error, setError] = useState(null);
+    // Only the newest in-flight request may touch state: a slower response for
+    // an older position/window must not overwrite a newer result.
+    const requestSeq = useRef(0);
+    const fetchHistory = useCallback(async () => {
+        const seq = ++requestSeq.current;
+        if (!sdk?.positions || !positionId) {
+            setData([]);
+            setLoading(false);
+            setError(null);
+            return;
+        }
+        setLoading(true);
+        setError(null);
+        try {
+            const response = await sdk.positions.getPositionPnlHistory(positionId, {
+                interval,
+                startTime,
+                endTime,
+            });
+            if (seq !== requestSeq.current)
+                return;
+            setData(response.data);
+        }
+        catch (err) {
+            if (seq !== requestSeq.current)
+                return;
+            // Drop prior data so a stale series is never shown under a fresh error.
+            setData([]);
+            setError(err instanceof Error ? err : new Error(String(err)));
+        }
+        finally {
+            if (seq === requestSeq.current) {
+                setLoading(false);
+            }
+        }
+    }, [sdk, positionId, interval, startTime, endTime]);
+    useEffect(() => {
+        void fetchHistory();
+    }, [fetchHistory]);
+    return { data, loading, error, refetch: fetchHistory };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@0xmonaco/react",
-	"version": "0.8.21",
+	"version": "0.8.22",
 	"type": "module",
 	"repository": {
 		"type": "git",
@@ -20,8 +20,8 @@
 		"lint": "biome lint ."
 	},
 	"dependencies": {
-		"@0xmonaco/core": "0.8.21",
-		"@0xmonaco/types": "0.8.21"
+		"@0xmonaco/core": "0.8.22",
+		"@0xmonaco/types": "0.8.22"
 	},
 	"devDependencies": {
 		"@types/react": "^19.1.12",