jpsclient 1.3.0 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d843d5f4064530438cd7ca9763da69d92df5d5d6a6cc552e5534e07b356060c5
-  data.tar.gz: 3178f83cd63dc1030b61c6f14694966c7251a48c49dc7ec13c0c67438b08700b
+  metadata.gz: 5dc83223b65fce83cf83423489a63175292008cadba1fa25d20a428d5401cef0
+  data.tar.gz: 78c8a24b9d535fcd0bc64ab6add14c466c99725212ae0f5267a67248060d1ecb
 SHA512:
-  metadata.gz: ced82b03ab14e7cdd6990a0cdcd694cdaa280ec539867d83d5d3f8afb39ca5abd96969969d45b86b113dc1a48d9048ed60ec2c265840e7af0d489268e8dab16e
-  data.tar.gz: 0554a7c2c67981564e1972aee4308c2442bf9ac1e431ae28f20fb814a5bbfa7bea61612217a380e9271c9b4f0ddb749a73666d9afd11522a4e1e8f5110e0181b
+  metadata.gz: a85d81582f25660667707be4c4370f0db5555ffd8ef805da89e23c54c4be94c0926b1e4f38b61bb98cb76807356e6f2b01898f855734e338e868a3a3c2717a1b
+  data.tar.gz: 25b41812658ae7a22d49359a849509129b233e951d4aacb0bc3c73a78cd3ba086fe3bd494c9c72a85f972a3109f8084414138ce16ac5963d64912069b73cabbf

data/lib/jpsclient/api/category.rb

