web-dc-api 0.0.73 → 0.0.74

package/dist/index.d.ts

@@ -3290,11 +3290,11 @@ interface INet {
 interface ICollectionConfig {
     name: string;
     schema: AnySchema;
-    indexes?: Index$1[];
+    indexes?: Index$2[];
     writeValidator?: string;
     readFilter?: string;
 }
-interface Index$1 {
+interface Index$2 {
     path: string;
     unique: boolean;
 }
@@ -3566,7 +3566,7 @@ type InstanceID = string;
 /**
  * Index defines an index configuration
  */
-interface Index {
+interface Index$1 {
     /**
      * Path to the field to index in dot syntax, e.g., "name.last" or "age".
      */
@@ -3582,7 +3582,7 @@ interface Index {
 /**
  * Index definition for collections
  */
-interface Index {
+interface Index$1 {
     path: string;
     unique?: boolean;
 }
@@ -3599,7 +3599,7 @@ declare class Collection implements ICollection {
     private vm;
     private writeValidator;
     readFilter: ((reader: any, instance: any) => any) | null;
-    indexes: Map<string, Index>;
+    indexes: Map<string, Index$1>;
     constructor(name: string, schema: AnySchema, db: IDB, rawWriteValidator?: string | undefined, rawReadFilter?: string | undefined);
     private compileAndLoadValidator;
     /**
@@ -3697,7 +3697,7 @@ declare class Collection implements ICollection {
     /**
      * 返回当前索引列表
      */
-    getIndexes(): Index[];
+    getIndexes(): Index$1[];
     /**
      * 创建基于路径的新索引
      * 使用点语法访问嵌套字段，例如 "name.last"
@@ -3706,7 +3706,7 @@ declare class Collection implements ICollection {
      * 添加索引将覆盖任何已存在的重叠索引值
      * 注意: 这目前不会构建索引。如果在添加新索引之前已添加了项目，它们不会被事后索引。
      */
-    addIndex(index: Index, token?: ThreadToken): Promise<void>;
+    addIndex(index: Index$1, token?: ThreadToken): Promise<void>;
     /**
      * 删除指定路径的索引
      */
@@ -3727,7 +3727,7 @@ declare class Collection implements ICollection {
     /**
      * 在项目上添加或移除特定索引
      */
-    indexUpdate(field: string, index: Index, txn: any, key: Key$1, input: Uint8Array, deleteOp: boolean): Promise<void>;
+    indexUpdate(field: string, index: Index$1, txn: any, key: Key$1, input: Uint8Array, deleteOp: boolean): Promise<void>;
 }
 
 declare class DB implements App, IDB {
@@ -15388,6 +15388,9 @@ declare namespace dcnet {
 
             /** SetKeyValueReply flag */
             flag?: (number|null);
+
+            /** SetKeyValueReply timestamp */
+            timestamp?: (number|Long|null);
         }
 
         /** Represents a SetKeyValueReply. */
@@ -15402,6 +15405,9 @@ declare namespace dcnet {
             /** SetKeyValueReply flag. */
             public flag: number;
 
+            /** SetKeyValueReply timestamp. */
+            public timestamp: (number|Long);
+
             /**
              * Creates a new SetKeyValueReply instance using the specified properties.
              * @param [properties] Properties to set
@@ -18324,6 +18330,230 @@ declare namespace dcnet {
             public static getTypeUrl(typeUrlPrefix?: string): string;
         }
 
+        /** Properties of a GetUserThemeConfigInfoRequest. */
+        interface IGetUserThemeConfigInfoRequest {
+
+            /** GetUserThemeConfigInfoRequest theme */
+            theme?: (Uint8Array|null);
+
+            /** GetUserThemeConfigInfoRequest appId */
+            appId?: (Uint8Array|null);
+
+            /** GetUserThemeConfigInfoRequest themeAuthor */
+            themeAuthor?: (Uint8Array|null);
+
+            /** GetUserThemeConfigInfoRequest UserPubkey */
+            UserPubkey?: (Uint8Array|null);
+
+            /** GetUserThemeConfigInfoRequest Vaccount */
+            Vaccount?: (Uint8Array|null);
+        }
+
+        /** Represents a GetUserThemeConfigInfoRequest. */
+        class GetUserThemeConfigInfoRequest implements IGetUserThemeConfigInfoRequest {
+
+            /**
+             * Constructs a new GetUserThemeConfigInfoRequest.
+             * @param [properties] Properties to set
+             */
+            constructor(properties?: dcnet.pb.IGetUserThemeConfigInfoRequest);
+
+            /** GetUserThemeConfigInfoRequest theme. */
+            public theme: Uint8Array;
+
+            /** GetUserThemeConfigInfoRequest appId. */
+            public appId: Uint8Array;
+
+            /** GetUserThemeConfigInfoRequest themeAuthor. */
+            public themeAuthor: Uint8Array;
+
+            /** GetUserThemeConfigInfoRequest UserPubkey. */
+            public UserPubkey: Uint8Array;
+
+            /** GetUserThemeConfigInfoRequest Vaccount. */
+            public Vaccount: Uint8Array;
+
+            /**
+             * Creates a new GetUserThemeConfigInfoRequest instance using the specified properties.
+             * @param [properties] Properties to set
+             * @returns GetUserThemeConfigInfoRequest instance
+             */
+            public static create(properties?: dcnet.pb.IGetUserThemeConfigInfoRequest): dcnet.pb.GetUserThemeConfigInfoRequest;
+
+            /**
+             * Encodes the specified GetUserThemeConfigInfoRequest message. Does not implicitly {@link dcnet.pb.GetUserThemeConfigInfoRequest.verify|verify} messages.
+             * @param message GetUserThemeConfigInfoRequest message or plain object to encode
+             * @param [writer] Writer to encode to
+             * @returns Writer
+             */
+            public static encode(message: dcnet.pb.IGetUserThemeConfigInfoRequest, writer?: $protobuf.Writer): $protobuf.Writer;
+
+            /**
+             * Encodes the specified GetUserThemeConfigInfoRequest message, length delimited. Does not implicitly {@link dcnet.pb.GetUserThemeConfigInfoRequest.verify|verify} messages.
+             * @param message GetUserThemeConfigInfoRequest message or plain object to encode
+             * @param [writer] Writer to encode to
+             * @returns Writer
+             */
+            public static encodeDelimited(message: dcnet.pb.IGetUserThemeConfigInfoRequest, writer?: $protobuf.Writer): $protobuf.Writer;
+
+            /**
+             * Decodes a GetUserThemeConfigInfoRequest message from the specified reader or buffer.
+             * @param reader Reader or buffer to decode from
+             * @param [length] Message length if known beforehand
+             * @returns GetUserThemeConfigInfoRequest
+             * @throws {Error} If the payload is not a reader or valid buffer
+             * @throws {$protobuf.util.ProtocolError} If required fields are missing
+             */
+            public static decode(reader: ($protobuf.Reader|Uint8Array), length?: number): dcnet.pb.GetUserThemeConfigInfoRequest;
+
+            /**
+             * Decodes a GetUserThemeConfigInfoRequest message from the specified reader or buffer, length delimited.
+             * @param reader Reader or buffer to decode from
+             * @returns GetUserThemeConfigInfoRequest
+             * @throws {Error} If the payload is not a reader or valid buffer
+             * @throws {$protobuf.util.ProtocolError} If required fields are missing
+             */
+            public static decodeDelimited(reader: ($protobuf.Reader|Uint8Array)): dcnet.pb.GetUserThemeConfigInfoRequest;
+
+            /**
+             * Verifies a GetUserThemeConfigInfoRequest message.
+             * @param message Plain object to verify
+             * @returns `null` if valid, otherwise the reason why it is not
+             */
+            public static verify(message: { [k: string]: any }): (string|null);
+
+            /**
+             * Creates a GetUserThemeConfigInfoRequest message from a plain object. Also converts values to their respective internal types.
+             * @param object Plain object
+             * @returns GetUserThemeConfigInfoRequest
+             */
+            public static fromObject(object: { [k: string]: any }): dcnet.pb.GetUserThemeConfigInfoRequest;
+
+            /**
+             * Creates a plain object from a GetUserThemeConfigInfoRequest message. Also converts values to other types if specified.
+             * @param message GetUserThemeConfigInfoRequest
+             * @param [options] Conversion options
+             * @returns Plain object
+             */
+            public static toObject(message: dcnet.pb.GetUserThemeConfigInfoRequest, options?: $protobuf.IConversionOptions): { [k: string]: any };
+
+            /**
+             * Converts this GetUserThemeConfigInfoRequest to JSON.
+             * @returns JSON object
+             */
+            public toJSON(): { [k: string]: any };
+
+            /**
+             * Gets the default type url for GetUserThemeConfigInfoRequest
+             * @param [typeUrlPrefix] your custom typeUrlPrefix(default "type.googleapis.com")
+             * @returns The default type url
+             */
+            public static getTypeUrl(typeUrlPrefix?: string): string;
+        }
+
+        /** Properties of a GetUserThemeConfigInfoReply. */
+        interface IGetUserThemeConfigInfoReply {
+
+            /** GetUserThemeConfigInfoReply flag */
+            flag?: (number|null);
+
+            /** GetUserThemeConfigInfoReply authInfo */
+            authInfo?: (Uint8Array|null);
+        }
+
+        /** Represents a GetUserThemeConfigInfoReply. */
+        class GetUserThemeConfigInfoReply implements IGetUserThemeConfigInfoReply {
+
+            /**
+             * Constructs a new GetUserThemeConfigInfoReply.
+             * @param [properties] Properties to set
+             */
+            constructor(properties?: dcnet.pb.IGetUserThemeConfigInfoReply);
+
+            /** GetUserThemeConfigInfoReply flag. */
+            public flag: number;
+
+            /** GetUserThemeConfigInfoReply authInfo. */
+            public authInfo: Uint8Array;
+
+            /**
+             * Creates a new GetUserThemeConfigInfoReply instance using the specified properties.
+             * @param [properties] Properties to set
+             * @returns GetUserThemeConfigInfoReply instance
+             */
+            public static create(properties?: dcnet.pb.IGetUserThemeConfigInfoReply): dcnet.pb.GetUserThemeConfigInfoReply;
+
+            /**
+             * Encodes the specified GetUserThemeConfigInfoReply message. Does not implicitly {@link dcnet.pb.GetUserThemeConfigInfoReply.verify|verify} messages.
+             * @param message GetUserThemeConfigInfoReply message or plain object to encode
+             * @param [writer] Writer to encode to
+             * @returns Writer
+             */
+            public static encode(message: dcnet.pb.IGetUserThemeConfigInfoReply, writer?: $protobuf.Writer): $protobuf.Writer;
+
+            /**
+             * Encodes the specified GetUserThemeConfigInfoReply message, length delimited. Does not implicitly {@link dcnet.pb.GetUserThemeConfigInfoReply.verify|verify} messages.
+             * @param message GetUserThemeConfigInfoReply message or plain object to encode
+             * @param [writer] Writer to encode to
+             * @returns Writer
+             */
+            public static encodeDelimited(message: dcnet.pb.IGetUserThemeConfigInfoReply, writer?: $protobuf.Writer): $protobuf.Writer;
+
+            /**
+             * Decodes a GetUserThemeConfigInfoReply message from the specified reader or buffer.
+             * @param reader Reader or buffer to decode from
+             * @param [length] Message length if known beforehand
+             * @returns GetUserThemeConfigInfoReply
+             * @throws {Error} If the payload is not a reader or valid buffer
+             * @throws {$protobuf.util.ProtocolError} If required fields are missing
+             */
+            public static decode(reader: ($protobuf.Reader|Uint8Array), length?: number): dcnet.pb.GetUserThemeConfigInfoReply;
+
+            /**
+             * Decodes a GetUserThemeConfigInfoReply message from the specified reader or buffer, length delimited.
+             * @param reader Reader or buffer to decode from
+             * @returns GetUserThemeConfigInfoReply
+             * @throws {Error} If the payload is not a reader or valid buffer
+             * @throws {$protobuf.util.ProtocolError} If required fields are missing
+             */
+            public static decodeDelimited(reader: ($protobuf.Reader|Uint8Array)): dcnet.pb.GetUserThemeConfigInfoReply;
+
+            /**
+             * Verifies a GetUserThemeConfigInfoReply message.
+             * @param message Plain object to verify
+             * @returns `null` if valid, otherwise the reason why it is not
+             */
+            public static verify(message: { [k: string]: any }): (string|null);
+
+            /**
+             * Creates a GetUserThemeConfigInfoReply message from a plain object. Also converts values to their respective internal types.
+             * @param object Plain object
+             * @returns GetUserThemeConfigInfoReply
+             */
+            public static fromObject(object: { [k: string]: any }): dcnet.pb.GetUserThemeConfigInfoReply;
+
+            /**
+             * Creates a plain object from a GetUserThemeConfigInfoReply message. Also converts values to other types if specified.
+             * @param message GetUserThemeConfigInfoReply
+             * @param [options] Conversion options
+             * @returns Plain object
+             */
+            public static toObject(message: dcnet.pb.GetUserThemeConfigInfoReply, options?: $protobuf.IConversionOptions): { [k: string]: any };
+
+            /**
+             * Converts this GetUserThemeConfigInfoReply to JSON.
+             * @returns JSON object
+             */
+            public toJSON(): { [k: string]: any };
+
+            /**
+             * Gets the default type url for GetUserThemeConfigInfoReply
+             * @param [typeUrlPrefix] your custom typeUrlPrefix(default "type.googleapis.com")
+             * @returns The default type url
+             */
+            public static getTypeUrl(typeUrlPrefix?: string): string;
+        }
+
         /** Properties of a GetUserCommentsRequest. */
         interface IGetUserCommentsRequest {
 
@@ -25701,6 +25931,20 @@ declare namespace dcnet {
              */
             public getThemeComments(request: dcnet.pb.IGetThemeCommentsRequest): Promise<dcnet.pb.GetThemeCommentsReply>;
 
+            /**
+             * Calls GetUserThemeConfigInfo.
+             * @param request GetUserThemeConfigInfoRequest message or plain object
+             * @param callback Node-style callback called with the error, if any, and GetUserThemeConfigInfoReply
+             */
+            public getUserThemeConfigInfo(request: dcnet.pb.IGetUserThemeConfigInfoRequest, callback: dcnet.pb.Service.GetUserThemeConfigInfoCallback): void;
+
+            /**
+             * Calls GetUserThemeConfigInfo.
+             * @param request GetUserThemeConfigInfoRequest message or plain object
+             * @returns Promise
+             */
+            public getUserThemeConfigInfo(request: dcnet.pb.IGetUserThemeConfigInfoRequest): Promise<dcnet.pb.GetUserThemeConfigInfoReply>;
+
             /**
              * Calls GetThemeAuthList.
              * @param request GetThemeAuthListRequest message or plain object
@@ -26586,6 +26830,13 @@ declare namespace dcnet {
              */
             type GetThemeCommentsCallback = (error: (Error|null), response?: dcnet.pb.GetThemeCommentsReply) => void;
 
+            /**
+             * Callback as used by {@link dcnet.pb.Service#getUserThemeConfigInfo}.
+             * @param error Error, if any
+             * @param [response] GetUserThemeConfigInfoReply
+             */
+            type GetUserThemeConfigInfoCallback = (error: (Error|null), response?: dcnet.pb.GetUserThemeConfigInfoReply) => void;
+
             /**
              * Callback as used by {@link dcnet.pb.Service#getThemeAuthList}.
              * @param error Error, if any
@@ -26908,7 +27159,7 @@ declare class KeyValueDB {
     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]>;
+    set(key: string, value: any, indexs?: string, vaccount?: string): Promise<[boolean | null, number | 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]>;
@@ -26925,7 +27176,7 @@ declare class KeyValueManager {
     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]>;
+    vaccount?: string): Promise<[boolean | null, number | 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]>;
@@ -26977,16 +27228,24 @@ interface IKeyValueOperations {
      * @param value 值内容
      * @param indexs 索引列表，格式为json字符串:[{key:"indexkey1",type:"string",value:"value"},{key:"indexkey2",type:"number", value:12}],设置索引后,后续查询可以通过索引快速定位
      * @param vaccount 可选的虚拟账户
-     * @returns [是否设置成功, 错误信息]
+     * @returns [是否设置成功, 时间戳, 错误信息]
      */
-    set(kvdb: KeyValueDB, key: string, value: string, indexs: string, vaccount?: string): Promise<[boolean | null, Error | null]>;
+    set(kvdb: KeyValueDB, key: string, value: string, indexs: string, vaccount?: string): Promise<[boolean | null, number | 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$$${'timestamp':'%d','opuser':'%s'}
+     * @returns [值内容, 错误信息] 值的格式:  value$$$dckv_extra$$${'dc_timestamp':'%d','dc_opuser':'%s'}
      */
     get(kvdb: KeyValueDB, key: string, writerPubkey?: string, vaccount?: string): Promise<[string | null, Error | null]>;
     /**
@@ -26998,7 +27257,7 @@ interface IKeyValueOperations {
       * @param direction 查询方向
       * @param offset 结果偏移量
       * @param vaccount 可选的虚拟账户
-      * @returns [值列表生成的json字符串, 错误信息] 每个值的格式:  value$$$dckv_extra$$${'timestamp':'%d','opuser':'%s'}
+      * @returns [值列表数组生成的json字符串, 错误信息] 数组的每个元素的格式:  key:value$$$dckv_extra$$${'dc_timestamp':'%d','dc_opuser':'%s'}
       */
     getValues(kvdb: KeyValueDB, key: string, options: {
         limit?: number;
@@ -27012,7 +27271,7 @@ interface IKeyValueOperations {
      * @param keys 多个键名，逗号分隔
      * @param writerPubkey 写入者的公钥,可选,默认为主题作者
      * @param vaccount 可选的虚拟账户
-     * @returns [JSON格式值内容, 错误信息] 每个值的格式:  value$$$dckv_extra$$${'timestamp':'%d','opuser':'%s'}
+     * @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]>;
     /**
@@ -27026,7 +27285,7 @@ interface IKeyValueOperations {
      * @param direction 查询方向 (Forward/Backward)
      * @param limit 返回结果数量限制
      * @param vaccount 可选的虚拟账户
-     * @returns [JSON格式查询结果, 错误信息] 每个值的格式: value$$$dckv_extra$$${'timestamp':'%d','opuser':'%s'}
+     * @returns [值列表数组生成的json字符串, 错误信息] 数组的每个元素的格式:  key:value$$$dckv_extra$$${'dc_timestamp':'%d','dc_opuser':'%s'}
      */
     getWithIndex(kvdb: KeyValueDB, indexKey: string, indexValue: string, options: {
         type?: string;
@@ -28053,6 +28312,7 @@ declare class KeyValueModule implements DCModule, IKeyValueOperations {
     readonly moduleName = CoreModuleName.KEYVALUE;
     private keyValueManager;
     private initialized;
+    private context;
     /**
      * 初始化键值存储模块
      * @param context DC上下文
@@ -28077,14 +28337,22 @@ declare class KeyValueModule implements DCModule, IKeyValueOperations {
     configAuth(kvdb: KeyValueDB, authPubkey: string, permission: ThemePermission, remark: string, vaccount?: string): Promise<[number | null, Error | null]>;
     getAuthList(kvdb: KeyValueDB, vaccount?: string): Promise<[ThemeAuthInfo[] | null, ThemeComment[] | null, Error | null]>;
     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, Error | null]>;
+    vaccount?: string): Promise<[boolean | null, number | 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
      * @param key
      * @param writerPubkey
      * @param vaccount
-     * @returns  [值, 错误信息],值的格式:  value$$$dckv_extra$$${'timestamp':'%d','opuser':'%s'}
+     * @returns  [值, 错误信息],值的格式:  value$$$dckv_extra$$${'dc_timestamp':'%d','dc_opuser':'%s'}
      */
     get(kvdb: KeyValueDB, key: string, writerPubkey?: string, vaccount?: string): Promise<[string | null, Error | null]>;
     /**
@@ -28095,7 +28363,7 @@ declare class KeyValueModule implements DCModule, IKeyValueOperations {
     * @param seekKey 查询起始键,用于分页查询
     * @param offset 结果偏移量
     * @param vaccount 可选的虚拟账户
-    * @returns [值列表生成的json字符串, 错误信息] 每个值的格式:  value$$$dckv_extra$$${'timestamp':'%d','opuser':'%s'}
+    * @returns [值列表数组生成的json字符串, 错误信息] 数组的每个元素的格式:  key:value$$$dckv_extra$$${'dc_timestamp':'%d','dc_opuser':'%s'}
     */
     getValues(kvdb: KeyValueDB, key: string, options: {
         limit?: number;
@@ -28109,7 +28377,7 @@ declare class KeyValueModule implements DCModule, IKeyValueOperations {
      * @param keys 逗号分隔的键列表
      * @param writerPubkey 可选，指定写入者公钥
      * @param vaccount 可选的虚拟账户
-     * @returns [值的JSON字符串, 错误信息] 每个值的格式:  value$$$dckv_extra$$${'timestamp':'%d','opuser':'%s'}
+     * @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]>;
     /**
@@ -28122,7 +28390,7 @@ declare class KeyValueModule implements DCModule, IKeyValueOperations {
      * @param direction 查询方向
      * @param offset 结果偏移量
      * @param vaccount 可选的虚拟账户
-     * @returns [值的JSON字符串, 错误信息] 每个值的格式:  value$$$dckv_extra$$${'timestamp':'%d','opuser':'%s'}
+     * @returns [值的数组形式的JSON字符串, 错误信息] 数组的每个元素的格式:  key:value$$$dckv_extra$$${'dc_timestamp':'%d','dc_opuser':'%s'}
      */
     getWithIndex(kvdb: KeyValueDB, indexKey: string, indexValue: string, options: {
         type?: string;
@@ -28565,6 +28833,160 @@ declare class DC implements DCContext {
     get util(): UtilModule | null;
 }
 
+declare abstract class BaseEntity {
+    dc_timestamp?: number;
+    dc_opuser?: string;
+    constructor();
+    protected getPrimaryKey(): string;
+    touch(opuser?: string, timeMs?: number): this;
+    setOpUser(opuser: string): this;
+    validate(): void;
+    static from<T extends BaseEntity>(this: new () => T, data: Partial<T>): T;
+    toJSON(): Record<string, unknown>;
+}
+
+type Ctor<T> = new (...args: any[]) => T;
+declare function composeCompositeIndexValue(values: unknown[]): string;
+type FindIndexOptions = {
+    type?: "string" | "number" | "boolean" | "date" | "json" | "binary";
+    limit?: number;
+    seekKey?: string;
+    direction?: Direction;
+    offset?: number;
+    vaccount?: string;
+};
+type FindValuesOptions = {
+    limit?: number;
+    seekKey?: string;
+    direction?: Direction;
+    offset?: number;
+    vaccount?: string;
+};
+declare class EntityRepository<T extends BaseEntity> {
+    private readonly entityCtor;
+    private readonly ops;
+    private readonly db;
+    constructor(entityCtor: Ctor<T>, ops: IKeyValueOperations, db: KeyValueDB);
+    save(entity: T, vaccount?: string): Promise<number>;
+    deleteById(id: string, vaccount?: string): Promise<void>;
+    update(id: string, patch: Partial<T>, vaccount?: string): Promise<T | null>;
+    findById(id: string, writerPubkey?: string, vaccount?: string): Promise<T | null>;
+    findByIndex(indexKey: string, indexValue: string, options?: FindIndexOptions): Promise<T[]>;
+    findOneByIndex(indexKey: string, indexValue: string, options?: Omit<FindIndexOptions, "limit">): Promise<T | null>;
+    getValues(keyPrefix: string, options?: FindValuesOptions): Promise<T[]>;
+}
+
+type PrimitiveType = 'string' | 'number' | 'boolean' | 'date' | 'json' | 'binary';
+interface EntityOptions {
+    name?: string;
+    namespace?: string;
+    ttlSeconds?: number;
+    versioned?: boolean;
+}
+interface ColumnOptions<T = unknown> {
+    name?: string;
+    type?: PrimitiveType;
+    required?: boolean;
+    default?: T | (() => T);
+    index?: boolean;
+    unique?: boolean;
+}
+type IndexField = string | {
+    field: string;
+    order?: 'asc' | 'desc';
+};
+interface IndexOptions {
+    name?: string;
+    fields: IndexField[];
+    unique?: boolean;
+    ttlSeconds?: number;
+}
+interface EntityMeta {
+    target: Function;
+    name: string;
+    options: EntityOptions;
+}
+interface ColumnMeta {
+    target: Function;
+    propertyKey: string | symbol;
+    options: ColumnOptions;
+    resolvedName: string;
+}
+interface NormalizedIndexField {
+    field: string;
+    order: 'asc' | 'desc';
+}
+interface IndexMeta {
+    target: Function;
+    name: string;
+    fields: NormalizedIndexField[];
+    unique?: boolean;
+    ttlSeconds?: number;
+}
+declare class MetadataStorage {
+    private entities;
+    private columns;
+    private indexes;
+    registerEntity(target: Function, options?: EntityOptions, nameHint?: string): EntityMeta;
+    registerColumn(target: Function, propertyKey: string | symbol, options?: ColumnOptions): ColumnMeta;
+    registerIndex(target: Function, input: {
+        name?: string;
+        fields: IndexField[];
+        unique?: boolean;
+        ttlSeconds?: number;
+    }): void;
+    getEntity(target: Function | object): EntityMeta | undefined;
+    getColumns(target: Function | object): ColumnMeta[];
+    getIndexes(target: Function | object): IndexMeta[];
+    getSchema(target: Function | object): {
+        entity: EntityMeta | undefined;
+        columns: ColumnMeta[];
+        indexes: IndexMeta[];
+    };
+    private defaultIndexName;
+    private makeIndexKey;
+}
+declare const metadata: MetadataStorage;
+declare function Entity(options?: EntityOptions): (valueOrTarget: any, maybeContext?: unknown) => void;
+declare function Column(options?: ColumnOptions): (a: any, b: any) => void;
+declare function Index(nameOrOptions: string | IndexOptions, fields?: IndexOptions['fields']): (valueOrTarget: any, maybeContext?: unknown) => void;
+declare function getEntitySchema(target: Function | object): {
+    entity: EntityMeta | undefined;
+    columns: ColumnMeta[];
+    indexes: IndexMeta[];
+};
+declare function getEntityName(target: Function | object): string | undefined;
+declare function getColumns(target: Function | object): ColumnMeta[];
+declare function getIndexes(target: Function | object): IndexMeta[];
+
+type PrintableSchema = {
+    entityName: string;
+    namespace?: string;
+    ttlSeconds?: number;
+    versioned?: boolean;
+    columns: Array<{
+        name: string;
+        type?: string;
+        required?: boolean;
+        unique?: boolean;
+        index?: boolean;
+        default?: unknown;
+    }>;
+    indexes: Array<{
+        name: string;
+        fields: Array<{
+            field: string;
+            order: "asc" | "desc";
+        }>;
+        unique?: boolean;
+        ttlSeconds?: number;
+    }>;
+};
+interface FileContentMap {
+    [fileName: string]: string;
+}
+declare function extractSchemasFromSources(sources: FileContentMap): Promise<PrintableSchema[]>;
+
 /**
  * 注册 Service Worker 并设置消息监听器
  * @param fileOps 文件操作对象，用于处理IPFS请求
@@ -28643,5 +29065,5 @@ declare global {
     }
 }
 
-export { AIProxyModule, AIStreamResponseFlag, AuthModule, CacheModule, ClientModule, CommentModule, CommentType, CoreModuleName, DC, DatabaseModule, Direction, Ed25519PrivKey, Ed25519PubKey, Errors, FileModule, KeyManager, KeyValueModule, LogLevel, MessageModule, ModuleSystem, NFTBindStatus, OffChainOpTimes, OffChainOpTimesLimit, OffChainSpaceLimit, PeerStatus, ThemePermission, UploadStatus, UtilModule, configureLogger, createLogger, dc_protocol, dial_timeout, isServiceWorkerActive, keyExpire, registerServiceWorker, updateServiceWorker, walletOrigin, walletUrl, walletWindowName };
-export type { AIChatMessage, AIChatMessageRequest, AIMessageContent, AIMessageMediaSource, AIProxyConfig, APPInfo, Account, AccountInfo, DCConnectInfo, DCContext, DCModule, EIP712SignReqMessage, FileTransmit, FunctionDef, IAICallConfig, IAppInfo, IAuthOperations, ICacheOperations, IClientOperations, ICommentOperations, IDatabaseOperations, IFileOperations, IKeyValueOperations, IMessageOperations, IUtilOperations, ModelConfig, OnStreamResponseType, ProxyCallConfig, ResponseMessage, SendMessage, SignHandler, SignReqMessage, SignReqMessageData, SignResponseMessage, ThemeAuthInfo, ThemeComment, ThemeObj, ToolDefinition, User, UserProxyCallConfig };
+export { AIProxyModule, AIStreamResponseFlag, AuthModule, BaseEntity, CacheModule, ClientModule, Column, CommentModule, CommentType, CoreModuleName, DC, DatabaseModule, Direction, Ed25519PrivKey, Ed25519PubKey, Entity, EntityRepository, Errors, FileModule, Index, KeyManager, KeyValueModule, LogLevel, MessageModule, ModuleSystem, NFTBindStatus, OffChainOpTimes, OffChainOpTimesLimit, OffChainSpaceLimit, PeerStatus, ThemePermission, UploadStatus, UtilModule, composeCompositeIndexValue, configureLogger, createLogger, dc_protocol, dial_timeout, extractSchemasFromSources, getColumns, getEntityName, getEntitySchema, getIndexes, isServiceWorkerActive, keyExpire, metadata, registerServiceWorker, updateServiceWorker, walletOrigin, walletUrl, walletWindowName };
+export type { AIChatMessage, AIChatMessageRequest, AIMessageContent, AIMessageMediaSource, AIProxyConfig, APPInfo, Account, AccountInfo, ColumnMeta, ColumnOptions, DCConnectInfo, DCContext, DCModule, EIP712SignReqMessage, EntityMeta, EntityOptions, FileTransmit, FindIndexOptions, FindValuesOptions, FunctionDef, IAICallConfig, IAppInfo, IAuthOperations, ICacheOperations, IClientOperations, ICommentOperations, IDatabaseOperations, IFileOperations, IKeyValueOperations, IMessageOperations, IUtilOperations, IndexField, IndexMeta, IndexOptions, ModelConfig, NormalizedIndexField, OnStreamResponseType, PrimitiveType, PrintableSchema, ProxyCallConfig, ResponseMessage, SendMessage, SignHandler, SignReqMessage, SignReqMessageData, SignResponseMessage, ThemeAuthInfo, ThemeComment, ThemeObj, ToolDefinition, User, UserProxyCallConfig };