@crosspost/sdk 0.1.6 → 0.1.7

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { NearAuthData } from 'near-sign-verify';
-import { ActivityLeaderboardQuery, ActivityLeaderboardResponse, AccountActivityQuery, AccountActivityResponse, AccountPostsQuery, AccountPostsResponse, NearAuthorizationResponse, Platform, EnhancedApiResponse, AuthStatusResponse, AuthRevokeResponse, ConnectedAccountsResponse, CreatePostRequest, CreatePostResponse, RepostRequest, RepostResponse, QuotePostRequest, QuotePostResponse, ReplyToPostRequest, ReplyToPostResponse, LikePostRequest, LikePostResponse, UnlikePostRequest, UnlikePostResponse, DeletePostRequest, DeletePostResponse, RateLimitResponse, EndpointRateLimitResponse, ApiError, ApiErrorCode, PlatformError, CompositeApiError } from '@crosspost/types';
+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';
 export * from '@crosspost/types';
 
 /**
@@ -87,19 +87,19 @@ declare class AuthApi {
     loginToPlatform(platform: Platform, options?: {
         successUrl?: string;
         errorUrl?: string;
-    }): Promise<EnhancedApiResponse<any>>;
+    }): Promise<ApiResponse<any>>;
     /**
      * Refreshes the authentication token for the specified platform.
      * @param platform The target platform.
      * @returns A promise resolving with the refresh response.
      */
-    refreshToken(platform: Platform): Promise<EnhancedApiResponse<any>>;
+    refreshToken(platform: Platform): Promise<ApiResponse<any>>;
     /**
      * Refreshes the user's profile information from the specified platform.
      * @param platform The target platform.
      * @returns A promise resolving with the profile refresh response.
      */
-    refreshProfile(platform: Platform): Promise<EnhancedApiResponse<any>>;
+    refreshProfile(platform: Platform): Promise<ApiResponse<any>>;
     /**
      * Gets the authentication status for the specified platform.
      * @param platform The target platform.
@@ -199,9 +199,9 @@ declare class SystemApi {
      * Gets the health status of the API
      * @returns A promise resolving with the health status
      */
-    getHealthStatus(): Promise<{
+    getHealthStatus(): Promise<ApiResponse<{
         status: string;
-    }>;
+    }>>;
 }
 
 /**
@@ -256,129 +256,82 @@ declare class CrosspostClient {
 }
 
 /**
- * Error categories grouped by type
+ * CrosspostError class for SDK error handling
  */
