@vue-skuilder/db 0.2.36 → 0.2.37

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (33) hide show
  1. package/dist/core/index.cjs +91 -70
  2. package/dist/core/index.cjs.map +1 -1
  3. package/dist/core/navigators/generators/prescribed.mjs +29 -11
  4. package/dist/core/navigators/generators/prescribed.mjs.map +1 -1
  5. package/dist/core/versionStamps.mjs +1 -1
  6. package/dist/impl/common/BaseUserDB.mjs +14 -2
  7. package/dist/impl/common/BaseUserDB.mjs.map +1 -1
  8. package/dist/impl/couch/CourseSyncService.mjs +88 -10
  9. package/dist/impl/couch/CourseSyncService.mjs.map +1 -1
  10. package/dist/impl/couch/PouchDataLayerProvider.mjs +16 -1
  11. package/dist/impl/couch/PouchDataLayerProvider.mjs.map +1 -1
  12. package/dist/impl/couch/courseAPI.mjs +24 -10
  13. package/dist/impl/couch/courseAPI.mjs.map +1 -1
  14. package/dist/impl/couch/courseDB.mjs +15 -9
  15. package/dist/impl/couch/courseDB.mjs.map +1 -1
  16. package/dist/impl/couch/index.cjs +163 -62
  17. package/dist/impl/couch/index.cjs.map +1 -1
  18. package/dist/impl/couch/index.d.ts +22 -1
  19. package/dist/impl/couch/index.mjs +20 -3
  20. package/dist/impl/couch/index.mjs.map +1 -1
  21. package/dist/impl/static/index.cjs +39 -15
  22. package/dist/impl/static/index.cjs.map +1 -1
  23. package/dist/index.cjs +202 -92
  24. package/dist/index.cjs.map +1 -1
  25. package/package.json +3 -3
  26. package/src/core/navigators/generators/prescribed.ts +42 -16
  27. package/src/impl/common/BaseUserDB.ts +15 -2
  28. package/src/impl/couch/CourseSyncService.ts +130 -20
  29. package/src/impl/couch/PouchDataLayerProvider.ts +14 -1
  30. package/src/impl/couch/courseAPI.ts +26 -12
  31. package/src/impl/couch/courseDB.ts +20 -12
  32. package/src/impl/couch/index.ts +16 -5
  33. package/tests/impl/courseSync.test.ts +139 -0
