jpsclient 0.2.0

data/lib/jpsclient/api/modular_client.rb

@@ -0,0 +1,228 @@
+require 'uri'
+require 'json'
+require 'jpsclient/base/exception'
+require 'jpsclient/base/api_config'
+require 'jpsclient/utils/aes'
+require 'jpsclient/http/http_client'
+require 'jpsclient/auth/auth'
+require 'jpsclient/auth/token'
+require 'jpsclient/utils/logger'
+
+module JPSClient
+  # 模块化Client - 支持按需加载指定的API模块组
+  class ModularClient
+    # 模块分组定义
+    MODULE_GROUPS = {
+      # 核心模块 - 项目和文件管理
+      core: %w[project project_package file cert],
+
+      # 应用管理相关
+      application: %w[application application_category application_version application_design
+                      application_income application_sales],
+
+      # 资源管理相关
+      resource: %w[app_resource app_resource_version app_level assets_category
+                   resource_category collection],
+
+      # Bug和工作流
+      workflow: %w[bug workflow commit_log],
+
+      # 用户和权限
+      user: %w[user role login],
+
+      # Lark集成
+      lark: %w[lark_task lark_task_list lark_task_section lark_user
+               lark_wiki_node lark_wiki_space lark_chat_group lark_comment lark_bitable],
+
+      # 创意和设计
+      creative: %w[creative idea sketch sketch_category experience experience_category],
+
+      # 发布商相关
+      publisher: %w[publisher publisher_category publisher_group publisher_group_category],
+
+      # 需求和调研
+      requirements: %w[requirements requirements_category survey survey_category],
+
+      # 工具和实用
+      utility: %w[tool tool_category util simple_search menu tag],
+
+      # 统计和分析
+      analytics: %w[statistics trending sov],
+
+      # 媒体相关
+      media: %w[video_cover icon_and_snapshot m3u8 document_text],
+
+      # 其他
+      misc: %w[store webhook healthy custom_application custom_application_web
+               apple_account ud_id jssdk fgui_export game_assets collect]
+    }.freeze
+
+    attr_accessor :token, :baseurl, :request_config, :http_client, :api_config
+    attr_reader :config_json, :config_file, :loaded_groups, :loaded_modules
+
+    def initialize(config_file:, load_groups: [:core])
+      begin
+        @config_file = config_file
+        @loaded_groups = []
+        @loaded_modules = []
+
+        raise ExceptionError, "必须提供配置文件路径" unless @config_file
+        raise ExceptionError, "配置文件不存在: #{@config_file}" unless File.exist?(@config_file)
+
+        @config_json = JSON.parse(File.read(@config_file))
+        @baseurl = @config_json["pgyerapps_base_url"]
+        @request_config = @config_json["api_path_config"]
+
+        # 初始化API配置管理器
+        @api_config = ApiConfig.new(@config_json)
+
+        # 从 auth_config 获取配置
+        auth_config = @config_json["auth_config"]
+        @pgyer_aes_key = auth_config["aes_key"]
+
+        # 加载 JPS 登录配置
+        @jps_config = LoginConfig.from_json(auth_config)
+
+        # 初始化 token 管理器
+        @token_manager = Token.new(@jps_config)
+
+        # 尝试加载已保存的 token
+        if @token_manager.load && @token_manager.valid?
+          @token = @token_manager.to_h
+        end
+
+        # 初始化共享的 HTTP 客户端
+        @http_client = HttpClient.new(base_url: @baseurl)
+        @http_client.update_token(@token["token"]) if @token && @token["token"]
+
+        # 加载指定的模块组
+        Array(load_groups).each { |group| load_group(group) }
+
+      rescue JSON::ParserError => error
+        raise ExceptionError.new("配置文件格式错误 (#{@config_file}): #{error.message}")
+      rescue ExceptionError
+        raise  # 重新抛出 JPS 异常
+      rescue => error
+        raise ExceptionError.new("加载配置文件失败 (#{@config_file}): #{error.message}")
+      end
+    end
+
+    # 加载指定的模块组
+    def load_group(group_name)
+      group_name = group_name.to_sym
+      return if @loaded_groups.include?(group_name)
+
+      modules = MODULE_GROUPS[group_name]
+      unless modules
+        puts "警告: 未知的模块组 '#{group_name}'"
+        puts "可用的模块组: #{MODULE_GROUPS.keys.join(', ')}"
+        return
+      end
+
+      modules.each do |module_name|
+        load_module(module_name)
+      end
+
+      @loaded_groups << group_name
+      puts "已加载模块组: #{group_name} (#{modules.size}个模块)"
+    end
+
+    # 加载单个模块
+    def load_module(module_name)
+      return if @loaded_modules.include?(module_name)
+
+      begin
+        require "jpsclient/api/#{module_name}"
+
+        # 将模块名转换为类名
+        class_name = module_name.split('_').map(&:capitalize).join
+
+        # Include模块
+        if API.const_defined?(class_name)
+          self.class.send(:include, API.const_get(class_name))
+          @loaded_modules << module_name
+        end
+      rescue LoadError => e
+        puts "警告: 无法加载模块 #{module_name}: #{e.message}"
+      end
+    end
+
+    # 提供共享的HTTP客户端给其他模块
+    def shared_http_client
+      @http_client
+    end
+
+    # 打印加载状态
+    def print_status
+      puts "=" * 60
+      puts "ModularClient 加载状态"
+      puts "=" * 60
+      puts "已加载的模块组: #{@loaded_groups.join(', ')}"
+      puts "已加载的模块数: #{@loaded_modules.size}"
+      puts "可用的方法示例:"
+
+      # 显示一些可用的方法
+      sample_methods = self.methods(false).select { |m|
+        m.to_s.start_with?('get_', 'create_', 'update_', 'delete_')
+      }.first(10)
+
+      sample_methods.each { |m| puts "  - #{m}" }
+      puts "  ..." if self.methods(false).size > 10
+    end
+
+    # 核心登录功能
+    def do_login(force_login: false)
+      # 使用 token 管理器统一处理
+      if force_login
+        # 强制重新登录
+        @token_manager.clear  # 清除旧 token
+        auth = Auth.new(@jps_config)
+        result = auth.login
+
+        if result == :user_cancelled
+          Logger.instance.fancyinfo_error("用户取消了登录操作")
+          return false
+        elsif result == true
+          # 保存新 token
+          @token_manager.save(auth.access_token, auth.username, auth.expires_at)
+          update_token_everywhere()
+          return true
+        else
+          Logger.instance.fancyinfo_error("登录失败，未能获取有效token")
+          return false
+        end
+      else
+        # 尝试加载并验证现有 token
+        if @token_manager.load && @token_manager.valid?
+          update_token_everywhere()
+          return true
+        else
+          # Token 无效或不存在，需要重新登录
+          auth = Auth.new(@jps_config)
+          result = auth.login
+
+          if result == :user_cancelled
+            Logger.instance.fancyinfo_error("用户取消了登录操作")
+            return false
+          elsif result == true
+            # 保存新 token
+            @token_manager.save(auth.access_token, auth.username, auth.expires_at)
+            update_token_everywhere()
+            return true
+          else
+            Logger.instance.fancyinfo_error("登录失败，未能获取有效token")
+            return false
+          end
+        end
+      end
+    end
+
+    private
+
+    # 统一更新token到所有组件
+    def update_token_everywhere
+      @token = @token_manager.to_h
+      @http_client.update_token(@token["token"]) if @http_client && @token
+    end
+  end
+end

