@pear-protocol/core-sdk 1.6.0 → 1.8.0

package/dist/admin/index.d.ts

@@ -1,6 +1,7 @@
 import { HttpTypes } from '@pear-protocol/types';
 import { HttpClient } from '../http.js';
 import { ClientHeaders } from '../types.js';
+import '@pear-protocol/utils';
 
 declare class Admin {
     private client;

package/dist/auth/index.d.ts

@@ -1,6 +1,7 @@
 import { HttpTypes } from '@pear-protocol/types';
 import { HttpClient } from '../http.js';
 import { ClientHeaders } from '../types.js';
+import '@pear-protocol/utils';
 
 declare class Auth {
     private client;
@@ -14,7 +15,7 @@ declare class Auth {
             id: string;
             role: "basic" | "pro" | "admin";
             providerId: string | null;
-            loginMethod: "email" | "evm_wallet";
+            loginMethod: "email" | "evm_wallet" | "oauth";
         };
     }>;
     requestNonce(body: HttpTypes.RequestNonceRequest, headers?: ClientHeaders): Promise<{
@@ -28,7 +29,7 @@ declare class Auth {
         id: string;
         role: "basic" | "pro" | "admin";
         providerId: string | null;
-        loginMethod: "email" | "evm_wallet";
+        loginMethod: "email" | "evm_wallet" | "oauth";
     }>;
     apiKeyMe(headers?: ClientHeaders): Promise<{
         id: string;
@@ -49,6 +50,37 @@ declare class Auth {
     changePassword(body: HttpTypes.ChangePasswordRequest, headers?: ClientHeaders): Promise<void>;
     forgotPassword(body: HttpTypes.ForgotPasswordRequest, headers?: ClientHeaders): Promise<void>;
     resetPassword(body: HttpTypes.ResetPasswordRequest, headers?: ClientHeaders): Promise<void>;
+    getInteractionDetails(uid: string, headers?: ClientHeaders): Promise<{
+        uid: string;
+        prompt: {
+            name: string;
+            details: Record<string, unknown>;
+        };
+        params: Record<string, unknown>;
+        client: {
+            clientId: string;
+            redirectUris: string[];
+            clientName?: string | undefined;
+        };
+    }>;
+    submitInteractionLogin(uid: string, body: HttpTypes.LoginRequest, headers?: ClientHeaders): Promise<{
+        returnTo: string;
+    }>;
+    confirmInteraction(uid: string, body: HttpTypes.OauthInteractionConfirmRequest, headers?: ClientHeaders): Promise<{
+        returnTo: string;
+    }>;
+    abortInteraction(uid: string, headers?: ClientHeaders): Promise<{
+        returnTo: string;
+    }>;
+    listOauthGrants(headers?: ClientHeaders): Promise<{
+        grants: {
+            id: string;
+            name: string;
+            scopes: string[];
+            connectedAt: string;
+        }[];
+    }>;
+    revokeOauthGrant(id: string, headers?: ClientHeaders): Promise<void>;
 }
 
 export { Auth };

package/dist/auth/index.js

@@ -111,6 +111,46 @@ class Auth {
       body
     });
   }
+  // --- OAuth interaction (login + consent), keyed by uid in the URL, served by apps/auth ---
+  async getInteractionDetails(uid, headers) {
+    return await this.client.fetch(`/interaction/${uid}`, {
+      method: "GET",
+      headers
+    });
+  }
+  async submitInteractionLogin(uid, body, headers) {
+    return await this.client.fetch(`/interaction/${uid}/login`, {
+      method: "POST",
+      headers,
+      body
+    });
+  }
+  async confirmInteraction(uid, body, headers) {
+    return await this.client.fetch(`/interaction/${uid}/confirm`, {
+      method: "POST",
+      headers,
+      body
+    });
+  }
+  async abortInteraction(uid, headers) {
+    return await this.client.fetch(`/interaction/${uid}/abort`, {
+      method: "POST",
+      headers
+    });
+  }
+  // --- OAuth grants (the user's active authorizations), served by apps/auth ---
+  async listOauthGrants(headers) {
+    return await this.client.fetch(`/oauth2/grants`, {
+      method: "GET",
+      headers
+    });
+  }
+  async revokeOauthGrant(id, headers) {
+    return await this.client.fetch(`/oauth2/grants/${id}`, {
+      method: "DELETE",
+      headers
+    });
+  }
 }
 
 export { Auth };

