@pnt-team/pnt-component-frontend 0.0.138 → 0.0.139

package/lib/cjs/api/cos.d.ts

@@ -0,0 +1,103 @@
+import type { PntHttpLike } from "../config";
+/**
+ * 归一化后的 COS 临时凭证
+ * @description 各后端接口字段命名不统一（snake/camel），组件库内部统一为 camelCase
+ */
+export interface NormalizedCosCredential {
+    /** COS 存储桶 */
+    bucket: string;
+    /** COS 地域 */
+    region: string;
+    /** 临时密钥 ID */
+    secretId: string;
+    /** 临时密钥 Key */
+    secretKey: string;
+    /** 临时会话令牌 */
+    sessionToken: string;
+    /** 凭证生效时间（秒） */
+    startTime: number;
+    /** 凭证过期时间（秒） */
+    expiredTime: number;
+    /**
+     * 业务路径映射
+     * @description 后端按业务类型返回的可写路径 map；消费方按 pathKey 选取
+     */
+    path?: Record<string, string>;
+    /**
+     * 受控目录前缀（SDK 定制场景返回）
+     * @description 前端在该前缀下自行拼接文件名；可与 pathKey 继续拼接子目录
+     */
+    filePath?: string;
+    /**
+     * CDN 访问域名（不含尾斜杠）
+     * @description SDK 定制场景返回 cdn_url；通用场景无此字段时组件按 COS Location 拼接
+     */
+    cosHost?: string;
+}
+/**
+ * 通用 COS 凭证响应（snake_case，pnt-tools / account-business）
+ */
+interface SnakeCosCredential {
+    bucket: string;
+    region: string;
+    secret_id: string;
+    secret_key: string;
+    token: string;
+    start_time: number;
+    expired_time: number;
+    path?: Record<string, string>;
+}
+/**
+ * 内置业务场景
+ * @description 决定走哪个后端凭证接口
+ * - default: 通用上传（GET /v2/business/operation/get-cos-temp-token）
+ * - default_download: 通用下载/上传（POST /v2/business/operation/get-download-cos-temp-token，snake_case）
+ * - sdk_customize: SDK 定制服务（POST /internal/sdk_customize/upload_token，含 cdn_url/file_path）
+ * - ai_translate: AI 翻译服务（POST /business/aiTranslate/import/cosToken，camelCase）
+ */
+export type CosScene = 'default' | 'default_download' | 'sdk_customize' | 'ai_translate' | (string & Record<never, never>);
+/**
+ * 凭证获取参数
+ */
+export interface GetCosCredentialParams {
+    /** 业务场景 */
+    scene: CosScene;
+    /** 业务类型路径 key（透传到后端 path map 选取；sdk_customize 场景作为受控目录下的子目录） */
+    pathKey?: string;
+    /**
+     * 业务上下文参数（gameId/env/updType 等，按 scene 不同传递）
+     * @description default/default_download 场景下 gameId 会自动映射到请求头 x-service-type，
+     * 其余字段透传到 query/body；ai_translate 场景整体透传到 body
+     */
+    context?: Record<string, string | number>;
+    /** 文件大小（字节），后端用于校验配额 */
+    contentLength?: number;
+    /** 已上传文件 URL/Key（下载场景使用） */
+    fileUrl?: string;
+    /**
+     * 网关 audience
+     * @default '/player-network'
+     * @description 账号管理等子系统需覆盖为对应 audience（如 '/laas-pnt'）；
+     * 消费方注入的 http 实例若已统一追加 audience，URL 上存在该参数时拦截器不会重复追加
+     */
+    audience?: string;
+}
+/**
+ * 自定义原始响应归一化函数
+ * @description 后端返回字段不符合内置 scene 约定时使用；入参为后端响应的原始 data
+ */
+export type NormalizeCredential = (raw: unknown) => NormalizedCosCredential;
+/**
+ * snake_case 凭证归一化（导出供 getCredential 自定义逃生舱复用）
+ * @description 消费方自行请求凭证（如项目 http 实例为非标准签名）时，
+ * 可在 getCredential 内调用本函数把后端 data 转为组件库统一结构
+ */
+export declare const normalizeSnakeCredential: (raw: SnakeCosCredential) => NormalizedCosCredential;
+/**
+ * 获取 COS 临时凭证（按 scene 路由到不同后端接口，内部归一化字段命名）
+ * @param http 由 PntProvider 注入的 axios 实例
+ * @param params 凭证获取参数
+ * @param customNormalize 可选的原始响应自定义归一化
+ */
+export declare const fetchCosCredential: (http: PntHttpLike, params: GetCosCredentialParams, customNormalize?: NormalizeCredential) => Promise<NormalizedCosCredential>;
+export {};

