@lobehub/market-sdk 0.31.7 → 0.31.8

package/dist/index.d.mts

@@ -1966,6 +1966,114 @@ interface CodeInterpreterToolParams {
     searchLocalFiles: SearchLocalFilesParams;
     writeLocalFile: WriteLocalFileParams;
 }
+/**
+ * Author information for a plugin comment
+ */
+interface PluginCommentAuthor {
+    avatar?: string;
+    background?: string | null;
+    displayName?: string | null;
+    id?: number;
+    identifier?: string;
+    sourceType?: string | null;
+    tags?: string[];
+    type: 'agent' | 'user';
+}
+/**
+ * A single plugin comment item
+ */
+interface PluginCommentItem {
+    author: PluginCommentAuthor | null;
+    content: string;
+    createdAt: string;
+    downvotes: number;
+    id: number;
+    parentId: number | null;
+    rating?: number;
+    replyCount: number;
+    updatedAt: string;
+    upvotes: number;
+}
+/**
+ * Created plugin comment entity
+ */
+interface PluginCommentCreateItem {
+    agentId: number | null;
+    content: string;
+    createdAt: string;
+    downvotes: number;
+    id: number;
+    parentId: number | null;
+    pluginId: number;
+    updatedAt: string;
+    upvotes: number;
+    userId: number | null;
+}
+/**
+ * Rating payload returned when creating a comment with a score
+ */
+interface PluginCommentRating {
+    score: number;
+}
+/**
+ * Response returned by the create comment endpoint
+ */
+interface PluginCommentCreateResponse extends PluginCommentCreateItem {
+    rating?: PluginCommentRating;
+}
+/**
+ * Latest comment for the authenticated user/agent on a plugin
+ */
+interface PluginLatestOwnComment {
+    createdAt: string;
+    id: number;
+    parentId: number | null;
+    replyCount: number;
+}
+/**
+ * Response returned by the delete comment endpoint
+ */
+interface PluginCommentDeleteResponse {
+    success: boolean;
+}
+/**
+ * Query parameters for listing plugin comments
+ */
+interface PluginCommentListQuery {
+    order?: 'asc' | 'desc';
+    page?: number;
+    pageSize?: number;
+    sort?: 'createdAt' | 'upvotes';
+}
+/**
+ * Paginated response for plugin comments
+ */
+interface PluginCommentListResponse {
+    currentPage: number;
+    items: PluginCommentItem[];
+    pageSize: number;
+    totalCount: number;
+    totalPages: number;
+}
+/**
+ * Rating distribution counts by score (1-5)
+ */
+interface PluginRatingDistribution {
+    1: number;
+    2: number;
+    3: number;
+    4: number;
+    5: number;
+    totalCount: number;
+}
+/**
+ * Reaction response type
+ */
+interface PluginCommentReactionResponse {
+    commentId: number;
+    id: number;
+    type: string;
+}
 
 /**
  * Connect Types for LobeHub Market SDK
@@ -5932,6 +6040,93 @@ declare class PluginsService extends BaseSDK {
         topicId: string;
         userId: string;
     }): Promise<RunBuildInToolsResponse>;
+    /**
+     * Submits or updates a rating for a plugin
+     *
+     * @param identifier - Unique plugin identifier
+     * @param score - Rating score (1-5)
+     * @param options - Optional request options
+     * @returns Promise resolving to the submitted score
+     */
+    submitRating(identifier: string, score: number, options?: globalThis.RequestInit): Promise<{
+        score: number;
+    }>;
+    /**
+     * Deletes the current user/agent's rating for a plugin
+     *
+     * @param identifier - Unique plugin identifier
+     * @param options - Optional request options
+     * @returns Promise resolving to success status
+     */
+    deleteRating(identifier: string, options?: globalThis.RequestInit): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Gets the rating distribution for a plugin
+     *
+     * @param identifier - Unique plugin identifier
+     * @param options - Optional request options
+     * @returns Promise resolving to the rating distribution
+     */
+    getRatingDistribution(identifier: string, options?: globalThis.RequestInit): Promise<PluginRatingDistribution>;
+    /**
+     * Gets paginated comments for a plugin
+     *
+     * @param identifier - Unique plugin identifier
+     * @param params - Query parameters for pagination and sorting
+     * @param options - Optional request options
+     * @returns Promise resolving to the paginated comment list
+     */
+    getComments(identifier: string, params?: PluginCommentListQuery, options?: globalThis.RequestInit): Promise<PluginCommentListResponse>;
+    /**
+     * Gets the latest comment for the authenticated user or agent on a plugin
+     *
+     * @param identifier - Unique plugin identifier
+     * @param options - Optional request options
+     * @returns Promise resolving to the latest own comment or null when none exists
+     */
+    getLatestOwnComment(identifier: string, options?: globalThis.RequestInit): Promise<PluginLatestOwnComment | null>;
+    /**
+     * Creates a comment on a plugin, optionally with a rating
+     *
+     * @param identifier - Unique plugin identifier
+     * @param data - Comment data with content, optional score, and optional parentId
+     * @param options - Optional request options
+     * @returns Promise resolving to the created comment (with optional rating field)
+     */
+    createComment(identifier: string, data: {
+        content: string;
+        parentId?: number;
+        score?: number;
+    }, options?: globalThis.RequestInit): Promise<PluginCommentCreateResponse>;
+    /**
+     * Deletes a comment from a plugin
+     *
+     * @param identifier - Unique plugin identifier
+     * @param commentId - Comment ID to delete
+     * @param options - Optional request options
+     * @returns Promise resolving to success status
+     */
+    deleteComment(identifier: string, commentId: number, options?: globalThis.RequestInit): Promise<PluginCommentDeleteResponse>;
+    /**
+     * Adds or updates a reaction on a comment
+     *
+     * @param commentId - Comment ID to react to
+     * @param type - Reaction type ('upvote' or 'downvote')
+     * @param options - Optional request options
+     * @returns Promise resolving to the created reaction
+     */
+    addReaction(commentId: number, type: 'downvote' | 'upvote', options?: globalThis.RequestInit): Promise<PluginCommentReactionResponse>;
+    /**
+     * Removes a reaction from a comment
+     *
+     * @param commentId - Comment ID to remove reaction from
+     * @param options - Optional request options
+     * @returns Promise resolving to success status
+     */
+    removeReaction(commentId: number, options?: globalThis.RequestInit): Promise<{
+        success: boolean;
+    }>;
 }
 
 /**
@@ -6884,4 +7079,4 @@ declare function buildTrustedClientPayload(params: {
     userId: string;
 }): TrustedClientPayload;
 
-export { type AccountMeta, type AdminListQueryParams, type AdminListResponse, type AdminPluginParams, type AgentCreateRequest, type AgentCreateResponse, type AgentDetailQuery, type AgentExtension, type AgentForkItem, type AgentForkRequest, type AgentForkResponse, type AgentForkSourceResponse, type AgentForksResponse, type AgentGroupCreateRequest, type AgentGroupCreateResponse, type AgentGroupDetail, type AgentGroupDetailQuery, type AgentGroupForkItem, type AgentGroupForkRequest, type AgentGroupForkResponse, type AgentGroupForkSourceResponse, type AgentGroupForksResponse, type AgentGroupItem, type AgentGroupListQuery, type AgentGroupListResponse, type AgentGroupModifyRequest, type AgentGroupModifyResponse, type AgentGroupStatus, type AgentGroupStatusChangeResponse, type AgentGroupVersionCreateRequest, type AgentGroupVersionCreateResponse, type AgentInstallCountRequest, type AgentInstallCountResponse, type AgentInterface, type AgentItemDetail, type AgentListQuery, type AgentListResponse, type AgentModifyRequest, type AgentModifyResponse, type AgentProfileEntity, type AgentProfileResponse, 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 AuthorizeParams, type AuthorizeResponse, type CallSkillToolResponse, type CheckFavoriteQuery, type CheckFavoriteResponse, type CheckFollowQuery, type CheckFollowResponse, type CheckLikeQuery, type CheckLikeResponse, type ClientRegistrationError, type ClientRegistrationRequest, type ClientRegistrationResponse, type CodeInterpreterToolName, type CodeInterpreterToolParams, type ConnectProvider, type ConnectProviderDetail, type ConnectProviderScopes, type ConnectionHealth, type ConnectionStats, type CreateMemberAgent, type DiscoveryDocument, type EditLocalFileParams, type ExecuteCodeParams, type ExportFileParams, type FavoriteListResponse, type FavoriteQuery, type FavoriteRequest, type FeedbackClientInfo, type FollowListItem, type FollowListResponse, type FollowRequest, type GetAllConnectionsHealthResponse, type GetAuthorizeUrlParams, type GetCommandOutputParams, type GetConnectProviderResponse, type GetConnectionHealthResponse, type GetConnectionStatsResponse, type GetConnectionStatusResponse, type GetSkillStatusResponse, type GetSkillToolResponse, type GlobLocalFilesParams, type GrepContentParams, type InteractionTargetType, type KillCommandParams, type LikeListResponse, type LikeQuery, type LikeRequest, type ListConnectProvidersResponse, type ListConnectionsResponse, type ListLocalFilesParams, type ListSkillProvidersResponse, type ListSkillToolsResponse, MarketAPIError, MarketAdmin, type MarketReportGitHubSkillParams, type MarketReportGitHubSkillResponse, type MarketReportSkillInstallParams, type MarketReportSkillInstallResponse, MarketSDK, type MarketSDKOptions, type MarketSkillAuthor, type MarketSkillCategory, type MarketSkillCategoryQuery, type MarketSkillDetail, type MarketSkillDetailQuery, type MarketSkillGitHubMeta, type MarketSkillListItem, type MarketSkillListQuery, type MarketSkillListResponse, type MarketSkillManifest, type MarketSkillResource, type MarketSkillVersionSummary, type MarketSkillVersionsResponse, type MemberAgent, type MoveLocalFilesParams, type MoveOperation, type OAuthConnection, type OAuthTokenResponse, type OwnAgentGroupListQuery, 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 RefreshConnectionResponse, type RefreshTokenRequest, type RegisterUserRequest, type RegisterUserResponse, type RegisteredUserProfile, type RenameLocalFileParams, type ReviewStatus, ReviewStatusEnumSchema, type RevokeConnectionResponse, type RunBuildInToolsError, type RunBuildInToolsRequest, type RunBuildInToolsResponse, type RunBuildInToolsSuccessData, type RunCommandParams, SDK_USER_AGENT, SDK_VERSION, type SearchLocalFilesParams, type SharedTokenState, type SkillCallParams, type SkillCommentAuthor, type SkillCommentCreateItem, type SkillCommentCreateResponse, type SkillCommentDeleteResponse, type SkillCommentItem, type SkillCommentListItem, type SkillCommentListQuery, type SkillCommentListResponse, type SkillCommentRating, type SkillErrorResponse, type SkillLatestOwnComment, type SkillProviderInfo, type SkillProviderStatus, type SkillRatingDistribution, type SkillTool, StatusEnumSchema, type SubmitFeedbackRequest, type SubmitFeedbackResponse, type SuccessResponse, type ToggleLikeResponse, type TrustedClientPayload, type UnclaimedPluginItem, type UpdateAgentProfileRequest, type UpdateAgentProfileResponse, type UpdateMemberAgent, type UpdateUserInfoRequest, type UpdateUserInfoResponse, type UserAgentGroupItem, type UserAgentItem, type UserInfoQuery, type UserInfoResponse, type UserProfile, VisibilityEnumSchema, type WriteLocalFileParams, buildTrustedClientPayload, createTrustedClientToken, generateNonce };
+export { type AccountMeta, type AdminListQueryParams, type AdminListResponse, type AdminPluginParams, type AgentCreateRequest, type AgentCreateResponse, type AgentDetailQuery, type AgentExtension, type AgentForkItem, type AgentForkRequest, type AgentForkResponse, type AgentForkSourceResponse, type AgentForksResponse, type AgentGroupCreateRequest, type AgentGroupCreateResponse, type AgentGroupDetail, type AgentGroupDetailQuery, type AgentGroupForkItem, type AgentGroupForkRequest, type AgentGroupForkResponse, type AgentGroupForkSourceResponse, type AgentGroupForksResponse, type AgentGroupItem, type AgentGroupListQuery, type AgentGroupListResponse, type AgentGroupModifyRequest, type AgentGroupModifyResponse, type AgentGroupStatus, type AgentGroupStatusChangeResponse, type AgentGroupVersionCreateRequest, type AgentGroupVersionCreateResponse, type AgentInstallCountRequest, type AgentInstallCountResponse, type AgentInterface, type AgentItemDetail, type AgentListQuery, type AgentListResponse, type AgentModifyRequest, type AgentModifyResponse, type AgentProfileEntity, type AgentProfileResponse, 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 AuthorizeParams, type AuthorizeResponse, type CallSkillToolResponse, type CheckFavoriteQuery, type CheckFavoriteResponse, type CheckFollowQuery, type CheckFollowResponse, type CheckLikeQuery, type CheckLikeResponse, type ClientRegistrationError, type ClientRegistrationRequest, type ClientRegistrationResponse, type CodeInterpreterToolName, type CodeInterpreterToolParams, type ConnectProvider, type ConnectProviderDetail, type ConnectProviderScopes, type ConnectionHealth, type ConnectionStats, type CreateMemberAgent, type DiscoveryDocument, type EditLocalFileParams, type ExecuteCodeParams, type ExportFileParams, type FavoriteListResponse, type FavoriteQuery, type FavoriteRequest, type FeedbackClientInfo, type FollowListItem, type FollowListResponse, type FollowRequest, type GetAllConnectionsHealthResponse, type GetAuthorizeUrlParams, type GetCommandOutputParams, type GetConnectProviderResponse, type GetConnectionHealthResponse, type GetConnectionStatsResponse, type GetConnectionStatusResponse, type GetSkillStatusResponse, type GetSkillToolResponse, type GlobLocalFilesParams, type GrepContentParams, type InteractionTargetType, type KillCommandParams, type LikeListResponse, type LikeQuery, type LikeRequest, type ListConnectProvidersResponse, type ListConnectionsResponse, type ListLocalFilesParams, type ListSkillProvidersResponse, type ListSkillToolsResponse, MarketAPIError, MarketAdmin, type MarketReportGitHubSkillParams, type MarketReportGitHubSkillResponse, type MarketReportSkillInstallParams, type MarketReportSkillInstallResponse, MarketSDK, type MarketSDKOptions, type MarketSkillAuthor, type MarketSkillCategory, type MarketSkillCategoryQuery, type MarketSkillDetail, type MarketSkillDetailQuery, type MarketSkillGitHubMeta, type MarketSkillListItem, type MarketSkillListQuery, type MarketSkillListResponse, type MarketSkillManifest, type MarketSkillResource, type MarketSkillVersionSummary, type MarketSkillVersionsResponse, type MemberAgent, type MoveLocalFilesParams, type MoveOperation, type OAuthConnection, type OAuthTokenResponse, type OwnAgentGroupListQuery, type OwnAgentListQuery, type PaginationQuery, type PluginCommentAuthor, type PluginCommentCreateItem, type PluginCommentCreateResponse, type PluginCommentDeleteResponse, type PluginCommentItem, type PluginCommentListQuery, type PluginCommentListResponse, type PluginCommentRating, type PluginCommentReactionResponse, type PluginI18nImportParams, type PluginI18nImportResponse, type PluginItem, type PluginLatestOwnComment, type PluginListResponse, type PluginLocalization, type PluginQueryParams, type PluginRatingDistribution, type PluginUpdateParams, type PluginVersionCreateParams, type PluginVersionUpdateParams, type ProgrammingLanguage, type ReadLocalFileParams, type RefreshConnectionResponse, type RefreshTokenRequest, type RegisterUserRequest, type RegisterUserResponse, type RegisteredUserProfile, type RenameLocalFileParams, type ReviewStatus, ReviewStatusEnumSchema, type RevokeConnectionResponse, type RunBuildInToolsError, type RunBuildInToolsRequest, type RunBuildInToolsResponse, type RunBuildInToolsSuccessData, type RunCommandParams, SDK_USER_AGENT, SDK_VERSION, type SearchLocalFilesParams, type SharedTokenState, type SkillCallParams, type SkillCommentAuthor, type SkillCommentCreateItem, type SkillCommentCreateResponse, type SkillCommentDeleteResponse, type SkillCommentItem, type SkillCommentListItem, type SkillCommentListQuery, type SkillCommentListResponse, type SkillCommentRating, type SkillErrorResponse, type SkillLatestOwnComment, type SkillProviderInfo, type SkillProviderStatus, type SkillRatingDistribution, type SkillTool, StatusEnumSchema, type SubmitFeedbackRequest, type SubmitFeedbackResponse, type SuccessResponse, type ToggleLikeResponse, type TrustedClientPayload, type UnclaimedPluginItem, type UpdateAgentProfileRequest, type UpdateAgentProfileResponse, type UpdateMemberAgent, type UpdateUserInfoRequest, type UpdateUserInfoResponse, type UserAgentGroupItem, type UserAgentItem, type UserInfoQuery, type UserInfoResponse, type UserProfile, VisibilityEnumSchema, type WriteLocalFileParams, buildTrustedClientPayload, createTrustedClientToken, generateNonce };

package/dist/index.mjs

@@ -3414,6 +3414,196 @@ var PluginsService = class extends BaseSDK {
   async exportFile(path, uploadUrl, context) {
     return this.runBuildInTool("exportFile", { path, uploadUrl }, context);
   }
+  // ============================================================================
+  // Rating Methods
+  // ============================================================================
+  /**
+   * Submits or updates a rating for a plugin
+   *
+   * @param identifier - Unique plugin identifier
+   * @param score - Rating score (1-5)
+   * @param options - Optional request options
+   * @returns Promise resolving to the submitted score
+   */
+  async submitRating(identifier, score, options) {
+    log17("Submitting rating for plugin %s: %d", identifier, score);
+    const result = await this.request(
+      `/v1/plugins/${encodeURIComponent(identifier)}/ratings`,
+      {
+        ...options,
+        body: JSON.stringify({ score }),
+        method: "POST"
+      }
+    );
+    log17("Rating submitted for plugin %s: %d", identifier, result.score);
+    return result;
+  }
+  /**
+   * Deletes the current user/agent's rating for a plugin
+   *
+   * @param identifier - Unique plugin identifier
+   * @param options - Optional request options
+   * @returns Promise resolving to success status
+   */
+  async deleteRating(identifier, options) {
+    log17("Deleting rating for plugin %s", identifier);
+    const result = await this.request(
+      `/v1/plugins/${encodeURIComponent(identifier)}/ratings`,
+      {
+        ...options,
+        method: "DELETE"
+      }
+    );
+    log17("Rating deleted for plugin %s", identifier);
+    return result;
+  }
+  /**
+   * Gets the rating distribution for a plugin
+   *
+   * @param identifier - Unique plugin identifier
+   * @param options - Optional request options
+   * @returns Promise resolving to the rating distribution
+   */
+  async getRatingDistribution(identifier, options) {
+    log17("Getting rating distribution for plugin: %s", identifier);
+    const result = await this.request(
+      `/v1/plugins/${encodeURIComponent(identifier)}/ratings/distribution`,
+      options
+    );
+    log17("Rating distribution retrieved for plugin %s: %d total", identifier, result.totalCount);
+    return result;
+  }
+  // ============================================================================
+  // Comment Methods
+  // ============================================================================
+  /**
+   * Gets paginated comments for a plugin
+   *
+   * @param identifier - Unique plugin identifier
+   * @param params - Query parameters for pagination and sorting
+   * @param options - Optional request options
+   * @returns Promise resolving to the paginated comment list
+   */
+  async getComments(identifier, params = {}, options) {
+    const queryString = this.buildQueryString(params);
+    log17("Getting comments for plugin %s: %O", identifier, params);
+    const result = await this.request(
+      `/v1/plugins/${encodeURIComponent(identifier)}/comments${queryString}`,
+      options
+    );
+    log17(
+      "Retrieved %d comments for plugin %s (page %d/%d)",
+      result.items.length,
+      identifier,
+      result.currentPage,
+      result.totalPages
+    );
+    return result;
+  }
+  /**
+   * Gets the latest comment for the authenticated user or agent on a plugin
+   *
+   * @param identifier - Unique plugin identifier
+   * @param options - Optional request options
+   * @returns Promise resolving to the latest own comment or null when none exists
+   */
+  async getLatestOwnComment(identifier, options) {
+    log17("Getting latest own comment for plugin %s", identifier);
+    const result = await this.request(
+      `/v1/plugins/${encodeURIComponent(identifier)}/comments/latest`,
+      options
+    );
+    if (result) {
+      log17("Retrieved latest own comment for plugin %s: id=%d", identifier, result.id);
+    } else {
+      log17("No own comments found for plugin %s", identifier);
+    }
+    return result;
+  }
+  /**
+   * Creates a comment on a plugin, optionally with a rating
+   *
+   * @param identifier - Unique plugin identifier
+   * @param data - Comment data with content, optional score, and optional parentId
+   * @param options - Optional request options
+   * @returns Promise resolving to the created comment (with optional rating field)
+   */
+  async createComment(identifier, data, options) {
+    log17("Creating comment on plugin %s", identifier);
+    const result = await this.request(
+      `/v1/plugins/${encodeURIComponent(identifier)}/comments`,
+      {
+        ...options,
+        body: JSON.stringify(data),
+        method: "POST"
+      }
+    );
+    log17("Comment created on plugin %s: id=%d", identifier, result.id);
+    return result;
+  }
+  /**
+   * Deletes a comment from a plugin
+   *
+   * @param identifier - Unique plugin identifier
+   * @param commentId - Comment ID to delete
+   * @param options - Optional request options
+   * @returns Promise resolving to success status
+   */
+  async deleteComment(identifier, commentId, options) {
+    log17("Deleting comment %d from plugin %s", commentId, identifier);
+    const result = await this.request(
+      `/v1/plugins/${encodeURIComponent(identifier)}/comments/${commentId}`,
+      {
+        ...options,
+        method: "DELETE"
+      }
+    );
+    log17("Comment %d deleted from plugin %s", commentId, identifier);
+    return result;
+  }
+  // ============================================================================
+  // Reaction Methods
+  // ============================================================================
+  /**
+   * Adds or updates a reaction on a comment
+   *
+   * @param commentId - Comment ID to react to
+   * @param type - Reaction type ('upvote' or 'downvote')
+   * @param options - Optional request options
+   * @returns Promise resolving to the created reaction
+   */
+  async addReaction(commentId, type, options) {
+    log17("Adding %s reaction to comment %d", type, commentId);
+    const result = await this.request(
+      `/v1/plugins/comments/${commentId}/reactions`,
+      {
+        ...options,
+        body: JSON.stringify({ type }),
+        method: "POST"
+      }
+    );
+    log17("Reaction added to comment %d: %s (id=%d)", commentId, result.type, result.id);
+    return result;
+  }
+  /**
+   * Removes a reaction from a comment
+   *
+   * @param commentId - Comment ID to remove reaction from
+   * @param options - Optional request options
+   * @returns Promise resolving to success status
+   */
+  async removeReaction(commentId, options) {
+    log17("Removing reaction from comment %d", commentId);
+    const result = await this.request(
+      `/v1/plugins/comments/${commentId}/reactions`,
+      {
+        ...options,
+        method: "DELETE"
+      }
+    );
+    log17("Reaction removed from comment %d", commentId);
+    return result;
+  }
 };
 
 // src/market/services/SkillService.ts