next-flow-interface 0.27.13 → 0.27.15

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
      *
@@ -5997,6 +6050,8 @@ export declare class RvResourceService {
     private fileToResourceMap;
     /**
      * 添加 resourceId 到协同数据
+     *
+     * 如果资源元数据已在缓存中，会自动同步文件元数据并触发下载
      */
     add(resourceId: string): void;
     /**
@@ -6049,13 +6104,27 @@ export declare class RvResourceService {
      */
     getDownloadUrl(fileId: string): Promise<string>;
     /**
-     * 从后端同步资源列表到协同数据和本地缓存
+     * 从后端同步资源列表到本地缓存
      *
      * 通过 listResources 一次性拉取后端完整资源列表，
-     * 将缺失的 resourceId 补写回协同数据，
-     * 同时填充本地元数据缓存并通知文件订阅者。
+     * 仅填充本地元数据缓存，不自动添加到协同数据。
+     * 需要手动调用 add() 方法将资源添加到协同数据。
+     *
+     * 同步完成后会自动清理孤立资源（没有对应文件的资源）
      */
     syncFromBackend(): Promise<void>;
+    /**
+     * 获取所有后端资源的元数据列表（从本地缓存）
+     *
+     * @returns 资源元数据数组
+     */
+    getAllMetadata(): Resource[];
+    /**
+     * 获取所有未添加到协同数据的资源列表
+     *
+     * @returns 未添加的资源元数据数组
+     */
+    getUnaddedResources(): Resource[];
     /**
      * 订阅资源列表变化事件（ADD/REMOVE）
      */

package/package.json

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