@crosspost/sdk 0.1.7 → 0.1.9

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { NearAuthData } from 'near-sign-verify';
-import { ActivityLeaderboardQuery, ActivityLeaderboardResponse, AccountActivityQuery, AccountActivityResponse, AccountPostsQuery, AccountPostsResponse, NearAuthorizationResponse, Platform, ApiResponse, AuthStatusResponse, AuthRevokeResponse, ConnectedAccountsResponse, CreatePostRequest, CreatePostResponse, RepostRequest, RepostResponse, QuotePostRequest, QuotePostResponse, ReplyToPostRequest, ReplyToPostResponse, LikePostRequest, LikePostResponse, UnlikePostRequest, UnlikePostResponse, DeletePostRequest, DeletePostResponse, RateLimitResponse, EndpointRateLimitResponse, ApiErrorCode, StatusCode, ErrorDetails } from '@crosspost/types';
+import { ActivityLeaderboardQuery, ActivityLeaderboardResponse, AccountActivityQuery, AccountActivityResponse, AccountPostsQuery, AccountPostsResponse, NearAuthorizationResponse, Platform, AuthInitRequest, AuthUrlResponse, AuthCallbackResponse, ConnectedAccount, AuthStatusResponse, NearUnauthorizationResponse, AuthRevokeResponse, ConnectedAccountsResponse, CreatePostRequest, CreatePostResponse, RepostRequest, RepostResponse, QuotePostRequest, QuotePostResponse, ReplyToPostRequest, ReplyToPostResponse, LikePostRequest, LikePostResponse, UnlikePostRequest, UnlikePostResponse, DeletePostRequest, DeletePostResponse, RateLimitResponse, EndpointRateLimitResponse, HealthStatus, ApiErrorCode, StatusCode, ErrorDetails } from '@crosspost/types';
 export * from '@crosspost/types';
 
 /**
@@ -12,17 +12,18 @@ interface RequestOptions {
     baseUrl: string;
     /**
      * NEAR authentication data for generating auth tokens
-     * Can be undefined if not authorize yet
+     * Required for non-GET requests, optional for GET requests
      */
     nearAuthData?: NearAuthData;
     /**
-     * Request timeout in milliseconds
+     * NEAR account ID for simplified GET request authentication
+     * If not provided, will use account_id from nearAuthData
      */
-    timeout: number;
+    nearAccount?: string;
     /**
-     * Number of retries for failed requests
+     * Request timeout in milliseconds
      */
-    retries: number;
+    timeout: number;
 }
 
 /**
@@ -84,34 +85,37 @@ declare class AuthApi {
      * @param options Optional success and error redirect URLs.
      * @returns A promise resolving with the response from the service (might indicate success/failure or redirect info).
      */
-    loginToPlatform(platform: Platform, options?: {
-        successUrl?: string;
-        errorUrl?: string;
-    }): Promise<ApiResponse<any>>;
+    loginToPlatform(platform: Platform, options?: AuthInitRequest): Promise<AuthUrlResponse>;
     /**
      * Refreshes the authentication token for the specified platform.
      * @param platform The target platform.
-     * @returns A promise resolving with the refresh response.
+     * @returns A promise resolving with the refresh response containing updated auth details.
      */
-    refreshToken(platform: Platform): Promise<ApiResponse<any>>;
+    refreshToken(platform: Platform, userId: string): Promise<AuthCallbackResponse>;
     /**
      * Refreshes the user's profile information from the specified platform.
      * @param platform The target platform.
-     * @returns A promise resolving with the profile refresh response.
+     * @param userId The user ID on the platform
+     * @returns A promise resolving with the updated account profile information.
      */
-    refreshProfile(platform: Platform): Promise<ApiResponse<any>>;
+    refreshProfile(platform: Platform, userId: string): Promise<ConnectedAccount>;
     /**
      * Gets the authentication status for the specified platform.
      * @param platform The target platform.
      * @returns A promise resolving with the authentication status response.
      */
-    getAuthStatus(platform: Platform): Promise<AuthStatusResponse>;
+    getAuthStatus(platform: Platform, userId: string): Promise<AuthStatusResponse>;
+    /**
+     * Unauthorizes a NEAR account from using the service
+     * @returns A promise resolving with the unauthorized response
+     */
+    unauthorizeNear(): Promise<NearUnauthorizationResponse>;
     /**
      * Revokes the authentication token for the specified platform.
      * @param platform The target platform.
      * @returns A promise resolving with the revocation response.
      */
