web-dc-api 0.0.58 → 0.0.60

package/dist/types/common/types/types.d.ts

@@ -0,0 +1,280 @@
+import { Multiaddr } from '@multiformats/multiaddr';
+import { Client } from '../dcapi.js';
+import { Ed25519PubKey } from '../dc-key/ed25519.js';
+
+interface User {
+    callMinusNumber: number;
+    commentFrozenStatus: number;
+    commentReportAmount: number;
+    commentReportNumber: number;
+    dbConfigStr: string;
+    dbConfig: string;
+    dbConfigRaw: Uint8Array;
+    dbUpdateNumber: number;
+    encNftAccount: string;
+    expireNumber: number;
+    loginNumber: number;
+    nftUpdateNumber: number;
+    offchainOptimes: number;
+    offchainSpace: number;
+    parentAccount: string;
+    peers: Array<string>;
+    purchaseNumber: number;
+    requestPeers: Array<string>;
+    spamFrozenStatus: number;
+    spamReportAmount: number;
+    spamReportNumber: number;
+    subscribePrice: string;
+    subscribeSpace: number;
+    usedSpace: number;
+}
+interface DCConnectInfo {
+    client?: Client | undefined;
+    nodeAddr?: Multiaddr | undefined;
+}
+interface SignHandler {
+    sign(payload: Uint8Array): Uint8Array;
+    getPublicKey(): Ed25519PubKey;
+    getPubkeyRaw: () => Uint8Array;
+    decrypt: (content: Uint8Array) => Promise<Uint8Array>;
+}
+interface FileTransmit {
+    updateTransmitSize(status: string, size: number): void;
+}
+interface APPInfo {
+    appId: string;
+    appName: string;
+    appIcon: string;
+    appUrl: string;
+    appVersion: string;
+}
+interface ThemeObj {
+    theme: string;
+    appId: string;
+    blockheight: number;
+    commentSpace: number;
+    allowSpace: number;
+    userPubkey: string;
+    openFlag: number;
+    signature: string;
+    CCount: number;
+    UpCount: number;
+    DownCount: number;
+    TCount: number;
+    vaccount: string;
+}
+interface ThemeAuthInfo {
+    pubkey: string;
+    permission: number;
+    remark: string;
+}
+interface ThemeComment {
+    theme: string;
+    appId: string;
+    themeAuthor: string;
+    blockheight: number;
+    userPubkey: string;
+    commentCid: string;
+    comment: string;
+    commentSize: number;
+    status: number;
+    refercommentkey: string;
+    CCount: number;
+    UpCount: number;
+    DownCount: number;
+    TCount: number;
+    type: number;
+    signature: string;
+    vaccount: string;
+}
+interface ProxyCallConfig {
+    No: number;
+    Tlim?: number;
+    Dlim?: number;
+    Wlim?: number;
+    Mlim?: number;
+    Ylim?: number;
+    Exp?: number;
+}
+interface UserProxyCallConfig {
+    UserPubkey: string;
+    permission: number;
+    authConfig: ProxyCallConfig;
+}
+interface AIProxyConfig {
+    service: string;
+    isAIModel: number;
+    apiType: number;
+    authorization: string;
+    endpoint: string;
+    organization: string;
+    apiVersion: string;
+    modelConfig: ModelConfig;
+    remark: string;
+    blockheight?: number;
+}
+interface FunctionDef {
+    name: string;
+    description: string;
+    parameters?: any;
+}
+interface ToolDefinition {
+    type: string;
+    function?: FunctionDef;
+}
+interface ModelConfig {
+    model: string;
+    temperature: number;
+    maxTokens: number;
+    topP: number;
+    topK: number;
+    stopSequences: string[];
+    systemPrompt: string;
+    stream: boolean;
+    tools?: ToolDefinition[];
+}
+interface Account {
+    nftAccount: string;
+    appAccount: Uint8Array;
+    ethAccount: string;
+    chainId: string;
+    chainName: string;
+    accountInfo?: AccountInfo;
+}
+declare enum AIStreamResponseFlag {
+    /** 流式响应进行中 */
+    STREAMING = 0,
+    /** 推理信息流式响应进行中 */
+    STREAMING_REASON = 1,
+    /** 权限不足 */
+    PERMISSION_DENIED = 2,
+    /** 获取失败 */
+    FETCH_FAILED = 3,
+    /** 关闭连接 */
+    CONNECTION_CLOSED = 4,
+    /** Token数超限，需要继续请求 */
+    TOKEN_LIMIT_EXCEEDED = 5,
+    TOOLCALL = 6,
+    EXTERNAL_EXIT = 7,
+    /** 卡住了 */
+    STREAM_HANG = 88,
+    /** 其他错误 */
+    OTHER_ERROR = 99
+}
+type OnStreamResponseType = (flag: AIStreamResponseFlag, content: string, err: string) => void;
+declare enum NFTBindStatus {
+    Success = 0,
+    UserBinded = 1,// 用户已绑定其他nft账号
+    NftAccountBinded = 2,// nft账号已经被其他用户绑定
+    NoBcAccount = 3,// 区块链账号不存在
+    DcPeerNotConnected = 4,// 还没有建立到存储节点的连接
+    EncryptError = 5,// 加密数据过程出错
+    BlockchainError = 6,// 区块链相关错误
+    SignError = 7,// 签名错误
+    SpaceExpired = 8,// 用户有效期已过
+    NoLeftSpace = 9,// 空间不足
+    NetworkErr = 10,// 网络错误
+    Error = 99
+}
+declare enum UploadStatus {
+    OK = 0,
+    ENCRYPTING = 1,// 加密中
+    UPLOADING = 2,// 上传中
+    ERROR = 3,
+    ABNORMAL = 4,
+    PULLERROR = 5,
+    FILESIZEERROR = 6,// 文件大小错误
+    FILECOUNTERROR = 7,// 文件总数错误
+    NOSPACE = 8
+}
+declare enum PeerStatus {
+    PeerStatusOffline = 1,
+    PeerStatusJoining = 2,//Joining the network
+    PeerStatusOnline = 3,
+    PeerStatusStaked = 4,
+    PeerStatusErr = 5,
+    PeerStatusClose = 6,
+    PeerStatusDiscard = 7
+}
+type SignReqMessageData = {
+    appUrl: string;
+    ethAccount: string;
+    messageType?: string;
+    message: string;
+};
+type SignReqMessage = {
+    type: string;
+    origin: string;
+    data: SignReqMessageData;
+};
+type SignResponseMessage = {
+    success: boolean;
+    signature: string;
+};
+type EIP712SignReqMessage = {
+    type: string;
+    origin: string;
+    data: {
+        appUrl: string;
+        ethAccount: string;
+        domain: any;
+        types: any;
+        primaryType: string;
+        message: any;
+    };
+};
+type SendMessage<T> = {
+    type: string;
+    data?: T;
+};
+type ResponseMessage<T> = {
+    type: string;
+    data: T;
+};
+interface IAICallConfig {
+    appId: string;
+    themeAuthor: string;
+    theme: string;
+    service: string;
+    headers?: Record<string, string>;
+    path?: string;
+    model?: string;
+}
+interface AIMessageMediaSource {
+    url?: string;
+    type?: string;
+    name?: string;
+}
+interface AIMessageContent {
+    type: string;
+    text?: string;
+    source?: AIMessageMediaSource;
+}
+interface AIChatMessage {
+    role: string;
+    content: AIMessageContent[];
+}
+interface AIChatMessageRequest {
+    chatMessages: AIChatMessage[];
+}
+interface IAppInfo {
+    appId: string;
+    domain: string;
+    owner: string;
+    rewarder: string;
+    fid: string;
+}
+type AccountInfo = {
+    url?: string;
+    name: string;
+    nftAccount: string;
+    account: string;
+    credentialId: string;
+    iv: Uint8Array;
+    mnemonic: ArrayBuffer;
+    timeStamp: number;
+    type: string;
+};
+
+export { AIStreamResponseFlag, NFTBindStatus, PeerStatus, UploadStatus };
+export type { AIChatMessage, AIChatMessageRequest, AIMessageContent, AIMessageMediaSource, AIProxyConfig, APPInfo, Account, AccountInfo, DCConnectInfo, EIP712SignReqMessage, FileTransmit, FunctionDef, IAICallConfig, IAppInfo, ModelConfig, OnStreamResponseType, ProxyCallConfig, ResponseMessage, SendMessage, SignHandler, SignReqMessage, SignReqMessageData, SignResponseMessage, ThemeAuthInfo, ThemeComment, ThemeObj, ToolDefinition, User, UserProxyCallConfig };

