@crosspost/sdk 0.1.4 → 0.1.6

package/dist/index.cjs

@@ -43,6 +43,7 @@ __export(index_exports, {
   AuthStatusResponseSchema: () => AuthStatusResponseSchema,
   AuthUrlResponseSchema: () => AuthUrlResponseSchema,
   BaseError: () => BaseError,
+  CompositeApiError: () => CompositeApiError,
   ConnectedAccountSchema: () => ConnectedAccountSchema,
   ConnectedAccountsResponseSchema: () => ConnectedAccountsResponseSchema,
   CreatePostRequestSchema: () => CreatePostRequestSchema,
@@ -4387,6 +4388,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["MULTI_STATUS"] = "MULTI_STATUS";
   return ApiErrorCode2;
 })(ApiErrorCode || {});
 var ApiError = class _ApiError extends BaseError {
@@ -4483,6 +4485,18 @@ var PlatformError = class extends Error {
     this.details = details;
   }
 };
+var CompositeApiError = class extends ApiError {
+  constructor(message, errors, status = 207, details, recoverable = false) {
+    super(
+      message,
+      "MULTI_STATUS",
+      status,
+      { ...details, errors },
+      recoverable
+    );
+    this.errors = errors;
+  }
+};
 var PlatformParamSchema = z.object({
   platform: z.string().describe("Social media platform")
 }).describe("Platform parameter");
