@lobehub/market-sdk 0.0.27 → 0.0.29

package/dist/index.mjs

@@ -1,14 +1,15 @@
-// src/market/market-sdk.ts
-import debug4 from "debug";
+// src/admin/MarketAdmin.ts
+import debug6 from "debug";
 
 // src/core/BaseSDK.ts
 import debug from "debug";
 var log = debug("lobe-market-sdk:core");
 var BaseSDK = class {
   /**
-   * 创建基础 SDK 实例
-   * @param options SDK 配置选项
-   * @param sharedHeaders 共享的 headers 对象（可选）
+   * Creates a new BaseSDK instance
+   *
+   * @param options - Configuration options for the SDK
+   * @param sharedHeaders - Optional shared headers object for reuse across services
    */
   constructor(options = {}, sharedHeaders) {
     this.baseUrl = options.baseURL || process.env.MARKET_BASE_URL || "https://market.lobehub.com/api";
@@ -30,11 +31,14 @@ var BaseSDK = class {
     });
   }
   /**
-   * 发送请求并处理响应
-   * @param url 请求 URL
-   * @param options fetch 选项
-   * @returns 响应数据
+   * Sends an HTTP request to the API and handles the response
+   *
+   * @param url - Request URL path (will be appended to baseUrl)
+   * @param options - Fetch API request options
+   * @returns Promise resolving to the parsed JSON response
+   * @throws Error if the request fails
    */
