@lobehub/market-sdk 0.23.8 → 0.23.9-beta.1

package/dist/index.d.mts

@@ -1246,6 +1246,8 @@ interface CodeInterpreterToolParams {
  * Extended metadata for user profile
  */
 interface AccountMeta {
+    /** Any additional custom fields */
+    [key: string]: any;
     /** User description/bio */
     description?: string;
     /** Social links */
@@ -1254,8 +1256,6 @@ interface AccountMeta {
         twitter?: string;
         website?: string;
     };
-    /** Any additional custom fields */
-    [key: string]: any;
 }
 /**
  * User Profile
@@ -1355,6 +1355,200 @@ interface UpdateUserInfoResponse {
     /** Updated user profile */
     user: UserProfile;
 }
+/**
+ * Follow Request
+ *
+ * Request body for follow/unfollow operations
+ */
+interface FollowRequest {
+    /** The ID of the user to follow/unfollow */
+    followingId: number;
+}
+/**
+ * Check Follow Query
+ *
+ * Query parameters for checking follow status
+ */
+interface CheckFollowQuery {
+    /** The ID of the target user to check */
+    targetUserId: number;
+}
+/**
+ * Check Follow Response
+ *
+ * Response structure for check follow status endpoint
+ */
+interface CheckFollowResponse {
+    /** Whether the authenticated user is following the target user */
+    isFollowing: boolean;
+    /** Whether both users follow each other */
+    isMutual: boolean;
+}
+/**
+ * Follow List Item
+ *
+ * Represents a user in following/followers list
+ */
+interface FollowListItem {
+    /** User's avatar URL */
+    avatarUrl: string | null;
+    /** When the follow relationship was created */
+    createdAt: string;
+    /** User's display name */
+    displayName: string | null;
+    /** Account ID */
+    id: number;
+    /** Unique username */
+    userName: string | null;
+}
+/**
+ * Follow List Response
+ *
+ * Response structure for following/followers list endpoints
+ */
+interface FollowListResponse {
+    /** List of users */
+    data: FollowListItem[];
+}
+/**
+ * Target Type for favorites and likes
+ */
+type InteractionTargetType = 'agent' | 'plugin';
+/**
+ * Favorite Request
+ *
+ * Request body for add/remove favorite operations
+ */
+interface FavoriteRequest {
+    /** The ID of the target agent/plugin */
+    targetId: number;
+    /** The type of target */
+    targetType: InteractionTargetType;
+}
+/**
+ * Check Favorite Query
+ *
+ * Query parameters for checking favorite status
+ */
+interface CheckFavoriteQuery {
+    /** The ID of the target agent/plugin */
+    targetId: number;
+    /** The type of target */
+    targetType: InteractionTargetType;
+}
+/**
+ * Check Favorite Response
+ *
+ * Response structure for check favorite status endpoint
+ */
+interface CheckFavoriteResponse {
+    /** Whether the authenticated user has favorited the target */
+    isFavorited: boolean;
+}
+/**
+ * Favorite Query
+ *
+ * Query parameters for favorites list endpoints
+ */
+interface FavoriteQuery {
+    /** Maximum number of results to return */
+    limit?: number;
+    /** Number of results to skip */
+    offset?: number;
+    /** Filter by target type */
+    type?: InteractionTargetType;
+}
+/**
+ * Favorite List Response
+ *
+ * Response structure for favorites list endpoints
+ */
+interface FavoriteListResponse {
+    /** List of favorite items */
+    data: any[];
+}
+/**
+ * Like Request
+ *
+ * Request body for like/unlike operations
+ */
+interface LikeRequest {
+    /** The ID of the target agent/plugin */
+    targetId: number;
+    /** The type of target */
+    targetType: InteractionTargetType;
+}
+/**
+ * Check Like Query
+ *
+ * Query parameters for checking like status
+ */
+interface CheckLikeQuery {
+    /** The ID of the target agent/plugin */
+    targetId: number;
+    /** The type of target */
+    targetType: InteractionTargetType;
+}
+/**
+ * Check Like Response
+ *
+ * Response structure for check like status endpoint
+ */
+interface CheckLikeResponse {
+    /** Whether the authenticated user has liked the target */
+    isLiked: boolean;
+}
+/**
+ * Toggle Like Response
+ *
+ * Response structure for toggle like endpoint
+ */
+interface ToggleLikeResponse {
+    /** Whether the target is now liked */
+    liked: boolean;
+}
+/**
+ * Like Query
+ *
+ * Query parameters for likes list endpoints
+ */
+interface LikeQuery {
+    /** Maximum number of results to return */
+    limit?: number;
+    /** Number of results to skip */
+    offset?: number;
+    /** Filter by target type */
+    type?: InteractionTargetType;
+}
+/**
+ * Like List Response
+ *
+ * Response structure for likes list endpoints
+ */
+interface LikeListResponse {
+    /** List of liked items */
+    data: any[];
+}
+/**
+ * Success Response
+ *
+ * Common response structure for success operations
+ */
+interface SuccessResponse {
+    /** Whether the operation was successful */
+    success: boolean;
+}
+/**
+ * Pagination Query
+ *
+ * Common pagination parameters
+ */
+interface PaginationQuery {
+    /** Maximum number of results to return */
+    limit?: number;
+    /** Number of results to skip */
+    offset?: number;
+}
 
 /**
  * Base SDK class
@@ -2945,6 +3139,274 @@ declare class UserService extends BaseSDK {
     updateUserInfo(data: UpdateUserInfoRequest, options?: globalThis.RequestInit): Promise<UpdateUserInfoResponse>;
 }
 
+/**
+ * User Follow Service
+ *
+ * Provides access to user follow functionality in the LobeHub Marketplace.
+ * This service handles following/unfollowing users and retrieving follow relationships.
+ */
+declare class UserFollowService extends BaseSDK {
+    /**
+     * Follow a user
+     *
+     * Creates a follow relationship where the authenticated user follows the target user.
+     * Requires authentication.
+     *
+     * @param followingId - The ID of the user to follow
+     * @param options - Optional request options
+     * @returns Promise resolving to success response
+     * @throws Error if already following or cannot follow yourself
+     */
+    follow(followingId: number, options?: globalThis.RequestInit): Promise<SuccessResponse>;
+    /**
+     * Unfollow a user
+     *
+     * Removes the follow relationship where the authenticated user unfollows the target user.
+     * Requires authentication.
+     *
+     * @param followingId - The ID of the user to unfollow
+     * @param options - Optional request options
+     * @returns Promise resolving to success response
+     * @throws Error if follow relationship not found
+     */
+    unfollow(followingId: number, options?: globalThis.RequestInit): Promise<SuccessResponse>;
+    /**
+     * Check follow status
+     *
+     * Checks if the authenticated user is following the target user and if they follow each other.
+     * Requires authentication.
+     *
+     * @param targetUserId - The ID of the user to check
+     * @param options - Optional request options
+     * @returns Promise resolving to follow status (isFollowing, isMutual)
+     */
+    checkFollowStatus(targetUserId: number, options?: globalThis.RequestInit): Promise<CheckFollowResponse>;
+    /**
+     * Get following list
+     *
+     * Retrieves the list of users that a user is following.
+     * This is a public endpoint - no authentication required.
+     *
+     * @param userId - The ID of the user whose following list to retrieve
+     * @param params - Pagination parameters
+     * @param options - Optional request options
+     * @returns Promise resolving to list of following users
+     */
+    getFollowing(userId: number, params?: PaginationQuery, options?: globalThis.RequestInit): Promise<FollowListResponse>;
+    /**
+     * Get followers list
+     *
+     * Retrieves the list of users who follow a user.
+     * This is a public endpoint - no authentication required.
+     *
+     * @param userId - The ID of the user whose followers list to retrieve
+     * @param params - Pagination parameters
+     * @param options - Optional request options
+     * @returns Promise resolving to list of followers
+     */
+    getFollowers(userId: number, params?: PaginationQuery, options?: globalThis.RequestInit): Promise<FollowListResponse>;
+}
+
+/**
+ * User Favorite Service
+ *
+ * Provides access to user favorite functionality in the LobeHub Marketplace.
+ * This service handles adding/removing favorites and retrieving favorite lists.
+ */
+declare class UserFavoriteService extends BaseSDK {
+    /**
+     * Add to favorites
+     *
+     * Adds an agent or plugin to the authenticated user's favorites.
+     * Requires authentication.
+     *
+     * @param targetType - The type of target ('agent' or 'plugin')
+     * @param targetId - The ID of the target agent/plugin
+     * @param options - Optional request options
+     * @returns Promise resolving to success response
+     * @throws Error if already in favorites
+     */
+    addFavorite(targetType: InteractionTargetType, targetId: number, options?: globalThis.RequestInit): Promise<SuccessResponse>;
+    /**
+     * Remove from favorites
+     *
+     * Removes an agent or plugin from the authenticated user's favorites.
+     * Requires authentication.
+     *
+     * @param targetType - The type of target ('agent' or 'plugin')
+     * @param targetId - The ID of the target agent/plugin
+     * @param options - Optional request options
+     * @returns Promise resolving to success response
+     * @throws Error if favorite not found
+     */
+    removeFavorite(targetType: InteractionTargetType, targetId: number, options?: globalThis.RequestInit): Promise<SuccessResponse>;
+    /**
+     * Check favorite status
+     *
+     * Checks if the authenticated user has favorited a specific agent or plugin.
+     * Requires authentication.
+     *
+     * @param targetType - The type of target ('agent' or 'plugin')
+     * @param targetId - The ID of the target agent/plugin
+     * @param options - Optional request options
+     * @returns Promise resolving to favorite status
+     */
+    checkFavorite(targetType: InteractionTargetType, targetId: number, options?: globalThis.RequestInit): Promise<CheckFavoriteResponse>;
+    /**
+     * Get my favorites
+     *
+     * Retrieves the authenticated user's favorites.
+     * Requires authentication.
+     *
+     * @param params - Query parameters for filtering and pagination
+     * @param options - Optional request options
+     * @returns Promise resolving to list of favorites
+     */
+    getMyFavorites(params?: FavoriteQuery, options?: globalThis.RequestInit): Promise<FavoriteListResponse>;
+    /**
+     * Get user's favorites
+     *
+     * Retrieves a user's favorites.
+     * This is a public endpoint - no authentication required.
+     *
+     * @param userId - The ID of the user whose favorites to retrieve
+     * @param params - Query parameters for filtering and pagination
+     * @param options - Optional request options
+     * @returns Promise resolving to list of favorites
+     */
+    getUserFavorites(userId: number, params?: FavoriteQuery, options?: globalThis.RequestInit): Promise<FavoriteListResponse>;
+    /**
+     * Get user's favorite agents with details
+     *
+     * Retrieves a user's favorite agents with full details.
+     * This is a public endpoint - no authentication required.
+     *
+     * @param userId - The ID of the user whose favorite agents to retrieve
+     * @param params - Pagination parameters
+     * @param options - Optional request options
+     * @returns Promise resolving to list of favorite agents
+     */
+    getUserFavoriteAgents(userId: number, params?: Pick<FavoriteQuery, 'limit' | 'offset'>, options?: globalThis.RequestInit): Promise<FavoriteListResponse>;
+    /**
+     * Get user's favorite plugins with details
+     *
+     * Retrieves a user's favorite plugins with full details.
+     * This is a public endpoint - no authentication required.
+     *
+     * @param userId - The ID of the user whose favorite plugins to retrieve
+     * @param params - Pagination parameters
+     * @param options - Optional request options
+     * @returns Promise resolving to list of favorite plugins
+     */
+    getUserFavoritePlugins(userId: number, params?: Pick<FavoriteQuery, 'limit' | 'offset'>, options?: globalThis.RequestInit): Promise<FavoriteListResponse>;
+}
+
+/**
+ * User Like Service
+ *
+ * Provides access to user like functionality in the LobeHub Marketplace.
+ * This service handles liking/unliking content and retrieving like lists.
+ */
+declare class UserLikeService extends BaseSDK {
+    /**
+     * Like content
+     *
+     * Likes an agent or plugin for the authenticated user.
+     * Requires authentication.
+     *
+     * @param targetType - The type of target ('agent' or 'plugin')
+     * @param targetId - The ID of the target agent/plugin
+     * @param options - Optional request options
+     * @returns Promise resolving to success response
+     * @throws Error if already liked
+     */
+    like(targetType: InteractionTargetType, targetId: number, options?: globalThis.RequestInit): Promise<SuccessResponse>;
+    /**
+     * Unlike content
+     *
+     * Unlikes an agent or plugin for the authenticated user.
+     * Requires authentication.
+     *
+     * @param targetType - The type of target ('agent' or 'plugin')
+     * @param targetId - The ID of the target agent/plugin
+     * @param options - Optional request options
+     * @returns Promise resolving to success response
+     * @throws Error if like not found
+     */
+    unlike(targetType: InteractionTargetType, targetId: number, options?: globalThis.RequestInit): Promise<SuccessResponse>;
+    /**
+     * Toggle like status
+     *
+     * Toggles the like status - likes if not liked, unlikes if already liked.
+     * Requires authentication.
+     *
+     * @param targetType - The type of target ('agent' or 'plugin')
+     * @param targetId - The ID of the target agent/plugin
+     * @param options - Optional request options
+     * @returns Promise resolving to toggle response with new like status
+     */
+    toggleLike(targetType: InteractionTargetType, targetId: number, options?: globalThis.RequestInit): Promise<ToggleLikeResponse>;
+    /**
+     * Check like status
+     *
+     * Checks if the authenticated user has liked a specific agent or plugin.
+     * Requires authentication.
+     *
+     * @param targetType - The type of target ('agent' or 'plugin')
+     * @param targetId - The ID of the target agent/plugin
+     * @param options - Optional request options
+     * @returns Promise resolving to like status
+     */
+    checkLike(targetType: InteractionTargetType, targetId: number, options?: globalThis.RequestInit): Promise<CheckLikeResponse>;
+    /**
+     * Get my likes
+     *
+     * Retrieves the authenticated user's likes.
+     * Requires authentication.
+     *
+     * @param params - Query parameters for filtering and pagination
+     * @param options - Optional request options
+     * @returns Promise resolving to list of likes
+     */
+    getMyLikes(params?: LikeQuery, options?: globalThis.RequestInit): Promise<LikeListResponse>;
+    /**
+     * Get user's likes
+     *
+     * Retrieves a user's likes.
+     * This is a public endpoint - no authentication required.
+     *
+     * @param userId - The ID of the user whose likes to retrieve
+     * @param params - Query parameters for filtering and pagination
+     * @param options - Optional request options
+     * @returns Promise resolving to list of likes
+     */
+    getUserLikes(userId: number, params?: LikeQuery, options?: globalThis.RequestInit): Promise<LikeListResponse>;
+    /**
+     * Get user's liked agents with details
+     *
+     * Retrieves a user's liked agents with full details.
+     * This is a public endpoint - no authentication required.
+     *
+     * @param userId - The ID of the user whose liked agents to retrieve
+     * @param params - Pagination parameters
+     * @param options - Optional request options
+     * @returns Promise resolving to list of liked agents
+     */
+    getUserLikedAgents(userId: number, params?: Pick<LikeQuery, 'limit' | 'offset'>, options?: globalThis.RequestInit): Promise<LikeListResponse>;
+    /**
+     * Get user's liked plugins with details
+     *
+     * Retrieves a user's liked plugins with full details.
+     * This is a public endpoint - no authentication required.
+     *
+     * @param userId - The ID of the user whose liked plugins to retrieve
+     * @param params - Pagination parameters
+     * @param options - Optional request options
+     * @returns Promise resolving to list of liked plugins
+     */
+    getUserLikedPlugins(userId: number, params?: Pick<LikeQuery, 'limit' | 'offset'>, options?: globalThis.RequestInit): Promise<LikeListResponse>;
+}
+
 /**
  * LobeHub Market SDK Client
  *
@@ -2974,6 +3436,21 @@ declare class MarketSDK extends BaseSDK {
      * Provides methods to retrieve user profiles and their published agents
      */
     readonly user: UserService;
