web-dc-api 0.1.48 → 0.1.49

package/dist/esm/interfaces/database-interface.d.ts

@@ -0,0 +1,138 @@
+import { ICollectionConfig, IDBInfo } from "../implements/threaddb/core/core";
+/**
+ * 数据库操作接口,这个数据库主要由threadid确保唯一,servicekey,readkey多重加密来确保数据安全,其中readkey永远不离开用户,servicekey会在DC云端的TEE环境中参与数据备份
+ * 提供基于ThreadDB的分布式数据库管理功能
+ */
+export interface IDatabaseOperations {
+    /**
+     * 初始化数据库管理器
+     * 创建数据库操作所需的组件和服务
+     * @returns 错误信息
+     */
+    initDBManager(): Promise<Error | null>;
+    resetDBManager(): void;
+    /**
+     * 创建新数据库
+     * @param name 数据库名称
+     * @param b32Rk base32编码的读取密钥
+     * @param b32Sk base32编码的服务密钥
+     * @param jsonCollections 集合配置数组，定义数据库中的集合结构
+     * @returns 创建的线程ID和错误信息
+     */
+    newDB(name: string, b32Rk: string, b32Sk: string, jsonCollections: ICollectionConfig[]): Promise<[string | null, Error | null]>;
+    /**
+     * 从分布式网络同步数据库
+     * @param threadid 线程ID
+     * @param dbname 数据库名称
+     * @param dbAddr 数据库地址
+     * @param b32Rk base32编码的读取密钥
+     * @param b32Sk base32编码的服务密钥
+     * @param block 是否阻塞等待同步完成
+     * @param collectionInfos 集合配置数组，定义数据库中的集合结构
+     * @returns 错误信息或null表示成功
+     */
+    syncDbFromDC(threadid: string, dbname: string, dbAddr: string, b32Rk: string, b32Sk: string, block: boolean, collectionInfos: ICollectionConfig[]): Promise<Error | null>;
+    /**
+     * 刷新数据库，从分布式网络获取最新数据
+     * @param threadid 数据库线程ID
+     * @returns 错误信息或null表示成功
+     */
+    refreshDBFromDC(threadid: string): Promise<Error | null>;
+    /**
+     * 同步数据库到分布式网络
+     * @param tId 线程ID
+     * @returns 错误信息或null表示成功
+     */
+    syncDBToDC(tId: string): Promise<Error | null>;
+    autoExpandDBSpace(threadId: string, expandSpace: number): Promise<boolean>;
+    /**
+     * 获取数据库信息
+     * @param id threaddbID
+     * @returns 数据库信息字符串,或错误
+     */
+    getDBInfo(id: string): Promise<[IDBInfo | null, Error | null]>;
+    /**
+     * 升级集合结构
+     * @param threadId 线程ID
+     * @param collections 集合配置列表
+     * @returns 错误信息或null
+     */
+    upgradeCollections(threadId: string, collections: ICollectionConfig[]): Promise<Error | null>;
+    /**
+     * 关闭数据库管理器
+     * @throws 关闭失败时抛出错误
+     */
+    close(): Promise<Error | null>;
+    /**
+     * 在集合中创建新对象实例
+     * @param threadId 线程ID
+     * @param collectionName 集合名称
+     * @param jsonInstance JSON字符串表示的实例对象
+     * @returns 创建的实例ID,或错误
+     */
+    create(threadId: string, collectionName: string, jsonInstance: string): Promise<[string | null, Error | null]>;
+    /**
+     * 通过ID删除实例
+     * @param threadId 线程ID
+     * @param collectionName 集合名称
+     * @param instanceID 要删除的实例ID
+     * @throws 删除失败时抛出错误
+     */
+    delete(threadId: string, collectionName: string, instanceID: string): Promise<Error | null>;
+    /**
+     * 更新已存在的实例
+     * @param threadId 线程ID
+     * @param collectionName 集合名称
+     * @param instance JSON字符串表示的实例对象
+     * @throws 更新失败时抛出错误
+     */
+    save(threadId: string, collectionName: string, instance: string): Promise<Error | null>;
+    /**
+     * 批量删除多个实例
+     * @param threadId 线程ID
+     * @param collectionName 集合名称
+     * @param instanceIDs 逗号分隔或JSON数组表示的实例ID列表
+     * @throws 删除失败时抛出错误
+     */
+    deleteMany(threadId: string, collectionName: string, instanceIDs: string): Promise<Error | null>;
+    /**
+     * 检查指定实例是否存在
+     * @param threadId 线程ID
+     * @param collectionName 集合名称
+     * @param instanceID 要检查的实例ID
+     * @returns 布尔值表示实例是否存在
+     */
+    has(threadId: string, collectionName: string, instanceID: string): Promise<boolean>;
+    /**
+     * 根据查询条件查找实例
+     * @param threadId 线程ID
+     * @param collectionName 集合名称
+     * @param queryString JSON字符串表示的查询条件,
+     * 格式举例:(condition表示and条件组合, ors表示或条件组合, sort表示排序, seek表示分页)
+     * 格式1: `{"condition":"age=80 and name='John'"}`,"sort":{"fieldPath":"age","desc":true}}`
+     * 格式2: `{"ors":[{"condition":"age = 21 and name = 'foo'"}]}`
+     * 格式3: `{"condition":"age > 21 ","ors":[{"condition":"age = 21 and name = 'foo'"}],"sort":{"fieldPath":"age","desc":true},skip:10,"seek":"01fyc691gh671nf0s8qpt0ych8"}`
+     * @returns JSON字符串表示的查询结果
+     * @throws 查询失败时抛出错误
+     */
+    find(threadId: string, collectionName: string, queryString?: string): Promise<[string | null, Error | null]>;
+    /**
+     * 通过ID查找实例
+     * @param threadId 线程ID
+     * @param collectionName 集合名称
+     * @param instanceID 实例ID
+     * @returns JSON字符串表示的实例
+     * @throws 查询失败时抛出错误
+     */
+    findByID(threadId: string, collectionName: string, instanceID: string): Promise<[string | null, Error | null]>;
+    /**
+     * 获取在指定时间后被修改的实例ID列表
+     * @param threadId 线程ID
+     * @param collectionName 集合名称
+     * @param time 时间戳（毫秒）
+     * @returns JSON字符串表示的实例ID列表
+     * @throws 查询失败时抛出错误
+     */
+    modifiedSince(threadId: string, collectionName: string, time: number): Promise<[string | null, Error | null]>;
+}
+//# sourceMappingURL=database-interface.d.ts.map