@@ -0,0 +1,331 @@
+module JPSClient
+  module API
+    # Category 相关 API
+    # 处理通用分类管理相关接口
+    module Category
+
+      # 获取分类列表
+      #
+      # @param params [Hash] 查询参数
+      #   - type: 分类类型（可选）
+      #   - parent_id: 父分类ID（可选）
+      # @return [Hash] API响应
+      def get_category_list(params: {})
+        config = @request_config && @request_config["category_list"]
+        raise JPSClient::ExceptionError, "Missing config for category_list" unless config && config["url"]
+
+        path = config["url"]
+
+        response = @http_client.get(path, params: params)
+        result = JPSClient::Response.new(response)
+
+        if result.need_login?
+          do_login(force_login: true)
+          response = @http_client.get(path, params: params)
+          result = JPSClient::Response.new(response)
+        end
+
+        return result.to_h
+      end
+
+      # 获取分类树形结构
+      #
+      # @param params [Hash] 查询参数
+      #   - type: 分类类型（可选）
+      #   - max_level: 最大层级深度（可选）
+      # @return [Hash] API响应，包含树形结构数据
+      def get_category_tree(params: {})
+        config = @request_config && @request_config["category_tree"]
+        raise JPSClient::ExceptionError, "Missing config for category_tree" unless config && config["url"]
+
+        path = config["url"]
+
+        response = @http_client.get(path, params: params)
+        result = JPSClient::Response.new(response)
+
+        if result.need_login?
+          do_login(force_login: true)
+          response = @http_client.get(path, params: params)
+          result = JPSClient::Response.new(response)
+        end
+
+        return result.to_h
+      end
+
+      # 创建分类
+      #
+      # @param params [Hash] 分类信息参数
+      #   - name: 分类名称（必需）
+      #   - type: 分类类型（必需）
+      #   - parent_id: 父分类ID（可选，根分类不需要）
+      #   - icon: 分类图标（可选）
+      #   - description: 分类描述（可选）
+      #   - sort_order: 排序值（可选，默认1）
+      # @return [Hash] API响应
+      def create_category(params: {})
+        config = @request_config && @request_config["category_create"]
+        raise JPSClient::ExceptionError, "Missing config for category_create" unless config && config["url"]
+
+        # 参数验证
+        required_fields = [:name, :type]
+        missing_fields = required_fields.select { |field| params[field].nil? || params[field].to_s.empty? }
+
+        if missing_fields.any?
+          raise JPSClient::ExceptionError, "Missing required fields: #{missing_fields.join(', ')}"
+        end
+
+        # 设置默认值
+        params[:sort_order] ||= 1
+
+        path = config["url"]
+
+        response = @http_client.post(path, body: params)
+        result = JPSClient::Response.new(response)
+
+        if result.need_login?
+          do_login(force_login: true)
+          response = @http_client.post(path, body: params)
+          result = JPSClient::Response.new(response)
+        end
+
+        return result.to_h
+      end
+
+      # 更新分类
+      #
+      # @param params [Hash] 更新参数
+      #   - id: 分类ID（必需）
+      #   - name: 分类名称
+      #   - icon: 分类图标
+      #   - description: 分类描述
+      #   - sort_order: 排序值
+      #   - status: 分类状态（1:启用, 0:停用）
+      # @return [Hash] API响应
+      def update_category(params: {})
+        config = @request_config && @request_config["category_update"]
+        raise JPSClient::ExceptionError, "Missing config for category_update" unless config && config["url"]
+
+        # ID 是必需的
+        raise JPSClient::ExceptionError, "Missing required field: id" unless params[:id]
+
+        path = config["url"]
+
+        response = @http_client.post(path, body: params)
+        result = JPSClient::Response.new(response)
+
+        if result.need_login?
+          do_login(force_login: true)
+          response = @http_client.post(path, body: params)
+          result = JPSClient::Response.new(response)
+        end
+
+        return result.to_h
+      end
+
+      # 删除分类
+      #
+      # @param id [String, Integer] 分类ID（必需）
+      # @return [Hash] API响应
+      def delete_category(id:)
+        config = @request_config && @request_config["category_delete"]
+        raise JPSClient::ExceptionError, "Missing config for category_delete" unless config && config["url"]
+
+        path = config["url"]
+
+        # POST请求，ID作为body参数
+        params = { id: id }
+
+        response = @http_client.post(path, body: params)
+        result = JPSClient::Response.new(response)
+
+        if result.need_login?
+          do_login(force_login: true)
+          response = @http_client.post(path, body: params)
+          result = JPSClient::Response.new(response)
+        end
+
+        return result.to_h
+      end
+
+      # 分类排序
+      #
+      # @param items [Array<Hash>] 排序项数组
+      #   每个项包含：
+      #   - id: 分类ID
+      #   - sort_order: 新的排序值
+      # @return [Hash] API响应
+      def sort_categories(items: [])
+        config = @request_config && @request_config["category_sort"]
+        raise JPSClient::ExceptionError, "Missing config for category_sort" unless config && config["url"]
+
+        if items.empty?
+          raise JPSClient::ExceptionError, "Items array cannot be empty"
+        end
+
+        # 验证每个项都有必需的字段
+        items.each_with_index do |item, index|
+          unless item[:id] || item["id"]
+            raise JPSClient::ExceptionError, "Item at index #{index} missing 'id'"
+          end
+          unless item[:sort_order] || item["sort_order"]
+            raise JPSClient::ExceptionError, "Item at index #{index} missing 'sort_order'"
+          end
+        end
+
+        path = config["url"]
+        params = { items: items }
+
+        response = @http_client.post(path, body: params)
+        result = JPSClient::Response.new(response)
+
+        if result.need_login?
+          do_login(force_login: true)
+          response = @http_client.post(path, body: params)
+          result = JPSClient::Response.new(response)
+        end
+
+        return result.to_h
+      end
+
+      # 按类型获取分类列表（便捷方法）
+      #
+      # @param type [String] 分类类型
+      #   - application: 应用分类
+      #   - resource: 资源分类
+      #   - asset: 素材分类
+      #   - requirement: 需求分类
+      #   - sketch: 画板分类
+      #   - tool: 工具分类
+      #   - survey: 调研分类
+      #   - publisher: 发行商分类
+      #   - experience: 体验分类
+      # @param parent_id [String, Integer, nil] 父分类ID
+      # @return [Hash] API响应
+      def get_categories_by_type(type:, parent_id: nil)
+        params = { type: type }
+        params[:parent_id] = parent_id if parent_id
+        get_category_list(params: params)
+      end
+
+      # 获取某分类的所有子分类
+      #
+      # @param parent_id [String, Integer] 父分类ID
+      # @return [Hash] API响应
+      def get_subcategories(parent_id:)
+        get_category_list(params: { parent_id: parent_id })
+      end
+
+      # 获取根分类列表
+      #
+      # @param type [String, nil] 分类类型（可选）
+      # @return [Hash] API响应
+      def get_root_categories(type: nil)
+        params = { parent_id: 0 }  # parent_id 为 0 或 null 表示根分类
+        params[:type] = type if type
+        get_category_list(params: params)
+      end
+
+      # 批量创建分类
+      # 注意：此方法会逐个调用 API，返回结果数组
+      #
+      # @param categories [Array<Hash>] 分类数组
+      # @return [Array<Hash>] 每个请求的响应结果
+      def batch_create_categories(categories: [])
+        return [] if categories.empty?
+
+        results = []
+        categories.each do |category_params|
+          result = create_category(params: category_params)
+          results << result
+        end
+
+        results
+      end
+
+      # 移动分类到新的父分类
+      #
+      # @param category_id [String, Integer] 要移动的分类ID
+      # @param new_parent_id [String, Integer, nil] 新的父分类ID（nil表示移到根级）
+      # @return [Hash] API响应
+      def move_category(category_id:, new_parent_id: nil)
+        params = {
+          id: category_id,
+          parent_id: new_parent_id || 0
+        }
+        update_category(params: params)
+      end
+
+      # 启用分类
+      #
+      # @param category_id [String, Integer] 分类ID
+      # @return [Hash] API响应
+      def enable_category(category_id:)
+        update_category(params: { id: category_id, status: 1 })
+      end
+
+      # 停用分类
+      #
+      # @param category_id [String, Integer] 分类ID
+      # @return [Hash] API响应
+      def disable_category(category_id:)
+        update_category(params: { id: category_id, status: 0 })
+      end
+
+      # 构建分类路径
+      # 根据分类ID获取从根到该分类的完整路径
+      #
+      # @param category_id [String, Integer] 分类ID
+      # @return [Array<Hash>] 分类路径数组，从根到目标分类
+      def get_category_path(category_id:)
+        response = get_category_list
+
+        # 如果请求失败，返回空数组
+        return [] unless response && response['data']
+
+        categories = response['data']['list'] || response['data'][:list] || []
+        path = []
+
+        current_id = category_id.to_s
+        while current_id
+          category = categories.find { |c|
+            (c['id'] || c[:id]).to_s == current_id
+          }
+          break unless category
+
+          path.unshift(category)
+          current_id = (category['parent_id'] || category[:parent_id])&.to_s
+          break if current_id == "0" || current_id.nil?
+        end
+
+        path
+      end
+
+      # 获取分类统计信息
+      # 统计某个分类下的直接子分类数量
+      #
+      # @param category_id [String, Integer] 分类ID
+      # @return [Hash] 包含统计数据的哈希
+      def get_category_statistics(category_id:)
+        response = get_subcategories(parent_id: category_id)
+
+        # 如果请求失败，返回空统计
+        unless response && response['data']
+          return {
+            category_id: category_id,
+            direct_children_count: 0,
+            children: []
+          }
+        end
+
+        child_list = response['data']['list'] || response['data'][:list] || []
+
+        {
+          category_id: category_id,
+          direct_children_count: child_list.size,
+          children: child_list
+        }
+      end
+
+    end
+  end
+end

