next-flow-interface 0.27.14 → 0.27.16

package/index.d.ts

@@ -2489,6 +2489,18 @@ export declare class LocalDataService {
      * @public
      */
     add(option: AddLocalDataOption): LocalData;
+    /**
+     * 将已有的本地数据重映射到新的文件 ID
+     *
+     * 上传文件时使用临时 ID 存储，上传完成后需要替换为后端返回的真实 fileId，
+     * 以确保刷新页面后仍能通过真实 fileId 找到数据。
+     *
+     * @param oldFid - 旧的临时文件 ID
+     * @param newFid - 新的真实文件 ID
+     * @returns 是否成功重映射
+     * @public
+     */
+    remap(oldFid: string, newFid: string): boolean;
     /**
      * 加载一个文件到本地
      *
@@ -3290,6 +3302,15 @@ export declare class OssUploadService {
     private initialize;
     /** 正在上传的实例 Map（fid -> OssUploadInstance） */
     instances: Map<string, OssUploadInstance>;
+    /**
+     * 已完成上传但尚未获得 resourceId 的 rbFile.id 集合
+     *
+     * rhine-base 上传流程分两步：
+     * 1. 文件上传完成 → status='complete'（此时无 resourceId）
+     * 2. 后端创建资源 → resourceId 被设置（再次 notify）
+     * 需要在第二步时识别出该文件并写入协同数据
+     */
+    private pendingResourceIds;
     /**
      * 根据 fid 获取上传实例
      *
@@ -4185,6 +4206,38 @@ export declare class ResourceService {
      * @returns PNG 格式的 File 对象，失败返回 null
      */
     generatePreviewForTexture(texture: BaseTexture, filename?: string): Promise<File | null>;
+    /**
+     * 上传文件并等待完成
+     *
+     * 监听上传和资源添加事件，成功时返回 resourceId，失败时 reject。
+     *
+     * @param file - 浏览器 File 对象
+     * @param fid - 可选的文件 ID，不传则由上传服务自动生成
+     * @returns Promise<resourceId>，上传成功返回资源 ID，失败则 reject
+     */
+    uploadAndWait(file: File, fid?: string): Promise<string>;
+    /**
+     * 批量上传文件并等待所有完成
+     *
+     * 自动检测重复文件并提示用户。返回成功上传的资源 ID 列表。
+     *
+     * @param fileList - 文件列表，支持 FileList、File[]、单个 File 或 null
+     * @param fidList - 可选的文件 ID 列表，与 fileList 一一对应
+     * @returns Promise<resourceId[]>，成功上传的资源 ID 列表
+     */
+    uploadMultiAndWait(fileList: FileList | File[] | File | null | undefined, fidList?: string[]): Promise<string[]>;
+    /**
+     * 通过已有文件 ID 创建资源
+     *
+     * 调用后端资源创建接口，在当前用户容器中创建一个引用指定文件的资源。
+     * 创建成功后自动将资源元数据写入缓存并添加到协同数据。
+     *
+     * @param fileId - 已存在的后端文件 ID
+     * @param name - 资源名称
+     * @returns 创建成功的 resourceId
+     * @public
+     */
+    createByFileId(fileId: string, name: string): Promise<string>;
     /**
      * 生成资源/文件 ID
      *
@@ -6002,7 +6055,7 @@ export declare class RvResourceService {
      */
     add(resourceId: string): void;
     /**
-     * 从协同数据移除 resourceId
+     * 从协同数据移除 resourceId，并清理 fileToResourceMap 中的映射
      */
     remove(resourceId: string): boolean;
     /**
@@ -6014,9 +6067,19 @@ export declare class RvResourceService {
      */
     getMetadata(resourceId: string): Resource | undefined;
     /**
-     * 通过 fileId 获取对应的资源元数据
+     * 通过 fileId 获取对应的资源元数据（返回第一个匹配的资源）
+     *
+     * @deprecated 当一个文件对应多个资源时，此方法只返回第一个。建议使用 getAllMetadataByFileId()
      */
     getMetadataByFileId(fileId: string): Resource | undefined;
+    /**
+     * 通过 fileId 获取所有对应的资源元数据列表
+     */
+    getAllMetadataByFileId(fileId: string): Resource[];
+    /**
+     * 通过 fileId 获取所有对应的 resourceId 列表
+     */
+    getResourceIdsByFileId(fileId: string): string[];
     /**
      * 设置资源元数据缓存
      */
@@ -6056,6 +6119,8 @@ export declare class RvResourceService {
      * 通过 listResources 一次性拉取后端完整资源列表，
      * 仅填充本地元数据缓存，不自动添加到协同数据。
      * 需要手动调用 add() 方法将资源添加到协同数据。
+     *
+     * 同步完成后会自动清理孤立资源（没有对应文件的资源）
      */
     syncFromBackend(): Promise<void>;
     /**

package/package.json

@@ -36,7 +36,7 @@
     "valtio": "2.1.7",
     "rhine-var": "2.4.3"
   },
-  "version": "0.27.14",
+  "version": "0.27.16",
   "author": "NextFlow",
   "license": "Apache-2.0",
   "keywords": [