@pear-protocol/core-sdk 0.0.1

package/dist/trade/index.js

@@ -0,0 +1,85 @@
+class Trade {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  async open(body, headers) {
+    return await this.client.fetch(`/trade/open`, {
+      method: "POST",
+      headers,
+      body
+    });
+  }
+  async adjust(positionId, body, headers) {
+    return await this.client.fetch(`/trade/${positionId}/adjust`, {
+      method: "POST",
+      headers,
+      body
+    });
+  }
+  async close(positionId, body, headers) {
+    return await this.client.fetch(`/trade/${positionId}/close`, {
+      method: "POST",
+      headers,
+      body
+    });
+  }
+  async closeAll(body, headers) {
+    return await this.client.fetch(`/trade/close-all`, {
+      method: "POST",
+      headers,
+      body
+    });
+  }
+  schedules = {
+    create: async (body, headers) => {
+      return await this.client.fetch(`/schedules`, {
+        method: "POST",
+        headers,
+        body
+      });
+    },
+    cancel: async (scheduleId, headers) => {
+      return await this.client.fetch(`/schedules/${scheduleId}/cancel`, {
+        method: "PATCH",
+        headers
+      });
+    },
+    cancelAll: async (headers) => {
+      return await this.client.fetch(`/schedules/cancel-all`, {
+        method: "PATCH",
+        headers
+      });
+    }
+  };
+  triggers = {
+    open: async (body, headers) => {
+      return await this.client.fetch(`/triggers/open`, {
+        method: "POST",
+        headers,
+        body
+      });
+    },
+    close: async (body, headers) => {
+      return await this.client.fetch(`/triggers/close`, {
+        method: "POST",
+        headers,
+        body
+      });
+    },
+    cancel: async (triggerId, headers) => {
+      return await this.client.fetch(`/triggers/${triggerId}/cancel`, {
+        method: "PATCH",
+        headers
+      });
+    },
+    cancelAll: async (headers) => {
+      return await this.client.fetch(`/triggers/cancel-all`, {
+        method: "PATCH",
+        headers
+      });
+    }
+  };
+}
+
+export { Trade };

package/dist/types.d.ts

@@ -0,0 +1,93 @@
+type AuthMode = 'session' | 'bearer';
+type SDKConfig = {
+    /**
+     * Trade + Info endpoints.
+     *
+     * Example: 'https://api.pear.garden'
+     */
+    apiUrl: string;
+    /**
+     * Authentication endpoint.
+     *
+     * Example: 'https://auth.pear.garden'
+     */
+    authUrl: string;
+    /**
+     * Authentication transport mode:
+     *
+     * Session (default):
+     * Cookies sent via `credentials: 'include'`. No tokens in JS memory.
+     * SDK retries once on 401 by calling `POST /auth/refresh`.
+     * Used by web applications.
+     *
+     * Bearer:
+     * Token set on every request via `Authorization` header. Provide
+     * `token` getter to supply the API key or JWT. No client-side refresh.
+     * If 401, caller handles re-auth. Used by headless / API-key clients.
+     */
+    auth?: {
+        type: AuthMode;
+        /**
+         * Token getter for bearer mode (e.g. () => apiKey). Ignored in session mode.
+         *
+         * Example: () => localStorage.getItem('apiKey')
+         */
+        token?: () => string | null;
+    };
+    /**
+     * Trade account ID getter (used in both modes)
+     *
+     * Example: () => localStorage.getState().activeTradeAccountId
+     */
+    getTradeAccountId?: () => string | null;
+    /**
+     * Called when server returns 401 (bearer mode only)
+     *
+     * Example: () => {
+     *   console.error('Unauthorized. Token may be expired or revoked.');
+     *   localStorage.removeItem('apiKey');
+     * }
+     */
+    onAuthError?: () => void;
+    /**
+     * Logger for debugging
+     *
+     * Example: {
+     *   error: console.error,
+     *   warn: console.warn,
+     *   info: console.info,
+     *   debug: console.debug,
+     * }
+     */
+    logger?: Logger;
+    /**
+     * Whether to print debug messages to the console.
+     *
+     * Example: true
+     */
+    debug?: boolean;
+};
+type Logger = {
+    error: (...messages: string[]) => void;
+    warn: (...messages: string[]) => void;
+    info: (...messages: string[]) => void;
+    debug: (...messages: string[]) => void;
+};
+type FetchParams = Parameters<typeof fetch>;
+type ClientHeaders = Record<string, string | null | {
+    /**
+     * Tags to cache data under for Next.js applications.
+     * https://nextjs.org/docs/app/building-your-application/caching#fetch-optionsnexttags-and-revalidatetag
+     */
+    tags: string[];
+}>;
+type FetchInput = FetchParams[0];
+type FetchArgs = Omit<RequestInit, 'headers' | 'body'> & {
+    query?: Record<string, any>;
+    headers?: ClientHeaders;
+    body?: RequestInit['body'] | Record<string, any>;
+};
+type RequestMiddleware = (request: Request, next: () => Promise<Response>) => Promise<Response>;
+type ResponseMiddleware = (response: Response, retry: () => Promise<Response>, request: Request) => Promise<Response>;
+
+export type { AuthMode, ClientHeaders, FetchArgs, FetchInput, FetchParams, Logger, RequestMiddleware, ResponseMiddleware, SDKConfig };

