web-dc-api 0.1.4 → 0.1.6

package/lib/index.ts

@@ -1,57 +0,0 @@
-// index.ts
-// 导出主要类和功能
-// 在您库的入口文件开头添加
-
-declare global {
-  interface PromiseConstructor {
-    withResolvers<T = any>(): {
-      promise: Promise<T>;
-      resolve: (value: T | PromiseLike<T>) => void;
-      reject: (reason?: any) => void;
-    };
-  }
-}
-
-if (typeof Promise !== 'undefined' && !Promise.withResolvers) {
-  Promise.withResolvers = function<T = any>() {
-    let resolve!: (value: T | PromiseLike<T>) => void;
-    let reject!: (reason?: any) => void;
-    const promise = new Promise<T>((res, rej) => {
-      resolve = res;
-      reject = rej;
-    });
-    return { promise, resolve, reject };
-  };
-}
-export { DC } from './dc';
-export {BaseEntity} from './serverless/base_entity';
-export { EntityRepository,type FindIndexOptions, type FindValuesOptions,composeCompositeIndexValue} from './serverless/base_repository';
-export * from './serverless/decorator_factory';
-export * from './serverless/browser_schema_extractor';
-export { registerServiceWorker, isServiceWorkerActive, updateServiceWorker } from './common/service-worker';
-export * from './common/types/types';
-export * from './interfaces';
-export * from './common/define';
-export {ThemePermission} from './common/constants';
-
-// 导出模块系统
-export { ModuleSystem, CoreModuleName } from './common/module-system';
-export type { DCModule } from './common/module-system';
- 
-
-// 导出核心模块
-export * from './modules';
-
-// 导出工具类
-export { createLogger, configureLogger, LogLevel } from './util/logger';
-
-// 导出keyManager
-export { KeyManager } from './common/dc-key/keyManager';
-
-// 导出私钥
-export { Ed25519PrivKey, Ed25519PubKey } from './common/dc-key/ed25519';
-
-// 导出错误类型
-export { Errors } from './common/error';
-
-

package/lib/interfaces/DCContext.ts

@@ -1,51 +0,0 @@
-
-import { Ed25519PrivKey, Ed25519PubKey } from "../common/dc-key/ed25519";
-import type { DCConnectInfo, APPInfo, AccountInfo, Account } from "../common/types/types";
-import type { HeliaLibp2p } from "helia";
-import { Libp2p } from "@libp2p/interface";
-import { ChainUtil } from "../common/chain";
-import { DcUtil } from "../common/dcutil";
-import { DBManager } from "../implements/threaddb/dbmanager";
-import { DCGrpcServer } from "../implements/threaddb/net/grpcserver";
-
-/**
- * 核心系统上下文接口
- * 定义所有模块可以访问的核心系统组件
- */
-export interface DCContext {
-  // 核心基础设施
-  dcNodeClient: HeliaLibp2p<Libp2p>;
-  dcChain: ChainUtil;
-  dcutil: DcUtil;
-
-  swInited: boolean;
-  
-  // 连接信息
-  connectedDc: DCConnectInfo;
-  // 账号信息备份连接信息
-  AccountBackupDc: DCConnectInfo;
-  
-  // 应用信息
-  appInfo: APPInfo;
-  
-  // 当前登录的账户信息
-  accountInfo: AccountInfo;
-  // 当前登录的用户信息
-  userInfo: Account | null;
-
-  // 数据库管理器
-  dbManager?: DBManager;
-  
-  // 身份相关
-  publicKey: Ed25519PubKey | undefined;
-  privateKey: Ed25519PrivKey | undefined | null;
-  // 以太坊格式的公钥,16进制字符串
-  ethAddress: string | undefined;
-
-  grpcServer: DCGrpcServer;
-  
-  // 核心功能
-  sign(payload: Uint8Array): Promise<Uint8Array> ;
-  getPubkeyRaw(): Uint8Array;
-  getPublicKey(): Ed25519PubKey;
-}

package/lib/interfaces/aiproxy-interface.ts

