@pnt-team/pnt-component-frontend 0.0.91 → 0.0.95

package/README.md

@@ -2,6 +2,8 @@
 
 PNT 前端业务组件库，基于 [dumi2](https://d.umijs.org/) + [father4](https://github.com/umijs/father) 构建，收敛 PNT 业务项目中高价值的重复组件与 Hook，实现单一来源维护。
 
+> 当前版本：**0.0.91** · 组件清单：`PntImage` / `PntBusinessSelect` / `PntSecureBox` / `PntGeneralLayout`
+
 ## 安装
 
 ```bash
@@ -12,11 +14,12 @@ yarn add @pnt-team/pnt-component-frontend
 
 ### 依赖要求（peerDependencies）
 
-| 依赖            | 版本要求   | 说明                                   |
-| --------------- | ---------- | -------------------------------------- |
-| `react`         | `>=16.9.0` | React 核心框架                         |
-| `react-dom`     | `>=16.9.0` | React DOM 渲染                         |
-| `tdesign-react` | `>=1.5.0`  | UI 组件库（本组件库基于 TDesign 封装） |
+| 依赖                  | 版本要求   | 说明                                   |
+| --------------------- | ---------- | -------------------------------------- |
+| `react`               | `>=16.9.0` | React 核心框架                         |
+| `react-dom`           | `>=16.9.0` | React DOM 渲染                         |
+| `tdesign-react`       | `>=1.5.0`  | UI 组件库（本组件库基于 TDesign 封装） |
+| `tdesign-icons-react` | `>=0.2.0`  | TDesign 图标库                         |
 
 > ⚠️ 请确保项目中已安装以上依赖，否则组件可能无法正常运行。
 
@@ -36,12 +39,15 @@ import http from '你的项目中的 axios 实例';
 ```tsx
 import {
   // L1 基础展示组件
-  PntImagePreview,
+  PntImage,
   // L2 业务复合组件
   PntBusinessSelect,
   PntSecureBox,
   // L3 布局组件
   PntGeneralLayout,
+  // 配置
+  PntProvider,
+  usePntConfig,
 } from '@pnt-team/pnt-component-frontend';
 ```
 
@@ -49,29 +55,57 @@ import {
 
 ### L1 基础展示组件
 
-#### PntImagePreview — 图片预览组件
+#### PntImage — 业务图片组件
 
-用于展示上传的图片，支持预览、删除功能和上传状态显示。
+统一的业务图片组件，单一组件通过 `onRemove` 是否传入自适应「上传预览」与「纯预览」两种模式，避免业务侧维护两套组件（原 UploadImageViewer + BasicImageViewer）。
 
 **Props：**
 
-| 属性         | 类型                                            | 必填 | 说明                             |
-| ------------ | ----------------------------------------------- | ---- | -------------------------------- |
-| `iconUrl`    | `string \| undefined`                           | ✅   | 图片 URL 地址                    |
-| `loading`    | `boolean`                                       | ✅   | 上传加载状态                     |
-| `defaultImg` | `string`                                        | ❌   | 默认图片（不传则使用内置默认图） |
-| `params`     | `{ style?: CSSProperties; [key: string]: any }` | ❌   | 自定义扩展参数                   |
-| `onRemove`   | `(e: any) => void`                              | ❌   | 删除回调函数                     |
+| 属性         | 类型                                 | 必填 | 默认值                                                               | 说明                                                    |
+| ------------ | ------------------------------------ | :--: | -------------------------------------------------------------------- | ------------------------------------------------------- |
+| `src`        | `string \| undefined`                |  ✅  | -                                                                    | 图片 URL；为空则展示 defaultImg 或内置 uploadImg        |
+| `alt`        | `string`                             |  ❌  | `''`                                                                 | alt 文本，纯预览模式建议传入以提升可访问性              |
+| `defaultImg` | `string`                             |  ❌  | 内置 uploadImg                                                       | 默认图片（仅上传预览模式生效）                          |
+| `size`       | `'small' \| 'medium' \| 'large'`     |  ❌  | `'large'`                                                            | 快捷正方形尺寸：small=36px、medium=60px、large=136px    |
+| `style`      | `React.CSSProperties`                |  ❌  | -                                                                    | 自定义样式；width/height 优先级高于 size                |
+| `loading`    | `boolean`                            |  ❌  | `false`                                                              | 上传中状态（仅上传预览模式生效）                        |
+| `onRemove`   | `(e: any) => void`                   |  ❌  | -                                                                    | 删除回调（传入即启用上传预览模式）                      |
+| `container`  | `HTMLElement \| (() => HTMLElement)` |  ❌  | -                                                                    | attach 容器（弹窗场景需要，透传给 tdesign ImageViewer） |
+| `texts`      | `PntImageTexts`                      |  ❌  | `{ uploading: '上传中', loading: '加载中', loadFailed: '加载失败' }` | 多语言文案，传入字段覆盖默认中文                        |
+
+**模式判定规则：**
+
+| 模式         | 触发条件        | mask 行为                | loading 占位            | defaultImg | error 占位 |
+| ------------ | --------------- | ------------------------ | ----------------------- | :--------: | ---------- |
+| 上传预览模式 | 传入 `onRemove` | 预览按钮 + 分隔线 + 删除 | "上传中"（LoadingIcon） |     ✅     | 不显示     |
+| 纯预览模式   | 不传 `onRemove` | 半透明遮罩 + 点击预览    | "加载中"（ImageIcon）   |     ❌     | "加载失败" |
 
 **示例：**
 
 ```tsx
-<PntImagePreview
-  iconUrl={imageUrl}
+// 上传预览模式
+<PntImage
+  src={iconUrl}
   loading={uploading}
   defaultImg="/path/to/default.png"
-  params={{ style: { width: '200px', height: '200px' } }}
   onRemove={handleRemove}
+  size="large"
+/>
+
+// 纯预览模式
+<PntImage
+  src={url}
+  alt="avatar"
+  size="medium"
+  container={dialogContainer}
+/>
+
+// 多语言
+<PntImage
+  src={url}
+  alt="avatar"
+  size="medium"
+  texts={{ loading: 'Loading', loadFailed: 'Failed' }}
 />
 ```
 
@@ -81,23 +115,42 @@ import {
 
 #### PntBusinessSelect — 业务选择器组件
 
-统一业务下拉选择器，内置对接后端通用接口 `/api/business/select/list`，支持远程搜索、滚动分页加载、多选、场景化禁用。
+统一业务下拉选择器，内置对接后端通用接口 `/api/business/select/list`，支持远程搜索、滚动分页加载、多选、场景化禁用（合规场景 `creatable` 字段）。
+
+替代此前 5 个分散的业务 select 接口（`game/list`、`game/list_option`、`compliance-age/game/list`、`biz-list-with-creatable-state`、`sdk_customize/game_list`）。
 
 **Props：**
 
-| 属性          | 类型                                                        | 必填 | 默认值      | 说明           |
-| ------------- | ----------------------------------------------------------- | :--: | ----------- | -------------- |
-| `value`       | `SelectValue`                                               |  ❌  | -           | 当前选中值     |
-| `onChange`    | `TdSelectProps['onChange']`                                 |  ❌  | -           | 值变化回调     |
-| `multiple`    | `boolean`                                                   |  ❌  | `false`     | 是否多选       |
-| `scene`       | `'default' \| 'sdk' \| 'compliance_age' \| 'custom_region'` |  ❌  | `'default'` | 下拉场景       |
-| `statuses`    | `number[]`                                                  |  ❌  | -           | 业务状态筛选   |
-| `labelFormat` | `'name' \| 'name_en' \| 'name_id' \| 'name_en_id'`          |  ❌  | `'name'`    | 标签格式       |
-| `filterable`  | `boolean`                                                   |  ❌  | `true`      | 是否可远程搜索 |
-| `pagination`  | `boolean`                                                   |  ❌  | `true`      | 是否分页       |
-| `placeholder` | `string`                                                    |  ❌  | -           | 占位提示文案   |
-| `disabled`    | `boolean`                                                   |  ❌  | `false`     | 是否禁用       |
-| `popupProps`  | `Partial<TdSelectProps['popupProps']>`                      |  ❌  | -           | 弹层属性透传   |
+| 属性                   | 类型                                                        | 必填 | 默认值      | 说明                                                                                |
+| ---------------------- | ----------------------------------------------------------- | :--: | ----------- | ----------------------------------------------------------------------------------- |
+| `value`                | `string \| string[]`                                        |  ❌  | -           | 当前选中值；单选为 string，多选为 string[]                                          |
+| `onChange`             | `(value, context) => void`                                  |  ❌  | -           | 值变化回调；context.selectedOptions 返回纯业务数据对象                              |
+| `multiple`             | `boolean`                                                   |  ❌  | `false`     | 是否多选                                                                            |
+| `scene`                | `'default' \| 'sdk' \| 'compliance_age' \| 'custom_region'` |  ❌  | `'default'` | 下拉场景；后端按场景返回默认字段集                                                  |
+| `statuses`             | `number[]`                                                  |  ❌  | -           | 业务状态筛选（3-线上运营, 4-接入中, 5-中途结项, 6-已下线）                          |
+| `businessTypes`        | `number[]`                                                  |  ❌  | -           | 业务类型筛选（1-正式业务, 2-测试业务）                                              |
+| `businessAccessMethod` | `number`                                                    |  ❌  | -           | 业务接入类型筛选（1-纯 SDK, 2-LI PASS, 3-工作室品牌账号）                           |
+| `labelFormat`          | `'name' \| 'name_en' \| 'name_id' \| 'name_en_id'`          |  ❌  | `'name'`    | 标签格式                                                                            |
+| `labelField`           | `string`                                                    |  ❌  | -           | 自定义 label 字段（消费方接口返回字段非标准 name/name_en 时使用）                   |
+| `optionLabel`          | `(item) => ReactNode`                                       |  ❌  | -           | 自定义选项 label 渲染；优先级高于 labelFormat/labelField                            |
+| `placeholder`          | `string`                                                    |  ❌  | -           | 占位提示文案                                                                        |
+| `disabled`             | `boolean`                                                   |  ❌  | `false`     | 是否禁用整个选择器                                                                  |
+| `clearable`            | `boolean`                                                   |  ❌  | `true`      | 是否可清除                                                                          |
+| `filterable`           | `boolean`                                                   |  ❌  | `true`      | 是否可远程搜索                                                                      |
+| `max`                  | `number`                                                    |  ❌  | -           | 多选时最大可选数量                                                                  |
+| `pageSize`             | `number`                                                    |  ❌  | `20`        | 每页条数                                                                            |
+| `searchDebounce`       | `number`                                                    |  ❌  | `400`       | 搜索防抖延迟（毫秒）                                                                |
+| `minCollapsedNum`      | `number`                                                    |  ❌  | -           | 多选时最少折叠数量；透传至 TDesign Select                                           |
+| `collapsedItems`       | `TdSelectProps['collapsedItems']`                           |  ❌  | -           | 折叠项自定义渲染；透传至 TDesign Select                                             |
+| `popupProps`           | `Partial<TdSelectProps['popupProps']>`                      |  ❌  | -           | 弹层属性透传；与内部 onScrollToBottom 合并；常用 attach、overlayClassName           |
+| `fields`               | `string[]`                                                  |  ❌  | -           | 字段白名单，传给后端 fields 参数；未传时后端按 scene 返回默认字段                   |
+| `pagination`           | `boolean`                                                   |  ❌  | `true`      | 是否分页；false 时一次性加载全量数据，不远程搜索                                    |
+| `onLoaded`             | `(options) => void`                                         |  ❌  | -           | 选项加载完成回调；不分页模式下首屏即全量，可复用此数据避免重复请求                  |
+| `optionDisabled`       | `(item) => boolean`                                         |  ❌  | -           | 自定义选项禁用逻辑；与合规场景 creatable 判断叠加（任一为 true 即禁用）             |
+| `optionTooltip`        | `(item) => string`                                          |  ❌  | -           | 自定义选项 tooltip 内容；返回非空字符串时该选项悬停显示 tooltip，常用于解释禁用原因 |
+| `tooltipPlacement`     | `'top' \| 'bottom' \| 'left' \| 'right'`                    |  ❌  | `'top'`     | tooltip 位置                                                                        |
+| `className`            | `string`                                                    |  ❌  | -           | 自定义类名                                                                          |
+| `style`                | `React.CSSProperties`                                       |  ❌  | -           | 自定义样式                                                                          |
 
 **示例：**
 
@@ -111,6 +164,15 @@ import { PntBusinessSelect } from '@pnt-team/pnt-component-frontend';
   value={gameId}
   onChange={(v) => setGameId(v as string)}
 />;
+
+// 多选 + 状态过滤
+<PntBusinessSelect
+  multiple
+  statuses={[3, 4]}
+  labelFormat="name_id"
+  value={gameIds}
+  onChange={(v) => setGameIds(v as string[])}
+/>;
 ```
 
 ---
@@ -121,15 +183,15 @@ import { PntBusinessSelect } from '@pnt-team/pnt-component-frontend';
 
 **Props：**
 
-| 属性        | 类型                                   | 必填 | 说明                                   |
-| ----------- | -------------------------------------- | ---- | -------------------------------------- |
-| `dataKey`   | `string`                               | ✅   | 高敏信息的唯一标识 key                 |
-| `dataValue` | `string`                               | ✅   | 初始显示值（通常为脱敏后的数据）       |
-| `env`       | `string \| number`                     | ✅   | 环境标识（如 dev / test / production） |
-| `gameId`    | `string \| number`                     | ✅   | 游戏 ID                                |
-| `renderDom` | `(content: string) => React.ReactNode` | ✅   | 自定义渲染函数                         |
-| `viewText`  | `string`                               | ❌   | 查看按钮文案，默认 `'View'`            |
-| `pageId`    | `string`                               | ❌   | 页面 ID（用于操作日志和权限验证）      |
+| 属性        | 类型                                   | 必填 | 默认值              | 说明                                                         |
+| ----------- | -------------------------------------- | :--: | ------------------- | ------------------------------------------------------------ |
+| `dataKey`   | `string`                               |  ✅  | -                   | 高敏信息的唯一标识 key，用于缓存真实值                       |
+| `dataValue` | `string`                               |  ✅  | -                   | 初始显示值，通常为脱敏后的数据（含 `_high_security_:` 前缀） |
+| `env`       | `string \| number`                     |  ✅  | -                   | 环境标识（如 dev / test / production）                       |
+| `gameId`    | `string \| number`                     |  ✅  | -                   | 游戏 / 业务 ID                                               |
+| `renderDom` | `(content: string) => React.ReactNode` |  ✅  | -                   | 自定义渲染函数，参数为当前显示内容（真实值或脱敏值）         |
+| `viewText`  | `string`                               |  ❌  | `'View'`            | 查看按钮文案                                                 |
+| `pageId`    | `string`                               |  ❌  | `location.pathname` | 页面 ID，用于操作日志和权限验证                              |
 
 **示例：**
 
@@ -146,28 +208,53 @@ import { PntSecureBox } from '@pnt-team/pnt-component-frontend';
 />;
 ```
 
+**非展示场景（查看 → 复制 / 批量解锁拼装）请用 `useHighSecurity`：**
+
+```tsx
+import { useHighSecurity } from '@pnt-team/pnt-component-frontend';
+
+const { securityData, isUnlocked, requestSecurityData, clearSecurityData } =
+  useHighSecurity({ gameId, env });
+
+// 第一次点击解锁、第二次点击复制；切换业务时 clearSecurityData()
+const res = await requestSecurityData({
+  gameId,
+  env,
+  param: [{ key: 'SDK_KEY', value: cipher }],
+});
+if (res.length) navigator.clipboard.writeText(securityData.SDK_KEY);
+```
+
+- 模块级缓存按 `gameId + env + key` 复合键隔离，同页多实例共享，同一 key 同页只请求一次；在途并发自动去重
+- 解锁失败返回 `[]` 且不抛错；`env` 必填
+- 另有 `isSecurityData(value)` 导出，用于判断 `_high_security_:` 密文
+
 ---
 
 ### L3 布局组件
 
 #### PntGeneralLayout — 通用页面布局组件
 
-提供标准的「头部 + 子头部 + 内容区 + 底部」页面布局结构，基于 TDesign Layout 封装，适用于后台管理系统的详情页、表单页等场景。
+提供标准的「头部 + 子头部 + 内容区 + 底部」页面布局结构，基于 TDesign Layout（flex column）封装，内容区自动填满剩余高度并独立滚动，适用于后台管理系统的列表页、详情页、表单页等场景。
 
 **Props：**
 
-| 属性                | 类型                  | 必填 | 默认值 | 说明                                 |
-| ------------------- | --------------------- | ---- | ------ | ------------------------------------ |
-| `className`         | `string`              | ❌   | -      | 自定义类名                           |
-| `headerTitle`       | `ReactNode`           | ❌   | -      | 头部标题内容，传入后渲染 Header 区域 |
-| `showBackButton`    | `boolean`             | ❌   | false  | 是否显示返回按钮                     |
-| `onBackButtonClick` | `() => void`          | ❌   | -      | 返回按钮点击回调                     |
-| `subHeaderContent`  | `ReactNode`           | ❌   | -      | 子头部内容，位于 Header 下方         |
-| `operation`         | `ReactNode`           | ❌   | -      | 头部右侧操作区，常用于放置按钮组     |
-| `bodyRef`           | `Ref<HTMLDivElement>` | ❌   | -      | 内容区 ref 引用                      |
-| `bodyStyle`         | `CSSProperties`       | ❌   | -      | 内容区自定义样式                     |
-| `footer`            | `ReactNode`           | ❌   | -      | 底部内容，传入后渲染 Footer 区域     |
-| `children`          | `ReactNode`           | ❌   | -      | 页面主体内容                         |
+| 属性                | 类型                  | 必填 | 默认值    | 说明                                                                               |
+| ------------------- | --------------------- | :--: | --------- | ---------------------------------------------------------------------------------- |
+| `className`         | `string`              |  ❌  | -         | 自定义类名，追加到根元素，常用于页面级样式覆写                                     |
+| `headerTitle`       | `ReactNode`           |  ❌  | -         | 头部标题内容，传入后渲染 Header 区域                                               |
+| `showBackButton`    | `boolean`             |  ❌  | `false`   | 是否显示返回按钮                                                                   |
+| `onBackButtonClick` | `() => void`          |  ❌  | -         | 返回按钮点击回调                                                                   |
+| `headerBordered`    | `boolean`             |  ❌  | `true`    | 是否显示头部底部分割线                                                             |
+| `subHeaderContent`  | `ReactNode`           |  ❌  | -         | 子头部内容，位于 Header 下方                                                       |
+| `operation`         | `ReactNode`           |  ❌  | -         | 头部右侧操作区，常用于放置按钮组                                                   |
+| `bodyRef`           | `Ref<HTMLDivElement>` |  ❌  | -         | 内容区 ref 引用                                                                    |
+| `bodyStyle`         | `CSSProperties`       |  ❌  | -         | 内容区自定义样式（内边距、圆角建议优先使用 bodyPadding / cardRadius）              |
+| `bodyPadding`       | `number \| string`    |  ❌  | `24`      | 内容区内边距；数字按 px 处理，全出血内容可传 `'24px 0'`                            |
+| `cardRadius`        | `number`              |  ❌  | `4`       | 内容区卡片圆角（px），联动 t-card 及其 body                                        |
+| `footerButton`      | `'fixed' \| 'auto'`   |  ❌  | `'fixed'` | fixed：底部按钮统一 36px 高 / 92px 最小宽 / 加粗；auto：不约束按钮尺寸，仅保留间距 |
+| `footer`            | `ReactNode`           |  ❌  | -         | 底部内容，传入后渲染 Footer 区域                                                   |
+| `children`          | `ReactNode`           |  ❌  | -         | 页面主体内容                                                                       |
 
 **示例：**
 
@@ -204,6 +291,14 @@ import { PntSecureBox } from '@pnt-team/pnt-component-frontend';
 >
   <Detail />
 </PntGeneralLayout>
+
+// 适配项目风格（无头部边线 / 全出血内容 / 大圆角卡片 / 底部按钮自适应）
+<PntGeneralLayout
+  headerBordered={false}
+  bodyPadding="24px 0"
+  cardRadius={8}
+  footerButton="auto"
+/>
 ```
 
 ---

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

@@ -0,0 +1,103 @@
+import type { AxiosInstance } from 'axios';
+/**
+ * 归一化后的 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: AxiosInstance, params: GetCosCredentialParams, customNormalize?: NormalizeCredential) => Promise<NormalizedCosCredential>;
+export {};

package/lib/cjs/api/cos.js

@@ -0,0 +1,137 @@
+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
+});