@volcengine/amk-editor 0.0.2-beta.1 → 0.0.2

package/dist/tos-upload.d.ts

@@ -31,12 +31,23 @@ interface RefreshTosMaterialUrlsOptions {
     storage: AmkEditorStorageConfig;
     createClient?: UploadFilesToTosOptions['createClient'];
 }
+/** TOS 素材的稳定标识已包含 bucket 与 object key，无需额外持久化内部字段。 */
+export declare function parseTosResourceUrl(value: unknown): {
+    bucket: string;
+    key: string;
+} | null;
 /** 使用宿主下发的临时 STS 将本地文件直传客户 TOS，并转换为编辑器素材。 */
 export declare function uploadFilesToTos(options: UploadFilesToTosOptions): Promise<MaterialItem[]>;
 /** 为已持久化的私有 TOS 素材重新生成播放签名，供初始化和按需刷新使用。 */
 export declare function refreshTosMaterialUrls(options: RefreshTosMaterialUrlsOptions): Promise<Array<Partial<MaterialItem> & {
     material_id: string;
 }>>;
+/** 将任意任务产物中的 tos:// 地址批量签成浏览器可访问的 HTTP URL。 */
+export declare function signTosResourceUrls(options: {
+    urls: unknown[];
+    storage: AmkEditorStorageConfig;
+    createClient?: UploadFilesToTosOptions['createClient'];
+}): Promise<unknown[]>;
 /** 为资产库导入的 TOS 素材签发播放 URL；稳定身份仍保留在 source_material_id。 */
 export declare function signTosImportedMaterialUrls(options: {
     materials: MaterialItem[];

package/dist/types.d.ts

@@ -24,13 +24,13 @@ export interface AmkMaterialImportRequestOptions {
     onMaterialsImported?: (materials: MaterialItem[]) => void | Promise<void>;
 }
 /**
- * 抽帧产物存储 key 的推荐命名，仅用于提供接入提示，不属于强制素材 Schema。
- * 业务可以直接使用这两个字段，也可以把 key 放进任意自定义字段或嵌套对象。
+ * 抽帧产物的稳定存储身份。TOS 产物会保存完整 `tos://bucket/key`，
+ * SDK 用它在签名 URL 过期后重新签发；非 TOS 业务仍可使用自定义字段。
  */
 export interface RecommendedExtractStorageFields {
-    /** 推荐字段：封面图业务存储 key；业务也可以使用自定义字段。 */
+    /** 封面图稳定身份；内置 TOS 链路保存 `tos://bucket/key`。 */
     poster_storage_key?: string;
-    /** 推荐字段：与 sprite.storeurls 对应的业务存储 key；也可自定义。 */
+    /** 与 sprite.storeurls 等长的稳定身份数组；内置 TOS 链路保存 tos:// 地址。 */
     sprite_storage_keys?: string[];
 }
 export interface PersistExtractUrlsResult {
@@ -70,7 +70,8 @@ export interface MaterialConfig {
      * SDK 会先用临时链上屏/落盘，再后台调用本回调换链；失败则保留临时链。
      * 未配置则只落盘临时链；若带 auth_key 且过期，SDK 会自动重抽。
      * 推荐返回 urls + materialPatch，把刷新 URL 所需的 storage key 或其他业务字段写入素材。
-     * SDK 不限定 materialPatch 的字段名；poster_storage_key / sprite_storage_keys 仅为推荐命名。
+     * SDK 不限制其他 materialPatch 字段；poster_storage_key / sprite_storage_keys
+     * 中的 `tos://` 地址会作为后续自动重签依据。
      * 兼容只返回 string[]，但该形式无法附带业务字段。
      */
     onPersistExtractUrls?: (params: {
@@ -86,6 +87,8 @@ export interface AmkEditorHeaderTitleUpdateSuccess {
 }
 export interface AmkEditorHeaderConfig {
     show?: boolean;
+    /** 是否展示导出任务列表入口，默认开启。 */
+    exportTaskList?: boolean;
     /**
      * When set, the header is rendered into this element instead of inside the
      * editor root. Use this to place a full-width header above a host split layout.
@@ -114,13 +117,14 @@ export interface AmkEditorUploadSTSCredentials {
 }
 /**
  * 产物 / 主动上传的存储目标。
- * `media_output_destination` 用于 TOS 直传的 Bucket 定位；当前不会自动写入 AMK tools 请求体。
+ * `media_output_destination` 用于 TOS 直传的 Bucket 定位，并默认写入会产生媒体产物的 AMK tools 请求体。
  * @see https://docs.volcengine.com/docs/6448/2386113
  */
 export interface AmkEditorStorageConfig {
     /**
-     * 处理产物存储目标。支持 `vod://<空间名>` 或 `tos://<桶名>`。
-     * 配置后任务结果中的 url 为对应资源地址，而不是临时下载链。
+     * 处理产物存储目标。支持 `vod://<空间名>` 或 `tos://<桶名>/<可选子目录>`。
+     * 配置后任务结果中的 url 为对应资源地址，而不是临时下载链；当返回
+     * `tos://bucket/key` 且同时配置 getUploadSTS 时，SDK 会自动签成 HTTP 播放地址。
      */
     media_output_destination?: string;
     /**