data/lib/jpsclient/api/project.rb

@@ -0,0 +1,46 @@
+module JPSClient
+  module API
+    # 项目相关 API
+    # 处理 /api/project/* 路径的所有接口
+    module Project
+
+      # 获取项目列表
+      # @param params [Hash] 查询参数
+      # @return [Hash] 响应数据
+      def get_project_list(params:nil)
+        path = @request_config["project_list"]["url"]
+
+        get_params = {
+        orderByColumn: "update_time",
+        sort: "DESC",
+        pageNo: 1,
+        pageSize: 40,
+        }
+
+        params.each { |key,value| get_params[key] = value } if params
+
+        response = @http_client.get(path, params: get_params)
+        result = JPSClient::Response.new(response)
+
+        # 处理 401 错误，自动重新登录
+        if result.need_login?
+          do_login(force_login: true)
+          # 重试请求
+          response = @http_client.get(path, params: get_params)
+          result = JPSClient::Response.new(response)
+        end
+
+        # 处理响应数据格式
+        response_data = result.to_h
+        if response_data && response_data['data'] && response_data['data']['projects']
+          # 新的API格式：返回 projects 数组
+          response_data['data'] = response_data['data']['projects']
+        end
+
+        return response_data
+      end
+
+
+    end
+  end
+end