@@ -1,145 +0,0 @@
-import { AIProxyConfig, IAICallConfig, OnStreamResponseType, ProxyCallConfig, UserProxyCallConfig } from "../common/types/types";
-import { AIProxyUserPermission } from "../common/constants";
-
-/**
- * AI代理操作接口
- * 提供AI代理的配置和调用功能
- */
-export interface IAIProxyOperations {
-  /**
-   * 创建AI调用的Proxy配置
-   * @param appId 应用ID
-   * @param configTheme 配置主题
-   * @returns [状态码, 错误信息]
-   */
-  createProxyConfig(
-    appId: string,
-    configTheme: string
-  ): Promise<[number | null, Error | null]>;
-
-
-   /**
-   * 删除AI调用的Proxy配置
-   * @param appId 应用ID
-   * @param configTheme 配置主题
-   * @returns [状态码, 错误信息]
-   */
-  deleteProxyConfig(
-    appId: string,
-    configTheme: string
-  ): Promise<[number | null, Error | null]>;
-  
-  /**
-   * 配置AI代理的访问配置
-   * 如果serverConfig为空,则表示删除该serviceName的配置
-   * @param appId 应用ID
-   * @param configAuthor 配置作者的公钥
-   * @param configTheme 配置主题
-   * @param serviceName 服务名称
-   * @param serviceConfig 服务配置(可选)
-   * @param vaccount 虚拟账户(可选)
-   * @returns [是否配置成功, 错误信息]
-   */
-  configAIProxy(
-    appId: string,
-    configAuthor: string,
-    configTheme: string,
-    serviceName: string,
-    serviceConfig?: AIProxyConfig,
-    vaccount?: string
-  ): Promise<[boolean | null, Error | null]>;
-  
-  /**
-   * 配置用户的访问权限
-   * @param appId 应用ID
-   * @param configAuthor 配置作者的公钥
-   * @param configTheme 配置主题
-   * @param authPubkey 被授权用户的公钥
-   * @param permission 权限级别
-   * @param authConfig 授权配置
-   * @param vaccount 虚拟账户(可选)
-   * @returns [状态码, 错误信息]
-   */
-  configAuth(
-    appId: string,
-    configAuthor: string,
-    configTheme: string,
-    authPubkey: string,
-    permission: AIProxyUserPermission,
-    authConfig: ProxyCallConfig,
-    vaccount?: string
-  ): Promise<[number | null, Error | null]>;
-  
-  /**
-   * 获取AI代理的所有配置
-   * 包括服务与授权列表
-   * @param appId 应用ID
-   * @param themeAuthor 主题作者的公钥
-   * @param configTheme 配置主题
-   * @param vaccount 虚拟账户(可选)
-   * @returns [用户授权配置列表, AI代理配置列表, 错误信息]
-   */
-  GetAIProxyConfig(
-    appId: string,
-    themeAuthor: string,
-    configTheme: string,
-    vaccount?: string
-  ): Promise<[UserProxyCallConfig[] | null, AIProxyConfig[] | null, Error | null]>;
-  
-  /**
-   * 获取当前用户自身的AI代理授权信息
-   * @param appId 应用ID
-   * @param themeAuthor 主题作者的公钥
-   * @param configTheme 配置主题
-   * @returns [授权配置, 错误信息]
-   */
-  GetUserOwnAIProxyAuth(
-    appId: string,
-    themeAuthor: string,
-    configTheme: string
-  ): Promise<[ProxyCallConfig | null, Error | null]>;
-  
-  /**
-   * 执行AI代理调用
-   * 包括代理与AI的通信或者与MCPServer的通信
-   * @param reqBody 请求体
-   * @param forceRefresh 是否强制刷新,强制刷鞋会消耗一定数量的token,一般在更新了用户授权后,才需要强制刷新
-   * @param onStreamResponse 流式响应回调函数
-   * @param appId 应用ID(可选),为空时使用默认的调用配置中的appId
-   * @param themeAuthor(可选) 主题作者的公钥,为空时使用默认的调用配置中的themeAuthor
-   * @param configTheme(可选) 配置主题,为空时使用默认的调用配置中的configTheme
-   * @param serviceName(可选) 服务器名称,为空时使用默认的调用配置中的serviceName
-   * @param headers 请求头(可选),为空时使用默认的调用配置中的headers
-   * @param path 请求路径(可选),为空时使用默认的调用配置中的path
-   * @param model 模型名称(可选),为空时使用默认的调用配置中的model
-   * @returns 调用状态码
-   */
-  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>;
-}

