@vue-skuilder/db 0.1.4 → 0.1.6

package/dist/impl/static/index.mjs

@@ -0,0 +1,3025 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __glob = (map) => (path) => {
+  var fn = map[path];
+  if (fn) return fn();
+  throw new Error("Module not found in bundle: " + path);
+};
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// src/util/logger.ts
+var isDevelopment, logger;
+var init_logger = __esm({
+  "src/util/logger.ts"() {
+    "use strict";
+    isDevelopment = typeof process !== "undefined" && process.env.NODE_ENV === "development";
+    logger = {
+      /**
+       * Debug-level logging - only shown in development
+       */
+      debug: (message, ...args) => {
+        if (isDevelopment) {
+          console.debug(`[DB:DEBUG] ${message}`, ...args);
+        }
+      },
+      /**
+       * Info-level logging - general information
+       */
+      info: (message, ...args) => {
+        console.info(`[DB:INFO] ${message}`, ...args);
+      },
+      /**
+       * Warning-level logging - potential issues
+       */
+      warn: (message, ...args) => {
+        console.warn(`[DB:WARN] ${message}`, ...args);
+      },
+      /**
+       * Error-level logging - serious problems
+       */
+      error: (message, ...args) => {
+        console.error(`[DB:ERROR] ${message}`, ...args);
+      },
+      /**
+       * Log function for backward compatibility with existing log() usage
+       */
+      log: (message, ...args) => {
+        if (isDevelopment) {
+          console.log(`[DB:LOG] ${message}`, ...args);
+        }
+      }
+    };
+  }
+});
+
+// src/core/interfaces/adminDB.ts
+var init_adminDB = __esm({
+  "src/core/interfaces/adminDB.ts"() {
+    "use strict";
+  }
+});
+
+// src/core/interfaces/classroomDB.ts
+var init_classroomDB = __esm({
+  "src/core/interfaces/classroomDB.ts"() {
+    "use strict";
+  }
+});
+
+// src/factory.ts
+var ENV;
+var init_factory = __esm({
+  "src/factory.ts"() {
+    "use strict";
+    init_logger();
+    ENV = {
+      COUCHDB_SERVER_PROTOCOL: "NOT_SET",
+      COUCHDB_SERVER_URL: "NOT_SET"
+    };
+  }
+});
+
+// src/impl/couch/pouchdb-setup.ts
+import PouchDB from "pouchdb";
+import PouchDBFind from "pouchdb-find";
+import PouchDBAuth from "@nilock2/pouchdb-authentication";
+var pouchdb_setup_default;
+var init_pouchdb_setup = __esm({
+  "src/impl/couch/pouchdb-setup.ts"() {
+    "use strict";
+    PouchDB.plugin(PouchDBFind);
+    PouchDB.plugin(PouchDBAuth);
+    PouchDB.defaults({
+      ajax: {
+        timeout: 6e4
+      }
+    });
+    pouchdb_setup_default = PouchDB;
+  }
+});
+
+// src/core/types/types-legacy.ts
+var GuestUsername, DocType, cardHistoryPrefix;
+var init_types_legacy = __esm({
+  "src/core/types/types-legacy.ts"() {
+    "use strict";
+    init_logger();
+    GuestUsername = "Guest";
+    DocType = /* @__PURE__ */ ((DocType2) => {
+      DocType2["DISPLAYABLE_DATA"] = "DISPLAYABLE_DATA";
+      DocType2["CARD"] = "CARD";
+      DocType2["DATASHAPE"] = "DATASHAPE";
+      DocType2["QUESTIONTYPE"] = "QUESTION";
+      DocType2["VIEW"] = "VIEW";
+      DocType2["PEDAGOGY"] = "PEDAGOGY";
+      DocType2["CARDRECORD"] = "CARDRECORD";
+      DocType2["SCHEDULED_CARD"] = "SCHEDULED_CARD";
+      DocType2["TAG"] = "TAG";
+      DocType2["NAVIGATION_STRATEGY"] = "NAVIGATION_STRATEGY";
+      return DocType2;
+    })(DocType || {});
+    cardHistoryPrefix = "cardH";
+  }
+});
+
+// src/impl/couch/courseLookupDB.ts
+var init_courseLookupDB = __esm({
+  "src/impl/couch/courseLookupDB.ts"() {
+    "use strict";
+    init_pouchdb_setup();
+    init_factory();
+    init_logger();
+    logger.debug(`COURSELOOKUP FILE RUNNING`);
+  }
+});
+
+// src/impl/couch/adminDB.ts
+var init_adminDB2 = __esm({
+  "src/impl/couch/adminDB.ts"() {
+    "use strict";
+    init_pouchdb_setup();
+    init_factory();
+    init_couch();
+    init_classroomDB2();
+    init_courseLookupDB();
+    init_logger();
+  }
+});
+
+// src/util/Loggable.ts
+var Loggable;
+var init_Loggable = __esm({
+  "src/util/Loggable.ts"() {
+    "use strict";
+    Loggable = class {
+      log(...args) {
+        console.log(`LOG-${this._className}@${/* @__PURE__ */ new Date()}:`, ...args);
+      }
+      error(...args) {
+        console.error(`ERROR-${this._className}@${/* @__PURE__ */ new Date()}:`, ...args);
+      }
+    };
+  }
+});
+
+// src/impl/couch/updateQueue.ts
+var UpdateQueue;
+var init_updateQueue = __esm({
+  "src/impl/couch/updateQueue.ts"() {
+    "use strict";
+    init_Loggable();
+    init_logger();
+    UpdateQueue = class extends Loggable {
+      _className = "UpdateQueue";
+      pendingUpdates = {};
+      inprogressUpdates = {};
+      db;
+      update(id, update) {
+        logger.debug(`Update requested on doc: ${id}`);
+        if (this.pendingUpdates[id]) {
+          this.pendingUpdates[id].push(update);
+        } else {
+          this.pendingUpdates[id] = [update];
+        }
+        return this.applyUpdates(id);
+      }
+      constructor(db) {
+        super();
+        this.db = db;
+        logger.debug(`UpdateQ initialized...`);
+        void this.db.info().then((i) => {
+          logger.debug(`db info: ${JSON.stringify(i)}`);
+        });
+      }
+      async applyUpdates(id) {
+        logger.debug(`Applying updates on doc: ${id}`);
+        if (this.inprogressUpdates[id]) {
+          await this.db.info();
+          return this.applyUpdates(id);
+        } else {
+          if (this.pendingUpdates[id] && this.pendingUpdates[id].length > 0) {
+            this.inprogressUpdates[id] = true;
+            try {
+              let doc = await this.db.get(id);
+              logger.debug(`Retrieved doc: ${id}`);
+              while (this.pendingUpdates[id].length !== 0) {
+                const update = this.pendingUpdates[id].splice(0, 1)[0];
+                if (typeof update === "function") {
+                  doc = { ...doc, ...update(doc) };
+                } else {
+                  doc = {
+                    ...doc,
+                    ...update
+                  };
+                }
+              }
+              await this.db.put(doc);
+              logger.debug(`Put doc: ${id}`);
+              if (this.pendingUpdates[id].length === 0) {
+                this.inprogressUpdates[id] = false;
+                delete this.inprogressUpdates[id];
+              } else {
+                return this.applyUpdates(id);
+              }
+              return doc;
+            } catch (e) {
+              delete this.inprogressUpdates[id];
+              if (this.pendingUpdates[id]) {
+                delete this.pendingUpdates[id];
+              }
+              logger.error(`Error on attemped update: ${JSON.stringify(e)}`);
+              throw e;
+            }
+          } else {
+            throw new Error(`Empty Updates Queue Triggered`);
+          }
+        }
+      }
+    };
+  }
+});
+
+// src/impl/couch/clientCache.ts
+async function GET_CACHED(k, f) {
+  if (CLIENT_CACHE[k]) {
+    return CLIENT_CACHE[k];
+  }
+  CLIENT_CACHE[k] = f ? await f(k) : await GET_ITEM(k);
+  return GET_CACHED(k);
+}
+async function GET_ITEM(k) {
+  throw new Error(`No implementation found for GET_CACHED(${k})`);
+}
+var CLIENT_CACHE;
+var init_clientCache = __esm({
+  "src/impl/couch/clientCache.ts"() {
+    "use strict";
+    CLIENT_CACHE = {};
+  }
+});
+
+// src/core/navigators/elo.ts
+var elo_exports = {};
+__export(elo_exports, {
+  default: () => ELONavigator
+});
+var ELONavigator;
+var init_elo = __esm({
+  "src/core/navigators/elo.ts"() {
+    "use strict";
+    init_navigators();
+    ELONavigator = class extends ContentNavigator {
+      user;
+      course;
+      constructor(user, course) {
+        super();
+        this.user = user;
+        this.course = course;
+      }
+      async getPendingReviews() {
+        const reviews = await this.user.getPendingReviews(this.course.getCourseID());
+        const elo = await this.course.getCardEloData(reviews.map((r) => r.cardId));
+        const ratedReviews = reviews.map((r, i) => {
+          const ratedR = {
+            ...r,
+            ...elo[i]
+          };
+          return ratedR;
+        });
+        ratedReviews.sort((a, b) => {
+          return a.global.score - b.global.score;
+        });
+        return ratedReviews.map((r) => {
+          return {
+            ...r,
+            contentSourceType: "course",
+            contentSourceID: this.course.getCourseID(),
+            cardID: r.cardId,
+            courseID: r.courseId,
+            qualifiedID: `${r.courseId}-${r.cardId}`,
+            reviewID: r._id,
+            status: "review"
+          };
+        });
+      }
+      async getNewCards(limit = 99) {
+        const activeCards = await this.user.getActiveCards();
+        return (await this.course.getCardsCenteredAtELO({ limit, elo: "user" }, (c) => {
+          if (activeCards.some((ac) => c.includes(ac))) {
+            return false;
+          } else {
+            return true;
+          }
+        })).map((c) => {
+          return {
+            ...c,
+            status: "new"
+          };
+        });
+      }
+    };
+  }
+});
+
+// import("./**/*") in src/core/navigators/index.ts
+var globImport;
+var init_ = __esm({
+  'import("./**/*") in src/core/navigators/index.ts'() {
+    globImport = __glob({
+      "./elo.ts": () => Promise.resolve().then(() => (init_elo(), elo_exports)),
+      "./index.ts": () => Promise.resolve().then(() => (init_navigators(), navigators_exports))
+    });
+  }
+});
+
+// src/core/navigators/index.ts
+var navigators_exports = {};
+__export(navigators_exports, {
+  ContentNavigator: () => ContentNavigator,
+  Navigators: () => Navigators
+});
+var Navigators, ContentNavigator;
+var init_navigators = __esm({
+  "src/core/navigators/index.ts"() {
+    "use strict";
+    init_logger();
+    init_();
+    Navigators = /* @__PURE__ */ ((Navigators2) => {
+      Navigators2["ELO"] = "elo";
+      return Navigators2;
+    })(Navigators || {});
+    ContentNavigator = class {
+      /**
+       *
+       * @param user
+       * @param strategyData
+       * @returns the runtime object used to steer a study session.
+       */
+      static async create(user, course, strategyData) {
+        const implementingClass = strategyData.implementingClass;
+        let NavigatorImpl;
+        const variations = ["", ".js", ".ts"];
+        for (const ext of variations) {
+          try {
+            const module = await globImport(`./${implementingClass}${ext}`);
+            NavigatorImpl = module.default;
+            break;
+          } catch (e) {
+            logger.debug(`Failed to load with extension ${ext}:`, e);
+          }
+        }
+        if (!NavigatorImpl) {
+          throw new Error(`Could not load navigator implementation for: ${implementingClass}`);
+        }
+        return new NavigatorImpl(user, course, strategyData);
+      }
+    };
+  }
+});
+
+// src/impl/couch/courseDB.ts
+import {
+  EloToNumber,
+  Status,
+  blankCourseElo,
+  toCourseElo
+} from "@vue-skuilder/common";
+function randIntWeightedTowardZero(n) {
+  return Math.floor(Math.random() * Math.random() * Math.random() * n);
+}
+async function getCourseTagStubs(courseID) {
+  logger.debug(`Getting tag stubs for course: ${courseID}`);
+  const stubs = await filterAllDocsByPrefix(
+    getCourseDB(courseID),
+    "TAG" /* TAG */.valueOf() + "-"
+  );
+  stubs.rows.forEach((row) => {
+    logger.debug(`	Tag stub for doc: ${row.id}`);
+  });
+  return stubs;
+}
+async function createTag(courseID, tagName, author) {
+  logger.debug(`Creating tag: ${tagName}...`);
+  const tagID = getTagID(tagName);
+  const courseDB = getCourseDB(courseID);
+  const resp = await courseDB.put({
+    course: courseID,
+    docType: "TAG" /* TAG */,
+    name: tagName,
+    snippet: "",
+    taggedCards: [],
+    wiki: "",
+    author,
+    _id: tagID
+  });
+  return resp;
+}
+async function updateTag(tag) {
+  const prior = await getTag(tag.course, tag.name);
+  return await getCourseDB(tag.course).put({
+    ...tag,
+    _rev: prior._rev
+  });
+}
+async function getTag(courseID, tagName) {
+  const tagID = getTagID(tagName);
+  const courseDB = getCourseDB(courseID);
+  return courseDB.get(tagID);
+}
+async function removeTagFromCard(courseID, cardID, tagID) {
+  tagID = getTagID(tagID);
+  const courseDB = getCourseDB(courseID);
+  const tag = await courseDB.get(tagID);
+  tag.taggedCards = tag.taggedCards.filter((taggedID) => {
+    return cardID !== taggedID;
+  });
+  return courseDB.put(tag);
+}
+async function getAppliedTags(id_course, id_card) {
+  const db = getCourseDB(id_course);
+  const result = await db.query("getTags", {
+    startkey: id_card,
+    endkey: id_card
+    // include_docs: true
+  });
+  return result;
+}
+async function updateCredentialledCourseConfig(courseID, config) {
+  logger.debug(`Updating course config:
+
+${JSON.stringify(config)}
+`);
+  const db = getCourseDB(courseID);
+  const old = await getCredentialledCourseConfig(courseID);
+  return await db.put({
+    ...config,
+    _rev: old._rev
+  });
+}
+function isSuccessRow(row) {
+  return "doc" in row && row.doc !== null && row.doc !== void 0;
+}
+var CourseDB;
+var init_courseDB = __esm({
+  "src/impl/couch/courseDB.ts"() {
+    "use strict";
+    init_couch();
+    init_updateQueue();
+    init_types_legacy();
+    init_logger();
+    init_clientCache();
+    init_courseAPI();
+    init_courseLookupDB();
+    init_navigators();
+    CourseDB = class {
+      // private log(msg: string): void {
+      //   log(`CourseLog: ${this.id}\n  ${msg}`);
+      // }
+      db;
+      id;
+      _getCurrentUser;
+      updateQueue;
+      constructor(id, userLookup) {
+        this.id = id;
+        this.db = getCourseDB(this.id);
+        this._getCurrentUser = userLookup;
+        this.updateQueue = new UpdateQueue(this.db);
+      }
+      getCourseID() {
+        return this.id;
+      }
+      async getCourseInfo() {
+        const cardCount = (await this.db.find({
+          selector: {
+            docType: "CARD" /* CARD */
+          },
+          limit: 1e3
+        })).docs.length;
+        return {
+          cardCount,
+          registeredUsers: 0
+        };
+      }
+      async getInexperiencedCards(limit = 2) {
+        return (await this.db.query("cardsByInexperience", {
+          limit
+        })).rows.map((r) => {
+          const ret = {
+            courseId: this.id,
+            cardId: r.id,
+            count: r.key,
+            elo: r.value
+          };
+          return ret;
+        });
+      }
+      async getCardsByEloLimits(options = {
+        low: 0,
+        high: Number.MIN_SAFE_INTEGER,
+        limit: 25,
+        page: 0
+      }) {
+        return (await this.db.query("elo", {
+          startkey: options.low,
+          endkey: options.high,
+          limit: options.limit,
+          skip: options.limit * options.page
+        })).rows.map((r) => {
+          return `${this.id}-${r.id}-${r.key}`;
+        });
+      }
+      async getCardEloData(id) {
+        const docs = await this.db.allDocs({
+          keys: id,
+          include_docs: true
+        });
+        const ret = [];
+        docs.rows.forEach((r) => {
+          if (isSuccessRow(r)) {
+            if (r.doc && r.doc.elo) {
+              ret.push(toCourseElo(r.doc.elo));
+            } else {
+              logger.warn("no elo data for card: " + r.id);
+              ret.push(blankCourseElo());
+            }
+          } else {
+            logger.warn("no elo data for card: " + JSON.stringify(r));
+            ret.push(blankCourseElo());
+          }
+        });
+        return ret;
+      }
+      /**
+       * Returns the lowest and highest `global` ELO ratings in the course
+       */
+      async getELOBounds() {
+        const [low, high] = await Promise.all([
+          (await this.db.query("elo", {
+            startkey: 0,
+            limit: 1,
+            include_docs: false
+          })).rows[0].key,
+          (await this.db.query("elo", {
+            limit: 1,
+            descending: true,
+            startkey: 1e5
+          })).rows[0].key
+        ]);
+        return {
+          low,
+          high
+        };
+      }
+      async removeCard(id) {
+        const doc = await this.db.get(id);
+        if (!doc.docType || !(doc.docType === "CARD" /* CARD */)) {
+          throw new Error(`failed to remove ${id} from course ${this.id}. id does not point to a card`);
+        }
+        return this.db.remove(doc);
+      }
+      async getCardDisplayableDataIDs(id) {
+        logger.debug(id.join(", "));
+        const cards = await this.db.allDocs({
+          keys: id,
+          include_docs: true
+        });
+        const ret = {};
+        cards.rows.forEach((r) => {
+          if (isSuccessRow(r)) {
+            ret[r.id] = r.doc.id_displayable_data;
+          }
+        });
+        await Promise.all(
+          cards.rows.map((r) => {
+            return async () => {
+              if (isSuccessRow(r)) {
+                ret[r.id] = r.doc.id_displayable_data;
+              }
+            };
+          })
+        );
+        return ret;
+      }
+      async getCardsByELO(elo, cardLimit) {
+        elo = parseInt(elo);
+        const limit = cardLimit ? cardLimit : 25;
+        const below = await this.db.query("elo", {
+          limit: Math.ceil(limit / 2),
+          startkey: elo,
+          descending: true
+        });
+        const aboveLimit = limit - below.rows.length;
+        const above = await this.db.query("elo", {
+          limit: aboveLimit,
+          startkey: elo + 1
+        });
+        let cards = below.rows;
+        cards = cards.concat(above.rows);
+        const ret = cards.sort((a, b) => {
+          const s = Math.abs(a.key - elo) - Math.abs(b.key - elo);
+          if (s === 0) {
+            return Math.random() - 0.5;
+          } else {
+            return s;
+          }
+        }).map((c) => `${this.id}-${c.id}-${c.key}`);
+        const str = `below:
+${below.rows.map((r) => `	${r.id}-${r.key}
+`)}
+
+above:
+${above.rows.map((r) => `	${r.id}-${r.key}
+`)}`;
+        logger.debug(`Getting ${limit} cards centered around elo: ${elo}:
+
+` + str);
+        return ret;
+      }
+      async getCourseConfig() {
+        const ret = await getCredentialledCourseConfig(this.id);
+        if (ret) {
+          return ret;
+        } else {
+          throw new Error(`Course config not found for course ID: ${this.id}`);
+        }
+      }
+      async updateCourseConfig(cfg) {
+        logger.debug(`Updating: ${JSON.stringify(cfg)}`);
+        try {
+          return await updateCredentialledCourseConfig(this.id, cfg);
+        } catch (error) {
+          logger.error(`Error updating course config in course DB: ${error}`);
+          throw error;
+        }
+      }
+      async updateCardElo(cardId, elo) {
+        if (!elo) {
+          throw new Error(`Cannot update card elo with null or undefined value for card ID: ${cardId}`);
+        }
+        try {
+          const result = await this.updateQueue.update(cardId, (card) => {
+            logger.debug(`Replacing ${JSON.stringify(card.elo)} with ${JSON.stringify(elo)}`);
+            card.elo = elo;
+            return card;
+          });
+          return { ok: true, id: cardId, rev: result._rev };
+        } catch (error) {
+          logger.error(`Failed to update card elo for card ID: ${cardId}`, error);
+          throw new Error(`Failed to update card elo for card ID: ${cardId}`);
+        }
+      }
+      async getAppliedTags(cardId) {
+        const ret = await getAppliedTags(this.id, cardId);
+        if (ret) {
+          return ret;
+        } else {
+          throw new Error(`Failed to find tags for card ${this.id}-${cardId}`);
+        }
+      }
+      async addTagToCard(cardId, tagId, updateELO) {
+        return await addTagToCard(this.id, cardId, tagId, (await this._getCurrentUser()).getUsername(), updateELO);
+      }
+      async removeTagFromCard(cardId, tagId) {
+        return await removeTagFromCard(this.id, cardId, tagId);
+      }
+      async createTag(name, author) {
+        return await createTag(this.id, name, author);
+      }
+      async getTag(tagId) {
+        return await getTag(this.id, tagId);
+      }
+      async updateTag(tag) {
+        if (tag.course !== this.id) {
+          throw new Error(`Tag ${JSON.stringify(tag)} does not belong to course ${this.id}`);
+        }
+        return await updateTag(tag);
+      }
+      async getCourseTagStubs() {
+        return getCourseTagStubs(this.id);
+      }
+      async addNote(codeCourse, shape, data, author, tags, uploads, elo = blankCourseElo()) {
+        try {
+          const resp = await addNote55(this.id, codeCourse, shape, data, author, tags, uploads, elo);
+          if (resp.ok) {
+            if (resp.cardCreationFailed) {
+              logger.warn(
+                `[courseDB.addNote] Note added but card creation failed: ${resp.cardCreationError}`
+              );
+              return {
+                status: Status.error,
+                message: `Note was added but no cards were created: ${resp.cardCreationError}`,
+                id: resp.id
+              };
+            }
+            return {
+              status: Status.ok,
+              message: "",
+              id: resp.id
+            };
+          } else {
+            return {
+              status: Status.error,
+              message: "Unexpected error adding note"
+            };
+          }
+        } catch (e) {
+          const err = e;
+          logger.error(
+            `[addNote] error ${err.name}
+	reason: ${err.reason}
+	message: ${err.message}`
+          );
+          return {
+            status: Status.error,
+            message: `Error adding note to course. ${e.reason || err.message}`
+          };
+        }
+      }
+      async getCourseDoc(id, options) {
+        return await getCourseDoc(this.id, id, options);
+      }
+      async getCourseDocs(ids, options = {}) {
+        return await getCourseDocs(this.id, ids, options);
+      }
+      ////////////////////////////////////
+      // NavigationStrategyManager implementation
+      ////////////////////////////////////
+      getNavigationStrategy(id) {
+        logger.debug(`[courseDB] Getting navigation strategy: ${id}`);
+        const strategy = {
+          id: "ELO",
+          docType: "NAVIGATION_STRATEGY" /* NAVIGATION_STRATEGY */,
+          name: "ELO",
+          description: "ELO-based navigation strategy for ordering content by difficulty",
+          implementingClass: "elo" /* ELO */,
+          course: this.id,
+          serializedData: ""
+          // serde is a noop for ELO navigator.
+        };
+        return Promise.resolve(strategy);
+      }
+      getAllNavigationStrategies() {
+        logger.debug("[courseDB] Returning hard-coded navigation strategies");
+        const strategies = [
+          {
+            id: "ELO",
+            docType: "NAVIGATION_STRATEGY" /* NAVIGATION_STRATEGY */,
+            name: "ELO",
+            description: "ELO-based navigation strategy for ordering content by difficulty",
+            implementingClass: "elo" /* ELO */,
+            course: this.id,
+            serializedData: ""
+            // serde is a noop for ELO navigator.
+          }
+        ];
+        return Promise.resolve(strategies);
+      }
+      addNavigationStrategy(data) {
+        logger.debug(`[courseDB] Adding navigation strategy: ${data.id}`);
+        logger.debug(JSON.stringify(data));
+        return Promise.resolve();
+      }
+      updateNavigationStrategy(id, data) {
+        logger.debug(`[courseDB] Updating navigation strategy: ${id}`);
+        logger.debug(JSON.stringify(data));
+        return Promise.resolve();
+      }
+      async surfaceNavigationStrategy() {
+        logger.warn(`Returning hard-coded default ELO navigator`);
+        const ret = {
+          id: "ELO",
+          docType: "NAVIGATION_STRATEGY" /* NAVIGATION_STRATEGY */,
+          name: "ELO",
+          description: "ELO-based navigation strategy",
+          implementingClass: "elo" /* ELO */,
+          course: this.id,
+          serializedData: ""
+          // serde is a noop for ELO navigator.
+        };
+        return Promise.resolve(ret);
+      }
+      ////////////////////////////////////
+      // END NavigationStrategyManager implementation
+      ////////////////////////////////////
+      ////////////////////////////////////
+      // StudyContentSource implementation
+      ////////////////////////////////////
+      async getNewCards(limit = 99) {
+        const u = await this._getCurrentUser();
+        try {
+          const strategy = await this.surfaceNavigationStrategy();
+          const navigator = await ContentNavigator.create(u, this, strategy);
+          return navigator.getNewCards(limit);
+        } catch (e) {
+          logger.error(`[courseDB] Error surfacing a NavigationStrategy: ${e}`);
+          throw e;
+        }
+      }
+      async getPendingReviews() {
+        const u = await this._getCurrentUser();
+        try {
+          const strategy = await this.surfaceNavigationStrategy();
+          const navigator = await ContentNavigator.create(u, this, strategy);
+          return navigator.getPendingReviews();
+        } catch (e) {
+          logger.error(`[courseDB] Error surfacing a NavigationStrategy: ${e}`);
+          throw e;
+        }
+      }
+      async getCardsCenteredAtELO(options = {
+        limit: 99,
+        elo: "user"
+      }, filter) {
+        let targetElo;
+        if (options.elo === "user") {
+          const u = await this._getCurrentUser();
+          targetElo = -1;
+          try {
+            const courseDoc = (await u.getCourseRegistrationsDoc()).courses.find((c) => {
+              return c.courseID === this.id;
+            });
+            targetElo = EloToNumber(courseDoc.elo);
+          } catch {
+            targetElo = 1e3;
+          }
+        } else if (options.elo === "random") {
+          const bounds = await GET_CACHED(`elo-bounds-${this.id}`, () => this.getELOBounds());
+          targetElo = Math.round(bounds.low + Math.random() * (bounds.high - bounds.low));
+        } else {
+          targetElo = options.elo;
+        }
+        let cards = [];
+        let mult = 4;
+        let previousCount = -1;
+        let newCount = 0;
+        while (cards.length < options.limit && newCount !== previousCount) {
+          cards = await this.getCardsByELO(targetElo, mult * options.limit);
+          previousCount = newCount;
+          newCount = cards.length;
+          logger.debug(`Found ${cards.length} elo neighbor cards...`);
+          if (filter) {
+            cards = cards.filter(filter);
+            logger.debug(`Filtered to ${cards.length} cards...`);
+          }
+          mult *= 2;
+        }
+        const selectedCards = [];
+        while (selectedCards.length < options.limit && cards.length > 0) {
+          const index = randIntWeightedTowardZero(cards.length);
+          const card = cards.splice(index, 1)[0];
+          selectedCards.push(card);
+        }
+        return selectedCards.map((c) => {
+          const split = c.split("-");
+          return {
+            courseID: this.id,
+            cardID: split[1],
+            qualifiedID: `${split[0]}-${split[1]}`,
+            contentSourceType: "course",
+            contentSourceID: this.id,
+            status: "new"
+          };
+        });
+      }
+    };
+  }
+});
+
+// src/impl/common/SyncStrategy.ts
+var init_SyncStrategy = __esm({
+  "src/impl/common/SyncStrategy.ts"() {
+    "use strict";
+  }
+});
+
+// src/core/util/index.ts
+function getCardHistoryID(courseID, cardID) {
+  return `${cardHistoryPrefix}-${courseID}-${cardID}`;
+}
+var init_util = __esm({
+  "src/core/util/index.ts"() {
+    "use strict";
+    init_types_legacy();
+  }
+});
+
+// src/impl/common/userDBHelpers.ts
+import moment from "moment";
+function filterAllDocsByPrefix2(db, prefix, opts) {
+  const options = {
+    startkey: prefix,
+    endkey: prefix + "\uFFF0",
+    include_docs: true
+  };
+  if (opts) {
+    Object.assign(options, opts);
+  }
+  return db.allDocs(options);
+}
+function getStartAndEndKeys2(key) {
+  return {
+    startkey: key,
+    endkey: key + "\uFFF0"
+  };
+}
+function getLocalUserDB(username) {
+  return new pouchdb_setup_default(`userdb-${username}`, {});
+}
+function scheduleCardReviewLocal(userDB, review) {
+  const now = moment.utc();
+  logger.info(`Scheduling for review in: ${review.time.diff(now, "h") / 24} days`);
+  void userDB.put({
+    _id: REVIEW_PREFIX + review.time.format(REVIEW_TIME_FORMAT),
+    cardId: review.card_id,
+    reviewTime: review.time,
+    courseId: review.course_id,
+    scheduledAt: now,
+    scheduledFor: review.scheduledFor,
+    schedulingAgentId: review.schedulingAgentId
+  });
+}
+async function removeScheduledCardReviewLocal(userDB, reviewDocID) {
+  const reviewDoc = await userDB.get(reviewDocID);
+  userDB.remove(reviewDoc).then((res) => {
+    if (res.ok) {
+      log(`Removed Review Doc: ${reviewDocID}`);
+    }
+  }).catch((err) => {
+    log(`Failed to remove Review Doc: ${reviewDocID},
+${JSON.stringify(err)}`);
+  });
+}
+var REVIEW_PREFIX, REVIEW_TIME_FORMAT, log;
+var init_userDBHelpers = __esm({
+  "src/impl/common/userDBHelpers.ts"() {
+    "use strict";
+    init_logger();
+    init_pouchdb_setup();
+    REVIEW_PREFIX = "card_review_";
+    REVIEW_TIME_FORMAT = "YYYY-MM-DD--kk:mm:ss-SSS";
+    log = (s) => {
+      logger.info(s);
+    };
+  }
+});
+
+// src/impl/couch/user-course-relDB.ts
+import moment2 from "moment";
+var UsrCrsData;
+var init_user_course_relDB = __esm({
+  "src/impl/couch/user-course-relDB.ts"() {
+    "use strict";
+    init_couch();
+    init_courseDB();
+    init_logger();
+    UsrCrsData = class {
+      user;
+      course;
+      _courseId;
+      constructor(user, courseId) {
+        this.user = user;
+        this.course = new CourseDB(courseId, async () => this.user);
+        this._courseId = courseId;
+      }
+      async getReviewsForcast(daysCount) {
+        const time = moment2.utc().add(daysCount, "days");
+        return this.getReviewstoDate(time);
+      }
+      async getPendingReviews() {
+        const now = moment2.utc();
+        return this.getReviewstoDate(now);
+      }
+      async getScheduledReviewCount() {
+        return (await this.getPendingReviews()).length;
+      }
+      async getCourseSettings() {
+        const regDoc = await this.user.getCourseRegistrationsDoc();
+        const crsDoc = regDoc.courses.find((c) => c.courseID === this._courseId);
+        if (crsDoc && crsDoc.settings) {
+          return crsDoc.settings;
+        } else {
+          logger.warn(`no settings found during lookup on course ${this._courseId}`);
+          return {};
+        }
+      }
+      updateCourseSettings(updates) {
+        void this.user.updateCourseSettings(this._courseId, updates);
+      }
+      async getReviewstoDate(targetDate) {
+        const keys = getStartAndEndKeys(REVIEW_PREFIX2);
+        const reviews = await this.user.remote().allDocs({
+          startkey: keys.startkey,
+          endkey: keys.endkey,
+          include_docs: true
+        });
+        logger.debug(
+          `Fetching ${this.user.getUsername()}'s scheduled reviews for course ${this._courseId}.`
+        );
+        return reviews.rows.filter((r) => {
+          if (r.id.startsWith(REVIEW_PREFIX2)) {
+            const date = moment2.utc(r.id.substr(REVIEW_PREFIX2.length), REVIEW_TIME_FORMAT2);
+            if (targetDate.isAfter(date)) {
+              if (this._courseId === void 0 || r.doc.courseId === this._courseId) {
+                return true;
+              }
+            }
+          }
+        }).map((r) => r.doc);
+      }
+    };
+  }
+});
+
+// src/impl/common/BaseUserDB.ts
+import { Status as Status2 } from "@vue-skuilder/common";
+import moment3 from "moment";
+async function getOrCreateClassroomRegistrationsDoc(user) {
+  let ret;
+  try {
+    ret = await getLocalUserDB(user).get(userClassroomsDoc);
+  } catch (e) {
+    const err = e;
+    if (err.status === 404) {
+      await getLocalUserDB(user).put({
+        _id: userClassroomsDoc,
+        registrations: []
+      });
+      ret = await getOrCreateClassroomRegistrationsDoc(user);
+    } else {
+      const errorDetails = {
+        name: err.name,
+        status: err.status,
+        message: err.message,
+        reason: err.reason,
+        error: err.error
+      };
+      logger.error(
+        "Database error in getOrCreateClassroomRegistrationsDoc (standalone function):",
+        errorDetails
+      );
+      throw new Error(
+        `Database error accessing classroom registrations: ${err.message || err.name || "Unknown error"} (status: ${err.status})`
+      );
+    }
+  }
+  return ret;
+}
+async function getOrCreateCourseRegistrationsDoc(user) {
+  let ret;
+  try {
+    ret = await getLocalUserDB(user).get(userCoursesDoc);
+  } catch (e) {
+    const err = e;
+    if (err.status === 404) {
+      await getLocalUserDB(user).put({
+        _id: userCoursesDoc,
+        courses: [],
+        studyWeight: {}
+      });
+      ret = await getOrCreateCourseRegistrationsDoc(user);
+    } else {
+      throw new Error(
+        `Unexpected error ${JSON.stringify(e)} in getOrCreateCourseRegistrationDoc...`
+      );
+    }
+  }
+  return ret;
+}
+async function updateUserElo(user, course_id, elo) {
+  const regDoc = await getOrCreateCourseRegistrationsDoc(user);
+  const course = regDoc.courses.find((c) => c.courseID === course_id);
+  course.elo = elo;
+  return getLocalUserDB(user).put(regDoc);
+}
+async function registerUserForClassroom(user, classID, registerAs) {
+  log2(`Registering user: ${user} in course: ${classID}`);
+  return getOrCreateClassroomRegistrationsDoc(user).then((doc) => {
+    const regItem = {
+      classID,
+      registeredAs: registerAs
+    };
+    if (doc.registrations.filter((reg) => {
+      return reg.classID === regItem.classID && reg.registeredAs === regItem.registeredAs;
+    }).length === 0) {
+      doc.registrations.push(regItem);
+    } else {
+      log2(`User ${user} is already registered for class ${classID}`);
+    }
+    return getLocalUserDB(user).put(doc);
+  });
+}
+async function dropUserFromClassroom(user, classID) {
+  return getOrCreateClassroomRegistrationsDoc(user).then((doc) => {
+    let index = -1;
+    for (let i = 0; i < doc.registrations.length; i++) {
+      if (doc.registrations[i].classID === classID) {
+        index = i;
+      }
+    }
+    if (index !== -1) {
+      doc.registrations.splice(index, 1);
+    }
+    return getLocalUserDB(user).put(doc);
+  });
+}
+async function getUserClassrooms(user) {
+  return getOrCreateClassroomRegistrationsDoc(user);
+}
+var log2, cardHistoryPrefix2, BaseUser, userCoursesDoc, userClassroomsDoc;
+var init_BaseUserDB = __esm({
+  "src/impl/common/BaseUserDB.ts"() {
+    "use strict";
+    init_util();
+    init_types_legacy();
+    init_logger();
+    init_userDBHelpers();
+    init_updateQueue();
+    init_user_course_relDB();
+    init_couch();
+    log2 = (s) => {
+      logger.info(s);
+    };
+    cardHistoryPrefix2 = "cardH-";
+    BaseUser = class _BaseUser {
+      static _instance;
+      static _initialized = false;
+      static Dummy(syncStrategy) {
+        return new _BaseUser("Me", syncStrategy);
+      }
+      static DOC_IDS = {
+        CONFIG: "CONFIG",
+        COURSE_REGISTRATIONS: "CourseRegistrations",
+        CLASSROOM_REGISTRATIONS: "ClassroomRegistrations"
+      };
+      // private email: string;
+      _username;
+      syncStrategy;
+      getUsername() {
+        return this._username;
+      }
+      isLoggedIn() {
+        return !this._username.startsWith(GuestUsername);
+      }
+      remoteDB;
+      remote() {
+        return this.remoteDB;
+      }
+      localDB;
+      updateQueue;
+      async createAccount(username, password) {
+        if (!this.syncStrategy.canCreateAccount()) {
+          throw new Error("Account creation not supported by current sync strategy");
+        }
+        if (!this._username.startsWith(GuestUsername)) {
+          throw new Error(
+            `Cannot create a new account while logged in:
+Currently logged-in as ${this._username}.`
+          );
+        }
+        const result = await this.syncStrategy.createAccount(username, password);
+        if (result.status === Status2.ok) {
+          log2(`Account created successfully, updating username to ${username}`);
+          this._username = username;
+          localStorage.removeItem("dbUUID");
+          await this.init();
+        }
+        return {
+          status: result.status,
+          error: result.error || ""
+        };
+      }
+      async login(username, password) {
+        if (!this.syncStrategy.canAuthenticate()) {
+          throw new Error("Authentication not supported by current sync strategy");
+        }
+        if (!this._username.startsWith(GuestUsername)) {
+          throw new Error(`Cannot change accounts while logged in.
+      Log out of account ${this.getUsername()} before logging in as ${username}.`);
+        }
+        const loginResult = await this.syncStrategy.authenticate(username, password);
+        if (loginResult.ok) {
+          log2(`Logged in as ${username}`);
+          this._username = username;
+          localStorage.removeItem("dbUUID");
+          await this.init();
+        }
+        return loginResult;
+      }
+      async resetUserData() {
+        if (this.syncStrategy.canAuthenticate()) {
+          return {
+            status: Status2.error,
+            error: "Reset user data is only available for local-only mode. Use logout instead for remote sync."
+          };
+        }
+        try {
+          const localDB = getLocalUserDB(this._username);
+          const allDocs = await localDB.allDocs({ include_docs: false });
+          const docsToDelete = allDocs.rows.filter((row) => {
+            const id = row.id;
+            return id.startsWith(cardHistoryPrefix2) || // Card interaction history
+            id.startsWith(REVIEW_PREFIX) || // Scheduled reviews
+            id === _BaseUser.DOC_IDS.COURSE_REGISTRATIONS || // Course registrations
+            id === _BaseUser.DOC_IDS.CLASSROOM_REGISTRATIONS || // Classroom registrations
+            id === _BaseUser.DOC_IDS.CONFIG;
+          }).map((row) => ({ _id: row.id, _rev: row.value.rev, _deleted: true }));
+          if (docsToDelete.length > 0) {
+            await localDB.bulkDocs(docsToDelete);
+          }
+          await this.init();
+          return { status: Status2.ok };
+        } catch (error) {
+          logger.error("Failed to reset user data:", error);
+          return {
+            status: Status2.error,
+            error: error instanceof Error ? error.message : "Unknown error during reset"
+          };
+        }
+      }
+      async logout() {
+        if (!this.syncStrategy.canAuthenticate()) {
+          this._username = await this.syncStrategy.getCurrentUsername();
+          await this.init();
+          return { ok: true };
+        }
+        const ret = await this.syncStrategy.logout();
+        this._username = await this.syncStrategy.getCurrentUsername();
+        await this.init();
+        return ret;
+      }
+      update(id, update) {
+        return this.updateQueue.update(id, update);
+      }
+      async getCourseRegistrationsDoc() {
+        logger.debug(`Fetching courseRegistrations for ${this.getUsername()}`);
+        let ret;
+        try {
+          const regDoc = await this.localDB.get(
+            _BaseUser.DOC_IDS.COURSE_REGISTRATIONS
+          );
+          return regDoc;
+        } catch (e) {
+          const err = e;
+          if (err.status === 404) {
+            await this.localDB.put({
+              _id: _BaseUser.DOC_IDS.COURSE_REGISTRATIONS,
+              courses: [],
+              studyWeight: {}
+            });
+            ret = await this.getCourseRegistrationsDoc();
+          } else {
+            throw new Error(
+              `Unexpected error ${JSON.stringify(e)} in getOrCreateCourseRegistrationDoc...`
+            );
+          }
+        }
+        return ret;
+      }
+      async getActiveCourses() {
+        const reg = await this.getCourseRegistrationsDoc();
+        return reg.courses.filter((c) => {
+          return c.status === void 0 || c.status === "active";
+        });
+      }
+      /**
+       * Returns a promise of the card IDs that the user has
+       * a scheduled review for.
+       *
+       */
+      async getActiveCards() {
+        const keys = getStartAndEndKeys2(REVIEW_PREFIX);
+        const reviews = await this.remoteDB.allDocs({
+          startkey: keys.startkey,
+          endkey: keys.endkey,
+          include_docs: true
+        });
+        return reviews.rows.map((r) => `${r.doc.courseId}-${r.doc.cardId}`);
+      }
+      async getActivityRecords() {
+        try {
+          const hist = await this.getHistory();
+          const allRecords = [];
+          if (!Array.isArray(hist)) {
+            logger.error("getHistory did not return an array:", hist);
+            return allRecords;
+          }
+          let sampleCount = 0;
+          for (let i = 0; i < hist.length; i++) {
+            try {
+              if (hist[i] && Array.isArray(hist[i].records)) {
+                hist[i].records.forEach((record) => {
+                  try {
+                    if (!record.timeStamp) {
+                      return;
+                    }
+                    let timeStamp;
+                    if (typeof record.timeStamp === "object") {
+                      if (typeof record.timeStamp.toDate === "function") {
+                        timeStamp = record.timeStamp.toISOString();
+                      } else if (record.timeStamp instanceof Date) {
+                        timeStamp = record.timeStamp.toISOString();
+                      } else {
+                        if (sampleCount < 3) {
+                          logger.warn("Unknown timestamp object type:", record.timeStamp);
+                          sampleCount++;
+                        }
+                        return;
+                      }
+                    } else if (typeof record.timeStamp === "string") {
+                      const date = new Date(record.timeStamp);
+                      if (isNaN(date.getTime())) {
+                        return;
+                      }
+                      timeStamp = record.timeStamp;
+                    } else if (typeof record.timeStamp === "number") {
+                      timeStamp = new Date(record.timeStamp).toISOString();
+                    } else {
+                      return;
+                    }
+                    allRecords.push({
+                      timeStamp,
+                      courseID: record.courseID || "unknown",
+                      cardID: record.cardID || "unknown",
+                      timeSpent: record.timeSpent || 0,
+                      type: "card_view"
+                    });
+                  } catch (err) {
+                  }
+                });
+              }
+            } catch (err) {
+              logger.error("Error processing history item:", err);
+            }
+          }
+          logger.debug(`Found ${allRecords.length} activity records`);
+          return allRecords;
+        } catch (err) {
+          logger.error("Error in getActivityRecords:", err);
+          return [];
+        }
+      }
+      async getReviewstoDate(targetDate, course_id) {
+        const keys = getStartAndEndKeys2(REVIEW_PREFIX);
+        const reviews = await this.remoteDB.allDocs({
+          startkey: keys.startkey,
+          endkey: keys.endkey,
+          include_docs: true
+        });
+        log2(
+          `Fetching ${this._username}'s scheduled reviews${course_id ? ` for course ${course_id}` : ""}.`
+        );
+        return reviews.rows.filter((r) => {
+          if (r.id.startsWith(REVIEW_PREFIX)) {
+            const date = moment3.utc(r.id.substr(REVIEW_PREFIX.length), REVIEW_TIME_FORMAT);
+            if (targetDate.isAfter(date)) {
+              if (course_id === void 0 || r.doc.courseId === course_id) {
+                return true;
+              }
+            }
+          }
+        }).map((r) => r.doc);
+      }
+      async getReviewsForcast(daysCount) {
+        const time = moment3.utc().add(daysCount, "days");
+        return this.getReviewstoDate(time);
+      }
+      async getPendingReviews(course_id) {
+        const now = moment3.utc();
+        return this.getReviewstoDate(now, course_id);
+      }
+      async getScheduledReviewCount(course_id) {
+        return (await this.getPendingReviews(course_id)).length;
+      }
+      async getRegisteredCourses() {
+        const regDoc = await this.getCourseRegistrationsDoc();
+        return regDoc.courses.filter((c) => {
+          return !c.status || c.status === "active" || c.status === "maintenance-mode";
+        });
+      }
+      async getCourseRegDoc(courseID) {
+        const regDocs = await this.getCourseRegistrationsDoc();
+        const ret = regDocs.courses.find((c) => c.courseID === courseID);
+        if (ret) {
+          return ret;
+        } else {
+          throw new Error(`Course registration not found for course ID: ${courseID}`);
+        }
+      }
+      async registerForCourse(course_id, previewMode = false) {
+        return this.getCourseRegistrationsDoc().then((doc) => {
+          const status = previewMode ? "preview" : "active";
+          logger.debug(`Registering for ${course_id} with status: ${status}`);
+          const regItem = {
+            status,
+            courseID: course_id,
+            user: true,
+            admin: false,
+            moderator: false,
+            elo: {
+              global: {
+                score: 1e3,
+                count: 0
+              },
+              tags: {},
+              misc: {}
+            }
+          };
+          if (doc.courses.filter((course) => {
+            return course.courseID === regItem.courseID;
+          }).length === 0) {
+            log2(`It's a new course registration!`);
+            doc.courses.push(regItem);
+            doc.studyWeight[course_id] = 1;
+          } else {
+            doc.courses.forEach((c) => {
+              log2(`Found the previously registered course!`);
+              if (c.courseID === course_id) {
+                c.status = status;
+              }
+            });
+          }
+          return this.localDB.put(doc);
+        }).catch((e) => {
+          log2(`Registration failed because of: ${JSON.stringify(e)}`);
+          throw e;
+        });
+      }
+      async dropCourse(course_id, dropStatus = "dropped") {
+        return this.getCourseRegistrationsDoc().then((doc) => {
+          let index = -1;
+          for (let i = 0; i < doc.courses.length; i++) {
+            if (doc.courses[i].courseID === course_id) {
+              index = i;
+            }
+          }
+          if (index !== -1) {
+            delete doc.studyWeight[course_id];
+            doc.courses[index].status = dropStatus;
+          } else {
+            throw new Error(
+              `User ${this.getUsername()} is not currently registered for course ${course_id}`
+            );
+          }
+          return this.localDB.put(doc);
+        });
+      }
+      async getCourseInterface(courseId) {
+        return new UsrCrsData(this, courseId);
+      }
+      async getUserEditableCourses() {
+        let courseIDs = [];
+        const registeredCourses = await this.getCourseRegistrationsDoc();
+        courseIDs = courseIDs.concat(
+          registeredCourses.courses.map((course) => {
+            return course.courseID;
+          })
+        );
+        const cfgs = await Promise.all(
+          courseIDs.map(async (id) => {
+            return await getCredentialledCourseConfig(id);
+          })
+        );
+        return cfgs;
+      }
+      async getConfig() {
+        const defaultConfig = {
+          _id: _BaseUser.DOC_IDS.CONFIG,
+          darkMode: false,
+          likesConfetti: false
+        };
+        try {
+          const cfg = await this.localDB.get(_BaseUser.DOC_IDS.CONFIG);
+          logger.debug("Raw config from DB:", cfg);
+          return cfg;
+        } catch (e) {
+          const err = e;
+          if (err.name && err.name === "not_found") {
+            await this.localDB.put(defaultConfig);
+            return this.getConfig();
+          } else {
+            logger.error(`Error setting user default config:`, e);
+            throw new Error(`Error returning the user's configuration: ${JSON.stringify(e)}`);
+          }
+        }
+      }
+      async setConfig(items) {
+        logger.debug(`Setting Config items ${JSON.stringify(items)}`);
+        const c = await this.getConfig();
+        const put = await this.localDB.put({
+          ...c,
+          ...items
+        });
+        if (put.ok) {
+          logger.debug(`Config items set: ${JSON.stringify(items)}`);
+        } else {
+          logger.error(`Error setting config items: ${JSON.stringify(put)}`);
+        }
+      }
+      /**
+       *
+       * This function should be called *only* by the pouchdb datalayer provider
+       * auth store.
+       *
+       *
+       * Anyone else seeking the current user should use the auth store's
+       * exported `getCurrentUser` method.
+       *
+       */
+      static async instance(syncStrategy, username) {
+        if (username) {
+          _BaseUser._instance = new _BaseUser(username, syncStrategy);
+          await _BaseUser._instance.init();
+          return _BaseUser._instance;
+        } else if (_BaseUser._instance && _BaseUser._initialized) {
+          return _BaseUser._instance;
+        } else if (_BaseUser._instance) {
+          return new Promise((resolve) => {
+            (function waitForUser() {
+              if (_BaseUser._initialized) {
+                return resolve(_BaseUser._instance);
+              } else {
+                setTimeout(waitForUser, 50);
+              }
+            })();
+          });
+        } else {
+          const guestUsername = await syncStrategy.getCurrentUsername();
+          _BaseUser._instance = new _BaseUser(guestUsername, syncStrategy);
+          await _BaseUser._instance.init();
+          return _BaseUser._instance;
+        }
+      }
+      constructor(username, syncStrategy) {
+        _BaseUser._initialized = false;
+        this._username = username;
+        this.syncStrategy = syncStrategy;
+        this.setDBandQ();
+      }
+      setDBandQ() {
+        this.localDB = getLocalUserDB(this._username);
+        this.remoteDB = this.syncStrategy.setupRemoteDB(this._username);
+        this.updateQueue = new UpdateQueue(this.localDB);
+      }
+      async init() {
+        _BaseUser._initialized = false;
+        this.setDBandQ();
+        this.syncStrategy.startSync(this.localDB, this.remoteDB);
+        void this.applyDesignDocs();
+        void this.deduplicateReviews();
+        _BaseUser._initialized = true;
+      }
+      static designDocs = [
+        {
+          _id: "_design/reviewCards",
+          views: {
+            reviewCards: {
+              map: `function (doc) {
+            if (doc._id && doc._id.indexOf('card_review') === 0 && doc.courseId && doc.cardId) {
+              emit(doc._id, doc.courseId + '-' + doc.cardId);
+            }
+          }`
+            }
+          }
+        }
+      ];
+      async applyDesignDocs() {
+        for (const doc of _BaseUser.designDocs) {
+          try {
+            try {
+              const existingDoc = await this.remoteDB.get(doc._id);
+              await this.remoteDB.put({
+                ...doc,
+                _rev: existingDoc._rev
+              });
+            } catch (e) {
+              if (e instanceof Error && e.name === "not_found") {
+                await this.remoteDB.put(doc);
+              } else {
+                throw e;
+              }
+            }
+          } catch (error) {
+            if (error instanceof Error && error.name === "conflict") {
+              logger.warn(`Design doc ${doc._id} update conflict - will retry`);
+              await new Promise((resolve) => setTimeout(resolve, 1e3));
+              await this.applyDesignDoc(doc);
+            } else {
+              logger.error(`Failed to apply design doc ${doc._id}:`, error);
+              throw error;
+            }
+          }
+        }
+      }
+      // Helper method for single doc update with retry
+      async applyDesignDoc(doc, retries = 3) {
+        try {
+          const existingDoc = await this.remoteDB.get(doc._id);
+          await this.remoteDB.put({
+            ...doc,
+            _rev: existingDoc._rev
+          });
+        } catch (e) {
+          if (e instanceof Error && e.name === "conflict" && retries > 0) {
+            await new Promise((resolve) => setTimeout(resolve, 1e3));
+            return this.applyDesignDoc(doc, retries - 1);
+          }
+          throw e;
+        }
+      }
+      /**
+       * Logs a record of the user's interaction with the card and returns the card's
+       * up-to-date history
+       *
+       * // [ ] #db-refactor extract to a smaller scope - eg, UserStudySession
+       *
+       * @param record the recent recorded interaction between user and card
+       * @returns The updated state of the card's CardHistory data
+       */
+      async putCardRecord(record) {
+        const cardHistoryID = getCardHistoryID(record.courseID, record.cardID);
+        record.timeStamp = moment3.utc(record.timeStamp).toString();
+        try {
+          const cardHistory = await this.update(
+            cardHistoryID,
+            function(h) {
+              h.records.push(record);
+              h.bestInterval = h.bestInterval || 0;
+              h.lapses = h.lapses || 0;
+              h.streak = h.streak || 0;
+              return h;
+            }
+          );
+          cardHistory.records = cardHistory.records.map((record2) => {
+            const ret = {
+              ...record2
+            };
+            ret.timeStamp = moment3.utc(record2.timeStamp);
+            return ret;
+          });
+          return cardHistory;
+        } catch (e) {
+          const reason = e;
+          if (reason.status === 404) {
+            const initCardHistory = {
+              _id: cardHistoryID,
+              cardID: record.cardID,
+              courseID: record.courseID,
+              records: [record],
+              lapses: 0,
+              streak: 0,
+              bestInterval: 0
+            };
+            void this.remoteDB.put(initCardHistory);
+            return initCardHistory;
+          } else {
+            throw new Error(`putCardRecord failed because of:
+  name:${reason.name}
+  error: ${reason.error}
+  message: ${reason.message}`);
+          }
+        }
+      }
+      async deduplicateReviews() {
+        try {
+          log2("Starting deduplication of scheduled reviews...");
+          const reviewsMap = {};
+          const duplicateDocIds = [];
+          const scheduledReviews = await this.remoteDB.query("reviewCards/reviewCards");
+          log2(`Found ${scheduledReviews.rows.length} scheduled reviews to process`);
+          scheduledReviews.rows.forEach((r) => {
+            const qualifiedCardId = r.value;
+            const docId = r.key;
+            if (reviewsMap[qualifiedCardId]) {
+              log2(`Found duplicate scheduled review for card: ${qualifiedCardId}`);
+              log2(
+                `Marking earlier review ${reviewsMap[qualifiedCardId]} for deletion, keeping ${docId}`
+              );
+              duplicateDocIds.push(reviewsMap[qualifiedCardId]);
+              reviewsMap[qualifiedCardId] = docId;
+            } else {
+              reviewsMap[qualifiedCardId] = docId;
+            }
+          });
+          if (duplicateDocIds.length > 0) {
+            log2(`Removing ${duplicateDocIds.length} duplicate reviews...`);
+            const deletePromises = duplicateDocIds.map(async (docId) => {
+              try {
+                const doc = await this.remoteDB.get(docId);
+                await this.remoteDB.remove(doc);
+                log2(`Successfully removed duplicate review: ${docId}`);
+              } catch (error) {
+                log2(`Failed to remove duplicate review ${docId}: ${error}`);
+              }
+            });
+            await Promise.all(deletePromises);
+            log2(`Deduplication complete. Processed ${duplicateDocIds.length} duplicates`);
+          } else {
+            log2("No duplicate reviews found");
+          }
+        } catch (error) {
+          log2(`Error during review deduplication: ${error}`);
+        }
+      }
+      /**
+       * Returns a promise of the card IDs that the user has
+       * encountered in the past.
+       *
+       * @param course_id optional specification of individual course
+       */
+      async getSeenCards(course_id) {
+        let prefix = cardHistoryPrefix2;
+        if (course_id) {
+          prefix += course_id;
+        }
+        const docs = await filterAllDocsByPrefix2(this.localDB, prefix, {
+          include_docs: false
+        });
+        const ret = [];
+        docs.rows.forEach((row) => {
+          if (row.id.startsWith(cardHistoryPrefix2)) {
+            ret.push(row.id.substr(cardHistoryPrefix2.length));
+          }
+        });
+        return ret;
+      }
+      /**
+       *
+       * @returns A promise of the cards that the user has seen in the past.
+       */
+      async getHistory() {
+        const cards = await filterAllDocsByPrefix2(
+          this.remoteDB,
+          cardHistoryPrefix2,
+          {
+            include_docs: true,
+            attachments: false
+          }
+        );
+        return cards.rows.map((r) => r.doc);
+      }
+      async updateCourseSettings(course_id, settings) {
+        void this.getCourseRegistrationsDoc().then((doc) => {
+          const crs = doc.courses.find((c) => c.courseID === course_id);
+          if (crs) {
+            if (crs.settings === null || crs.settings === void 0) {
+              crs.settings = {};
+            }
+            settings.forEach((setting) => {
+              crs.settings[setting.key] = setting.value;
+            });
+          }
+          return this.localDB.put(doc);
+        });
+      }
+      async getCourseSettings(course_id) {
+        const regDoc = await this.getCourseRegistrationsDoc();
+        const crsDoc = regDoc.courses.find((c) => c.courseID === course_id);
+        if (crsDoc) {
+          return crsDoc.settings;
+        } else {
+          throw new Error(`getCourseSettings Failed:
+      User is not registered for course ${course_id}`);
+        }
+      }
+      async getOrCreateClassroomRegistrationsDoc() {
+        let ret;
+        try {
+          ret = await this.remoteDB.get(
+            _BaseUser.DOC_IDS.CLASSROOM_REGISTRATIONS
+          );
+        } catch (e) {
+          const err = e;
+          if (err.status === 404) {
+            await this.remoteDB.put({
+              _id: _BaseUser.DOC_IDS.CLASSROOM_REGISTRATIONS,
+              registrations: []
+            });
+            ret = await this.getOrCreateClassroomRegistrationsDoc();
+          } else {
+            const errorDetails = {
+              name: err.name,
+              status: err.status,
+              message: err.message,
+              reason: err.reason,
+              error: err.error
+            };
+            logger.error(
+              "Database error in getOrCreateClassroomRegistrationsDoc (private method):",
+              errorDetails
+            );
+            throw new Error(
+              `Database error accessing classroom registrations: ${err.message || err.name || "Unknown error"} (status: ${err.status})`
+            );
+          }
+        }
+        logger.debug(`Returning classroom registrations doc: ${JSON.stringify(ret)}`);
+        return ret;
+      }
+      /**
+       * Retrieves the list of active classroom IDs where the user is registered as a student.
+       *
+       * @returns Promise<string[]> - Array of classroom IDs, or empty array if classroom
+       *                              registration document is unavailable due to database errors
+       *
+       * @description This method gracefully handles database connectivity issues by returning
+       *              an empty array when the classroom registrations document cannot be accessed.
+       *              This ensures that users can still access other application features even
+       *              when classroom functionality is temporarily unavailable.
+       */
+      async getActiveClasses() {
+        try {
+          return (await this.getOrCreateClassroomRegistrationsDoc()).registrations.filter((c) => c.registeredAs === "student").map((c) => c.classID);
+        } catch (error) {
+          logger.warn(
+            "Failed to load classroom registrations, continuing without classroom data:",
+            error
+          );
+          return [];
+        }
+      }
+      async scheduleCardReview(review) {
+        return scheduleCardReviewLocal(this.remoteDB, review);
+      }
+      async removeScheduledCardReview(reviewId) {
+        return removeScheduledCardReviewLocal(this.remoteDB, reviewId);
+      }
+      async registerForClassroom(_classId, _registerAs) {
+        return registerUserForClassroom(this._username, _classId, _registerAs);
+      }
+      async dropFromClassroom(classId) {
+        return dropUserFromClassroom(this._username, classId);
+      }
+      async getUserClassrooms() {
+        return getUserClassrooms(this._username);
+      }
+      async updateUserElo(courseId, elo) {
+        return updateUserElo(this._username, courseId, elo);
+      }
+    };
+    userCoursesDoc = "CourseRegistrations";
+    userClassroomsDoc = "ClassroomRegistrations";
+  }
+});
+
+// src/impl/common/index.ts
+var init_common = __esm({
+  "src/impl/common/index.ts"() {
+    "use strict";
+    init_SyncStrategy();
+    init_BaseUserDB();
+    init_userDBHelpers();
+  }
+});
+
+// src/impl/couch/courseAPI.ts
+import { NameSpacer } from "@vue-skuilder/common";
+import { blankCourseElo as blankCourseElo2, toCourseElo as toCourseElo2 } from "@vue-skuilder/common";
+import { prepareNote55 } from "@vue-skuilder/common";
+async function addNote55(courseID, codeCourse, shape, data, author, tags, uploads, elo = blankCourseElo2()) {
+  const db = getCourseDB2(courseID);
+  const payload = prepareNote55(courseID, codeCourse, shape, data, author, tags, uploads);
+  const result = await db.post(payload);
+  const dataShapeId = NameSpacer.getDataShapeString({
+    course: codeCourse,
+    dataShape: shape.name
+  });
+  if (result.ok) {
+    try {
+      await createCards(courseID, dataShapeId, result.id, tags, elo, author);
+    } catch (error) {
+      let errorMessage = "Unknown error";
+      if (error instanceof Error) {
+        errorMessage = error.message;
+      } else if (error && typeof error === "object" && "reason" in error) {
+        errorMessage = error.reason;
+      } else if (error && typeof error === "object" && "message" in error) {
+        errorMessage = error.message;
+      } else {
+        errorMessage = String(error);
+      }
+      logger.error(`[addNote55] Failed to create cards for note ${result.id}: ${errorMessage}`);
+      result.cardCreationFailed = true;
+      result.cardCreationError = errorMessage;
+    }
+  } else {
+    logger.error(`[addNote55] Error adding note. Result: ${JSON.stringify(result)}`);
+  }
+  return result;
+}
+async function createCards(courseID, datashapeID, noteID, tags, elo = blankCourseElo2(), author) {
+  const cfg = await getCredentialledCourseConfig(courseID);
+  const dsDescriptor = NameSpacer.getDataShapeDescriptor(datashapeID);
+  let questionViewTypes = [];
+  for (const ds of cfg.dataShapes) {
+    if (ds.name === datashapeID) {
+      questionViewTypes = ds.questionTypes;
+    }
+  }
+  if (questionViewTypes.length === 0) {
+    const errorMsg = `No questionViewTypes found for datashapeID: ${datashapeID} in course config. Cards cannot be created.`;
+    logger.error(errorMsg);
+    throw new Error(errorMsg);
+  }
+  for (const questionView of questionViewTypes) {
+    await createCard(questionView, courseID, dsDescriptor, noteID, tags, elo, author);
+  }
+}
+async function createCard(questionViewName, courseID, dsDescriptor, noteID, tags, elo = blankCourseElo2(), author) {
+  const qDescriptor = NameSpacer.getQuestionDescriptor(questionViewName);
+  const cfg = await getCredentialledCourseConfig(courseID);
+  for (const rQ of cfg.questionTypes) {
+    if (rQ.name === questionViewName) {
+      for (const view of rQ.viewList) {
+        await addCard(
+          courseID,
+          dsDescriptor.course,
+          [noteID],
+          NameSpacer.getViewString({
+            course: qDescriptor.course,
+            questionType: qDescriptor.questionType,
+            view
+          }),
+          elo,
+          tags,
+          author
+        );
+      }
+    }
+  }
+}
+async function addCard(courseID, course, id_displayable_data, id_view, elo, tags, author) {
+  const db = getCourseDB2(courseID);
+  const card = await db.post({
+    course,
+    id_displayable_data,
+    id_view,
+    docType: "CARD" /* CARD */,
+    elo: elo || toCourseElo2(990 + Math.round(20 * Math.random())),
+    author
+  });
+  for (const tag of tags) {
+    logger.info(`adding tag: ${tag} to card ${card.id}`);
+    await addTagToCard(courseID, card.id, tag, author, false);
+  }
+  return card;
+}
+async function getCredentialledCourseConfig(courseID) {
+  try {
+    const db = getCourseDB2(courseID);
+    const ret = await db.get("CourseConfig");
+    ret.courseID = courseID;
+    logger.info(`Returning course config: ${JSON.stringify(ret)}`);
+    return ret;
+  } catch (e) {
+    logger.error(`Error fetching config for ${courseID}:`, e);
+    throw e;
+  }
+}
+async function addTagToCard(courseID, cardID, tagID, author, updateELO = true) {
+  const prefixedTagID = getTagID(tagID);
+  const courseDB = getCourseDB2(courseID);
+  const courseApi = new CourseDB(courseID, async () => {
+    const dummySyncStrategy = {
+      setupRemoteDB: () => null,
+      startSync: () => {
+      },
+      canCreateAccount: () => false,
+      canAuthenticate: () => false,
+      getCurrentUsername: async () => "DummyUser"
+    };
+    return BaseUser.Dummy(dummySyncStrategy);
+  });
+  try {
+    logger.info(`Applying tag ${tagID} to card ${courseID + "-" + cardID}...`);
+    const tag = await courseDB.get(prefixedTagID);
+    if (!tag.taggedCards.includes(cardID)) {
+      tag.taggedCards.push(cardID);
+      if (updateELO) {
+        try {
+          const eloData = await courseApi.getCardEloData([cardID]);
+          const elo = eloData[0];
+          elo.tags[tagID] = {
+            count: 0,
+            score: elo.global.score
+            // todo: or 1000?
+          };
+          await updateCardElo(courseID, cardID, elo);
+        } catch (error) {
+          logger.error("Failed to update ELO data for card:", cardID, error);
+        }
+      }
+      return courseDB.put(tag);
+    } else throw new AlreadyTaggedErr(`Card ${cardID} is already tagged with ${tagID}`);
+  } catch (e) {
+    if (e instanceof AlreadyTaggedErr) {
+      throw e;
+    }
+    await createTag(courseID, tagID, author);
+    return addTagToCard(courseID, cardID, tagID, author, updateELO);
+  }
+}
+async function updateCardElo(courseID, cardID, elo) {
+  if (elo) {
+    const cDB = getCourseDB2(courseID);
+    const card = await cDB.get(cardID);
+    logger.debug(`Replacing ${JSON.stringify(card.elo)} with ${JSON.stringify(elo)}`);
+    card.elo = elo;
+    return cDB.put(card);
+  }
+}
+function getTagID(tagName) {
+  const tagPrefix = "TAG" /* TAG */.valueOf() + "-";
+  if (tagName.indexOf(tagPrefix) === 0) {
+    return tagName;
+  } else {
+    return tagPrefix + tagName;
+  }
+}
+function getCourseDB2(courseID) {
+  const dbName = `coursedb-${courseID}`;
+  return new pouchdb_setup_default(
+    ENV.COUCHDB_SERVER_PROTOCOL + "://" + ENV.COUCHDB_SERVER_URL + dbName,
+    pouchDBincludeCredentialsConfig
+  );
+}
+var AlreadyTaggedErr;
+var init_courseAPI = __esm({
+  "src/impl/couch/courseAPI.ts"() {
+    "use strict";
+    init_pouchdb_setup();
+    init_couch();
+    init_factory();
+    init_courseDB();
+    init_types_legacy();
+    init_common();
+    init_logger();
+    AlreadyTaggedErr = class extends Error {
+      constructor(message) {
+        super(message);
+        this.name = "AlreadyTaggedErr";
+      }
+    };
+  }
+});
+
+// src/impl/couch/auth.ts
+var init_auth = __esm({
+  "src/impl/couch/auth.ts"() {
+    "use strict";
+    init_factory();
+    init_types_legacy();
+    init_logger();
+  }
+});
+
+// src/impl/couch/CouchDBSyncStrategy.ts
+import { Status as Status3 } from "@vue-skuilder/common";
+var init_CouchDBSyncStrategy = __esm({
+  "src/impl/couch/CouchDBSyncStrategy.ts"() {
+    "use strict";
+    init_factory();
+    init_types_legacy();
+    init_logger();
+    init_common();
+    init_pouchdb_setup();
+    init_couch();
+    init_auth();
+  }
+});
+
+// src/impl/couch/index.ts
+import moment4 from "moment";
+import process2 from "process";
+function getCourseDB(courseID) {
+  return new pouchdb_setup_default(
+    ENV.COUCHDB_SERVER_PROTOCOL + "://" + ENV.COUCHDB_SERVER_URL + "coursedb-" + courseID,
+    pouchDBincludeCredentialsConfig
+  );
+}
+function getCourseDocs(courseID, docIDs, options = {}) {
+  return getCourseDB(courseID).allDocs({
+    ...options,
+    keys: docIDs
+  });
+}
+function getCourseDoc(courseID, docID, options = {}) {
+  return getCourseDB(courseID).get(docID, options);
+}
+function filterAllDocsByPrefix(db, prefix, opts) {
+  const options = {
+    startkey: prefix,
+    endkey: prefix + "\uFFF0",
+    include_docs: true
+  };
+  if (opts) {
+    Object.assign(options, opts);
+  }
+  return db.allDocs(options);
+}
+function getStartAndEndKeys(key) {
+  return {
+    startkey: key,
+    endkey: key + "\uFFF0"
+  };
+}
+var isBrowser, GUEST_LOCAL_DB, localUserDB, pouchDBincludeCredentialsConfig, REVIEW_PREFIX2, REVIEW_TIME_FORMAT2;
+var init_couch = __esm({
+  "src/impl/couch/index.ts"() {
+    "use strict";
+    init_factory();
+    init_types_legacy();
+    init_logger();
+    init_pouchdb_setup();
+    init_contentSource();
+    init_adminDB2();
+    init_classroomDB2();
+    init_courseAPI();
+    init_courseDB();
+    init_CouchDBSyncStrategy();
+    isBrowser = typeof window !== "undefined";
+    if (isBrowser) {
+      window.process = process2;
+    }
+    GUEST_LOCAL_DB = `userdb-${GuestUsername}`;
+    localUserDB = new pouchdb_setup_default(GUEST_LOCAL_DB);
+    pouchDBincludeCredentialsConfig = {
+      fetch(url, opts) {
+        opts.credentials = "include";
+        return pouchdb_setup_default.fetch(url, opts);
+      }
+    };
+    REVIEW_PREFIX2 = "card_review_";
+    REVIEW_TIME_FORMAT2 = "YYYY-MM-DD--kk:mm:ss-SSS";
+  }
+});
+
+// src/impl/couch/classroomDB.ts
+import moment5 from "moment";
+var init_classroomDB2 = __esm({
+  "src/impl/couch/classroomDB.ts"() {
+    "use strict";
+    init_factory();
+    init_logger();
+    init_pouchdb_setup();
+    init_couch();
+    init_courseDB();
+  }
+});
+
+// src/core/interfaces/contentSource.ts
+var init_contentSource = __esm({
+  "src/core/interfaces/contentSource.ts"() {
+    "use strict";
+    init_factory();
+    init_classroomDB2();
+  }
+});
+
+// src/core/interfaces/courseDB.ts
+var init_courseDB2 = __esm({
+  "src/core/interfaces/courseDB.ts"() {
+    "use strict";
+  }
+});
+
+// src/core/interfaces/dataLayerProvider.ts
+var init_dataLayerProvider = __esm({
+  "src/core/interfaces/dataLayerProvider.ts"() {
+    "use strict";
+  }
+});
+
+// src/core/interfaces/userDB.ts
+var init_userDB = __esm({
+  "src/core/interfaces/userDB.ts"() {
+    "use strict";
+  }
+});
+
+// src/core/interfaces/index.ts
+var init_interfaces = __esm({
+  "src/core/interfaces/index.ts"() {
+    "use strict";
+    init_adminDB();
+    init_classroomDB();
+    init_contentSource();
+    init_courseDB2();
+    init_dataLayerProvider();
+    init_userDB();
+  }
+});
+
+// src/core/types/user.ts
+var init_user = __esm({
+  "src/core/types/user.ts"() {
+    "use strict";
+  }
+});
+
+// src/core/bulkImport/cardProcessor.ts
+import { Status as Status4 } from "@vue-skuilder/common";
+var init_cardProcessor = __esm({
+  "src/core/bulkImport/cardProcessor.ts"() {
+    "use strict";
+    init_logger();
+  }
+});
+
+// src/core/bulkImport/types.ts
+var init_types = __esm({
+  "src/core/bulkImport/types.ts"() {
+    "use strict";
+  }
+});
+
+// src/core/bulkImport/index.ts
+var init_bulkImport = __esm({
+  "src/core/bulkImport/index.ts"() {
+    "use strict";
+    init_cardProcessor();
+    init_types();
+  }
+});
+
+// src/core/index.ts
+var init_core = __esm({
+  "src/core/index.ts"() {
+    "use strict";
+    init_interfaces();
+    init_types_legacy();
+    init_user();
+    init_Loggable();
+    init_util();
+    init_navigators();
+    init_bulkImport();
+  }
+});
+
+// src/impl/static/StaticDataUnpacker.ts
+var pathUtils, nodeFS, StaticDataUnpacker;
+var init_StaticDataUnpacker = __esm({
+  "src/impl/static/StaticDataUnpacker.ts"() {
+    "use strict";
+    init_logger();
+    init_core();
+    pathUtils = {
+      isAbsolute: (path) => {
+        if (/^[a-zA-Z]:[\\/]/.test(path) || /^\\\\/.test(path)) {
+          return true;
+        }
+        if (path.startsWith("/")) {
+          return true;
+        }
+        return false;
+      }
+    };
+    nodeFS = null;
+    try {
+      if (typeof window === "undefined" && typeof process !== "undefined" && process.versions?.node) {
+        nodeFS = eval("require")("fs");
+      }
+    } catch {
+    }
+    StaticDataUnpacker = class {
+      manifest;
+      basePath;
+      documentCache = /* @__PURE__ */ new Map();
+      chunkCache = /* @__PURE__ */ new Map();
+      indexCache = /* @__PURE__ */ new Map();
+      constructor(manifest, basePath) {
+        this.manifest = manifest;
+        this.basePath = basePath;
+      }
+      /**
+       * Get a document by ID, loading from appropriate chunk if needed
+       */
+      async getDocument(id) {
+        if (this.documentCache.has(id)) {
+          const doc = this.documentCache.get(id);
+          return await this.hydrateAttachments(doc);
+        }
+        const chunk = await this.findChunkForDocument(id);
+        if (!chunk) {
+          logger.error(
+            `Document ${id} not found in any chunk. Available chunks:`,
+            this.manifest.chunks.map((c) => `${c.id} (${c.docType}): ${c.startKey} - ${c.endKey}`)
+          );
+          throw new Error(`Document ${id} not found in any chunk`);
+        }
+        await this.loadChunk(chunk.id);
+        if (this.documentCache.has(id)) {
+          const doc = this.documentCache.get(id);
+          return await this.hydrateAttachments(doc);
+        }
+        logger.error(`Document ${id} not found in chunk ${chunk.id}`);
+        throw new Error(`Document ${id} not found in chunk ${chunk.id}`);
+      }
+      /**
+       * Query cards by ELO score, returning card IDs sorted by ELO
+       */
+      async queryByElo(targetElo, limit = 25) {
+        const eloIndex = await this.loadIndex("elo");
+        if (!eloIndex || !eloIndex.sorted) {
+          logger.warn("ELO index not found or malformed, returning empty results");
+          return [];
+        }
+        const sorted = eloIndex.sorted;
+        let startIndex = 0;
+        let left = 0;
+        let right = sorted.length - 1;
+        while (left <= right) {
+          const mid = Math.floor((left + right) / 2);
+          if (sorted[mid].elo < targetElo) {
+            left = mid + 1;
+          } else {
+            right = mid - 1;
+          }
+        }
+        startIndex = left;
+        const result = [];
+        const halfLimit = Math.floor(limit / 2);
+        for (let i = Math.max(0, startIndex - halfLimit); i < startIndex && result.length < limit; i++) {
+          result.push(sorted[i].cardId);
+        }
+        for (let i = startIndex; i < sorted.length && result.length < limit; i++) {
+          result.push(sorted[i].cardId);
+        }
+        return result;
+      }
+      /**
+       * Get all tag names mapped to their card arrays
+       */
+      async getTagsIndex() {
+        return await this.loadIndex("tags");
+      }
+      /**
+       * Find which chunk contains a specific document ID
+       */
+      async findChunkForDocument(docId) {
+        let expectedDocType = void 0;
+        for (const docType of Object.values(DocType)) {
+          if (docId.startsWith(`${docType}-`)) {
+            expectedDocType = docType;
+            break;
+          }
+        }
+        if (expectedDocType !== void 0) {
+          const typeChunks = this.manifest.chunks.filter((c) => c.docType === expectedDocType);
+          for (const chunk of typeChunks) {
+            if (docId >= chunk.startKey && docId <= chunk.endKey) {
+              const exists = await this.verifyDocumentInChunk(docId, chunk);
+              if (exists) {
+                return chunk;
+              }
+            }
+          }
+          return void 0;
+        } else {
+          const displayableChunks = this.manifest.chunks.filter(
+            (c) => c.docType === "DISPLAYABLE_DATA"
+          );
+          for (const chunk of displayableChunks) {
+            if (docId >= chunk.startKey && docId <= chunk.endKey) {
+              const exists = await this.verifyDocumentInChunk(docId, chunk);
+              if (exists) {
+                return chunk;
+              }
+            }
+          }
+          const cardChunks = this.manifest.chunks.filter((c) => c.docType === "CARD");
+          for (const chunk of cardChunks) {
+            if (docId >= chunk.startKey && docId <= chunk.endKey) {
+              const exists = await this.verifyDocumentInChunk(docId, chunk);
+              if (exists) {
+                return chunk;
+              }
+            }
+          }
+          const otherChunks = this.manifest.chunks.filter(
+            (c) => c.docType !== "CARD" && c.docType !== "DISPLAYABLE_DATA" && c.docType !== "TAG"
+          );
+          for (const chunk of otherChunks) {
+            if (docId >= chunk.startKey && docId <= chunk.endKey) {
+              const exists = await this.verifyDocumentInChunk(docId, chunk);
+              if (exists) {
+                return chunk;
+              }
+            }
+          }
+          return void 0;
+        }
+      }
+      /**
+       * Verify that a document actually exists in a specific chunk by loading and checking it
+       */
+      async verifyDocumentInChunk(docId, chunk) {
+        try {
+          await this.loadChunk(chunk.id);
+          return this.documentCache.has(docId);
+        } catch {
+          return false;
+        }
+      }
+      /**
+       * Load a chunk file and cache its documents
+       */
+      async loadChunk(chunkId) {
+        if (this.chunkCache.has(chunkId)) {
+          return;
+        }
+        const chunk = this.manifest.chunks.find((c) => c.id === chunkId);
+        if (!chunk) {
+          throw new Error(`Chunk ${chunkId} not found in manifest`);
+        }
+        try {
+          const chunkPath = `${this.basePath}/${chunk.path}`;
+          logger.debug(`Loading chunk from ${chunkPath}`);
+          let documents;
+          if (this.isLocalPath(chunkPath) && nodeFS) {
+            const fileContent = await nodeFS.promises.readFile(chunkPath, "utf8");
+            documents = JSON.parse(fileContent);
+          } else {
+            const response = await fetch(chunkPath);
+            if (!response.ok) {
+              throw new Error(
+                `Failed to fetch chunk ${chunkId}: ${response.status} ${response.statusText}`
+              );
+            }
+            documents = await response.json();
+          }
+          this.chunkCache.set(chunkId, documents);
+          for (const doc of documents) {
+            if (doc._id) {
+              this.documentCache.set(doc._id, doc);
+            }
+          }
+          logger.debug(`Loaded ${documents.length} documents from chunk ${chunkId}`);
+        } catch (error) {
+          logger.error(`Failed to load chunk ${chunkId}:`, error);
+          throw error;
+        }
+      }
+      /**
+       * Load an index file and cache it
+       */
+      async loadIndex(indexName) {
+        if (this.indexCache.has(indexName)) {
+          return this.indexCache.get(indexName);
+        }
+        const indexMeta = this.manifest.indices.find((idx) => idx.name === indexName);
+        if (!indexMeta) {
+          throw new Error(`Index ${indexName} not found in manifest`);
+        }
+        try {
+          const indexPath = `${this.basePath}/${indexMeta.path}`;
+          logger.debug(`Loading index from ${indexPath}`);
+          let indexData;
+          if (this.isLocalPath(indexPath) && nodeFS) {
+            const fileContent = await nodeFS.promises.readFile(indexPath, "utf8");
+            indexData = JSON.parse(fileContent);
+          } else {
+            const response = await fetch(indexPath);
+            if (!response.ok) {
+              throw new Error(
+                `Failed to fetch index ${indexName}: ${response.status} ${response.statusText}`
+              );
+            }
+            indexData = await response.json();
+          }
+          this.indexCache.set(indexName, indexData);
+          logger.debug(`Loaded index ${indexName}`);
+          return indexData;
+        } catch (error) {
+          logger.error(`Failed to load index ${indexName}:`, error);
+          throw error;
+        }
+      }
+      /**
+       * Get a document by ID without hydration (raw document access)
+       * Used internally to avoid recursion during attachment hydration
+       */
+      async getRawDocument(id) {
+        if (this.documentCache.has(id)) {
+          return this.documentCache.get(id);
+        }
+        const chunk = await this.findChunkForDocument(id);
+        if (!chunk) {
+          logger.error(
+            `Document ${id} not found in any chunk. Available chunks:`,
+            this.manifest.chunks.map((c) => `${c.id} (${c.docType}): ${c.startKey} - ${c.endKey}`)
+          );
+          throw new Error(`Document ${id} not found in any chunk`);
+        }
+        await this.loadChunk(chunk.id);
+        if (this.documentCache.has(id)) {
+          return this.documentCache.get(id);
+        }
+        logger.error(`Document ${id} not found in chunk ${chunk.id}`);
+        throw new Error(`Document ${id} not found in chunk ${chunk.id}`);
+      }
+      /**
+       * Get attachment URL for a given document and attachment name
+       */
+      getAttachmentUrl(docId, attachmentName) {
+        return `${this.basePath}/attachments/${docId}/${attachmentName}`;
+      }
+      /**
+       * Load attachment data from the document and get the correct file path
+       * Uses raw document access to avoid recursion with hydration
+       */
+      async getAttachmentPath(docId, attachmentName) {
+        try {
+          const doc = await this.getRawDocument(docId);
+          if (doc._attachments && doc._attachments[attachmentName]) {
+            const attachment = doc._attachments[attachmentName];
+            if (attachment.path) {
+              return `${this.basePath}/${attachment.path}`;
+            }
+          }
+          return null;
+        } catch {
+          return null;
+        }
+      }
+      /**
+       * Load attachment as a blob (for browser) or buffer (for Node.js)
+       */
+      async getAttachmentBlob(docId, attachmentName) {
+        const attachmentPath = await this.getAttachmentPath(docId, attachmentName);
+        if (!attachmentPath) {
+          return null;
+        }
+        try {
+          if (this.isLocalPath(attachmentPath) && nodeFS) {
+            const buffer = await nodeFS.promises.readFile(attachmentPath);
+            return buffer;
+          } else {
+            const response = await fetch(attachmentPath);
+            if (!response.ok) {
+              throw new Error(
+                `Failed to fetch attachment ${docId}/${attachmentName}: ${response.status} ${response.statusText}`
+              );
+            }
+            return await response.blob();
+          }
+        } catch (error) {
+          logger.error(`Failed to load attachment ${docId}/${attachmentName}:`, error);
+          return null;
+        }
+      }
+      /**
+       * Hydrate document attachments by converting file paths to blob URLs
+       */
+      async hydrateAttachments(doc) {
+        const typedDoc = doc;
+        if (!typedDoc._attachments) {
+          return doc;
+        }
+        const hydratedDoc = JSON.parse(JSON.stringify(doc));
+        for (const [attachmentName, attachment] of Object.entries(typedDoc._attachments)) {
+          const attachmentData = attachment;
+          if (attachmentData.path) {
+            try {
+              const blob = await this.getAttachmentBlob(typedDoc._id, attachmentName);
+              if (blob) {
+                if (typeof window !== "undefined" && window.URL) {
+                  hydratedDoc._attachments[attachmentName] = {
+                    ...attachmentData,
+                    data: blob,
+                    stub: false
+                    // Indicates this contains actual data, not just metadata
+                  };
+                } else {
+                  hydratedDoc._attachments[attachmentName] = {
+                    ...attachmentData,
+                    buffer: blob
+                    // Attach buffer for Node.js use
+                  };
+                }
+              } else {
+                logger.warn(
+                  `[hydrateAttachments] getAttachmentBlob returned null for ${typedDoc._id}/${attachmentName}. Skipping hydration for this attachment.`
+                );
+              }
+            } catch (error) {
+              logger.warn(
+                `[hydrateAttachments] Failed to hydrate attachment ${typedDoc._id}/${attachmentName}:`,
+                error
+              );
+            }
+          } else {
+            logger.debug(
+              `[hydrateAttachments] Attachment ${attachmentName} for doc ${typedDoc._id} has no path. Skipping blob conversion.`
+            );
+          }
+        }
+        return hydratedDoc;
+      }
+      /**
+       * Clear all caches (useful for testing or memory management)
+       */
+      clearCaches() {
+        this.documentCache.clear();
+        this.chunkCache.clear();
+        this.indexCache.clear();
+      }
+      /**
+       * Get cache statistics for debugging
+       */
+      getCacheStats() {
+        return {
+          documents: this.documentCache.size,
+          chunks: this.chunkCache.size,
+          indices: this.indexCache.size
+        };
+      }
+      /**
+       * Check if a path is a local file path (vs URL)
+       */
+      isLocalPath(filePath) {
+        return !filePath.startsWith("http://") && !filePath.startsWith("https://") && (pathUtils.isAbsolute(filePath) || filePath.startsWith("./") || filePath.startsWith("../"));
+      }
+    };
+  }
+});
+
+// src/impl/static/courseDB.ts
+import { Status as Status5 } from "@vue-skuilder/common";
+var StaticCourseDB;
+var init_courseDB3 = __esm({
+  "src/impl/static/courseDB.ts"() {
+    "use strict";
+    init_types_legacy();
+    init_navigators();
+    StaticCourseDB = class {
+      constructor(courseId, unpacker, userDB, manifest) {
+        this.courseId = courseId;
+        this.unpacker = unpacker;
+        this.userDB = userDB;
+        this.manifest = manifest;
+      }
+      getCourseID() {
+        return this.courseId;
+      }
+      async getCourseConfig() {
+        if (this.manifest.courseConfig != null) {
+          return this.manifest.courseConfig;
+        } else {
+          throw new Error(`Course config not found for course ${this.courseId}`);
+        }
+      }
+      async updateCourseConfig(_cfg) {
+        throw new Error("Cannot update course config in static mode");
+      }
+      async getCourseInfo() {
+        return {
+          cardCount: 0,
+          // Would come from manifest
+          registeredUsers: 0
+        };
+      }
+      async getCourseDoc(id, _options) {
+        return this.unpacker.getDocument(id);
+      }
+      async getCourseDocs(ids, _options) {
+        const rows = await Promise.all(
+          ids.map(async (id) => {
+            try {
+              const doc = await this.unpacker.getDocument(id);
+              return {
+                id,
+                key: id,
+                value: { rev: "1-static" },
+                doc
+              };
+            } catch {
+              return {
+                key: id,
+                error: "not_found"
+              };
+            }
+          })
+        );
+        return {
+          total_rows: ids.length,
+          offset: 0,
+          rows
+        };
+      }
+      async getCardsByELO(elo, limit) {
+        return this.unpacker.queryByElo(elo, limit || 25);
+      }
+      async getCardEloData(cardIds) {
+        const results = await Promise.all(
+          cardIds.map(async (id) => {
+            try {
+              const card = await this.unpacker.getDocument(id);
+              return card.elo || { global: { score: 1e3, count: 0 }, tags: {}, misc: {} };
+            } catch {
+              return { global: { score: 1e3, count: 0 }, tags: {}, misc: {} };
+            }
+          })
+        );
+        return results;
+      }
+      async updateCardElo(cardId, _elo) {
+        return { ok: true, id: cardId, rev: "1-static" };
+      }
+      async getNewCards(limit) {
+        const cardIds = await this.unpacker.queryByElo(1e3, limit || 10);
+        return cardIds.map((cardId) => ({
+          status: "new",
+          qualifiedID: `${this.courseId}-${cardId}`,
+          cardID: cardId,
+          contentSourceType: "course",
+          contentSourceID: this.courseId,
+          courseID: this.courseId
+        }));
+      }
+      async getCardsCenteredAtELO(options, filter) {
+        let targetElo = typeof options.elo === "number" ? options.elo : 1e3;
+        if (options.elo === "user") {
+          try {
+            const regDoc = await this.userDB.getCourseRegistrationsDoc();
+            const courseReg = regDoc.courses.find((c) => c.courseID === this.courseId);
+            if (courseReg && typeof courseReg.elo === "object") {
+              targetElo = courseReg.elo.global.score;
+            }
+          } catch {
+            targetElo = 1e3;
+          }
+        } else if (options.elo === "random") {
+          targetElo = 800 + Math.random() * 400;
+        }
+        let cardIds = await this.unpacker.queryByElo(targetElo, options.limit * 2);
+        if (filter) {
+          cardIds = cardIds.filter(filter);
+        }
+        return cardIds.slice(0, options.limit).map((cardId) => ({
+          status: "new",
+          qualifiedID: `${this.courseId}-${cardId}`,
+          cardID: cardId,
+          contentSourceType: "course",
+          contentSourceID: this.courseId,
+          courseID: this.courseId
+        }));
+      }
+      async getAppliedTags(_cardId) {
+        return {
+          total_rows: 0,
+          offset: 0,
+          rows: []
+        };
+      }
+      async addTagToCard(_cardId, _tagId) {
+        throw new Error("Cannot modify tags in static mode");
+      }
+      async removeTagFromCard(_cardId, _tagId) {
+        throw new Error("Cannot modify tags in static mode");
+      }
+      async createTag(_tagName) {
+        throw new Error("Cannot create tags in static mode");
+      }
+      async getTag(tagName) {
+        return this.unpacker.getDocument(`${"TAG" /* TAG */}-${tagName}`);
+      }
+      async updateTag(_tag) {
+        throw new Error("Cannot update tags in static mode");
+      }
+      async getCourseTagStubs() {
+        return {
+          total_rows: 0,
+          offset: 0,
+          rows: []
+        };
+      }
+      async addNote(_codeCourse, _shape, _data, _author, _tags, _uploads, _elo) {
+        return {
+          status: Status5.error,
+          message: "Cannot add notes in static mode"
+        };
+      }
+      async removeCard(_cardId) {
+        throw new Error("Cannot remove cards in static mode");
+      }
+      async getInexperiencedCards() {
+        return [];
+      }
+      // Navigation Strategy Manager implementation
+      async getNavigationStrategy(_id) {
+        return {
+          id: "ELO",
+          docType: "NAVIGATION_STRATEGY" /* NAVIGATION_STRATEGY */,
+          name: "ELO",
+          description: "ELO-based navigation strategy",
+          implementingClass: "elo" /* ELO */,
+          course: this.courseId,
+          serializedData: ""
+        };
+      }
+      async getAllNavigationStrategies() {
+        return [await this.getNavigationStrategy("ELO")];
+      }
+      async addNavigationStrategy(_data) {
+        throw new Error("Cannot add navigation strategies in static mode");
+      }
+      async updateNavigationStrategy(_id, _data) {
+        throw new Error("Cannot update navigation strategies in static mode");
+      }
+      async surfaceNavigationStrategy() {
+        return this.getNavigationStrategy("ELO");
+      }
+      // Study Content Source implementation
+      async getPendingReviews() {
+        return [];
+      }
+      // Attachment helper methods (internal use, not part of interface)
+      /**
+       * Get attachment URL for a document and attachment name
+       * Internal helper method for static attachment serving
+       */
+      getAttachmentUrl(docId, attachmentName) {
+        return this.unpacker.getAttachmentUrl(docId, attachmentName);
+      }
+      /**
+       * Load attachment as blob/buffer
+       * Internal helper method for static attachment serving
+       */
+      async getAttachmentBlob(docId, attachmentName) {
+        return this.unpacker.getAttachmentBlob(docId, attachmentName);
+      }
+    };
+  }
+});
+
+// src/impl/static/coursesDB.ts
+var StaticCoursesDB;
+var init_coursesDB = __esm({
+  "src/impl/static/coursesDB.ts"() {
+    "use strict";
+    init_logger();
+    StaticCoursesDB = class {
+      constructor(manifests) {
+        this.manifests = manifests;
+      }
+      async getCourseConfig(courseId) {
+        if (!this.manifests[courseId]) {
+          logger.warn(`Course ${courseId} not found`);
+          return {};
+        }
+        return {};
+      }
+      async getCourseList() {
+        return Object.keys(this.manifests).map(
+          (courseId) => ({
+            courseID: courseId,
+            name: this.manifests[courseId].courseName
+            // ... other config fields
+          })
+        );
+      }
+      async disambiguateCourse(_courseId, _disambiguator) {
+        logger.warn("Cannot disambiguate courses in static mode");
+      }
+    };
+  }
+});
+
+// src/impl/static/NoOpSyncStrategy.ts
+var NoOpSyncStrategy;
+var init_NoOpSyncStrategy = __esm({
+  "src/impl/static/NoOpSyncStrategy.ts"() {
+    "use strict";
+    init_types_legacy();
+    init_common();
+    NoOpSyncStrategy = class {
+      currentUsername = GuestUsername;
+      setupRemoteDB(username) {
+        return getLocalUserDB(username);
+      }
+      startSync(_localDB, _remoteDB) {
+      }
+      stopSync() {
+      }
+      canCreateAccount() {
+        return false;
+      }
+      canAuthenticate() {
+        return false;
+      }
+      async createAccount(_username, _password) {
+        throw new Error(
+          "Account creation not supported in static mode. Use local account switching instead."
+        );
+      }
+      async authenticate(_username, _password) {
+        throw new Error(
+          "Remote authentication not supported in static mode. Use local account switching instead."
+        );
+      }
+      async logout() {
+        this.currentUsername = GuestUsername;
+        return {
+          ok: true
+        };
+      }
+      async getCurrentUsername() {
+        return this.currentUsername;
+      }
+      /**
+       * Set the current username (for local account switching)
+       * This method is specific to NoOpSyncStrategy and not part of the base interface
+       */
+      setCurrentUsername(username) {
+        this.currentUsername = username;
+      }
+    };
+  }
+});
+
+// src/impl/static/StaticDataLayerProvider.ts
+var StaticDataLayerProvider;
+var init_StaticDataLayerProvider = __esm({
+  "src/impl/static/StaticDataLayerProvider.ts"() {
+    "use strict";
+    init_logger();
+    init_StaticDataUnpacker();
+    init_courseDB3();
+    init_coursesDB();
+    init_common();
+    init_NoOpSyncStrategy();
+    StaticDataLayerProvider = class {
+      config;
+      initialized = false;
+      courseUnpackers = /* @__PURE__ */ new Map();
+      constructor(config) {
+        this.config = {
+          staticContentPath: config.staticContentPath || "/static-courses",
+          localStoragePrefix: config.localStoragePrefix || "skuilder-static",
+          manifests: config.manifests || {}
+        };
+      }
+      async initialize() {
+        if (this.initialized) return;
+        logger.info("Initializing static data layer provider");
+        for (const [courseId, manifest] of Object.entries(this.config.manifests)) {
+          const unpacker = new StaticDataUnpacker(
+            manifest,
+            `${this.config.staticContentPath}/${courseId}`
+          );
+          this.courseUnpackers.set(courseId, unpacker);
+        }
+        this.initialized = true;
+      }
+      async teardown() {
+        this.courseUnpackers.clear();
+        this.initialized = false;
+      }
+      getUserDB() {
+        const syncStrategy = new NoOpSyncStrategy();
+        return BaseUser.Dummy(syncStrategy);
+      }
+      getCourseDB(courseId) {
+        const unpacker = this.courseUnpackers.get(courseId);
+        if (!unpacker) {
+          throw new Error(`Course ${courseId} not found in static data`);
+        }
+        const manifest = this.config.manifests[courseId];
+        return new StaticCourseDB(courseId, unpacker, this.getUserDB(), manifest);
+      }
+      getCoursesDB() {
+        return new StaticCoursesDB(this.config.manifests);
+      }
+      async getClassroomDB(_classId, _type) {
+        throw new Error("Classrooms not supported in static mode");
+      }
+      getAdminDB() {
+        throw new Error("Admin functions not supported in static mode");
+      }
+      isReadOnly() {
+        return true;
+      }
+    };
+  }
+});
+
+// src/impl/static/index.ts
+init_StaticDataLayerProvider();
+init_StaticDataUnpacker();
+init_courseDB3();
+init_coursesDB();
+init_NoOpSyncStrategy();
+export {
+  NoOpSyncStrategy,
+  StaticCourseDB,
+  StaticCoursesDB,
+  StaticDataLayerProvider,
+  StaticDataUnpacker
+};
+//# sourceMappingURL=index.mjs.map