package/dist/types/dc.d.ts

@@ -0,0 +1,194 @@
+import { ChainUtil } from './common/chain.js';
+import { DCConnectInfo, APPInfo, AccountInfo, Account } from './common/types/types.js';
+import { DcUtil } from './common/dcutil.js';
+import { HeliaLibp2p } from 'helia';
+import { Libp2p } from '@libp2p/interface';
+import { DCGrpcServer } from './implements/threaddb/net/grpcserver.js';
+import { Ed25519PubKey } from './common/dc-key/ed25519.js';
+import { DCContext } from './interfaces/DCContext.js';
+import { LogLevel } from './util/logger.js';
+import { DCModule } from './common/module-system.js';
+import { FileModule } from './modules/file-module.js';
+import { AuthModule } from './modules/auth-module.js';
+import { CommentModule } from './modules/comment-module.js';
+import { DatabaseModule } from './modules/database-module.js';
+import { MessageModule } from './modules/message-module.js';
+import { KeyValueModule } from './modules/keyvalue-module.js';
+import { ClientModule } from './modules/client-module.js';
+import { CacheModule } from './modules/cache-module.js';
+import { AIProxyModule } from './modules/aiproxy-module.js';
+import { UtilModule } from './modules/util-module.js';
+import { ICollectionConfig, IDBInfo } from './implements/threaddb/core/core.js';
+
+/**
+ * DC主类，整合所有功能模块
+ * 基于模块系统，更轻量级和可扩展
+ */
+declare class DC implements DCContext {
+    blockChainAddr: string;
+    backChainAddr: string;
+    dcChain: ChainUtil;
+    dcNodeClient: HeliaLibp2p<Libp2p>;
+    dcutil: DcUtil;
+    publicKey: Ed25519PubKey | undefined;
+    dbThreadId: string;
+    ethAddress: string;
+    connectedDc: DCConnectInfo;
+    AccountBackupDc: DCConnectInfo;
+    Identity: string;
+    Blockheight: number;
+    grpcServer: DCGrpcServer;
+    appInfo: APPInfo;
+    shouldReturnUserInfo: boolean;
+    accountInfo: AccountInfo;
+    userInfo: Account | null;
+    dbManager: any;
+    swUrl: string;
+    swInited: boolean;
+    private moduleSystem;
+    private initialized;
+    /**
+     * 创建DC实例
+     * @param options 配置选项
+     */
+    constructor(options: {
+        wssUrl: string;
+        backWssUrl: string;
+        appInfo?: APPInfo;
+        swUrl?: string;
+        logLevel?: LogLevel;
+        names?: string[];
+    });
+    /**
+     * 注册核心模块
+     */
+    private registerCoreModules;
+    /**
+     * 注册自定义模块
+     * @param module 要注册的模块
+     * @returns 是否注册成功
+     */
+    registerModule(module: DCModule): boolean;
+    /**
+     * 初始化DC实例
+     * backStep 0-注册模块成功，1-链节点连接成功，2-节点连接成功，3-初始化模块成功，
+     * @returns 是否成功初始化
+     */
+    init: (backStep?: (step: number) => Promise<void>) => Promise<boolean>;
+    setAppInfo(appInfo: APPInfo): void;
+    setAccountInfo(accountInfo: AccountInfo): void;
+    setShouldReturnUserInfo(shouldReturnUserInfo: boolean): void;
+    /**
+     * 获取当前用户的去中心数据库信息,如果用户数据库不存在,则会自动创建
+     * @param collections 集合配置数组，定义数据库中的集合结构
+     * @param reset 是否重置数据库，默认为false,如果为true，则会重置数据库,原来的数据会丢失,应该只在开发调试时使用
+     * @returns 当前用户的数据库信息
+     */
+    initUserDB(collections: ICollectionConfig[], verno?: number, //版本编码,当版本编码变化时，需要重构表结构
+    reset?: boolean): Promise<[IDBInfo | null, Error | null]>;
+    private setUserDefaultDB;
+    private checkSetUserDefaultDB;
+    /**
+     * 关闭并清理资源
+     */
+    shutdown(): Promise<void>;
+    /**
+     * 退出并清理资源
+     */
+    exit(): Promise<void>;
+    /**
+     * 签名方法
+     * @param payload 需要签名的数据
+     * @returns 签名结果
+     */
+    sign: (payload: Uint8Array) => Promise<Uint8Array>;
+    setPublicKey(publicKey: Ed25519PubKey): void;
+    /**
+     * 获取公钥
+     * @returns 公钥对象
+     */
+    getPublicKey(): Ed25519PubKey;
+    /**
+     * 获取原始公钥数据
+     * @returns 原始公钥字节数据
+     */
+    getPubkeyRaw(): Uint8Array;
+    /**
+     * 创建DC客户端
+     * @param nodeAddr 节点地址
+     * @returns DC客户端
+     */
+    private newDcClient;
+    /**
+     * 检查DC实例是否已初始化
+     * @returns 是否已初始化
+     */
+    isInitialized(): boolean;
+    /**
+     * 获取已注册的模块列表
+     */
+    getRegisteredModules(): string[];
+    /**
+     * 获取指定模块
+     * @param moduleName 模块名称
+     * @returns 模块实例
+     */
+    getModule<T extends DCModule>(moduleName: string): T | null;
+    /**
+     * 断言DC已初始化
+     * @throws 如果DC未初始化则抛出错误
+     */
+    private assertInitialized;
+    /**
+     * 获取文件模块
+     * @returns 文件模块实例
+     */
+    get file(): FileModule | null;
+    /**
+     * 获取认证模块
+     * @returns 认证模块实例
+     */
+    get auth(): AuthModule | null;
+    /**
+     * 获取评论模块
+     * @returns 评论模块实例
+     */
+    get comment(): CommentModule | null;
+    /**
+     * 获取数据库模块
+     * @returns 数据库模块实例
+     */
+    get db(): DatabaseModule | null;
+    /**
+     * 获取消息模块
+     * @returns 消息模块实例
+     */
+    get message(): MessageModule | null;
+    /**
+     * 获取键值存储模块
+     * @returns 键值存储模块实例
+     */
+    get keyValue(): KeyValueModule | null;
+    /**
+     * client
+     * @returns 客户端实例
+     */
+    get client(): ClientModule | null;
+    /**
+     * 缓存模块
+     * @returns 缓存模块实例
+     */
+    get cache(): CacheModule | null;
+    /**
+     * AI代理模块
+     * @returns AI代理模块实例
+     */
+    get aiproxy(): AIProxyModule | null;
+    /**
+     * 工具模块
+     * @returns 工具模块实例
+     */
+    get util(): UtilModule | null;
+}
+
+export { DC };

