jpsclient 2.4.1 → 2.7.0

data/lib/jpsclient/api/material.rb

@@ -0,0 +1,353 @@
+module JPSClient
+  module API
+    # Material 相关 API
+    # 素材库 v2 接口 (/api/v2/material)，涵盖素材管理、素材配置管理、分区管理三组
+    module Material
+
+      # ==================== 素材管理 ====================
+
+      # 创建素材
+      #
+      # @param params [Hash] MaterialCreateDto: name, description, priorityRule,
+      #   sourceType, sourceId, tagIds, items, categoryId*, instanceId*, flowId*, stateId*, screenId*
+      # @return [Hash] API响应
+      def create_material(params: {})
+        config = @request_config && @request_config["material_create"]
+        raise JPSClient::ExceptionError, "Missing config for material_create" unless config && config["url"]
+
+        path = config["url"]
+
+        return request_with_auth(:post, path, body: params)
+      end
+
+      # 更新素材
+      #
+      # @param params [Hash] MaterialUpdateDto: materialId*, name, description,
+      #   priorityRule, sourceType, sourceId, tagIds, items(全量快照)
+      # @return [Hash] API响应
+      def update_material(params: {})
+        config = @request_config && @request_config["material_update"]
+        raise JPSClient::ExceptionError, "Missing config for material_update" unless config && config["url"]
+
+        path = config["url"]
+
+        return request_with_auth(:post, path, body: params)
+      end
+
+      # 删除素材（软删除，同步软删其下 item、partition）
+      #
+      # @param params [Hash] MaterialDeleteDto: id*
+      # @return [Hash] API响应
+      def delete_material(params: {})
+        config = @request_config && @request_config["material_delete"]
+        raise JPSClient::ExceptionError, "Missing config for material_delete" unless config && config["url"]
+
+        path = config["url"]
+
+        return request_with_auth(:post, path, body: params)
+      end
+
+      # 复制或迁移素材内容（兼容旧 material/copy_or_trans 语义）
+      #
+      # @param params [Hash] 传 materialId 更新现有素材，不传则按条件定位或新建目标素材
+      # @return [Hash] API响应
+      def copy_or_trans(params: {})
+        config = @request_config && @request_config["material_copy_or_trans"]
+        raise JPSClient::ExceptionError, "Missing config for material_copy_or_trans" unless config && config["url"]
+
+        path = config["url"]
+
+        return request_with_auth(:post, path, body: params)
+      end
+
+      # 批量导入素材（兼容旧 material/zip 语义，按 zip 内目录名匹配分类）
+      #
+      # @param params [Hash] MaterialCreateByZipDto: zipUrl*, applicationId*, platform*, flowId*, stateId*, screenId*
+      # @return [Hash] API响应
+      def create_by_zip(params: {})
+        config = @request_config && @request_config["material_batch_create"]
+        raise JPSClient::ExceptionError, "Missing config for material_batch_create" unless config && config["url"]
+
+        path = config["url"]
+
+        return request_with_auth(:post, path, body: params)
+      end
+
+      # 素材库素材列表
+      #
+      # @param params [Hash] categoryIds, platforms, unifiedAppIds, materialTagIds,
+      #   itemTagIds, itemTitles, onlyCollected, keywords, createUserId, updateUserId,
+      #   excludeCreateUserId, excludeUpdateUserId, pageNo, pageSize
+      # @return [Hash] API响应
+      def get_material_list(params: {})
+        config = @request_config && @request_config["material_list"]
+        raise JPSClient::ExceptionError, "Missing config for material_list" unless config && config["url"]
+
+        path = config["url"]
+
+        return request_with_auth(:get, path, params: params)
+      end
+
+      # 应用详情素材列表（每个分类返回最新一条素材及其 items、分类下素材数量）
+      #
+      # @param params [Hash] sourceId*, categoryId, categoryIds, platforms, unifiedAppIds,
+      #   materialTagIds, itemTagIds, itemTitles, onlyCollected, keywords,
+      #   createUserId, updateUserId, excludeCreateUserId, excludeUpdateUserId, pageNo, pageSize
+      # @return [Hash] API响应
+      def get_list_by_source(params: {})
+        config = @request_config && @request_config["material_list_by_source"]
+        raise JPSClient::ExceptionError, "Missing config for material_list_by_source" unless config && config["url"]
+
+        path = config["url"]
+
+        return request_with_auth(:get, path, params: params)
+      end
+
+      # 分类素材详情（返回该分类下全部素材记录）
+      #
+      # @param params [Hash] categoryId*, materialTagIds, itemTagIds, itemTitles, keywords
+      # @return [Hash] API响应
+      def get_detail_by_category(params: {})
+        config = @request_config && @request_config["material_detail_by_category"]
+        raise JPSClient::ExceptionError, "Missing config for material_detail_by_category" unless config && config["url"]
+
+        path = config["url"]
+
+        return request_with_auth(:get, path, params: params)
+      end
+
+      # ==================== 素材配置管理 ====================
+
+      # 创建素材配置（按 scopeType 创建 instance/flow/state/screen）
+      #
+      # @param params [Hash] MaterialConfigCreateDto: scopeType*, name*, categoryId,
+      #   lang, appVersion, device, identity, bizKey, description, flowType, note, groupName, weight
+      # @return [Hash] API响应
+      def create_material_config(params: {})
+        config = @request_config && @request_config["material_config_create"]
+        raise JPSClient::ExceptionError, "Missing config for material_config_create" unless config && config["url"]
+
+        path = config["url"]
+
+        return request_with_auth(:post, path, body: params)
+      end
+
+      # 更新素材配置（按 scopeType + id 更新，仅非空字段参与更新）
+      #
+      # @param params [Hash] MaterialConfigUpdateDto: scopeType*, id*, categoryId, name,
+      #   lang, appVersion, device, identity, bizKey, description, flowType, note, groupName, weight
+      # @return [Hash] API响应
+      def update_material_config(params: {})
+        config = @request_config && @request_config["material_config_update"]
+        raise JPSClient::ExceptionError, "Missing config for material_config_update" unless config && config["url"]
+
+        path = config["url"]
+
+        return request_with_auth(:post, path, body: params)
+      end
+
+      # 删除素材配置（软删除指定 scopeType + id）
+      #
+      # @param params [Hash] MaterialConfigDeleteDto: scopeType*, id*
+      # @return [Hash] API响应
+      def delete_material_config(params: {})
+        config = @request_config && @request_config["material_config_delete"]
+        raise JPSClient::ExceptionError, "Missing config for material_config_delete" unless config && config["url"]
+
+        path = config["url"]
+
+        return request_with_auth(:post, path, body: params)
+      end
+
+      # 绑定分类可用配置（维护分类可用的 flow/state/screen 列表）
+      #
+      # @param params [Hash] MaterialCategoryScopeBindDto: categoryId*, scopeType*, scopeIds*
+      # @return [Hash] API响应
+      def bind_material_config(params: {})
+        config = @request_config && @request_config["material_config_bind"]
+        raise JPSClient::ExceptionError, "Missing config for material_config_bind" unless config && config["url"]
+
+        path = config["url"]
+
+        return request_with_auth(:post, path, body: params)
+      end
+
+      # 查询分类可用配置（instances、flows、states、screens）
+      #
+      # @param params [Hash] categoryId*, includeInherited
+      # @return [Hash] API响应
+      def get_material_config_options(params: {})
+        config = @request_config && @request_config["material_config_options"]
+        raise JPSClient::ExceptionError, "Missing config for material_config_options" unless config && config["url"]
+
+        path = config["url"]
+
+        return request_with_auth(:get, path, params: params)
+      end
+
+      # ==================== 素材分区管理 ====================
+
+      # 创建素材分区（在指定素材下创建分区）
+      #
+      # @param params [Hash] MaterialPartitionCreateDto: materialId*, name*, color, weight
+      # @return [Hash] API响应
+      def create_material_partition(params: {})
+        config = @request_config && @request_config["material_partition_create"]
+        raise JPSClient::ExceptionError, "Missing config for material_partition_create" unless config && config["url"]
+
+        path = config["url"]
+
+        return request_with_auth(:post, path, body: params)
+      end
+
+      # 更新素材分区（仅非空字段参与更新）
+      #
+      # @param params [Hash] MaterialPartitionUpdateDto: id*, name, color, weight
+      # @return [Hash] API响应
+      def update_material_partition(params: {})
+        config = @request_config && @request_config["material_partition_update"]
+        raise JPSClient::ExceptionError, "Missing config for material_partition_update" unless config && config["url"]
+
+        path = config["url"]
+
+        return request_with_auth(:post, path, body: params)
+      end
+
+      # 删除素材分区（软删除，删除前把分区下未删 item 的 partitionId 置空）
+      #
+      # @param params [Hash] MaterialPartitionDeleteDto: id*
+      # @return [Hash] API响应
+      def delete_material_partition(params: {})
+        config = @request_config && @request_config["material_partition_delete"]
+        raise JPSClient::ExceptionError, "Missing config for material_partition_delete" unless config && config["url"]
+
+        path = config["url"]
+
+        return request_with_auth(:post, path, body: params)
+      end
+
+      # ==================== 旧版素材接口 (/api/material，material-controller) ====================
+      # 与上方 v2 接口并存；别名统一 material_v1_ 前缀，方法名对与 v2 同名者加 _v1 后缀
+
+      # 新增素材（旧版）
+      #
+      # @param params [Hash] ResourceCreateDto: elementType*, content, sourceType*, sourceId*,
+      #   name, categoryId*, partition, version, status, publishTime
+      # @return [Hash] API响应
+      def create_material_v1(params: {})
+        config = @request_config && @request_config["material_v1_create"]
+        raise JPSClient::ExceptionError, "Missing config for material_v1_create" unless config && config["url"]
+
+        path = config["url"]
+
+        return request_with_auth(:post, path, body: params)
+      end
+
+      # 更新素材（旧版）
+      #
+      # @param params [Hash] ResourceUpdateDto: id*, content, name, categoryId, partition,
+      #   version, status, publishTime, tagList, elementType
+      # @return [Hash] API响应
+      def update_material_v1(params: {})
+        config = @request_config && @request_config["material_v1_update"]
+        raise JPSClient::ExceptionError, "Missing config for material_v1_update" unless config && config["url"]
+
+        path = config["url"]
+
+        return request_with_auth(:post, path, body: params)
+      end
+
+      # 删除素材（旧版）
+      #
+      # @param params [Hash] BaseIdDtoInteger: id*
+      # @return [Hash] API响应
+      def delete_material_v1(params: {})
+        config = @request_config && @request_config["material_v1_delete"]
+        raise JPSClient::ExceptionError, "Missing config for material_v1_delete" unless config && config["url"]
+
+        path = config["url"]
+
+        return request_with_auth(:post, path, body: params)
+      end
+
+      # 移动或者复制素材（旧版）
+      #
+      # @param params [Array] 数组，每项含 sourceId, targetId, type, elementType, content 等（前端实际传数组体）
+      # @return [Hash] API响应
+      def copy_or_trans_v1(params: [])
+        config = @request_config && @request_config["material_v1_copy_or_trans"]
+        raise JPSClient::ExceptionError, "Missing config for material_v1_copy_or_trans" unless config && config["url"]
+
+        path = config["url"]
+
+        return request_with_auth(:post, path, body: params)
+      end
+
+      # 批量新增素材，不支持创建素材版本（旧版）
+      #
+      # @param params [Hash] ResourceCreateByZipDto: zipUrl*, sourceType*, sourceId*, platform*, resourceType
+      # @return [Hash] API响应
+      def create_by_zip_v1(params: {})
+        config = @request_config && @request_config["material_v1_zip"]
+        raise JPSClient::ExceptionError, "Missing config for material_v1_zip" unless config && config["url"]
+
+        path = config["url"]
+
+        return request_with_auth(:post, path, body: params)
+      end
+
+      # 素材库下发素材列表（旧版）
+      #
+      # @param params [Hash] ResourceSearchDto: page, pageSize, elementType, categoryId,
+      #   keyword, sourceType, sourceId 等
+      # @return [Hash] API响应
+      def get_material_list_v1(params: {})
+        config = @request_config && @request_config["material_v1_list"]
+        raise JPSClient::ExceptionError, "Missing config for material_v1_list" unless config && config["url"]
+
+        path = config["url"]
+
+        return request_with_auth(:get, path, params: params)
+      end
+
+      # 应用详情下发素材列表（旧版）
+      #
+      # @param params [Hash] ResourceByTypeDto: sourceId*, resourceType 等
+      # @return [Hash] API响应
+      def get_list_by_source_v1(params: {})
+        config = @request_config && @request_config["material_v1_list_by_source"]
+        raise JPSClient::ExceptionError, "Missing config for material_v1_list_by_source" unless config && config["url"]
+
+        path = config["url"]
+
+        return request_with_auth(:get, path, params: params)
+      end
+
+      # 应用详情素材视频/图片信息（旧版，v2 无对应端点）
+      #
+      # @param params [Hash] sourceId
+      # @return [Hash] API响应
+      def get_medias_by_source(params: {})
+        config = @request_config && @request_config["material_v1_medias_by_source"]
+        raise JPSClient::ExceptionError, "Missing config for material_v1_medias_by_source" unless config && config["url"]
+
+        path = config["url"]
+
+        return request_with_auth(:get, path, params: params)
+      end
+
+      # 应用详情素材相关统计信息（旧版，v2 无对应端点）
+      #
+      # @param params [Hash] sourceId
+      # @return [Hash] API响应
+      def get_summary_by_source(params: {})
+        config = @request_config && @request_config["material_v1_summary_by_source"]
+        raise JPSClient::ExceptionError, "Missing config for material_v1_summary_by_source" unless config && config["url"]
+
+        path = config["url"]
+
+        return request_with_auth(:get, path, params: params)
+      end
+    end
+  end
+end

data/lib/jpsclient/api/project_package.rb

@@ -61,7 +61,7 @@ module JPSClient
       # @option params [String] :projectPackageId 项目包ID
       # @return [Hash] API响应
       def upload_nuget_package(projectId:nil, params:nil)
-        puts "========1111 upload_nuget_package"  if ENV['PINDO_DEBUG']
+        puts "========1111 upload_nuget_package"  if JPSClient.debug?
         config = @request_config && @request_config["project_package_upload_nuget"]
         raise JPSClient::ExceptionError, "Missing config for project_package_upload_nuget" unless config && config["url"]
         path = config["url"]
@@ -86,7 +86,7 @@ module JPSClient
         # 移除值为nil的键
         body_params.compact!
 
-        if ENV['PINDO_DEBUG']
+        if JPSClient.debug?
           puts "[DEBUG]upload_nuget_package  upload_nuget_package 请求详情:"
           puts "[DEBUG]upload_nuget_package    URL: #{path}"
           puts "[DEBUG]upload_nuget_package    请求体:"