@aiao/rxdb-adapter-sqlite 0.0.6 → 0.0.7

package/dist/RxDBAdapterSqlite.d.ts

@@ -1,8 +1,12 @@
-import { EntityType, IRepository, IRxDBAdapter, RestoreEntityOptions, RxDBBranchRepository, RxDBChangeRepository, RxDB, RxDBAdapterLocalBase, TransactionFun } from '../packages/rxdb/src/index.ts';
+import { EntityType, IRxDBAdapter, RxDB, RxDBAdapterLocalBase, RxDBBranch, RxDBChange, RxDBMutationsMap, SwitchBranchOptions, SwitchVersionActions } from '../packages/rxdb/src/index.ts';
+import { SqliteRepository } from './repository/SqliteRepository.js';
+import { SqliteTreeRepository } from './repository/SqliteTreeRepository.js';
 import { ADAPTER_NAME, SqliteOptions, SqliteResult } from './sqlite.interface.js';
+import { SqliteClient } from './SqliteClient.js';
 import { SQLiteCompatibleType } from './wa-sqlite.interface.js';
+export type TransactionFun = (client: SqliteClient) => Promise<any>;
 /**
- * SQLite Adapter
+ * SQLite 适配器
  */
 export declare class RxDBAdapterSqlite extends RxDBAdapterLocalBase implements IRxDBAdapter {
     #private;
@@ -12,6 +16,11 @@ export declare class RxDBAdapterSqlite extends RxDBAdapterLocalBase implements I
      */
     name: string;
     constructor(rxdb: RxDB, options: SqliteOptions);
+    /**
+     * 获取实体仓库
+     * @param EntityType 实体类
+     */
+    getRepository<T extends EntityType, RT = SqliteRepository<T>>(EntityType: T): RT;
     /**
      * 连接 wab sqlite
      */
@@ -24,11 +33,6 @@ export declare class RxDBAdapterSqlite extends RxDBAdapterLocalBase implements I
      * 获取版本
      */
     version(): Promise<string>;
-    /**
-     * 获取实体仓库
-     * @param entity 实体类
-     */
-    getRepository<T extends EntityType, RT = IRepository<T>>(entity: T): RT;
     /**
      * 保存多个实体
      * TODO: 优化事件
@@ -41,6 +45,11 @@ export declare class RxDBAdapterSqlite extends RxDBAdapterLocalBase implements I
      * @returns
      */
     removeMany<T extends EntityType>(entities: InstanceType<T>[]): Promise<InstanceType<T>[]>;
+    /**
+     * 批量修改实体（创建/更新/删除）
+     * @param options
+     */
+    mutations(options: RxDBMutationsMap<any>): Promise<InstanceType<any>[]>;
     /**
      * 判断表是否存在
      * @param EntityType
@@ -48,23 +57,28 @@ export declare class RxDBAdapterSqlite extends RxDBAdapterLocalBase implements I
     isTableExisted<T extends EntityType>(EntityType: T): Promise<boolean>;
     /**
      * 创建表和初始化数据
-     * @param entities 表结构
-     * @param data 视图数据
+     * @param EntityTypes 表结构
+     * @param entities 视图数据
      * @returns
      */
     createTables<T extends EntityType>(EntityTypes: T[], entities?: InstanceType<T>[]): Promise<boolean>;
-    /**
-     * 创建分支
-     * @param branchId 分支 ID
-     * @param fromChangeId
-     */
-    createBranch(branchId: string, fromChangeId?: number): Promise<void>;
     /**
      * 切换分支
-     * @param branchId
+     * @param options 切换选项
      * @returns
      */
-    switchBranch(branchId: string): Promise<void>;
+    switchBranch(options: SwitchBranchOptions): Promise<void>;
+    /**
+     * 应用压缩后的变更到本地实体表
+     *
+     * 将 actions 转换为 SQL 操作实体表。
+     *
+     * @param actions - 压缩后的变更操作
+     * @param localChanges - （已废弃）不再使用，Pull 来的数据不应该生成 RxDBChange 记录
+     * @param disableTriggers - 是否禁用触发器（用于 pull 等操作，避免创建 RxDBChange）
+     * @deprecated localChanges 参数已废弃，将在未来版本中移除
+     */
+    mergeChanges(actions: SwitchVersionActions, localChanges?: Omit<RxDBChange, 'id'>[], disableTriggers?: boolean): Promise<void>;
     /**
      * 缓存 RowId 与实体映射
      * @param rowId
@@ -89,11 +103,9 @@ export declare class RxDBAdapterSqlite extends RxDBAdapterLocalBase implements I
      */
     getRowIdByEntity(entity: InstanceType<EntityType>): bigint | undefined;
     /**
-     * 恢复某个实体
-     * @param entity
-     * @param options
+     * 清空所有缓存
      */
-    restoreEntity<T extends EntityType>(entity: InstanceType<T>, options: RestoreEntityOptions): Promise<InstanceType<T>>;
+    cleanAllCache(): Promise<void>;
     /**
      * 执行 SQL 语句
      */
@@ -108,11 +120,28 @@ export declare class RxDBAdapterSqlite extends RxDBAdapterLocalBase implements I
     /**
      * 本地分支仓库
      */
-    localRxDBBranch(): RxDBBranchRepository;
+    localRxDBBranch(): SqliteRepository<typeof RxDBBranch>;
+    /**
+     * 内部查询
+     * 直接调用不会走队列
+     * @param sql
+     * @returns
+     */
+    internalQuery(sql: string, bindings?: SQLiteCompatibleType[]): Promise<SqliteResult>;
     /**
      * 本地变更仓库
      */
-    localRxDBChange(): RxDBChangeRepository;
+    localRxDBChange(): SqliteTreeRepository<typeof RxDBChange>;
+    /**
+     * 获取 RxDBChange 表的当前序列值
+     * @returns
+     */
+    getRxDBChangeSequence(): Promise<number>;
+    /**
+     * 设置 RxDBChange 表的序列值
+     * @param sequence 序列值
+     */
+    setRxDBChangeSequence(sequence: number): Promise<void>;
 }
 declare module '../packages/rxdb/src/index.ts' {
     interface RxDBAdapters {

package/dist/RxDBAdapterSqlite.d.ts.map

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

package/dist/SqliteClient.d.ts

@@ -7,24 +7,79 @@ export interface SqliteClientEvents {
     [SQliteChangeType.SQLITE_UPDATE]: SqliteChangeEvent;
 }
 /**
- * sqlite 客户端
+ * 批量事件发送间隔（毫秒）
+ *
+ * 预设档位：
+ * - IMMEDIATE (0ms): 立即发送，无批量合并，最低延迟
+ * - FAST (4ms): 快速响应，适合实时协作场景
+ * - BALANCED (16ms): 平衡模式，对应 60fps，推荐默认值
+ * - POWER_SAVE (50ms): 省电模式，最大化批量合并
+ */
+export declare const BATCH_TIMEOUT: {
+    readonly IMMEDIATE: 0;
+    readonly FAST: 4;
+    readonly BALANCED: 16;
+    readonly POWER_SAVE: 50;
+};
+/**
+ * SQLite 客户端
+ *
+ * 提供数据库连接、SQL 执行、变更监听等核心功能
+ *
+ * @example
+ * ```typescript
+ * const client = new SqliteClient();
+ *
+ * // 默认配置（16ms 平衡模式）
+ * await client.init('mydb', { url: '...' });
+ *
+ * // 快速响应模式（4ms）
+ * await client.init('mydb', {
+ *   url: '...',
+ *   batchTimeout: BATCH_TIMEOUT.FAST
+ * });
+ *
+ * const result = await client.execute('SELECT * FROM users');
+ * ```
  */
 export declare class SqliteClient extends EventDispatcher<SqliteClientEvents> {
     #private;
     /**
      * 初始化数据库
-     * @param dbName 数据库名称
-     * @param options 加载选项
-     * @returns
+     *
+     * @param dbName - 数据库名称（不含 .sqlite 扩展名）
+     * @param options - 加载选项
      */
     init(dbName: string, options: LoadModuleOptions): Promise<void>;
+    /**
+     * 获取 SQLite 版本号
+     *
+     * @returns SQLite 版本字符串
+     */
     version(): Promise<string>;
+    /**
+     * 断开数据库连接
+     *
+     * 等待所有待执行任务完成后关闭数据库连接
+     */
     disconnect(): Promise<void>;
     /**
-     * 执行 sql
-     * @param sql
-     * @param bindings
-     * @returns
+     * 执行 SQL 语句
+     *
+     * 所有查询自动排队，保证串行执行避免并发冲突
+     *
+     * @param sql - SQL 语句（支持多语句，用分号分隔）
+     * @param bindings - 参数绑定（可选）
+     * @returns 执行结果
+     * @throws {Error} 当客户端已断开连接时
+     *
+     * @example
+     * ```typescript
+     * const result = await client.execute(
+     *   'SELECT * FROM users WHERE id = ?',
+     *   [userId]
+     * );
+     * ```
      */
     execute(sql: string, bindings?: SQLiteCompatibleType[]): Promise<SqliteResult>;
 }

package/dist/SqliteClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SqliteClient.d.ts","sourceRoot":"","sources":["../src/SqliteClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,eAAe,EAAO,MAAM,aAAa,CAAC;AAIvE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC7G,OAAO,EAAa,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAS3E,MAAM,WAAW,kBAAkB;IACjC,CAAC,gBAAgB,CAAC,aAAa,CAAC,EAAE,iBAAiB,CAAC;IACpD,CAAC,gBAAgB,CAAC,aAAa,CAAC,EAAE,iBAAiB,CAAC;IACpD,CAAC,gBAAgB,CAAC,aAAa,CAAC,EAAE,iBAAiB,CAAC;CACrD;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,eAAe,CAAC,kBAAkB,CAAC;;IAmBnE;;;;;OAKG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB;IAoD/C,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAK1B,UAAU;IAOhB;;;;;OAKG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,oBAAoB,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC;CA6BrF"}
+{"version":3,"file":"SqliteClient.d.ts","sourceRoot":"","sources":["../src/SqliteClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,eAAe,EAAO,MAAM,aAAa,CAAC;AAIvE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC7G,OAAO,EAAa,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAS3E,MAAM,WAAW,kBAAkB;IACjC,CAAC,gBAAgB,CAAC,aAAa,CAAC,EAAE,iBAAiB,CAAC;IACpD,CAAC,gBAAgB,CAAC,aAAa,CAAC,EAAE,iBAAiB,CAAC;IACpD,CAAC,gBAAgB,CAAC,aAAa,CAAC,EAAE,iBAAiB,CAAC;CACrD;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa;;;;;CAKhB,CAAC;AAcX;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,YAAa,SAAQ,eAAe,CAAC,kBAAkB,CAAC;;IAUnE;;;;;OAKG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BrE;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAKhC;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAMjC;;;;;;;;;;;;;;;;;OAiBG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,oBAAoB,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC;CAuDrF"}

package/dist/{rxdb_create_sqlite_client.d.ts → create_sqlite_client.d.ts}

@@ -1,5 +1,11 @@
 import { SqliteOptions } from './sqlite.interface.js';
 import { SqliteClient } from './SqliteClient.js';
+/**
+ * 创建 SQLite 客户端
+ * @param dbName 数据库名称
+ * @param options 加载选项
+ * @returns SQLite 客户端实例
+ */
 declare const _default: (dbName: string, options: SqliteOptions) => Promise<SqliteClient>;
 export default _default;
-//# sourceMappingURL=rxdb_create_sqlite_client.d.ts.map
+//# sourceMappingURL=create_sqlite_client.d.ts.map

package/dist/create_sqlite_client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create_sqlite_client.d.ts","sourceRoot":"","sources":["../src/create_sqlite_client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAqB,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;;;;GAKG;yBACmB,QAAQ,MAAM,EAAE,SAAS,aAAa;AAA5D,wBA2BE"}

package/dist/entity/delete_sql.d.ts

@@ -1,6 +1,6 @@
 import { EntityMetadata, EntityType } from '../../packages/rxdb/src/index.ts';
 /**
- * Entity remove SQL
+ * 生成删除实体的 sql 语句
  */
 declare const _default: <T extends EntityType>(metadata: EntityMetadata, entity: InstanceType<T>) => {
     sql: string;

package/dist/entity/deletes_sql.d.ts

@@ -1,6 +1,6 @@
 import { EntityMetadata, EntityType } from '../../packages/rxdb/src/index.ts';
 /**
- * Entity remove SQL
+ * 生成删除实体的 sql 语句
  */
 declare const _default: <T extends EntityType>(metadata: EntityMetadata, entities: InstanceType<T>[]) => string;
 export default _default;

package/dist/entity/insert_sql.d.ts

@@ -1,8 +1,15 @@
 import { EntityMetadata, EntityType, IMutationContext } from '../../packages/rxdb/src/index.ts';
 import { GenerateSqlResult } from '../query/query_sql.js';
+export interface InsertSqlOptions extends IMutationContext {
+    /**
+     * 使用 INSERT OR REPLACE 而不是 INSERT
+     * 用于 pull/undo/redo 场景中可能的重复键
+     */
+    useReplace?: boolean;
+}
 /**
- * Entity Create SQL
+ * 生成创建实体的 sql 语句
  */
-declare const _default: <T extends EntityType>(metadata: EntityMetadata, entity: InstanceType<T>, context?: IMutationContext) => GenerateSqlResult;
+declare const _default: <T extends EntityType>(metadata: EntityMetadata, entity: InstanceType<T>, context?: InsertSqlOptions) => GenerateSqlResult;
 export default _default;
 //# sourceMappingURL=insert_sql.d.ts.map

package/dist/entity/insert_sql.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"insert_sql.d.ts","sourceRoot":"","sources":["../../src/entity/insert_sql.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAW,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAS1D;;GAEG;yBACa,CAAC,SAAS,UAAU,EAClC,UAAU,cAAc,EACxB,QAAQ,YAAY,CAAC,CAAC,CAAC,EACvB,UAAU,gBAAgB,KACzB,iBAAiB;AAJpB,wBA8BE"}
+{"version":3,"file":"insert_sql.d.ts","sourceRoot":"","sources":["../../src/entity/insert_sql.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAW,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAS1D,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACxD;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;yBACa,CAAC,SAAS,UAAU,EAClC,UAAU,cAAc,EACxB,QAAQ,YAAY,CAAC,CAAC,CAAC,EACvB,UAAU,gBAAgB,KACzB,iBAAiB;AAJpB,wBAyCE"}

package/dist/entity/inserts_sql.d.ts

@@ -1,6 +1,6 @@
 import { EntityMetadata, EntityType, IQueryContext } from '../../packages/rxdb/src/index.ts';
 /**
- * Entity Create SQL
+ * 生成批量创建实体的 sql 语句
  */
 declare const _default: <T extends EntityType>(metadata: EntityMetadata, entities: InstanceType<T>[], context?: IQueryContext) => string;
 export default _default;

package/dist/entity/mod_entities_sql.d.ts

@@ -0,0 +1,8 @@
+import { EntityType, IMutationContext, RxDBMutationsMap } from '../../packages/rxdb/src/index.ts';
+import { RxDBAdapterSqlite } from '../RxDBAdapterSqlite.js';
+/**
+ * 批量修改实体（创建/更新/删除）
+ */
+declare const _default: <T extends EntityType = any>(adapter: RxDBAdapterSqlite, mutations: RxDBMutationsMap<T>, context?: IMutationContext) => Promise<InstanceType<T>[]>;
+export default _default;
+//# sourceMappingURL=mod_entities_sql.d.ts.map

package/dist/entity/mod_entities_sql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod_entities_sql.d.ts","sourceRoot":"","sources":["../../src/entity/mod_entities_sql.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAsC,gBAAgB,EAAE,gBAAgB,EAAQ,MAAM,YAAY,CAAC;AAItH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAMjE;;GAEG;yBACmB,CAAC,SAAS,UAAU,GAAG,GAAG,EAC9C,SAAS,iBAAiB,EAC1B,WAAW,gBAAgB,CAAC,CAAC,CAAC,EAC9B,UAAU,gBAAgB,KACzB,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;AAJ7B,wBAwHE"}

package/dist/entity/update_sql.d.ts

@@ -1,8 +1,14 @@
 import { EntityMetadata, EntityType, IMutationContext } from '../../packages/rxdb/src/index.ts';
 import { GenerateSqlResult } from '../query/query_sql.js';
 /**
- * 计算更新 entity 的 SQL
+ * 计算更新实体的 SQL 语句
+ * @template T - 实体类型
+ * @param metadata - 实体元数据
+ * @param entityOrEntities - 要更新的实体实例或实体实例数组
+ * @param patch - 更新的数据补丁
+ * @param context - 变更上下文，可选
+ * @returns 生成的 SQL 语句和参数
  */
-declare const _default: <T extends EntityType>(metadata: EntityMetadata, entityOrEntities: InstanceType<T> | InstanceType<T>[], patch: Partial<InstanceType<T>>, context?: IMutationContext) => GenerateSqlResult;
-export default _default;
+export declare const update_sql: <T extends EntityType>(metadata: EntityMetadata, entityOrEntities: InstanceType<T> | InstanceType<T>[], patch: Partial<InstanceType<T>>, context?: IMutationContext) => GenerateSqlResult;
+export default update_sql;
 //# sourceMappingURL=update_sql.d.ts.map

package/dist/entity/update_sql.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update_sql.d.ts","sourceRoot":"","sources":["../../src/entity/update_sql.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAW,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAI1D;;GAEG;yBACa,CAAC,SAAS,UAAU,EAClC,UAAU,cAAc,EACxB,kBAAkB,YAAY,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,EAAE,EACrD,OAAO,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAC/B,UAAU,gBAAgB,KACzB,iBAAiB;AALpB,wBA2CE"}
+{"version":3,"file":"update_sql.d.ts","sourceRoot":"","sources":["../../src/entity/update_sql.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAW,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAU1D;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,UAAU,EAC7C,UAAU,cAAc,EACxB,kBAAkB,YAAY,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,EAAE,EACrD,OAAO,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAC/B,UAAU,gBAAgB,KACzB,iBAuCF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/handle_rxdb_change.d.ts

@@ -0,0 +1,5 @@
+import { EntityType } from '../packages/rxdb/src/index.ts';
+import { RxDBAdapterSqlite } from './RxDBAdapterSqlite.js';
+import { SqliteChangeEvent } from './sqlite.interface.js';
+export declare const handle_rxdb_change: <T extends EntityType>(adapter: RxDBAdapterSqlite, event: SqliteChangeEvent) => void;
+//# sourceMappingURL=handle_rxdb_change.d.ts.map

package/dist/handle_rxdb_change.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle_rxdb_change.d.ts","sourceRoot":"","sources":["../src/handle_rxdb_change.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,UAAU,EAOX,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAA0B,iBAAiB,EAAoB,MAAM,uBAAuB,CAAC;AAqEpG,eAAO,MAAM,kBAAkB,GAAI,CAAC,SAAS,UAAU,EAAE,SAAS,iBAAiB,EAAE,OAAO,iBAAiB,SAwF5G,CAAC"}

package/dist/index.d.ts

@@ -1,6 +1,9 @@
+export { buildRuleGroup } from './query/query_sql.js';
+export type { GenerateSqlResult } from './query/query_sql.js';
+export { SqliteRepository } from './repository/SqliteRepository.js';
 export { RxDBAdapterSqlite } from './RxDBAdapterSqlite.js';
-export { sqliteLoad, WA_SQLITE_VFS_LIST } from './sqlite-load.utils.js';
+export { WA_SQLITE_VFS_LIST, sqliteLoad } from './sqlite-load.utils.js';
 export type { SqliteOptions } from './sqlite.interface.js';
-export { RxdbAdapterSqliteError } from './sqlite.utils.js';
+export { ROWID, RxDBAdapterSqliteError, get_table_name as sqliteGetTableName, get_table_name_by_metadata as sqliteGetTableNameByMetadata } from './sqlite.utils.js';
 export { SqliteClient } from './SqliteClient.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACxE,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACxE,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EACL,KAAK,EACL,sBAAsB,EACtB,cAAc,IAAI,kBAAkB,EACpC,0BAA0B,IAAI,4BAA4B,EAC3D,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}