-    revokeAuth(platform: Platform): Promise<AuthRevokeResponse>;
+    revokeAuth(platform: Platform, userId: string): Promise<AuthRevokeResponse>;
     /**
      * Lists all accounts connected to the NEAR account.
      * @returns A promise resolving with the list of connected accounts.
@@ -199,9 +203,7 @@ declare class SystemApi {
      * Gets the health status of the API
      * @returns A promise resolving with the health status
      */
-    getHealthStatus(): Promise<ApiResponse<{
-        status: string;
-    }>>;
+    getHealthStatus(): Promise<HealthStatus>;
 }
 
 /**
@@ -222,11 +224,6 @@ interface CrosspostClientConfig {
      * @default 30000
      */
     timeout?: number;
-    /**
-     * Number of retries for failed requests (specifically for network errors or 5xx status codes)
-     * @default 2
-     */
-    retries?: number;
 }
 
 /**
@@ -245,14 +242,36 @@ declare class CrosspostClient {
     constructor(config?: CrosspostClientConfig);
     /**
      * Sets the authentication data (signature) for the client
+     * Required for non-GET requests
      * @param nearAuthData The NEAR authentication data
      */
     setAuthentication(nearAuthData: NearAuthData): void;
+    /**
+     * Sets the NEAR account ID for simplified GET request authentication
+     * If not set, will use account_id from nearAuthData
+     * @param nearAccount The NEAR account ID
+     */
+    setNearAccount(nearAccount: string): void;
+    /**
+     * Gets the current NEAR account ID being used for authentication
+     * @returns The NEAR account ID from nearAccount or nearAuthData
+     */
+    getNearAccount(): string | undefined;
     /**
      * Checks if authentication data (signature) exists on client
-     * @param signature The NEAR authentication data
+     * @returns true if nearAuthData is set (required for non-GET requests)
      */
     isAuthenticated(): boolean;
+    /**
+     * Checks if a NEAR account is set for GET request authentication
+     * @returns true if either nearAccount or nearAuthData.account_id is set
+     */
+    hasNearAccount(): boolean;
+    /**
+     * Clears all authentication data from the client
+     * This will prevent all requests from working until new authentication is set
+     */
+    clear(): void;
 }
 
 /**

package/dist/index.js

@@ -4095,6 +4095,7 @@ var ApiErrorCode = /* @__PURE__ */ ((ApiErrorCode2) => {
   ApiErrorCode2["POST_DELETION_FAILED"] = "POST_DELETION_FAILED";
   ApiErrorCode2["POST_INTERACTION_FAILED"] = "POST_INTERACTION_FAILED";
   ApiErrorCode2["NETWORK_ERROR"] = "NETWORK_ERROR";
+  ApiErrorCode2["INVALID_RESPONSE"] = "INVALID_RESPONSE";
   return ApiErrorCode2;
 })(ApiErrorCode || {});
 var ApiErrorCodeSchema = z.enum(Object.values(ApiErrorCode));