-declare const ERROR_CATEGORIES: {
-    AUTH: ApiErrorCode[];
-    VALIDATION: ApiErrorCode[];
-    NETWORK: ApiErrorCode[];
-    PLATFORM: ApiErrorCode[];
-    CONTENT: ApiErrorCode[];
-    RATE_LIMIT: ApiErrorCode[];
-    POST: ApiErrorCode[];
-    MEDIA: ApiErrorCode[];
-};
-/**
- * Check if an error belongs to a specific category
- *
- * @param error The error to check
- * @param category The category to check against
- * @returns True if the error belongs to the category, false otherwise
- */
-declare function isErrorOfCategory(error: unknown, category: ApiErrorCode[]): boolean;
+declare class CrosspostError extends Error {
+    readonly code: ApiErrorCode;
+    readonly status: StatusCode;
+    readonly details?: ErrorDetails;
+    readonly recoverable: boolean;
+    constructor(message: string, code: ApiErrorCode, status: StatusCode, details?: ErrorDetails, recoverable?: boolean);
+    /**
+     * Get platform from details if available
+     */
+    get platform(): string | undefined;
+    /**
+     * Get userId from details if available
+     */
+    get userId(): string | undefined;
+}
 /**
  * Check if an error is an authentication error
- *
- * @param error The error to check
- * @returns True if the error is an authentication error, false otherwise
  */
 declare function isAuthError(error: unknown): boolean;
 /**
  * Check if an error is a validation error
- *
- * @param error The error to check
- * @returns True if the error is a validation error, false otherwise
  */
 declare function isValidationError(error: unknown): boolean;
 /**
  * Check if an error is a network error
- *
- * @param error The error to check
- * @returns True if the error is a network error, false otherwise
  */
 declare function isNetworkError(error: unknown): boolean;
 /**
  * Check if an error is a platform error
- *
- * @param error The error to check
- * @returns True if the error is a platform error, false otherwise
  */
 declare function isPlatformError(error: unknown): boolean;
 /**
  * Check if an error is a content policy error
- *
- * @param error The error to check
- * @returns True if the error is a content policy error, false otherwise
  */
 declare function isContentError(error: unknown): boolean;
 /**
  * Check if an error is a rate limit error
- *
- * @param error The error to check
- * @returns True if the error is a rate limit error, false otherwise
  */
 declare function isRateLimitError(error: unknown): boolean;
 /**
  * Check if an error is a post-related error
- *
- * @param error The error to check
- * @returns True if the error is a post-related error, false otherwise
  */
 declare function isPostError(error: unknown): boolean;
 /**
  * Check if an error is a media-related error
- *
- * @param error The error to check
- * @returns True if the error is a media-related error, false otherwise
  */
 declare function isMediaError(error: unknown): boolean;
 /**
  * Check if an error is recoverable
- *
- * @param error The error to check
- * @returns True if the error is recoverable, false otherwise
  */
 declare function isRecoverableError(error: unknown): boolean;
 /**
  * Get a user-friendly error message
- *
- * @param error The error to get the message from
- * @param defaultMessage The default message to return if no message is found
- * @returns The error message
  */
 declare function getErrorMessage(error: unknown, defaultMessage?: string): string;
 /**
- * Extract error details if available
- *
- * @param error The error to extract details from
- * @returns The error details or undefined if none are found
+ * Get error details if available
  */
-declare function getErrorDetails(error: unknown): Record<string, any> | undefined;
+declare function getErrorDetails(error: unknown): ErrorDetails | undefined;
 /**
  * Enrich an error with additional context
- *
- * @param error The error to enrich
- * @param context The context to add to the error
- * @returns The enriched error
  */
-declare function enrichErrorWithContext(error: unknown, context: Record<string, any>): Error;
+declare function enrichErrorWithContext(error: unknown, context: Record<string, unknown>): Error;
 /**
  * Wrapper for API calls with consistent error handling
- *
- * @param apiCall The API call to wrap
- * @param context Optional context to add to any errors
- * @returns The result of the API call
- * @throws An enriched error if the API call fails
  */
-declare function apiWrapper<T>(apiCall: () => Promise<T>, context?: Record<string, any>): Promise<T>;
+declare function apiWrapper<T>(apiCall: () => Promise<T>, context?: Record<string, unknown>): Promise<T>;
 /**
  * Handles error responses from the API and converts them to appropriate error objects.
- *
- * @param data The error response data
- * @param status The HTTP status code
- * @returns An ApiError or PlatformError instance
  */
-declare function handleErrorResponse(data: any, status: number): ApiError | PlatformError | CompositeApiError;
-declare function createNetworkError(error: unknown, url: string, timeout: number): ApiError;
+declare function handleErrorResponse(data: any, status: number): CrosspostError;
+/**
+ * Creates a network error with appropriate details
+ */
+declare function createNetworkError(error: unknown, url: string, timeout: number): CrosspostError;
 