data/lib/jpsclient/api/project_package.rb

@@ -0,0 +1,249 @@
+module JPSClient
+  module API
+    # 项目包管理相关 API
+    # 处理 /api/project_package/* 路径的所有接口
+    #
+    # 支持的功能：
+    # - 上传项目包
+    # - 获取项目包列表
+    # - 更新项目包信息
+    # - 签名项目包
+    # - 发送项目包消息通知
+    # - 绑定提交记录
+    # - 预览项目包
+    # - 获取绑定列表
+    module ProjectPackage
+
+      # 上传项目包
+      def upload_project_package(projectId:nil, params:nil)
+        config = @request_config && @request_config["project_package_upload"]
+        raise JPSClient::ExceptionError, "Missing config for project_package_upload" unless config && config["url"]
+        path = config["url"]
+
+        body_params = {
+        projectId: projectId
+        }
+
+        # 合并传入的参数
+        if params
+          params.each { |key,value| body_params[key] = value }
+        end
+
+        # 确保必要的字段存在
+        body_params[:packageUrl] ||= params&.dig(:packageUrl)
+        body_params[:description] ||= params&.dig(:description)
+        body_params[:attachFileUrls] ||= params&.dig(:attachFileUrls) || []
+        body_params[:chatEnv] ||= params&.dig(:chatEnv)
+        body_params[:commitId] ||= params&.dig(:commitId)
+        body_params[:projectPackageId] ||= params&.dig(:projectPackageId)
+
+        # 移除值为nil的键
+        body_params.compact!
+
+        response = @http_client.post(path, body: body_params)
+        result = JPSClient::Response.new(response)
+
+        # 处理 401 错误，自动重新登录
+        if result.need_login?
+          do_login(force_login: true)
+          # 重试请求
+          response = @http_client.post(path, body: body_params)
+          result = JPSClient::Response.new(response)
+        end
+
+        return result.to_h
+      end
+
+      # 获取项目包列表
+      def get_project_package_list(projectId:nil, params:nil)
+        params = {} if params.nil?
+        config = @request_config && @request_config["project_package_list"]
+        raise JPSClient::ExceptionError, "Missing config for project_package_list" unless config && config["url"]
+        path = config["url"]
+
+        get_params = {
+        projectId: projectId,
+        pageNo: params[:pageNo] || 1,
+        pageSize: params[:pageSize] || 20,
+        }
+
+        # 添加可选的筛选参数
+        get_params[:uploadBy] = params[:uploadBy] if params[:uploadBy]
+        get_params[:nativePackageType] = params[:nativePackageType] if params[:nativePackageType]
+        get_params[:startTimestamp] = params[:startTimestamp] if params[:startTimestamp]
+        get_params[:endTimestamp] = params[:endTimestamp] if params[:endTimestamp]
+
+        response = @http_client.get(path, params: get_params)
+        result = JPSClient::Response.new(response)
+
+        # 处理响应数据格式
+        response_data = result.to_h
+        if response_data && response_data['data'] && response_data['data']['packages']
+          # 新的API格式：返回 packages 数组
+          response_data['data'] = response_data['data']['packages']
+        end
+
+        return response_data
+      end
+
+      # 更新项目包信息（备注等）
+      def update_project_package(id:, description:nil)
+        config = @request_config && @request_config["project_package_update"]
+        raise JPSClient::ExceptionError, "Missing config for project_package_update" unless config && config["url"]
+        path = config["url"]
+
+        body_params = {
+        id: id,
+        description: description
+        }.compact # 移除nil值
+
+        response = @http_client.post(path, body: body_params)
+        result = JPSClient::Response.new(response)
+
+        # 处理 401 错误，自动重新登录
+        if result.need_login?
+          do_login(force_login: true)
+          # 重试请求
+          response = @http_client.post(path, body: body_params)
+          result = JPSClient::Response.new(response)
+        end
+
+        return result.to_h
+      end
+
+      # 签名项目包
+      def sign_project_package(packageId:nil, certId:nil)
+        config = @request_config && @request_config["project_package_sign"]
+        raise JPSClient::ExceptionError, "Missing config for project_package_sign" unless config && config["url"]
+        path = config["url"]
+
+        body_params = {
+        projectPackageId: packageId,  # 根据文档使用 projectPackageId
+        certId: certId
+        }
+
+        response = @http_client.post(path, body: body_params)
+        result = JPSClient::Response.new(response)
+
+        # 处理 401 错误，自动重新登录
+        if result.need_login?
+          do_login(force_login: true)
+          # 重试请求
+          response = @http_client.post(path, body: body_params)
+          result = JPSClient::Response.new(response)
+        end
+
+        return result.to_h
+      end
+
+      # 发送项目包消息
+      def send_project_package_message(projectId:nil, packageId:nil, chatEnv: nil, receiveType:nil, indexNo:nil)
+        config = @request_config && @request_config["project_package_send_message"]
+        raise JPSClient::ExceptionError, "Missing config for project_package_send_message" unless config && config["url"]
+        path = config["url"]
+
+        body_params = {
+        receiveType: receiveType,
+        projectId: projectId,
+        projectPackageId: packageId,
+        chatEnv: chatEnv
+        }
+
+        # 添加可选参数
+        body_params[:indexNo] = indexNo if indexNo
+
+        response = @http_client.post(path, body: body_params)
+        result = JPSClient::Response.new(response)
+
+        # 处理 401 错误，自动重新登录
+        if result.need_login?
+          do_login(force_login: true)
+          # 重试请求
+          response = @http_client.post(path, body: body_params)
+          result = JPSClient::Response.new(response)
+        end
+
+        return result.to_h
+      end
+
+      # 绑定提交记录到项目包
+      def bind_commit_to_package(commitId:, projectPackageIds:)
+        config = @request_config && @request_config["project_package_bind_commit"]
+        raise JPSClient::ExceptionError, "Missing config for project_package_bind_commit" unless config && config["url"]
+        path = config["url"]
+
+        body_params = {
+        commitId: commitId,
+        projectPackageIds: projectPackageIds
+        }
+
+        response = @http_client.post(path, body: body_params)
+        result = JPSClient::Response.new(response)
+
+        # 处理 401 错误，自动重新登录
+        if result.need_login?
+          do_login(force_login: true)
+          # 重试请求
+          response = @http_client.post(path, body: body_params)
+          result = JPSClient::Response.new(response)
+        end
+
+        return result.to_h
+      end
+
+      # 预览项目包
+      def preview_project_package(params:)
+        config = @request_config && @request_config["project_package_preview"]
+        raise JPSClient::ExceptionError, "Missing config for project_package_preview" unless config && config["url"]
+        path = config["url"]
+
+        get_params = {
+        id: params[:id],
+        url: params[:url],
+        packId: params[:packId],
+        packageType: params[:packageType],
+        packageVersion: params[:packageVersion],
+        projectName: params[:projectName]
+        }.compact # 移除nil值
+
+        response = @http_client.get(path, params: get_params)
+        result = JPSClient::Response.new(response)
+
+        # 处理 401 错误，自动重新登录
+        if result.need_login?
+          do_login(force_login: true)
+          # 重试请求
+          response = @http_client.get(path, params: get_params)
+          result = JPSClient::Response.new(response)
+        end
+
+        return result.to_h
+      end
+
+      # 获取项目包绑定列表
+      def get_project_package_bind_list(projectId:)
+        config = @request_config && @request_config["project_package_bind_list"]
+        raise JPSClient::ExceptionError, "Missing config for project_package_bind_list" unless config && config["url"]
+        path = config["url"]
+
+        get_params = {
+        projectId: projectId
+        }
+
+        response = @http_client.get(path, params: get_params)
+        result = JPSClient::Response.new(response)
+
+        # 处理 401 错误，自动重新登录
+        if result.need_login?
+          do_login(force_login: true)
+          # 重试请求
+          response = @http_client.get(path, params: get_params)
+          result = JPSClient::Response.new(response)
+        end
+
+        return result.to_h
+      end
+
+    end
+  end
+end