data/lib/jpsclient/api/cert.rb

@@ -6,7 +6,10 @@ module JPSClient
 
       # 获取证书列表
       def get_cert_list()
-        path = @request_config["cert_list"]["url"]
+        config = @request_config && @request_config["cert_list"]
+        raise JPSClient::ExceptionError, "Missing config for cert_list" unless config && config["url"]
+
+        path = config["url"]
 
         response = @http_client.get(path)
         result = JPSClient::Response.new(response)

data/lib/jpsclient/api/client.rb

@@ -11,16 +11,17 @@ require 'jpsclient/utils/logger'
 # 加载 API 模块
 require 'jpsclient/api/app_level'
 require 'jpsclient/api/app_resource'
-require 'jpsclient/api/app_resource_version'
+# require 'jpsclient/api/app_resource_version' # 已移除 - API不存在
 require 'jpsclient/api/apple_account'
 require 'jpsclient/api/application'
-require 'jpsclient/api/application_category'
-require 'jpsclient/api/application_design'
+# require 'jpsclient/api/application_category' # 已移除 - API不存在
+require 'jpsclient/api/design' # 替代 application_design
 require 'jpsclient/api/application_income'
 require 'jpsclient/api/application_sales'
 require 'jpsclient/api/application_version'
-require 'jpsclient/api/assets_category'
+# require 'jpsclient/api/assets_category' # 已移除 - API不存在
 require 'jpsclient/api/bug'