+  // eslint-disable-next-line no-undef
   async request(url, options = {}) {
     log("Sending request: %s", `${this.baseUrl}${url}`);
     const response = await fetch(`${this.baseUrl}${url}`, {
@@ -53,24 +57,26 @@ var BaseSDK = class {
     return response.json();
   }
   /**
-   * 构建查询字符串
-   * @param params 查询参数
-   * @returns 查询字符串
+   * Builds a URL query string from a parameters object
+   *
+   * @param params - Object containing query parameters
+   * @returns Formatted query string (including leading ? if params exist)
    */
   buildQueryString(params) {
     const query = Object.entries(params).filter(([_, value]) => value !== void 0 && value !== null).map(([key, value]) => `${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`).join("&");
     return query ? `?${query}` : "";
   }
   /**
-   * 设置认证令牌
-   * @param token 认证令牌
+   * Sets an authentication token for API requests
+   *
+   * @param token - API authentication token
    */
   setAuthToken(token) {
     log("Setting authentication token");
     this.headers.Authorization = `Bearer ${token}`;
   }
   /**
-   * 清除认证令牌
+   * Clears the authentication token
    */
   clearAuthToken() {
     log("Clearing authentication token");
@@ -78,370 +84,285 @@ var BaseSDK = class {
   }
 };
 
-// src/market/services/PluginsService.ts
-import debug2 from "debug";
-var log2 = debug2("lobe-market-sdk:plugins");
-var PluginsService = class extends BaseSDK {
-  /**
-   * 创建插件服务实例
-   * @param options SDK 配置选项
-   * @param sharedHeaders 共享的 headers 对象（可选）
-   */
-  constructor(options = {}, sharedHeaders) {
-    super(options, sharedHeaders);
-    log2("PluginsService instance created");
-  }
-  /**
-   * 获取插件列表
-   * @param params 查询参数
-   * @returns 插件列表响应
-   */
-  async getPluginList(params = {}) {
-    const locale = params.locale || this.defaultLocale;
-    const queryParams = { ...params, locale };
-    const queryString = this.buildQueryString(queryParams);
-    log2("Getting plugin list: %O", queryParams);
-    const result = await this.request(`/v1/plugins${queryString}`);
-    log2("Retrieved %d plugins", result.items.length);
-    return result;
-  }
-  /**
-   * 获取插件清单
-   * @param identifier 插件标识符
-   * @param locale 语言
-   * @param version 版本
-   * @returns 插件清单
-   */
-  async getPluginManifest(identifier, locale, version) {
-    log2("Getting plugin manifest: %O", { identifier, version, locale });
-    const localeParam = locale || this.defaultLocale;
-    const params = { locale: localeParam };
-    if (version) {
-      params.version = version;
-    }
-    const queryString = this.buildQueryString(params);
-    const manifest = await this.request(
-      `/v1/plugins/${identifier}/manifest${queryString}`
-    );
-    log2("Plugin manifest successfully retrieved: %s", identifier);
-    return manifest;
-  }
-};
-
-// src/market/services/DiscoveryService.ts
-import debug3 from "debug";
-var log3 = debug3("lobe-market-sdk:discovery");
-var DiscoveryService = class extends BaseSDK {
-  /**
-   * 创建发现服务实例
-   * @param options SDK 配置选项
-   * @param sharedHeaders 共享的 headers 对象（可选）
-   */
-  constructor(options = {}, sharedHeaders) {
-    super(options, sharedHeaders);
-    log3("DiscoveryService instance created");
-  }
-  /**
-   * 获取市场服务发现文档
-   * @returns 服务发现文档
-   */
-  async getDiscoveryDocument() {
-    log3("Fetching discovery document");
-    if (this.discoveryDoc) {
-      log3("Returning cached discovery document");
-      return this.discoveryDoc;
-    }
-    this.discoveryDoc = await this.request("/market/.well-known/discovery");
-    log3("Discovery document successfully fetched");
-    return this.discoveryDoc;
-  }
-};
-
-// src/market/market-sdk.ts
-var log4 = debug4("lobe-market-sdk");
-var MarketSDK = class extends BaseSDK {
-  /**
-   * Create MarketSDK instance
-   * @param options SDK configuration options
-   */
-  constructor(options = {}) {
-    super(options);
-    log4("MarketSDK instance created");
-    this.plugins = new PluginsService(options, this.headers);
-    this.discovery = new DiscoveryService(options, this.headers);
-  }
-  /**
-   * Get market service discovery document
-   * @returns Service discovery document
-   */
-  async getDiscoveryDocument() {
-    return this.discovery.getDiscoveryDocument();
-  }
-};
-
-// src/admin/MarketAdmin.ts
-import debug9 from "debug";
-
 // src/admin/services/PluginService.ts
-import debug5 from "debug";
-var log5 = debug5("lobe-market-sdk:admin:plugin");
+import debug2 from "debug";
+var log2 = debug2("lobe-market-sdk:admin:plugin");
 var PluginService = class extends BaseSDK {
   /**
-   * 创建插件管理服务实例
-   * @param options SDK 配置选项
-   * @param sharedHeaders 共享的 headers 对象（可选）
+   * Creates a new PluginService instance
+   *
+   * @param options - Configuration options for the SDK
+   * @param sharedHeaders - Optional shared headers object for reuse across services
    */
   constructor(options = {}, sharedHeaders) {
     super(options, sharedHeaders);
-    log5("PluginService instance created");
+    log2("PluginService instance created");
   }
   /**
-   * 导入插件清单（需要管理员权限）
-   * @param manifests 插件清单数组
-   * @param ownerId 所有者 ID
-   * @returns 导入结果
+   * Imports plugin manifests (requires admin privileges)
+   *
+   * Allows batch importing of plugin manifests into the marketplace.
+   *
+   * @param manifests - Array of plugin manifests to import
+   * @param ownerId - Optional owner ID to associate with the imported plugins
+   * @returns Promise resolving to the import results with counts of success and failure
    */
   async importManifests(manifests, ownerId) {
-    log5(`Starting batch import of ${manifests.length} manifests`);
+    log2(`Starting batch import of ${manifests.length} manifests`);
     if (ownerId) {
-      log5(`Using specified owner ID: ${ownerId}`);
+      log2(`Using specified owner ID: ${ownerId}`);
     }
     const response = await this.request(
       "/admin/plugins/import",
       {
-        method: "POST",
         body: JSON.stringify({
           manifests,
           ownerId
-        })
+        }),
+        method: "POST"
       }
     );
-    log5(`Batch import completed: ${response.success} succeeded, ${response.failed} failed`);
+    log2(`Batch import completed: ${response.success} succeeded, ${response.failed} failed`);
     return response;
   }
   /**
-   * 获取插件列表
-   * @param params 查询参数
-   * @returns 插件列表响应
+   * Retrieves a list of plugins with admin details
+   *
+   * Supports filtering, pagination, and sorting of results.
+   *
+   * @param params - Query parameters for filtering and pagination
+   * @returns Promise resolving to the plugin list response with admin details
    */
   async getPlugins(params = {}) {
-    log5("Getting plugins with params: %O", params);
+    log2("Getting plugins with params: %O", params);
     const queryString = this.buildQueryString(params);
     const url = `/admin/plugins${queryString}`;
     const result = await this.request(url);
-    log5("Retrieved %d plugins", result.data.length);
+    log2("Retrieved %d plugins", result.data.length);
     return result;
   }
   /**
-   * 获取单个插件
-   * @param id 插件 ID
-   * @returns 插件详情
+   * Retrieves a single plugin with full admin details
+   *
+   * @param id - Plugin ID or identifier
+   * @returns Promise resolving to the detailed plugin information with version history
    */
   async getPlugin(id) {
-    log5("Getting plugin details (admin): %d", id);
-    const result = await this.request(
-      `/admin/plugins/${id}`
-    );
-    log5("Retrieved plugin with %d versions", result.versions.length);
+    log2("Getting plugin details (admin): %d", id);
+    const result = await this.request(`/admin/plugins/${id}`);
+    log2("Retrieved plugin with %d versions", result.versions.length);
     return result;
   }
   /**
-   * 更新插件信息
-   * @param id 插件 ID
-   * @param data 插件更新数据
-   * @returns 更新后的插件
+   * Updates plugin information
+   *
+   * @param id - Plugin ID
+   * @param data - Plugin update data containing fields to update
+   * @returns Promise resolving to the updated plugin
    */
   async updatePlugin(id, data) {
-    log5("Updating plugin: %d, data: %O", id, data);
+    log2("Updating plugin: %d, data: %O", id, data);
     const result = await this.request(`/admin/plugins/${id}`, {
-      method: "PUT",
-      body: JSON.stringify(data)
+      body: JSON.stringify(data),
+      method: "PUT"
     });
-    log5("Plugin updated successfully");
+    log2("Plugin updated successfully");
     return result;
   }
   /**
-   * 更新插件状态
-   * @param id 插件 ID
-   * @param status 新状态
-   * @returns 成功响应
+   * Updates plugin publication status
+   *
+   * @param id - Plugin ID
+   * @param status - New status to set
+   * @returns Promise resolving to success response
    */
   async updatePluginStatus(id, status) {
-    log5("Updating plugin status: %d to %s", id, status);
+    log2("Updating plugin status: %d to %s", id, status);
     const result = await this.request(
       `/admin/plugins/${id}/status`,
       {
-        method: "PATCH",
-        body: JSON.stringify({ status })
+        body: JSON.stringify({ status }),
+        method: "PATCH"
       }
     );
-    log5("Plugin status updated successfully");
+    log2("Plugin status updated successfully");
     return result;
   }
   /**
-   * 删除插件
-   * @param id 插件 ID
-   * @returns 成功响应
+   * Deletes a plugin
+   *
+   * @param id - Plugin ID
+   * @returns Promise resolving to success response
    */
   async deletePlugin(id) {
-    log5("Deleting plugin: %d", id);
+    log2("Deleting plugin: %d", id);
     const result = await this.request(
       `/admin/plugins/${id}`,
       { method: "DELETE" }
     );
-    log5("Plugin deleted successfully");
+    log2("Plugin deleted successfully");
     return result;
   }
   /**
-   * 获取插件版本列表
-   * @param pluginId 插件 ID
-   * @returns 插件版本列表
+   * Retrieves the version history for a plugin
+   *
+   * @param pluginId - Plugin ID
+   * @returns Promise resolving to an array of plugin versions
    */
   async getPluginVersions(pluginId) {
-    log5("Getting plugin versions: pluginId=%d", pluginId);
+    log2("Getting plugin versions: pluginId=%d", pluginId);
     const result = await this.request(`/admin/plugins/${pluginId}/versions`);
-    log5("Retrieved %d versions", result.length);
+    log2("Retrieved %d versions", result.length);
     return result;
   }
   /**
-   * 获取单个插件版本
-   * @param pluginId 插件 ID
-   * @param versionId 版本 ID
-   * @returns 插件版本
+   * Retrieves a specific plugin version
+   *
+   * @param pluginId - Plugin ID
+   * @param versionId - Version ID
+   * @returns Promise resolving to the plugin version details
    */
   async getPluginVersion(pluginId, versionId) {
-    log5("Getting version details: pluginId=%d, versionId=%d", pluginId, versionId);
+    log2("Getting version details: pluginId=%d, versionId=%d", pluginId, versionId);
     const result = await this.request(
       `/admin/plugins/${pluginId}/versions/${versionId}`
     );
-    log5("Version details retrieved");
+    log2("Version details retrieved");
     return result;
   }
   /**
-   * 创建插件版本
-   * @param pluginId 插件 ID
-   * @param data 版本创建数据
-   * @returns 创建的版本
+   * Creates a new plugin version
+   *
+   * @param pluginId - Plugin ID
+   * @param data - Version creation data including manifest and version string
+   * @returns Promise resolving to the created plugin version
    */
   async createPluginVersion(pluginId, data) {
-    log5("Creating new version: pluginId=%d", pluginId);
+    log2("Creating new version: pluginId=%d", pluginId);
     const result = await this.request(`/admin/plugins/${pluginId}/versions`, {
-      method: "POST",
-      body: JSON.stringify(data)
+      body: JSON.stringify(data),
+      method: "POST"
     });
-    log5("Plugin version created successfully");
+    log2("Plugin version created successfully");
     return result;
   }
   /**
-   * 更新插件版本
-   * @param pluginId 插件 ID
-   * @param versionId 版本 ID
-   * @param data 版本更新数据
-   * @returns 更新后的版本
+   * Updates a plugin version
+   *
+   * @param pluginId - Plugin ID
+   * @param versionId - Version ID
+   * @param data - Version update data
+   * @returns Promise resolving to the updated plugin version
    */
   async updatePluginVersion(pluginId, versionId, data) {
-    log5("Updating version: pluginId=%d, versionId=%d", pluginId, versionId);
+    log2("Updating version: pluginId=%d, versionId=%d", pluginId, versionId);
     const result = await this.request(
       `/admin/plugins/${pluginId}/versions/${versionId}`,
       {
-        method: "PUT",
-        body: JSON.stringify(data)
+        body: JSON.stringify(data),
+        method: "PUT"
       }
     );
-    log5("Plugin version updated successfully");
+    log2("Plugin version updated successfully");
     return result;
   }
   /**
-   * 删除插件版本
-   * @param pluginId 插件 ID
-   * @param versionId 版本 ID
-   * @returns 成功响应
+   * Deletes a plugin version
+   *
+   * @param pluginId - Plugin ID
+   * @param versionId - Version ID
+   * @returns Promise resolving to success response
    */
   async deletePluginVersion(pluginId, versionId) {
-    log5("Deleting version: pluginId=%d, versionId=%d", pluginId, versionId);
+    log2("Deleting version: pluginId=%d, versionId=%d", pluginId, versionId);
     const result = await this.request(
       `/admin/plugins/${pluginId}/versions/${versionId}`,
       { method: "DELETE" }
     );
-    log5("Plugin version deleted successfully");
+    log2("Plugin version deleted successfully");
     return result;
   }
   /**
-   * 设置插件版本为最新版本
-   * @param pluginId 插件 ID
-   * @param versionId 版本 ID
-   * @returns 成功响应
+   * Sets a specific version as the latest version of a plugin
+   *
+   * @param pluginId - Plugin ID
+   * @param versionId - Version ID to set as latest
+   * @returns Promise resolving to success response
    */
   async setPluginVersionAsLatest(pluginId, versionId) {
-    log5("Setting version as latest: pluginId=%d, versionId=%d", pluginId, versionId);
+    log2("Setting version as latest: pluginId=%d, versionId=%d", pluginId, versionId);
     const result = await this.request(
       `/admin/plugins/${pluginId}/versions/${versionId}/latest`,
       { method: "POST" }
     );
-    log5("Version set as latest");
+    log2("Version set as latest");
     return result;
   }
   /**
-   * 更新插件可见性
-   * @param id 插件 ID
-   * @param visibility 新的可见性状态
-   * @returns 成功响应
+   * Updates plugin visibility
+   *
+   * @param id - Plugin ID
+   * @param visibility - New visibility setting
+   * @returns Promise resolving to success response
    */
   async updatePluginVisibility(id, visibility) {
-    log5("Updating plugin visibility: %d to %s", id, visibility);
+    log2("Updating plugin visibility: %d to %s", id, visibility);
     const result = await this.request(
       `/admin/plugins/${id}/visibility`,
       {
-        method: "PATCH",
-        body: JSON.stringify({ visibility })
+        body: JSON.stringify({ visibility }),
+        method: "PATCH"
       }
     );
-    log5("Plugin visibility updated successfully");
+    log2("Plugin visibility updated successfully");
     return result;
   }
   /**
-   * 批量更新插件状态
-   * @param ids 插件 ID 数组
-   * @param status 新的状态
-   * @returns 成功响应
+   * Updates status for multiple plugins in a single operation
+   *
+   * @param ids - Array of plugin IDs to update
+   * @param status - New status to set for all specified plugins
+   * @returns Promise resolving to success response
    */
   async batchUpdatePluginStatus(ids, status) {
-    log5("Batch updating plugin status: %O to %s", ids, status);
+    log2("Batch updating plugin status: %O to %s", ids, status);
     const result = await this.request(
       "/admin/plugins/batch/status",
       {
-        method: "PATCH",
-        body: JSON.stringify({ ids, status })
+        body: JSON.stringify({ ids, status }),
+        method: "PATCH"
       }
     );
-    log5("Batch plugin status update completed");
+    log2("Batch plugin status update completed");
     return result;
   }
   /**
-   * 批量删除插件
-   * @param ids 插件 ID 数组
-   * @returns 成功响应
+   * Deletes multiple plugins in a single operation
+   *
+   * @param ids - Array of plugin IDs to delete
+   * @returns Promise resolving to success response
    */
   async batchDeletePlugins(ids) {
-    log5("Batch deleting plugins: %O", ids);
+    log2("Batch deleting plugins: %O", ids);
     const result = await this.request(
       "/admin/plugins/batch/delete",
       {
-        method: "DELETE",
-        body: JSON.stringify({ ids })
+        body: JSON.stringify({ ids }),
+        method: "DELETE"
       }
     );
-    log5("Batch plugin deletion completed");
+    log2("Batch plugin deletion completed");
     return result;
   }
   /**
-   * 获取插件版本详情
-   * @param pluginId 插件 ID
-   * @param versionId 版本 ID
-   * @returns 版本详情
+   * Retrieves detailed information about a plugin version including deployment options
+   *
+   * @param pluginId - Plugin ID
+   * @param versionId - Version ID
+   * @returns Promise resolving to version details with deployment options
    */
   async getPluginVersionDetails(pluginId, versionId) {
-    log5(
+    log2(
       "Getting version details with deployment options: pluginId=%d, versionId=%d",
       pluginId,
       versionId
@@ -449,71 +370,75 @@ var PluginService = class extends BaseSDK {
     const result = await this.request(
       `/admin/plugins/${pluginId}/versions/${versionId}`
     );
-    log5("Version details with deployment options retrieved");
+    log2("Version details with deployment options retrieved");
     return result;
   }
   /**
-   * 更新插件版本信息
-   * @param pluginId 插件 ID
-   * @param versionId 版本 ID
-   * @param data 版本更新数据
-   * @returns 更新后的版本
+   * Updates detailed information for a plugin version
+   *
+   * @param pluginId - Plugin ID
+   * @param versionId - Version ID
+   * @param data - Detailed version update data including metadata and capabilities
+   * @returns Promise resolving to the updated plugin version
    */
   async updatePluginVersionDetails(pluginId, versionId, data) {
-    log5("Updating version details: pluginId=%d, versionId=%d", pluginId, versionId);
+    log2("Updating version details: pluginId=%d, versionId=%d", pluginId, versionId);
     const result = await this.request(
       `/admin/plugins/${pluginId}/versions/${versionId}`,
       {
-        method: "PUT",
-        body: JSON.stringify(data)
+        body: JSON.stringify(data),
+        method: "PUT"
       }
     );
-    log5("Version details updated successfully");
+    log2("Version details updated successfully");
     return result;
   }
   /**
-   * 获取插件版本的部署选项列表
-   * @param pluginId 插件 ID
-   * @param versionId 版本 ID
-   * @returns 部署选项列表
+   * Retrieves deployment options for a specific plugin version
+   *
+   * @param pluginId - Plugin ID
+   * @param versionId - Version ID
+   * @returns Promise resolving to an array of deployment options
    */
   async getDeploymentOptions(pluginId, versionId) {
-    log5("Getting deployment options: pluginId=%d, versionId=%d", pluginId, versionId);
+    log2("Getting deployment options: pluginId=%d, versionId=%d", pluginId, versionId);
     const result = await this.request(
       `/admin/plugins/${pluginId}/versions/${versionId}/deployment-options`
     );
-    log5("Retrieved %d deployment options", result.length);
+    log2("Retrieved %d deployment options", result.length);
     return result;
   }
   /**
-   * 创建部署选项
-   * @param pluginId 插件 ID
-   * @param versionId 版本 ID
-   * @param data 部署选项数据
-   * @returns 创建的部署选项
+   * Creates a new deployment option for a plugin version
+   *
+   * @param pluginId - Plugin ID
+   * @param versionId - Version ID
+   * @param data - Deployment option configuration data
+   * @returns Promise resolving to the created deployment option
    */
   async createDeploymentOption(pluginId, versionId, data) {
-    log5("Creating deployment option: pluginId=%d, versionId=%d", pluginId, versionId);
+    log2("Creating deployment option: pluginId=%d, versionId=%d", pluginId, versionId);
     const result = await this.request(
       `/admin/plugins/${pluginId}/versions/${versionId}/deployment-options`,
       {
-        method: "POST",
-        body: JSON.stringify(data)
+        body: JSON.stringify(data),
+        method: "POST"
       }
     );
-    log5("Deployment option created successfully");
+    log2("Deployment option created successfully");
     return result;
   }
   /**
-   * 更新部署选项
-   * @param pluginId 插件 ID
-   * @param versionId 版本 ID
-   * @param optionId 部署选项 ID
-   * @param data 部署选项更新数据
-   * @returns 更新后的部署选项
+   * Updates an existing deployment option
+   *
+   * @param pluginId - Plugin ID
+   * @param versionId - Version ID
+   * @param optionId - Deployment option ID
+   * @param data - Updated deployment option configuration
+   * @returns Promise resolving to the updated deployment option
    */
   async updateDeploymentOption(pluginId, versionId, optionId, data) {
-    log5(
+    log2(
       "Updating deployment option: pluginId=%d, versionId=%d, optionId=%d",
       pluginId,
       versionId,
@@ -522,22 +447,23 @@ var PluginService = class extends BaseSDK {
     const result = await this.request(
       `/admin/plugins/${pluginId}/versions/${versionId}/deployment-options/${optionId}`,
       {
-        method: "PUT",
-        body: JSON.stringify(data)
+        body: JSON.stringify(data),
+        method: "PUT"
       }
     );
-    log5("Deployment option updated successfully");
+    log2("Deployment option updated successfully");
     return result;
   }
   /**
-   * 删除部署选项
-   * @param pluginId 插件 ID
-   * @param versionId 版本 ID
-   * @param optionId 部署选项 ID
-   * @returns 成功响应
+   * Deletes a deployment option
+   *
+   * @param pluginId - Plugin ID
+   * @param versionId - Version ID
+   * @param optionId - Deployment option ID
+   * @returns Promise resolving to success response
    */
   async deleteDeploymentOption(pluginId, versionId, optionId) {
-    log5(
+    log2(
       "Deleting deployment option: pluginId=%d, versionId=%d, optionId=%d",
       pluginId,
       versionId,
@@ -547,18 +473,19 @@ var PluginService = class extends BaseSDK {
       `/admin/plugins/${pluginId}/versions/${versionId}/deployment-options/${optionId}`,
       { method: "DELETE" }
     );
-    log5("Deployment option deleted successfully");
+    log2("Deployment option deleted successfully");
     return result;
   }
   /**
-   * 获取部署选项的系统依赖
-   * @param pluginId 插件 ID
-   * @param versionId 版本 ID
-   * @param optionId 部署选项 ID
-   * @returns 系统依赖列表
+   * Retrieves system dependencies for a deployment option
+   *
+   * @param pluginId - Plugin ID
+   * @param versionId - Version ID
+   * @param optionId - Deployment option ID
+   * @returns Promise resolving to an array of system dependencies
    */
   async getDeploymentOptionSystemDependencies(pluginId, versionId, optionId) {
-    log5(
+    log2(
       "Getting system dependencies: pluginId=%d, versionId=%d, optionId=%d",
       pluginId,
       versionId,
@@ -567,233 +494,254 @@ var PluginService = class extends BaseSDK {
     const result = await this.request(
       `/admin/plugins/${pluginId}/versions/${versionId}/deployment-options/${optionId}/system-dependencies`
     );
-    log5("Retrieved %d system dependencies", result.length);
+    log2("Retrieved %d system dependencies", result.length);
     return result;
   }
 };
 
 // src/admin/services/SystemDependencyService.ts
-import debug6 from "debug";
-var log6 = debug6("lobe-market-sdk:admin:dependency");
+import debug3 from "debug";
+var log3 = debug3("lobe-market-sdk:admin:dependency");
 var SystemDependencyService = class extends BaseSDK {
   /**
-   * 创建系统依赖管理服务实例
-   * @param options SDK 配置选项
-   * @param sharedHeaders 共享的 headers 对象（可选）
+   * Creates a new SystemDependencyService instance
+   *
+   * @param options - Configuration options for the SDK
+   * @param sharedHeaders - Optional shared headers object for reuse across services
    */
   constructor(options = {}, sharedHeaders) {
     super(options, sharedHeaders);
-    log6("SystemDependencyService instance created");
+    log3("SystemDependencyService instance created");
   }
   /**
-   * 获取所有系统依赖项
-   * @returns 系统依赖项列表
+   * Retrieves all system dependencies
+   *
+   * Gets a list of all defined system dependencies that plugins may require.
+   *
+   * @returns Promise resolving to an array of system dependencies
    */
   async getSystemDependencies() {
-    log6("Getting all system dependencies");
+    log3("Getting all system dependencies");
     const result = await this.request(`/admin/plugins/dependencies`);
-    log6("Retrieved %d system dependencies", result.length);
+    log3("Retrieved %d system dependencies", result.length);
     return result;
   }
   /**
-   * 获取特定系统依赖项
-   * @param id 依赖项 ID
-   * @returns 系统依赖项
+   * Retrieves a specific system dependency by ID
+   *
+   * @param id - System dependency ID
+   * @returns Promise resolving to the system dependency details
    */
   async getSystemDependency(id) {
-    log6("Getting system dependency details: %d", id);
+    log3("Getting system dependency details: %d", id);
     const result = await this.request(`/admin/plugins/dependencies/${id}`);
-    log6("System dependency details retrieved");
+    log3("System dependency details retrieved");
     return result;
   }
   /**
-   * 创建系统依赖项
-   * @param data 依赖项创建数据
-   * @returns 创建的依赖项
+   * Creates a new system dependency
+   *
+   * @param data - System dependency creation data
+   * @returns Promise resolving to the created system dependency
    */
   async createSystemDependency(data) {
-    log6("Creating system dependency: %O", data);
+    log3("Creating system dependency: %O", data);
     const result = await this.request(`/admin/plugins/dependencies`, {
-      method: "POST",
-      body: JSON.stringify(data)
+      body: JSON.stringify(data),
+      method: "POST"
     });
-    log6("System dependency created successfully");
+    log3("System dependency created successfully");
     return result;
   }
   /**
-   * 更新系统依赖项
-   * @param id 依赖项 ID
-   * @param data 依赖项更新数据
-   * @returns 更新后的依赖项
+   * Updates an existing system dependency
+   *
+   * @param id - System dependency ID
+   * @param data - System dependency update data
+   * @returns Promise resolving to the updated system dependency
    */
   async updateSystemDependency(id, data) {
-    log6("Updating system dependency: %d, data: %O", id, data);
+    log3("Updating system dependency: %d, data: %O", id, data);
     const result = await this.request(`/admin/plugins/dependencies/${id}`, {
-      method: "PUT",
-      body: JSON.stringify(data)
+      body: JSON.stringify(data),
+      method: "PUT"
     });
-    log6("System dependency updated successfully");
+    log3("System dependency updated successfully");
     return result;
   }
   /**
-   * 删除系统依赖项
-   * @param id 依赖项 ID
-   * @returns 成功响应
+   * Deletes a system dependency
+   *
+   * @param id - System dependency ID
+   * @returns Promise resolving to success response
    */
   async deleteSystemDependency(id) {
-    log6("Deleting system dependency: %d", id);
+    log3("Deleting system dependency: %d", id);
     const result = await this.request(
       `/admin/plugins/dependencies/${id}`,
       { method: "DELETE" }
     );
-    log6("System dependency deleted successfully");
+    log3("System dependency deleted successfully");
     return result;
   }
 };
 
 // src/admin/services/SettingsService.ts
-import debug7 from "debug";
-var log7 = debug7("lobe-market-sdk:admin:settings");
+import debug4 from "debug";
+var log4 = debug4("lobe-market-sdk:admin:settings");
 var SettingsService = class extends BaseSDK {
   /**
-   * 获取设置列表
-   * @param params 查询参数
-   * @returns 设置键值对对象
+   * Retrieves all system settings
+   *
+   * Returns a consolidated map of all settings with typed values
+   * for known setting keys.
+   *
+   * @returns Promise resolving to the settings map
    */
   async getSettings() {
     return await this.request("/admin/settings");
   }
   /**
-   * 获取单个设置
-   * @param key 设置键名
-   * @returns 设置详情
+   * Retrieves a specific setting by key
+   *
+   * @param key - Setting key name
+   * @returns Promise resolving to the setting details
    */
   async getSettingByKey(key) {
-    log7("Getting setting: %s", key);
+    log4("Getting setting: %s", key);
     const result = await this.request(`/admin/settings/${key}`);
-    log7("Setting retrieved");
+    log4("Setting retrieved");
     return result;
   }
   /**
-   * 创建设置
-   * @param data 设置数据
-   * @returns 创建的设置
+   * Creates a new system setting
+   *
+   * @param data - Setting creation parameters
+   * @returns Promise resolving to the created setting
    */
   async createSetting(data) {
-    log7("Creating setting: %O", data);
+    log4("Creating setting: %O", data);
     const result = await this.request("/admin/settings", {
-      method: "POST",
-      body: JSON.stringify(data)
+      body: JSON.stringify(data),
+      method: "POST"
     });
-    log7("Setting created successfully");
+    log4("Setting created successfully");
     return result;
   }
   /**
-   * 更新设置
-   * @param key 设置键名
-   * @param data 更新数据
-   * @returns 更新后的设置
+   * Updates an existing setting
+   *
+   * @param key - Setting key name
+   * @param data - Setting update parameters
+   * @returns Promise resolving to the updated setting
    */
   async updateSetting(key, data) {
-    log7("Updating setting: %s, data: %O", key, data);
+    log4("Updating setting: %s, data: %O", key, data);
     const result = await this.request(`/admin/settings/${key}`, {
-      method: "PUT",
-      body: JSON.stringify(data)
+      body: JSON.stringify(data),
+      method: "PUT"
     });
-    log7("Setting updated successfully");
+    log4("Setting updated successfully");
     return result;
   }
   /**
-   * 删除设置
-   * @param key 设置键名
-   * @returns 删除结果
+   * Deletes a setting
+   *
+   * @param key - Setting key name
+   * @returns Promise resolving to success message
    */
   async deleteSetting(key) {
-    log7("Deleting setting: %s", key);
+    log4("Deleting setting: %s", key);
     const result = await this.request(`/admin/settings/${key}`, {
       method: "DELETE"
     });
-    log7("Setting deleted successfully");
+    log4("Setting deleted successfully");
     return result;
   }
 };
 
 // src/admin/services/ReviewService.ts
-import debug8 from "debug";
-var log8 = debug8("lobe-market-sdk:admin:review");
+import debug5 from "debug";
+var log5 = debug5("lobe-market-sdk:admin:review");
 var ReviewService = class extends BaseSDK {
   /**
-   * 创建审核管理服务实例
-   * @param options SDK 配置选项
-   * @param sharedHeaders 共享的 headers 对象（可选）
+   * Creates a new ReviewService instance
+   *
+   * @param options - Configuration options for the SDK
+   * @param sharedHeaders - Optional shared headers object for reuse across services
    */
   constructor(options = {}, sharedHeaders) {
     super(options, sharedHeaders);
-    log8("ReviewService instance created");
+    log5("ReviewService instance created");
   }
   /**
-   * 获取审核列表
-   * @param params 查询参数
-   * @returns 审核列表响应
+   * Retrieves a list of reviews with filtering options
+   *
+   * @param params - Query parameters for filtering and pagination
+   * @returns Promise resolving to the review list response
    */
   async getReviews(params = {}) {
-    log8("Getting reviews with params: %O", params);
+    log5("Getting reviews with params: %O", params);
     const queryString = this.buildQueryString(params);
     const url = `/admin/reviews${queryString ? `?${queryString}` : ""}`;
     const result = await this.request(url);
-    log8("Retrieved %d reviews", result.data.length);
+    log5("Retrieved %d reviews", result.data.length);
     return result;
   }
   /**
-   * 获取审核详情
-   * @param id 审核 ID
-   * @returns 审核详情
+   * Retrieves a specific review by ID
+   *
+   * @param id - Review ID
+   * @returns Promise resolving to the review details
    */
   async getReviewById(id) {
-    log8("Getting review details: %d", id);
+    log5("Getting review details: %d", id);
     const result = await this.request(`/admin/reviews/${id}`);
-    log8("Review details retrieved");
+    log5("Review details retrieved");
     return result;
   }
   /**
-   * 更新审核状态
-   * @param id 审核 ID
-   * @param data 更新数据
-   * @returns 更新后的审核信息
+   * Updates a review's status and comment
+   *
+   * @param id - Review ID
+   * @param data - Update parameters containing new status and optional comment
+   * @returns Promise resolving to the updated review
    */
   async updateReview(id, data) {
-    log8("Updating review: %d, data: %O", id, data);
+    log5("Updating review: %d, data: %O", id, data);
     const result = await this.request(`/admin/reviews/${id}`, {
-      method: "PUT",
-      body: JSON.stringify(data)
+      body: JSON.stringify(data),
+      method: "PUT"
     });
-    log8("Review updated successfully");
+    log5("Review updated successfully");
     return result;
   }
   /**
-   * 获取插件的审核历史
-   * @param pluginId 插件 ID
-   * @returns 审核历史列表
+   * Retrieves the review history for a specific plugin
+   *
+   * @param pluginId - Plugin ID
+   * @returns Promise resolving to an array of reviews for the plugin
    */
   async getPluginReviews(pluginId) {
-    log8("Getting plugin reviews: pluginId=%d", pluginId);
+    log5("Getting plugin reviews: pluginId=%d", pluginId);
     const result = await this.request(`/admin/reviews/plugin/${pluginId}`);
-    log8("Retrieved %d reviews for plugin", result.data.length);
+    log5("Retrieved %d reviews for plugin", result.data.length);
     return result;
   }
 };
 
 // src/admin/MarketAdmin.ts
-var log9 = debug9("lobe-market-sdk:admin");
+var log6 = debug6("lobe-market-sdk:admin");
 var MarketAdmin = class extends BaseSDK {
   /**
-   * 创建 MarketAdmin 实例
-   * @param options SDK 配置选项
+   * Creates a new MarketAdmin instance
+   *
+   * @param options - Configuration options for the SDK
    */
   constructor(options = {}) {
     const apiKey = options.apiKey || process.env.MARKET_ADMIN_API_KEY;
     super({ ...options, apiKey });
-    log9("MarketAdmin instance created");
+    log6("MarketAdmin instance created");
     this.plugins = new PluginService(options, this.headers);
     this.reviews = new ReviewService(options, this.headers);
     this.settings = new SettingsService(options, this.headers);
@@ -801,6 +749,143 @@ var MarketAdmin = class extends BaseSDK {
   }
 };
 
+// src/market/market-sdk.ts
+import debug9 from "debug";
+
+// src/market/services/DiscoveryService.ts
+import debug7 from "debug";
+var log7 = debug7("lobe-market-sdk:discovery");
+var DiscoveryService = class extends BaseSDK {
+  /**
+   * Creates a new DiscoveryService instance
+   *
+   * @param options - Configuration options for the SDK
+   * @param sharedHeaders - Optional shared headers object for reuse across services
+   */
+  constructor(options = {}, sharedHeaders) {
+    super(options, sharedHeaders);
+    log7("DiscoveryService instance created");
+  }
+  /**
+   * Retrieves the service discovery document
+   *
+   * This document contains information about available API endpoints,
+   * authentication methods, and other capabilities of the Market API.
+   * The result is cached after the first request to improve performance.
+   *
+   * @returns Promise resolving to the service discovery document
+   */
+  async getDiscoveryDocument() {
+    log7("Fetching discovery document");
+    if (this.discoveryDoc) {
+      log7("Returning cached discovery document");
+      return this.discoveryDoc;
+    }
+    this.discoveryDoc = await this.request("/market/.well-known/discovery");
+    log7("Discovery document successfully fetched");
+    return this.discoveryDoc;
+  }
+};
+
+// src/market/services/PluginsService.ts
+import debug8 from "debug";
+var log8 = debug8("lobe-market-sdk:plugins");
+var PluginsService = class extends BaseSDK {
+  /**
+   * Creates a new PluginsService instance
+   *
+   * @param options - Configuration options for the SDK
+   * @param sharedHeaders - Optional shared headers object for reuse across services
+   */
+  constructor(options = {}, sharedHeaders) {
+    super(options, sharedHeaders);
+    log8("PluginsService instance created");
+  }
+  /**
+   * Retrieves a list of plugins from the marketplace
+   *
+   * Supports filtering, pagination, and localization of results.
+   *
+   * @param params - Query parameters for filtering and pagination
+   * @returns Promise resolving to the plugin list response containing items and pagination info
+   */
+  async getPluginList(params = {}) {
+    const locale = params.locale || this.defaultLocale;
+    const queryParams = { ...params, locale };
+    const queryString = this.buildQueryString(queryParams);
+    log8("Getting plugin list: %O", queryParams);
+    const result = await this.request(`/v1/plugins${queryString}`);
+    log8("Retrieved %d plugins", result.items.length);
+    return result;
+  }
+  /**
+   * Retrieves all plugin categories and their counts
+   *
+   * Returns a list of categories along with the number of plugins in each category.
+   * Useful for building category filters in a UI.
+   *
+   * @returns Promise resolving to an array of category items with counts
+   */
+  async getCategories() {
+    log8("Getting plugin categories");
+    const result = await this.request("/v1/plugins/categories");
+    log8("Retrieved %d categories", result.length);
+    return result;
+  }
+  /**
+   * Retrieves the manifest for a specific plugin
+   *
+   * The manifest contains detailed information about a plugin, including
+   * its capabilities, tools, prompts, and resources.
+   *
+   * @param identifier - Unique identifier of the plugin
+   * @param locale - Optional locale for localized content (defaults to SDK default locale)
+   * @param version - Optional specific version to retrieve (defaults to latest)
+   * @returns Promise resolving to the plugin manifest
+   */
+  async getPluginManifest(identifier, locale, version) {
+    log8("Getting plugin manifest: %O", { identifier, locale, version });
+    const localeParam = locale || this.defaultLocale;
+    const params = { locale: localeParam };
+    if (version) {
+      params.version = version;
+    }
+    const queryString = this.buildQueryString(params);
+    const manifest = await this.request(
+      `/v1/plugins/${identifier}/manifest${queryString}`
+    );
+    log8("Plugin manifest successfully retrieved: %s", identifier);
+    return manifest;
+  }
+};
+
+// src/market/market-sdk.ts
+var log9 = debug9("lobe-market-sdk");
+var MarketSDK = class extends BaseSDK {
+  /**
+   * Creates a new MarketSDK instance
+   *
+   * @param options - Configuration options for the SDK
+   */
+  constructor(options = {}) {
+    super(options);
+    log9("MarketSDK instance created");
+    this.plugins = new PluginsService(options, this.headers);
+    this.discovery = new DiscoveryService(options, this.headers);
+  }
+  /**
+   * Retrieves the service discovery document
+   *
+   * The discovery document provides information about available API endpoints,
+   * versions, and capabilities of the Market API.
+   *
+   * @returns Promise resolving to the service discovery document
+   */
+  async getDiscoveryDocument() {
+    return this.discovery.getDiscoveryDocument();
+  }
+};
+
 // src/types/admin.ts
 import { z } from "zod";
 var VisibilityEnumSchema = z.enum(["public", "private", "internal"]);