+    /**
+     * User follow service for follow operations
+     * Provides methods to follow/unfollow users and retrieve follow relationships
+     */
+    readonly follows: UserFollowService;
+    /**
+     * User favorite service for favorite operations
+     * Provides methods to add/remove favorites and retrieve favorite lists
+     */
+    readonly favorites: UserFavoriteService;
+    /**
+     * User like service for like operations
+     * Provides methods to like/unlike content and retrieve like lists
+     */
+    readonly likes: UserLikeService;
     /**
      * Discovery service for retrieving API service information
      * Used to get information about available endpoints and services
@@ -3009,4 +3486,4 @@ declare class MarketSDK extends BaseSDK {
     registerClient(request: ClientRegistrationRequest): Promise<ClientRegistrationResponse>;
 }
 
-export { type AccountMeta, type AdminListQueryParams, type AdminListResponse, type AdminPluginParams, type AgentCreateRequest, type AgentCreateResponse, type AgentDetailQuery, type AgentExtension, type AgentInstallCountRequest, type AgentInstallCountResponse, type AgentInterface, type AgentItemDetail, type AgentListQuery, type AgentListResponse, type AgentModifyRequest, type AgentModifyResponse, type AgentSecurityRequirement, type AgentSecurityScheme, type AgentSkill, type AgentStatus, type AgentStatusChangeResponse, type AgentUploadRequest, type AgentUploadResponse, type AgentUploadVersion, type AgentVersionCreateRequest, type AgentVersionCreateResponse, type AgentVersionLocalization, type AgentVersionModifyRequest, type AgentVersionModifyResponse, type AuthorizationCodeTokenRequest, type ClientRegistrationError, type ClientRegistrationRequest, type ClientRegistrationResponse, type CodeInterpreterToolName, type CodeInterpreterToolParams, type DiscoveryDocument, type EditLocalFileParams, type ExecuteCodeParams, type ExportFileParams, type GetCommandOutputParams, type GlobLocalFilesParams, type GrepContentParams, type KillCommandParams, type ListLocalFilesParams, MarketAdmin, MarketSDK, type MarketSDKOptions, type MoveLocalFilesParams, type MoveOperation, type OAuthTokenResponse, type OwnAgentListQuery, type PluginI18nImportParams, type PluginI18nImportResponse, type PluginItem, type PluginListResponse, type PluginLocalization, type PluginQueryParams, type PluginUpdateParams, type PluginVersionCreateParams, type PluginVersionUpdateParams, type ProgrammingLanguage, type ReadLocalFileParams, type RefreshTokenRequest, type RenameLocalFileParams, type ReviewStatus, ReviewStatusEnumSchema, type RunBuildInToolsError, type RunBuildInToolsRequest, type RunBuildInToolsResponse, type RunBuildInToolsSuccessData, type RunCommandParams, type SearchLocalFilesParams, type SharedTokenState, StatusEnumSchema, type UnclaimedPluginItem, type UpdateUserInfoRequest, type UpdateUserInfoResponse, type UserAgentItem, type UserInfoQuery, type UserInfoResponse, type UserProfile, VisibilityEnumSchema, type WriteLocalFileParams };
+export { type AccountMeta, type AdminListQueryParams, type AdminListResponse, type AdminPluginParams, type AgentCreateRequest, type AgentCreateResponse, type AgentDetailQuery, type AgentExtension, type AgentInstallCountRequest, type AgentInstallCountResponse, type AgentInterface, type AgentItemDetail, type AgentListQuery, type AgentListResponse, type AgentModifyRequest, type AgentModifyResponse, type AgentSecurityRequirement, type AgentSecurityScheme, type AgentSkill, type AgentStatus, type AgentStatusChangeResponse, type AgentUploadRequest, type AgentUploadResponse, type AgentUploadVersion, type AgentVersionCreateRequest, type AgentVersionCreateResponse, type AgentVersionLocalization, type AgentVersionModifyRequest, type AgentVersionModifyResponse, type AuthorizationCodeTokenRequest, type CheckFavoriteQuery, type CheckFavoriteResponse, type CheckFollowQuery, type CheckFollowResponse, type CheckLikeQuery, type CheckLikeResponse, type ClientRegistrationError, type ClientRegistrationRequest, type ClientRegistrationResponse, type CodeInterpreterToolName, type CodeInterpreterToolParams, type DiscoveryDocument, type EditLocalFileParams, type ExecuteCodeParams, type ExportFileParams, type FavoriteListResponse, type FavoriteQuery, type FavoriteRequest, type FollowListItem, type FollowListResponse, type FollowRequest, type GetCommandOutputParams, type GlobLocalFilesParams, type GrepContentParams, type InteractionTargetType, type KillCommandParams, type LikeListResponse, type LikeQuery, type LikeRequest, type ListLocalFilesParams, MarketAdmin, MarketSDK, type MarketSDKOptions, type MoveLocalFilesParams, type MoveOperation, type OAuthTokenResponse, type OwnAgentListQuery, type PaginationQuery, type PluginI18nImportParams, type PluginI18nImportResponse, type PluginItem, type PluginListResponse, type PluginLocalization, type PluginQueryParams, type PluginUpdateParams, type PluginVersionCreateParams, type PluginVersionUpdateParams, type ProgrammingLanguage, type ReadLocalFileParams, type RefreshTokenRequest, type RenameLocalFileParams, type ReviewStatus, ReviewStatusEnumSchema, type RunBuildInToolsError, type RunBuildInToolsRequest, type RunBuildInToolsResponse, type RunBuildInToolsSuccessData, type RunCommandParams, type SearchLocalFilesParams, type SharedTokenState, StatusEnumSchema, type SuccessResponse, type ToggleLikeResponse, type UnclaimedPluginItem, type UpdateUserInfoRequest, type UpdateUserInfoResponse, type UserAgentItem, type UserInfoQuery, type UserInfoResponse, type UserProfile, VisibilityEnumSchema, type WriteLocalFileParams };