@vue-skuilder/db 0.2.37 → 0.3.0
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-D_E7JaxR.d.ts → contentSource-2zVmcjKA.d.ts} +6 -1
- package/dist/core/index.cjs +112 -78
- package/dist/core/index.cjs.map +1 -1
- package/dist/core/index.d.ts +5 -5
- package/dist/core/navigators/Pipeline.mjs +8 -0
- package/dist/core/navigators/Pipeline.mjs.map +1 -1
- package/dist/core/versionStamps.mjs +1 -1
- package/dist/{dataLayerProvider-BDshhSp_.d.ts → dataLayerProvider-rGyLQ93v.d.ts} +1 -1
- package/dist/diagnostics/index.d.ts +3 -3
- package/dist/impl/common/BaseUserDB.mjs +18 -13
- package/dist/impl/common/BaseUserDB.mjs.map +1 -1
- package/dist/impl/couch/CourseSyncService.mjs +23 -1
- package/dist/impl/couch/CourseSyncService.mjs.map +1 -1
- package/dist/impl/couch/courseDB.mjs +4 -0
- package/dist/impl/couch/courseDB.mjs.map +1 -1
- package/dist/impl/couch/index.cjs +134 -79
- package/dist/impl/couch/index.cjs.map +1 -1
- package/dist/impl/couch/index.d.ts +5 -3
- package/dist/impl/couch/updateQueue.mjs +69 -46
- package/dist/impl/couch/updateQueue.mjs.map +1 -1
- package/dist/impl/static/index.cjs +108 -78
- package/dist/impl/static/index.cjs.map +1 -1
- package/dist/impl/static/index.d.ts +4 -4
- package/dist/{index-BLDpFYG3.d.ts → index-C745YB_6.d.ts} +1 -1
- package/dist/index.cjs +144 -80
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.ts +23 -10
- package/dist/index.mjs +2 -1
- package/dist/study/SessionController.mjs +4 -0
- package/dist/study/SessionController.mjs.map +1 -1
- package/dist/{types-DChCz22D.d.ts → types-DF0JuPbs.d.ts} +1 -1
- package/dist/{types-legacy-fT5Y1Wuy.d.ts → types-legacy-DdVjg81H.d.ts} +1 -1
- package/dist/util/packer/index.d.ts +3 -3
- package/dist/util/perfMarks.mjs +30 -0
- package/dist/util/perfMarks.mjs.map +1 -0
- package/package.json +3 -3
- package/src/core/interfaces/courseDB.ts +6 -0
- package/src/core/navigators/Pipeline.ts +8 -0
- package/src/impl/common/BaseUserDB.ts +27 -21
- package/src/impl/couch/CourseSyncService.ts +19 -2
- package/src/impl/couch/courseDB.ts +5 -0
- package/src/impl/couch/updateQueue.ts +86 -82
- package/src/study/SessionController.ts +4 -0
- package/src/util/index.ts +1 -0
- package/src/util/perfMarks.ts +35 -0
- package/tests/impl/updateQueue.test.ts +57 -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 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 * 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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"}
|
|
@@ -1472,8 +1472,10 @@ var init_updateQueue = __esm({
|
|
|
1472
1472
|
init_logger();
|
|
1473
1473
|
UpdateQueue = class extends Loggable {
|
|
1474
1474
|
_className = "UpdateQueue";
|
|
1475
|
-
|
|
1476
|
-
|
|
1475
|
+
/** Updates not yet taken by a write, per doc. */
|
|
1476
|
+
pending = /* @__PURE__ */ new Map();
|
|
1477
|
+
/** Docs with a drain loop running. */
|
|
1478
|
+
draining = /* @__PURE__ */ new Set();
|
|
1477
1479
|
readDB;
|
|
1478
1480
|
// Database for read operations
|
|
1479
1481
|
writeDB;
|
|
@@ -1491,6 +1493,9 @@ var init_updateQueue = __esm({
|
|
|
1491
1493
|
* **Error Handling Pattern:**
|
|
1492
1494
|
* - This method does NOT create documents if they don't exist
|
|
1493
1495
|
* - Callers are responsible for handling 404 errors and creating documents
|
|
1496
|
+
* - A rejected update is dropped from the queue: a caller that creates the
|
|
1497
|
+
* doc after a 404 has already applied its change and must not see it
|
|
1498
|
+
* re-applied by a later update to the same doc
|
|
1494
1499
|
* - This design maintains separation of concerns (UpdateQueue handles conflicts, callers handle lifecycle)
|
|
1495
1500
|
*
|
|
1496
1501
|
* @example
|
|
@@ -1507,12 +1512,16 @@ var init_updateQueue = __esm({
|
|
|
1507
1512
|
*/
|
|
1508
1513
|
update(id, update) {
|
|
1509
1514
|
logger.debug(`Update requested on doc: ${id}`);
|
|
1510
|
-
|
|
1511
|
-
this.
|
|
1512
|
-
|
|
1513
|
-
|
|
1514
|
-
|
|
1515
|
-
|
|
1515
|
+
return new Promise((resolve, reject) => {
|
|
1516
|
+
const queue = this.pending.get(id) ?? [];
|
|
1517
|
+
queue.push({
|
|
1518
|
+
update,
|
|
1519
|
+
resolve,
|
|
1520
|
+
reject
|
|
1521
|
+
});
|
|
1522
|
+
this.pending.set(id, queue);
|
|
1523
|
+
if (!this.draining.has(id)) void this.drain(id);
|
|
1524
|
+
});
|
|
1516
1525
|
}
|
|
1517
1526
|
constructor(readDB, writeDB) {
|
|
1518
1527
|
super();
|
|
@@ -1523,64 +1532,56 @@ var init_updateQueue = __esm({
|
|
|
1523
1532
|
logger.debug(`db info: ${JSON.stringify(i)}`);
|
|
1524
1533
|
});
|
|
1525
1534
|
}
|
|
1526
|
-
|
|
1527
|
-
|
|
1528
|
-
|
|
1529
|
-
|
|
1530
|
-
|
|
1535
|
+
/** Writes the doc's queued updates, batch by batch, until none are left. */
|
|
1536
|
+
async drain(id) {
|
|
1537
|
+
this.draining.add(id);
|
|
1538
|
+
try {
|
|
1539
|
+
let batch;
|
|
1540
|
+
while ((batch = this.pending.get(id)) && batch.length > 0) {
|
|
1541
|
+
this.pending.delete(id);
|
|
1542
|
+
try {
|
|
1543
|
+
const doc = await this.write(
|
|
1544
|
+
id,
|
|
1545
|
+
batch.map((p) => p.update)
|
|
1546
|
+
);
|
|
1547
|
+
batch.forEach((p) => p.resolve(doc));
|
|
1548
|
+
} catch (e) {
|
|
1549
|
+
batch.forEach((p) => p.reject(e));
|
|
1550
|
+
}
|
|
1531
1551
|
}
|
|
1532
|
-
|
|
1533
|
-
|
|
1534
|
-
|
|
1535
|
-
|
|
1536
|
-
|
|
1537
|
-
|
|
1538
|
-
|
|
1539
|
-
|
|
1540
|
-
|
|
1541
|
-
|
|
1542
|
-
|
|
1543
|
-
|
|
1544
|
-
|
|
1545
|
-
|
|
1546
|
-
|
|
1547
|
-
|
|
1548
|
-
|
|
1549
|
-
|
|
1550
|
-
|
|
1551
|
-
|
|
1552
|
-
|
|
1553
|
-
|
|
1554
|
-
|
|
1555
|
-
|
|
1556
|
-
|
|
1557
|
-
|
|
1558
|
-
|
|
1559
|
-
|
|
1560
|
-
|
|
1561
|
-
} catch (e) {
|
|
1562
|
-
if (e.name === "conflict" && i < MAX_RETRIES - 1) {
|
|
1563
|
-
logger.warn(`Conflict on update for doc ${id}, retry #${i + 1}`);
|
|
1564
|
-
await new Promise((res) => setTimeout(res, 50 * Math.random()));
|
|
1565
|
-
} else if (e.name === "not_found" && i === 0) {
|
|
1566
|
-
logger.warn(`Update failed for ${id} - does not exist. Throwing to caller.`);
|
|
1567
|
-
delete this.inprogressUpdates[id];
|
|
1568
|
-
throw e;
|
|
1569
|
-
} else {
|
|
1570
|
-
delete this.inprogressUpdates[id];
|
|
1571
|
-
if (this.pendingUpdates[id]) {
|
|
1572
|
-
delete this.pendingUpdates[id];
|
|
1573
|
-
}
|
|
1574
|
-
logger.error(`Error on attemped update (retry ${i}): ${JSON.stringify(e)}`);
|
|
1575
|
-
throw e;
|
|
1576
|
-
}
|
|
1577
|
-
}
|
|
1552
|
+
} finally {
|
|
1553
|
+
this.draining.delete(id);
|
|
1554
|
+
}
|
|
1555
|
+
}
|
|
1556
|
+
/** One read-apply-put of `updates`, retried on conflict against a fresh read. */
|
|
1557
|
+
async write(id, updates) {
|
|
1558
|
+
logger.debug(`Applying ${updates.length} update(s) on doc: ${id}`);
|
|
1559
|
+
const MAX_RETRIES = 5;
|
|
1560
|
+
for (let i = 0; i < MAX_RETRIES; i++) {
|
|
1561
|
+
try {
|
|
1562
|
+
const doc = await this.readDB.get(id);
|
|
1563
|
+
let updatedDoc = {
|
|
1564
|
+
...doc
|
|
1565
|
+
};
|
|
1566
|
+
for (const update of updates) {
|
|
1567
|
+
updatedDoc = typeof update === "function" ? { ...updatedDoc, ...update(updatedDoc) } : { ...updatedDoc, ...update };
|
|
1568
|
+
}
|
|
1569
|
+
const res = await this.writeDB.put(updatedDoc);
|
|
1570
|
+
return { ...updatedDoc, _rev: res.rev };
|
|
1571
|
+
} catch (e) {
|
|
1572
|
+
if (e.name === "conflict" && i < MAX_RETRIES - 1) {
|
|
1573
|
+
logger.warn(`Conflict on update for doc ${id}, retry #${i + 1}`);
|
|
1574
|
+
await new Promise((res) => setTimeout(res, 50 * Math.random()));
|
|
1575
|
+
} else if (e.name === "not_found" && i === 0) {
|
|
1576
|
+
logger.warn(`Update failed for ${id} - does not exist. Throwing to caller.`);
|
|
1577
|
+
throw e;
|
|
1578
|
+
} else {
|
|
1579
|
+
logger.error(`Error on attemped update (retry ${i}): ${JSON.stringify(e)}`);
|
|
1580
|
+
throw e;
|
|
1578
1581
|
}
|
|
1579
|
-
throw new Error(`UpdateQueue failed for doc ${id} after ${MAX_RETRIES} retries.`);
|
|
1580
|
-
} else {
|
|
1581
|
-
throw new Error(`Empty Updates Queue Triggered`);
|
|
1582
1582
|
}
|
|
1583
1583
|
}
|
|
1584
|
+
throw new Error(`UpdateQueue failed for doc ${id} after ${MAX_RETRIES} retries.`);
|
|
1584
1585
|
}
|
|
1585
1586
|
};
|
|
1586
1587
|
}
|
|
@@ -1885,6 +1886,29 @@ var init_dataDirectory = __esm({
|
|
|
1885
1886
|
}
|
|
1886
1887
|
});
|
|
1887
1888
|
|
|
1889
|
+
// src/util/perfMarks.ts
|
|
1890
|
+
function perfMark(name, detail) {
|
|
1891
|
+
try {
|
|
1892
|
+
globalThis.performance?.mark(name, detail ? { detail } : void 0);
|
|
1893
|
+
} catch {
|
|
1894
|
+
}
|
|
1895
|
+
}
|
|
1896
|
+
function perfMeasure(name, start, end, detail) {
|
|
1897
|
+
try {
|
|
1898
|
+
globalThis.performance?.measure(name, {
|
|
1899
|
+
start,
|
|
1900
|
+
...end !== void 0 ? { end } : {},
|
|
1901
|
+
...detail ? { detail } : {}
|
|
1902
|
+
});
|
|
1903
|
+
} catch {
|
|
1904
|
+
}
|
|
1905
|
+
}
|
|
1906
|
+
var init_perfMarks = __esm({
|
|
1907
|
+
"src/util/perfMarks.ts"() {
|
|
1908
|
+
"use strict";
|
|
1909
|
+
}
|
|
1910
|
+
});
|
|
1911
|
+
|
|
1888
1912
|
// src/core/navigators/regulators.ts
|
|
1889
1913
|
function clamp01(x) {
|
|
1890
1914
|
return Math.min(1, Math.max(0, x));
|
|
@@ -2099,6 +2123,7 @@ var init_Pipeline = __esm({
|
|
|
2099
2123
|
import_common3 = require("@vue-skuilder/common");
|
|
2100
2124
|
init_navigators();
|
|
2101
2125
|
init_logger();
|
|
2126
|
+
init_perfMarks();
|
|
2102
2127
|
init_orchestration();
|
|
2103
2128
|
init_PipelineDebugger();
|
|
2104
2129
|
init_diversityRerank();
|
|
@@ -2302,6 +2327,13 @@ var init_Pipeline = __esm({
|
|
|
2302
2327
|
logger.info(
|
|
2303
2328
|
`[Pipeline:timing] total=${(tFilter - t0).toFixed(0)}ms (context=${(tContext - t0).toFixed(0)} generate=${(tGenerate - tContext).toFixed(0)} hydrate=${(tHydrate - tGenerate).toFixed(0)} filter=${(tFilter - tHydrate).toFixed(0)})`
|
|
2304
2329
|
);
|
|
2330
|
+
perfMeasure("sk:pipeline-run", t0, tFilter, {
|
|
2331
|
+
context: Math.round(tContext - t0),
|
|
2332
|
+
generate: Math.round(tGenerate - tContext),
|
|
2333
|
+
hydrate: Math.round(tHydrate - tGenerate),
|
|
2334
|
+
filter: Math.round(tFilter - tHydrate),
|
|
2335
|
+
binding: this.course?.readsLocal === void 0 ? "unknown" : this.course.readsLocal ? "local" : "remote"
|
|
2336
|
+
});
|
|
2305
2337
|
const topScores = result.slice(0, 3).map((c) => c.score);
|
|
2306
2338
|
logExecutionSummary(
|
|
2307
2339
|
this.generator.name,
|
|
@@ -4984,22 +5016,20 @@ Currently logged-in as ${this._username}.`
|
|
|
4984
5016
|
async putCardRecord(record) {
|
|
4985
5017
|
const cardHistoryID = getCardHistoryID(record.courseID, record.cardID);
|
|
4986
5018
|
record.timeStamp = import_moment5.default.utc(record.timeStamp).toString();
|
|
4987
|
-
|
|
4988
|
-
|
|
4989
|
-
|
|
4990
|
-
|
|
4991
|
-
|
|
4992
|
-
|
|
4993
|
-
|
|
4994
|
-
|
|
4995
|
-
|
|
4996
|
-
|
|
4997
|
-
|
|
4998
|
-
|
|
4999
|
-
|
|
5000
|
-
|
|
5001
|
-
}
|
|
5002
|
-
);
|
|
5019
|
+
const append = (h) => {
|
|
5020
|
+
h.records.push(record);
|
|
5021
|
+
h.bestInterval = h.bestInterval || 0;
|
|
5022
|
+
if (areQuestionRecords(h)) {
|
|
5023
|
+
h.lapses = getLapses(h.records);
|
|
5024
|
+
h.streak = getStreak(h.records);
|
|
5025
|
+
} else {
|
|
5026
|
+
h.lapses = h.lapses || 0;
|
|
5027
|
+
h.streak = h.streak || 0;
|
|
5028
|
+
}
|
|
5029
|
+
return h;
|
|
5030
|
+
};
|
|
5031
|
+
const appendToExisting = async () => {
|
|
5032
|
+
const cardHistory = await this.update(cardHistoryID, append);
|
|
5003
5033
|
cardHistory.records = cardHistory.records.map((record2) => {
|
|
5004
5034
|
const ret = {
|
|
5005
5035
|
...record2
|
|
@@ -5008,6 +5038,9 @@ Currently logged-in as ${this._username}.`
|
|
|
5008
5038
|
return ret;
|
|
5009
5039
|
});
|
|
5010
5040
|
return cardHistory;
|
|
5041
|
+
};
|
|
5042
|
+
try {
|
|
5043
|
+
return await appendToExisting();
|
|
5011
5044
|
} catch (e) {
|
|
5012
5045
|
const reason = e;
|
|
5013
5046
|
if (reason.status === 404) {
|
|
@@ -5024,6 +5057,9 @@ Currently logged-in as ${this._username}.`
|
|
|
5024
5057
|
const putResult = await this.writeDB.put(initCardHistory);
|
|
5025
5058
|
return { ...initCardHistory, _rev: putResult.rev };
|
|
5026
5059
|
} catch (creationError) {
|
|
5060
|
+
if (creationError.name === "conflict") {
|
|
5061
|
+
return appendToExisting();
|
|
5062
|
+
}
|
|
5027
5063
|
throw new Error(
|
|
5028
5064
|
`Failed to create CardHistory for ${cardHistoryID}. Reason: ${creationError}`
|
|
5029
5065
|
);
|
|
@@ -6836,6 +6872,10 @@ var init_courseDB2 = __esm({
|
|
|
6836
6872
|
* values may be stale, so read-modify-write cycles must go through
|
|
6837
6873
|
* the remote DB to avoid conflicts).
|
|
6838
6874
|
*/
|
|
6875
|
+
/** Reads go to this device's replica (perf marks report it as the session's binding). */
|
|
6876
|
+
get readsLocal() {
|
|
6877
|
+
return this.db !== this.remoteDB;
|
|
6878
|
+
}
|
|
6839
6879
|
constructor(id, userLookup, localDB) {
|
|
6840
6880
|
this.id = id;
|
|
6841
6881
|
const remote = getCourseDB(this.id);
|
|
@@ -7862,6 +7902,7 @@ var init_CourseSyncService = __esm({
|
|
|
7862
7902
|
init_pouchdb_setup();
|
|
7863
7903
|
init_couch();
|
|
7864
7904
|
init_logger();
|
|
7905
|
+
init_perfMarks();
|
|
7865
7906
|
SYNC_MARKER_ID = "_local/sk-course-sync-complete";
|
|
7866
7907
|
DEFAULT_REPLICATION = {
|
|
7867
7908
|
batchSize: 1e3,
|
|
@@ -7960,6 +8001,7 @@ var init_CourseSyncService = __esm({
|
|
|
7960
8001
|
entry.localDB = localDB;
|
|
7961
8002
|
entry.status = { state: "ready" };
|
|
7962
8003
|
entry.readyPromise = null;
|
|
8004
|
+
perfMark("sk:course-sync-ready", { courseId, from: "marker" });
|
|
7963
8005
|
logger.info(
|
|
7964
8006
|
`[CourseSyncService] Using this device's replica of course ${courseId}; refreshing in the background`
|
|
7965
8007
|
);
|
|
@@ -8002,6 +8044,12 @@ var init_CourseSyncService = __esm({
|
|
|
8002
8044
|
syncTimeMs,
|
|
8003
8045
|
viewWarmTimeMs
|
|
8004
8046
|
};
|
|
8047
|
+
perfMark("sk:course-sync-refreshed", {
|
|
8048
|
+
courseId,
|
|
8049
|
+
docs: result.docs_written,
|
|
8050
|
+
syncTimeMs,
|
|
8051
|
+
viewWarmTimeMs
|
|
8052
|
+
});
|
|
8005
8053
|
logger.info(
|
|
8006
8054
|
`[CourseSyncService] Background refresh of course ${courseId}: ${result.docs_written} docs in ${syncTimeMs}ms, views ${viewWarmTimeMs}ms`
|
|
8007
8055
|
);
|
|
@@ -8102,6 +8150,11 @@ var init_CourseSyncService = __esm({
|
|
|
8102
8150
|
);
|
|
8103
8151
|
const result = await this.replicate(remoteDB, localDB);
|
|
8104
8152
|
const syncTimeMs = Date.now() - syncStart;
|
|
8153
|
+
perfMark("sk:course-sync-replicated", {
|
|
8154
|
+
courseId,
|
|
8155
|
+
docs: result.docs_written,
|
|
8156
|
+
ms: syncTimeMs
|
|
8157
|
+
});
|
|
8105
8158
|
logger.info(
|
|
8106
8159
|
`[CourseSyncService] Replication complete for course ${courseId}: ${result.docs_written} docs in ${syncTimeMs}ms`
|
|
8107
8160
|
);
|
|
@@ -8119,6 +8172,7 @@ var init_CourseSyncService = __esm({
|
|
|
8119
8172
|
syncTimeMs,
|
|
8120
8173
|
viewWarmTimeMs
|
|
8121
8174
|
};
|
|
8175
|
+
perfMark("sk:course-sync-ready", { courseId, from: "sync", viewWarmTimeMs });
|
|
8122
8176
|
} catch (e) {
|
|
8123
8177
|
const errorMsg = e instanceof Error ? e.message : String(e);
|
|
8124
8178
|
logger.error(
|
|
@@ -8206,7 +8260,8 @@ var init_CourseSyncService = __esm({
|
|
|
8206
8260
|
try {
|
|
8207
8261
|
localEpoch = await localDB.get("db-epoch");
|
|
8208
8262
|
} catch {
|
|
8209
|
-
|
|
8263
|
+
const info = await localDB.info();
|
|
8264
|
+
return info.doc_count > 0 || !!info.update_seq;
|
|
8210
8265
|
}
|
|
8211
8266
|
return remoteEpoch.epoch !== localEpoch.epoch;
|
|
8212
8267
|
} catch {
|