@pear-protocol/core-sdk 1.4.0 → 1.6.0

package/dist/core/index.d.ts

@@ -362,6 +362,7 @@ declare class Core {
                 side: "BUY" | "SELL";
                 reduceOnly: boolean;
                 isExternal: boolean;
+                synthetic: boolean;
                 quantity: string;
                 price: string;
                 usd: string;
@@ -389,6 +390,7 @@ declare class Core {
                 side: "BUY" | "SELL";
                 reduceOnly: boolean;
                 isExternal: boolean;
+                synthetic: boolean;
                 quantity: string;
                 price: string;
                 usd: string;
@@ -532,6 +534,7 @@ declare class Core {
                         side: "BUY" | "SELL";
                         reduceOnly: boolean;
                         isExternal: boolean;
+                        synthetic: boolean;
                         quantity: string;
                         price: string;
                         usd: string;
@@ -664,6 +667,7 @@ declare class Core {
                         side: "BUY" | "SELL";
                         reduceOnly: boolean;
                         isExternal: boolean;
+                        synthetic: boolean;
                         quantity: string;
                         price: string;
                         usd: string;
@@ -829,6 +833,7 @@ declare class Core {
                         side: "BUY" | "SELL";
                         reduceOnly: boolean;
                         isExternal: boolean;
+                        synthetic: boolean;
                         quantity: string;
                         price: string;
                         usd: string;
@@ -963,6 +968,7 @@ declare class Core {
                         side: "BUY" | "SELL";
                         reduceOnly: boolean;
                         isExternal: boolean;
+                        synthetic: boolean;
                         quantity: string;
                         price: string;
                         usd: string;
@@ -1095,6 +1101,7 @@ declare class Core {
                         side: "BUY" | "SELL";
                         reduceOnly: boolean;
                         isExternal: boolean;
+                        synthetic: boolean;
                         quantity: string;
                         price: string;
                         usd: string;
@@ -1260,6 +1267,7 @@ declare class Core {
                         side: "BUY" | "SELL";
                         reduceOnly: boolean;
                         isExternal: boolean;
+                        synthetic: boolean;
                         quantity: string;
                         price: string;
                         usd: string;
@@ -1394,6 +1402,7 @@ declare class Core {
                         side: "BUY" | "SELL";
                         reduceOnly: boolean;
                         isExternal: boolean;
+                        synthetic: boolean;
                         quantity: string;
                         price: string;
                         usd: string;
@@ -1526,6 +1535,7 @@ declare class Core {
                         side: "BUY" | "SELL";
                         reduceOnly: boolean;
                         isExternal: boolean;
+                        synthetic: boolean;
                         quantity: string;
                         price: string;
                         usd: string;
@@ -1691,6 +1701,7 @@ declare class Core {
                         side: "BUY" | "SELL";
                         reduceOnly: boolean;
                         isExternal: boolean;
+                        synthetic: boolean;
                         quantity: string;
                         price: string;
                         usd: string;
@@ -1811,26 +1822,50 @@ declare class Core {
         list: (query?: HttpTypes.NotificationListParamsInput, headers?: ClientHeaders) => Promise<{
             notifications: {
                 id: string;
-                category: "TAKE_PROFIT_HIT" | "STOP_LOSS_HIT" | "TRIGGER_ORDER_HIT";
+                category: "TAKE_PROFIT_HIT" | "STOP_LOSS_HIT" | "TRIGGER_ORDER_HIT" | "TAKE_PROFIT_FAILED" | "STOP_LOSS_FAILED" | "TRIGGER_ORDER_FAILED" | "ATTACHED_TRIGGER_DISCARDED";
                 parameters: {
                     type: "take_profit";
                     triggerId: string;
                     positionId: string;
                     connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                    metric?: "price" | "ratio" | "weighted_ratio" | "funding_rate" | "prediction_market" | "btc_dominance" | "notional" | "upnl" | "upnl_bps" | "ratio_trailing" | "price_trailing" | "weighted_ratio_trailing" | "notional_trailing" | "upnl_trailing" | "upnl_bps_trailing" | undefined;
+                    level?: number | undefined;
+                    reason?: string | undefined;
                 } | {
                     type: "stop_loss";
                     triggerId: string;
                     positionId: string;
                     connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                    metric?: "price" | "ratio" | "weighted_ratio" | "funding_rate" | "prediction_market" | "btc_dominance" | "notional" | "upnl" | "upnl_bps" | "ratio_trailing" | "price_trailing" | "weighted_ratio_trailing" | "notional_trailing" | "upnl_trailing" | "upnl_bps_trailing" | undefined;
+                    level?: number | undefined;
+                    reason?: string | undefined;
                 } | {
                     type: "trigger_order";
                     triggerId: string;
                     positionId: string;
                     connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                    metric?: "price" | "ratio" | "weighted_ratio" | "funding_rate" | "prediction_market" | "btc_dominance" | "notional" | "upnl" | "upnl_bps" | "ratio_trailing" | "price_trailing" | "weighted_ratio_trailing" | "notional_trailing" | "upnl_trailing" | "upnl_bps_trailing" | undefined;
+                    level?: number | undefined;
+                    reason?: string | undefined;
                 } | {
                     type: "default_trigger";
                     triggerId: string;
                     connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                    metric?: "price" | "ratio" | "weighted_ratio" | "funding_rate" | "prediction_market" | "btc_dominance" | "notional" | "upnl" | "upnl_bps" | "ratio_trailing" | "price_trailing" | "weighted_ratio_trailing" | "notional_trailing" | "upnl_trailing" | "upnl_bps_trailing" | undefined;
+                    level?: number | undefined;
+                    reason?: string | undefined;
+                } | {
+                    type: "attached_trigger_discarded";
+                    positionId: string;
+                    positionKey: string;
+                    connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                    discarded: {
+                        bracketType: "STOP_LOSS" | "TAKE_PROFIT";
+                        metric: "price" | "ratio" | "weighted_ratio" | "funding_rate" | "prediction_market" | "btc_dominance" | "notional" | "upnl" | "upnl_bps" | "ratio_trailing" | "price_trailing" | "weighted_ratio_trailing" | "notional_trailing" | "upnl_trailing" | "upnl_bps_trailing";
+                        reason: "TRIGGER_LIMIT" | "TRAILING_ALREADY_EXISTS";
+                        level?: number | undefined;
+                    }[];
+                    activeTriggerLimit: number;
                 };
                 isRead: boolean;
                 createdAt: string;
@@ -1857,12 +1892,16 @@ declare class Core {
     };
     positions: {
         list: (query: HttpTypes.PositionListParamsInput, headers?: ClientHeaders) => Promise<{
+            limit: number;
+            nextCursor: string | undefined;
             positions: {
                 id: string;
                 tradeAccountId: string;
                 connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
                 status: "OPEN" | "CLOSED";
+                origin: "PARTIAL" | "PEAR" | "EXTERNAL";
                 exposure: Record<string, `-${string}` | `+${string}`>;
+                totalFundingPayment: Record<string, `-${string}` | `+${string}`>;
                 initialExposureUSD: Record<string, `-${string}` | `+${string}`>;
                 createdAt: string;
                 updatedAt: string;
@@ -1874,8 +1913,9 @@ declare class Core {
             positions: {
                 id: string;
                 createdAt: string;
-                exposure: Record<string, string>;
+                exposure: Record<string, `-${string}` | `+${string}`>;
                 status: "OPEN";
+                origin: "PARTIAL" | "PEAR" | "EXTERNAL";
                 connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
             }[];
         }>;
@@ -2058,14 +2098,77 @@ declare class Core {
         }>;
     };
     rebalance: {
-        manually: (positionId: string, body: HttpTypes.RebalanceManually, headers?: ClientHeaders) => Promise<{
+        manual: (positionId: string, body: HttpTypes.RebalanceManual, headers?: ClientHeaders) => Promise<{
             plan: {
                 outcome: "full_rebalance";
             } | {
-                outcome: "partial_rebalance" | "no_rebalance";
+                outcome: "partial_rebalance";
+                messages: [string, ...string[]];
+            } | {
+                outcome: "no_rebalance";
+                messages: [string, ...string[]];
+            } | {
+                outcome: "failed";
                 messages: [string, ...string[]];
             };
         }>;
+        auto: {
+            list: (query?: HttpTypes.AutoRebalanceListParamsInput, headers?: ClientHeaders) => Promise<{
+                limit: number;
+                nextCursor: string | undefined;
+                items: {
+                    id: string;
+                    positionId: string;
+                    status: "ACTIVE" | "PAUSED";
+                    weightSource: "INITIAL_WEIGHT" | "LIVE_BETA";
+                    minimumDriftPct: string;
+                    createdAt: string;
+                    updatedAt: string;
+                    timeframe?: "1d" | "1h" | "4h" | undefined;
+                }[];
+            }>;
+            create: (body: HttpTypes.CreateAutoRebalanceConfig, headers?: ClientHeaders) => Promise<{
+                config: {
+                    id: string;
+                    positionId: string;
+                    status: "ACTIVE" | "PAUSED";
+                    weightSource: "INITIAL_WEIGHT" | "LIVE_BETA";
+                    minimumDriftPct: string;
+                    createdAt: string;
+                    updatedAt: string;
+                    timeframe?: "1d" | "1h" | "4h" | undefined;
+                };
+            }>;
+            update: (id: string, body: HttpTypes.UpdateAutoRebalanceConfig, headers?: ClientHeaders) => Promise<{
+                config: {
+                    id: string;
+                    positionId: string;
+                    status: "ACTIVE" | "PAUSED";
+                    weightSource: "INITIAL_WEIGHT" | "LIVE_BETA";
+                    minimumDriftPct: string;
+                    createdAt: string;
+                    updatedAt: string;
+                    timeframe?: "1d" | "1h" | "4h" | undefined;
+                };
+            }>;
+            cancel: (id: string, headers?: ClientHeaders) => Promise<void>;
+        };
+        listEvents: (positionId: string, query?: HttpTypes.RebalanceEventListParamsInput, headers?: ClientHeaders) => Promise<{
+            limit: number;
+            nextCursor: string | undefined;
+            items: {
+                id: string;
+                autoRebalanceConfigId: string;
+                positionId: string;
+                weightSource: "INITIAL_WEIGHT" | "LIVE_BETA";
+                driftPct: string;
+                currentWeights: Record<string, number>;
+                targetWeights: Record<string, number>;
+                status: "FAILED" | "SUCCESS";
+                createdAt: string;
+                error?: string | undefined;
+            }[];
+        }>;
     };
     savedBaskets: {
         list: (headers?: ClientHeaders) => Promise<{
@@ -2159,6 +2262,7 @@ declare class Core {
                     side: "BUY" | "SELL";
                     reduceOnly: boolean;
                     isExternal: boolean;
+                    synthetic: boolean;
                     quantity: string;
                     price: string;
                     usd: string;
@@ -2204,6 +2308,7 @@ declare class Core {
                     side: "BUY" | "SELL";
                     reduceOnly: boolean;
                     isExternal: boolean;
+                    synthetic: boolean;
                     quantity: string;
                     price: string;
                     usd: string;
@@ -2254,6 +2359,7 @@ declare class Core {
                     side: "BUY" | "SELL";
                     reduceOnly: boolean;
                     isExternal: boolean;
+                    synthetic: boolean;
                     quantity: string;
                     price: string;
                     usd: string;
@@ -2299,6 +2405,7 @@ declare class Core {
                     side: "BUY" | "SELL";
                     reduceOnly: boolean;
                     isExternal: boolean;
+                    synthetic: boolean;
                     quantity: string;
                     price: string;
                     usd: string;
@@ -2322,15 +2429,24 @@ declare class Core {
         }>;
     };
     sync: {
-        since: (body: HttpTypes.SyncSinceRequest, headers?: ClientHeaders) => Promise<{
-            since: string;
-            sinceMs: number;
-            safeTs?: number | undefined;
-            confirmedExchangeFillIds?: string[] | undefined;
-        }>;
-        confirm: (body: HttpTypes.ConfirmFillsRequest, headers?: ClientHeaders) => Promise<Record<string, never>>;
-        reconcile: (body: HttpTypes.ReconcileFillsRequest, headers?: ClientHeaders) => Promise<Record<string, never>>;
-        create: (body: HttpTypes.CreateFillsRequest, headers?: ClientHeaders) => Promise<Record<string, never>>;
+        fills: {
+            since: (body: HttpTypes.SyncFillsSinceRequest, headers?: ClientHeaders) => Promise<{
+                sinceMs: number;
+                neverSynced: boolean;
+                confirmedExchangeFillIds?: string[] | undefined;
+            }>;
+            reconcile: (body: HttpTypes.ReconcileFillsRequest, headers?: ClientHeaders) => Promise<Record<string, never>>;
+            confirm: (body: HttpTypes.ConfirmFillsRequest, headers?: ClientHeaders) => Promise<Record<string, never>>;
+            create: (body: HttpTypes.CreateApplicablesRequest, headers?: ClientHeaders) => Promise<Record<string, never>>;
+            createBulk: (body: HttpTypes.CreateApplicablesRequest, headers?: ClientHeaders) => Promise<Record<string, never>>;
+        };
+        funding: {
+            since: (body: HttpTypes.SyncFundingSinceRequest, headers?: ClientHeaders) => Promise<{
+                sinceMs: number;
+            }>;
+            create: (body: HttpTypes.CreateFundingPaymentsRequest, headers?: ClientHeaders) => Promise<Record<string, never>>;
+            createBulk: (body: HttpTypes.CreateFundingPaymentsRequest, headers?: ClientHeaders) => Promise<Record<string, never>>;
+        };
     };
     trade: {
         open: (body: HttpTypes.CreateTradeOpen, headers?: ClientHeaders) => Promise<{
@@ -3160,6 +3276,7 @@ declare class Core {
                     side: "BUY" | "SELL";
                     reduceOnly: boolean;
                     isExternal: boolean;
+                    synthetic: boolean;
                     quantity: string;
                     price: string;
                     usd: string;
@@ -3292,6 +3409,7 @@ declare class Core {
                     side: "BUY" | "SELL";
                     reduceOnly: boolean;
                     isExternal: boolean;
+                    synthetic: boolean;
                     quantity: string;
                     price: string;
                     usd: string;
@@ -3457,6 +3575,7 @@ declare class Core {
                     side: "BUY" | "SELL";
                     reduceOnly: boolean;
                     isExternal: boolean;
+                    synthetic: boolean;
                     quantity: string;
                     price: string;
                     usd: string;
@@ -3577,6 +3696,7 @@ declare class Core {
                     side: "BUY" | "SELL";
                     reduceOnly: boolean;
                     isExternal: boolean;
+                    synthetic: boolean;
                     quantity: string;
                     price: string;
                     usd: string;
@@ -3709,6 +3829,7 @@ declare class Core {
                     side: "BUY" | "SELL";
                     reduceOnly: boolean;
                     isExternal: boolean;
+                    synthetic: boolean;
                     quantity: string;
                     price: string;
                     usd: string;
@@ -3874,6 +3995,7 @@ declare class Core {
                     side: "BUY" | "SELL";
                     reduceOnly: boolean;
                     isExternal: boolean;
+                    synthetic: boolean;
                     quantity: string;
                     price: string;
                     usd: string;
@@ -3994,6 +4116,7 @@ declare class Core {
                     side: "BUY" | "SELL";
                     reduceOnly: boolean;
                     isExternal: boolean;
+                    synthetic: boolean;
                     quantity: string;
                     price: string;
                     usd: string;
@@ -4126,6 +4249,7 @@ declare class Core {
                     side: "BUY" | "SELL";
                     reduceOnly: boolean;
                     isExternal: boolean;
+                    synthetic: boolean;
                     quantity: string;
                     price: string;
                     usd: string;
@@ -4291,6 +4415,7 @@ declare class Core {
                     side: "BUY" | "SELL";
                     reduceOnly: boolean;
                     isExternal: boolean;
+                    synthetic: boolean;
                     quantity: string;
                     price: string;
                     usd: string;
@@ -4386,6 +4511,14 @@ declare class Core {
                 openPositions: number;
             }[];
         }>;
+        totals: (query: HttpTypes.StatisticsTotalsQueryParamsInput, headers?: ClientHeaders) => Promise<{
+            data: {
+                totalVolume: number;
+                totalFees: number;
+                totalTrades: number;
+                totalUsers: number;
+            };
+        }>;
     };
     tca: {
         execution: (executionId: string, headers?: ClientHeaders) => Promise<{

package/dist/core/index.js

@@ -1,3 +1,5 @@
+import { gzipJson } from '../utils';
+
 class Core {
   client;
   clientId;
@@ -245,12 +247,48 @@ class Core {
     }
   };
   rebalance = {
-    manually: async (positionId, body, headers) => {
-      return await this.client.fetch(`/rebalance/manually/${positionId}`, {
+    manual: async (positionId, body, headers) => {
+      return await this.client.fetch(`/rebalance/manual/${positionId}`, {
         method: "POST",
         headers,
         body: this.withClientId(body)
       });
+    },
+    auto: {
+      list: async (query, headers) => {
+        return await this.client.fetch(`/rebalance/auto`, {
+          method: "GET",
+          headers,
+          query
+        });
+      },
+      create: async (body, headers) => {
+        return await this.client.fetch(`/rebalance/auto`, {
+          method: "POST",
+          headers,
+          body
+        });
+      },
+      update: async (id, body, headers) => {
+        return await this.client.fetch(`/rebalance/auto/${id}`, {
+          method: "PATCH",
+          headers,
+          body
+        });
+      },
+      cancel: async (id, headers) => {
+        return await this.client.fetch(`/rebalance/auto/${id}/cancel`, {
+          method: "POST",
+          headers
+        });
+      }
+    },
+    listEvents: async (positionId, query, headers) => {
+      return await this.client.fetch(`/rebalance/${positionId}/events`, {
+        method: "GET",
+        headers,
+        query
+      });
     }
   };
   savedBaskets = {
@@ -310,33 +348,71 @@ class Core {
     }
   };
   sync = {
-    since: async (body, headers) => {
-      return await this.client.fetch(`/sync/since`, {
-        method: "POST",
-        headers,
-        body
-      });
-    },
-    confirm: async (body, headers) => {
-      return await this.client.fetch(`/sync/confirm`, {
-        method: "POST",
-        headers,
-        body
-      });
-    },
-    reconcile: async (body, headers) => {
-      return await this.client.fetch(`/sync/reconcile`, {
-        method: "POST",
-        headers,
-        body
-      });
+    fills: {
+      since: async (body, headers) => {
+        return await this.client.fetch(`/sync/fills/since`, {
+          method: "POST",
+          headers,
+          body
+        });
+      },
+      reconcile: async (body, headers) => {
+        return await this.client.fetch(`/sync/fills/reconcile`, {
+          method: "POST",
+          headers,
+          body
+        });
+      },
+      confirm: async (body, headers) => {
+        return await this.client.fetch(`/sync/fills/confirm`, {
+          method: "POST",
+          headers,
+          body
+        });
+      },
+      create: async (body, headers) => {
+        return await this.client.fetch(`/sync/fills/create`, {
+          method: "POST",
+          headers,
+          body
+        });
+      },
+      createBulk: async (body, headers) => {
+        const file = await gzipJson(body);
+        const formData = new FormData();
+        formData.append("file", file, "payload.json.gz");
+        return await this.client.fetch(`/sync/fills/create/bulk`, {
+          method: "POST",
+          headers: { ...headers, "content-type": null },
+          body: formData
+        });
+      }
     },
-    create: async (body, headers) => {
-      return await this.client.fetch(`/sync/create`, {
-        method: "POST",
-        headers,
-        body
-      });
+    funding: {
+      since: async (body, headers) => {
+        return await this.client.fetch(`/sync/funding/since`, {
+          method: "POST",
+          headers,
+          body
+        });
+      },
+      create: async (body, headers) => {
+        return await this.client.fetch(`/sync/funding/create`, {
+          method: "POST",
+          headers,
+          body
+        });
+      },
+      createBulk: async (body, headers) => {
+        const file = await gzipJson(body);
+        const formData = new FormData();
+        formData.append("file", file, "payload.json.gz");
+        return await this.client.fetch(`/sync/funding/create/bulk`, {
+          method: "POST",
+          headers: { ...headers, "content-type": null },
+          body: formData
+        });
+      }
     }
   };
   trade = {
@@ -499,6 +575,13 @@ class Core {
         headers,
         query
       });
+    },
+    totals: async (query, headers) => {
+      return await this.client.fetch(`/statistics/totals`, {
+        method: "GET",
+        headers,
+        query
+      });
     }
   };
   tca = {

package/dist/index.js

@@ -7,6 +7,28 @@ import { HttpClient } from './http';
 import { FetchError } from './utils';
 export * from '@pear-protocol/utils';
 
+const SESSION_REFRESH_PATH = "/auth/session/refresh";
+const SESSION_REFRESH_TIMEOUT_MS = 15e3;
+const isSessionRefreshRequest = (request) => {
+  try {
+    return new URL(request.url).pathname.includes(SESSION_REFRESH_PATH);
+  } catch {
+    return false;
+  }
+};
+const withTimeout = async (promise, ms, label) => {
+  let timer;
+  try {
+    return await Promise.race([
+      promise,
+      new Promise((_, reject) => {
+        timer = setTimeout(() => reject(new Error(`${label} timed out after ${ms}ms`)), ms);
+      })
+    ]);
+  } finally {
+    clearTimeout(timer);
+  }
+};
 class PearSDK {
   admin;
   auth;
@@ -31,7 +53,7 @@ class PearSDK {
       const refreshSession = async () => {
         if (!refreshInFlight) {
           logger.info("[session-refresh] Refreshing session...");
-          refreshInFlight = this.auth.refreshSession().then(() => logger.info("[session-refresh] Session refreshed successfully")).catch((err) => {
+          refreshInFlight = withTimeout(this.auth.refreshSession(), SESSION_REFRESH_TIMEOUT_MS, "Session refresh").then(() => logger.info("[session-refresh] Session refreshed successfully")).catch((err) => {
             logger.error("[session-refresh] Refresh failed:", String(err));
             throw err;
           }).finally(() => {
@@ -42,18 +64,25 @@ class PearSDK {
         }
         return refreshInFlight;
       };
+      const expire = (reason) => {
+        logger.error(`[session-refresh] ${reason}`);
+        config.onSessionExpired?.();
+        throw new FetchError("Session expired. Please log in again.", "Unauthorized", 401);
+      };
+      const alreadyRetried = /* @__PURE__ */ new WeakSet();
       const sessionRefreshMiddleware = async (response, retry, request) => {
         if (response.status !== 401) return response;
+        if (isSessionRefreshRequest(request)) return response;
         logger.warn(`[session-refresh] 401 received for ${request.method} ${request.url}`);
+        if (alreadyRetried.has(request)) return expire("Still 401 after refresh, giving up");
         try {
           await refreshSession();
-          logger.info(`[session-refresh] Retrying ${request.method} ${request.url}`);
-          return retry();
         } catch {
-          logger.error("[session-refresh] Session expired, cannot recover");
-          config.onSessionExpired?.();
-          throw new FetchError("Session expired. Please log in again.", "Unauthorized", 401);
+          return expire("Session expired, cannot recover");
         }
+        alreadyRetried.add(request);
+        logger.info(`[session-refresh] Retrying ${request.method} ${request.url}`);
+        return retry();
       };
       client.useResponse(sessionRefreshMiddleware);
     }

package/dist/index.test.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/index.test.js

@@ -0,0 +1,88 @@
+import { describe, afterEach, vi, it, expect } from 'vitest';
+import PearSDK from './index';
+
+const json = (status, body = {}) => {
+  return new Response(JSON.stringify(body), {
+    status,
+    headers: { "content-type": "application/json" }
+  });
+};
+const silentLogger = {
+  error: () => {
+  },
+  warn: () => {
+  },
+  info: () => {
+  },
+  debug: () => {
+  }
+};
+const setup = (routes) => {
+  const calls = [];
+  const fetchMock = vi.fn(async (input) => {
+    const key = `${input.method} ${new URL(input.url).pathname}`;
+    calls.push(key);
+    const queue = routes[key];
+    if (!queue || queue.length === 0) {
+      throw new Error(`unexpected request: ${key}`);
+    }
+    const responder = queue.length > 1 ? queue.shift() : queue[0];
+    return responder();
+  });
+  vi.stubGlobal("fetch", fetchMock);
+  const onSessionExpired = vi.fn();
+  const sdk = new PearSDK({
+    url: "https://gateway.test",
+    auth: { type: "session" },
+    onSessionExpired,
+    logger: silentLogger
+  });
+  return { sdk, onSessionExpired, calls };
+};
+describe("session-refresh middleware", () => {
+  afterEach(() => {
+    vi.unstubAllGlobals();
+    vi.useRealTimers();
+    vi.restoreAllMocks();
+  });
+  it("rejects (never hangs) when the refresh endpoint itself 401s on a dead cookie", async () => {
+    const { sdk, onSessionExpired, calls } = setup({
+      "GET /positions": [() => json(401, { message: "unauthorized" })],
+      "POST /auth/session/refresh": [() => json(401, { message: "refresh failed" })]
+    });
+    await expect(sdk.core.positions.list({})).rejects.toMatchObject({ status: 401 });
+    expect(onSessionExpired).toHaveBeenCalledTimes(1);
+    expect(calls).toEqual(["GET /positions", "POST /auth/session/refresh"]);
+  });
+  it("gives up after a single retry when the request still 401s after a successful refresh", async () => {
+    const { sdk, onSessionExpired, calls } = setup({
+      "GET /positions": [() => json(401)],
+      "POST /auth/session/refresh": [() => json(200)]
+    });
+    await expect(sdk.core.positions.list({})).rejects.toMatchObject({ status: 401 });
+    expect(calls.filter((call) => call === "GET /positions")).toHaveLength(2);
+    expect(calls.filter((call) => call === "POST /auth/session/refresh")).toHaveLength(1);
+    expect(onSessionExpired).toHaveBeenCalledTimes(1);
+  });
+  it("transparently refreshes and retries the original request on a recoverable 401", async () => {
+    const { sdk, onSessionExpired, calls } = setup({
+      "GET /positions": [() => json(401), () => json(200, { positions: ["ok"] })],
+      "POST /auth/session/refresh": [() => json(200)]
+    });
+    await expect(sdk.core.positions.list({})).resolves.toMatchObject({ positions: ["ok"] });
+    expect(onSessionExpired).not.toHaveBeenCalled();
+    expect(calls).toEqual(["GET /positions", "POST /auth/session/refresh", "GET /positions"]);
+  });
+  it("caps a stalled refresh at the timeout instead of wedging the queue", async () => {
+    vi.useFakeTimers();
+    const { sdk, onSessionExpired } = setup({
+      "GET /positions": [() => json(401)],
+      "POST /auth/session/refresh": [() => new Promise(() => {
+      })]
+    });
+    const settled = expect(sdk.core.positions.list({})).rejects.toMatchObject({ status: 401 });
+    await vi.advanceTimersByTimeAsync(15e3);
+    await settled;
+    expect(onSessionExpired).toHaveBeenCalledTimes(1);
+  });
+});

package/dist/types.d.ts

@@ -111,6 +111,6 @@ type FetchArgs = Omit<RequestInit, 'headers' | 'body'> & {
 };
 type RequestMiddleware = (request: Request, next: () => Promise<Response>) => Promise<Response>;
 type ResponseMiddleware = (response: Response, retry: () => Promise<Response>, request: Request) => Promise<Response>;
-type ClientIdBody = HttpTypes.RebalanceManually | HttpTypes.CreateSchedule | HttpTypes.CreateTradeOpen | HttpTypes.CreateTradeAdjust | HttpTypes.CreateTradeClose | HttpTypes.CreateTradeCloseAll | HttpTypes.CreateTriggerOpen | HttpTypes.CreateTriggerClose;
+type ClientIdBody = HttpTypes.RebalanceManual | HttpTypes.CreateSchedule | HttpTypes.CreateTradeOpen | HttpTypes.CreateTradeAdjust | HttpTypes.CreateTradeClose | HttpTypes.CreateTradeCloseAll | HttpTypes.CreateTriggerOpen | HttpTypes.CreateTriggerClose;
 
 export type { AuthMode, ClientHeaders, ClientIdBody, FetchArgs, FetchInput, FetchParams, Logger, RequestMiddleware, ResponseMiddleware, SDKConfig };

package/dist/utils.d.ts

@@ -9,5 +9,6 @@ declare class FetchError extends Error {
     statusText: string | undefined;
     constructor(message: string, statusText?: string, status?: number);
 }
+declare function gzipJson(value: unknown): Promise<Blob>;
 
-export { FetchError, getBaseUrl, normalizeRequest, normalizeResponseData };
+export { FetchError, getBaseUrl, gzipJson, normalizeRequest, normalizeResponseData };

package/dist/utils.js

@@ -44,5 +44,9 @@ class FetchError extends Error {
     this.status = status;
   }
 }
+async function gzipJson(value) {
+  const stream = new Blob([JSON.stringify(value)]).stream().pipeThrough(new CompressionStream("gzip"));
+  return await new Response(stream).blob();
+}
 
-export { FetchError, getBaseUrl, normalizeRequest, normalizeResponseData };
+export { FetchError, getBaseUrl, gzipJson, normalizeRequest, normalizeResponseData };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pear-protocol/core-sdk",
-  "version": "1.4.0",
+  "version": "1.6.0",
   "description": "Pear Protocol Core SDK",
   "private": false,
   "type": "module",
@@ -22,17 +22,20 @@
   "scripts": {
     "build": "tsup",
     "clean": "rm -rf dist .turbo",
+    "test": "vitest run",
+    "test:watch": "vitest",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@pear-protocol/types": "^1.4.0",
-    "@pear-protocol/utils": "^0.0.23",
+    "@pear-protocol/types": "^1.8.0",
+    "@pear-protocol/utils": "^0.1.0",
     "qs": "^6.14.0"
   },
   "devDependencies": {
     "@backend/typescript-config": "workspace:*",
     "@types/qs": "^6.14.0",
     "tsup": "8.5.1",
-    "typescript": "5.9.3"
+    "typescript": "5.9.3",
+    "vitest": "4.1.2"
   }
 }