package/dist/esm/interfaces/database-interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-interface.d.ts","sourceRoot":"","sources":["../../../lib/interfaces/database-interface.ts"],"names":[],"mappings":"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"}

package/dist/esm/interfaces/file-interface.d.ts

@@ -0,0 +1,124 @@
+import { SeekableFileStream } from "../implements/file/seekableFileStream";
+/**
+ * 文件操作接口
+ * 提供文件上传、下载、缓存等功能
+ */
+export interface IFileOperations {
+    /**
+     * 获取可寻址文件流
+     * @param ipfsPath IPFS路径或CID
+     * @param decryptKey 解密密钥,base32的symmetric key
+     * @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 可选的特定路径，不提供则清除所有缓存
+     */
+    clearFileCache(pathname?: string): void;
+    /**
+     * 获取缓存统计信息
+     * @returns 包含缓存总数和键列表的统计对象
+     */
+    getCacheStats(): [{
+        total: number;
+        keys: string[];
+    } | null, Error | null];
+    /**
+     * 获取文件内容
+     * @param cid 文件的内容标识符
+     * @param decryptKey 解密密钥
+     * @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 文件的内容标识符
+     * @param decryptKey 解密密钥
+     * @returns 可读流对象，失败则返回null
+     */
+    createFileStream(cid: string, decryptKey: string): Promise<ReadableStream<Uint8Array> | null>;
+    /**
+     * 添加文件到存储
+     * @param file 要上传的文件对象
+     * @param enkey 加密密钥
+     * @param onUpdateTransmitSize 传输进度回调函数
+     * @returns 添加结果
+     */
+    addFile(file: File, enkey: string, onUpdateTransmitSize: (status: number, size: number) => void): Promise<[string | null, Error | null]>;
+    /**
+     * 添加文件夹到存储
+     * @param files 要上传的文件夹下的文件列表
+     * @param enkey 加密密钥,base32的symmetric key
+     * @param onUpdateTransmitCount 传输进度回调函数
+     * @returns 添加结果
+     */
+    addFolder(files: FileList, enkey: string, onUpdateTransmitCount: (status: number, total: number, process: number) => void): Promise<[string | null, Error | null]>;
+    /**
+     * 获取文件夹下的所有文件,包括内容（支持多级目录递归）
+     * @param cid 根目录的CID
+     * @param decryptKey 解密密钥
+     * @param recursive 是否递归获取子目录，默认false（保持向后兼容）
+     * @returns 文件列表：[{Name:文件或目录名，Type：0-文件 1-目录，Size：大小，Hash：文件或目录cid，Path：完整路径}]
+     */
+    getFolderFileListWithContent(cid: string, decryptKey: string, recursive: boolean): Promise<[Array<{
+        Name: string;
+        Type: number;
+        Size: number;
+        Hash: string;
+        Path: string;
+        Content?: Uint8Array;
+    }> | null, Error | null]>;
+    /**
+     * 获取文件夹下的文件列表（支持多级目录递归）
+     * @param cid 根目录的CID
+     * @param flag 是否需要连接节点
+     * @param recursive 是否递归获取子目录，默认false（保持向后兼容）
+     * @returns 返回JSON格式的文件列表：[{Name:文件或目录名，Type：0-文件 1-目录，Size：大小，Hash：文件或目录cid，Path：完整路径}]
+     */
+    getFolderFileList(cid: string, flag: number, recursive: boolean): Promise<[Array<{
+        Name: string;
+        Type: number;
+        Size: number;
+        Hash: string;
+        Path: string;
+        Content?: Uint8Array;
+    }> | null, Error | null]>;
+    /**
+     * 创建自定义文件列表
+     * @param filesMap 文件列表，可以是Map或Record对象
+     * @param rootFolderName 根文件夹名称
+     * @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'>;
+}
+//# sourceMappingURL=file-interface.d.ts.map

package/dist/esm/interfaces/file-interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-interface.d.ts","sourceRoot":"","sources":["../../../lib/interfaces/file-interface.ts"],"names":[],"mappings":"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"}

package/dist/esm/interfaces/index.d.ts

@@ -0,0 +1,11 @@
+export type { IAuthOperations } from './auth-interface';
+export type { IClientOperations } from './client-interface';
+export type { IDatabaseOperations } from './database-interface';
+export type { IFileOperations } from './file-interface';
+export type { IMessageOperations } from './message-interface';
+export type { IKeyValueOperations } from './keyvalue-interface';
+export type { ICommentOperations } from './comment-interface';
+export type { ICacheOperations } from './cache-interface';
+export type { DCContext } from './DCContext';
+export type { IUtilOperations } from './util-interface';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/interfaces/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../lib/interfaces/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAC,eAAe,EAAC,MAAM,kBAAkB,CAAC;AACtD,YAAY,EAAC,iBAAiB,EAAC,MAAM,oBAAoB,CAAC;AAC1D,YAAY,EAAC,mBAAmB,EAAC,MAAM,sBAAsB,CAAC;AAC9D,YAAY,EAAC,eAAe,EAAC,MAAM,kBAAkB,CAAC;AACtD,YAAY,EAAC,kBAAkB,EAAC,MAAM,qBAAqB,CAAC;AAC5D,YAAY,EAAC,mBAAmB,EAAC,MAAM,sBAAsB,CAAC;AAC9D,YAAY,EAAC,kBAAkB,EAAC,MAAM,qBAAqB,CAAC;AAC5D,YAAY,EAAC,gBAAgB,EAAC,MAAM,mBAAmB,CAAC;AACxD,YAAY,EAAC,SAAS,EAAC,MAAO,aAAa,CAAC;AAC5C,YAAY,EAAC,eAAe,EAAC,MAAM,kBAAkB,CAAC"}

package/dist/esm/interfaces/keyvalue-interface.d.ts

@@ -0,0 +1,173 @@
+import { Direction } from "../common/define";
+import { ThemePermission } from "../common/constants";
+import { ThemeAuthInfo, ThemeComment } from "../common/types/types";
+import { KeyValueStoreType, KeyValueDB } from "../implements/keyvalue/manager";
+/**
+ * 键值存储操作接口
+ * 提供分布式键值存储的创建、权限管理和数据操作功能
+ */
+export interface IKeyValueOperations {
+    /**
+     * 创建key-value存储库
+     * @param appId 应用ID
+     * @param theme 库主题名称
+     * @param space 分配的存储空间大小（字节）
+     * @param type 存储主题类型 1:鉴权主题(读写都需要鉴权) 2:公共主题(默认所有用户可读,写需要鉴权)
+     * @returns 创建的keyvalue数据库实例和可能的错误信息
+     */
+    createStore(appId: string, theme: string, space: number, type: KeyValueStoreType): Promise<[KeyValueDB | null, Error | null]>;
+    /**
+     * 获取指定主题的keyvalue数据库
+     * @param appId 应用ID
+     * @param theme 主题名称
+     * @param themeAuthor 数据库创建者的公钥
+     * @returns keyvalue数据库实例
+     */
+    getStore(appId: string, theme: string, themeAuthor: string): Promise<[KeyValueDB | null, Error | null]>;
+    /**
+     * 配置主题的授权信息
+     * @param kvdb keyvalue数据库实例
+     * @param authPubkey 被授权者的公钥
+     * @param permission 权限级别
+     * @param remark 备注信息
+     * @param vaccount 可选的虚拟账户
+     * @returns [授权状态码, 错误信息]
+     */
+    configAuth(kvdb: KeyValueDB, authPubkey: string, permission: ThemePermission, remark: string, vaccount?: string): Promise<[number | null, Error | null]>;
+    /**
+     * 获取主题的授权列表
+     * @param kvdb keyvalue数据库实例
+     * @param vaccount 可选的虚拟账户
+     * @returns [授权列表,含签名的原始授权列表, 错误信息]
+     */
+    getAuthList(kvdb: KeyValueDB, vaccount?: string): Promise<[ThemeAuthInfo[] | null, ThemeComment[] | null, Error | null]>;
+    /**
+      * 获取当前用户自身的kevdb授权信息,用户自己调用
+      * @param kvdb keyvalue数据库实例
+      * @param vaccount 可选的虚拟账户
+      * @returns [授权配置, 错误信息]
+      */
+    GetUserOwnAuth(kvdb: KeyValueDB, vaccount?: string): Promise<[ThemeAuthInfo | null, Error | null]>;
+    /**
+       * 获取指定用户授权信息
+       * @param kvdb keyvalue数据库实例
+       * @param userPubkey 用户公钥
+       * @param vaccount 可选的虚拟账户
+       * @returns [授权信息, 错误信息]
+       */
+    GetUserAuth(kvdb: KeyValueDB, userPubkey: string, vaccount?: string): Promise<[ThemeAuthInfo | null, Error | null]>;
+    /**
+     * 设置键值对，支持索引功能
+     * @param kvdb: KeyValueDB,
+     * @param key 键名
+     * @param value 值内容
+     * @param indexs 索引列表，格式为json字符串:[{key:"indexkey1",type:"string",value:"value"},{key:"indexkey2",type:"number", value:12}],设置索引后,后续查询可以通过索引快速定位
+     * @param vaccount 可选的虚拟账户
+     * @returns [是否设置成功, 时间戳, 错误信息]
+     */
+    set(kvdb: KeyValueDB, key: string, value: string, indexs: string, vaccount?: string): Promise<[boolean | null, number | null, Error | null]>;
+    /**
+    * 设置需要统计功能的键值对,调用本方法如果valueFlag为false时,会为key对应value中的指定字段进行加减操作,这时直接可以通过get方法传入key获取到最新的值内容
+    * 也自动为DB全局的统计字段进行加减操作，如果valueFlag为true,则只为DB全局的统计字段进行加减操作,支持索引功能
+    * @param kvdb: KeyValueDB,
+    * @param key 键名
+    * @param value  值内容,格式如下:{add:{"field1":10,"field2":5},sub:{"field1":10,"field2":-5},allflag:true,countdate:"2020-01-01",yearFlag:true,monthFlag:true,valueFlag:true,value:"value"}
+    *              表示对field1进行加10,减10,对field2进行加5,减-5,allflag表示是不是累计到主题总计数上,如果为true,则同时更新主题的总计数,否则只更新当前key的统计值,countdate不为空表示统计
+    *              到所有key累计的总的countdate日期上,yearFlag为true,表示统计值添加到所有key累计的总的按年统计,monthFlag为true,表示统计值添加到所有key累计的总的按月统计,valueFlag为true,表示同时设置该key的值为value字段指定的内容
+    * @param indexs 索引列表，格式为json字符串:[{key:"indexkey1",type:"string",value:"value"},{key:"indexkey2",type:"number", value:12}],设置索引后,后续查询可以通过索引快速定位
+    * @param vaccount 可选的虚拟账户
+    * @returns [是否设置成功, 时间戳, 错误信息]
+    */
+    setWithCount(kvdb: KeyValueDB, key: string, value: string, indexs: string, vaccount?: string): Promise<[boolean | null, number | null, Error | null]>;
+    /**  获取DB全局的统计数据,即所有key设置操作累计的的统计数据汇总
+     * @param kvdb: KeyValueDB,
+     * @param countType 统计类型,0:总计数,1:按天统计,2:按月统计,3:按年统计
+     * @param typeStr 类型字符串,countType:0 时为空, countType:1时格式为"yyyy-MM-dd",countType:2时格式为"yyyy-MM",countType:3时格式为"yyyy"
+     * @param vaccount 可选的虚拟账户
+     * @returns [统计值json字符串格式{field1:10,field2:5}, 错误信息]
+     */
+    getDBCount(kvdb: KeyValueDB, countType: number, //统计类型,0:总计数,1:按天统计,2:按月统计,3:按年统计
+    typeStr: string, //类型字符串,countType:0 时为空, countType:1时格式为"yyyy-MM-dd",countType:2时格式为"yyyy-MM",countType:3时格式为"yyyy"
+    vaccount?: string): Promise<[string | null, Error | null]>;
+    /**
+       * 获取当前用户设置的指定键的元数据
+       * @param kvdb
+       * @param key
+       * @param vaccount
+       * @returns  [值, 错误信息],值的格式:  value$$$dckv_extra$$${'dc_timestamp':'%d','dc_opuser':'%s'}
+       */
+    getValueSetByCurrentUser(kvdb: KeyValueDB, key: string, vaccount?: string): Promise<[string | null, Error | null]>;
+    /**
+     * 获取指定键的值
+     * @param kvdb: KeyValueDB,
+     * @param key 键名
+     * @param writerPubkey 写入者的公钥,如果不指定，则获取所有用户写入的该key的最新值
+     * @param vaccount 可选的虚拟账户
+     * @returns [值内容, 错误信息] 值的格式:  value$$$dckv_extra$$${'dc_timestamp':'%d','dc_opuser':'%s'}
+     */
+    get(kvdb: KeyValueDB, key: string, writerPubkey?: string, vaccount?: string): Promise<[string | null, Error | null]>;
+    /**
+      * 获取指定键的值列表,按key的字典序排序
+      * @param kvdb: KeyValueDB,
+      * @param key 键名
+      * @param limit 返回结果数量限制
+      * @param seekKey 查询起始键,用于分页查询
+      * @param direction 查询方向
+      * @param offset 结果偏移量
+      * @param vaccount 可选的虚拟账户
+      * @returns [值列表数组生成的json字符串, 错误信息] 数组的每个元素的格式:  key:value$$$dckv_extra$$${'dc_timestamp':'%d','dc_opuser':'%s'}
+      */
+    getValues(kvdb: KeyValueDB, key: string, options: {
+        limit?: number;
+        seekKey?: string;
+        direction?: Direction;
+        offset?: number;
+    }, vaccount?: string): Promise<[string | null, Error | null]>;
+    /**
+     * 批量获取多个键的值
+     * @param kvdb: KeyValueDB,
+     * @param keys 多个键名，逗号分隔
+     * @param writerPubkey 写入者的公钥,可选,默认为主题作者
+     * @param vaccount 可选的虚拟账户
+     * @returns [值列表数组生成的json字符串, 错误信息] 数组的每个元素的格式:  key:value$$$dckv_extra$$${'dc_timestamp':'%d','dc_opuser':'%s'}
+     */
+    getBatch(kvdb: KeyValueDB, keys: string, writerPubkey?: string, vaccount?: string): Promise<[string | null, Error | null]>;
+    /**
+     * 通过索引查询键值对
+     * @param kvdb: KeyValueDB,
+     * @param indexKey 索引键名
+     * @param indexValue 索引值
+     * @param type 索引值类型
+     * @param seekKey 查询起始键
+     * @param offset 结果偏移量
+     * @param direction 查询方向 (Forward/Backward)
+     * @param limit 返回结果数量限制
+     * @param vaccount 可选的虚拟账户
+     * @returns [值列表数组生成的json字符串, 错误信息] 数组的每个元素的格式:  key:value$$$dckv_extra$$${'dc_timestamp':'%d','dc_opuser':'%s'}
+     */
+    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]>;
+    /**
+   * 按设置时间顺序获取主题的的键值对列表
+   * @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'}
+   */
+    getWithTimeOrder(kvdb: KeyValueDB, timestamp: number, //毫秒时间戳
+    options: {
+        limit?: number;
+        seekKey?: string;
+        direction?: Direction;
+        offset?: number;
+    }, vaccount?: string): Promise<[string | null, Error | null]>;
+}
+//# sourceMappingURL=keyvalue-interface.d.ts.map

