jpsclient 2.7.1 → 2.7.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 48dd1ae1aaa5dc5113053a1518852757e21f1093e6cc0f78af67a233fa99816c
-  data.tar.gz: 45d7e50bdba93716069834434e6fcc312f47ec1cb65f762c33151245507fc90d
+  metadata.gz: 7e190dad3a9fb10f985ea2536b22c03de35927a45bb26a45ce6ce4e49a87b13d
+  data.tar.gz: c7a7c41fab362a5f0bfdddbac0e0a4a75de2ded745a601787dd9a98e34e046df
 SHA512:
-  metadata.gz: 5e52ac2b47c2933708800e6a36059853638d464f5927c64037e7153c9abf39bcad5b7c19d9ee43a9075bf2e5dc88d05e3978cc760e1e402882a0eea2697a7ca6
-  data.tar.gz: ac94b28dbce9ab2622acbc1ba2a1d11e2306cf842c6afc565149f8a146d0ffa2536cece93a26471ee85afc629fa3e597f3e8e84ce7a62a19b5cbe3acb2f392e9
+  metadata.gz: f4ef3da2ea5cc2c413213722d2d529a1f93ed334d1739d817d8eadc2faa5945c8783737f6200095e315f227456c7b2fe0d341a0262e9a9facba32ca671824ae0
+  data.tar.gz: 75a7071f7117f8e15a7b4cca95dbd88dfaf1a116513b735b301e6a23bccd1c75535ae6313f52f96191fb2c3971f8a6399a3c379b8f802cc5e3eb3842c571c09b

data/lib/jpsclient/api/commit_log.rb

@@ -27,18 +27,21 @@ module JPSClient
         return request_with_auth(:post, path, body: body_params)
       end
 
-      # 发送提交记录消息通知
+      # 发送提交记录消息通知（commit_log/send_message）
+      #
+      # 以线上真实请求为准：接口文档可能滞后。
       #
       # @param projectId [String] 项目ID（必需）
       # @param workflowId [Integer] 工作流ID（必需）
       # @param params [Hash] 其他参数
-      # @option params [Boolean] :single 是否单个提交（默认 true）
-      # @option params [Array<String>, String] :branches 分支名称数组，服务端 CommitLogSendMessageDto 的字段
-      # @option params [String] :branch 分支名称（单数形式，调用方便利写法，内部归一化为 branches）
-      # @option params [Array<String>] :commitIds 提交ID数组
-      # @option params [Integer] :startTimestamp 开始时间戳
-      # @option params [Integer] :endTimestamp 结束时间戳
-      # @option params [Integer] :indexNo 索引号
+      # @option params [Boolean] :single 是否单条提交发送（默认 true）
+      # @option params [Array<Integer>] :ids commit_log 记录 ID 集合
+      # @option params [String] :branch 分支名称，空字符串也需要原样发送
+      # @option params [Array<String>] :commitIds 提交ID集合，single=true 时必传（取第一个）
+      # @option params [Integer] :startTimestamp 提交时间下界（epoch 毫秒，闭区间，仅 single=false）
+      # @option params [Integer] :endTimestamp 提交时间上界（epoch 毫秒，开区间，仅 single=false）
+      # @option params [Integer] :indexNo 项目包索引号
+      # @option params [Array<String>] :repoTypes 仓库类型过滤（仅 single=false）
       # @return [Hash] API响应
       def send_commit_log_message(projectId:, workflowId:, params: {})
         config = @request_config && @request_config["commit_log_send_message"]
@@ -51,16 +54,13 @@ module JPSClient
           single: params.fetch(:single, true)
         }
 
-        # 添加可选参数
-        # 服务端 CommitLogSendMessageDto 只有 branches 数组字段，branch 单数会被直接丢弃，
-        # 因此单数写法在这里归一化为数组，不再原样透传
-        branches = params[:branches] || params[:branch]
-        body_params[:branches] = Array(branches).compact if branches
-
+        body_params[:ids] = params[:ids] if params[:ids]
         body_params[:commitIds] = params[:commitIds] if params[:commitIds]