package/dist/types/implements/file/seekableFileStream.d.ts

@@ -0,0 +1,66 @@
+import { UnixFS } from '@helia/unixfs';
+import { CID } from 'multiformats/cid';
+
+/**
+ * 可定位文件流类
+ * 支持随机访问和流式读取加密和未加密的IPFS文件
+ */
+declare class SeekableFileStream {
+    private position;
+    private fs;
+    private cid;
+    private decryptKey;
+    private fileInfo;
+    private encryptChunkSize;
+    constructor(options: {
+        fileInfo: {
+            size: number;
+            hasHeader: boolean;
+            headerSize: number;
+        };
+        fs: UnixFS;
+        cid: CID;
+        decryptKey: string;
+        encryptChunkSize: number;
+    });
+    /**
+     * 获取文件大小
+     */
+    getSize(): number;
+    /**
+     * 定位到文件指定位置
+     * @param position 目标位置
+     */
+    seek(position: number): void;
+    /**
+     * 获取当前位置
+     */
+    getPosition(): number;
+    /**
+     * 读取指定长度的数据
+     * @param length 要读取的字节数
+     */
+    read(length: number): Promise<Uint8Array>;
+    /**
+     * 读取未加密的数据
+     * @param startPosition 开始位置
+     * @param length 读取长度
+     */
+    private readPlain;
+    /**
+   * 读取并解密加密数据，无音视频帧保护
+   * @param startPosition 开始位置
+   * @param length 读取长度
+   */
+    private readEncrypted;
+    /**
+     * 创建标准的可读流
+     * 使用独立缓冲区，不影响随机访问读取
+     */
+    createReadableStream(options?: {
+        start?: number;
+        end?: number;
+    }): ReadableStream<Uint8Array>;
+}
+
+export { SeekableFileStream };