@@ -4820,15 +4834,15 @@ var EndpointRateLimitResponseSchema = z.object({
   signerId: z.string().describe("NEAR account ID")
 }).describe("Endpoint rate limit response");
 var TimePeriod = /* @__PURE__ */ ((TimePeriod2) => {
-  TimePeriod2["ALL_TIME"] = "all";
-  TimePeriod2["YEARLY"] = "yearly";
-  TimePeriod2["MONTHLY"] = "monthly";
-  TimePeriod2["WEEKLY"] = "weekly";
-  TimePeriod2["DAILY"] = "daily";
+  TimePeriod2["ALL"] = "all";
+  TimePeriod2["YEARLY"] = "year";
+  TimePeriod2["MONTHLY"] = "month";
+  TimePeriod2["WEEKLY"] = "week";
+  TimePeriod2["DAILY"] = "day";
   return TimePeriod2;
 })(TimePeriod || {});
 var ActivityLeaderboardQuerySchema = z.object({
-  timeframe: z.enum(["day", "week", "month", "all"]).optional().describe(
+  timeframe: z.nativeEnum(TimePeriod).optional().describe(
     "Timeframe for the leaderboard"
   ),
   limit: z.string().optional().transform((val) => val ? parseInt(val, 10) : void 0).pipe(z.number().min(1).max(100).optional()).describe("Maximum number of results to return (1-100)"),
@@ -4847,7 +4861,7 @@ var AccountActivityEntrySchema = z.object({
 }).describe("Account activity entry");
 var ActivityLeaderboardResponseSchema = EnhancedResponseSchema(
   z.object({
-    timeframe: z.enum(["day", "week", "month", "all"]).describe("Timeframe for the leaderboard"),
+    timeframe: z.nativeEnum(TimePeriod).describe("Timeframe for the leaderboard"),
     entries: z.array(AccountActivityEntrySchema).describe("Leaderboard entries"),
     total: z.number().describe("Total number of entries in the leaderboard"),
     limit: z.number().describe("Maximum number of results returned"),
@@ -4859,7 +4873,7 @@ var AccountActivityParamsSchema = z.object({
   signerId: z.string().describe("NEAR account ID")
 }).describe("Account activity params");
 var AccountActivityQuerySchema = z.object({
-  timeframe: z.enum(["day", "week", "month", "all"]).optional().describe(
+  timeframe: z.nativeEnum(TimePeriod).optional().describe(
     "Timeframe for the activity"
   )
 }).describe("Account activity query");
@@ -4876,7 +4890,7 @@ var PlatformActivitySchema = z.object({
 var AccountActivityResponseSchema = EnhancedResponseSchema(
   z.object({
     signerId: z.string().describe("NEAR account ID"),
-    timeframe: z.enum(["day", "week", "month", "all"]).describe("Timeframe for the activity"),
+    timeframe: z.nativeEnum(TimePeriod).describe("Timeframe for the activity"),
     totalPosts: z.number().describe("Total number of posts across all platforms"),
     totalLikes: z.number().describe("Total number of likes across all platforms"),
     totalReposts: z.number().describe("Total number of reposts across all platforms"),
@@ -5113,6 +5127,38 @@ async function apiWrapper(apiCall, context) {
   }
 }
 function handleErrorResponse(data, status) {
+  if (data?.errors && Array.isArray(data.errors)) {
+    if (data.errors.length === 1) {
+      const errorDetail = data.errors[0];
+      if (errorDetail.platform && Object.values(Platform).includes(errorDetail.platform)) {
+        return new PlatformError(
+          errorDetail.message,
+          errorDetail.platform,
+          errorDetail.code,
+          errorDetail.recoverable ?? false,
+          void 0,
+          status,
+          errorDetail.userId,
+          errorDetail.details
+        );
+      } else {
+        return new ApiError(
+          errorDetail.message,
+          errorDetail.code,
+          status,
+          errorDetail.details,
+          errorDetail.recoverable ?? false
+        );
+      }
+    } else if (data.errors.length > 1) {
+      return new CompositeApiError(
+        "Multiple errors occurred",
+        data.errors,
+        status,
+        { originalResponse: data }
+      );
+    }
+  }
   const errorData = data?.error || {};
   const message = errorData?.message || data?.message || "An API error occurred";
   const codeString = errorData?.code || data?.code || ApiErrorCode.UNKNOWN_ERROR;
@@ -5129,19 +5175,17 @@ function handleErrorResponse(data, status) {
       message,
       platform,
       code,
-      // Use the parsed code
+      recoverable,
+      void 0,
       status,
-      // Cast status
-      enhancedDetails,
-      recoverable
+      void 0,
+      enhancedDetails
     );
   } else {
     return new ApiError(
       message,
       code,
-      // Use the parsed code
       status,
-      // Cast status
       enhancedDetails,
       recoverable
     );
@@ -5650,6 +5694,7 @@ var CrosspostClient = class {
   AuthStatusResponseSchema,
   AuthUrlResponseSchema,
   BaseError,
+  CompositeApiError,
   ConnectedAccountSchema,
   ConnectedAccountsResponseSchema,
   CreatePostRequestSchema,

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 } from '@crosspost/types';
+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';
 export * from '@crosspost/types';
 
 /**
@@ -378,15 +378,7 @@ declare function apiWrapper<T>(apiCall: () => Promise<T>, context?: Record<strin
  * @param status The HTTP status code
  * @returns An ApiError or PlatformError instance
  */
-declare function handleErrorResponse(data: any, status: number): ApiError | PlatformError;
-/**
- * Creates a network error with appropriate details
- *
- * @param error The original error
- * @param url The request URL
- * @param timeout The request timeout
- * @returns An ApiError instance
- */
+declare function handleErrorResponse(data: any, status: number): ApiError | PlatformError | CompositeApiError;
 declare function createNetworkError(error: unknown, url: string, timeout: number): ApiError;
 
 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 };

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 } from '@crosspost/types';
+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';
 export * from '@crosspost/types';
 
 /**
@@ -378,15 +378,7 @@ declare function apiWrapper<T>(apiCall: () => Promise<T>, context?: Record<strin
  * @param status The HTTP status code
  * @returns An ApiError or PlatformError instance
  */
-declare function handleErrorResponse(data: any, status: number): ApiError | PlatformError;
-/**
- * Creates a network error with appropriate details
- *
- * @param error The original error
- * @param url The request URL
- * @param timeout The request timeout
- * @returns An ApiError instance
- */
+declare function handleErrorResponse(data: any, status: number): ApiError | PlatformError | CompositeApiError;
 declare function createNetworkError(error: unknown, url: string, timeout: number): ApiError;
 
 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 };

package/dist/index.js

@@ -4250,6 +4250,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["MULTI_STATUS"] = "MULTI_STATUS";
   return ApiErrorCode2;
 })(ApiErrorCode || {});
 var ApiError = class _ApiError extends BaseError {
@@ -4346,6 +4347,18 @@ var PlatformError = class extends Error {
     this.details = details;
   }
 };
+var CompositeApiError = class extends ApiError {
+  constructor(message, errors, status = 207, details, recoverable = false) {
+    super(
+      message,
+      "MULTI_STATUS",
+      status,
+      { ...details, errors },
+      recoverable
+    );
+    this.errors = errors;
+  }
+};
 var PlatformParamSchema = z.object({
   platform: z.string().describe("Social media platform")
 }).describe("Platform parameter");
@@ -4683,15 +4696,15 @@ var EndpointRateLimitResponseSchema = z.object({
   signerId: z.string().describe("NEAR account ID")
 }).describe("Endpoint rate limit response");
 var TimePeriod = /* @__PURE__ */ ((TimePeriod2) => {
-  TimePeriod2["ALL_TIME"] = "all";
-  TimePeriod2["YEARLY"] = "yearly";
-  TimePeriod2["MONTHLY"] = "monthly";
-  TimePeriod2["WEEKLY"] = "weekly";
-  TimePeriod2["DAILY"] = "daily";
+  TimePeriod2["ALL"] = "all";
+  TimePeriod2["YEARLY"] = "year";
+  TimePeriod2["MONTHLY"] = "month";
+  TimePeriod2["WEEKLY"] = "week";
+  TimePeriod2["DAILY"] = "day";
   return TimePeriod2;
 })(TimePeriod || {});
 var ActivityLeaderboardQuerySchema = z.object({
-  timeframe: z.enum(["day", "week", "month", "all"]).optional().describe(
+  timeframe: z.nativeEnum(TimePeriod).optional().describe(
     "Timeframe for the leaderboard"
   ),
   limit: z.string().optional().transform((val) => val ? parseInt(val, 10) : void 0).pipe(z.number().min(1).max(100).optional()).describe("Maximum number of results to return (1-100)"),
@@ -4710,7 +4723,7 @@ var AccountActivityEntrySchema = z.object({
 }).describe("Account activity entry");
 var ActivityLeaderboardResponseSchema = EnhancedResponseSchema(
   z.object({
-    timeframe: z.enum(["day", "week", "month", "all"]).describe("Timeframe for the leaderboard"),
+    timeframe: z.nativeEnum(TimePeriod).describe("Timeframe for the leaderboard"),
     entries: z.array(AccountActivityEntrySchema).describe("Leaderboard entries"),
     total: z.number().describe("Total number of entries in the leaderboard"),
     limit: z.number().describe("Maximum number of results returned"),
@@ -4722,7 +4735,7 @@ var AccountActivityParamsSchema = z.object({
   signerId: z.string().describe("NEAR account ID")
 }).describe("Account activity params");
 var AccountActivityQuerySchema = z.object({
-  timeframe: z.enum(["day", "week", "month", "all"]).optional().describe(
+  timeframe: z.nativeEnum(TimePeriod).optional().describe(
     "Timeframe for the activity"
   )
 }).describe("Account activity query");
@@ -4739,7 +4752,7 @@ var PlatformActivitySchema = z.object({
 var AccountActivityResponseSchema = EnhancedResponseSchema(
   z.object({
     signerId: z.string().describe("NEAR account ID"),
-    timeframe: z.enum(["day", "week", "month", "all"]).describe("Timeframe for the activity"),
+    timeframe: z.nativeEnum(TimePeriod).describe("Timeframe for the activity"),
     totalPosts: z.number().describe("Total number of posts across all platforms"),
     totalLikes: z.number().describe("Total number of likes across all platforms"),
     totalReposts: z.number().describe("Total number of reposts across all platforms"),
@@ -4976,6 +4989,38 @@ async function apiWrapper(apiCall, context) {
   }
 }
 function handleErrorResponse(data, status) {
+  if (data?.errors && Array.isArray(data.errors)) {
+    if (data.errors.length === 1) {
+      const errorDetail = data.errors[0];
+      if (errorDetail.platform && Object.values(Platform).includes(errorDetail.platform)) {
+        return new PlatformError(
+          errorDetail.message,
+          errorDetail.platform,
+          errorDetail.code,
+          errorDetail.recoverable ?? false,
+          void 0,
+          status,
+          errorDetail.userId,
+          errorDetail.details
+        );
+      } else {
+        return new ApiError(
+          errorDetail.message,
+          errorDetail.code,
+          status,
+          errorDetail.details,
+          errorDetail.recoverable ?? false
+        );
+      }
+    } else if (data.errors.length > 1) {
+      return new CompositeApiError(
+        "Multiple errors occurred",
+        data.errors,
+        status,
+        { originalResponse: data }
+      );
+    }
+  }
   const errorData = data?.error || {};
   const message = errorData?.message || data?.message || "An API error occurred";
   const codeString = errorData?.code || data?.code || ApiErrorCode.UNKNOWN_ERROR;
@@ -4992,19 +5037,17 @@ function handleErrorResponse(data, status) {
       message,
       platform,
       code,
-      // Use the parsed code
+      recoverable,
+      void 0,
       status,
-      // Cast status
-      enhancedDetails,
-      recoverable
+      void 0,
+      enhancedDetails
     );
   } else {
     return new ApiError(
       message,
       code,
-      // Use the parsed code
       status,
-      // Cast status
       enhancedDetails,
       recoverable
     );
@@ -5512,6 +5555,7 @@ export {
   AuthStatusResponseSchema,
   AuthUrlResponseSchema,
   BaseError,
+  CompositeApiError,
   ConnectedAccountSchema,
   ConnectedAccountsResponseSchema,
   CreatePostRequestSchema,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crosspost/sdk",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "SDK for interacting with the Crosspost API",
   "type": "module",
   "main": "dist/index.cjs",
@@ -36,7 +36,7 @@
   "author": "crosspost.near",
   "license": "MIT",
   "dependencies": {
-    "near-sign-verify": "^0.1.1"
+    "near-sign-verify": "^0.1.3"
   },
   "devDependencies": {
     "@types/node": "^20.10.5",

package/src/utils/error.ts

@@ -1,4 +1,12 @@
-import { ApiError, ApiErrorCode, Platform, PlatformError } from '@crosspost/types';
+import {
+  ApiError,
+  ApiErrorCode,
+  CompositeApiError,
+  type ErrorDetail,
+  Platform,
+  PlatformError,
+} from '@crosspost/types';
+import type { StatusCode } from 'hono/utils/http-status';
 
 /**
  * Error categories grouped by type
@@ -307,17 +315,55 @@ export async function apiWrapper<T>(
  * @param status The HTTP status code
  * @returns An ApiError or PlatformError instance
  */
-export function handleErrorResponse(data: any, status: number): ApiError | PlatformError {
-  // Safely access nested error properties
+export function handleErrorResponse(
+  data: any,
+  status: number,
+): ApiError | PlatformError | CompositeApiError {
+  // Check for enhanced error response format with multiple errors
+  if (data?.errors && Array.isArray(data.errors)) {
+    if (data.errors.length === 1) {
+      // Single error case - convert to standard error
+      const errorDetail = data.errors[0];
+      if (
+        errorDetail.platform && Object.values(Platform).includes(errorDetail.platform as Platform)
+      ) {
+        return new PlatformError(
+          errorDetail.message,
+          errorDetail.platform as Platform,
+          errorDetail.code,
+          errorDetail.recoverable ?? false,
+          undefined,
+          status as StatusCode,
+          errorDetail.userId,
+          errorDetail.details,
+        );
+      } else {
+        return new ApiError(
+          errorDetail.message,
+          errorDetail.code,
+          status as StatusCode,
+          errorDetail.details,
+          errorDetail.recoverable ?? false,
+        );
+      }
+    } else if (data.errors.length > 1) {
+      // Multiple errors case - return composite error
+      return new CompositeApiError(
+        'Multiple errors occurred',
+        data.errors as ErrorDetail[],
+        status as StatusCode,
+        { originalResponse: data },
+      );
+    }
+  }
+
+  // Fall back to legacy error format handling
   const errorData = data?.error || {};
   const message = errorData?.message || data?.message || 'An API error occurred';
-
-  // Ensure code is a valid ApiErrorCode or default
   const codeString = errorData?.code || data?.code || ApiErrorCode.UNKNOWN_ERROR;
   const code = Object.values(ApiErrorCode).includes(codeString as ApiErrorCode)
     ? codeString as ApiErrorCode
     : ApiErrorCode.UNKNOWN_ERROR;
-
   const details = errorData?.details || data?.details || {};
   const recoverable = errorData?.recoverable ?? data?.recoverable ?? false;
   const platform = errorData?.platform || data?.platform;
@@ -325,25 +371,25 @@ export function handleErrorResponse(data: any, status: number): ApiError | Platf
   // Add original response data to details if not already present
   const enhancedDetails = { ...details };
   if (typeof enhancedDetails === 'object' && !enhancedDetails.originalResponse) {
-    enhancedDetails.originalResponse = data; // Include the raw error payload for debugging
+    enhancedDetails.originalResponse = data;
   }
 
   if (platform && Object.values(Platform).includes(platform as Platform)) {
-    // If platform is specified and valid, it's a PlatformError
     return new PlatformError(
       message,
       platform as Platform,
-      code, // Use the parsed code
-      status as any, // Cast status
-      enhancedDetails,
+      code,
       recoverable,
+      undefined,
+      status as StatusCode,
+      undefined,
+      enhancedDetails,
     );
   } else {
-    // Otherwise, it's a general ApiError
     return new ApiError(
       message,
-      code, // Use the parsed code
-      status as any, // Cast status
+      code,
+      status as StatusCode,
       enhancedDetails,
       recoverable,
     );
@@ -358,6 +404,16 @@ export function handleErrorResponse(data: any, status: number): ApiError | Platf
  * @param timeout The request timeout
  * @returns An ApiError instance
  */
+/**
+ * Check if an error is a composite error containing multiple error details
+ *
+ * @param error The error to check
+ * @returns True if the error is a composite error, false otherwise
+ */
+export function isCompositeApiError(error: unknown): error is CompositeApiError {
+  return error instanceof CompositeApiError;
+}
+
 export function createNetworkError(error: unknown, url: string, timeout: number): ApiError {
   if (error instanceof DOMException && error.name === 'AbortError') {
     return new ApiError(