package/dist/esm/interfaces/keyvalue-interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyvalue-interface.d.ts","sourceRoot":"","sources":["../../../lib/interfaces/keyvalue-interface.ts"],"names":[],"mappings":"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"}

package/dist/esm/interfaces/message-interface.d.ts

@@ -0,0 +1,21 @@
+import { dcnet } from "../../lib/proto/dcnet_proto";
+/**
+ * 消息操作接口
+ * 提供用户消息盒子的收发功能
+ */
+export interface IMessageOperations {
+    /**
+     * 发送消息到用户消息盒子
+     * @param receiver 接收者的公钥或账号标识
+     * @param msg 消息内容
+     * @returns 发送结果，包含消息ID和时间戳
+     */
+    sendMsgToUserBox(receiver: string, msg: string): Promise<[number | null, Error | null]>;
+    /**
+     * 从用户消息盒子获取消息
+     * @param limit 可选，限制返回消息的最大数量，默认由系统决定
+     * @returns 消息列表，按时间顺序排列
+     */
+    getMsgFromUserBox(limit?: number): Promise<[dcnet.pb.IUserMsg[] | null, Error | null]>;
+}
+//# sourceMappingURL=message-interface.d.ts.map

package/dist/esm/interfaces/message-interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-interface.d.ts","sourceRoot":"","sources":["../../../lib/interfaces/message-interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AAEpD;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;OAKG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,MAAM,GAAG,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC;IAExF;;;;OAIG;IACH,iBAAiB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC;CACxF"}