package/lib/interfaces/auth-interface.ts

@@ -1,118 +0,0 @@
-import { DCConnectInfo, NFTBindStatus, User, Account, AccountInfo } from "../common/types/types";
-
-
-
-/**
- * 认证操作接口
- * 处理用户身份验证、账户管理和访问控制
- */
-export interface IAuthOperations {
-  
-  /**
-   * 账户登录通过钱包
-   * @returns 是否登录成功
-   */
-  accountLoginWithWallet(accountInfo?: AccountInfo): Promise<[Account | null, Error | null]>;
-
-  /**
-   * 账户登录
-   * @param nftAccount NFT账户
-   * @param password 密码
-   * @param safecode 安全码,默认000000
-   * @returns 是否登录成功
-   */
-  accountLogin(nftAccount: string, password: string, safecode: string): Promise<[string, Error | null]>;
-
-  /**
-   * 签名数据
-   * @param payload 要签名的数据
-   * @returns 签名结果
-   */
-  sign(payload: Uint8Array): Promise<[Uint8Array | null, Error | null]>;
-  
-
-  /**
-   * 解密数据
-   * @param payload 要解密的数据
-   * @returns 解密结果
-   */
-  decryptWithWallet(payload: Uint8Array): Promise<[Uint8Array | null, Error | null]>;
-
-  /**
-   * 将公钥绑定NFT账号
-   * @param account NFT账号
-   * @param password 密码
-   * @param seccode 安全码
-   * @param mnemonic 助记词,将安全存储在DC云端
-   * @returns [状态码, 错误信息]
-   */
-  bindNFTAccount(account: string, password: string, seccode: string, mnemonic: string): Promise<[NFTBindStatus | null, Error | null]>;
-
-  /**
-   * 创建APP访问账号,返回APP专用私钥
-   * @param appId 应用ID
-   * @param mnemonic 助记词
-   * @returns [私钥字符串, 错误]
-   */
-  generateAppAccount(appId: string, mnemonic: string): Promise<[string | null, Error | null]>;
-
-  /**
-   * 检查NFT账号是否成功绑定到当前用户的公钥
-   * @param nftAccount NFT账号
-   * @param pubKeyStr 公钥字符串
-   * @returns 是否成功绑定
-   */
-  isNftAccountBindSuccess(nftAccount: string, pubKeyStr: string): Promise<[boolean | null, Error | null]>;
-
-  /**
-   * 检查NFT账号是否已经被公钥绑定
-   * @param nftAccount NFT账号
-   * @returns 是否被其他账号绑定
-   */
-  isNftAccountBinded(nftAccount: string): Promise<[boolean | null, Error | null]>;
-  
- /**
-   * 获取用户信息
-   * @param nftAccount NFT账户
-   * @returns 用户信息
-   */
-  getUserInfoWithNft(nftAccount: string): Promise<[User | null, Error | null]>;
-  
-
-  /**
-   * 获取用户钱包信息
-   * @param pubkeyAccount 账户名
-   * @returns 用户信息
-   */
-  getUserInfoWithAccount(pubkeyAccount: string): Promise<[User | null, Error | null]>;
-  
-  /**
-   * 开启定时验证token线程
-   */
-  startDcPeerTokenKeepValidTask(): Promise<[boolean, Error | null]>;
-
-
-  
-  /**
-   * 检查用户空间是否足够
-   * @param needSize 需要的空间大小
-   * @returns 空间信息
-   */
-  ifEnoughUserSpace(needSize?: number): Promise<[boolean | null, Error | null]>;
-  
-  /**
-   * 刷新用户信息
-   * @returns 用户信息
-   */
-  refreshUserInfo(): Promise<[User | null, Error | null]>;
-
-  /**
-   * 获取用户默认数据库
-   * @param threadId 数据库ID
-   * @param rk 读取密钥,主要用来加解密真正的数据,注意对数据记录进行加密和解密
-   * @param sk 服务密钥,主要用来处理传输过程加解密,主要对数据链表头进行加密和解密
-   * @param remark 备注信息
-   * @returns 用户默认数据库信息
-   */
-  setUserDefaultDB(threadId: string, rk: string,sk: string,remark: string,vaccount?: string): Promise< Error | null>;
-}

