@crosspost/sdk 0.1.7 → 0.1.8

package/dist/index.cjs

@@ -36,6 +36,7 @@ __export(index_exports, {
   AuthCallbackResponseSchema: () => AuthCallbackResponseSchema,
   AuthInitRequestSchema: () => AuthInitRequestSchema,
   AuthRevokeResponseSchema: () => AuthRevokeResponseSchema,
+  AuthStatusParamsSchema: () => AuthStatusParamsSchema,
   AuthStatusResponseSchema: () => AuthStatusResponseSchema,
   AuthTokenRequestSchema: () => AuthTokenRequestSchema,
   AuthUrlResponseSchema: () => AuthUrlResponseSchema,
@@ -49,6 +50,7 @@ __export(index_exports, {
   DeleteResultSchema: () => DeleteResultSchema,
   EndpointRateLimitResponseSchema: () => EndpointRateLimitResponseSchema,
   ErrorDetailSchema: () => ErrorDetailSchema,
+  HealthStatusSchema: () => HealthStatusSchema,
   LikePostRequestSchema: () => LikePostRequestSchema,
   LikePostResponseSchema: () => LikePostResponseSchema,
   LikeResultSchema: () => LikeResultSchema,
@@ -58,6 +60,7 @@ __export(index_exports, {
   NearAuthorizationRequestSchema: () => NearAuthorizationRequestSchema,
   NearAuthorizationResponseSchema: () => NearAuthorizationResponseSchema,
   NearAuthorizationStatusResponseSchema: () => NearAuthorizationStatusResponseSchema,
+  NearUnauthorizationResponseSchema: () => NearUnauthorizationResponseSchema,
   Platform: () => Platform,
   PlatformActivitySchema: () => PlatformActivitySchema,
   PlatformParamSchema: () => PlatformParamSchema,
@@ -4324,6 +4327,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(),
@@ -4356,6 +4364,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"),
@@ -4952,7 +4968,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) {
@@ -4978,9 +4994,28 @@ async function makeRequest(method, path, options, data, query) {
       try {
         const headers = {
           "Content-Type": "application/json",
-          "Accept": "application/json",
-          "Authorization": `Bearer ${(0, import_near_sign_verify.createAuthToken)(options.nearAuthData)}`
+          "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 ${(0, import_near_sign_verify.createAuthToken)(options.nearAuthData)}`;
+        }
         const requestOptions = {
           method,
           headers,
@@ -5152,25 +5187,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 }
     );
   }
   /**
@@ -5178,11 +5216,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,
+      {}
     );
   }
   /**
@@ -5190,11 +5242,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 }
     );
   }
   /**
@@ -5341,7 +5394,9 @@ var SystemApi = class {
     return makeRequest(
       "GET",
       `/api/rate-limit/${endpoint}`,
-      this.options
+      this.options,
+      void 0,
+      { endpoint }
     );
   }
   /**
@@ -5388,18 +5443,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;
+  }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
@@ -5419,6 +5508,7 @@ var CrosspostClient = class {
   AuthCallbackResponseSchema,
   AuthInitRequestSchema,
   AuthRevokeResponseSchema,
+  AuthStatusParamsSchema,
   AuthStatusResponseSchema,
   AuthTokenRequestSchema,
   AuthUrlResponseSchema,
@@ -5432,6 +5522,7 @@ var CrosspostClient = class {
   DeleteResultSchema,
   EndpointRateLimitResponseSchema,
   ErrorDetailSchema,
+  HealthStatusSchema,
   LikePostRequestSchema,
   LikePostResponseSchema,
   LikeResultSchema,
@@ -5441,6 +5532,7 @@ var CrosspostClient = class {
   NearAuthorizationRequestSchema,
   NearAuthorizationResponseSchema,
   NearAuthorizationStatusResponseSchema,
+  NearUnauthorizationResponseSchema,
   Platform,
   PlatformActivitySchema,
   PlatformParamSchema,

package/dist/index.d.cts

@@ -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,9 +12,14 @@ 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;
+    /**
+     * NEAR account ID for simplified GET request authentication
+     * If not provided, will use account_id from nearAuthData
+     */
+    nearAccount?: string;
     /**
      * Request timeout in milliseconds
      */
@@ -84,34 +89,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 +207,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>;
 }
 
 /**
@@ -245,14 +251,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.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,9 +12,14 @@ 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;
+    /**
+     * NEAR account ID for simplified GET request authentication
+     * If not provided, will use account_id from nearAuthData
+     */
+    nearAccount?: string;
     /**
      * Request timeout in milliseconds
      */
@@ -84,34 +89,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 +207,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>;
 }
 
 /**
@@ -245,14 +251,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

@@ -4207,6 +4207,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 +4244,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 +4848,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) {
@@ -4861,9 +4874,28 @@ async function makeRequest(method, path, options, data, query) {
       try {
         const headers = {
           "Content-Type": "application/json",
-          "Accept": "application/json",
-          "Authorization": `Bearer ${createAuthToken(options.nearAuthData)}`
+          "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,
@@ -5035,25 +5067,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 +5096,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 +5122,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 +5274,9 @@ var SystemApi = class {
     return makeRequest(
       "GET",
       `/api/rate-limit/${endpoint}`,
-      this.options
+      this.options,
+      void 0,
+      { endpoint }
     );
   }
   /**
@@ -5271,18 +5323,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 +5387,7 @@ export {
   AuthCallbackResponseSchema,
   AuthInitRequestSchema,
   AuthRevokeResponseSchema,
+  AuthStatusParamsSchema,
   AuthStatusResponseSchema,
   AuthTokenRequestSchema,
   AuthUrlResponseSchema,
@@ -5314,6 +5401,7 @@ export {
   DeleteResultSchema,
   EndpointRateLimitResponseSchema,
   ErrorDetailSchema,
+  HealthStatusSchema,
   LikePostRequestSchema,
   LikePostResponseSchema,
   LikeResultSchema,
@@ -5323,6 +5411,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.8",
   "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,

package/src/api/auth.ts

@@ -1,9 +1,16 @@
 import type {
-  ApiResponse,
+  AuthCallbackResponse,
+  AuthInitRequest,
   AuthRevokeResponse,
+  AuthStatusParams,
   AuthStatusResponse,
+  AuthTokenRequest,
+  AuthUrlResponse,
+  ConnectedAccount,
   ConnectedAccountsResponse,
+  NearAuthorizationRequest,
   NearAuthorizationResponse,
+  NearUnauthorizationResponse,
   Platform,
 } from '@crosspost/types';
 import { makeRequest, type RequestOptions } from '../core/request.ts';
@@ -27,7 +34,7 @@ export class AuthApi {
    * @returns A promise resolving with the authorization response.
    */
   async authorizeNearAccount(): Promise<NearAuthorizationResponse> {
-    return makeRequest<NearAuthorizationResponse>(
+    return makeRequest<NearAuthorizationResponse, NearAuthorizationRequest>(
       'POST',
       '/auth/authorize/near',
       this.options,
@@ -40,7 +47,7 @@ export class AuthApi {
    * @returns A promise resolving with the authorization status response.
    */
   async getNearAuthorizationStatus(): Promise<NearAuthorizationResponse> {
-    return makeRequest<NearAuthorizationResponse>(
+    return makeRequest<NearAuthorizationResponse, never>(
       'GET',
       '/auth/authorize/near/status',
       this.options,
@@ -56,9 +63,9 @@ export class AuthApi {
    */
   async loginToPlatform(
     platform: Platform,
-    options?: { successUrl?: string; errorUrl?: string },
-  ): Promise<ApiResponse<any>> { // TODO: Refine response type based on actual API
-    return makeRequest<ApiResponse<any>>(
+    options?: AuthInitRequest,
+  ): Promise<AuthUrlResponse> {
+    return makeRequest<AuthUrlResponse, AuthInitRequest>(
       'POST',
       `/auth/${platform}/login`,
       this.options,
@@ -69,26 +76,29 @@ export class AuthApi {
   /**
    * 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: Platform): Promise<ApiResponse<any>> { // TODO: Refine response type
-    return makeRequest<ApiResponse<any>>(
+  async refreshToken(platform: Platform, userId: string): Promise<AuthCallbackResponse> {
+    return makeRequest<AuthCallbackResponse, AuthTokenRequest>(
       'POST',
       `/auth/${platform}/refresh`,
       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: Platform): Promise<ApiResponse<any>> { // TODO: Refine response type
-    return makeRequest<ApiResponse<any>>(
+  async refreshProfile(platform: Platform, userId: string): Promise<ConnectedAccount> {
+    return makeRequest<ConnectedAccount, AuthTokenRequest>(
       'POST',
       `/auth/${platform}/refresh-profile`,
       this.options,
+      { userId },
     );
   }
 
@@ -97,11 +107,26 @@ export class AuthApi {
    * @param platform The target platform.
    * @returns A promise resolving with the authentication status response.
    */
-  async getAuthStatus(platform: Platform): Promise<AuthStatusResponse> {
-    return makeRequest<AuthStatusResponse>(
+  async getAuthStatus(platform: Platform, userId: string): Promise<AuthStatusResponse> {
+    return makeRequest<AuthStatusResponse, never, AuthStatusParams>(
       'GET',
-      `/auth/${platform}/status`,
+      `/auth/${platform}/status/${userId}`,
       this.options,
+      undefined,
+      { platform, userId },
+    );
+  }
+
+  /**
+   * Unauthorizes a NEAR account from using the service
+   * @returns A promise resolving with the unauthorized response
+   */
+  async unauthorizeNear(): Promise<NearUnauthorizationResponse> {
+    return makeRequest<NearUnauthorizationResponse, NearAuthorizationRequest>(
+      'DELETE',
+      '/auth/unauthorize/near',
+      this.options,
+      {},
     );
   }
 
@@ -110,11 +135,12 @@ export class AuthApi {
    * @param platform The target platform.
    * @returns A promise resolving with the revocation response.
    */
-  async revokeAuth(platform: Platform): Promise<AuthRevokeResponse> {
-    return makeRequest<AuthRevokeResponse>(
+  async revokeAuth(platform: Platform, userId: string): Promise<AuthRevokeResponse> {
+    return makeRequest<AuthRevokeResponse, AuthTokenRequest>(
       'DELETE',
       `/auth/${platform}/revoke`,
       this.options,
+      { userId },
     );
   }
 
@@ -123,7 +149,7 @@ export class AuthApi {
    * @returns A promise resolving with the list of connected accounts.
    */
   async getConnectedAccounts(): Promise<ConnectedAccountsResponse> {
-    return makeRequest<ConnectedAccountsResponse>(
+    return makeRequest<ConnectedAccountsResponse, never>(
       'GET',
       '/auth/accounts',
       this.options,

package/src/api/post.ts

@@ -36,7 +36,7 @@ export class PostApi {
    * @returns A promise resolving with the post creation response.
    */
   async createPost(request: CreatePostRequest): Promise<CreatePostResponse> {
-    return makeRequest<CreatePostResponse>(
+    return makeRequest<CreatePostResponse, CreatePostRequest>(
       'POST',
       '/api/post',
       this.options,
@@ -50,7 +50,7 @@ export class PostApi {
    * @returns A promise resolving with the repost response.
    */
   async repost(request: RepostRequest): Promise<RepostResponse> {
-    return makeRequest<RepostResponse>(
+    return makeRequest<RepostResponse, RepostRequest>(
       'POST',
       '/api/post/repost',
       this.options,
@@ -64,7 +64,7 @@ export class PostApi {
    * @returns A promise resolving with the quote post response.
    */
   async quotePost(request: QuotePostRequest): Promise<QuotePostResponse> {
-    return makeRequest<QuotePostResponse>(
+    return makeRequest<QuotePostResponse, QuotePostRequest>(
       'POST',
       '/api/post/quote',
       this.options,
@@ -78,7 +78,7 @@ export class PostApi {
    * @returns A promise resolving with the reply response.
    */
   async replyToPost(request: ReplyToPostRequest): Promise<ReplyToPostResponse> {
-    return makeRequest<ReplyToPostResponse>(
+    return makeRequest<ReplyToPostResponse, ReplyToPostRequest>(
       'POST',
       '/api/post/reply',
       this.options,
@@ -92,7 +92,7 @@ export class PostApi {
    * @returns A promise resolving with the like response.
    */
   async likePost(request: LikePostRequest): Promise<LikePostResponse> {
-    return makeRequest<LikePostResponse>(
+    return makeRequest<LikePostResponse, LikePostRequest>(
       'POST',
       `/api/post/like`,
       this.options,
@@ -106,7 +106,7 @@ export class PostApi {
    * @returns A promise resolving with the unlike response.
    */
   async unlikePost(request: UnlikePostRequest): Promise<UnlikePostResponse> {
-    return makeRequest<UnlikePostResponse>(
+    return makeRequest<UnlikePostResponse, UnlikePostRequest>(
       'DELETE',
       `/api/post/like`,
       this.options,
@@ -120,7 +120,7 @@ export class PostApi {
    * @returns A promise resolving with the delete response.
    */
   async deletePost(request: DeletePostRequest): Promise<DeletePostResponse> {
-    return makeRequest<DeletePostResponse>(
+    return makeRequest<DeletePostResponse, DeletePostRequest>(
       'DELETE',
       `/api/post`,
       this.options,

package/src/api/system.ts

@@ -1,4 +1,9 @@
-import type { ApiResponse, EndpointRateLimitResponse, RateLimitResponse } from '@crosspost/types';
+import type {
+  EndpointRateLimitResponse,
+  HealthStatus,
+  RateLimitEndpointParam,
+  RateLimitResponse,
+} from '@crosspost/types';
 import { makeRequest, type RequestOptions } from '../core/request.ts';
 
 /**
@@ -21,7 +26,7 @@ export class SystemApi {
    * @returns A promise resolving with the rate limit response
    */
   async getRateLimits(): Promise<RateLimitResponse> {
-    return makeRequest<RateLimitResponse>(
+    return makeRequest<RateLimitResponse, never>(
       'GET',
       '/api/rate-limit',
       this.options,
@@ -34,10 +39,12 @@ export class SystemApi {
    * @returns A promise resolving with the endpoint rate limit response
    */
   async getEndpointRateLimit(endpoint: string): Promise<EndpointRateLimitResponse> {
-    return makeRequest<EndpointRateLimitResponse>(
+    return makeRequest<EndpointRateLimitResponse, never, RateLimitEndpointParam>(
       'GET',
       `/api/rate-limit/${endpoint}`,
       this.options,
+      undefined,
+      { endpoint },
     );
   }
 
@@ -45,8 +52,8 @@ export class SystemApi {
    * Gets the health status of the API
    * @returns A promise resolving with the health status
    */
-  async getHealthStatus(): Promise<ApiResponse<{ status: string }>> {
-    return makeRequest<ApiResponse<{ status: string }>>(
+  async getHealthStatus(): Promise<HealthStatus> {
+    return makeRequest<HealthStatus, never>(
       'GET',
       '/health',
       this.options,

package/src/core/client.ts

@@ -43,17 +43,56 @@ export class CrosspostClient {
 
   /**
    * Sets the authentication data (signature) for the client
+   * Required for non-GET requests
    * @param nearAuthData The NEAR authentication data
    */
   public setAuthentication(nearAuthData: NearAuthData): void {
     this.options.nearAuthData = nearAuthData;
+    // Also set nearAccount from nearAuthData if not already set
+    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
+   */
+  public setNearAccount(nearAccount: string): void {
+    this.options.nearAccount = nearAccount;
+  }
+
+  /**
+   * Gets the current NEAR account ID being used for authentication
+   * @returns The NEAR account ID from nearAccount or nearAuthData
+   */
+  public getNearAccount(): string | undefined {
+    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)
    */
   public isAuthenticated(): boolean {
     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
+   */
+  public hasNearAccount(): boolean {
+    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
+   */
+  public clear(): void {
+    this.options.nearAuthData = undefined;
+    this.options.nearAccount = undefined;
+  }
 }

package/src/core/request.ts

@@ -17,9 +17,14 @@ export 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;
+  /**
+   * NEAR account ID for simplified GET request authentication
+   * If not provided, will use account_id from nearAuthData
+   */
+  nearAccount?: string;
   /**
    * Request timeout in milliseconds
    */
@@ -39,17 +44,21 @@ export interface RequestOptions {
  * @param data Optional request data
  * @returns A promise resolving with the response data
  */
-export async function makeRequest<T>(
+export async function makeRequest<
+  TResponse,
+  TRequest = unknown,
+  TQuery = unknown,
+>(
   method: string,
   path: string,
   options: RequestOptions,
-  data?: any,
-  query?: Record<string, any>,
-): Promise<T> {
+  data?: TRequest,
+  query?: TQuery,
+): Promise<TResponse> {
   let url = `${options.baseUrl}${path.startsWith('/') ? path : `/${path}`}`;
 
   // Add query parameters if provided
-  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 !== undefined && value !== null) {
@@ -81,9 +90,31 @@ export async function makeRequest<T>(
         const headers: Record<string, string> = {
           'Content-Type': 'application/json',
           'Accept': 'application/json',
-          'Authorization': `Bearer ${createAuthToken(options.nearAuthData!)}`,
         };
 
+        // For GET requests, use X-Near-Account header if available
+        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 {
+          // For non-GET requests, require nearAuthData
+          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: RequestInit = {
           method,
           headers,
@@ -133,7 +164,7 @@ export async function makeRequest<T>(
         if (responseData && typeof responseData === 'object' && 'success' in responseData) {
           if (responseData.success) {
             // Success response - return the data
-            return responseData.data as T;
+            return responseData.data as TResponse;
           } else {
             // Error response - handle with our error utilities
             lastError = handleErrorResponse(responseData, response.status);