package/lib/cjs/api/cos.js

@@ -0,0 +1,146 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/api/cos.ts
+var cos_exports = {};
+__export(cos_exports, {
+  fetchCosCredential: () => fetchCosCredential,
+  normalizeSnakeCredential: () => normalizeSnakeCredential
+});
+module.exports = __toCommonJS(cos_exports);
+var normalizeSnake = (raw) => ({
+  bucket: raw.bucket,
+  region: raw.region,
+  secretId: raw.secret_id,
+  secretKey: raw.secret_key,
+  sessionToken: raw.token,
+  startTime: raw.start_time,
+  expiredTime: raw.expired_time,
+  path: raw.path
+});
+var normalizeSnakeCredential = (raw) => normalizeSnake(raw);
+var normalizeAiTranslate = (raw) => {
+  var _a, _b;
+  return {
+    bucket: raw.bucket || "",
+    region: raw.region || "",
+    secretId: raw.secretId || "",
+    secretKey: raw.secretKey || "",
+    sessionToken: raw.token || "",
+    startTime: (_a = raw.startTime) != null ? _a : 0,
+    expiredTime: (_b = raw.expiredTime) != null ? _b : 0,
+    // aiTranslate path 类型为 Record<string, unknown>，这里收窄为 string
+    path: raw.path ? Object.fromEntries(
+      Object.entries(raw.path).filter(
+        (v) => typeof v[1] === "string"
+      )
+    ) : void 0
+  };
+};
+var normalizeSdkCustomize = (raw) => ({
+  bucket: raw.bucket,
+  region: raw.region,
+  secretId: raw.secret_id,
+  secretKey: raw.secret_key,
+  sessionToken: raw.token,
+  startTime: raw.start_time,
+  expiredTime: raw.expired_time,
+  filePath: raw.file_path,
+  cosHost: raw.cdn_url
+});
+var DEFAULT_AUDIENCE = "/player-network";
+var resolveCredential = (res, normalize, customNormalize) => {
+  var _a, _b;
+  const success = res.code === 0 || res.ret === 0;
+  if (!success || res.data === null || typeof res.data === "undefined") {
+    throw new Error(
+      `[PntCosUploader] 获取 COS 凭证失败: code=${(_a = res.code) != null ? _a : "null"} ret=${(_b = res.ret) != null ? _b : "null"} ${res.msg || ""}`
+    );
+  }
+  return customNormalize ? customNormalize(res.data) : normalize(res.data);
+};
+var fetchCosCredential = async (http, params, customNormalize) => {
+  const {
+    scene,
+    context = {},
+    contentLength,
+    fileUrl,
+    audience = DEFAULT_AUDIENCE
+  } = params;
+  switch (scene) {
+    case "default": {
+      const { gameId, ...restContext } = context;
+      const res = await http.get(
+        `/v2/business/operation/get-cos-temp-token?audience=${audience}`,
+        {
+          params: {
+            content_length: contentLength,
+            ...restContext
+          },
+          headers: gameId !== void 0 ? { "x-service-type": String(gameId) } : void 0
+        }
+      );
+      return resolveCredential(res, normalizeSnake, customNormalize);
+    }
+    case "default_download": {
+      const { gameId, ...restContext } = context;
+      const res = await http.post(
+        `/v2/business/operation/get-download-cos-temp-token?audience=${audience}`,
+        {
+          file_url: fileUrl,
+          content_length: contentLength,
+          ...restContext
+        },
+        {
+          headers: gameId !== void 0 ? { "x-service-type": String(gameId) } : void 0
+        }
+      );
+      return resolveCredential(res, normalizeSnake, customNormalize);
+    }
+    case "sdk_customize": {
+      const res = await http.post(
+        "/internal/sdk_customize/upload_token",
+        {
+          content_length: contentLength,
+          ...context
+        }
+      );
+      return resolveCredential(res, normalizeSdkCustomize, customNormalize);
+    }
+    case "ai_translate": {
+      const res = await http.post(
+        "/business/aiTranslate/import/cosToken",
+        {
+          contentLength,
+          ...context
+        }
+      );
+      return resolveCredential(res, normalizeAiTranslate, customNormalize);
+    }
+    default: {
+      throw new Error(
+        `[PntCosUploader] 未支持的 scene: ${scene}；请通过 getCredential 自定义`
+      );
+    }
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  fetchCosCredential,
+  normalizeSnakeCredential
+});

