web-dc-api 0.1.5 → 0.1.7

package/lib/modules/file-module.ts

@@ -1,291 +0,0 @@
-// modules/file-module.ts
-// 文件功能模块
-
-import {  IFileOperations } from "../interfaces/file-interface";
-import { DCContext } from "../../lib/interfaces/DCContext";
-import { DCModule, CoreModuleName } from "../common/module-system";
-import { FileManager } from "../implements/file/manager";
-import { FileCacheManager } from "../implements/file/file-cache-manager";
-import { SeekableFileStream } from "../implements/file/seekableFileStream";
-import { createLogger } from "../util/logger";
-import { registerServiceWorker } from "../common/service-worker";
-
-const logger = createLogger('FileModule');
-
-/**
- * 文件模块
- * 提供文件上传、下载、缓存等功能
- */
-export class FileModule implements DCModule, IFileOperations {
-  readonly moduleName = CoreModuleName.FILE;
-  private fileManager!: FileManager;
-  private fileCacheManager!: FileCacheManager;
-  private initialized: boolean = false;
-  private swUrl: string;
-  
-  constructor(url: string) {
-    this.swUrl = url;
-  }
-
-  /**
-   * 初始化文件模块
-   * @param context DC上下文
-   * @returns 是否初始化成功
-   */
-  async initialize(context: DCContext): Promise<boolean> {
-    try {
-      this.fileManager = new FileManager(
-        context.dcutil,
-        context.connectedDc,
-        context.dcChain,
-        context.dcNodeClient,
-        context
-      );
-      
-      this.fileCacheManager = new FileCacheManager();
-      
-      // 注册 Service Worker
-      try {
-        logger.info('Service Worker 已开始注册');
-        const registration = await registerServiceWorker(this, this.swUrl || '');
-        if(registration) {
-          logger.info('Service Worker 注册成功');
-          context.swInited = true;
-        }else {
-          logger.warn('Service Worker 注册失败');
-          context.swInited = false;
-        }
-      } catch (err) {
-        logger.warn('Service Worker 注册失败:', err);
-        context.swInited = false;
-        // 服务工作者注册失败不阻断模块初始化
-      }
-      
-      this.initialized = true;
-      return true;
-    } catch (error) {
-      logger.error("文件模块初始化失败:", error);
-      return false;
-    }
-  }
-  
-  /**
-   * 关闭文件模块
-   */
-  async shutdown(): Promise<void> {
-    // 清理所有缓存
-    if (this.fileCacheManager) {
-      this.clearFileCache();
-      this.fileCacheManager.stopCacheCleanupTask();
-    }
-    this.initialized = false;
-  }
-  
-  /**
-   * 获取可寻址文件流
-   */
-  async getSeekableFileStream(ipfsPath: string, decryptKey: string): Promise<SeekableFileStream> {
-    
-    try {
-      this.assertInitialized();
-      // 先查看缓存
-      const cachedStream = this.fileCacheManager.getCachedFileStream(ipfsPath, decryptKey);
-      if (cachedStream) {
-        return cachedStream;
-      }
-      
-      // 没有缓存，创建新的流
-      const fileStream = await this.fileManager.createSeekableFileStream(ipfsPath, decryptKey);
-      if(!fileStream) {
-        throw new Error(`获取文件流失败: ${ipfsPath}`);
-      }
-      
-      // 将新创建的流保存到缓存
-      this.fileCacheManager.cacheFileStream(ipfsPath, decryptKey, fileStream);
-      
-      return fileStream;
-    } catch (error) {
-      logger.error(`获取文件流失败: ${ipfsPath}`, error);
-      throw new Error(`获取文件流失败: ${error instanceof Error ? error.message : String(error)}`);
-    }
-  }
-  
-  /**
-   * 清理文件缓存
-   */
-  clearFileCache(pathname?: string): void {
-    try {
-      this.assertInitialized();
-      this.fileCacheManager.clearFileCache(pathname);
-    } catch (error) {
-      logger.error(`清理文件缓存失败`, error);
-    }
-  }
-  
-  /**
-   * 获取缓存统计信息
-   */
-  getCacheStats(): [{ total: number, keys: string[] } | null, Error | null] {
-    try {
-      this.assertInitialized();
-      const stats = this.fileCacheManager.getCacheStats();
-      return [stats, null];
-    } catch (error) {
-      return [null, error as Error];
-    }
-  }
-  
-  /**
-   * 获取文件内容
-   */
-  async getFile(cid: string, decryptKey: string): Promise<[Uint8Array | null, Error | null]> {
-    try {
-      this.assertInitialized();
-      const fileContent = await this.fileManager.getFileFromDc(cid, decryptKey);
-      return [fileContent, null];
-    } catch (error) {
-      logger.error(`获取文件失败: ${cid}`, error);
-      throw [null, new Error(`获取文件失败: ${error instanceof Error ? error.message : String(error)}`)];
-    }
-  }
-  
-  /**
-   * 创建文件流
-   */
-  async createFileStream(
-    cid: string,
-    decryptKey: string
-  ): Promise<ReadableStream<Uint8Array> | null> {
-    try {
-      this.assertInitialized();
-      const fileStream = await this.fileManager.createSeekableFileStream(
-        cid,
-        decryptKey
-      );
-      if(!fileStream) {
-        return null;
-      }
-      return fileStream.createReadableStream();
-    } catch (error) {
-      logger.error(`创建文件流失败: ${cid}`, error);
-      return null;
-    }
-  }
-  
-  /**
-   * 添加文件
-   */
-  async addFile(
-    file: File,
-    enkey: string,
-    onUpdateTransmitSize: (status: number, size: number) => void
-  ): Promise<[string | null, Error | null]> {
-   
-    try {
-       this.assertInitialized();
-      if (!file) {
-        throw new Error("文件不能为空");
-      }
-      const res = await this.fileManager.addFile(file, enkey, onUpdateTransmitSize);
-      return res;
-    } catch (error) {
-      logger.error(`添加文件失败: ${file?.name}`, error);
-      return [null, new Error(`添加文件失败: ${error instanceof Error ? error.message : String(error)}`)];
-    }
-  }
-
-  /**
-   * 添加文件夹
-   */
-  async addFolder(
-    files: FileList,
-    enkey: string,
-    onUpdateTransmitCount: (status: number, total: number, process: number) => void
-  ): Promise<[string | null, Error | null]> {
-   
-    try {
-       this.assertInitialized();
-      if (!files || files.length === 0) {
-        throw new Error("文件夹不能为空");
-      }
-      const res = await this.fileManager.addFolder(files, enkey, onUpdateTransmitCount);
-      return res;
-    } catch (error) {
-      logger.error(`添加文件夹失败`, error);
-      return [null, new Error(`添加文件夹失败: ${error instanceof Error ? error.message : String(error)}`)];
-    }
-  }
-
-
-/**
- * 获取文件夹下的所有文件,包括内容（支持多级目录递归）
- * @param cid 根目录的CID
- * @param decryptKey 解密密钥
- * @param recursive 是否递归获取子目录，默认false（保持向后兼容）
- * @returns 文件列表：[{Name:文件或目录名，Type：0-文件 1-目录，Size：大小，Hash：文件或目录cid，Path：完整路径}]
- */
-async getFolderFileListWithContent(
-  cid: string, 
-  decryptKey: string, 
-  recursive: boolean = true
-): Promise<[Array<{Name: string; Type: number; Size: number; Hash: string; Path: string, Content?: Uint8Array}> | null, Error | null]> {
- const [fileList, err] = await this.fileManager.getFolderFileListWithContent(cid, decryptKey, recursive);
- return [fileList, err];
-}
-
-/**
- * 获取文件夹下的文件列表（支持多级目录递归）
- * @param cid 根目录的CID
- * @param flag 是否需要连接节点
- * @param recursive 是否递归获取子目录，默认false（保持向后兼容）
- * @returns 返回JSON格式的文件列表：[{Name:文件或目录名，Type：0-文件 1-目录，Size：大小，Hash：文件或目录cid，Path：完整路径}]
- */
-async getFolderFileList(
-  cid: string, 
-  flag?: number,
-  recursive: boolean = true
-): Promise<[Array<{Name: string; Type: number; Size: number; Hash: string; Path: string, Content?: Uint8Array}> | null, Error | null]> {
- const [fileList, err] = await this.fileManager.getFolderFileList(cid, flag, recursive);
- return [fileList, err];
-}
-
-
-
-
-  /**
-   * Creates a custom FileList object from file paths and contents
-   * @param filesMap - Map of file paths to content (string or Uint8Array)
-   * @param rootFolderName - Optional root folder name (defaults to "upload")
-   * @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 = "upload"
-  ): [FileList | null, Error | null] {
-    try {
-      this.assertInitialized();
-       // filesMap 判断
-    if (!filesMap || filesMap.size === 0) {
-      return [null, new Error("文件夹不能为空")];
-    }
-    const fileList = this.fileManager.createCustomFileList(filesMap, rootFolderName);
-    return [fileList, null];
-    } catch (error) {
-      logger.error("创建自定义文件列表失败:", error);
-      return [null, new Error("文件模块未初始化")];
-    }
-   
-   
-  }
-  
-  /**
-   * 断言模块已初始化
-   */
-  private assertInitialized(): void {
-    if (!this.initialized) {
-      throw new Error("文件模块未初始化");
-    }
-  }
-}