package/dist/esm/interfaces/util-interface.d.ts

@@ -0,0 +1,29 @@
+import { IAppInfo } from '../../lib/common/types/types';
+import { SymmetricKey, Key as ThreadKey } from '../implements/threaddb/common/key';
+import { IFileOperations } from './file-interface';
+export interface IUtilOperations {
+    createSymmetricKey(): SymmetricKey;
+    createThreadKey(): ThreadKey;
+    /**
+     * 设置应用信息,发布应用时调用
+     * @param appId string 应用ID
+     * @param fid
+     * @param domain
+     * @param owner
+     * @param rewarder
+     */
+    setAppInfo(appId: string, fid: string, domain: string, owner?: string, rewarder?: string): Promise<[boolean | null, Error | null]>;
+    getAppInfo(appId: string): Promise<[IAppInfo | null, Error | null]>;
+    /**
+     * 处理IPFS请求
+     * @param data 请求数据
+     * @param port 消息端口
+     * @param fileOps 文件操作对象
+     */
+    handleIpfsRequest(data: {
+        id: string;
+        pathname: string;
+        range?: string;
+    }, port: MessagePort, fileOps?: IFileOperations): Promise<void>;
+}
+//# sourceMappingURL=util-interface.d.ts.map

package/dist/esm/interfaces/util-interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util-interface.d.ts","sourceRoot":"","sources":["../../../lib/interfaces/util-interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,GAAG,IAAI,SAAS,EAAE,MAAM,mCAAmC,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGnD,MAAM,WAAW,eAAe;IAC5B,kBAAkB,IAAI,YAAY,CAAC;IACnC,eAAe,IAAI,SAAS,CAAC;IAC7B;;;;;;;OAOG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAC,GAAG,EAAC,MAAM,EAAC,MAAM,EAAC,MAAM,EAAC,KAAK,CAAC,EAAE,MAAM,EAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,OAAO,GAAC,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC;IAC3H,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,QAAQ,GAAC,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC;IAElE;;;;;OAKG;IACF,iBAAiB,CAChB,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EACtD,IAAI,EAAE,WAAW,EACjB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,IAAI,CAAC,CAAA;CACnB"}