package/dist/types/implements/keyvalue/manager.d.ts

@@ -0,0 +1,40 @@
+import { ThemeAuthInfo, ThemeComment } from '../../common/types/types.js';
+import { ChainUtil } from '../../common/chain.js';
+import { DcUtil } from '../../common/dcutil.js';
+import { Direction } from '../../common/define.js';
+import { DCContext } from '../../interfaces/DCContext.js';
+
+declare enum KeyValueStoreType {
+    Auth = 1,
+    Public = 2
+}
+declare class KeyValueDB {
+    private appId;
+    private dbname;
+    private themeAuthor;
+    private manager;
+    constructor(appId: string, dbname: string, themeAuthor: string, manager: KeyValueManager);
+    set(key: string, value: any, indexs?: string, vaccount?: string): Promise<[boolean | null, Error | null]>;
+    get(key: string, writerPubkey?: string, vaccount?: string): Promise<[string | null, Error | null]>;
+    getBatch(keys: string, writerPubkey: string, vaccount: string): Promise<[string | null, Error | null]>;
+    getWithIndex(indexKey: string, indexValue: string, limit?: number, seekKey?: string, direction?: Direction, offset?: number, vaccount?: string): Promise<[string | null, Error | null]>;
+    configAuth(authPubkey: string, permission: number, remark: string, vaccount?: string): Promise<[number | null, Error | null]>;
+    getAuthList(vaccount?: string): Promise<[ThemeAuthInfo[] | null, ThemeComment[] | null, Error | null]>;
+}
+declare class KeyValueManager {
+    private dc;
+    private chainUtil;
+    private context;
+    constructor(dc: DcUtil, chainUtil: ChainUtil, context: DCContext);
+    createStore(appId: string, theme: string, space: number, type: KeyValueStoreType): Promise<[KeyValueDB | null, Error | null]>;
+    getKeyValueDB(appId: string, theme: string, ThemeAuthor: string): Promise<[KeyValueDB | null, Error | null]>;
+    doConfigAuth(appId: string, themeAuthor: string, theme: string, authPubkey: string, permission: number, remark: string, vaccount?: string): Promise<[number | null, Error | null]>;
+    getAuthList(appId: string, themeAuthor: string, theme: string, vaccount?: string): Promise<[ThemeAuthInfo[] | null, ThemeComment[] | null, Error | null]>;
+    setKeyValue(appId: string, themeAuthor: string, theme: string, key: string, value: string, indexs: string, //索引列表,格式为key1:value1$$$key2:value2
+    vaccount?: string): Promise<[boolean | null, Error | null]>;
+    getValueWithKey(appId: string, themeAuthor: string, theme: string, writerPubkey: string, key: string, vaccount?: string): Promise<[string | null, Error | null]>;
+    getValuesWithKeys(appId: string, themeAuthor: string, theme: string, writerPubkey: string, keys: string, vaccount?: string): Promise<[string | null, Error | null]>;
+    getWithIndex(appId: string, themeAuthor: string, theme: string, indexKey: string, indexValue: string, seekKey: string, direction: Direction | undefined, offset: number, limit: number, vaccount?: string): Promise<[string | null, Error | null]>;
+}
+
+export { KeyValueDB, KeyValueManager, KeyValueStoreType };