+require 'jpsclient/api/category'
 require 'jpsclient/api/cert'
 require 'jpsclient/api/collect'
 require 'jpsclient/api/collection'
@@ -29,15 +30,15 @@ require 'jpsclient/api/creative'
 require 'jpsclient/api/custom_application'
 require 'jpsclient/api/custom_application_web'
 require 'jpsclient/api/document_text'
-require 'jpsclient/api/experience'
-require 'jpsclient/api/experience_category'
+# require 'jpsclient/api/experience' # 已移除 - API不存在
+# require 'jpsclient/api/experience_category' # 已移除 - API不存在
 require 'jpsclient/api/fgui_export'
 require 'jpsclient/api/file'
 require 'jpsclient/api/game_assets'
 require 'jpsclient/api/healthy'
-require 'jpsclient/api/icon_and_snapshot'
+# require 'jpsclient/api/icon_and_snapshot' # 已移除 - API不存在
 require 'jpsclient/api/idea'
-require 'jpsclient/api/jssdk'
+require 'jpsclient/api/js_sdk' # 重命名为 js_sdk
 require 'jpsclient/api/lark_bitable'
 require 'jpsclient/api/lark_chat_group'
 require 'jpsclient/api/lark_comment'
@@ -47,30 +48,41 @@ require 'jpsclient/api/lark_task_section'
 require 'jpsclient/api/lark_user'
 require 'jpsclient/api/lark_wiki_node'
 require 'jpsclient/api/lark_wiki_space'
+# 添加新的飞书API
+require 'jpsclient/api/lark_card_message'
+require 'jpsclient/api/lark_message'
+require 'jpsclient/api/lark_file'
+require 'jpsclient/api/lark_department'
+require 'jpsclient/api/lark_leave_approval'
 require 'jpsclient/api/login'
 require 'jpsclient/api/m3u8'
 require 'jpsclient/api/menu'
+# 添加新的核心API
+require 'jpsclient/api/permission'
+require 'jpsclient/api/image_search'
+require 'jpsclient/api/nuget'
 require 'jpsclient/api/project'
 require 'jpsclient/api/project_package'
 require 'jpsclient/api/publisher'
-require 'jpsclient/api/publisher_category'
+# require 'jpsclient/api/publisher_category' # 已移除 - API不存在
 require 'jpsclient/api/publisher_group'
-require 'jpsclient/api/publisher_group_category'
+# require 'jpsclient/api/publisher_group_category' # 已移除 - API不存在
 require 'jpsclient/api/requirements'
-require 'jpsclient/api/requirements_category'
-require 'jpsclient/api/resource_category'
+# require 'jpsclient/api/requirements_category' # 已移除 - API不存在
+# require 'jpsclient/api/resource_category' # 已移除 - API不存在
 require 'jpsclient/api/role'
 require 'jpsclient/api/simple_search'
 require 'jpsclient/api/sketch'
-require 'jpsclient/api/sketch_category'
+# require 'jpsclient/api/sketch_category' # 已移除 - API不存在
 require 'jpsclient/api/sov'
 require 'jpsclient/api/statistics'
 require 'jpsclient/api/store'
 require 'jpsclient/api/survey'
-require 'jpsclient/api/survey_category'
+# require 'jpsclient/api/survey_category' # 已移除 - API不存在
 require 'jpsclient/api/tag'
+require 'jpsclient/api/template'
 require 'jpsclient/api/tool'