package/lib/cjs/api/index.d.ts

@@ -0,0 +1,23 @@
+import type { commonEesType, PntHttpLike } from "../config";
+import { BusinessGameInfoHighSecurityDecryptBody, BusinessGameInfoHighSecurityDecryptResponse, BusinessRegionQueryBody, BusinessRegionQueryResponse, BusinessSelectListBody, BusinessSelectListResponse } from './types/index';
+/**
+ * 业务下拉选择列表
+ * @param http 由 PntProvider 注入的 axios 实例
+ * @param data 请求参数
+ */
+export declare const businessSelectList: (axios: PntHttpLike, data: BusinessSelectListBody) => Promise<commonEesType<BusinessSelectListResponse>>;
+/**
+ * 高敏信息解锁
+ * @param http 由 PntProvider 注入的 axios 实例
+ * @param data 请求参数
+ * @param url 自定义接口 URL（可选，覆盖默认值）
+ */
+export declare const businessGameInfoHighSecurityDecrypt: (axios: PntHttpLike, data: BusinessGameInfoHighSecurityDecryptBody, url?: string) => Promise<commonEesType<BusinessGameInfoHighSecurityDecryptResponse>>;
+/**
+ * 业务区域查询
+ * @param axios 由 PntProvider 注入的 axios 实例
+ * @param data 请求参数；不传时不带任何参数，返回全部国家区域（251 个）；
+ *             传 game_id 时返回该业务最终生效的区域
+ * @param url 自定义接口 URL（可选，覆盖默认值）
+ */
+export declare const businessRegionQuery: (axios: PntHttpLike, data?: BusinessRegionQueryBody, url?: string) => Promise<commonEesType<BusinessRegionQueryResponse>>;

package/lib/cjs/api/index.js

@@ -0,0 +1,38 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/api/index.ts
+var api_exports = {};
+__export(api_exports, {
+  businessGameInfoHighSecurityDecrypt: () => businessGameInfoHighSecurityDecrypt,
+  businessRegionQuery: () => businessRegionQuery,
+  businessSelectList: () => businessSelectList
+});
+module.exports = __toCommonJS(api_exports);
+var businessSelectList = (axios, data) => axios.post("/business/select/list?audience=/player-network", data);
+var businessGameInfoHighSecurityDecrypt = (axios, data, url) => axios.post(
+  url || "/v3/business/game_info/high-security-decrypt?audience=/laas-pnt",
+  data
+);
+var businessRegionQuery = (axios, data, url) => axios.post(url || "/v5/business/region/query?audience=/laas-pnt", data);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  businessGameInfoHighSecurityDecrypt,
+  businessRegionQuery,
+  businessSelectList
+});

package/lib/cjs/api/types/index.d.ts