package/lib/interfaces/cache-interface.ts

@@ -1,22 +0,0 @@
-/**
- * 临时缓存操作接口
- * 提供从分布式网络获取和设置缓存值的功能,调用前请确保DC网络已连接,且用户已登录
- */
-export interface ICacheOperations {
-  /**
-   * 从DC网络获取缓存值
-   * @param key 缓存键
-   * @returns 缓存值，如果键不存在则返回null
-   * @throws 当操作失败时抛出错误
-   */
-  getCacheValue(key: string): Promise<[string | null, Error | null]>;
-  
-  /**
-   * 设置缓存值
-   * @param value 缓存值
-   * @param expire 可选，过期时间(秒)，默认为一天
-   * @returns 设置操作的结果
-   * @throws 当操作失败时抛出错误
-   */
-  setCacheKey(value: string, expire?: number): Promise<[string | null, Error | null]>;
-}

package/lib/interfaces/client-interface.ts

@@ -1,11 +0,0 @@
-/**
- * client接口
- */
-export interface IClientOperations {
-  /**
-   * 获取链接DC节点的hostID以及本机的公网地址
-   * 
-   * @returns peerID表示DC节点的hostID,reqAddr表示本机的公网地址
-   */
-  getHostID(): Promise<[{ peerID: string; reqAddr: string } | null, Error | null]>;
-}

package/lib/interfaces/comment-interface.ts

