@shaxpir/duiduidui-models 1.4.11 → 1.4.14

package/dist/repo/ShareSync.d.ts

@@ -57,6 +57,12 @@ export declare class ShareSync {
     createManifest(body: ManifestBody): Manifest;
     createContent(body: ContentBody): Content;
     acquire(kind: ContentKind, id: ContentId, timestamp?: CompactDateTime): Promise<Model>;
+    /**
+     * Acquire multiple models of the same kind in a bulk operation.
+     * This leverages DurableStore's bulk capabilities for significant performance gains
+     * when loading multiple models simultaneously (e.g., component terms in proficiency updates).
+     */
+    acquireMultiple(kind: ContentKind, ids: ContentId[], timestamp?: CompactDateTime): Promise<Model[]>;
     load(kind: ContentKind, id: ContentId): Model;
     findAndAcquire(kind: ContentKind, query: any): Promise<Content[]>;
     updateManifestForContent(content: Content): Promise<void>;

package/dist/repo/ShareSync.js

@@ -267,6 +267,44 @@ class ShareSync {
         }
         return model;
     }
+    /**
+     * Acquire multiple models of the same kind in a bulk operation.
+     * This leverages DurableStore's bulk capabilities for significant performance gains
+     * when loading multiple models simultaneously (e.g., component terms in proficiency updates).
+     */
+    async acquireMultiple(kind, ids, timestamp) {
+        if (!Array.isArray(ids) || ids.length === 0) {
+            return [];
+        }
+        // Load all models first (this creates docs, wraps them, and caches them)
+        const models = ids.map(id => this.load(kind, id));
+        // Try bulk acquire if DurableStore supports it
+        if (this._durableStore?.getDocsBulk) {
+            try {
+                const durableStore = this._durableStore;
+                const docIds = models.map(model => model.doc.id);
+                // Use DurableStore's bulk retrieval
+                const docDatas = await new Promise((resolve, reject) => {
+                    durableStore.getDocsBulk(kind, docIds, (error, data) => {
+                        if (error)
+                            reject(error);
+                        else
+                            resolve(data || []);
+                    });
+                });
+                // Bulk retrieval was successful, now do normal acquire for all models
+                // The DurableStore bulk operation has already loaded the data, so individual
+                // acquire operations should be fast (no additional network requests)
+                const acquirePromises = models.map(model => timestamp ? model.acquire(timestamp) : model.acquire());
+                return Promise.all(acquirePromises);
+            }
+            catch (error) {
+                console.warn('Bulk acquire failed, falling back to individual acquire:', error);
+            }
+        }
+        // Fallback to individual acquire calls
+        return Promise.all(models.map(model => timestamp ? model.acquire(timestamp) : model.acquire()));
+    }
     load(kind, id) {
         // First, try getting the content from the cache
         const compoundKey = `${kind}/${id}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shaxpir/duiduidui-models",
-  "version": "1.4.11",
+  "version": "1.4.14",
   "repository": {
     "type": "git",
     "url": "https://github.com/shaxpir/duiduidui-models"
@@ -16,7 +16,7 @@
     "dist/"
   ],
   "dependencies": {
-    "@shaxpir/sharedb": "^6.0.5",
+    "@shaxpir/sharedb": "^6.0.6",
     "@shaxpir/shaxpir-common": "1.3.0",
     "ot-json1": "1.0.1",
     "ot-text-unicode": "4.0.0",