web-dc-api 0.1.11 → 0.1.13

package/dist/index.d.ts

@@ -3858,7 +3858,7 @@ interface IAuthOperations {
      * @param seccode 安全码
      * @param mnemonic 助记词 (可选，如果是主账号登录则需要)
      */
-    nftAccountPasswordModify(account: string, password: string, seccode: string, mnemonic?: string): Promise<Error | null>;
+    nftAccountPasswordModify(account: string, password: string, seccode: string, mnemonic?: string): Promise<[boolean | null, Error | null]>;
     /**
      * 创建APP访问账号,返回APP专用私钥
      * @param appId 应用ID
@@ -4164,6 +4164,10 @@ declare class SeekableFileStream {
         start?: number;
         end?: number;
     }): ReadableStream<Uint8Array>;
+    /**
+     * 获取文件CID
+     */
+    getCid(): CID;
 }
 
 /**
@@ -4178,6 +4182,14 @@ interface IFileOperations {
      * @returns 可寻址文件流实例
      */
     getSeekableFileStream(ipfsPath: string, decryptKey: string): Promise<SeekableFileStream>;
+    /**
+     * 获取指定文件夹CID中指定路径的文件流
+     * @param rootCid 根文件夹CID
+     * @param filePath 文件相对路径
+     * @param decryptKey 解密密钥
+     * @returns 可寻址文件流实例
+     */
+    getSeekableFileStreamFromDir(rootCid: string, filePath: string, decryptKey: string): Promise<SeekableFileStream>;
     /**
      * 清理文件缓存
      * @param pathname 可选的特定路径，不提供则清除所有缓存
@@ -4198,6 +4210,21 @@ interface IFileOperations {
      * @returns 文件的字节数组，失败则返回undefined
      */
     getFile(cid: string, decryptKey: string): Promise<[Uint8Array | null, Error | null]>;
+    /**
+     * 获取指定文件夹CID中指定路径的文件内容或目录列表
+     * @param rootCid 根文件夹CID
+     * @param filePath 文件相对路径
+     * @param decryptKey 解密密钥
+     * @returns 文件的字节数组或目录列表，失败则返回undefined
+     */
+    getFileFromDir(rootCid: string, filePath: string, decryptKey: string): Promise<[Uint8Array | Array<{
+        Name: string;
+        Type: number;
+        Size: number;
+        Hash: string;
+        Path: string;
+        Content?: Uint8Array;
+    }> | null, Error | null]>;
     /**
      * 创建文件可读流
      * @param cid 文件的内容标识符
@@ -4258,6 +4285,12 @@ interface IFileOperations {
      * @returns 自定义文件列表对象
      */
     createCustomFileList(filesMap: Map<string, string | Uint8Array | ArrayBuffer> | Record<string, string | Uint8Array | ArrayBuffer>, rootFolderName: string): [FileList | null, Error | null];
+    /**
+     * 判断CID是文件还是目录
+     * @param cid
+     * @returns 'file' | 'directory' | 'unknown'
+     */
+    isFileOrDir(cid: string): Promise<'file' | 'directory' | 'unknown'>;
 }
 
 /** Namespace dcnet. */
@@ -27853,6 +27886,10 @@ declare class FileModule implements DCModule, IFileOperations {
      * 获取可寻址文件流
      */
     getSeekableFileStream(ipfsPath: string, decryptKey: string): Promise<SeekableFileStream>;
+    /**
+     * 获取指定文件夹CID中指定路径的文件流
+     */
+    getSeekableFileStreamFromDir(rootCid: string, filePath: string, decryptKey: string): Promise<SeekableFileStream>;
     /**
      * 清理文件缓存
      */
@@ -27917,10 +27954,25 @@ declare class FileModule implements DCModule, IFileOperations {
      * @returns A FileList-like object that can be used with addFolder
      */
     createCustomFileList(filesMap: Map<string, string | Uint8Array | ArrayBuffer> | Record<string, string | Uint8Array | ArrayBuffer>, rootFolderName?: string): [FileList | null, Error | null];
+    /**
+     * 判断CID是文件还是目录
+     */
+    isFileOrDir(cid: string): Promise<'file' | 'directory' | 'unknown'>;
     /**
      * 断言模块已初始化
      */
     private assertInitialized;
+    /**
+     * 获取指定文件夹CID中指定路径的文件内容或目录列表
+     */
+    getFileFromDir(rootCid: string, filePath: string, decryptKey: string): Promise<[Uint8Array | Array<{
+        Name: string;
+        Type: number;
+        Size: number;
+        Hash: string;
+        Path: string;
+        Content?: Uint8Array;
+    }> | null, Error | null]>;
 }
 
 /**
@@ -27952,10 +28004,7 @@ declare class AuthModule implements DCModule, IAuthOperations {
      * 账户登录(钱包登录)不抛出异常
      * @returns [账户信息, 错误信息]
      */
-    accountLoginWithWallet(accountInfo?: AccountInfo): Promise<[
-        Account | null,
-        Error | null
-    ]>;
+    accountLoginWithWallet(accountInfo?: AccountInfo): Promise<[Account | null, Error | null]>;
     exitLogin(): void;
     /**
      * 账户登录(钱包登录)不抛出异常
@@ -27972,7 +28021,7 @@ declare class AuthModule implements DCModule, IAuthOperations {
      * @param seccode 安全码
      * @param mnemonic 助记词 (可选，如果是主账号登录则需要)
      */
-    nftAccountPasswordModify(account: string, password: string, seccode: string, mnemonic?: string): Promise<Error | null>;
+    nftAccountPasswordModify(account: string, password: string, seccode: string, mnemonic?: string): Promise<[boolean | null, Error | null]>;
     signWithWallet(payload: Uint8Array): Promise<Uint8Array>;
     sign(payload: Uint8Array): Promise<[Uint8Array | null, Error | null]>;
     decryptWithWallet(payload: Uint8Array): Promise<[Uint8Array | null, Error | null]>;
@@ -28021,10 +28070,7 @@ declare class AuthModule implements DCModule, IAuthOperations {
     /**
      * 开启定时验证 token 线程,不抛出异常
      */
-    startDcPeerTokenKeepValidTask(): Promise<[
-        boolean,
-        Error | null
-    ]>;
+    startDcPeerTokenKeepValidTask(): Promise<[boolean, Error | null]>;
     /**
      * 停止token验证任务,不抛出异常
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "web-dc-api",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "web相关的dcapi",
   "type": "module",
   "browser": "dist/dc.min.js",