package/dist/esm/modules/aiproxy-module.d.ts

@@ -0,0 +1,57 @@
+import { DCContext } from "../../lib/interfaces/DCContext";
+import { DCModule, CoreModuleName } from "../common/module-system";
+import { AIProxyConfig, GetUserAIProxyAuthParams, OnStreamResponseType, ProxyCallConfig, UserProxyCallConfig } from "../common/types/types";
+import { AIProxyUserPermission } from "../common/constants";
+import { IAICallConfig } from "../common/types/types";
+import { IAIProxyOperations } from "../../lib/interfaces/aiproxy-interface";
+/**
+ * AI代理模块
+ * 提供AI代理的配置和调用
+ */
+export declare class AIProxyModule implements DCModule, IAIProxyOperations {
+    readonly moduleName = CoreModuleName.AIPROXY;
+    private aiProxyManager;
+    private initialized;
+    private aiCallConfig;
+    /**
+     * 初始化AI代理模块
+     * @param context DC上下文
+     * @returns 是否初始化成功
+     */
+    initialize(context: DCContext): Promise<boolean>;
+    /**
+     * 关闭AI代理模块
+     */
+    shutdown(): Promise<void>;
+    createProxyConfig(appId: string, configTheme: string): Promise<[number | null, Error | null]>;
+    deleteProxyConfig(appId: string, configTheme: string): Promise<[number | null, Error | null]>;
+    configAIProxy(appId: string, configAuthor: string, configTheme: string, serviceName: string, serviceConfig?: AIProxyConfig, vaccount?: string): Promise<[boolean | null, Error | null]>;
+    configAuth(appId: string, configAuthor: string, configTheme: string, authPubkey: string, permission: AIProxyUserPermission, authConfig: ProxyCallConfig, vaccount?: string): Promise<[number | null, Error | null]>;
+    GetAIProxyConfig(appId: string, themeAuthor: string, configTheme: string, vaccount?: string): Promise<[
+        UserProxyCallConfig[] | null,
+        AIProxyConfig[] | null,
+        Error | null
+    ]>;
+    GetUserOwnAIProxyAuth(appId: string, themeAuthor: string, configTheme: string): Promise<[authConfig: ProxyCallConfig | null, error: Error | null]>;
+    DoAIProxyCall(context: {
+        signal?: AbortSignal;
+    }, reqBody: string, forceRefresh: boolean, onStreamResponse: OnStreamResponseType, appId?: string, themeAuthor?: string, configTheme?: string, serviceName?: string, headers?: Record<string, string>, path?: string, model?: string): Promise<[number | null, Error | null]>;
+    /**
+     * 设置AI调用的配置
+     * @param appId 应用ID
+     * @param themeAuthor 主题作者的公钥
+     * @param configTheme 配置主题
+     * @param serviceName 服务名称
+     * @param headers 请求头(可选)
+     * @param path 请求路径(可选)
+     * @param model 模型名称(可选)
+     * @returns Promise<void>
+     * */
+    SetAICallConfig(callConfig: IAICallConfig): Promise<Error | null>;
+    GetUserAIProxyAuth(params: GetUserAIProxyAuthParams): Promise<[authConfigs: ProxyCallConfig[] | null, error: Error | null]>;
+    /**
+     * 断言模块已初始化
+     */
+    private assertInitialized;
+}
+//# sourceMappingURL=aiproxy-module.d.ts.map

package/dist/esm/modules/aiproxy-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiproxy-module.d.ts","sourceRoot":"","sources":["../../../lib/modules/aiproxy-module.ts"],"names":[],"mappings":"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"}