package/lib/modules/index.ts

@@ -1,13 +0,0 @@
-// modules/index.ts
-// 导出所有模块供注册使用
-
-export { FileModule } from './file-module';
-export { AuthModule } from './auth-module';
-export { CommentModule } from './comment-module';
-export { DatabaseModule } from './database-module';
-export { MessageModule } from './message-module';
-export { KeyValueModule } from './keyvalue-module';
-export { ClientModule } from './client-module';
-export { CacheModule  } from './cache-module';
-export { AIProxyModule } from './aiproxy-module';
-export { UtilModule } from './util-module';

package/lib/modules/keyvalue-module.ts

@@ -1,379 +0,0 @@
-// modules/keyvalue-module.ts
-// 键值存储功能模块
-
-import {  IKeyValueOperations } from "../interfaces/keyvalue-interface";
-import { DCContext } from "../../lib/interfaces/DCContext";
-import { DCModule, CoreModuleName } from "../common/module-system";
-import { KeyValueManager, KeyValueStoreType, KeyValueDB } from "../implements/keyvalue/manager";
-import { createLogger } from "../util/logger";
-import { ThemeAuthInfo, ThemeComment } from "../common/types/types";
-import { Direction } from "../common/define";
-import { ThemePermission } from "../common/constants";
-import {padPositiveInt20} from "../util/utils";
-const logger = createLogger('KeyValueModule');
-const indexkey_dckv = "indexkey_dckv"; //索引键名，keyvalue设置过程中key本身的索引键
-/**
- * 键值存储模块
- * 提供键值存储功能
- */
-export class KeyValueModule implements DCModule, IKeyValueOperations {
-  readonly moduleName = CoreModuleName.KEYVALUE;
-  private keyValueManager!: KeyValueManager;
-  private initialized: boolean = false;
-  private context: DCContext = {} as DCContext;
-  
-  /**
-   * 初始化键值存储模块
-   * @param context DC上下文
-   * @returns 是否初始化成功
-   */
-  async initialize(context: DCContext): Promise<boolean> {
-    try {
-      this.context = context;
-      this.keyValueManager = new KeyValueManager(
-        context.dcutil,
-        context.dcChain,
-        context
-      );
-      
-      this.initialized = true;
-      return true;
-    } catch (error) {
-      logger.error("键值存储模块初始化失败:", error);
-      return false;
-    }
-  }
-  
-  /**
-   * 关闭键值存储模块
-   */
-  async shutdown(): Promise<void> {
-    this.initialized = false;
-  }
-  
-  /**
-   * 创建存储主题
-   * @param appId 应用ID
-   * @param themeAuthor 主题作者
-   * @param theme 主题名称
-   * @param space 空间大小
-   * @param type 主题类型
-   * @returns 创建结果
-   */
-  async createStore(
-    appId: string,
-    theme: string,
-    space: number,
-    type: KeyValueStoreType
-  ): Promise<[KeyValueDB|null, Error | null]> {
-   const err = this.assertInitialized();
-    if (err) {
-      return [null, err];
-    }
-    
-    try {
-      const [kvdb,err] = await this.keyValueManager.createStore(
-        appId,
-        theme,
-        space,
-        type
-      );
-      return [kvdb,err];
-    } catch (error) {
-      return [null, error instanceof Error ? error : new Error(String(error))];
-    }
-  }
-
-  
-  async getStore(
-    appId: string,
-    theme: string,
-    themeAuthor: string
-  ): Promise<[KeyValueDB|null, Error | null]> {
-    const err = this.assertInitialized();
-    if (err) {
-      return [null, err];
-    }
-    try {
-      const [kvdb,err] = await this.keyValueManager.getKeyValueDB(
-        appId,
-        theme,
-        themeAuthor
-      );
-      return [kvdb,err];
-    } catch (error) {
-      return [null, error instanceof Error ? error : new Error(String(error))];
-    }
-  }
-  
-
-  
-   async configAuth(
-    kvdb: KeyValueDB,
-    authPubkey: string,
-    permission: ThemePermission,
-    remark: string,
-    vaccount?: string
-  ): Promise<[number | null, Error | null]> {
-    const err = this.assertInitialized();
-    if (err) {
-      return [null, err];
-    }
-    
-    try {
-       const res = await kvdb.configAuth(authPubkey, permission, remark, vaccount);
-      return res;
-    } catch (error) {
-      return [null, error instanceof Error ? error : new Error(String(error))];
-    }
-  }
-   async getAuthList(
-    kvdb: KeyValueDB,
-    vaccount?: string
-  ): Promise<[ThemeAuthInfo[]|null,ThemeComment[] | null, Error | null]> {
-    const err = this.assertInitialized();
-    if (err) {
-      return [null, null,err];
-    }
-    
-    try {
-      const res = await kvdb.getAuthList(vaccount);
-      return res;
-    } catch (error) {
-      return [null, null, error instanceof Error ? error : new Error(String(error))];
-    }
-  }
-  
-
-  
-  async set(
-    kvdb: KeyValueDB,
-    key: string,
-    value: string,
-    indexs: string, //索引列表,格式为json字符串:[{key:"indexkey1",type:"string",value:"value"},{key:"indexkey2",type:"number", value:12}],这里统一转换格式为key1:value1$$$key2:value2
-    vaccount?: string
-  ): Promise<[boolean | null, number | null, Error | null]> {
-     const err = this.assertInitialized();
-    if (err) {
-      return [null, null, err];
-    }
-    
-    try {
-      //进行格式转换
-      let strIndexs = "";
-      try {
-        if (indexs && indexs != "") {
-          const indexArray = JSON.parse(indexs);
-          for (const index of indexArray) {
-            let indexValue = "";
-            if( index.type === "number" ){ //
-              indexValue = padPositiveInt20(index.value);
-            }else{
-              indexValue = index.value;
-            }
-            strIndexs += `${index.key}:${indexValue}$$$`;
-          }
-          
-         
-        }
-      } catch (error) {
-        logger.error(`设置索引,解析失败:`, error);
-      }
-      const res = await kvdb.set(key, value, strIndexs, vaccount);
-      return res;
-    } catch (error) {
-      return [null,null, error instanceof Error ? error : new Error(String(error))];
-    }
-  }
-
-
- /**
-   * 获取当前用户设置的指定键的元数据
-   * @param kvdb 
-   * @param key 
-   * @param vaccount 
-   * @returns  [值, 错误信息],值的格式:  value$$$dckv_extra$$${'dc_timestamp':'%d','dc_opuser':'%s'}
-   */
-  async getValueSetByCurrentUser(kvdb: KeyValueDB, key: string,vaccount?: string): Promise<[string | null, Error | null]> {
-    if(!this.context.publicKey){
-      return [null, new Error("当前用户公钥未设置")];
-    }
-    return this.get(kvdb,key, this.context.publicKey.string(), vaccount);
-  }
-
-
-  /**
-   * 获取指定键的元数据
-   * @param kvdb 
-   * @param key 
-   * @param writerPubkey 
-   * @param vaccount 
-   * @returns  [值, 错误信息],值的格式:  value$$$dckv_extra$$${'dc_timestamp':'%d','dc_opuser':'%s'}
-   */
-  async get(
-    kvdb: KeyValueDB,
-    key: string,
-    writerPubkey?: string,
-    vaccount?: string
-  ): Promise<[string | null, Error | null]> {
-     const err = this.assertInitialized();
-    if (err) {
-      return [null, err];
-    }
-    
-    try {
-      const res = await kvdb.get(key, writerPubkey, vaccount);
-      return res;
-    } catch (error) {
-      return [null, error instanceof Error ? error : new Error(String(error))];
-    }
-  }
-
-
-   /**
-   * 获取指定键的值列表
-   * @param kvdb: KeyValueDB,
-   * @param key 键名
-   * @param limit 返回结果数量限制
-   * @param seekKey 查询起始键,用于分页查询
-   * @param offset 结果偏移量
-   * @param vaccount 可选的虚拟账户
-   * @returns [值列表数组生成的json字符串, 错误信息] 数组的每个元素的格式:  key:value$$$dckv_extra$$${'dc_timestamp':'%d','dc_opuser':'%s'}
-   */
-  async getValues(
-    kvdb: KeyValueDB,
-    key: string,
-    options: { limit?: number; seekKey?: string; direction?: Direction; offset?: number } ,
-    vaccount?: string
-  ): Promise<[string | null, Error | null]> {
-     const err = this.assertInitialized();
-    if (err) {
-      return [null, err];
-    }
-    const limit = options.limit? options.limit: 10;
-    const seekKey = options.seekKey? options.seekKey: "";
-    const direction = options.direction? options.direction: Direction.Forward;
-    const offset = options.offset? options.offset: 0;
-    try {
-      const res = await kvdb.getWithIndex(indexkey_dckv, key, limit, seekKey, direction, offset, vaccount);
-      return res;
-    } catch (error) {
-      return [null, error instanceof Error ? error : new Error(String(error))];
-    }
-  }
-  
-  /**
-   * 批量获取指定键的值
-   * @param kvdb KeyValueDB实例
-   * @param keys 逗号分隔的键列表
-   * @param writerPubkey 可选，指定写入者公钥
-   * @param vaccount 可选的虚拟账户
-   * @returns [值的数组的JSON字符串, 错误信息] 数组的每个元素的格式:  key:value$$$dckv_extra$$${'dc_timestamp':'%d','dc_opuser':'%s'}
-   */
-  async getBatch(
-    kvdb: KeyValueDB,
-    keys: string,
-    writerPubkey: string = "",
-    vaccount: string = ""
-  ): Promise<[string | null, Error | null]> { 
-    const err = this.assertInitialized();
-    if (err) {
-      return [null, err];
-    }
-
-    try {
-      const res = await kvdb.getBatch(keys, writerPubkey, vaccount);
-      return res;
-    } catch (error) {
-      return [null, error instanceof Error ? error : new Error(String(error))];
-    }
-  }
-
-  /**
-   * 获取指定索引的值
-   * @param kvdb KeyValueDB实例
-   * @param indexKey 索引键名
-   * @param indexValue 索引值
-   * @param type 索引值类型
-   * @param seekKey 查询起始键,用于分页查询
-   * @param direction 查询方向
-   * @param offset 结果偏移量
-   * @param vaccount 可选的虚拟账户
-   * @returns [值的数组形式的JSON字符串, 错误信息] 数组的每个元素的格式:  key:value$$$dckv_extra$$${'dc_timestamp':'%d','dc_opuser':'%s'}
-   */ 
-   async getWithIndex(
-    kvdb: KeyValueDB,
-    indexKey:string,
-    indexValue:string,
-    options: {type?:string; limit?: number; seekKey?: string; direction?: Direction; offset?: number } ,
-    vaccount?: string
-  ): Promise<[string | null, Error | null]> {
-    const err = this.assertInitialized();
-    if (err) {
-      return [null, err];
-    }
-    const limit = options.limit? options.limit: 10;
-    const seekKey = options.seekKey? options.seekKey: "";
-    const direction = options.direction? options.direction: Direction.Forward;
-    const offset = options.offset? options.offset: 0;
-    let indexValueStr = "";
-    if( options.type === "number" ){ //
-      indexValueStr = padPositiveInt20(indexValue);
-    }
-    try {
-      const res = await kvdb.getWithIndex(indexKey, indexValueStr, limit,seekKey, direction,offset,  vaccount);
-    return res;
-    } catch (error) {
-      return [null, error instanceof Error ? error : new Error(String(error))];
-    }
-  }
-
-  /**
-   * 按设置时间顺序获取主题的的键值对列表
-   * @param kvdb KeyValueDB实例
-   * @param limit 返回结果数量限制
-   * @param seekKey 查询起始键,用于分页查询
-   * @param direction 查询方向 
-   * @param offset 结果偏移量
-   * @param vaccount 可选的虚拟账户
-   * @returns [值列表数组生成的json字符串, 错误信息] 数组的每个元素的格式:  key:value$$$dckv_extra$$${'dc_timestamp':'%d','dc_opuser':'%s'}
-   */
-  async getWithTimeOrder(
-    kvdb: KeyValueDB,
-    timestamp: number,//毫秒时间戳
-    options: { limit?: number; seekKey?: string; direction?: Direction; offset?: number },
-    vaccount?: string
-  ): Promise<[string | null, Error | null]> {
-    const err = this.assertInitialized();
-    if (err) {
-      return [null, err];
-    }
-    let timestampStr = "";
-    if( timestamp > 0 ){
-      //把毫秒时间转为微妙时间戳字符串,与DC节点存储的时间戳格式一致
-      timestampStr = padPositiveInt20(timestamp * 1000);
-      //前面补0,保证长度为20位
-      timestampStr = timestampStr.padStart(20, "0");
-    }
-    const limit = options.limit ? options.limit : 10;
-    const seekKey = options.seekKey ? options.seekKey : "";
-    const direction = options.direction ? options.direction : Direction.Forward;
-    const offset = options.offset ? options.offset : 0;
-    try {
-      const res = await kvdb.getWithIndex("indexkey_timestamp", timestampStr, limit, seekKey, direction, offset, vaccount);
-      return res;
-    } catch (error) {
-      return [null, error instanceof Error ? error : new Error(String(error))];
-    }
-  }
-  
-
-  /**
-   * 断言模块已初始化
-   */
-  private assertInitialized(): Error | void {
-    if (!this.initialized) {
-      return Error("键值存储模块未初始化");
-    }
-  }
-}