+        body_params[:branch] = params[:branch] if params.key?(:branch)
         body_params[:startTimestamp] = params[:startTimestamp] if params[:startTimestamp]
         body_params[:endTimestamp] = params[:endTimestamp] if params[:endTimestamp]
         body_params[:indexNo] = params[:indexNo] if params[:indexNo]
+        body_params[:repoTypes] = params[:repoTypes] if params[:repoTypes]
 
         return request_with_auth(:post, path, body: body_params)
       end

data/lib/jpsclient/http/http_client.rb

@@ -236,6 +236,10 @@ end
 module JPSClient
   # JPS API 响应封装类 - 简化版
   class Response
+    # 登录 token 失效的业务码。调用方需要按它区分「认证失败」和「网络/服务端故障」，
+    # 提成常量避免各处硬编码
+    NEED_LOGIN_CODE = '20001'.freeze
+
     attr_reader :code
     attr_reader :data
     attr_reader :msg
@@ -269,7 +273,7 @@ module JPSClient
 
     # 20001: 登录token失效
     def need_login?
-      @need_login || @code.to_s == '20001'
+      @need_login || @code.to_s == NEED_LOGIN_CODE
     end
 
     # 20011: 没有权限访问项目

data/lib/jpsclient/upload/upload_client.rb

@@ -6,6 +6,7 @@ require 'digest'
 require 'cgi'
 require 'uri'
 require 'jpsclient/base/exception'
+require 'jpsclient/http/http_client'
 require 'jpsclient/upload/upload_config'
 require 'jpsclient/upload/upload_progress'
 require 'jpsclient/utils/logger'
@@ -98,7 +99,7 @@ module JPSClient
           end
 
           if init_result.nil? || !init_result.dig("data", "upload_id")
-              raise ExceptionError, "初始化上传失败，请检查网络或服务器状态"
+              raise ExceptionError, init_multipart_error_message(init_result)
           end
 
           upload_id = init_result["data"]["upload_id"]
@@ -169,6 +170,35 @@ module JPSClient
 
       end
 
+      # 拼装初始化上传失败的错误信息
+      #
+      # 真实原因写在接口返回的 code / msg 里（例如 20001 登录态失效），
+      # 一律报「请检查网络或服务器状态」会把认证问题误导成网络问题；
+      # 而原始响应此前只在 JPSClient.debug? 下打印，排查时通常拿不到。
+      #
+      # @param init_result [Hash, nil] init_file_multipart 的原始返回
+      # @return [String] 带上真实原因的错误信息
+      def init_multipart_error_message(init_result)
+        return "初始化上传失败：接口无响应，请检查网络或服务器状态" if init_result.nil?
+
+        code = init_result["code"]
+        msg = init_result["msg"] || init_result["message"]
+
+        # request_with_auth 遇到 20001 会自动重新登录并重试一次，
+        # 这里仍拿到 20001 说明重登也没成功，需要用户手动重新登录
+        if code.to_s == Response::NEED_LOGIN_CODE
+          detail = msg.to_s.empty? ? "code=#{code}" : "code=#{code}，msg=#{msg}"
+          return "初始化上传失败：登录态已失效，且自动重新登录未成功（#{detail}），请重新登录后重试"
+        end
+
+        parts = []
+        parts << "code=#{code}" unless code.nil?
+        parts << "msg=#{msg}" unless msg.to_s.empty?
+        parts << "响应中缺少 data.upload_id" if parts.empty?
+
+        "初始化上传失败（#{parts.join("，")}），请检查网络或服务器状态"
+      end
+
       # 安全地检查上传失败状态
       def upload_failed?
         @upload_failed_mutex.synchronize { @upload_failed }

data/lib/jpsclient/version.rb

@@ -1,3 +1,3 @@
 module JPSClient
-  VERSION = '2.7.1'
+  VERSION = '2.7.3'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jpsclient
 version: !ruby/object:Gem::Version
-  version: 2.7.1
+  version: 2.7.3
 platform: ruby
 authors:
 - Your Name
@@ -296,7 +296,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.11
+rubygems_version: 4.0.10
 specification_version: 4
 summary: JPS Platform API Client with Full API Support
 test_files: []