data/lib/jpsclient/api/publisher.rb

@@ -0,0 +1,165 @@
+module JPSClient
+  module API
+    # Publisher 相关 API
+    # 自动生成的模块，处理 publisher 相关接口
+    module Publisher
+
+      # Update Publisher
+      #
+      # @param params [Hash] 请求参数
+      # @return [Hash] API响应
+      def update_publisher(publisherId:, params: {})
+        config = @request_config && @request_config["publisher_publisher"]
+        raise JPSClient::ExceptionError, "Missing config for publisher_publisher" unless config && config["url"]
+
+        path = config["url"]
+        path = path.gsub("{publisherId}", publisherId.to_s)
+
+        response = @http_client.put(path, body: params)
+        result = JPSClient::Response.new(response)
+
+        if result.need_login?
+          do_login(force_login: true)
+          response = @http_client.put(path, body: params)
+          result = JPSClient::Response.new(response)
+        end
+
+        return result.to_h
+      end
+
+      # Delete Publisher
+      #
+      # @param params [Hash] 请求参数
+      # @return [Hash] API响应
+      def delete_publisher(publisherId:, params: {})
+        config = @request_config && @request_config["publisher_publisher"]
+        raise JPSClient::ExceptionError, "Missing config for publisher_publisher" unless config && config["url"]
+
+        path = config["url"]
+        path = path.gsub("{publisherId}", publisherId.to_s)
+
+        response = @http_client.delete(path)
+        result = JPSClient::Response.new(response)
+
+        if result.need_login?
+          do_login(force_login: true)
+          response = @http_client.delete(path)
+          result = JPSClient::Response.new(response)
+        end
+
+        return result.to_h
+      end
+
+      # Create Publishers
+      #
+      # @param params [Hash] 请求参数
+      # @return [Hash] API响应
+      def create_publishers(params: {})
+        config = @request_config && @request_config["publisher_publishers"]
+        raise JPSClient::ExceptionError, "Missing config for publisher_publishers" 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
+
+      # Create Stream
+      #
+      # @param params [Hash] 请求参数
+      # @return [Hash] API响应
+      def create_stream(params: {})
+        config = @request_config && @request_config["publisher_stream"]
+        raise JPSClient::ExceptionError, "Missing config for publisher_stream" 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
+
+      # Create Weights
+      #
+      # @param params [Hash] 请求参数
+      # @return [Hash] API响应
+      def create_weights(params: {})
+        config = @request_config && @request_config["publisher_weights"]
+        raise JPSClient::ExceptionError, "Missing config for publisher_weights" 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
+
+      # Create Detail
+      #
+      # @param params [Hash] 请求参数
+      # @return [Hash] API响应
+      def create_detail(params: {})
+        config = @request_config && @request_config["publisher_detail"]
+        raise JPSClient::ExceptionError, "Missing config for publisher_detail" 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
+
+      # Get Store Applications Detail
+      #
+      # @param params [Hash] 请求参数
+      # @return [Hash] API响应
+      def get_store_applications_detail(publisherId:, params: {})
+        config = @request_config && @request_config["publisher_store_applications_detail"]
+        raise JPSClient::ExceptionError, "Missing config for publisher_store_applications_detail" unless config && config["url"]
+
+        path = config["url"]
+        path = path.gsub("{publisherId}", publisherId.to_s)
+
+        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
+    end
+  end
+end