@aiao/rxdb-adapter-sqliteai 0.0.25 → 0.0.28

package/package.json

@@ -1,6 +1,19 @@
 {
   "name": "@aiao/rxdb-adapter-sqliteai",
-  "version": "0.0.25",
+  "version": "0.0.28",
+  "description": "SQLiteAI adapter with vector and AI functions for Aiao RxDB.",
+  "homepage": "https://rxdb.aiao.io/docs/adapters/sqliteai",
+  "bugs": {
+    "url": "https://github.com/aiao-io/rxdb/issues"
+  },
+  "keywords": [
+    "aiao",
+    "rxdb",
+    "sqliteai",
+    "sqlite",
+    "vector-search",
+    "ai"
+  ],
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -8,11 +21,18 @@
     "directory": "packages/rxdb-adapter-sqliteai"
   },
   "type": "module",
+  "sideEffects": false,
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
     "./package.json": "./package.json",
+    "./testing": {
+      "@aiao/source": "./src/testing.ts",
+      "types": "./dist/testing.d.ts",
+      "import": "./dist/testing.js",
+      "default": "./dist/testing.js"
+    },
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
@@ -37,13 +57,19 @@
     ]
   },
   "dependencies": {
-    "@sqliteai/sqlite-wasm": "3.50.4-wasm.1.0.0-sync.1.1.2-vector.1.0.0-memory.1.3.5",
-    "@aiao/rxdb": "0.0.25",
-    "@aiao/rxdb-adapter-sqlite-core": "0.0.25"
+    "@sqliteai/sqlite-wasm": "3.50.4-wasm.1.0.0-sync.1.2.0-vector.1.1.2-memory.1.3.5",
+    "@aiao/rxdb-adapter-sqlite-core": "^0.0.28"
   },
   "devDependencies": {
     "comlink": "^4.4.2",
     "ms": "^2.1.3",
-    "@aiao/rxdb-test": "0.0.25"
+    "@aiao/rxdb-plugin-working-tree": "0.0.28",
+    "@aiao/rxdb-test": "0.0.28",
+    "@aiao/rxdb-plugin-sync": "0.0.28",
+    "@aiao/rxdb-plugin-history": "0.0.28",
+    "@aiao/rxdb-plugin-querycache": "0.0.28"
+  },
+  "peerDependencies": {
+    "@aiao/rxdb": "^0.0.28"
   }
 }

package/src/RxDBAdapterSqliteai.ts

@@ -1,5 +1,5 @@
 import type { RxDB } from '@aiao/rxdb';
-import { RxDBAdapterSqliteBase, type SqliteClientLike } from '@aiao/rxdb-adapter-sqlite-core';
+import { RxDBAdapterSqliteBase, type SqliteBackupStorage, type SqliteClientLike } from '@aiao/rxdb-adapter-sqlite-core';
 import { createSqliteClient } from './create_sqlite_client.js';
 import { ADAPTER_NAME, type SqliteaiOptions } from './sqliteai.interface.js';
 
@@ -22,6 +22,16 @@ export class RxDBAdapterSqliteai extends RxDBAdapterSqliteBase {
     this.#dbName = rxdb.config.dbName;
   }
 
+  /**
+   * 不开 OPFS 时是内存库；开 OPFS 时是持久化库。
+   * `opfsFallback: 'memory'` 会在 OPFS 打不开时静默落到内存，恢复目标不确定，报 `unsupported_combination`。
+   */
+  protected override backupStorage(): SqliteBackupStorage {
+    if (!this.options.opfs) return { kind: 'memory', label: 'memory' };
+    if (this.options.opfsFallback === 'memory') return { kind: 'unsupported', field: 'opfsFallback', actual: 'memory' };
+    return this.persistentBackupStorage('opfs');
+  }
+
   protected override async createClient(): Promise<SqliteClientLike> {
     return createSqliteClient(this.#dbName, this.options);
   }

package/src/create_sqlite_client.ts

@@ -1,12 +1,18 @@
-import { assertLoadOptionsTransferable, wrapWithComlink, type SqliteClientLike } from '@aiao/rxdb-adapter-sqlite-core';
+import {
+  assertLoadOptionsTransferable,
+  releaseComlinkProxy,
+  wrapWithComlinkEndpoint,
+  type SqliteClientLike
+} from '@aiao/rxdb-adapter-sqlite-core';
 import { SqliteaiOptions, type SqliteaiLoadOptions } from './sqliteai.interface.js';
 import { SqliteaiClient } from './SqliteaiClient.js';
 
 /**
  * 创建 SqliteAI 客户端实例并完成初始化。
  *
- * 如果 `options` 中指定了 worker / sharedWorker，会通过 `wrapWithComlink` 把客户端代理到 worker；
- * 否则在主线程直接 new。
+ * 如果 `options` 中指定了 worker / sharedWorker，会通过 `wrapWithComlinkEndpoint` 为这次连接租用
+ * worker 的一条独立子端口；否则在主线程直接 new。释放后同一个 worker 可以再连：恢复先用一条连接写库，
+ * 之后的 `connect()` 再开一条。
  *
  * 返回类型是 {@link SqliteClientLike} 而非具体的 `SqliteaiClient`：worker 模式下拿到的是
  * Comlink 远端代理，它把每个方法都 Promise 化，断言成实现类会让 `beginTransactionSql(): string`
@@ -32,7 +38,14 @@ export async function createSqliteClient(dbName: string, options: SqliteaiOption
 
   assertLoadOptionsTransferable(loadOptions, options);
 
-  const client = wrapWithComlink(new SqliteaiClient(), options);
-  await client.init(dbName, loadOptions);
-  return client;
+  const client = await wrapWithComlinkEndpoint(new SqliteaiClient(), options);
+  try {
+    await client.init(dbName, loadOptions);
+    return client;
+  } catch (error) {
+    // 同 rxdb-adapter-sqlite / rxdb-adapter-sqlite-wasm：init 失败要释放 Comlink 代理，
+    // 否则 worker 模式下每次失败的重连都会多留一个 MessagePort 和一个 worker 侧客户端。
+    releaseComlinkProxy(client);
+    throw error;
+  }
 }

package/src/testing.ts

@@ -0,0 +1,21 @@
+/**
+ * sqliteai 适配器测试工具入口（test-only）。
+ *
+ * 通过 `@aiao/rxdb-adapter-sqliteai/testing` 子路径导出，供跨包测试复用
+ * `sqliteaiFactory`（US-703 AC#8 的搜索套件入口依赖它）。
+ *
+ * 刻意用 `import.meta.glob` 而不是直接 `export ... from './__tests__/...'`：
+ * 后者会在 lib 类型检查里把测试工厂（及其 `@aiao/rxdb-test/encrypted` 依赖链）
+ * 拖进 `rootDir`，违反 `src/__tests__/` 的 lib 排除约定。glob 不产生直接 TS
+ * import 边，测试工厂只在 vite 打包/运行期被解析，类型由泛型声明。
+ *
+ * @packageDocumentation
+ */
+
+import type { AdapterFactory } from '@aiao/rxdb-adapter-sqlite-core/testing';
+
+const factoryModules = import.meta.glob<{ sqliteaiFactory: AdapterFactory }>('./__tests__/sqliteai-factory.ts', {
+  eager: true
+});
+
+export const sqliteaiFactory: AdapterFactory = factoryModules['./__tests__/sqliteai-factory.ts'].sqliteaiFactory;