-require 'jpsclient/api/tool_category'
+# require 'jpsclient/api/tool_category' # 已移除 - API不存在
 require 'jpsclient/api/trending'
 require 'jpsclient/api/ud_id'
 require 'jpsclient/api/user'
@@ -85,16 +97,17 @@ module JPSClient
     # 引入各个 API 模块
     include API::AppLevel
     include API::AppResource
-    include API::AppResourceVersion
+    # include API::AppResourceVersion # 已移除 - API不存在
     include API::AppleAccount
     include API::Application
-    include API::ApplicationCategory
-    include API::ApplicationDesign
+    # include API::ApplicationCategory # 已移除 - API不存在
+    include API::Design # 替代 ApplicationDesign
     include API::ApplicationIncome
     include API::ApplicationSales
     include API::ApplicationVersion
-    include API::AssetsCategory
+    # include API::AssetsCategory # 已移除 - API不存在
     include API::Bug
+    include API::Category
     include API::Cert
     include API::Collect
     include API::Collection
@@ -103,15 +116,15 @@ module JPSClient
     include API::CustomApplication
     include API::CustomApplicationWeb
     include API::DocumentText
-    include API::Experience
-    include API::ExperienceCategory
+    # include API::Experience # 已移除 - API不存在
+    # include API::ExperienceCategory # 已移除 - API不存在
     include API::FguiExport
     include API::File
     include API::GameAssets
     include API::Healthy
-    include API::IconAndSnapshot
+    # include API::IconAndSnapshot # 已移除 - API不存在
     include API::Idea
-    include API::Jssdk
+    include API::Jssdk # 模块名应该是 Jssdk
     include API::LarkBitable
     include API::LarkChatGroup
     include API::LarkComment
@@ -121,30 +134,41 @@ module JPSClient
     include API::LarkUser
     include API::LarkWikiNode
     include API::LarkWikiSpace
+    # 添加新的飞书API模块
+    include API::LarkCardMessage
+    include API::LarkMessage
+    include API::LarkFile
+    include API::LarkDepartment
+    include API::LarkLeaveApproval
     include API::Login
     include API::M3u8
     include API::Menu
+    # 添加新的核心API模块
+    include API::Permission
+    include API::ImageSearch
+    include API::NuGet
     include API::Project
     include API::ProjectPackage
     include API::Publisher
-    include API::PublisherCategory
+    # include API::PublisherCategory # 已移除 - API不存在
     include API::PublisherGroup
-    include API::PublisherGroupCategory
+    # include API::PublisherGroupCategory # 已移除 - API不存在
     include API::Requirements
-    include API::RequirementsCategory
-    include API::ResourceCategory
+    # include API::RequirementsCategory # 已移除 - API不存在
+    # include API::ResourceCategory # 已移除 - API不存在
     include API::Role
     include API::SimpleSearch
     include API::Sketch
-    include API::SketchCategory
+    # include API::SketchCategory # 已移除 - API不存在
     include API::Sov
     include API::Statistics
     include API::Store
     include API::Survey
-    include API::SurveyCategory
+    # include API::SurveyCategory # 已移除 - API不存在
     include API::Tag
+    include API::Template
     include API::Tool
-    include API::ToolCategory
+    # include API::ToolCategory # 已移除 - API不存在
     include API::Trending
     include API::UdId
     include API::User
@@ -161,14 +185,21 @@ module JPSClient
     attr_reader :config_json  # 暴露配置供其他模块使用
     attr_reader :config_file  # 配置文件路径
 
-    def initialize(config_file:)
+    def initialize(config_file: nil, config: nil)
       begin
-        @config_file = config_file
-
-        raise ExceptionError, "必须提供配置文件路径" unless @config_file
-        raise ExceptionError, "配置文件不存在: #{@config_file}" unless File.exist?(@config_file)
-
-        @config_json = JSON.parse(File.read(@config_file))
+        # 支持两种初始化方式：从文件或直接配置
+        if config
+          # 直接使用提供的配置（主要用于测试）
+          @config_json = config
+          @config_file = nil
+        elsif config_file
+          # 从文件加载配置
+          @config_file = config_file
+          raise ExceptionError, "配置文件不存在: #{@config_file}" unless File.exist?(@config_file)
+          @config_json = JSON.parse(File.read(@config_file))
+        else
+          raise ExceptionError, "必须提供配置文件路径或配置对象"
+        end
 
         @baseurl = @config_json["pgyerapps_base_url"]
         @request_config = @config_json["api_path_config"]

