@vue-skuilder/db 0.1.39 → 0.1.40

package/dist/impl/couch/index.d.cts

@@ -351,11 +351,35 @@ interface CourseSyncStatus {
  *
  * The service is a singleton — course sync state is shared across the app.
  */
+/**
+ * Tuning knobs for one-shot remote→local replication.
+ * Defaults are chosen for one-shot snapshot replication of bounded course
+ * corpora (text/JSON docs, no large attachments). PouchDB's built-in
+ * defaults (100/10) target live continuous sync — too conservative for
+ * cold-load UX on a course of a few thousand docs.
+ *
+ * Apps with smaller/larger corpora can override via
+ * `initializeDataLayer({ options: { courseSync: { replication: {...} } } })`.
+ */
+interface ReplicationOptions {
+    /** Docs per `_bulk_get` HTTP request. Higher = fewer roundtrips. */
+    batchSize?: number;
+    /** Concurrent batches in flight. */
+    batchesLimit?: number;
+}
 declare class CourseSyncService {
     private static instance;
     private entries;
+    private replicationOptions;
     private constructor();
     static getInstance(): CourseSyncService;
+    /**
+     * Apply replication tuning. Typically called once from `initializeDataLayer`.
+     * Partial overrides merge with defaults.
+     */
+    configure(opts: {
+        replication?: ReplicationOptions;
+    }): void;
     /**
      * Reset the singleton (for testing).
      */
@@ -506,4 +530,4 @@ declare function getStartAndEndKeys(key: string): {
     endkey: string;
 };
 
-export { AdminDB, CLASSROOM_CONFIG, ClassroomLookupDB, type ClassroomMessage, CouchDBSyncStrategy, CourseDB, CourseSyncService, type CourseSyncState, type CourseSyncStatus, CoursesDB, REVIEW_TIME_FORMAT, StudentClassroomDB, StudyContentSource, StudySessionItem, TeacherClassroomDB, addNote55, addTagToCard, createPouchDBConfig, createTag, deleteTag, filterAllDocsByPrefix, getAncestorTagIDs, getAppliedTags, getChildTagStubs, getClassroomConfig, getClassroomDB, getCouchUserDB, getCourseDB, getCourseDataShapes, getCourseDoc, getCourseDocs, getCourseQuestionTypes, getCourseTagStubs, getCredentialledCourseConfig, getCredentialledDataShapes, getLatestVersion, getRandomCards, getStartAndEndKeys, getTag, getTagID, hexEncode, localUserDB, removeTagFromCard, scheduleCardReview, updateCardElo, updateCredentialledCourseConfig, updateGuestAccountExpirationDate, updateTag, usernameIsAvailable };
+export { AdminDB, CLASSROOM_CONFIG, ClassroomLookupDB, type ClassroomMessage, CouchDBSyncStrategy, CourseDB, CourseSyncService, type CourseSyncState, type CourseSyncStatus, CoursesDB, REVIEW_TIME_FORMAT, type ReplicationOptions, StudentClassroomDB, StudyContentSource, StudySessionItem, TeacherClassroomDB, addNote55, addTagToCard, createPouchDBConfig, createTag, deleteTag, filterAllDocsByPrefix, getAncestorTagIDs, getAppliedTags, getChildTagStubs, getClassroomConfig, getClassroomDB, getCouchUserDB, getCourseDB, getCourseDataShapes, getCourseDoc, getCourseDocs, getCourseQuestionTypes, getCourseTagStubs, getCredentialledCourseConfig, getCredentialledDataShapes, getLatestVersion, getRandomCards, getStartAndEndKeys, getTag, getTagID, hexEncode, localUserDB, removeTagFromCard, scheduleCardReview, updateCardElo, updateCredentialledCourseConfig, updateGuestAccountExpirationDate, updateTag, usernameIsAvailable };

package/dist/impl/couch/index.d.ts

@@ -351,11 +351,35 @@ interface CourseSyncStatus {
  *
  * The service is a singleton — course sync state is shared across the app.
  */
+/**
+ * Tuning knobs for one-shot remote→local replication.
+ * Defaults are chosen for one-shot snapshot replication of bounded course
+ * corpora (text/JSON docs, no large attachments). PouchDB's built-in
+ * defaults (100/10) target live continuous sync — too conservative for
+ * cold-load UX on a course of a few thousand docs.
+ *
+ * Apps with smaller/larger corpora can override via
+ * `initializeDataLayer({ options: { courseSync: { replication: {...} } } })`.
+ */
+interface ReplicationOptions {
+    /** Docs per `_bulk_get` HTTP request. Higher = fewer roundtrips. */
+    batchSize?: number;
+    /** Concurrent batches in flight. */
+    batchesLimit?: number;
+}
 declare class CourseSyncService {
     private static instance;
     private entries;
+    private replicationOptions;
     private constructor();
     static getInstance(): CourseSyncService;
+    /**
+     * Apply replication tuning. Typically called once from `initializeDataLayer`.
+     * Partial overrides merge with defaults.
+     */
+    configure(opts: {
+        replication?: ReplicationOptions;
+    }): void;
     /**
      * Reset the singleton (for testing).
      */
@@ -506,4 +530,4 @@ declare function getStartAndEndKeys(key: string): {
     endkey: string;
 };
 
-export { AdminDB, CLASSROOM_CONFIG, ClassroomLookupDB, type ClassroomMessage, CouchDBSyncStrategy, CourseDB, CourseSyncService, type CourseSyncState, type CourseSyncStatus, CoursesDB, REVIEW_TIME_FORMAT, StudentClassroomDB, StudyContentSource, StudySessionItem, TeacherClassroomDB, addNote55, addTagToCard, createPouchDBConfig, createTag, deleteTag, filterAllDocsByPrefix, getAncestorTagIDs, getAppliedTags, getChildTagStubs, getClassroomConfig, getClassroomDB, getCouchUserDB, getCourseDB, getCourseDataShapes, getCourseDoc, getCourseDocs, getCourseQuestionTypes, getCourseTagStubs, getCredentialledCourseConfig, getCredentialledDataShapes, getLatestVersion, getRandomCards, getStartAndEndKeys, getTag, getTagID, hexEncode, localUserDB, removeTagFromCard, scheduleCardReview, updateCardElo, updateCredentialledCourseConfig, updateGuestAccountExpirationDate, updateTag, usernameIsAvailable };
+export { AdminDB, CLASSROOM_CONFIG, ClassroomLookupDB, type ClassroomMessage, CouchDBSyncStrategy, CourseDB, CourseSyncService, type CourseSyncState, type CourseSyncStatus, CoursesDB, REVIEW_TIME_FORMAT, type ReplicationOptions, StudentClassroomDB, StudyContentSource, StudySessionItem, TeacherClassroomDB, addNote55, addTagToCard, createPouchDBConfig, createTag, deleteTag, filterAllDocsByPrefix, getAncestorTagIDs, getAppliedTags, getChildTagStubs, getClassroomConfig, getClassroomDB, getCouchUserDB, getCourseDB, getCourseDataShapes, getCourseDoc, getCourseDocs, getCourseQuestionTypes, getCourseTagStubs, getCredentialledCourseConfig, getCredentialledDataShapes, getLatestVersion, getRandomCards, getStartAndEndKeys, getTag, getTagID, hexEncode, localUserDB, removeTagFromCard, scheduleCardReview, updateCardElo, updateCredentialledCourseConfig, updateGuestAccountExpirationDate, updateTag, usernameIsAvailable };

package/dist/impl/couch/index.js

@@ -7954,16 +7954,21 @@ var init_adminDB2 = __esm({
 });
 
 // src/impl/couch/CourseSyncService.ts
-var 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() {
@@ -7972,6 +7977,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).
        */
@@ -8100,7 +8120,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;
@@ -8158,6 +8178,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) => {