package/dist/core/index.d.ts

@@ -1,6 +1,7 @@
 import { HttpTypes } from '@pear-protocol/types';
 import { HttpClient } from '../http.js';
 import { ClientHeaders } from '../types.js';
+import '@pear-protocol/utils';
 
 declare class Core {
     private client;
@@ -204,7 +205,6 @@ declare class Core {
     executions: {
         list: (query: HttpTypes.ExecutionListParamsInput, headers?: ClientHeaders) => Promise<{
             limit: number;
-            nextCursor: string | undefined;
             executions: ({
                 id: string;
                 connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
@@ -348,6 +348,152 @@ declare class Core {
                     filledPrice?: string | undefined;
                 }[] | undefined;
             })[];
+            nextCursor?: string | undefined;
+        }>;
+        get: (id: string, headers?: ClientHeaders) => Promise<{
+            execution: {
+                id: string;
+                connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                status: "CANCELLED" | "ACTIVE" | "COMPLETED" | "IDLE" | "FAILED";
+                createdAt: string;
+                updatedAt: string;
+                intent: "OPEN";
+                orderType: "MARKET";
+                legs: [{
+                    symbol: string;
+                    side: "BUY" | "SELL";
+                    mode: "QUANTITY" | "USD";
+                    amount: string;
+                    reduceOnly: boolean;
+                }, ...{
+                    symbol: string;
+                    side: "BUY" | "SELL";
+                    mode: "QUANTITY" | "USD";
+                    amount: string;
+                    reduceOnly: boolean;
+                }[]];
+                error?: string | undefined;
+                orders?: {
+                    id: string;
+                    connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                    status: "CANCELLED" | "PENDING" | "PARTIAL" | "FILLED" | "REJECTED";
+                    createdAt: string;
+                    updatedAt: string;
+                    type: "MARKET";
+                    symbol: string;
+                    side: "BUY" | "SELL";
+                    reduceOnly: boolean;
+                    leverage: number;
+                    quantity: string;
+                    price: string;
+                    filledQuantity: string;
+                    error?: string | undefined;
+                    filledPrice?: string | undefined;
+                }[] | undefined;
+            } | {
+                id: string;
+                connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                status: "CANCELLED" | "ACTIVE" | "COMPLETED" | "IDLE" | "FAILED";
+                createdAt: string;
+                updatedAt: string;
+                intent: "ADJUST";
+                orderType: "MARKET";
+                position: {
+                    id: string;
+                    exposure: Record<string, `-${string}` | `+${string}`>;
+                };
+                legs: [{
+                    symbol: string;
+                    side: "BUY" | "SELL";
+                    mode: "QUANTITY" | "USD";
+                    amount: string;
+                    reduceOnly: boolean;
+                }, ...{
+                    symbol: string;
+                    side: "BUY" | "SELL";
+                    mode: "QUANTITY" | "USD";
+                    amount: string;
+                    reduceOnly: boolean;
+                }[]];
+                error?: string | undefined;
+                orders?: {
+                    id: string;
+                    connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                    status: "CANCELLED" | "PENDING" | "PARTIAL" | "FILLED" | "REJECTED";
+                    createdAt: string;
+                    updatedAt: string;
+                    type: "MARKET";
+                    symbol: string;
+                    side: "BUY" | "SELL";
+                    reduceOnly: boolean;
+                    leverage: number;
+                    quantity: string;
+                    price: string;
+                    filledQuantity: string;
+                    error?: string | undefined;
+                    filledPrice?: string | undefined;
+                }[] | undefined;
+            } | {
+                id: string;
+                connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                status: "CANCELLED" | "ACTIVE" | "COMPLETED" | "IDLE" | "FAILED";
+                createdAt: string;
+                updatedAt: string;
+                intent: "CLOSE";
+                orderType: "MARKET";
+                position: {
+                    id: string;
+                    exposure: Record<string, `-${string}` | `+${string}`>;
+                };
+                error?: string | undefined;
+                orders?: {
+                    id: string;
+                    connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                    status: "CANCELLED" | "PENDING" | "PARTIAL" | "FILLED" | "REJECTED";
+                    createdAt: string;
+                    updatedAt: string;
+                    type: "MARKET";
+                    symbol: string;
+                    side: "BUY" | "SELL";
+                    reduceOnly: boolean;
+                    leverage: number;
+                    quantity: string;
+                    price: string;
+                    filledQuantity: string;
+                    error?: string | undefined;
+                    filledPrice?: string | undefined;
+                }[] | undefined;
+            } | {
+                id: string;
+                connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                status: "CANCELLED" | "ACTIVE" | "COMPLETED" | "IDLE" | "FAILED";
+                createdAt: string;
+                updatedAt: string;
+                intent: "REVERSE";
+                orderType: "MARKET";
+                position: {
+                    id: string;
+                    exposure: Record<string, `-${string}` | `+${string}`>;
+                };
+                error?: string | undefined;
+                orders?: {
+                    id: string;
+                    connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                    status: "CANCELLED" | "PENDING" | "PARTIAL" | "FILLED" | "REJECTED";
+                    createdAt: string;
+                    updatedAt: string;
+                    type: "MARKET";
+                    symbol: string;
+                    side: "BUY" | "SELL";
+                    reduceOnly: boolean;
+                    leverage: number;
+                    quantity: string;
+                    price: string;
+                    filledQuantity: string;
+                    error?: string | undefined;
+                    filledPrice?: string | undefined;
+                }[] | undefined;
+            };
         }>;
     };
     fills: {
@@ -379,7 +525,6 @@ declare class Core {
         }>;
         list: (query: HttpTypes.FillListParams, headers?: ClientHeaders) => Promise<{
             limit: number;
-            nextCursor: string | undefined;
             fills: {
                 id: string;
                 status: "PROVISIONAL" | "CONFIRMED" | "RECONCILED";
@@ -404,6 +549,7 @@ declare class Core {
                     quantity: string;
                 } | undefined;
             }[];
+            nextCursor?: string | undefined;
         }>;
         provisionals: (headers?: ClientHeaders) => Promise<{
             fills: {
@@ -426,7 +572,6 @@ declare class Core {
     ladders: {
         list: (query: HttpTypes.LadderListParamsInput, headers?: ClientHeaders) => Promise<{
             limit: number;
-            nextCursor: string | undefined;
             ladders: {
                 id: string;
                 connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
@@ -859,6 +1004,7 @@ declare class Core {
                 createdAt: string;
                 updatedAt: string;
             }[];
+            nextCursor?: string | undefined;
         }>;
         create: (body: HttpTypes.CreateLadder, headers?: ClientHeaders) => Promise<{
             ladder: {
@@ -1893,7 +2039,6 @@ declare class Core {
     positions: {
         list: (query: HttpTypes.PositionListParamsInput, headers?: ClientHeaders) => Promise<{
             limit: number;
-            nextCursor: string | undefined;
             positions: {
                 id: string;
                 tradeAccountId: string;
@@ -1903,11 +2048,13 @@ declare class Core {
                 exposure: Record<string, `-${string}` | `+${string}`>;
                 totalFundingPayment: Record<string, `-${string}` | `+${string}`>;
                 initialExposureUSD: Record<string, `-${string}` | `+${string}`>;
+                entryPrices: Record<string, string>;
                 createdAt: string;
                 updatedAt: string;
                 closedReason?: "USER" | "NETTED" | "LIQUIDATED" | null | undefined;
                 closedAt?: string | null | undefined;
             }[];
+            nextCursor?: string | undefined;
         }>;
         openLite: (headers?: ClientHeaders) => Promise<{
             positions: {
@@ -2115,7 +2262,6 @@ declare class Core {
         auto: {
             list: (query?: HttpTypes.AutoRebalanceListParamsInput, headers?: ClientHeaders) => Promise<{
                 limit: number;
-                nextCursor: string | undefined;
                 items: {
                     id: string;
                     positionId: string;
@@ -2126,6 +2272,7 @@ declare class Core {
                     updatedAt: string;
                     timeframe?: "1d" | "1h" | "4h" | undefined;
                 }[];
+                nextCursor?: string | undefined;
             }>;
             create: (body: HttpTypes.CreateAutoRebalanceConfig, headers?: ClientHeaders) => Promise<{
                 config: {
@@ -2155,7 +2302,6 @@ declare class Core {
         };
         listEvents: (positionId: string, query?: HttpTypes.RebalanceEventListParamsInput, headers?: ClientHeaders) => Promise<{
             limit: number;
-            nextCursor: string | undefined;
             items: {
                 id: string;
                 autoRebalanceConfigId: string;
@@ -2168,6 +2314,7 @@ declare class Core {
                 createdAt: string;
                 error?: string | undefined;
             }[];
+            nextCursor?: string | undefined;
         }>;
     };
     savedBaskets: {
@@ -2227,7 +2374,6 @@ declare class Core {
     schedules: {
         list: (query: HttpTypes.ScheduleListParamsInput, headers?: ClientHeaders) => Promise<{
             limit: number;
-            nextCursor: string | undefined;
             schedules: ({
                 id: string;
                 connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
@@ -2323,6 +2469,7 @@ declare class Core {
                     } | undefined;
                 }[] | undefined;
             })[];
+            nextCursor?: string | undefined;
         }>;
         create: (body: HttpTypes.CreateSchedule, headers?: ClientHeaders) => Promise<{
             schedule: {
@@ -3179,7 +3326,6 @@ declare class Core {
     triggers: {
         list: (query: HttpTypes.TriggerListParamsInput, headers?: ClientHeaders) => Promise<{
             limit: number;
-            nextCursor: string | undefined;
             triggers: ({
                 id: string;
                 tradeAccountId: string;
@@ -3598,6 +3744,7 @@ declare class Core {
                     stopBreachedAt?: number | undefined;
                 } | undefined;
             })[];
+            nextCursor?: string | undefined;
         }>;
         open: (body: HttpTypes.CreateTriggerOpen, headers?: ClientHeaders) => Promise<{
             trigger: {

package/dist/core/index.js

@@ -83,6 +83,12 @@ class Core {
         headers,
         query
       });
+    },
+    get: async (id, headers) => {
+      return await this.client.fetch(`/executions/${id}`, {
+        method: "GET",
+        headers
+      });
     }
   };
   fills = {

package/dist/external/kalshi.js

@@ -1,3 +1,5 @@
+import { proxyFetch } from '@pear-protocol/utils';
+
 const BASE_URL = "https://api.elections.kalshi.com";
 const BATCH_SIZE = 100;
 async function fetchKalshiMarketNames(tickers) {
@@ -7,7 +9,7 @@ async function fetchKalshiMarketNames(tickers) {
     const url = new URL(`${BASE_URL}/trade-api/v2/markets`);
     url.searchParams.set("tickers", batch.join(","));
     url.searchParams.set("limit", String(BATCH_SIZE));
-    const response = await fetch(url, { method: "GET", headers: { accept: "application/json" } });
+    const response = await proxyFetch(url, { method: "GET", headers: { accept: "application/json" } });
     if (!response.ok) throw new Error(`Kalshi API error: ${response.status} ${response.statusText}`);
     const data = await response.json();
     for (const m of data.markets ?? []) result.set(m.ticker, m.title);
@@ -22,7 +24,7 @@ async function searchKalshiTriggers(params = {}) {
   if (params.category) url.searchParams.set("category", params.category);
   if (params.search) url.searchParams.set("query", params.search);
   if (params.cursor) url.searchParams.set("cursor", params.cursor);
-  const response = await fetch(url, { method: "GET", headers: { accept: "application/json" } });
+  const response = await proxyFetch(url, { method: "GET", headers: { accept: "application/json" } });
   if (!response.ok) return { triggers: [], nextCursor: null };
   const data = await response.json();
   return {

package/dist/external/polymarket.js

@@ -1,3 +1,5 @@
+import { proxyFetch } from '@pear-protocol/utils';
+
 const BASE_URL = "https://gamma-api.polymarket.com";
 const BATCH_SIZE = 100;
 async function fetchPolymarketMarketNames(ids) {
@@ -7,7 +9,7 @@ async function fetchPolymarketMarketNames(ids) {
     const url = new URL(`${BASE_URL}/markets`);
     for (const id of batch) url.searchParams.append("id", id);
     url.searchParams.set("limit", String(BATCH_SIZE));
-    const response = await fetch(url, { method: "GET", headers: { accept: "application/json" } });
+    const response = await proxyFetch(url, { method: "GET", headers: { accept: "application/json" } });
     if (!response.ok) throw new Error(`Polymarket API error: ${response.status} ${response.statusText}`);
     const data = await response.json();
     for (const m of data) result.set(m.id, m.question ?? m.groupItemTitle ?? "");
@@ -23,7 +25,7 @@ async function searchPolymarketTriggers(params = {}) {
   if (params.search) url.searchParams.set("title_search", params.search);
   if (params.category) url.searchParams.set("tag_slug", params.category);
   if (params.cursor) url.searchParams.set("after_cursor", params.cursor);
-  const response = await fetch(url, { method: "GET", headers: { accept: "application/json" } });
+  const response = await proxyFetch(url, { method: "GET", headers: { accept: "application/json" } });
   if (!response.ok) return { triggers: [], nextCursor: null };
   const data = await response.json();
   const events = data.events ?? [];

package/dist/http.d.ts

@@ -1,5 +1,6 @@
 import { AuthMode, Logger, RequestMiddleware, ResponseMiddleware, FetchInput, FetchArgs } from './types.js';
 import '@pear-protocol/types';
+import '@pear-protocol/utils';
 
 declare class HttpClient {
     private baseUrl;

package/dist/index.d.ts

@@ -5,6 +5,7 @@ import { External } from './external/index.js';
 import { SDKConfig } from './types.js';
 export { ExternalTrigger, ExternalTriggerSource, HttpTypes, SearchTriggersParams, SearchTriggersResponse, TriggerOutcome } from '@pear-protocol/types';
 export * from '@pear-protocol/utils';
+export { FetchError } from './utils.js';
 import './http.js';
 
 declare class PearSDK {

package/dist/index.js

@@ -1,3 +1,5 @@
+import { configureProxy } from '@pear-protocol/utils';
+export * from '@pear-protocol/utils';
 import { Admin } from './admin';
 import { Auth } from './auth';
 import { Core } from './core';
@@ -5,7 +7,7 @@ import { External } from './external';
 export { External } from './external';
 import { HttpClient } from './http';
 import { FetchError } from './utils';
-export * from '@pear-protocol/utils';
+export { FetchError } from './utils';
 
 const SESSION_REFRESH_PATH = "/auth/session/refresh";
 const SESSION_REFRESH_TIMEOUT_MS = 15e3;
@@ -35,6 +37,7 @@ class PearSDK {
   core;
   external;
   constructor(config) {
+    if (config.proxy) configureProxy(config.proxy);
     const authMode = config.auth?.type ?? "session";
     const logger = config.logger ?? {
       error: console.error,

package/dist/types.d.ts

@@ -1,4 +1,5 @@
 import { HttpTypes } from '@pear-protocol/types';
+import { ProxyConfig } from '@pear-protocol/utils';
 
 type AuthMode = 'session' | 'bearer' | 'apikey';
 type SDKConfig = {
@@ -88,6 +89,14 @@ type SDKConfig = {
      * Example: true
      */
     debug?: boolean;
+    /**
+     * Optional forward-proxy for the SDK's external HTTP calls (prediction-market data). When
+     * enabled, requests are re-pointed at `proxy.url` with the original host in `X-Proxy-Target`.
+     * Injected here because the SDK also runs in the browser, where env vars are unavailable.
+     *
+     * Example: { enabled: true, url: 'http://proxy.internal:8080' }
+     */
+    proxy?: ProxyConfig;
 };
 type Logger = {
     error: (...messages: string[]) => void;

package/dist/utils.d.ts

@@ -1,5 +1,6 @@
 import { FetchArgs, AuthMode } from './types.js';
 import '@pear-protocol/types';
+import '@pear-protocol/utils';
 
 declare function getBaseUrl(passedBaseUrl: string): string;
 declare function normalizeRequest(init: FetchArgs | undefined, headers: Headers, authMode: AuthMode): RequestInit | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pear-protocol/core-sdk",
-  "version": "1.6.0",
+  "version": "1.8.0",
   "description": "Pear Protocol Core SDK",
   "private": false,
   "type": "module",
@@ -27,8 +27,8 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@pear-protocol/types": "^1.8.0",
-    "@pear-protocol/utils": "^0.1.0",
+    "@pear-protocol/types": "^1.11.0",
+    "@pear-protocol/utils": "^0.2.0",
     "qs": "^6.14.0"
   },
   "devDependencies": {