@vue-skuilder/db 0.3.0 → 0.3.2
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.
- package/dist/{contentSource-2zVmcjKA.d.ts → contentSource-CSI0pJ2D.d.ts} +10 -0
- package/dist/core/index.cjs +105 -36
- package/dist/core/index.cjs.map +1 -1
- package/dist/core/index.d.ts +3 -3
- package/dist/core/interfaces/contentSource.mjs.map +1 -1
- package/dist/core/navigators/Pipeline.mjs +7 -1
- package/dist/core/navigators/Pipeline.mjs.map +1 -1
- package/dist/core/navigators/filters/eloDistance.mjs +17 -2
- package/dist/core/navigators/filters/eloDistance.mjs.map +1 -1
- package/dist/core/navigators/generators/prescribed.mjs +20 -10
- package/dist/core/navigators/generators/prescribed.mjs.map +1 -1
- package/dist/core/navigators/index.mjs +2 -0
- package/dist/core/navigators/index.mjs.map +1 -1
- package/dist/core/versionStamps.mjs +1 -1
- package/dist/{dataLayerProvider-rGyLQ93v.d.ts → dataLayerProvider-D5n1gGc_.d.ts} +1 -1
- package/dist/diagnostics/index.d.ts +2 -2
- package/dist/impl/common/BaseUserDB.mjs +43 -21
- package/dist/impl/common/BaseUserDB.mjs.map +1 -1
- package/dist/impl/couch/courseDB.mjs +5 -0
- package/dist/impl/couch/courseDB.mjs.map +1 -1
- package/dist/impl/couch/index.cjs +80 -24
- package/dist/impl/couch/index.cjs.map +1 -1
- package/dist/impl/couch/index.d.ts +4 -2
- package/dist/impl/static/courseDB.mjs +5 -0
- package/dist/impl/static/courseDB.mjs.map +1 -1
- package/dist/impl/static/index.cjs +80 -24
- package/dist/impl/static/index.cjs.map +1 -1
- package/dist/impl/static/index.d.ts +4 -2
- package/dist/index.cjs +116 -37
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.ts +3 -3
- package/dist/study/SessionController.mjs +1 -0
- package/dist/study/SessionController.mjs.map +1 -1
- package/docs/session-lifecycle-and-replan.md +71 -58
- package/package.json +3 -3
- package/src/core/interfaces/contentSource.ts +7 -0
- package/src/core/navigators/Pipeline.ts +7 -0
- package/src/core/navigators/filters/eloDistance.ts +31 -2
- package/src/core/navigators/generators/prescribed.ts +56 -11
- package/src/core/navigators/generators/types.ts +3 -0
- package/src/core/navigators/index.ts +5 -0
- package/src/impl/common/BaseUserDB.ts +47 -25
- package/src/impl/couch/courseDB.ts +13 -0
- package/src/impl/static/courseDB.ts +13 -0
- package/src/study/SessionController.ts +3 -0
- package/tests/core/navigators/eloDistanceFilter.test.ts +15 -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 {\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 /** Reads go to this device's replica (perf marks report it as the session's binding). */\n public get readsLocal(): boolean {\n return this.db !== this.remoteDB;\n }\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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"}
|
|
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 /** Reads go to this device's replica (perf marks report it as the session's binding). */\n public get readsLocal(): boolean {\n return this.db !== this.remoteDB;\n }\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 private _sessionId: string | null = null;\n\n\n public setSessionId(sessionId: string): void {\n\n this._sessionId = sessionId;\n\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 if (this._sessionId) {\n navigator.setSessionId(this._sessionId);\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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"}
|
|
@@ -1296,6 +1296,9 @@ var init_navigators = __esm({
|
|
|
1296
1296
|
*/
|
|
1297
1297
|
setEphemeralHints(_hints) {
|
|
1298
1298
|
}
|
|
1299
|
+
/** See StudyContentSource.setSessionId. No-op for non-Pipeline navigators. */
|
|
1300
|
+
setSessionId(_sessionId) {
|
|
1301
|
+
}
|
|
1299
1302
|
};
|
|
1300
1303
|
}
|
|
1301
1304
|
});
|
|
@@ -2159,6 +2162,7 @@ var init_Pipeline = __esm({
|
|
|
2159
2162
|
* getWeightedCards() call, then cleared.
|
|
2160
2163
|
*/
|
|
2161
2164
|
_ephemeralHints = null;
|
|
2165
|
+
_sessionId;
|
|
2162
2166
|
/**
|
|
2163
2167
|
* The intake valve's clock (see regulators.ts), loaded from strategy state on
|
|
2164
2168
|
* first use and kept in memory. Writes are chained so a presentation and a
|
|
@@ -2194,6 +2198,10 @@ var init_Pipeline = __esm({
|
|
|
2194
2198
|
*
|
|
2195
2199
|
* Overrides ContentNavigator.setEphemeralHints() no-op.
|
|
2196
2200
|
*/
|
|
2201
|
+
/** See StudyContentSource.setSessionId. Carried into every run's context. */
|
|
2202
|
+
setSessionId(sessionId) {
|
|
2203
|
+
this._sessionId = sessionId;
|
|
2204
|
+
}
|
|
2197
2205
|
setEphemeralHints(hints) {
|
|
2198
2206
|
this._ephemeralHints = hints;
|
|
2199
2207
|
logger.info(`[Pipeline] Ephemeral hints set: ${JSON.stringify(hints)}`);
|
|
@@ -2641,7 +2649,8 @@ var init_Pipeline = __esm({
|
|
|
2641
2649
|
course: this.course,
|
|
2642
2650
|
userElo,
|
|
2643
2651
|
...userCourseElo ? { userCourseElo } : {},
|
|
2644
|
-
orchestration
|
|
2652
|
+
orchestration,
|
|
2653
|
+
...this._sessionId ? { sessionId: this._sessionId } : {}
|
|
2645
2654
|
};
|
|
2646
2655
|
}
|
|
2647
2656
|
/**
|
|
@@ -4290,6 +4299,9 @@ var init_BaseUserDB = __esm({
|
|
|
4290
4299
|
// Database to use for write operations (local-first approach)
|
|
4291
4300
|
updateQueue;
|
|
4292
4301
|
_hydration = { state: "not-required" };
|
|
4302
|
+
/** See scanScheduledCards. Bumped by every write to scheduled reviews. */
|
|
4303
|
+
_scheduledScan = null;
|
|
4304
|
+
_scheduledGeneration = 0;
|
|
4293
4305
|
/** In-flight hydration, so concurrent callers can wait for a real answer. */
|
|
4294
4306
|
_hydrationPromise = null;
|
|
4295
4307
|
/**
|
|
@@ -4534,18 +4546,38 @@ Currently logged-in as ${this._username}.`
|
|
|
4534
4546
|
*
|
|
4535
4547
|
*/
|
|
4536
4548
|
async getActiveCards() {
|
|
4549
|
+
return (await this.scanScheduledCards()).map((doc) => ({
|
|
4550
|
+
courseID: doc.courseId,
|
|
4551
|
+
cardID: doc.cardId
|
|
4552
|
+
}));
|
|
4553
|
+
}
|
|
4554
|
+
/**
|
|
4555
|
+
* The user's scheduled reviews (`card_review_*`), all of them: one `allDocs`
|
|
4556
|
+
* scan shared by concurrent readers. A pipeline run's generators start
|
|
4557
|
+
* together (`CompositeGenerator`), and each used to scan the range itself
|
|
4558
|
+
* (`getActiveCards` from ELO and Prescribed, `getReviewstoDate` from SRS).
|
|
4559
|
+
* Sharing only an in-flight scan keeps reads as fresh as before; a schedule
|
|
4560
|
+
* or removal of a review starts a new scan for anyone reading after it.
|
|
4561
|
+
* Docs are shared between callers: copy before mutating.
|
|
4562
|
+
*/
|
|
4563
|
+
scanScheduledCards() {
|
|
4564
|
+
const inFlight = this._scheduledScan;
|
|
4565
|
+
if (inFlight && inFlight.generation === this._scheduledGeneration) return inFlight.scan;
|
|
4537
4566
|
const keys = getStartAndEndKeys(DocTypePrefixes["SCHEDULED_CARD" /* SCHEDULED_CARD */]);
|
|
4538
|
-
const
|
|
4539
|
-
|
|
4540
|
-
|
|
4541
|
-
|
|
4542
|
-
|
|
4543
|
-
|
|
4544
|
-
|
|
4545
|
-
|
|
4546
|
-
|
|
4547
|
-
|
|
4548
|
-
|
|
4567
|
+
const entry = {
|
|
4568
|
+
generation: this._scheduledGeneration,
|
|
4569
|
+
scan: this.remoteDB.allDocs({
|
|
4570
|
+
startkey: keys.startkey,
|
|
4571
|
+
endkey: keys.endkey,
|
|
4572
|
+
include_docs: true
|
|
4573
|
+
}).then((res) => res.rows.map((row) => row.doc))
|
|
4574
|
+
};
|
|
4575
|
+
this._scheduledScan = entry;
|
|
4576
|
+
const done = () => {
|
|
4577
|
+
if (this._scheduledScan === entry) this._scheduledScan = null;
|
|
4578
|
+
};
|
|
4579
|
+
entry.scan.then(done, done);
|
|
4580
|
+
return entry.scan;
|
|
4549
4581
|
}
|
|
4550
4582
|
async getActivityRecords() {
|
|
4551
4583
|
try {
|
|
@@ -4611,28 +4643,23 @@ Currently logged-in as ${this._username}.`
|
|
|
4611
4643
|
}
|
|
4612
4644
|
}
|
|
4613
4645
|
async getReviewstoDate(targetDate, course_id) {
|
|
4614
|
-
const
|
|
4615
|
-
const reviews = await this.remoteDB.allDocs({
|
|
4616
|
-
startkey: keys.startkey,
|
|
4617
|
-
endkey: keys.endkey,
|
|
4618
|
-
include_docs: true
|
|
4619
|
-
});
|
|
4646
|
+
const reviews = await this.scanScheduledCards();
|
|
4620
4647
|
log3(
|
|
4621
4648
|
`Fetching ${this._username}'s scheduled reviews${course_id ? ` for course ${course_id}` : ""}.`
|
|
4622
4649
|
);
|
|
4623
|
-
return reviews.
|
|
4624
|
-
if (
|
|
4650
|
+
return reviews.filter((doc) => {
|
|
4651
|
+
if (doc._id.startsWith(DocTypePrefixes["SCHEDULED_CARD" /* SCHEDULED_CARD */])) {
|
|
4625
4652
|
const date = import_moment5.default.utc(
|
|
4626
|
-
|
|
4653
|
+
doc._id.substr(DocTypePrefixes["SCHEDULED_CARD" /* SCHEDULED_CARD */].length),
|
|
4627
4654
|
REVIEW_TIME_FORMAT
|
|
4628
4655
|
);
|
|
4629
4656
|
if (targetDate.isAfter(date)) {
|
|
4630
|
-
if (course_id === void 0 ||
|
|
4657
|
+
if (course_id === void 0 || doc.courseId === course_id) {
|
|
4631
4658
|
return true;
|
|
4632
4659
|
}
|
|
4633
4660
|
}
|
|
4634
4661
|
}
|
|
4635
|
-
}).map((
|
|
4662
|
+
}).map((doc) => ({ ...doc }));
|
|
4636
4663
|
}
|
|
4637
4664
|
async getReviewsForcast(daysCount, course_id) {
|
|
4638
4665
|
const time = import_moment5.default.utc().add(daysCount, "days");
|
|
@@ -5103,6 +5130,7 @@ Currently logged-in as ${this._username}.`
|
|
|
5103
5130
|
const deletePromises = duplicateDocIds.map(async (docId) => {
|
|
5104
5131
|
try {
|
|
5105
5132
|
const doc = await this.remoteDB.get(docId);
|
|
5133
|
+
this._scheduledGeneration++;
|
|
5106
5134
|
await this.writeDB.remove(doc);
|
|
5107
5135
|
log3(`Successfully removed duplicate review: ${docId}`);
|
|
5108
5136
|
} catch (error) {
|
|
@@ -5248,9 +5276,11 @@ Currently logged-in as ${this._username}.`
|
|
|
5248
5276
|
}
|
|
5249
5277
|
}
|
|
5250
5278
|
async scheduleCardReview(review) {
|
|
5279
|
+
this._scheduledGeneration++;
|
|
5251
5280
|
return scheduleCardReviewLocal(this.writeDB, review);
|
|
5252
5281
|
}
|
|
5253
5282
|
async removeScheduledCardReview(reviewId) {
|
|
5283
|
+
this._scheduledGeneration++;
|
|
5254
5284
|
return removeScheduledCardReviewLocal(this.writeDB, reviewId);
|
|
5255
5285
|
}
|
|
5256
5286
|
async registerForClassroom(_classId, _registerAs) {
|
|
@@ -6248,6 +6278,9 @@ var init_srs = __esm({
|
|
|
6248
6278
|
});
|
|
6249
6279
|
|
|
6250
6280
|
// src/core/navigators/filters/eloDistance.ts
|
|
6281
|
+
function isIntroCard(card) {
|
|
6282
|
+
return (card.tags ?? []).some((t) => (0, import_common11.tagRole)(t) === "intro");
|
|
6283
|
+
}
|
|
6251
6284
|
function computeMultiplier(distance, halfLife, minMultiplier, maxMultiplier) {
|
|
6252
6285
|
const normalizedDistance = distance / halfLife;
|
|
6253
6286
|
const decay = Math.exp(-(normalizedDistance * normalizedDistance));
|
|
@@ -6315,7 +6348,7 @@ async function applyEloDistance(cards, context, config, source) {
|
|
|
6315
6348
|
const { course, userElo, userCourseElo } = context;
|
|
6316
6349
|
const { halfLife, minMultiplier, maxMultiplier } = config;
|
|
6317
6350
|
const tagAware = (config.tagAware || multiDimElo) && userCourseElo !== void 0;
|
|
6318
|
-
const missing = cards.filter((c) => tagAware || c.cardElo === void 0).map((c) => c.cardId);
|
|
6351
|
+
const missing = cards.filter((c) => !isIntroCard(c) && (tagAware || c.cardElo === void 0)).map((c) => c.cardId);
|
|
6319
6352
|
const fetched = /* @__PURE__ */ new Map();
|
|
6320
6353
|
if (missing.length > 0) {
|
|
6321
6354
|
const elos = await course.getCardEloData(missing);
|
|
@@ -6324,6 +6357,22 @@ async function applyEloDistance(cards, context, config, source) {
|
|
|
6324
6357
|
});
|
|
6325
6358
|
}
|
|
6326
6359
|
return cards.map((card) => {
|
|
6360
|
+
if (isIntroCard(card)) {
|
|
6361
|
+
return {
|
|
6362
|
+
...card,
|
|
6363
|
+
provenance: [
|
|
6364
|
+
...card.provenance,
|
|
6365
|
+
{
|
|
6366
|
+
strategy: "eloDistance",
|
|
6367
|
+
strategyName: source.name,
|
|
6368
|
+
strategyId: source.strategyId,
|
|
6369
|
+
action: "passed",
|
|
6370
|
+
score: card.score,
|
|
6371
|
+
reason: "intro card: ELO is a placeholder, distance not applied \u2192 1.00x"
|
|
6372
|
+
}
|
|
6373
|
+
]
|
|
6374
|
+
};
|
|
6375
|
+
}
|
|
6327
6376
|
const full = fetched.get(card.cardId);
|
|
6328
6377
|
const cardElo = full?.global?.score ?? card.cardElo ?? DEFAULT_CARD_ELO;
|
|
6329
6378
|
let distance = Math.abs(cardElo - userElo);
|
|
@@ -7316,6 +7365,10 @@ ${e.stack}` : JSON.stringify(e);
|
|
|
7316
7365
|
setEphemeralHints(hints) {
|
|
7317
7366
|
this._pendingHints = hints;
|
|
7318
7367
|
}
|
|
7368
|
+
_sessionId = null;
|
|
7369
|
+
setSessionId(sessionId) {
|
|
7370
|
+
this._sessionId = sessionId;
|
|
7371
|
+
}
|
|
7319
7372
|
/**
|
|
7320
7373
|
* Forward a presentation to the navigator (a new card restarts its intake
|
|
7321
7374
|
* clock). Builds the navigator if the cached one has expired.
|
|
@@ -7332,6 +7385,9 @@ ${e.stack}` : JSON.stringify(e);
|
|
|
7332
7385
|
navigator2.setEphemeralHints(this._pendingHints);
|
|
7333
7386
|
this._pendingHints = null;
|
|
7334
7387
|
}
|
|
7388
|
+
if (this._sessionId) {
|
|
7389
|
+
navigator2.setSessionId(this._sessionId);
|
|
7390
|
+
}
|
|
7335
7391
|
const result = await navigator2.getWeightedCards(limit);
|
|
7336
7392
|
return result;
|
|
7337
7393
|
} catch (e) {
|