data/lib/jpsclient/api/design.rb

@@ -0,0 +1,123 @@
+module JPSClient
+  module API
+    # Design 相关 API
+    # 处理应用设计相关接口
+    module Design
+
+      # 导入设计
+      #
+      # @param params [Hash] 导入参数
+      # @return [Hash] API响应
+      def import_design(params: {})
+        config = @request_config && @request_config["design_import"]
+        raise JPSClient::ExceptionError, "Missing config for design_import" unless config && config["url"]
+
+        path = config["url"]
+
+        response = @http_client.post(path, body: params)
+        result = JPSClient::Response.new(response)
+
+        if result.need_login?
+          do_login(force_login: true)
+          response = @http_client.post(path, body: params)
+          result = JPSClient::Response.new(response)
+        end
+
+        return result.to_h
+      end
+
+      # 检查设计
+      #
+      # @param params [Hash] 检查参数
+      # @return [Hash] API响应
+      def check_design(params: {})
+        config = @request_config && @request_config["design_check"]
+        raise JPSClient::ExceptionError, "Missing config for design_check" unless config && config["url"]
+
+        path = config["url"]
+
+        response = @http_client.post(path, body: params)
+        result = JPSClient::Response.new(response)
+
+        if result.need_login?
+          do_login(force_login: true)
+          response = @http_client.post(path, body: params)
+          result = JPSClient::Response.new(response)
+        end
+
+        return result.to_h
+      end
+
+      # 获取分类下的设计稿列表
+      #
+      # @param params [Hash] 请求参数
+      # @return [Hash] API响应
+      def get_category_designs(params: {})
+        config = @request_config && @request_config["design_category_designs"]
+        raise JPSClient::ExceptionError, "Missing config for design_category_designs" unless config && config["url"]
+
+        path = config["url"]
+
+        response = @http_client.post(path, body: params)
+        result = JPSClient::Response.new(response)
+
+        if result.need_login?
+          do_login(force_login: true)
+          response = @http_client.post(path, body: params)
+          result = JPSClient::Response.new(response)
+        end
+
+        return result.to_h
+      end
+
+      # 获取应用设计稿版本列表
+      #
+      # @param app_id [String, Integer] 应用ID（必需）
+      # @param params [Hash] 其他参数（可选）
+      # @return [Hash] API响应
+      def get_app_design_versions(app_id:, params: {})
+        config = @request_config && @request_config["design_app_versions"]
+        raise JPSClient::ExceptionError, "Missing config for design_app_versions" unless config && config["url"]
+
+        path = config["url"]
+        body = params.merge(app_id: app_id)
+
+        response = @http_client.post(path, body: body)
+        result = JPSClient::Response.new(response)
+
+        if result.need_login?
+          do_login(force_login: true)
+          response = @http_client.post(path, body: body)
+          result = JPSClient::Response.new(response)
+        end
+
+        return result.to_h
+      end
+
+      # 获取应用设计稿列表
+      #
+      # @param app_id [String, Integer] 应用ID（必需）
+      # @param params [Hash] 其他参数（可选）
+      # @return [Hash] API响应
+      def get_app_designs(app_id:, params: {})
+        config = @request_config && @request_config["design_app_designs"]
+        raise JPSClient::ExceptionError, "Missing config for design_app_designs" unless config && config["url"]
+
+        path = config["url"]
+        body = params.merge(app_id: app_id)
+
+        response = @http_client.post(path, body: body)
+        result = JPSClient::Response.new(response)
+
+        if result.need_login?
+          do_login(force_login: true)
+          response = @http_client.post(path, body: body)
+          result = JPSClient::Response.new(response)
+        end
+
+        return result.to_h
+      end
+
+    end
+  end
+end