@@ -0,0 +1,117 @@
+/**
+ * 本文件由 yapi-gen 自动生成，请勿手动修改
+ * 生成时间: 2026/9/10 11:19:01
+ * 数据来源: https://api-pnt.intlgame.com
+ */
+export interface BusinessSelectListBody {
+    /** 业务类型列表，仅 game_list、game_list_option 场景支持：1-正式业务，2-测试业务 */
+    business_types?: number[];
+    /** 云控类型列表，仅 game_list、game_list_option 场景支持：1-INTL Project，2-LI PASS Project */
+    cloudCtrlType?: number[];
+    /** 集群类型列表，仅 game_list、game_list_option 场景支持：1-公有，2-私有，3-未配置 */
+    clusterTypes?: number[];
+    /** 需要返回的字段；未传时使用场景默认字段，仅支持服务端白名单字段 */
+    fields?: string[];
+    /** 业务ID列表，仅 game_list、game_list_option 场景支持 */
+    game_ids?: string[];
+    /** 业务ID、中文名称或英文名称的模糊匹配关键字 */
+    keyword?: string;
+    /** 登录器类型列表，仅 game_list、game_list_option 场景支持 */
+    lander_type?: number[];
+    /** LI PASS 开关列表，仅 game_list、game_list_option 场景支持：1-开启，2-未开启 */
+    lipSwitches?: number[];
+    /** 当前页 */
+    pageNum?: number;
+    /** 每页条数 */
+    pageSize?: number;
+    /** 平台列表，仅 game_list、game_list_option 场景支持 */
+    platform?: string[];
+    /** 下拉场景：game_list-业务列表，game_list_option-业务选择，compliance_age-合规年龄，custom_region-自定义合规地域，sdk-SDK定制 */
+    scene?: string;
+    /** 业务状态列表，仅 game_list、game_list_option 场景支持：3-线上运营，4-接入中，5-中途结项，6-已下线 */
+    statuses?: number[];
+    /** 总条数 */
+    total?: number;
+    /** 总页数 */
+    totalPage?: number;
+}
+export interface BusinessSelectListResponseListItem {
+    /** 业务接入类型：1-纯SDK，2-LI PASS，3-工作室品牌账号 */
+    business_access_method?: number;
+    /** 业务类型：1-正式业务，2-测试业务 */
+    business_type?: number;
+    /** 当前场景是否可创建；仅 compliance_age、custom_region 场景有意义 */
+    creatable?: boolean;
+    /** 当前业务是否禁用合规年龄认证；仅 compliance_age 场景有意义 */
+    disabled?: boolean;
+    /** 业务ID */
+    game_id?: string;
+    /** 业务接口开发负责人；SDK场景可返回 */
+    interface_developer_name?: string;
+    /** 业务中文名称 */
+    name?: string;
+    /** 业务英文名称 */
+    name_en?: string;
+    /** SDK定制版本通知人；SDK场景可返回 */
+    sdk_customize_notifier?: string;
+    /** 业务状态：3-线上运营，4-接入中，5-中途结项，6-已下线 */
+    state?: number;
+}
+export interface BusinessSelectListResponsePagination {
+    /** 当前页 */
+    pageNum?: number;
+    /** 每页条数 */
+    pageSize?: number;
+    /** 总条数 */
+    total?: number;
+    /** 总页数 */
+    totalPage?: number;
+}
+export interface BusinessSelectListResponse {
+    /** 业务列表；字段由请求 Fields 或场景默认字段决定 */
+    list?: BusinessSelectListResponseListItem[];
+    /** 分页信息；未分页时统计字段均为零值 */
+    pagination?: BusinessSelectListResponsePagination;
+}
+export interface BusinessGameInfoHighSecurityDecryptBodyParamItem {
+    /** 参数字段 */
+    key: string;
+    /** 参数密文 */
+    value: string;
+}
+export interface BusinessGameInfoHighSecurityDecryptBody {
+    param: BusinessGameInfoHighSecurityDecryptBodyParamItem[];
+    /** 页面ID */
+    page_id: string;
+    /** 请求环境 */
+    env: number;
+    game_id: number;
+}
+export type BusinessGameInfoHighSecurityDecryptResponse = Record<string, unknown>[];
+export interface BusinessRegionQueryBody {
+    /** GameID 目标业务 ID；取值 > 0 时返回该业务实际生效的国家区域；
+  取值 <= 0 或未传时返回国家区域全量字典；与当前登录业务是否一致不做强校验（跨业务查询合法）。 */
+    game_id?: number;
+}
+export interface BusinessRegionQueryResponseRegionListItem {
+    /** ID 区域主键 ID。 */
+    id?: number;
+    /** IsEEARegion 是否 EEA 区域，取值：0=否，1=是。 */
+    is_eea_region?: number;
+    /** IsSecretRegion 是否特殊合规区域，取值：1=默认区域，2=特殊区域。 */
+    is_secret_region?: number;
+    /** RegionA2Code 二位字母码。 */
+    region_a2_code?: string;
+    /** RegionA3Code 三位字母码。 */
+    region_a3_code?: string;
+    /** RegionCH 中文名称。 */
+    region_ch?: string;
+    /** RegionCode 数字码，按数据库原始值返回，不做前导零转换。 */
+    region_code?: string;
+    /** RegionEN 英文名称。 */
+    region_en?: string;
+}
+export interface BusinessRegionQueryResponse {
+    /** RegionList 国家区域列表：未携带 game_id 时为全量字典，携带 game_id 时为该业务实际生效区域；均按 id 升序。 */
+    region_list?: BusinessRegionQueryResponseRegionListItem[];
+}

package/lib/cjs/api/types/index.js

@@ -0,0 +1,17 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/api/types/index.ts
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);