@@ -4174,7 +4175,11 @@ var errorCodeToStatusCode = {
   [
     "NETWORK_ERROR"
     /* NETWORK_ERROR */
-  ]: 503
+  ]: 503,
+  [
+    "INVALID_RESPONSE"
+    /* INVALID_RESPONSE */
+  ]: 500
 };
 var ErrorDetailSchema = z.object({
   message: z.string().describe("Human-readable error message"),
@@ -4207,6 +4212,11 @@ var SuccessDetailSchema = z.object({
   additionalData: z.any().optional(),
   status: z.literal("success")
 }).catchall(z.any());
+var HealthStatusSchema = z.object({
+  status: z.string().describe("Health status of the API"),
+  version: z.string().optional().describe("API version"),
+  timestamp: z.string().datetime().describe("Current server time")
+}).describe("Health status response");
 var MultiStatusDataSchema = z.object({
   summary: z.object({
     total: z.number().int().nonnegative(),
@@ -4239,6 +4249,14 @@ var AuthCallbackResponseSchema = z.object({
   userId: z.string().describe("User ID"),
   redirectUrl: z.string().optional().describe("URL to redirect the user to after authentication")
 }).describe("Auth callback response");
+var AuthStatusParamsSchema = z.object({
+  platform: z.string().describe("Social media platform"),
+  userId: z.string().describe("User ID on the platform")
+}).describe("Token status parameters");
+var NearUnauthorizationResponseSchema = z.object({
+  success: z.boolean().describe("Whether the unauthorized operation was successful"),
+  nearAccount: z.string().describe("NEAR account ID that was unauthorized")
+}).describe("NEAR unauthorized response");
 var AuthStatusResponseSchema = z.object({
   platform: PlatformSchema,
   userId: z.string().describe("User ID"),
@@ -4835,7 +4853,7 @@ function createNetworkError(error, url, timeout) {
 // src/core/request.ts
 async function makeRequest(method, path, options, data, query) {
   let url = `${options.baseUrl}${path.startsWith("/") ? path : `/${path}`}`;
-  if (query && Object.keys(query).length > 0) {
+  if (query && typeof query === "object" && Object.keys(query).length > 0) {
     const queryParams = new URLSearchParams();
     for (const [key, value] of Object.entries(query)) {
       if (value !== void 0 && value !== null) {
@@ -4850,84 +4868,96 @@ async function makeRequest(method, path, options, data, query) {
   const context = {
     method,
     path,
-    url,
-    retries: options.retries
+    url
   };
-  return apiWrapper(async () => {
-    let lastError = null;
-    for (let attempt = 0; attempt <= options.retries; attempt++) {
-      const controller = new AbortController();
-      const timeoutId = setTimeout(() => controller.abort(), options.timeout);
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), options.timeout);
+  try {
+    const headers = {
+      "Content-Type": "application/json",
+      "Accept": "application/json"
+    };
+    if (method === "GET") {
+      const nearAccount = options.nearAccount || options.nearAuthData?.account_id;
+      if (!nearAccount) {
+        throw new CrosspostError(
+          "No NEAR account provided for GET request",
+          ApiErrorCode.UNAUTHORIZED,
+          401
+        );
+      }
+      headers["X-Near-Account"] = nearAccount;
+    } else {
+      if (!options.nearAuthData) {
+        throw new CrosspostError(
+          "NEAR authentication data required for non-GET request",
+          ApiErrorCode.UNAUTHORIZED,
+          401
+        );
+      }
+      headers["Authorization"] = `Bearer ${createAuthToken(options.nearAuthData)}`;
+    }
+    const requestOptions = {
+      method,
+      headers,
+      body: method !== "GET" && data ? JSON.stringify(data) : void 0,
+      signal: controller.signal
+    };
+    const response = await fetch(url, requestOptions);
+    clearTimeout(timeoutId);
+    let responseData;
+    try {
+      responseData = await response.json();
+    } catch (jsonError) {
+      let responseText;
       try {
-        const headers = {
-          "Content-Type": "application/json",
-          "Accept": "application/json",
-          "Authorization": `Bearer ${createAuthToken(options.nearAuthData)}`
-        };
-        const requestOptions = {
-          method,
-          headers,
-          body: method !== "GET" && data ? JSON.stringify(data) : void 0,
-          signal: controller.signal
-        };
-        const response = await fetch(url, requestOptions);
-        clearTimeout(timeoutId);
-        let responseData;
-        try {
-          responseData = await response.json();
-        } catch (jsonError) {
-          if (!response.ok) {
-            throw new CrosspostError(
-              `API request failed with status ${response.status} and non-JSON response`,
-              ApiErrorCode.NETWORK_ERROR,
-              response.status,
-              { originalStatusText: response.statusText }
-            );
-          }
-          throw new CrosspostError(
-            `Failed to parse JSON response: ${jsonError instanceof Error ? jsonError.message : String(jsonError)}`,
-            ApiErrorCode.INTERNAL_ERROR,
-            response.status
-          );
-        }
-        if (!response.ok) {
-          lastError = handleErrorResponse(responseData, response.status);
-          const shouldRetry = lastError instanceof CrosspostError && lastError.code === ApiErrorCode.RATE_LIMITED;
-          if (shouldRetry && attempt < options.retries) {
-            await new Promise((resolve) => setTimeout(resolve, 1e3 * Math.pow(2, attempt)));
-            continue;
-          }
-          throw lastError;
-        }
-        if (responseData && typeof responseData === "object" && "success" in responseData) {
-          if (responseData.success) {
-            return responseData.data;
-          } else {
-            lastError = handleErrorResponse(responseData, response.status);
-            const shouldRetry = lastError instanceof CrosspostError && lastError.code === ApiErrorCode.RATE_LIMITED;
-            if (shouldRetry && attempt < options.retries) {
-              await new Promise((resolve) => setTimeout(resolve, 1e3 * Math.pow(2, attempt)));
-              continue;
-            }
-            throw lastError;
-          }
-        }
-      } catch (error) {
-        clearTimeout(timeoutId);
-        lastError = error instanceof Error ? error : new Error(String(error));
-        const isNetworkError2 = error instanceof TypeError || error instanceof DOMException && error.name === "AbortError";
-        if (isNetworkError2 && attempt < options.retries) {
-          await new Promise((resolve) => setTimeout(resolve, 1e3 * Math.pow(2, attempt)));
-          continue;
-        }
-        if (!(error instanceof CrosspostError)) {
-          throw createNetworkError(error, url, options.timeout);
-        }
-        throw error;
+        responseText = await response.text();
+      } catch (_) {
       }
+      throw new CrosspostError(
+        `API request failed with status ${response.status} and non-JSON response`,
+        ApiErrorCode.INVALID_RESPONSE,
+        response.status,
+        {
+          originalStatusText: response.statusText,
+          originalError: jsonError instanceof Error ? jsonError.message : String(jsonError),
+          responseText
+        }
+      );
+    }
+    if (!response.ok) {
+      throw handleErrorResponse(responseData, response.status);
+    }
+    if (!responseData || typeof responseData !== "object" || !("success" in responseData)) {
+      throw new CrosspostError(
+        "Invalid success response format from API",
+        ApiErrorCode.INVALID_RESPONSE,
+        response.status,
+        { responseData }
+      );
+    }
+    if (responseData.success) {
+      return responseData.data;
+    }
+    throw handleErrorResponse(responseData, response.status);
+  } catch (error) {
+    clearTimeout(timeoutId);
+    if (error instanceof CrosspostError) {
+      throw enrichErrorWithContext(error, context);
+    }
+    if (error instanceof TypeError || error instanceof DOMException && error.name === "AbortError") {
+      throw enrichErrorWithContext(createNetworkError(error, url, options.timeout), context);
     }
-    throw lastError || new CrosspostError("Request failed after multiple retries", ApiErrorCode.INTERNAL_ERROR, 500);
-  }, context);
+    throw enrichErrorWithContext(
+      new CrosspostError(
+        error instanceof Error ? error.message : String(error),
+        ApiErrorCode.INTERNAL_ERROR,
+        500,
+        { originalError: String(error) }
+      ),
+      context
+    );
+  }
 }
 
 // src/api/activity.ts
@@ -5035,25 +5065,28 @@ var AuthApi = class {
   /**
    * Refreshes the authentication token for the specified platform.
    * @param platform The target platform.
-   * @returns A promise resolving with the refresh response.
+   * @returns A promise resolving with the refresh response containing updated auth details.
    */
-  async refreshToken(platform) {
+  async refreshToken(platform, userId) {
     return makeRequest(
       "POST",
       `/auth/${platform}/refresh`,
-      this.options
+      this.options,
+      { userId }
     );
   }
   /**
    * Refreshes the user's profile information from the specified platform.
    * @param platform The target platform.
-   * @returns A promise resolving with the profile refresh response.
+   * @param userId The user ID on the platform
+   * @returns A promise resolving with the updated account profile information.
    */
-  async refreshProfile(platform) {
+  async refreshProfile(platform, userId) {
     return makeRequest(
       "POST",
       `/auth/${platform}/refresh-profile`,
-      this.options
+      this.options,
+      { userId }
     );
   }
   /**
@@ -5061,11 +5094,25 @@ var AuthApi = class {
    * @param platform The target platform.
    * @returns A promise resolving with the authentication status response.
    */
-  async getAuthStatus(platform) {
+  async getAuthStatus(platform, userId) {
     return makeRequest(
       "GET",
-      `/auth/${platform}/status`,
-      this.options
+      `/auth/${platform}/status/${userId}`,
+      this.options,
+      void 0,
+      { platform, userId }
+    );
+  }
+  /**
+   * Unauthorizes a NEAR account from using the service
+   * @returns A promise resolving with the unauthorized response
+   */
+  async unauthorizeNear() {
+    return makeRequest(
+      "DELETE",
+      "/auth/unauthorize/near",
+      this.options,
+      {}
     );
   }
   /**
@@ -5073,11 +5120,12 @@ var AuthApi = class {
    * @param platform The target platform.
    * @returns A promise resolving with the revocation response.
    */
-  async revokeAuth(platform) {
+  async revokeAuth(platform, userId) {
     return makeRequest(
       "DELETE",
       `/auth/${platform}/revoke`,
-      this.options
+      this.options,
+      { userId }
     );
   }
   /**
@@ -5224,7 +5272,9 @@ var SystemApi = class {
     return makeRequest(
       "GET",
       `/api/rate-limit/${endpoint}`,
-      this.options
+      this.options,
+      void 0,
+      { endpoint }
     );
   }
   /**
@@ -5243,8 +5293,7 @@ var SystemApi = class {
 // src/core/config.ts
 var DEFAULT_CONFIG = {
   baseUrl: "https://open-crosspost-proxy.deno.dev/",
-  timeout: 3e4,
-  retries: 2
+  timeout: 3e4
 };
 
 // src/core/client.ts
@@ -5256,12 +5305,10 @@ var CrosspostClient = class {
   constructor(config = {}) {
     const baseUrl = config.baseUrl || DEFAULT_CONFIG.baseUrl;
     const timeout = config.timeout || DEFAULT_CONFIG.timeout;
-    const retries = config.retries ?? DEFAULT_CONFIG.retries;
     const nearAuthData = config.nearAuthData;
     this.options = {
       baseUrl,
       timeout,
-      retries,
       nearAuthData
     };
     this.auth = new AuthApi(this.options);
@@ -5271,18 +5318,52 @@ var CrosspostClient = class {
   }
   /**
    * Sets the authentication data (signature) for the client
+   * Required for non-GET requests
    * @param nearAuthData The NEAR authentication data
    */
   setAuthentication(nearAuthData) {
     this.options.nearAuthData = nearAuthData;
+    if (!this.options.nearAccount) {
+      this.options.nearAccount = nearAuthData.account_id;
+    }
+  }
+  /**
+   * Sets the NEAR account ID for simplified GET request authentication
+   * If not set, will use account_id from nearAuthData
+   * @param nearAccount The NEAR account ID
+   */
+  setNearAccount(nearAccount) {
+    this.options.nearAccount = nearAccount;
+  }
+  /**
+   * Gets the current NEAR account ID being used for authentication
+   * @returns The NEAR account ID from nearAccount or nearAuthData
+   */
+  getNearAccount() {
+    return this.options.nearAccount || this.options.nearAuthData?.account_id;
   }
   /**
    * Checks if authentication data (signature) exists on client
-   * @param signature The NEAR authentication data
+   * @returns true if nearAuthData is set (required for non-GET requests)
    */
   isAuthenticated() {
     return !!this.options.nearAuthData;
   }
+  /**
+   * Checks if a NEAR account is set for GET request authentication
+   * @returns true if either nearAccount or nearAuthData.account_id is set
+   */
+  hasNearAccount() {
+    return !!(this.options.nearAccount || this.options.nearAuthData?.account_id);
+  }
+  /**
+   * Clears all authentication data from the client
+   * This will prevent all requests from working until new authentication is set
+   */
+  clear() {
+    this.options.nearAuthData = void 0;
+    this.options.nearAccount = void 0;
+  }
 };
 export {
   AccountActivityEntrySchema,
@@ -5301,6 +5382,7 @@ export {
   AuthCallbackResponseSchema,
   AuthInitRequestSchema,
   AuthRevokeResponseSchema,
+  AuthStatusParamsSchema,
   AuthStatusResponseSchema,
   AuthTokenRequestSchema,
   AuthUrlResponseSchema,
@@ -5314,6 +5396,7 @@ export {
   DeleteResultSchema,
   EndpointRateLimitResponseSchema,
   ErrorDetailSchema,
+  HealthStatusSchema,
   LikePostRequestSchema,
   LikePostResponseSchema,
   LikeResultSchema,
@@ -5323,6 +5406,7 @@ export {
   NearAuthorizationRequestSchema,
   NearAuthorizationResponseSchema,
   NearAuthorizationStatusResponseSchema,
+  NearUnauthorizationResponseSchema,
   Platform,
   PlatformActivitySchema,
   PlatformParamSchema,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crosspost/sdk",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "SDK for interacting with the Crosspost API",
   "type": "module",
   "main": "dist/index.cjs",

package/src/api/activity.ts

@@ -28,7 +28,7 @@ export class ActivityApi {
    * @returns A promise resolving with the leaderboard response
    */
   async getLeaderboard(query?: ActivityLeaderboardQuery): Promise<ActivityLeaderboardResponse> {
-    return makeRequest<ActivityLeaderboardResponse>(
+    return makeRequest<ActivityLeaderboardResponse, never, ActivityLeaderboardQuery>(
       'GET',
       '/api/activity',
       this.options,
@@ -47,7 +47,7 @@ export class ActivityApi {
     signerId: string,
     query?: AccountActivityQuery,
   ): Promise<AccountActivityResponse> {
-    return makeRequest<AccountActivityResponse>(
+    return makeRequest<AccountActivityResponse, never, AccountActivityQuery>(
       'GET',
       `/api/activity/${signerId}`,
       this.options,
@@ -66,7 +66,7 @@ export class ActivityApi {
     signerId: string,
     query?: AccountPostsQuery,
   ): Promise<AccountPostsResponse> {
-    return makeRequest<AccountPostsResponse>(
+    return makeRequest<AccountPostsResponse, never, AccountPostsQuery>(
       'GET',
       `/api/activity/${signerId}/posts`,
       this.options,