-export { ActivityApi, AuthApi, CrosspostClient, type CrosspostClientConfig, ERROR_CATEGORIES, PostApi, SystemApi, apiWrapper, createNetworkError, enrichErrorWithContext, getErrorDetails, getErrorMessage, handleErrorResponse, isAuthError, isContentError, isErrorOfCategory, isMediaError, isNetworkError, isPlatformError, isPostError, isRateLimitError, isRecoverableError, isValidationError };
+export { ActivityApi, AuthApi, CrosspostClient, type CrosspostClientConfig, PostApi, SystemApi, apiWrapper, createNetworkError, enrichErrorWithContext, getErrorDetails, getErrorMessage, handleErrorResponse, isAuthError, isContentError, isMediaError, isNetworkError, isPlatformError, isPostError, isRateLimitError, isRecoverableError, isValidationError };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { NearAuthData } from 'near-sign-verify';
-import { ActivityLeaderboardQuery, ActivityLeaderboardResponse, AccountActivityQuery, AccountActivityResponse, AccountPostsQuery, AccountPostsResponse, NearAuthorizationResponse, Platform, EnhancedApiResponse, AuthStatusResponse, AuthRevokeResponse, ConnectedAccountsResponse, CreatePostRequest, CreatePostResponse, RepostRequest, RepostResponse, QuotePostRequest, QuotePostResponse, ReplyToPostRequest, ReplyToPostResponse, LikePostRequest, LikePostResponse, UnlikePostRequest, UnlikePostResponse, DeletePostRequest, DeletePostResponse, RateLimitResponse, EndpointRateLimitResponse, ApiError, ApiErrorCode, PlatformError, CompositeApiError } from '@crosspost/types';
+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';
 export * from '@crosspost/types';
 
 /**
@@ -87,19 +87,19 @@ declare class AuthApi {
     loginToPlatform(platform: Platform, options?: {
         successUrl?: string;
         errorUrl?: string;
-    }): Promise<EnhancedApiResponse<any>>;
+    }): Promise<ApiResponse<any>>;
     /**
      * Refreshes the authentication token for the specified platform.
      * @param platform The target platform.
      * @returns A promise resolving with the refresh response.
      */
-    refreshToken(platform: Platform): Promise<EnhancedApiResponse<any>>;
+    refreshToken(platform: Platform): Promise<ApiResponse<any>>;
     /**
      * Refreshes the user's profile information from the specified platform.
      * @param platform The target platform.
      * @returns A promise resolving with the profile refresh response.
      */
-    refreshProfile(platform: Platform): Promise<EnhancedApiResponse<any>>;
+    refreshProfile(platform: Platform): Promise<ApiResponse<any>>;
     /**
      * Gets the authentication status for the specified platform.
      * @param platform The target platform.
@@ -199,9 +199,9 @@ declare class SystemApi {
      * Gets the health status of the API
      * @returns A promise resolving with the health status
      */
-    getHealthStatus(): Promise<{
+    getHealthStatus(): Promise<ApiResponse<{
         status: string;
-    }>;
+    }>>;
 }
 
 /**
@@ -256,129 +256,82 @@ declare class CrosspostClient {
 }
 
 /**
- * Error categories grouped by type
+ * CrosspostError class for SDK error handling
  */