@@ -1 +1 @@
1
- {"version":3,"file":"courseDB.mjs","names":[],"sources":["../../../src/impl/couch/courseDB.ts"],"sourcesContent":["import { CourseDBInterface, CourseInfo, CoursesDBInterface, UserDBInterface } from '@db/core';\nimport type { GeneratorResult, ReplanHints } from '@db/core/navigators/generators/types';\nimport {\n CourseConfig,\n CourseElo,\n DataShape,\n EloToNumber,\n Status,\n blankCourseElo,\n toCourseElo,\n} from '@vue-skuilder/common';\n\nimport { filterAllDocsByPrefix, getCourseDB } from '.';\nimport UpdateQueue from './updateQueue';\nimport type { StudyContentSource } from '../../core/interfaces/contentSource';\nimport { StudySessionItem } from '../../core/interfaces/contentSource';\nimport {\n CardData,\n DocType,\n QualifiedCardID,\n SkuilderCourseData,\n Tag,\n TagStub,\n DocTypePrefixes,\n} from '../../core/types/types-legacy';\nimport { logger } from '../../util/logger';\nimport { GET_CACHED } from './clientCache';\nimport { addNote55, addTagToCard, getCredentialledCourseConfig, getTagID } from './courseAPI';\nimport { DataLayerResult } from '@db/core/types/db';\nimport { PouchError } from './types';\nimport CourseLookup from './courseLookupDB';\nimport { ContentNavigationStrategyData } from '@db/core/types/contentNavigationStrategy';\nimport { ContentNavigator, Navigators } from '@db/core/navigators';\nimport { PipelineAssembler } from '@db/core/navigators/PipelineAssembler';\nimport { createDefaultPipeline } from '@db/core/navigators/defaults';\n\nexport class CoursesDB implements CoursesDBInterface {\n _courseIDs: string[] | undefined;\n\n constructor(courseIDs?: string[]) {\n if (courseIDs && courseIDs.length > 0) {\n this._courseIDs = courseIDs;\n } else {\n this._courseIDs = undefined;\n }\n }\n\n public async getCourseList(): Promise<CourseConfig[]> {\n let crsList = await CourseLookup.allCourseWare();\n logger.debug(`AllCourses: ${crsList.map((c) => c.name + ', ' + c._id + '\\n\\t')}`);\n if (this._courseIDs) {\n crsList = crsList.filter((c) => this._courseIDs!.includes(c._id));\n }\n\n logger.debug(`AllCourses.filtered: ${crsList.map((c) => c.name + ', ' + c._id + '\\n\\t')}`);\n\n const cfgs = await Promise.all(\n crsList.map(async (c) => {\n try {\n const cfg = await getCredentialledCourseConfig(c._id);\n logger.debug(`Found cfg: ${JSON.stringify(cfg)}`);\n return cfg;\n } catch (e) {\n logger.warn(`Error fetching cfg for course ${c.name}, ${c._id}: ${e}`);\n return undefined;\n }\n })\n );\n return cfgs.filter((c) => !!c);\n }\n\n async getCourseConfig(courseId: string): Promise<CourseConfig> {\n if (this._courseIDs && this._courseIDs.length && !this._courseIDs.includes(courseId)) {\n throw new Error(`Course ${courseId} not in course list`);\n }\n\n const cfg = await getCredentialledCourseConfig(courseId);\n if (cfg === undefined) {\n throw new Error(`Error fetching cfg for course ${courseId}`);\n } else {\n return cfg;\n }\n }\n\n public async disambiguateCourse(courseId: string, disambiguator: string): Promise<void> {\n await CourseLookup.updateDisambiguator(courseId, disambiguator);\n }\n}\n\nfunction randIntWeightedTowardZero(n: number) {\n return Math.floor(Math.random() * Math.random() * Math.random() * n);\n}\n\nexport class CourseDB implements CourseDBInterface {\n // private log(msg: string): void {\n // log(`CourseLog: ${this.id}\\n ${msg}`);\n // }\n\n /**\n * Primary database handle used for all **read** operations (queries, gets).\n *\n * When local sync is active, this points to the local PouchDB replica for\n * fast, network-free reads. Otherwise it points to the remote CouchDB.\n */\n private db: PouchDB.Database;\n\n /**\n * Remote database handle used for all **write** operations.\n *\n * Always points to the remote CouchDB so that writes (ELO updates, tag\n * mutations, admin operations) aggregate on the server. The local replica\n * is a read-only snapshot that refreshes on the next page load.\n *\n * When local sync is NOT active, this is the same instance as `this.db`.\n */\n private remoteDB: PouchDB.Database;\n\n private id: string;\n private _getCurrentUser: () => Promise<UserDBInterface>;\n private updateQueue: UpdateQueue;\n\n /**\n * @param id - Course ID\n * @param userLookup - Async function returning the current user DB\n * @param localDB - Optional local PouchDB replica for reads. When provided,\n * `this.db` uses the local replica and `this.remoteDB` stays remote.\n * The UpdateQueue reads from remote and writes to remote (local `_rev`\n * values may be stale, so read-modify-write cycles must go through\n * the remote DB to avoid conflicts).\n */\n constructor(id: string, userLookup: () => Promise<UserDBInterface>, localDB?: PouchDB.Database) {\n this.id = id;\n const remote = getCourseDB(this.id);\n this.remoteDB = remote;\n this.db = localDB ?? remote;\n this._getCurrentUser = userLookup;\n // UpdateQueue always operates against the remote DB for its\n // read-modify-write cycle. Local _rev values may be stale (the local\n // replica is a snapshot), so conflict retries must read from remote.\n this.updateQueue = new UpdateQueue(this.remoteDB, this.remoteDB);\n }\n\n public getCourseID(): string {\n return this.id;\n }\n\n public async getCourseInfo(): Promise<CourseInfo> {\n const cardCount = (\n await this.db.find({\n selector: {\n docType: DocType.CARD,\n },\n limit: 1000,\n })\n ).docs.length;\n\n return {\n cardCount,\n registeredUsers: 0,\n };\n }\n\n public async getInexperiencedCards(limit: number = 2) {\n return (\n await this.db.query('cardsByInexperience', {\n limit,\n })\n ).rows.map((r) => {\n const ret = {\n courseId: this.id,\n cardId: r.id,\n count: r.key,\n elo: r.value,\n };\n return ret;\n });\n }\n\n public async getCardsByEloLimits(\n options: {\n low: number;\n high: number;\n limit: number;\n page: number;\n } = {\n low: 0,\n high: Number.MIN_SAFE_INTEGER,\n limit: 25,\n page: 0,\n }\n ) {\n return (\n await this.db.query('elo', {\n startkey: options.low,\n endkey: options.high,\n limit: options.limit,\n skip: options.limit * options.page,\n })\n ).rows.map((r) => {\n return `${this.id}-${r.id}-${r.key}`;\n });\n }\n public async getCardEloData(id: string[]): Promise<CourseElo[]> {\n const docs = await this.db.allDocs<CardData>({\n keys: id,\n include_docs: true,\n });\n const ret: CourseElo[] = [];\n docs.rows.forEach((r) => {\n // [ ] remove these ts-ignore directives.\n if (isSuccessRow(r)) {\n if (r.doc && r.doc.elo) {\n ret.push(toCourseElo(r.doc.elo));\n } else {\n logger.warn('no elo data for card: ' + r.id);\n ret.push(blankCourseElo());\n }\n } else {\n logger.warn('no elo data for card: ' + JSON.stringify(r));\n ret.push(blankCourseElo());\n }\n });\n return ret;\n }\n\n /**\n * Returns the lowest and highest `global` ELO ratings in the course\n */\n public async getELOBounds() {\n const [low, high] = await Promise.all([\n (\n await this.db.query('elo', {\n startkey: 0,\n limit: 1,\n include_docs: false,\n })\n ).rows[0].key,\n (\n await this.db.query('elo', {\n limit: 1,\n descending: true,\n startkey: 100_000,\n })\n ).rows[0].key,\n ]);\n\n return {\n low: low,\n high: high,\n };\n }\n\n public async removeCard(id: string) {\n // Admin operation — read and write both go through remote DB to ensure\n // we have the current _rev for the delete.\n const doc = await this.remoteDB.get<CardData>(id);\n if (!doc.docType || !(doc.docType === DocType.CARD)) {\n throw new Error(`failed to remove ${id} from course ${this.id}. id does not point to a card`);\n }\n\n // Remove card from all associated tags before deleting the card\n try {\n const appliedTags = await this.getAppliedTags(id);\n const results = await Promise.allSettled(\n appliedTags.rows.map(async (tagRow) => {\n const tagId = tagRow.id;\n await this.removeTagFromCard(id, tagId);\n })\n );\n\n // Log any individual tag cleanup failures\n results.forEach((result, index) => {\n if (result.status === 'rejected') {\n const tagId = appliedTags.rows[index].id;\n logger.error(`Failed to remove card ${id} from tag ${tagId}: ${result.reason}`);\n }\n });\n } catch (error) {\n logger.error(`Error removing card ${id} from tags: ${error}`);\n // Continue with card deletion even if tag cleanup fails\n }\n\n return this.remoteDB.remove(doc);\n }\n\n public async getCardDisplayableDataIDs(id: string[]) {\n logger.debug(id.join(', '));\n const cards = await this.db.allDocs<CardData>({\n keys: id,\n include_docs: true,\n });\n const ret: { [card: string]: string[] } = {};\n cards.rows.forEach((r) => {\n if (isSuccessRow(r)) {\n ret[r.id] = r.doc!.id_displayable_data;\n }\n });\n\n return ret;\n }\n\n async getCardsByELO(elo: number, cardLimit?: number) {\n elo = parseInt(elo as any);\n const limit = cardLimit ? cardLimit : 25;\n\n // const tQ0 = performance.now();\n // NOTE: `stale: 'update_after'` was tried here and removed — it gave no\n // measurable speedup (PouchDB 9 effectively ignores it for the reindex\n // cost) AND it can return an empty result on the first query after a cold\n // DB open (index not yet loaded), which then poisons the pool cache. The\n // session pool cache (see getCardsCenteredAtELO) is what removes the\n // per-run cost, so we read the view normally (always-fresh) here.\n const below: PouchDB.Query.Response<object> = await this.db.query('elo', {\n limit: Math.ceil(limit / 2),\n startkey: elo,\n descending: true,\n });\n // const tBelowQ = performance.now();\n\n const aboveLimit = limit - below.rows.length;\n\n const above: PouchDB.Query.Response<object> = await this.db.query('elo', {\n limit: aboveLimit,\n startkey: elo + 1,\n });\n // const tAbove = performance.now();\n // [perf] parked: getCardsByELO view-query timing (below/above split)\n // logger.info(\n // `[perf][getCardsByELO] reqLimit=${limit} ` +\n // `below=${(tBelowQ - tQ0).toFixed(0)}ms(${below.rows.length}r) ` +\n // `above=${(tAbove - tBelowQ).toFixed(0)}ms(${above.rows.length}r)`\n // );\n\n let cards = below.rows;\n cards = cards.concat(above.rows);\n\n const ret = cards\n .sort((a, b) => {\n const s = Math.abs(a.key - elo) - Math.abs(b.key - elo);\n if (s === 0) {\n return Math.random() - 0.5;\n } else {\n return s;\n }\n })\n .map((c) => {\n return {\n courseID: this.id,\n cardID: c.id,\n elo: c.key,\n };\n });\n\n const str = `below:\\n${below.rows.map((r) => `\\t${r.id}-${r.key}\\n`)}\n\nabove:\\n${above.rows.map((r) => `\\t${r.id}-${r.key}\\n`)}`;\n\n logger.debug(`Getting ${limit} cards centered around elo: ${elo}:\\n\\n` + str);\n\n return ret;\n }\n\n async getCourseConfig(): Promise<CourseConfig> {\n const ret = await getCredentialledCourseConfig(this.id);\n if (ret) {\n return ret;\n } else {\n throw new Error(`Course config not found for course ID: ${this.id}`);\n }\n }\n\n async updateCourseConfig(cfg: CourseConfig): Promise<PouchDB.Core.Response> {\n logger.debug(`Updating: ${JSON.stringify(cfg)}`);\n // write both to the course DB:\n try {\n return await updateCredentialledCourseConfig(this.id, cfg);\n } catch (error) {\n logger.error(`Error updating course config in course DB: ${error}`);\n throw error;\n }\n }\n\n async updateCardElo(cardId: string, elo: CourseElo): Promise<PouchDB.Core.Response> {\n if (!elo) {\n throw new Error(`Cannot update card elo with null or undefined value for card ID: ${cardId}`);\n }\n\n try {\n const result = await this.updateQueue.update<\n CardData & PouchDB.Core.GetMeta & PouchDB.Core.IdMeta\n >(cardId, (card) => {\n logger.debug(`Replacing ${JSON.stringify(card.elo)} with ${JSON.stringify(elo)}`);\n card.elo = elo;\n return card;\n });\n return { ok: true, id: cardId, rev: result._rev };\n } catch (error) {\n logger.error(`Failed to update card elo for card ID: ${cardId}`, error);\n throw new Error(`Failed to update card elo for card ID: ${cardId}`);\n }\n }\n\n async getAppliedTags(cardId: string): Promise<PouchDB.Query.Response<TagStub>> {\n const ret = await getAppliedTags(this.id, cardId);\n if (ret) {\n return ret;\n } else {\n throw new Error(`Failed to find tags for card ${this.id}-${cardId}`);\n }\n }\n\n async getAppliedTagsBatch(cardIds: string[]): Promise<Map<string, string[]>> {\n if (cardIds.length === 0) {\n return new Map();\n }\n\n const result = await this.db.query<TagStub>('getTags', {\n keys: cardIds,\n include_docs: false,\n });\n\n const tagsByCard = new Map<string, string[]>();\n\n // Initialize all requested cards with empty arrays\n for (const cardId of cardIds) {\n tagsByCard.set(cardId, []);\n }\n\n // Populate from query results\n for (const row of result.rows) {\n const cardId = row.key as string;\n const tagName = row.value?.name;\n if (tagName && tagsByCard.has(cardId)) {\n tagsByCard.get(cardId)!.push(tagName);\n }\n }\n\n return tagsByCard;\n }\n\n async getAllCardIds(): Promise<string[]> {\n // Card `_id`s are minted as `<DocTypePrefixes[CARD]>-<...>` (see courseAPI),\n // i.e. the `c-` prefix \\u2014 for both framework-minted uuid ids (`c-<uuid>`) and\n // course-authored deterministic ids (e.g. LettersPractice's `c-intro-s-S`).\n //\n // The previous implementation hardcoded a `CARD-` prefix range, which never\n // matched any card and silently returned an EMPTY list, starving the only\n // callers (`forecast()` / `diagnoseCardSpace()`). Use the prefix const so\n // the range stays correct if the scheme ever changes.\n const prefix = `${DocTypePrefixes[DocType.CARD]}-`;\n const result = await this.db.allDocs({\n startkey: prefix,\n endkey: `${prefix}\\ufff0`,\n include_docs: false,\n });\n return result.rows.map((row) => row.id);\n }\n\n async addTagToCard(\n cardId: string,\n tagId: string,\n updateELO?: boolean\n ): Promise<PouchDB.Core.Response> {\n return await addTagToCard(\n this.id,\n cardId,\n tagId,\n (await this._getCurrentUser()).getUsername(),\n updateELO\n );\n }\n\n async removeTagFromCard(cardId: string, tagId: string): Promise<PouchDB.Core.Response> {\n return await removeTagFromCard(this.id, cardId, tagId);\n }\n\n async createTag(name: string, author: string): Promise<PouchDB.Core.Response> {\n return await createTag(this.id, name, author);\n }\n\n async getTag(tagId: string): Promise<PouchDB.Core.GetMeta & PouchDB.Core.Document<Tag>> {\n return await getTag(this.id, tagId);\n }\n\n async updateTag(tag: Tag): Promise<PouchDB.Core.Response> {\n if (tag.course !== this.id) {\n throw new Error(`Tag ${JSON.stringify(tag)} does not belong to course ${this.id}`);\n }\n\n return await updateTag(tag);\n }\n\n async getCourseTagStubs(): Promise<PouchDB.Core.AllDocsResponse<Tag>> {\n return getCourseTagStubs(this.id);\n }\n\n async addNote(\n codeCourse: string,\n shape: DataShape,\n data: unknown,\n author: string,\n tags: string[],\n uploads?: { [key: string]: PouchDB.Core.FullAttachment },\n elo: CourseElo = blankCourseElo()\n ): Promise<DataLayerResult> {\n try {\n const resp = await addNote55(this.id, codeCourse, shape, data, author, tags, uploads, elo);\n if (resp.ok) {\n // Check if card creation failed (property added by addNote55)\n if ((resp as any).cardCreationFailed) {\n logger.warn(\n `[courseDB.addNote] Note added but card creation failed: ${\n (resp as any).cardCreationError\n }`\n );\n return {\n status: Status.error,\n message: `Note was added but no cards were created: ${(resp as any).cardCreationError}`,\n id: resp.id,\n };\n }\n return {\n status: Status.ok,\n message: '',\n id: resp.id,\n };\n } else {\n return {\n status: Status.error,\n message: 'Unexpected error adding note',\n };\n }\n } catch (e) {\n const err = e as PouchDB.Core.Error;\n logger.error(\n `[addNote] error ${err.name}\\n\\treason: ${err.reason}\\n\\tmessage: ${err.message}`\n );\n return {\n status: Status.error,\n message: `Error adding note to course. ${(e as PouchError).reason || err.message}`,\n };\n }\n }\n\n async getCourseDoc<T extends SkuilderCourseData>(\n id: string,\n options?: PouchDB.Core.GetOptions\n ): Promise<PouchDB.Core.GetMeta & PouchDB.Core.Document<T>> {\n // Use this.db (local when available) for read operations.\n // Falls back to the standalone helper (always remote) only if needed.\n return await this.db.get<T>(id, options ?? {}) as PouchDB.Core.GetMeta & PouchDB.Core.Document<T>;\n }\n\n async getCourseDocs<T extends SkuilderCourseData>(\n ids: string[],\n options: PouchDB.Core.AllDocsOptions = {}\n ): Promise<PouchDB.Core.AllDocsWithKeysResponse<{} & T>> {\n // Use this.db (local when available) for read operations.\n return await this.db.allDocs<T>({\n ...options,\n keys: ids,\n }) as PouchDB.Core.AllDocsWithKeysResponse<{} & T>;\n }\n\n ////////////////////////////////////\n // NavigationStrategyManager implementation\n ////////////////////////////////////\n\n getNavigationStrategy(id: string): Promise<ContentNavigationStrategyData> {\n logger.debug(`[courseDB] Getting navigation strategy: ${id}`);\n\n if (id == '') {\n const strategy: ContentNavigationStrategyData = {\n _id: 'NAVIGATION_STRATEGY-ELO',\n docType: DocType.NAVIGATION_STRATEGY,\n name: 'ELO',\n description: 'ELO-based navigation strategy for ordering content by difficulty',\n implementingClass: Navigators.ELO,\n course: this.id,\n serializedData: '', // serde is a noop for ELO navigator.\n };\n return Promise.resolve(strategy);\n } else {\n return this.db.get(id);\n }\n }\n\n async getAllNavigationStrategies(): Promise<ContentNavigationStrategyData[]> {\n const prefix = DocTypePrefixes[DocType.NAVIGATION_STRATEGY];\n const result = await this.db.allDocs<ContentNavigationStrategyData>({\n startkey: prefix,\n endkey: `${prefix}\\ufff0`,\n include_docs: true,\n });\n return result.rows.map((row) => row.doc!);\n }\n\n async addNavigationStrategy(data: ContentNavigationStrategyData): Promise<void> {\n logger.debug(`[courseDB] Adding navigation strategy: ${data._id}`);\n // Strategy set changed — drop the cached navigator so it rebuilds.\n this.invalidateNavigatorCache();\n // Admin write operation — use remote DB.\n return this.remoteDB.put(data).then(() => {});\n }\n updateNavigationStrategy(id: string, data: ContentNavigationStrategyData): Promise<void> {\n logger.debug(`[courseDB] Updating navigation strategy: ${id}`);\n // For now, just log the data and return success\n logger.debug(JSON.stringify(data));\n return Promise.resolve();\n }\n\n /**\n * Creates an instantiated navigator for this course.\n *\n * Handles multiple generators by wrapping them in CompositeGenerator.\n * This is the preferred method for getting a ready-to-use navigator.\n *\n * @param user - User database interface\n * @returns Instantiated ContentNavigator ready for use\n */\n async createNavigator(user: UserDBInterface): Promise<ContentNavigator> {\n try {\n const allStrategies = await this.getAllNavigationStrategies();\n\n if (allStrategies.length === 0) {\n // No strategies configured: use default Pipeline(Composite(ELO, SRS), [eloDistanceFilter])\n logger.debug(\n '[courseDB] No strategy documents found, using default Pipeline(Composite(ELO, SRS), [eloDistanceFilter])'\n );\n return createDefaultPipeline(user, this);\n }\n\n // Use PipelineAssembler to build a Pipeline from strategy documents\n const assembler = new PipelineAssembler();\n const { pipeline, generatorStrategies, filterStrategies, warnings } =\n await assembler.assemble({\n strategies: allStrategies,\n user,\n course: this,\n });\n\n // Log any warnings from assembly\n for (const warning of warnings) {\n logger.warn(`[PipelineAssembler] ${warning}`);\n }\n\n if (!pipeline) {\n // Assembly failed - fall back to default\n logger.debug('[courseDB] Pipeline assembly failed, using default pipeline');\n return createDefaultPipeline(user, this);\n }\n\n logger.debug(\n `[courseDB] Using assembled pipeline with ${generatorStrategies.length} generator(s) and ${filterStrategies.length} filter(s)`\n );\n return pipeline;\n } catch (e) {\n const msg = e instanceof Error ? `${e.message}\\n${e.stack}` : JSON.stringify(e);\n logger.error(`[courseDB] Error creating navigator: ${msg}`);\n throw e;\n }\n }\n\n ////////////////////////////////////\n // END NavigationStrategyManager implementation\n ////////////////////////////////////\n\n ////////////////////////////////////\n // StudyContentSource implementation\n ////////////////////////////////////\n\n /**\n * Get cards with suitability scores for presentation.\n *\n * This is the PRIMARY API for content sources going forward. Delegates to the\n * course's configured NavigationStrategy to get scored candidates.\n *\n * @param limit - Maximum number of cards to return\n * @returns Cards sorted by score descending\n */\n private _pendingHints: ReplanHints | null = null;\n\n /**\n * Session-scoped cache of the broad ELO-neighbor pool used by\n * getCardsCenteredAtELO. The `elo` view query re-indexes on first touch per\n * call (PouchDB 9 ignores `stale`), so without this each plan/replan pays\n * ~1.5-2s. The pool is fetched once and re-ranked against the live (roaming)\n * ELO in memory on subsequent calls.\n */\n private _eloPoolCache: {\n rows: (QualifiedCardID & { elo?: number })[];\n fetchedAt: number;\n /** The ELO the pool was fetched around. */\n centerElo: number;\n } | null = null;\n private readonly _eloPoolTtlMs = 5 * 60 * 1000;\n /**\n * How far the target may move from the pool's centre before the pool is\n * refetched. Well above a learner's in-session roam; a different learner (or\n * a far-off explicit ELO) on the same CourseDB gets a pool of their own.\n */\n private readonly _eloPoolMaxDrift = 200;\n\n /**\n * Cached assembled navigator (Pipeline). createNavigator() reads strategy\n * docs and builds a fresh Pipeline every call — whose internal `_tagCache`\n * and `_cachedOrchestration` are designed to make replans cheap but never\n * survive, because the instance is discarded each run. Caching it lets those\n * caches persist across plan/replan within a session (SessionController holds\n * one CourseDB instance for the session's lifetime). Rebuilt on user change,\n * TTL expiry, or explicit invalidation after a strategy-doc write.\n */\n private _cachedNavigator: {\n navigator: ContentNavigator;\n userId: string;\n builtAt: number;\n } | null = null;\n private readonly _navigatorTtlMs = 5 * 60 * 1000;\n\n public setEphemeralHints(hints: ReplanHints): void {\n this._pendingHints = hints;\n }\n\n /**\n * Forward a presentation to the navigator (a new card restarts its intake\n * clock). Builds the navigator if the cached one has expired.\n */\n public notePresented(card: { cardId: string; courseId: string; status: string }): void {\n if (card.status !== 'new') return;\n void this._getCurrentUser()\n .then((u) => this._getCachedNavigator(u))\n .then(({ navigator }) => (navigator as StudyContentSource).notePresented?.(card))\n .catch((e) => logger.warn(`[courseDB] Could not note a presentation: ${e}`));\n }\n\n public async getWeightedCards(limit: number): Promise<GeneratorResult> {\n const u = await this._getCurrentUser();\n\n try {\n // const tNav0 = performance.now(); // [perf] parked\n const { navigator } = await this._getCachedNavigator(u);\n // const tNav1 = performance.now(); // [perf] parked\n if (this._pendingHints) {\n navigator.setEphemeralHints(this._pendingHints);\n this._pendingHints = null;\n }\n const result = await navigator.getWeightedCards(limit);\n // const tRun = performance.now(); // [perf] parked\n // [perf] parked 2026-05 (pipeline-docs-workup) — uncomment to re-measure\n // logger.info(\n // `[perf][courseDB] getWeightedCards(limit=${limit}): ` +\n // `navigator=${(tNav1 - tNav0).toFixed(0)}ms(${navCache}) ` +\n // `pipelineRun=${(tRun - tNav1).toFixed(0)}ms ` +\n // `total=${(tRun - tNav0).toFixed(0)}ms`\n // );\n return result;\n } catch (e) {\n logger.error(`[courseDB] Error getting weighted cards: ${e}`);\n throw e;\n }\n }\n\n /**\n * Return the assembled navigator, reusing the cached instance when possible.\n * Reuse preserves the Pipeline's per-session caches (tags, orchestration\n * context) across replans, which is the dominant per-replan cost once the\n * ELO-pool cost is removed. Rebuilds on user change or TTL expiry.\n */\n private async _getCachedNavigator(\n user: UserDBInterface\n ): Promise<{ navigator: ContentNavigator; cacheStatus: 'hit' | 'miss' }> {\n const userId = user.getUsername();\n const now = Date.now();\n if (\n this._cachedNavigator &&\n this._cachedNavigator.userId === userId &&\n now - this._cachedNavigator.builtAt < this._navigatorTtlMs\n ) {\n return { navigator: this._cachedNavigator.navigator, cacheStatus: 'hit' };\n }\n const navigator = await this.createNavigator(user);\n this._cachedNavigator = { navigator, userId, builtAt: now };\n return { navigator, cacheStatus: 'miss' };\n }\n\n /**\n * Drop the cached navigator so the next getWeightedCards() rebuilds it.\n * Call after mutating this course's navigation strategy documents.\n */\n public invalidateNavigatorCache(): void {\n this._cachedNavigator = null;\n }\n\n public async getCardsCenteredAtELO(\n options: {\n limit: number;\n elo: 'user' | 'random' | number;\n } = {\n limit: 99,\n elo: 'user',\n },\n filter?: (a: QualifiedCardID) => boolean\n ): Promise<StudySessionItem[]> {\n // [perf] parked: getCardsCenteredAtELO rewrite banner\n // logger.info('[perf][run] getCardsCenteredAtELO rewrite (session pool cache + in-memory recenter)');\n // const tCelo0 = performance.now();\n let targetElo: number;\n\n if (options.elo === 'user') {\n const u = await this._getCurrentUser();\n\n targetElo = -1;\n try {\n const courseDoc = (await u.getCourseRegistrationsDoc()).courses.find((c) => {\n return c.courseID === this.id;\n })!;\n targetElo = EloToNumber(courseDoc.elo);\n } catch {\n targetElo = 1000;\n }\n } else if (options.elo === 'random') {\n const bounds = await GET_CACHED(`elo-bounds-${this.id}`, () => this.getELOBounds());\n targetElo = Math.round(bounds.low + Math.random() * (bounds.high - bounds.low));\n // logger.log(`Picked ${targetElo} from [${bounds.low}, ${bounds.high}]`);\n } else {\n targetElo = options.elo;\n }\n\n // const tReg = performance.now();\n\n // Broad neighbor pool fetched once per session and re-used. We over-fetch\n // (POOL_SIZE >> limit) so that the in-memory active-card filter and the\n // slowly-roaming ELO both have ample headroom before a refetch is needed.\n const POOL_SIZE = Math.max(2000, options.limit * 4);\n const nowMs = Date.now();\n let cacheStatus: 'hit' | 'miss' | 'refresh' = 'hit';\n\n if (\n !this._eloPoolCache ||\n nowMs - this._eloPoolCache.fetchedAt > this._eloPoolTtlMs ||\n Math.abs(targetElo - this._eloPoolCache.centerElo) > this._eloPoolMaxDrift\n ) {\n // MISS: pay the (reindexing) view query once, then cache the raw pool.\n // Guard: never cache an EMPTY pool. A cold-DB-open or sync-race fetch can\n // transiently return [], and caching it would starve the session for the\n // whole TTL. Leaving the cache untouched lets the next call retry.\n const fetched = await this.getCardsByELO(targetElo, POOL_SIZE);\n if (fetched.length > 0) {\n this._eloPoolCache = { rows: fetched, fetchedAt: nowMs, centerElo: targetElo };\n }\n cacheStatus = 'miss';\n }\n\n // Apply the (fresh) caller filter, then re-center against the *current* ELO.\n // Returns a new array each call — the cached pool is never mutated, and the\n // ranking reflects the live ELO even as it drifts within a session.\n const rankAgainstCurrentElo = (): (QualifiedCardID & { elo?: number })[] => {\n const raw = this._eloPoolCache?.rows ?? [];\n const survivors = filter ? raw.filter((c) => filter(c)) : raw;\n return survivors\n .map((c) => ({ ...c }))\n .sort(\n (a, b) =>\n Math.abs((a.elo ?? targetElo) - targetElo) -\n Math.abs((b.elo ?? targetElo) - targetElo)\n );\n };\n\n let cards = rankAgainstCurrentElo();\n\n // Refetch once if the pool can't satisfy the limit — either the active-card\n // filter has grown past pool coverage (hit), or the pool is missing because\n // a prior fetch came back empty (cold open / sync race). A miss that cached\n // a non-empty-but-small pool (genuinely small course) is left alone.\n if (cards.length < options.limit && (cacheStatus === 'hit' || !this._eloPoolCache)) {\n const fetched = await this.getCardsByELO(targetElo, POOL_SIZE);\n if (fetched.length > 0) {\n this._eloPoolCache = { rows: fetched, fetchedAt: nowMs, centerElo: targetElo };\n }\n cards = rankAgainstCurrentElo();\n cacheStatus = 'refresh';\n }\n\n // [perf] parked: centeredAtELO regDoc / pool-cache timing\n // logger.info(\n // `[perf][centeredAtELO] regDoc=${(tReg - tCelo0).toFixed(0)}ms ` +\n // `cache=${cacheStatus} build=${(performance.now() - tReg).toFixed(0)}ms ` +\n // `poolRaw=${this._eloPoolCache?.rows.length ?? 0} postFilter=${cards.length} ` +\n // `limit=${options.limit} targetElo=${targetElo}`\n // );\n\n const selectedCards: {\n courseID: string;\n cardID: string;\n elo?: number;\n }[] = [];\n\n while (selectedCards.length < options.limit && cards.length > 0) {\n const index = randIntWeightedTowardZero(cards.length);\n const card = cards.splice(index, 1)[0];\n selectedCards.push(card);\n }\n\n return selectedCards.map((c) => {\n return {\n courseID: this.id,\n cardID: c.cardID,\n contentSourceType: 'course',\n contentSourceID: this.id,\n elo: c.elo,\n status: 'new',\n };\n });\n }\n\n // Admin search methods\n public async searchCards(query: string): Promise<any[]> {\n logger.log(`[CourseDB ${this.id}] Searching for: \"${query}\"`);\n\n // Try multiple search approaches\n let displayableData;\n\n try {\n // Try regex search on the correct data structure: data[0].data\n displayableData = await this.db.find({\n selector: {\n docType: 'DISPLAYABLE_DATA',\n 'data.0.data': { $regex: `.*${query}.*` },\n },\n });\n logger.log(`[CourseDB ${this.id}] Regex search on data[0].data successful`);\n } catch (regexError) {\n logger.log(\n `[CourseDB ${this.id}] Regex search failed, falling back to manual search:`,\n regexError\n );\n\n // Fallback: get all displayable data and filter manually\n const allDisplayable = await this.db.find({\n selector: {\n docType: 'DISPLAYABLE_DATA',\n },\n });\n\n logger.log(\n `[CourseDB ${this.id}] Retrieved ${allDisplayable.docs.length} documents for manual filtering`\n );\n\n displayableData = {\n docs: allDisplayable.docs.filter((doc) => {\n // Search entire document as JSON string - inclusive approach for admin tool\n const docString = JSON.stringify(doc).toLowerCase();\n const match = docString.includes(query.toLowerCase());\n if (match) {\n logger.log(`[CourseDB ${this.id}] Manual match found in document: ${doc._id}`);\n }\n return match;\n }),\n };\n }\n\n logger.log(\n `[CourseDB ${this.id}] Found ${displayableData.docs.length} displayable data documents`\n );\n\n if (displayableData.docs.length === 0) {\n // Debug: Let's see what displayable data exists\n const allDisplayableData = await this.db.find({\n selector: {\n docType: 'DISPLAYABLE_DATA',\n },\n limit: 5, // Just sample a few\n });\n\n logger.log(\n `[CourseDB ${this.id}] Sample displayable data:`,\n allDisplayableData.docs.map((d) => ({\n id: d._id,\n docType: (d as any).docType,\n dataStructure: (d as any).data ? Object.keys((d as any).data) : 'no data field',\n dataContent: (d as any).data,\n fullDoc: d,\n }))\n );\n }\n\n const allResults: any[] = [];\n\n for (const dd of displayableData.docs) {\n const cards = await this.db.find({\n selector: {\n docType: 'CARD',\n id_displayable_data: { $in: [dd._id] },\n },\n });\n\n logger.log(\n `[CourseDB ${this.id}] Displayable data ${dd._id} linked to ${cards.docs.length} cards`\n );\n allResults.push(...cards.docs);\n }\n\n logger.log(`[CourseDB ${this.id}] Total cards found: ${allResults.length}`);\n return allResults;\n }\n\n public async find(\n request: PouchDB.Find.FindRequest<any>\n ): Promise<PouchDB.Find.FindResponse<any>> {\n return this.db.find(request);\n }\n}\n\n/**\n * Returns a list of registered datashapes for the specified\n * course.\n * @param courseID The ID of the course\n */\nexport async function getCourseDataShapes(courseID: string) {\n const cfg = await getCredentialledCourseConfig(courseID);\n return cfg!.dataShapes;\n}\n\nexport async function getCredentialledDataShapes(courseID: string) {\n const cfg = await getCredentialledCourseConfig(courseID);\n\n return cfg.dataShapes;\n}\n\nexport async function getCourseQuestionTypes(courseID: string) {\n const cfg = await getCredentialledCourseConfig(courseID);\n return cfg!.questionTypes;\n}\n\n// todo: this is actually returning full tag docs now.\n// - performance issue when tags have lots of\n// applied docs\n// - will require a computed couch DB view\nexport async function getCourseTagStubs(\n courseID: string\n): Promise<PouchDB.Core.AllDocsResponse<Tag>> {\n logger.debug(`Getting tag stubs for course: ${courseID}`);\n const stubs = await filterAllDocsByPrefix<Tag>(\n getCourseDB(courseID),\n DocType.TAG.valueOf() + '-'\n );\n\n stubs.rows.forEach((row) => {\n logger.debug(`\\tTag stub for doc: ${row.id}`);\n });\n\n return stubs;\n}\n\nexport async function deleteTag(courseID: string, tagName: string) {\n tagName = getTagID(tagName);\n const courseDB = getCourseDB(courseID);\n const doc = await courseDB.get<Tag>(DocType.TAG.valueOf() + '-' + tagName);\n const resp = await courseDB.remove(doc);\n return resp;\n}\n\nexport async function createTag(courseID: string, tagName: string, author: string) {\n logger.debug(`Creating tag: ${tagName}...`);\n const tagID = getTagID(tagName);\n const courseDB = getCourseDB(courseID);\n const resp = await courseDB.put<Tag>({\n course: courseID,\n docType: DocType.TAG,\n name: tagName,\n snippet: '',\n taggedCards: [],\n wiki: '',\n author,\n _id: tagID,\n });\n return resp;\n}\n\nexport async function updateTag(tag: Tag) {\n const prior = await getTag(tag.course, tag.name);\n return await getCourseDB(tag.course).put<Tag>({\n ...tag,\n _rev: prior._rev,\n });\n}\n\nexport async function getTag(courseID: string, tagName: string) {\n const tagID = getTagID(tagName);\n const courseDB = getCourseDB(courseID);\n return courseDB.get<Tag>(tagID);\n}\n\nexport async function removeTagFromCard(courseID: string, cardID: string, tagID: string) {\n // todo: possible future perf. hit if tags have large #s of taggedCards.\n // In this case, should be converted to a server-request\n tagID = getTagID(tagID);\n const courseDB = getCourseDB(courseID);\n const tag = await courseDB.get<Tag>(tagID);\n tag.taggedCards = tag.taggedCards.filter((taggedID) => {\n return cardID !== taggedID;\n });\n return courseDB.put<Tag>(tag);\n}\n\n/**\n * Returns an array of ancestor tag IDs, where:\n * return[0] = parent,\n * return[1] = grandparent,\n * return[2] = great grandparent,\n * etc.\n *\n * If ret is empty, the tag itself is a root\n */\nexport function getAncestorTagIDs(courseID: string, tagID: string): string[] {\n tagID = getTagID(tagID);\n const split = tagID.split('>');\n if (split.length === 1) {\n return [];\n } else {\n split.pop();\n const parent = split.join('>');\n return [parent].concat(getAncestorTagIDs(courseID, parent));\n }\n}\n\nexport async function getChildTagStubs(courseID: string, tagID: string) {\n return await filterAllDocsByPrefix(getCourseDB(courseID), tagID + '>');\n}\n\nexport async function getAppliedTags(id_course: string, id_card: string) {\n const db = getCourseDB(id_course);\n\n const result = await db.query<TagStub>('getTags', {\n startkey: id_card,\n endkey: id_card,\n // include_docs: true\n });\n\n // log(`getAppliedTags looked up: ${id_card}`);\n // log(`getAppliedTags returning: ${JSON.stringify(result)}`);\n\n return result;\n}\n\nexport async function updateCardElo(courseID: string, cardID: string, elo: CourseElo) {\n if (elo) {\n // checking against null, undefined, NaN\n const cDB = getCourseDB(courseID);\n const card = await cDB.get<CardData>(cardID);\n logger.debug(`Replacing ${JSON.stringify(card.elo)} with ${JSON.stringify(elo)}`);\n card.elo = elo;\n return cDB.put(card); // race conditions - is it important? probably not (net-zero effect)\n }\n}\n\nexport async function updateCredentialledCourseConfig(courseID: string, config: CourseConfig) {\n logger.debug(`Updating course config:\n\n${JSON.stringify(config)}\n`);\n\n const db = getCourseDB(courseID);\n const old = await getCredentialledCourseConfig(courseID);\n\n return await db.put<CourseConfig>({\n ...config,\n _rev: (old as any)._rev,\n });\n}\n\nfunction isSuccessRow<T>(\n row:\n | {\n key: PouchDB.Core.DocumentKey;\n error: 'not_found';\n }\n | {\n doc?: PouchDB.Core.ExistingDocument<PouchDB.Core.AllDocsMeta & T> | null | undefined;\n id: PouchDB.Core.DocumentId;\n key: PouchDB.Core.DocumentKey;\n value: {\n rev: PouchDB.Core.RevisionId;\n deleted?: boolean | undefined;\n };\n }\n): row is {\n doc?: PouchDB.Core.ExistingDocument<PouchDB.Core.AllDocsMeta & T> | null | undefined;\n id: PouchDB.Core.DocumentId;\n key: PouchDB.Core.DocumentKey;\n value: {\n rev: PouchDB.Core.RevisionId;\n deleted?: boolean | undefined;\n };\n} {\n return 'doc' in row && row.doc !== null && row.doc !== undefined;\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"courseDB.mjs","names":[],"sources":["../../../src/impl/couch/courseDB.ts"],"sourcesContent":["import { CourseDBInterface, CourseInfo, CoursesDBInterface, UserDBInterface } from '@db/core';\nimport type { GeneratorResult, ReplanHints } from '@db/core/navigators/generators/types';\nimport {\n CourseConfig,\n CourseElo,\n DataShape,\n EloToNumber,\n Status,\n blankCourseElo,\n toCourseElo,\n} from '@vue-skuilder/common';\n\nimport { filterAllDocsByPrefix, getCourseDB } from '.';\nimport UpdateQueue from './updateQueue';\nimport type { StudyContentSource } from '../../core/interfaces/contentSource';\nimport { StudySessionItem } from '../../core/interfaces/contentSource';\nimport {\n CardData,\n DocType,\n QualifiedCardID,\n SkuilderCourseData,\n Tag,\n TagStub,\n DocTypePrefixes,\n} from '../../core/types/types-legacy';\nimport { logger } from '../../util/logger';\nimport { GET_CACHED } from './clientCache';\nimport {\n addNote55,\n addTagToCard,\n getCredentialledCourseConfig,\n getTagID,\n invalidateCourseConfigCache,\n} from './courseAPI';\nimport { DataLayerResult } from '@db/core/types/db';\nimport { PouchError } from './types';\nimport CourseLookup from './courseLookupDB';\nimport { ContentNavigationStrategyData } from '@db/core/types/contentNavigationStrategy';\nimport { ContentNavigator, Navigators } from '@db/core/navigators';\nimport { PipelineAssembler } from '@db/core/navigators/PipelineAssembler';\nimport { createDefaultPipeline } from '@db/core/navigators/defaults';\n\nexport class CoursesDB implements CoursesDBInterface {\n _courseIDs: string[] | undefined;\n\n constructor(courseIDs?: string[]) {\n if (courseIDs && courseIDs.length > 0) {\n this._courseIDs = courseIDs;\n } else {\n this._courseIDs = undefined;\n }\n }\n\n public async getCourseList(): Promise<CourseConfig[]> {\n let crsList = await CourseLookup.allCourseWare();\n logger.debug(`AllCourses: ${crsList.map((c) => c.name + ', ' + c._id + '\\n\\t')}`);\n if (this._courseIDs) {\n crsList = crsList.filter((c) => this._courseIDs!.includes(c._id));\n }\n\n logger.debug(`AllCourses.filtered: ${crsList.map((c) => c.name + ', ' + c._id + '\\n\\t')}`);\n\n const cfgs = await Promise.all(\n crsList.map(async (c) => {\n try {\n const cfg = await getCredentialledCourseConfig(c._id);\n logger.debug(`Found cfg: ${JSON.stringify(cfg)}`);\n return cfg;\n } catch (e) {\n logger.warn(`Error fetching cfg for course ${c.name}, ${c._id}: ${e}`);\n return undefined;\n }\n })\n );\n return cfgs.filter((c) => !!c);\n }\n\n async getCourseConfig(courseId: string): Promise<CourseConfig> {\n if (this._courseIDs && this._courseIDs.length && !this._courseIDs.includes(courseId)) {\n throw new Error(`Course ${courseId} not in course list`);\n }\n\n const cfg = await getCredentialledCourseConfig(courseId);\n if (cfg === undefined) {\n throw new Error(`Error fetching cfg for course ${courseId}`);\n } else {\n return cfg;\n }\n }\n\n public async disambiguateCourse(courseId: string, disambiguator: string): Promise<void> {\n await CourseLookup.updateDisambiguator(courseId, disambiguator);\n }\n}\n\nfunction randIntWeightedTowardZero(n: number) {\n return Math.floor(Math.random() * Math.random() * Math.random() * n);\n}\n\nexport class CourseDB implements CourseDBInterface {\n // private log(msg: string): void {\n // log(`CourseLog: ${this.id}\\n ${msg}`);\n // }\n\n /**\n * Primary database handle used for all **read** operations (queries, gets).\n *\n * When local sync is active, this points to the local PouchDB replica for\n * fast, network-free reads. Otherwise it points to the remote CouchDB.\n */\n private db: PouchDB.Database;\n\n /**\n * Remote database handle used for all **write** operations.\n *\n * Always points to the remote CouchDB so that writes (ELO updates, tag\n * mutations, admin operations) aggregate on the server. The local replica\n * is a read-only snapshot that refreshes on the next page load.\n *\n * When local sync is NOT active, this is the same instance as `this.db`.\n */\n private remoteDB: PouchDB.Database;\n\n private id: string;\n private _getCurrentUser: () => Promise<UserDBInterface>;\n private updateQueue: UpdateQueue;\n\n /**\n * @param id - Course ID\n * @param userLookup - Async function returning the current user DB\n * @param localDB - Optional local PouchDB replica for reads. When provided,\n * `this.db` uses the local replica and `this.remoteDB` stays remote.\n * The UpdateQueue reads from remote and writes to remote (local `_rev`\n * values may be stale, so read-modify-write cycles must go through\n * the remote DB to avoid conflicts).\n */\n constructor(id: string, userLookup: () => Promise<UserDBInterface>, localDB?: PouchDB.Database) {\n this.id = id;\n const remote = getCourseDB(this.id);\n this.remoteDB = remote;\n this.db = localDB ?? remote;\n this._getCurrentUser = userLookup;\n // UpdateQueue always operates against the remote DB for its\n // read-modify-write cycle. Local _rev values may be stale (the local\n // replica is a snapshot), so conflict retries must read from remote.\n this.updateQueue = new UpdateQueue(this.remoteDB, this.remoteDB);\n }\n\n public getCourseID(): string {\n return this.id;\n }\n\n public async getCourseInfo(): Promise<CourseInfo> {\n const cardCount = (\n await this.db.find({\n selector: {\n docType: DocType.CARD,\n },\n limit: 1000,\n })\n ).docs.length;\n\n return {\n cardCount,\n registeredUsers: 0,\n };\n }\n\n public async getInexperiencedCards(limit: number = 2) {\n return (\n await this.db.query('cardsByInexperience', {\n limit,\n })\n ).rows.map((r) => {\n const ret = {\n courseId: this.id,\n cardId: r.id,\n count: r.key,\n elo: r.value,\n };\n return ret;\n });\n }\n\n public async getCardsByEloLimits(\n options: {\n low: number;\n high: number;\n limit: number;\n page: number;\n } = {\n low: 0,\n high: Number.MIN_SAFE_INTEGER,\n limit: 25,\n page: 0,\n }\n ) {\n return (\n await this.db.query('elo', {\n startkey: options.low,\n endkey: options.high,\n limit: options.limit,\n skip: options.limit * options.page,\n })\n ).rows.map((r) => {\n return `${this.id}-${r.id}-${r.key}`;\n });\n }\n public async getCardEloData(id: string[]): Promise<CourseElo[]> {\n const docs = await this.db.allDocs<CardData>({\n keys: id,\n include_docs: true,\n });\n const ret: CourseElo[] = [];\n docs.rows.forEach((r) => {\n // [ ] remove these ts-ignore directives.\n if (isSuccessRow(r)) {\n if (r.doc && r.doc.elo) {\n ret.push(toCourseElo(r.doc.elo));\n } else {\n logger.warn('no elo data for card: ' + r.id);\n ret.push(blankCourseElo());\n }\n } else {\n logger.warn('no elo data for card: ' + JSON.stringify(r));\n ret.push(blankCourseElo());\n }\n });\n return ret;\n }\n\n /**\n * Returns the lowest and highest `global` ELO ratings in the course\n */\n public async getELOBounds() {\n const [low, high] = await Promise.all([\n (\n await this.db.query('elo', {\n startkey: 0,\n limit: 1,\n include_docs: false,\n })\n ).rows[0].key,\n (\n await this.db.query('elo', {\n limit: 1,\n descending: true,\n startkey: 100_000,\n })\n ).rows[0].key,\n ]);\n\n return {\n low: low,\n high: high,\n };\n }\n\n public async removeCard(id: string) {\n // Admin operation — read and write both go through remote DB to ensure\n // we have the current _rev for the delete.\n const doc = await this.remoteDB.get<CardData>(id);\n if (!doc.docType || !(doc.docType === DocType.CARD)) {\n throw new Error(`failed to remove ${id} from course ${this.id}. id does not point to a card`);\n }\n\n // Remove card from all associated tags before deleting the card\n try {\n const appliedTags = await this.getAppliedTags(id);\n const results = await Promise.allSettled(\n appliedTags.rows.map(async (tagRow) => {\n const tagId = tagRow.id;\n await this.removeTagFromCard(id, tagId);\n })\n );\n\n // Log any individual tag cleanup failures\n results.forEach((result, index) => {\n if (result.status === 'rejected') {\n const tagId = appliedTags.rows[index].id;\n logger.error(`Failed to remove card ${id} from tag ${tagId}: ${result.reason}`);\n }\n });\n } catch (error) {\n logger.error(`Error removing card ${id} from tags: ${error}`);\n // Continue with card deletion even if tag cleanup fails\n }\n\n return this.remoteDB.remove(doc);\n }\n\n public async getCardDisplayableDataIDs(id: string[]) {\n logger.debug(id.join(', '));\n const cards = await this.db.allDocs<CardData>({\n keys: id,\n include_docs: true,\n });\n const ret: { [card: string]: string[] } = {};\n cards.rows.forEach((r) => {\n if (isSuccessRow(r)) {\n ret[r.id] = r.doc!.id_displayable_data;\n }\n });\n\n return ret;\n }\n\n async getCardsByELO(elo: number, cardLimit?: number) {\n elo = parseInt(elo as any);\n const limit = cardLimit ? cardLimit : 25;\n\n // const tQ0 = performance.now();\n // NOTE: `stale: 'update_after'` was tried here and removed — it gave no\n // measurable speedup (PouchDB 9 effectively ignores it for the reindex\n // cost) AND it can return an empty result on the first query after a cold\n // DB open (index not yet loaded), which then poisons the pool cache. The\n // session pool cache (see getCardsCenteredAtELO) is what removes the\n // per-run cost, so we read the view normally (always-fresh) here.\n const below: PouchDB.Query.Response<object> = await this.db.query('elo', {\n limit: Math.ceil(limit / 2),\n startkey: elo,\n descending: true,\n });\n // const tBelowQ = performance.now();\n\n const aboveLimit = limit - below.rows.length;\n\n const above: PouchDB.Query.Response<object> = await this.db.query('elo', {\n limit: aboveLimit,\n startkey: elo + 1,\n });\n // const tAbove = performance.now();\n // [perf] parked: getCardsByELO view-query timing (below/above split)\n // logger.info(\n // `[perf][getCardsByELO] reqLimit=${limit} ` +\n // `below=${(tBelowQ - tQ0).toFixed(0)}ms(${below.rows.length}r) ` +\n // `above=${(tAbove - tBelowQ).toFixed(0)}ms(${above.rows.length}r)`\n // );\n\n let cards = below.rows;\n cards = cards.concat(above.rows);\n\n const ret = cards\n .sort((a, b) => {\n const s = Math.abs(a.key - elo) - Math.abs(b.key - elo);\n if (s === 0) {\n return Math.random() - 0.5;\n } else {\n return s;\n }\n })\n .map((c) => {\n return {\n courseID: this.id,\n cardID: c.id,\n elo: c.key,\n };\n });\n\n const str = `below:\\n${below.rows.map((r) => `\\t${r.id}-${r.key}\\n`)}\n\nabove:\\n${above.rows.map((r) => `\\t${r.id}-${r.key}\\n`)}`;\n\n logger.debug(`Getting ${limit} cards centered around elo: ${elo}:\\n\\n` + str);\n\n return ret;\n }\n\n async getCourseConfig(): Promise<CourseConfig> {\n const ret = await getCredentialledCourseConfig(this.id);\n if (ret) {\n return ret;\n } else {\n throw new Error(`Course config not found for course ID: ${this.id}`);\n }\n }\n\n async updateCourseConfig(cfg: CourseConfig): Promise<PouchDB.Core.Response> {\n logger.debug(`Updating: ${JSON.stringify(cfg)}`);\n // write both to the course DB:\n try {\n return await updateCredentialledCourseConfig(this.id, cfg);\n } catch (error) {\n logger.error(`Error updating course config in course DB: ${error}`);\n throw error;\n }\n }\n\n async updateCardElo(cardId: string, elo: CourseElo): Promise<PouchDB.Core.Response> {\n if (!elo) {\n throw new Error(`Cannot update card elo with null or undefined value for card ID: ${cardId}`);\n }\n\n try {\n const result = await this.updateQueue.update<\n CardData & PouchDB.Core.GetMeta & PouchDB.Core.IdMeta\n >(cardId, (card) => {\n logger.debug(`Replacing ${JSON.stringify(card.elo)} with ${JSON.stringify(elo)}`);\n card.elo = elo;\n return card;\n });\n return { ok: true, id: cardId, rev: result._rev };\n } catch (error) {\n logger.error(`Failed to update card elo for card ID: ${cardId}`, error);\n throw new Error(`Failed to update card elo for card ID: ${cardId}`);\n }\n }\n\n async getAppliedTags(cardId: string): Promise<PouchDB.Query.Response<TagStub>> {\n // this.db: the local replica when one is ready (the module function is remote).\n return this.db.query<TagStub>('getTags', { startkey: cardId, endkey: cardId });\n }\n\n async getAppliedTagsBatch(cardIds: string[]): Promise<Map<string, string[]>> {\n if (cardIds.length === 0) {\n return new Map();\n }\n\n const result = await this.db.query<TagStub>('getTags', {\n keys: cardIds,\n include_docs: false,\n });\n\n const tagsByCard = new Map<string, string[]>();\n\n // Initialize all requested cards with empty arrays\n for (const cardId of cardIds) {\n tagsByCard.set(cardId, []);\n }\n\n // Populate from query results\n for (const row of result.rows) {\n const cardId = row.key as string;\n const tagName = row.value?.name;\n if (tagName && tagsByCard.has(cardId)) {\n tagsByCard.get(cardId)!.push(tagName);\n }\n }\n\n return tagsByCard;\n }\n\n async getAllCardIds(): Promise<string[]> {\n // Card `_id`s are minted as `<DocTypePrefixes[CARD]>-<...>` (see courseAPI),\n // i.e. the `c-` prefix \\u2014 for both framework-minted uuid ids (`c-<uuid>`) and\n // course-authored deterministic ids (e.g. LettersPractice's `c-intro-s-S`).\n //\n // The previous implementation hardcoded a `CARD-` prefix range, which never\n // matched any card and silently returned an EMPTY list, starving the only\n // callers (`forecast()` / `diagnoseCardSpace()`). Use the prefix const so\n // the range stays correct if the scheme ever changes.\n const prefix = `${DocTypePrefixes[DocType.CARD]}-`;\n const result = await this.db.allDocs({\n startkey: prefix,\n endkey: `${prefix}\\ufff0`,\n include_docs: false,\n });\n return result.rows.map((row) => row.id);\n }\n\n async addTagToCard(\n cardId: string,\n tagId: string,\n updateELO?: boolean\n ): Promise<PouchDB.Core.Response> {\n return await addTagToCard(\n this.id,\n cardId,\n tagId,\n (await this._getCurrentUser()).getUsername(),\n updateELO\n );\n }\n\n async removeTagFromCard(cardId: string, tagId: string): Promise<PouchDB.Core.Response> {\n return await removeTagFromCard(this.id, cardId, tagId);\n }\n\n async createTag(name: string, author: string): Promise<PouchDB.Core.Response> {\n return await createTag(this.id, name, author);\n }\n\n async getTag(tagId: string): Promise<PouchDB.Core.GetMeta & PouchDB.Core.Document<Tag>> {\n return await getTag(this.id, tagId);\n }\n\n async updateTag(tag: Tag): Promise<PouchDB.Core.Response> {\n if (tag.course !== this.id) {\n throw new Error(`Tag ${JSON.stringify(tag)} does not belong to course ${this.id}`);\n }\n\n return await updateTag(tag);\n }\n\n async getCourseTagStubs(): Promise<PouchDB.Core.AllDocsResponse<Tag>> {\n // this.db: the local replica when one is ready (the module function is remote).\n return filterAllDocsByPrefix<Tag>(this.db, DocType.TAG.valueOf() + '-');\n }\n\n async addNote(\n codeCourse: string,\n shape: DataShape,\n data: unknown,\n author: string,\n tags: string[],\n uploads?: { [key: string]: PouchDB.Core.FullAttachment },\n elo: CourseElo = blankCourseElo()\n ): Promise<DataLayerResult> {\n try {\n const resp = await addNote55(this.id, codeCourse, shape, data, author, tags, uploads, elo);\n if (resp.ok) {\n // Check if card creation failed (property added by addNote55)\n if ((resp as any).cardCreationFailed) {\n logger.warn(\n `[courseDB.addNote] Note added but card creation failed: ${\n (resp as any).cardCreationError\n }`\n );\n return {\n status: Status.error,\n message: `Note was added but no cards were created: ${(resp as any).cardCreationError}`,\n id: resp.id,\n };\n }\n return {\n status: Status.ok,\n message: '',\n id: resp.id,\n };\n } else {\n return {\n status: Status.error,\n message: 'Unexpected error adding note',\n };\n }\n } catch (e) {\n const err = e as PouchDB.Core.Error;\n logger.error(\n `[addNote] error ${err.name}\\n\\treason: ${err.reason}\\n\\tmessage: ${err.message}`\n );\n return {\n status: Status.error,\n message: `Error adding note to course. ${(e as PouchError).reason || err.message}`,\n };\n }\n }\n\n async getCourseDoc<T extends SkuilderCourseData>(\n id: string,\n options?: PouchDB.Core.GetOptions\n ): Promise<PouchDB.Core.GetMeta & PouchDB.Core.Document<T>> {\n // Use this.db (local when available) for read operations.\n // Falls back to the standalone helper (always remote) only if needed.\n return await this.db.get<T>(id, options ?? {}) as PouchDB.Core.GetMeta & PouchDB.Core.Document<T>;\n }\n\n async getCourseDocs<T extends SkuilderCourseData>(\n ids: string[],\n options: PouchDB.Core.AllDocsOptions = {}\n ): Promise<PouchDB.Core.AllDocsWithKeysResponse<{} & T>> {\n // Use this.db (local when available) for read operations.\n return await this.db.allDocs<T>({\n ...options,\n keys: ids,\n }) as PouchDB.Core.AllDocsWithKeysResponse<{} & T>;\n }\n\n ////////////////////////////////////\n // NavigationStrategyManager implementation\n ////////////////////////////////////\n\n getNavigationStrategy(id: string): Promise<ContentNavigationStrategyData> {\n logger.debug(`[courseDB] Getting navigation strategy: ${id}`);\n\n if (id == '') {\n const strategy: ContentNavigationStrategyData = {\n _id: 'NAVIGATION_STRATEGY-ELO',\n docType: DocType.NAVIGATION_STRATEGY,\n name: 'ELO',\n description: 'ELO-based navigation strategy for ordering content by difficulty',\n implementingClass: Navigators.ELO,\n course: this.id,\n serializedData: '', // serde is a noop for ELO navigator.\n };\n return Promise.resolve(strategy);\n } else {\n return this.db.get(id);\n }\n }\n\n async getAllNavigationStrategies(): Promise<ContentNavigationStrategyData[]> {\n const prefix = DocTypePrefixes[DocType.NAVIGATION_STRATEGY];\n const result = await this.db.allDocs<ContentNavigationStrategyData>({\n startkey: prefix,\n endkey: `${prefix}\\ufff0`,\n include_docs: true,\n });\n return result.rows.map((row) => row.doc!);\n }\n\n async addNavigationStrategy(data: ContentNavigationStrategyData): Promise<void> {\n logger.debug(`[courseDB] Adding navigation strategy: ${data._id}`);\n // Strategy set changed — drop the cached navigator so it rebuilds.\n this.invalidateNavigatorCache();\n // Admin write operation — use remote DB.\n return this.remoteDB.put(data).then(() => {});\n }\n updateNavigationStrategy(id: string, data: ContentNavigationStrategyData): Promise<void> {\n logger.debug(`[courseDB] Updating navigation strategy: ${id}`);\n // For now, just log the data and return success\n logger.debug(JSON.stringify(data));\n return Promise.resolve();\n }\n\n /**\n * Creates an instantiated navigator for this course.\n *\n * Handles multiple generators by wrapping them in CompositeGenerator.\n * This is the preferred method for getting a ready-to-use navigator.\n *\n * @param user - User database interface\n * @returns Instantiated ContentNavigator ready for use\n */\n async createNavigator(user: UserDBInterface): Promise<ContentNavigator> {\n try {\n const allStrategies = await this.getAllNavigationStrategies();\n\n if (allStrategies.length === 0) {\n // No strategies configured: use default Pipeline(Composite(ELO, SRS), [eloDistanceFilter])\n logger.debug(\n '[courseDB] No strategy documents found, using default Pipeline(Composite(ELO, SRS), [eloDistanceFilter])'\n );\n return createDefaultPipeline(user, this);\n }\n\n // Use PipelineAssembler to build a Pipeline from strategy documents\n const assembler = new PipelineAssembler();\n const { pipeline, generatorStrategies, filterStrategies, warnings } =\n await assembler.assemble({\n strategies: allStrategies,\n user,\n course: this,\n });\n\n // Log any warnings from assembly\n for (const warning of warnings) {\n logger.warn(`[PipelineAssembler] ${warning}`);\n }\n\n if (!pipeline) {\n // Assembly failed - fall back to default\n logger.debug('[courseDB] Pipeline assembly failed, using default pipeline');\n return createDefaultPipeline(user, this);\n }\n\n logger.debug(\n `[courseDB] Using assembled pipeline with ${generatorStrategies.length} generator(s) and ${filterStrategies.length} filter(s)`\n );\n return pipeline;\n } catch (e) {\n const msg = e instanceof Error ? `${e.message}\\n${e.stack}` : JSON.stringify(e);\n logger.error(`[courseDB] Error creating navigator: ${msg}`);\n throw e;\n }\n }\n\n ////////////////////////////////////\n // END NavigationStrategyManager implementation\n ////////////////////////////////////\n\n ////////////////////////////////////\n // StudyContentSource implementation\n ////////////////////////////////////\n\n /**\n * Get cards with suitability scores for presentation.\n *\n * This is the PRIMARY API for content sources going forward. Delegates to the\n * course's configured NavigationStrategy to get scored candidates.\n *\n * @param limit - Maximum number of cards to return\n * @returns Cards sorted by score descending\n */\n private _pendingHints: ReplanHints | null = null;\n\n /**\n * Session-scoped cache of the broad ELO-neighbor pool used by\n * getCardsCenteredAtELO. The `elo` view query re-indexes on first touch per\n * call (PouchDB 9 ignores `stale`), so without this each plan/replan pays\n * ~1.5-2s. The pool is fetched once and re-ranked against the live (roaming)\n * ELO in memory on subsequent calls.\n */\n private _eloPoolCache: {\n rows: (QualifiedCardID & { elo?: number })[];\n fetchedAt: number;\n /** The ELO the pool was fetched around. */\n centerElo: number;\n } | null = null;\n private readonly _eloPoolTtlMs = 5 * 60 * 1000;\n /**\n * How far the target may move from the pool's centre before the pool is\n * refetched. Well above a learner's in-session roam; a different learner (or\n * a far-off explicit ELO) on the same CourseDB gets a pool of their own.\n */\n private readonly _eloPoolMaxDrift = 200;\n\n /**\n * Cached assembled navigator (Pipeline). createNavigator() reads strategy\n * docs and builds a fresh Pipeline every call — whose internal `_tagCache`\n * and `_cachedOrchestration` are designed to make replans cheap but never\n * survive, because the instance is discarded each run. Caching it lets those\n * caches persist across plan/replan within a session (SessionController holds\n * one CourseDB instance for the session's lifetime). Rebuilt on user change,\n * TTL expiry, or explicit invalidation after a strategy-doc write.\n */\n private _cachedNavigator: {\n navigator: ContentNavigator;\n userId: string;\n builtAt: number;\n } | null = null;\n private readonly _navigatorTtlMs = 5 * 60 * 1000;\n\n public setEphemeralHints(hints: ReplanHints): void {\n this._pendingHints = hints;\n }\n\n /**\n * Forward a presentation to the navigator (a new card restarts its intake\n * clock). Builds the navigator if the cached one has expired.\n */\n public notePresented(card: { cardId: string; courseId: string; status: string }): void {\n if (card.status !== 'new') return;\n void this._getCurrentUser()\n .then((u) => this._getCachedNavigator(u))\n .then(({ navigator }) => (navigator as StudyContentSource).notePresented?.(card))\n .catch((e) => logger.warn(`[courseDB] Could not note a presentation: ${e}`));\n }\n\n public async getWeightedCards(limit: number): Promise<GeneratorResult> {\n const u = await this._getCurrentUser();\n\n try {\n // const tNav0 = performance.now(); // [perf] parked\n const { navigator } = await this._getCachedNavigator(u);\n // const tNav1 = performance.now(); // [perf] parked\n if (this._pendingHints) {\n navigator.setEphemeralHints(this._pendingHints);\n this._pendingHints = null;\n }\n const result = await navigator.getWeightedCards(limit);\n // const tRun = performance.now(); // [perf] parked\n // [perf] parked 2026-05 (pipeline-docs-workup) — uncomment to re-measure\n // logger.info(\n // `[perf][courseDB] getWeightedCards(limit=${limit}): ` +\n // `navigator=${(tNav1 - tNav0).toFixed(0)}ms(${navCache}) ` +\n // `pipelineRun=${(tRun - tNav1).toFixed(0)}ms ` +\n // `total=${(tRun - tNav0).toFixed(0)}ms`\n // );\n return result;\n } catch (e) {\n logger.error(`[courseDB] Error getting weighted cards: ${e}`);\n throw e;\n }\n }\n\n /**\n * Return the assembled navigator, reusing the cached instance when possible.\n * Reuse preserves the Pipeline's per-session caches (tags, orchestration\n * context) across replans, which is the dominant per-replan cost once the\n * ELO-pool cost is removed. Rebuilds on user change or TTL expiry.\n */\n private async _getCachedNavigator(\n user: UserDBInterface\n ): Promise<{ navigator: ContentNavigator; cacheStatus: 'hit' | 'miss' }> {\n const userId = user.getUsername();\n const now = Date.now();\n if (\n this._cachedNavigator &&\n this._cachedNavigator.userId === userId &&\n now - this._cachedNavigator.builtAt < this._navigatorTtlMs\n ) {\n return { navigator: this._cachedNavigator.navigator, cacheStatus: 'hit' };\n }\n const navigator = await this.createNavigator(user);\n this._cachedNavigator = { navigator, userId, builtAt: now };\n return { navigator, cacheStatus: 'miss' };\n }\n\n /**\n * Drop the cached navigator so the next getWeightedCards() rebuilds it.\n * Call after mutating this course's navigation strategy documents.\n */\n public invalidateNavigatorCache(): void {\n this._cachedNavigator = null;\n }\n\n public async getCardsCenteredAtELO(\n options: {\n limit: number;\n elo: 'user' | 'random' | number;\n } = {\n limit: 99,\n elo: 'user',\n },\n filter?: (a: QualifiedCardID) => boolean\n ): Promise<StudySessionItem[]> {\n // [perf] parked: getCardsCenteredAtELO rewrite banner\n // logger.info('[perf][run] getCardsCenteredAtELO rewrite (session pool cache + in-memory recenter)');\n // const tCelo0 = performance.now();\n let targetElo: number;\n\n if (options.elo === 'user') {\n const u = await this._getCurrentUser();\n\n targetElo = -1;\n try {\n const courseDoc = (await u.getCourseRegistrationsDoc()).courses.find((c) => {\n return c.courseID === this.id;\n })!;\n targetElo = EloToNumber(courseDoc.elo);\n } catch {\n targetElo = 1000;\n }\n } else if (options.elo === 'random') {\n const bounds = await GET_CACHED(`elo-bounds-${this.id}`, () => this.getELOBounds());\n targetElo = Math.round(bounds.low + Math.random() * (bounds.high - bounds.low));\n // logger.log(`Picked ${targetElo} from [${bounds.low}, ${bounds.high}]`);\n } else {\n targetElo = options.elo;\n }\n\n // const tReg = performance.now();\n\n // Broad neighbor pool fetched once per session and re-used. We over-fetch\n // (POOL_SIZE >> limit) so that the in-memory active-card filter and the\n // slowly-roaming ELO both have ample headroom before a refetch is needed.\n const POOL_SIZE = Math.max(2000, options.limit * 4);\n const nowMs = Date.now();\n let cacheStatus: 'hit' | 'miss' | 'refresh' = 'hit';\n\n if (\n !this._eloPoolCache ||\n nowMs - this._eloPoolCache.fetchedAt > this._eloPoolTtlMs ||\n Math.abs(targetElo - this._eloPoolCache.centerElo) > this._eloPoolMaxDrift\n ) {\n // MISS: pay the (reindexing) view query once, then cache the raw pool.\n // Guard: never cache an EMPTY pool. A cold-DB-open or sync-race fetch can\n // transiently return [], and caching it would starve the session for the\n // whole TTL. Leaving the cache untouched lets the next call retry.\n const fetched = await this.getCardsByELO(targetElo, POOL_SIZE);\n if (fetched.length > 0) {\n this._eloPoolCache = { rows: fetched, fetchedAt: nowMs, centerElo: targetElo };\n }\n cacheStatus = 'miss';\n }\n\n // Apply the (fresh) caller filter, then re-center against the *current* ELO.\n // Returns a new array each call — the cached pool is never mutated, and the\n // ranking reflects the live ELO even as it drifts within a session.\n const rankAgainstCurrentElo = (): (QualifiedCardID & { elo?: number })[] => {\n const raw = this._eloPoolCache?.rows ?? [];\n const survivors = filter ? raw.filter((c) => filter(c)) : raw;\n return survivors\n .map((c) => ({ ...c }))\n .sort(\n (a, b) =>\n Math.abs((a.elo ?? targetElo) - targetElo) -\n Math.abs((b.elo ?? targetElo) - targetElo)\n );\n };\n\n let cards = rankAgainstCurrentElo();\n\n // Refetch once if the pool can't satisfy the limit — either the active-card\n // filter has grown past pool coverage (hit), or the pool is missing because\n // a prior fetch came back empty (cold open / sync race). A miss that cached\n // a non-empty-but-small pool (genuinely small course) is left alone.\n if (cards.length < options.limit && (cacheStatus === 'hit' || !this._eloPoolCache)) {\n const fetched = await this.getCardsByELO(targetElo, POOL_SIZE);\n if (fetched.length > 0) {\n this._eloPoolCache = { rows: fetched, fetchedAt: nowMs, centerElo: targetElo };\n }\n cards = rankAgainstCurrentElo();\n cacheStatus = 'refresh';\n }\n\n // [perf] parked: centeredAtELO regDoc / pool-cache timing\n // logger.info(\n // `[perf][centeredAtELO] regDoc=${(tReg - tCelo0).toFixed(0)}ms ` +\n // `cache=${cacheStatus} build=${(performance.now() - tReg).toFixed(0)}ms ` +\n // `poolRaw=${this._eloPoolCache?.rows.length ?? 0} postFilter=${cards.length} ` +\n // `limit=${options.limit} targetElo=${targetElo}`\n // );\n\n const selectedCards: {\n courseID: string;\n cardID: string;\n elo?: number;\n }[] = [];\n\n while (selectedCards.length < options.limit && cards.length > 0) {\n const index = randIntWeightedTowardZero(cards.length);\n const card = cards.splice(index, 1)[0];\n selectedCards.push(card);\n }\n\n return selectedCards.map((c) => {\n return {\n courseID: this.id,\n cardID: c.cardID,\n contentSourceType: 'course',\n contentSourceID: this.id,\n elo: c.elo,\n status: 'new',\n };\n });\n }\n\n // Admin search methods\n public async searchCards(query: string): Promise<any[]> {\n logger.log(`[CourseDB ${this.id}] Searching for: \"${query}\"`);\n\n // Try multiple search approaches\n let displayableData;\n\n try {\n // Try regex search on the correct data structure: data[0].data\n displayableData = await this.db.find({\n selector: {\n docType: 'DISPLAYABLE_DATA',\n 'data.0.data': { $regex: `.*${query}.*` },\n },\n });\n logger.log(`[CourseDB ${this.id}] Regex search on data[0].data successful`);\n } catch (regexError) {\n logger.log(\n `[CourseDB ${this.id}] Regex search failed, falling back to manual search:`,\n regexError\n );\n\n // Fallback: get all displayable data and filter manually\n const allDisplayable = await this.db.find({\n selector: {\n docType: 'DISPLAYABLE_DATA',\n },\n });\n\n logger.log(\n `[CourseDB ${this.id}] Retrieved ${allDisplayable.docs.length} documents for manual filtering`\n );\n\n displayableData = {\n docs: allDisplayable.docs.filter((doc) => {\n // Search entire document as JSON string - inclusive approach for admin tool\n const docString = JSON.stringify(doc).toLowerCase();\n const match = docString.includes(query.toLowerCase());\n if (match) {\n logger.log(`[CourseDB ${this.id}] Manual match found in document: ${doc._id}`);\n }\n return match;\n }),\n };\n }\n\n logger.log(\n `[CourseDB ${this.id}] Found ${displayableData.docs.length} displayable data documents`\n );\n\n if (displayableData.docs.length === 0) {\n // Debug: Let's see what displayable data exists\n const allDisplayableData = await this.db.find({\n selector: {\n docType: 'DISPLAYABLE_DATA',\n },\n limit: 5, // Just sample a few\n });\n\n logger.log(\n `[CourseDB ${this.id}] Sample displayable data:`,\n allDisplayableData.docs.map((d) => ({\n id: d._id,\n docType: (d as any).docType,\n dataStructure: (d as any).data ? Object.keys((d as any).data) : 'no data field',\n dataContent: (d as any).data,\n fullDoc: d,\n }))\n );\n }\n\n const allResults: any[] = [];\n\n for (const dd of displayableData.docs) {\n const cards = await this.db.find({\n selector: {\n docType: 'CARD',\n id_displayable_data: { $in: [dd._id] },\n },\n });\n\n logger.log(\n `[CourseDB ${this.id}] Displayable data ${dd._id} linked to ${cards.docs.length} cards`\n );\n allResults.push(...cards.docs);\n }\n\n logger.log(`[CourseDB ${this.id}] Total cards found: ${allResults.length}`);\n return allResults;\n }\n\n public async find(\n request: PouchDB.Find.FindRequest<any>\n ): Promise<PouchDB.Find.FindResponse<any>> {\n return this.db.find(request);\n }\n}\n\n/**\n * Returns a list of registered datashapes for the specified\n * course.\n * @param courseID The ID of the course\n */\nexport async function getCourseDataShapes(courseID: string) {\n const cfg = await getCredentialledCourseConfig(courseID);\n return cfg!.dataShapes;\n}\n\nexport async function getCredentialledDataShapes(courseID: string) {\n const cfg = await getCredentialledCourseConfig(courseID);\n\n return cfg.dataShapes;\n}\n\nexport async function getCourseQuestionTypes(courseID: string) {\n const cfg = await getCredentialledCourseConfig(courseID);\n return cfg!.questionTypes;\n}\n\n// todo: this is actually returning full tag docs now.\n// - performance issue when tags have lots of\n// applied docs\n// - will require a computed couch DB view\nexport async function getCourseTagStubs(\n courseID: string\n): Promise<PouchDB.Core.AllDocsResponse<Tag>> {\n logger.debug(`Getting tag stubs for course: ${courseID}`);\n const stubs = await filterAllDocsByPrefix<Tag>(\n getCourseDB(courseID),\n DocType.TAG.valueOf() + '-'\n );\n\n stubs.rows.forEach((row) => {\n logger.debug(`\\tTag stub for doc: ${row.id}`);\n });\n\n return stubs;\n}\n\nexport async function deleteTag(courseID: string, tagName: string) {\n tagName = getTagID(tagName);\n const courseDB = getCourseDB(courseID);\n const doc = await courseDB.get<Tag>(DocType.TAG.valueOf() + '-' + tagName);\n const resp = await courseDB.remove(doc);\n return resp;\n}\n\nexport async function createTag(courseID: string, tagName: string, author: string) {\n logger.debug(`Creating tag: ${tagName}...`);\n const tagID = getTagID(tagName);\n const courseDB = getCourseDB(courseID);\n const resp = await courseDB.put<Tag>({\n course: courseID,\n docType: DocType.TAG,\n name: tagName,\n snippet: '',\n taggedCards: [],\n wiki: '',\n author,\n _id: tagID,\n });\n return resp;\n}\n\nexport async function updateTag(tag: Tag) {\n const prior = await getTag(tag.course, tag.name);\n return await getCourseDB(tag.course).put<Tag>({\n ...tag,\n _rev: prior._rev,\n });\n}\n\nexport async function getTag(courseID: string, tagName: string) {\n const tagID = getTagID(tagName);\n const courseDB = getCourseDB(courseID);\n return courseDB.get<Tag>(tagID);\n}\n\nexport async function removeTagFromCard(courseID: string, cardID: string, tagID: string) {\n // todo: possible future perf. hit if tags have large #s of taggedCards.\n // In this case, should be converted to a server-request\n tagID = getTagID(tagID);\n const courseDB = getCourseDB(courseID);\n const tag = await courseDB.get<Tag>(tagID);\n tag.taggedCards = tag.taggedCards.filter((taggedID) => {\n return cardID !== taggedID;\n });\n return courseDB.put<Tag>(tag);\n}\n\n/**\n * Returns an array of ancestor tag IDs, where:\n * return[0] = parent,\n * return[1] = grandparent,\n * return[2] = great grandparent,\n * etc.\n *\n * If ret is empty, the tag itself is a root\n */\nexport function getAncestorTagIDs(courseID: string, tagID: string): string[] {\n tagID = getTagID(tagID);\n const split = tagID.split('>');\n if (split.length === 1) {\n return [];\n } else {\n split.pop();\n const parent = split.join('>');\n return [parent].concat(getAncestorTagIDs(courseID, parent));\n }\n}\n\nexport async function getChildTagStubs(courseID: string, tagID: string) {\n return await filterAllDocsByPrefix(getCourseDB(courseID), tagID + '>');\n}\n\nexport async function getAppliedTags(id_course: string, id_card: string) {\n const db = getCourseDB(id_course);\n\n const result = await db.query<TagStub>('getTags', {\n startkey: id_card,\n endkey: id_card,\n // include_docs: true\n });\n\n // log(`getAppliedTags looked up: ${id_card}`);\n // log(`getAppliedTags returning: ${JSON.stringify(result)}`);\n\n return result;\n}\n\nexport async function updateCardElo(courseID: string, cardID: string, elo: CourseElo) {\n if (elo) {\n // checking against null, undefined, NaN\n const cDB = getCourseDB(courseID);\n const card = await cDB.get<CardData>(cardID);\n logger.debug(`Replacing ${JSON.stringify(card.elo)} with ${JSON.stringify(elo)}`);\n card.elo = elo;\n return cDB.put(card); // race conditions - is it important? probably not (net-zero effect)\n }\n}\n\nexport async function updateCredentialledCourseConfig(courseID: string, config: CourseConfig) {\n logger.debug(`Updating course config:\n\n${JSON.stringify(config)}\n`);\n\n const db = getCourseDB(courseID);\n invalidateCourseConfigCache(courseID);\n const old = await getCredentialledCourseConfig(courseID);\n\n try {\n return await db.put<CourseConfig>({\n ...config,\n _rev: (old as any)._rev,\n });\n } finally {\n invalidateCourseConfigCache(courseID);\n }\n}\n\nfunction isSuccessRow<T>(\n row:\n | {\n key: PouchDB.Core.DocumentKey;\n error: 'not_found';\n }\n | {\n doc?: PouchDB.Core.ExistingDocument<PouchDB.Core.AllDocsMeta & T> | null | undefined;\n id: PouchDB.Core.DocumentId;\n key: PouchDB.Core.DocumentKey;\n value: {\n rev: PouchDB.Core.RevisionId;\n deleted?: boolean | undefined;\n };\n }\n): row is {\n doc?: PouchDB.Core.ExistingDocument<PouchDB.Core.AllDocsMeta & T> | null | undefined;\n id: PouchDB.Core.DocumentId;\n key: PouchDB.Core.DocumentKey;\n value: {\n rev: PouchDB.Core.RevisionId;\n deleted?: boolean | undefined;\n };\n} {\n return 'doc' in row && row.doc !== null && row.doc !== undefined;\n}\n"],"mappings":"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"}