wtfai 1.6.4 → 1.6.5

package/README.md

@@ -506,28 +506,28 @@ const url = await IframeBridge.uploadFile(file, {
 > - `saveData/loadData` 存储在工作流 state 中（适合简单 key-value）
 > - Session Data API 存储在独立数据表中（适合结构化数据、列表数据）
 
-#### `IframeBridge.createRecord(collection, data)`
+#### `IframeBridge.createRecord(collection, data, options?)`
 
-在指定集合中创建一条记录。
+在指定集合中创建一条记录。可以通过 `options.entityId` 字段进行二级分类归属（如老师 ID、学生 ID），后续查询时利用此字段能大幅提升检索性能。
 
 ```javascript
 const id = await IframeBridge.createRecord('notes', {
   title: 'My Note',
   content: 'Hello World',
   createdAt: Date.now()
-});
+}, { entityId: 'user_123' }); // 可选的 entityId
 console.log('创建成功, ID:', id);
 ```
 
-#### `IframeBridge.createRecords(collection, dataList)`
+#### `IframeBridge.createRecords(collection, dataList, options?)`
 
-批量在指定集合中创建多条记录。
+批量在指定集合中创建多条记录。支持传入可选的配置项如 `entityId`。
 
 ```javascript
 const ids = await IframeBridge.createRecords('logs', [
   { level: 'info', message: 'Task started' },
   { level: 'success', message: 'Task finished' }
-]);
+], { entityId: 'user_123' });
 console.log('创建成功, IDs:', ids);
 ```
 
@@ -566,13 +566,14 @@ await IframeBridge.deleteRecord('notes', id);
 
 #### `IframeBridge.listRecords(collection, options?)`
 
-分页查询集合中的记录。
+分页查询集合中的记录。可以通过传入 `entityId` 来极速筛选归属于特定实体的数据。
 
 ```javascript
 const result = await IframeBridge.listRecords('notes', {
   page: 1,
   pageSize: 10,
-  order: 'DESC'
+  order: 'DESC',
+  entityId: 'user_123' // 可选，利用组合索引极速过滤
 });
 console.log(`共 ${result.total} 条记录`);
 result.records.forEach(r => {

package/dist/iframe-bridge.js

@@ -56,11 +56,11 @@ class IframeBridgeHost {
                 const [options] = params;
                 result = await this.session.uploadFileFromIframe(options);
             } else if ('createRecord' === method) {
-                const [collection, data] = params;
-                result = await this.session.createRecord(collection, data);
+                const [collection, data, options] = params;
+                result = await this.session.createRecord(collection, data, options);
             } else if ('createRecords' === method) {
-                const [collection, dataList] = params;
-                result = await this.session.createRecords(collection, dataList);
+                const [collection, dataList, options] = params;
+                result = await this.session.createRecords(collection, dataList, options);
             } else if ('getRecord' === method) {
                 const [collection, id] = params;
                 result = await this.session.getRecord(collection, id);

package/dist/session.d.ts

@@ -82,14 +82,18 @@ export declare class WorkflowSession {
      * @param data 数据内容
      * @returns 新创建记录的 ID
      */
-    createRecord(collection: string, data: Record<string, unknown>): Promise<string>;
+    createRecord(collection: string, data: Record<string, unknown>, options?: {
+        entityId?: string;
+    }): Promise<string>;
     /**
      * 批量创建数据记录
      * @param collection 集合名称
      * @param dataList 数据列表
      * @returns 新创建记录的 ID 列表
      */
-    createRecords(collection: string, dataList: Array<Record<string, unknown>>): Promise<string[]>;
+    createRecords(collection: string, dataList: Array<Record<string, unknown>>, options?: {
+        entityId?: string;
+    }): Promise<string[]>;
     /**
      * 获取数据记录
      * @param collection 集合名称
@@ -110,15 +114,11 @@ export declare class WorkflowSession {
      * @param id 记录 ID
      */
     deleteRecord(collection: string, id: string): Promise<void>;
-    /**
-     * 列表查询数据记录
-     * @param collection 集合名称
-     * @param options 分页选项
-     */
     listRecords(collection: string, options?: {
         page?: number;
         pageSize?: number;
         order?: 'ASC' | 'DESC';
+        entityId?: string;
     }): Promise<{
         records: Array<{
             id: string;

package/dist/session.js

@@ -161,7 +161,7 @@ class WorkflowSession {
             }, this.headers).catch(reject);
         });
     }
-    async createRecord(collection, data) {
+    async createRecord(collection, data, options = {}) {
         this.assertNotDisposed();
         if (!this.state.threadId) throw new Error('No active session (missing threadId)');
         const response = await fetch(`${this.baseUrl}/workflows/${this.workflowId}/data/${encodeURIComponent(collection)}`, {
@@ -172,14 +172,15 @@ class WorkflowSession {
             },
             body: JSON.stringify({
                 threadId: this.state.threadId,
-                data
+                data,
+                entityId: options.entityId
             })
         });
         if (!response.ok) throw new Error('Failed to create record');
         const result = await response.json();
         return result.id;
     }
-    async createRecords(collection, dataList) {
+    async createRecords(collection, dataList, options = {}) {
         this.assertNotDisposed();
         if (!this.state.threadId) throw new Error('No active session (missing threadId)');
         const response = await fetch(`${this.baseUrl}/workflows/${this.workflowId}/data/${encodeURIComponent(collection)}/batch`, {
@@ -190,7 +191,8 @@ class WorkflowSession {
             },
             body: JSON.stringify({
                 threadId: this.state.threadId,
-                dataList
+                dataList,
+                entityId: options.entityId
             })
         });
         if (!response.ok) throw new Error('Failed to create records');
@@ -242,9 +244,9 @@ class WorkflowSession {
         if (!this.state.threadId) throw new Error('No active session (missing threadId)');
         const url = new URL(`${this.baseUrl}/workflows/${this.workflowId}/data/${encodeURIComponent(collection)}`);
         url.searchParams.set('threadId', this.state.threadId);
-        if (null == options ? void 0 : options.page) url.searchParams.set('page', String(options.page));
-        if (null == options ? void 0 : options.pageSize) url.searchParams.set('pageSize', String(options.pageSize));
-        if (null == options ? void 0 : options.order) url.searchParams.set('order', options.order);
+        Object.entries(options || {}).forEach(([key, value])=>{
+            if (void 0 !== value) url.searchParams.set(key, String(value));
+        });
         const response = await fetch(url.toString(), {
             headers: this.headers
         });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wtfai",
-  "version": "1.6.4",
+  "version": "1.6.5",
   "type": "module",
   "exports": {
     ".": {