@vue-skuilder/db 0.1.39 → 0.2.0

package/dist/index.d.cts

@@ -1117,6 +1117,17 @@ interface DataLayerConfig {
         COUCHDB_USERNAME?: string;
         COUCHDB_PASSWORD?: string;
         COURSE_IDS?: string[];
+        /**
+         * Per-app tuning for the CouchDB→PouchDB course sync. Only applies when
+         * `type === 'couch'` and the course has `localSync.enabled === true`.
+         * See CourseSyncService.ReplicationOptions for defaults.
+         */
+        courseSync?: {
+            replication?: {
+                batchSize?: number;
+                batchesLimit?: number;
+            };
+        };
     };
 }
 /**

package/dist/index.d.ts

@@ -1117,6 +1117,17 @@ interface DataLayerConfig {
         COUCHDB_USERNAME?: string;
         COUCHDB_PASSWORD?: string;
         COURSE_IDS?: string[];
+        /**
+         * Per-app tuning for the CouchDB→PouchDB course sync. Only applies when
+         * `type === 'couch'` and the course has `localSync.enabled === true`.
+         * See CourseSyncService.ReplicationOptions for defaults.
+         */
+        courseSync?: {
+            replication?: {
+                batchSize?: number;
+                batchesLimit?: number;
+            };
+        };
     };
 }
 /**

package/dist/index.js

@@ -6469,16 +6469,25 @@ var init_adminDB2 = __esm({
 });
 
 // src/impl/couch/CourseSyncService.ts
-var CourseSyncService;
+var CourseSyncService_exports = {};
+__export(CourseSyncService_exports, {
+  CourseSyncService: () => CourseSyncService
+});
+var DEFAULT_REPLICATION, CourseSyncService;
 var init_CourseSyncService = __esm({
   "src/impl/couch/CourseSyncService.ts"() {
     "use strict";
     init_pouchdb_setup();
     init_couch();
     init_logger();
+    DEFAULT_REPLICATION = {
+      batchSize: 1e3,
+      batchesLimit: 5
+    };
     CourseSyncService = class _CourseSyncService {
       static instance = null;
       entries = /* @__PURE__ */ new Map();
+      replicationOptions = DEFAULT_REPLICATION;
       constructor() {
       }
       static getInstance() {
@@ -6487,6 +6496,21 @@ var init_CourseSyncService = __esm({
         }
         return _CourseSyncService.instance;
       }
+      /**
+       * Apply replication tuning. Typically called once from `initializeDataLayer`.
+       * Partial overrides merge with defaults.
+       */
+      configure(opts) {
+        if (opts.replication) {
+          this.replicationOptions = {
+            ...DEFAULT_REPLICATION,
+            ...opts.replication
+          };
+          logger.info(
+            `[CourseSyncService] Replication configured: batch_size=${this.replicationOptions.batchSize}, batches_limit=${this.replicationOptions.batchesLimit}`
+          );
+        }
+      }
       /**
        * Reset the singleton (for testing).
        */
@@ -6615,7 +6639,7 @@ var init_CourseSyncService = __esm({
           const remoteDB = this.getRemoteDB(courseId);
           const syncStart = Date.now();
           logger.info(
-            `[CourseSyncService] Starting one-shot replication for course ${courseId}`
+            `[CourseSyncService] Starting one-shot replication for course ${courseId} (batch_size=${this.replicationOptions.batchSize}, batches_limit=${this.replicationOptions.batchesLimit})`
           );
           const result = await this.replicate(remoteDB, localDB);
           const syncTimeMs = Date.now() - syncStart;
@@ -6673,6 +6697,8 @@ var init_CourseSyncService = __esm({
         return new Promise((resolve, reject) => {
           void pouchdb_setup_default.replicate(source, target, {
             // One-shot, not live. Local is a read-only snapshot.
+            batch_size: this.replicationOptions.batchSize,
+            batches_limit: this.replicationOptions.batchesLimit
           }).on("complete", (info) => {
             resolve(info);
           }).on("error", (err) => {
@@ -9298,6 +9324,10 @@ async function initializeDataLayer(config) {
     ENV.COUCHDB_SERVER_URL = config.options.COUCHDB_SERVER_URL;
     ENV.COUCHDB_USERNAME = config.options.COUCHDB_USERNAME;
     ENV.COUCHDB_PASSWORD = config.options.COUCHDB_PASSWORD;
+    if (config.options.courseSync) {
+      const { CourseSyncService: CourseSyncService2 } = await Promise.resolve().then(() => (init_CourseSyncService(), CourseSyncService_exports));
+      CourseSyncService2.getInstance().configure(config.options.courseSync);
+    }
     if (config.options.COUCHDB_PASSWORD && config.options.COUCHDB_USERNAME && typeof window !== "undefined") {
       const { CouchDBSyncStrategy: CouchDBSyncStrategy2 } = await Promise.resolve().then(() => (init_CouchDBSyncStrategy(), CouchDBSyncStrategy_exports));
       const syncStrategy = new CouchDBSyncStrategy2();
@@ -13968,8 +13998,8 @@ var SessionController = class _SessionController extends Loggable {
       this._minCardsGuarantee--;
       this.log(`[CardGuarantee] ${this._minCardsGuarantee} guaranteed cards remaining`);
     }
-    if (this._replanPromise) {
-      this.log("nextCard: awaiting in-flight replan before drawing");
+    if (this._replanPromise && this.newQ.length === 0 && this.reviewQ.length === 0 && this.failedQ.length === 0) {
+      this.log("nextCard: queues empty, awaiting in-flight replan before drawing");
       await this._replanPromise;
     }
     if (this.newQ.length <= 1 && this._secondsRemaining > 0 && !this._replanPromise) {