-declare const ERROR_CATEGORIES: {
-    AUTH: ApiErrorCode[];
-    VALIDATION: ApiErrorCode[];
-    NETWORK: ApiErrorCode[];
-    PLATFORM: ApiErrorCode[];
-    CONTENT: ApiErrorCode[];
-    RATE_LIMIT: ApiErrorCode[];
-    POST: ApiErrorCode[];
-    MEDIA: ApiErrorCode[];
-};
-/**
- * Check if an error belongs to a specific category
- *
- * @param error The error to check
- * @param category The category to check against
- * @returns True if the error belongs to the category, false otherwise
- */
-declare function isErrorOfCategory(error: unknown, category: ApiErrorCode[]): boolean;
+declare class CrosspostError extends Error {
+    readonly code: ApiErrorCode;
+    readonly status: StatusCode;
+    readonly details?: ErrorDetails;
+    readonly recoverable: boolean;
+    constructor(message: string, code: ApiErrorCode, status: StatusCode, details?: ErrorDetails, recoverable?: boolean);
+    /**
+     * Get platform from details if available
+     */
+    get platform(): string | undefined;
+    /**
+     * Get userId from details if available
+     */
+    get userId(): string | undefined;
+}
 /**
  * Check if an error is an authentication error
- *
- * @param error The error to check
- * @returns True if the error is an authentication error, false otherwise
  */
 declare function isAuthError(error: unknown): boolean;
 /**
  * Check if an error is a validation error
- *
- * @param error The error to check
- * @returns True if the error is a validation error, false otherwise
  */
 declare function isValidationError(error: unknown): boolean;
 /**
  * Check if an error is a network error
- *
- * @param error The error to check
- * @returns True if the error is a network error, false otherwise
  */
 declare function isNetworkError(error: unknown): boolean;
 /**
  * Check if an error is a platform error
- *
- * @param error The error to check
- * @returns True if the error is a platform error, false otherwise
  */
 declare function isPlatformError(error: unknown): boolean;
 /**
  * Check if an error is a content policy error
- *
- * @param error The error to check
- * @returns True if the error is a content policy error, false otherwise
  */
 declare function isContentError(error: unknown): boolean;
 /**
  * Check if an error is a rate limit error
- *
- * @param error The error to check
- * @returns True if the error is a rate limit error, false otherwise
  */
 declare function isRateLimitError(error: unknown): boolean;
 /**
  * Check if an error is a post-related error
- *
- * @param error The error to check
- * @returns True if the error is a post-related error, false otherwise
  */
 declare function isPostError(error: unknown): boolean;
 /**
  * Check if an error is a media-related error
- *
- * @param error The error to check
- * @returns True if the error is a media-related error, false otherwise
  */
 declare function isMediaError(error: unknown): boolean;
 /**
  * Check if an error is recoverable
- *
- * @param error The error to check
- * @returns True if the error is recoverable, false otherwise
  */
 declare function isRecoverableError(error: unknown): boolean;
 /**
  * Get a user-friendly error message
- *
- * @param error The error to get the message from
- * @param defaultMessage The default message to return if no message is found
- * @returns The error message
  */
 declare function getErrorMessage(error: unknown, defaultMessage?: string): string;
 /**
- * Extract error details if available
- *
- * @param error The error to extract details from
- * @returns The error details or undefined if none are found
+ * Get error details if available
  */
-declare function getErrorDetails(error: unknown): Record<string, any> | undefined;
+declare function getErrorDetails(error: unknown): ErrorDetails | undefined;
 /**
  * Enrich an error with additional context
- *
- * @param error The error to enrich
- * @param context The context to add to the error
- * @returns The enriched error
  */
-declare function enrichErrorWithContext(error: unknown, context: Record<string, any>): Error;
+declare function enrichErrorWithContext(error: unknown, context: Record<string, unknown>): Error;
 /**
  * Wrapper for API calls with consistent error handling
- *
- * @param apiCall The API call to wrap
- * @param context Optional context to add to any errors
- * @returns The result of the API call
- * @throws An enriched error if the API call fails
  */
-declare function apiWrapper<T>(apiCall: () => Promise<T>, context?: Record<string, any>): Promise<T>;
+declare function apiWrapper<T>(apiCall: () => Promise<T>, context?: Record<string, unknown>): Promise<T>;
 /**
  * Handles error responses from the API and converts them to appropriate error objects.
- *
- * @param data The error response data
- * @param status The HTTP status code
- * @returns An ApiError or PlatformError instance
  */
-declare function handleErrorResponse(data: any, status: number): ApiError | PlatformError | CompositeApiError;
-declare function createNetworkError(error: unknown, url: string, timeout: number): ApiError;
+declare function handleErrorResponse(data: any, status: number): CrosspostError;
+/**
+ * Creates a network error with appropriate details
+ */
+declare function createNetworkError(error: unknown, url: string, timeout: number): CrosspostError;
 
-export { ActivityApi, AuthApi, CrosspostClient, type CrosspostClientConfig, ERROR_CATEGORIES, PostApi, SystemApi, apiWrapper, createNetworkError, enrichErrorWithContext, getErrorDetails, getErrorMessage, handleErrorResponse, isAuthError, isContentError, isErrorOfCategory, isMediaError, isNetworkError, isPlatformError, isPostError, isRateLimitError, isRecoverableError, isValidationError };
+export { ActivityApi, AuthApi, CrosspostClient, type CrosspostClientConfig, PostApi, SystemApi, apiWrapper, createNetworkError, enrichErrorWithContext, getErrorDetails, getErrorMessage, handleErrorResponse, isAuthError, isContentError, isMediaError, isNetworkError, isPlatformError, isPostError, isRateLimitError, isRecoverableError, isValidationError };