@@ -1,167 +0,0 @@
-import { OpenFlag, ThemePermission } from "../common/constants";
-import { ThemeAuthInfo, ThemeComment, ThemeObj } from "../common/types/types";
-
-/**
- * 评论操作接口
- * 提供评论系统的所有功能操作
- */
-export interface ICommentOperations {
-  /**
-   * 为指定主题开通评论功能
-   * @param theme 主题/对象标识符
-   * @param openFlag 开放标志 0-公开 1-私密 2-鉴权
-   * @param commentSpace 可选，评论空间上限大小(字节)，默认50MB
-   * @returns 操作结果  0:成功 1:评论空间没有配置 2:评论空间不足 3:评论数据同步中
-   */
-  addThemeObj(theme: string, openFlag: OpenFlag, commentSpace?: number): Promise<[number | null, Error | null]>;
-  
-  /**
-   * 添加用户链下评论空间,DC为了提升性能,用户发布评论等操作,无需上链,有DC节点在TEE环境维护用户的评论空间使用情况,新用户在发布评论前需要先添加评论空间,每次调用会分配50MB的链下空间,用于发布评论等链下操作
-   * @returns 添加结果 true:成功  false:失败
-   */
-  addUserOffChainSpace(): Promise<[boolean | null, Error | null]>
-  
-  /**
-   * 为用户添加链下操作次数,DC为了提升性能,用户发布评论等操作,无需上链,用于发布评论等链下操作次数,
-   * @param times 操作次数
-   * @param vaccount 可选，用户的虚拟账号
-   * @returns 操作结果  0:成功 1:评论空间没有配置 2:评论空间不足 3:评论数据同步中
-   */
-  addUserOffChainOpTimes(
-  times: number,
-  vaccount?: string
-): Promise<[boolean | null, Error | null]>
- 
-  /**
-   * 为已开通评论的主题增加评论空间,为了防止每个主题评论空间浪费,每个主题在创建时会分配50MB的评论空间,如果后续不够,可以通过这个接口增加
-   * 本方法可以为指定主题的keyvaluedb增加空间
-   * @param theme 主题/对象标识符
-   * @param addSpace 要增加的空间大小(字节)
-   * @returns 操作结果
-   */
-  addThemeSpace(theme: string, addSpace: number): Promise<[number | null, Error | null]>;
-  
-  /**
-   * 向指定主题发布评论
-   * @param theme 主题/对象标识符
-   * @param themeAuthor 主题作者的公钥
-   * @param commentType 评论类型
-   * @param comment 评论内容
-   * @param refercommentkey 可选，引用的评论键
-   * @param openFlag 可选，评论可见性标志
-   * @returns 评论发布结果
-   */
-  publishCommentToTheme(
-    theme: string,
-    themeAuthor: string,
-    commentType: number,
-    comment: string,
-    openFlag?: number,
-    refercommentkey?: string
-  ): Promise<[string | null, Error | null]>;
-  
-  /**
-   * 删除自己发布的评论,只是删除了在自己列表中的评论,不能删除已经发布到主题下的评论
-   * @param theme 主题/对象标识符
-   * @param themeAuthor 主题作者的公钥
-   * @param commentKey 评论的唯一键
-   * @returns 删除操作结果
-   */
-  deleteSelfComment(theme: string, themeAuthor: string, commentKey: string): Promise<[number | null, Error | null]>;
-  
-  /**
-   * 获取指定作者的主题对象列表,无法查询作者设置为私密的主题
-   * @param themeAuthor 主题作者的公钥
-   * @param startHeight 可选，查询起始高度
-   * @param direction 可选，查询方向 (0:从新到旧, 1:从旧到新)
-   * @param offset 可选，结果集偏移量
-   * @param limit 可选，最大返回数量，默认100
-   * @param seekKey 可选，查询的起始键,格式为返回记录的 blockheight/key
-   * @returns 主题对象列表
-   */
-  getThemeObj(
-    themeAuthor: string,
-    startHeight?: number,
-    direction?: number,
-    offset?: number,
-    limit?: number,
-    seekKey?: string
-  ): Promise<[ThemeObj[] | null, Error | null]>;
-  
-  /**
-   * 获取指定主题的评论列表,无法查询作者设置为私密的评论
-   * @param theme 主题/对象标识符
-   * @param themeAuthor 主题作者的公钥
-   * @param startHeight 可选，查询起始高度
-   * @param direction 可选，查询方向 (0:从新到旧, 1:从旧到新) 
-   * @param offset 可选，结果集偏移量
-   * @param limit 可选，最大返回数量，默认100
-   * @param seekKey 可选，查询的起始键,格式为返回记录的 blockheight/key
-   * @returns 主题的评论列表
-   */
-  getThemeComments(
-    theme: string,
-    themeAuthor: string,
-    startHeight?: number,
-    direction?: number,
-    offset?: number,
-    limit?: number,
-    seekKey?: string
-  ): Promise<[ThemeComment[] | null, Error | null]>;
-
-
-   /**
-     * 配置主题的授权信息
-     * @param appId 应用ID
-     * @param themeAuthor 主题作者的公钥
-     * @param theme 主题名称
-     * @param authPubkey 被授权者的公钥
-     * @param permission 权限级别
-     * @param remark 备注信息
-     * @param vaccount 可选的虚拟账户
-     * @returns [授权状态码, 错误信息]
-     */
-    configAuth(
-      themeAuthor: string,
-      theme: string,
-      authPubkey: string,
-      permission: ThemePermission,
-      remark: string,
-      vaccount?: string
-    ): Promise<[number | null, Error | null]>;
-  
-  
-  /**
-   * 获取指定主题的授权列表,
-   * @param appId 应用ID
-   * @param themeAuthor 主题作者的公钥
-   * @param theme 主题/对象标识符
-   * @param vaccount 可选，虚拟账户
-   * @returns [授权列表, 评论列表, 错误信息]
-   */
- getAuthList(
-      themeAuthor: string,
-      theme: string,
-      vaccount?: string
-    ): Promise<[ThemeAuthInfo[]|null,ThemeComment[] | null, Error | null]> 
-     
-
-  /**
-   * 获取指定用户发布的评论列表,无法查询用户设置为私密的评论
-   * @param userPubkey 用户公钥
-   * @param startHeight 可选，查询起始高度
-   * @param direction 可选，查询方向 (0:从新到旧, 1:从旧到新)
-   * @param offset 可选，结果集偏移量
-   * @param limit 可选，最大返回数量，默认100
-   * @param seekKey 可选，查询的起始键,格式为返回记录的 blockheight/key
-   * @returns 用户的评论列表
-   */
-  getUserComments(
-    userPubkey: string,
-    startHeight?: number,
-    direction?: number,
-    offset?: number,
-    limit?: number,
-    seekKey?: string
-  ): Promise<[ThemeComment[] | null, Error | null]>;
-}