package/dist/types/implements/threaddb/common/AsyncMutex.d.ts

@@ -0,0 +1,8 @@
+declare class AsyncMutex {
+    private _locked;
+    private _queue;
+    acquire(): Promise<void>;
+    release(): void;
+}
+
+export { AsyncMutex };

package/dist/types/implements/threaddb/common/dispatcher.d.ts

@@ -0,0 +1,20 @@
+import { Query, Pair } from 'interface-datastore';
+import { TxnDatastoreExtended, Event } from '../core/db.js';
+
+interface Reducer {
+    reduce(events: Event[]): Promise<void>;
+}
+declare class Dispatcher {
+    private store;
+    private reducers;
+    private lock;
+    private lastID;
+    constructor(store: TxnDatastoreExtended);
+    getStore(): TxnDatastoreExtended;
+    register(reducer: Reducer): void;
+    dispatch(events: Event[]): Promise<void>;
+    query(query: Query): AsyncIterable<Pair>;
+    private getKey;
+}
+
+export { Dispatcher };

package/dist/types/implements/threaddb/common/key.d.ts

@@ -0,0 +1,70 @@
+import { SymKey } from '../core/core.js';
+import { PrivateKey, PublicKey } from '@libp2p/interface';
+
+/**
+ * Key is a wrapper for a symmetric key
+ */
+declare class SymmetricKey {
+    static readonly keyBytes: number;
+    private _raw;
+    constructor(rawBytes: Uint8Array);
+    /**
+     * Generate a new random key
+     */
+    static newRandom(): SymmetricKey;
+    /**
+     * Creates a key without error handling (will throw if fails)
+     */
+    static new(): SymmetricKey;
+    /**
+     * Create a key from raw bytes
+     */
+    static fromBytes(k: Uint8Array): SymmetricKey;
+    /**
+     * Create a key from a base32-encoded string
+     */
+    static fromString(k: string): SymmetricKey;
+    toSymKey(): Promise<SymKey>;
+    static fromSymKey(symKey: SymKey): SymmetricKey;
+    /**
+     * Get raw key bytes
+     */
+    get raw(): Uint8Array;
+    /**
+     * Return raw key bytes
+     */
+    bytes(): Uint8Array;
+    /**
+     * Convert key to binary format
+     */
+    marshalBinary(): Uint8Array;
+    /**
+     * Return base32-encoded string representation
+     */
+    toString(): string;
+    encrypt(plaintext: Uint8Array, exNonce?: Uint8Array): Promise<Uint8Array>;
+    /**
+     * Decrypt uses key to perform AES-256 GCM decryption on ciphertext
+     */
+    decrypt(encryptBuffer: Uint8Array): Promise<Uint8Array>;
+}
+type LogKey = PrivateKey | PublicKey;
+declare class Key {
+    private sk?;
+    private rk?;
+    constructor(sk: SymmetricKey, rk?: SymmetricKey);
+    static new(sk: SymmetricKey, rk?: SymmetricKey): Key;
+    static newRandom(): Key;
+    static newRandomService(): Key;
+    static fromBytes(b: Uint8Array): Key;
+    static fromString(s: string): Key;
+    service(): SymmetricKey | undefined;
+    read(): SymmetricKey | undefined;
+    defined(): boolean;
+    canRead(): boolean;
+    toBytes(): Uint8Array;
+    toString(): string;
+}
+
+export { Key, SymmetricKey };
+export type { LogKey };

package/dist/types/implements/threaddb/common/lineReader.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 从ReadableStream逐行读取数据的工具类
+ */
+declare class LineReader {
+    private reader;
+    private textDecoder;
+    private buffer;
+    private isEOF;
+    /**
+     * 创建LineReader实例
+     * @param stream 可读数据流
+     * @param encoding 文本编码（默认为'utf-8'）
+     */
+    constructor(stream: ReadableStream<Uint8Array>, encoding?: string);
+    /**
+     * 读取下一行数据
+     * @returns 返回一行数据，如果到达流末尾则返回null
+     */
+    readLine(): Promise<string | null>;
+    /**
+     * 释放读取器资源
+     */
+    release(): void;
+}
+
+export { LineReader };