package/dist/types.js

@@ -0,0 +1 @@
+

package/dist/utils.d.ts

@@ -0,0 +1,12 @@
+import { FetchArgs, AuthMode } from './types.js';
+
+declare function getBaseUrl(passedBaseUrl: string): string;
+declare function normalizeRequest(init: FetchArgs | undefined, headers: Headers, authMode: AuthMode): RequestInit | undefined;
+declare function normalizeResponseData(resp: Response, reqHeaders: Headers): Promise<any>;
+declare class FetchError extends Error {
+    status: number | undefined;
+    statusText: string | undefined;
+    constructor(message: string, statusText?: string, status?: number);
+}
+
+export { FetchError, getBaseUrl, normalizeRequest, normalizeResponseData };

package/dist/utils.js

@@ -0,0 +1,45 @@
+function getBaseUrl(passedBaseUrl) {
+  if (typeof window === "undefined") {
+    return passedBaseUrl;
+  }
+  if (passedBaseUrl === "" || passedBaseUrl === "/") {
+    return window.location.origin;
+  }
+  return passedBaseUrl;
+}
+function normalizeRequest(init, headers, authMode) {
+  let body = init?.body;
+  if (body && headers.get("content-type")?.includes("application/json")) {
+    body = JSON.stringify(body);
+  }
+  return {
+    ...init,
+    headers,
+    ...body ? { body } : {},
+    // In session mode, include cookies with every request
+    // WHY: httpOnly cookies are sent automatically — no JS token management needed
+    ...authMode === "session" ? { credentials: "include" } : {}
+  };
+}
+async function normalizeResponseData(resp, reqHeaders) {
+  if (resp.status === 304) {
+    return null;
+  }
+  if (resp.status >= 300) {
+    const jsonError = await resp.json().catch(() => ({}));
+    throw new FetchError(jsonError.message ?? resp.statusText, resp.statusText, resp.status);
+  }
+  const isJsonRequest = reqHeaders.get("accept")?.includes("application/json");
+  return isJsonRequest ? await resp.json() : resp;
+}
+class FetchError extends Error {
+  status;
+  statusText;
+  constructor(message, statusText, status) {
+    super(message);
+    this.statusText = statusText;
+    this.status = status;
+  }
+}
+
+export { FetchError, getBaseUrl, normalizeRequest, normalizeResponseData };

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@pear-protocol/core-sdk",
+  "version": "0.0.1",
+  "description": "Pear Protocol Core SDK",
+  "private": false,
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "clean": "rm -rf dist .turbo",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@pear-protocol/types": "0.0.1",
+    "@pear-protocol/utils": "0.0.1",
+    "qs": "^6.14.0"
+  },
+  "devDependencies": {
+    "@backend/typescript-config": "workspace:*",
+    "@types/qs": "^6.14.0",
+    "tsup": "8.5.1",
+    "typescript": "5.9.3"
+  }
+}