@vue-skuilder/db 0.2.35 → 0.2.37

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (263) hide show
  1. package/CLAUDE.md +15 -4
  2. package/build.entries.mjs +12 -0
  3. package/dist/_virtual/_rolldown/runtime.mjs +8 -0
  4. package/dist/{contentSource-BteiDpxH.d.ts → contentSource-D_E7JaxR.d.ts} +1 -1
  5. package/dist/core/UserDBDebugger.mjs +285 -0
  6. package/dist/core/UserDBDebugger.mjs.map +1 -0
  7. package/dist/core/bulkImport/cardProcessor.mjs +106 -0
  8. package/dist/core/bulkImport/cardProcessor.mjs.map +1 -0
  9. package/dist/core/{index.js → index.cjs} +6413 -7738
  10. package/dist/core/index.cjs.map +1 -0
  11. package/dist/core/index.d.ts +5 -5
  12. package/dist/core/index.mjs +20 -11368
  13. package/dist/core/interfaces/contentSource.mjs +20 -0
  14. package/dist/core/interfaces/contentSource.mjs.map +1 -0
  15. package/dist/core/navigators/Pipeline.mjs +723 -0
  16. package/dist/core/navigators/Pipeline.mjs.map +1 -0
  17. package/dist/core/navigators/PipelineAssembler.mjs +86 -0
  18. package/dist/core/navigators/PipelineAssembler.mjs.map +1 -0
  19. package/dist/core/navigators/PipelineDebugger.mjs +771 -0
  20. package/dist/core/navigators/PipelineDebugger.mjs.map +1 -0
  21. package/dist/core/navigators/SrsDebugger.mjs +34 -0
  22. package/dist/core/navigators/SrsDebugger.mjs.map +1 -0
  23. package/dist/core/navigators/StrategyPressureDebugger.mjs +19 -0
  24. package/dist/core/navigators/StrategyPressureDebugger.mjs.map +1 -0
  25. package/dist/core/navigators/defaults.mjs +96 -0
  26. package/dist/core/navigators/defaults.mjs.map +1 -0
  27. package/dist/core/navigators/diversityRerank.mjs +85 -0
  28. package/dist/core/navigators/diversityRerank.mjs.map +1 -0
  29. package/dist/core/navigators/filters/WeightedFilter.mjs +81 -0
  30. package/dist/core/navigators/filters/WeightedFilter.mjs.map +1 -0
  31. package/dist/core/navigators/filters/eloDistance.mjs +244 -0
  32. package/dist/core/navigators/filters/eloDistance.mjs.map +1 -0
  33. package/dist/core/navigators/filters/hierarchyDefinition.mjs +235 -0
  34. package/dist/core/navigators/filters/hierarchyDefinition.mjs.map +1 -0
  35. package/dist/core/navigators/filters/interferenceMitigator.mjs +201 -0
  36. package/dist/core/navigators/filters/interferenceMitigator.mjs.map +1 -0
  37. package/dist/core/navigators/filters/relativePriority.mjs +135 -0
  38. package/dist/core/navigators/filters/relativePriority.mjs.map +1 -0
  39. package/dist/core/navigators/filters/userTagPreference.mjs +101 -0
  40. package/dist/core/navigators/filters/userTagPreference.mjs.map +1 -0
  41. package/dist/core/navigators/generators/CompositeGenerator.mjs +203 -0
  42. package/dist/core/navigators/generators/CompositeGenerator.mjs.map +1 -0
  43. package/dist/core/navigators/generators/elo.mjs +77 -0
  44. package/dist/core/navigators/generators/elo.mjs.map +1 -0
  45. package/dist/core/navigators/generators/prescribed.mjs +694 -0
  46. package/dist/core/navigators/generators/prescribed.mjs.map +1 -0
  47. package/dist/core/navigators/generators/srs.mjs +158 -0
  48. package/dist/core/navigators/generators/srs.mjs.map +1 -0
  49. package/dist/core/navigators/index.mjs +345 -0
  50. package/dist/core/navigators/index.mjs.map +1 -0
  51. package/dist/core/navigators/pipelinePlan.mjs +109 -0
  52. package/dist/core/navigators/pipelinePlan.mjs.map +1 -0
  53. package/dist/core/navigators/regulators.mjs +128 -0
  54. package/dist/core/navigators/regulators.mjs.map +1 -0
  55. package/dist/core/orchestration/gradient.mjs +101 -0
  56. package/dist/core/orchestration/gradient.mjs.map +1 -0
  57. package/dist/core/orchestration/index.mjs +115 -0
  58. package/dist/core/orchestration/index.mjs.map +1 -0
  59. package/dist/core/orchestration/learning.mjs +140 -0
  60. package/dist/core/orchestration/learning.mjs.map +1 -0
  61. package/dist/core/orchestration/recording.mjs +64 -0
  62. package/dist/core/orchestration/recording.mjs.map +1 -0
  63. package/dist/core/orchestration/signal.mjs +40 -0
  64. package/dist/core/orchestration/signal.mjs.map +1 -0
  65. package/dist/core/types/contentNavigationStrategy.mjs +10 -0
  66. package/dist/core/types/contentNavigationStrategy.mjs.map +1 -0
  67. package/dist/core/types/hydration.mjs +13 -0
  68. package/dist/core/types/hydration.mjs.map +1 -0
  69. package/dist/core/types/strategyState.mjs +16 -0
  70. package/dist/core/types/strategyState.mjs.map +1 -0
  71. package/dist/core/types/studySession.mjs +14 -0
  72. package/dist/core/types/studySession.mjs.map +1 -0
  73. package/dist/core/types/types-legacy.mjs +44 -0
  74. package/dist/core/types/types-legacy.mjs.map +1 -0
  75. package/dist/core/util/index.mjs +31 -0
  76. package/dist/core/util/index.mjs.map +1 -0
  77. package/dist/core/versionStamps.mjs +46 -0
  78. package/dist/core/versionStamps.mjs.map +1 -0
  79. package/dist/courseConfigRegistration.mjs +306 -0
  80. package/dist/courseConfigRegistration.mjs.map +1 -0
  81. package/dist/{dataLayerProvider-C_QWzHf-.d.ts → dataLayerProvider-BDshhSp_.d.ts} +1 -1
  82. package/dist/diagnostics/dataset.mjs +118 -0
  83. package/dist/diagnostics/dataset.mjs.map +1 -0
  84. package/dist/diagnostics/derive.mjs +318 -0
  85. package/dist/diagnostics/derive.mjs.map +1 -0
  86. package/dist/diagnostics/{index.js → index.cjs} +1 -1
  87. package/dist/diagnostics/index.d.ts +3 -3
  88. package/dist/diagnostics/index.mjs +7 -1042
  89. package/dist/diagnostics/loader.mjs +151 -0
  90. package/dist/diagnostics/loader.mjs.map +1 -0
  91. package/dist/diagnostics/pipeline.mjs +161 -0
  92. package/dist/diagnostics/pipeline.mjs.map +1 -0
  93. package/dist/diagnostics/tagElo.mjs +177 -0
  94. package/dist/diagnostics/tagElo.mjs.map +1 -0
  95. package/dist/diagnostics/text.mjs +174 -0
  96. package/dist/diagnostics/text.mjs.map +1 -0
  97. package/dist/factory.mjs +70 -0
  98. package/dist/factory.mjs.map +1 -0
  99. package/dist/impl/common/BaseUserDB.mjs +1115 -0
  100. package/dist/impl/common/BaseUserDB.mjs.map +1 -0
  101. package/dist/impl/common/userDBHelpers.mjs +49 -0
  102. package/dist/impl/common/userDBHelpers.mjs.map +1 -0
  103. package/dist/impl/common/userDBKeys.mjs +45 -0
  104. package/dist/impl/common/userDBKeys.mjs.map +1 -0
  105. package/dist/impl/couch/CouchDBSyncStrategy.mjs +272 -0
  106. package/dist/impl/couch/CouchDBSyncStrategy.mjs.map +1 -0
  107. package/dist/impl/couch/CourseSyncService.mjs +320 -0
  108. package/dist/impl/couch/CourseSyncService.mjs.map +1 -0
  109. package/dist/impl/couch/PouchDataLayerProvider.mjs +89 -0
  110. package/dist/impl/couch/PouchDataLayerProvider.mjs.map +1 -0
  111. package/dist/impl/couch/adminDB.mjs +61 -0
  112. package/dist/impl/couch/adminDB.mjs.map +1 -0
  113. package/dist/impl/couch/auth.mjs +33 -0
  114. package/dist/impl/couch/auth.mjs.map +1 -0
  115. package/dist/impl/couch/classroomDB.mjs +227 -0
  116. package/dist/impl/couch/classroomDB.mjs.map +1 -0
  117. package/dist/impl/couch/clientCache.mjs +15 -0
  118. package/dist/impl/couch/clientCache.mjs.map +1 -0
  119. package/dist/impl/couch/courseAPI.mjs +197 -0
  120. package/dist/impl/couch/courseAPI.mjs.map +1 -0
  121. package/dist/impl/couch/courseDB.mjs +735 -0
  122. package/dist/impl/couch/courseDB.mjs.map +1 -0
  123. package/dist/impl/couch/courseLookupDB.mjs +94 -0
  124. package/dist/impl/couch/courseLookupDB.mjs.map +1 -0
  125. package/dist/impl/couch/{index.js → index.cjs} +7003 -10358
  126. package/dist/impl/couch/index.cjs.map +1 -0
  127. package/dist/impl/couch/index.d.ts +33 -5
  128. package/dist/impl/couch/index.mjs +152 -12147
  129. package/dist/impl/couch/index.mjs.map +1 -1
  130. package/dist/impl/couch/pouchdb-setup.mjs +15 -0
  131. package/dist/impl/couch/pouchdb-setup.mjs.map +1 -0
  132. package/dist/impl/couch/updateQueue.mjs +101 -0
  133. package/dist/impl/couch/updateQueue.mjs.map +1 -0
  134. package/dist/impl/couch/user-course-relDB.mjs +55 -0
  135. package/dist/impl/couch/user-course-relDB.mjs.map +1 -0
  136. package/dist/impl/static/NoOpSyncStrategy.mjs +49 -0
  137. package/dist/impl/static/NoOpSyncStrategy.mjs.map +1 -0
  138. package/dist/impl/static/StaticDataLayerProvider.mjs +94 -0
  139. package/dist/impl/static/StaticDataLayerProvider.mjs.map +1 -0
  140. package/dist/impl/static/StaticDataUnpacker.mjs +311 -0
  141. package/dist/impl/static/StaticDataUnpacker.mjs.map +1 -0
  142. package/dist/impl/static/courseDB.mjs +368 -0
  143. package/dist/impl/static/courseDB.mjs.map +1 -0
  144. package/dist/impl/static/coursesDB.mjs +38 -0
  145. package/dist/impl/static/coursesDB.mjs.map +1 -0
  146. package/dist/impl/static/{index.js → index.cjs} +2486 -5993
  147. package/dist/impl/static/index.cjs.map +1 -0
  148. package/dist/impl/static/index.d.ts +4 -4
  149. package/dist/impl/static/index.mjs +6 -10741
  150. package/dist/{index-C745YB_6.d.ts → index-BLDpFYG3.d.ts} +1 -1
  151. package/dist/{index.js → index.cjs} +14190 -14249
  152. package/dist/index.cjs.map +1 -0
  153. package/dist/index.d.ts +12 -23
  154. package/dist/index.mjs +38 -16937
  155. package/dist/pouch/{index.js → index.cjs} +5 -1
  156. package/dist/pouch/index.cjs.map +1 -0
  157. package/dist/pouch/index.mjs +2 -19
  158. package/dist/study/ItemQueue.mjs +95 -0
  159. package/dist/study/ItemQueue.mjs.map +1 -0
  160. package/dist/study/MixerDebugger.mjs +303 -0
  161. package/dist/study/MixerDebugger.mjs.map +1 -0
  162. package/dist/study/SessionController.mjs +1187 -0
  163. package/dist/study/SessionController.mjs.map +1 -0
  164. package/dist/study/SessionDebugger.mjs +271 -0
  165. package/dist/study/SessionDebugger.mjs.map +1 -0
  166. package/dist/study/SessionOverlay.mjs +407 -0
  167. package/dist/study/SessionOverlay.mjs.map +1 -0
  168. package/dist/study/SourceMixer.mjs +45 -0
  169. package/dist/study/SourceMixer.mjs.map +1 -0
  170. package/dist/study/SpacedRepetition.mjs +108 -0
  171. package/dist/study/SpacedRepetition.mjs.map +1 -0
  172. package/dist/study/TagFilteredContentSource.mjs +136 -0
  173. package/dist/study/TagFilteredContentSource.mjs.map +1 -0
  174. package/dist/study/services/CardHydrationService.mjs +172 -0
  175. package/dist/study/services/CardHydrationService.mjs.map +1 -0
  176. package/dist/study/services/EloService.mjs +217 -0
  177. package/dist/study/services/EloService.mjs.map +1 -0
  178. package/dist/study/services/ResponseProcessor.mjs +190 -0
  179. package/dist/study/services/ResponseProcessor.mjs.map +1 -0
  180. package/dist/study/services/SrsService.mjs +49 -0
  181. package/dist/study/services/SrsService.mjs.map +1 -0
  182. package/dist/study/services/tagRecent.mjs +65 -0
  183. package/dist/study/services/tagRecent.mjs.map +1 -0
  184. package/dist/{types-DF0JuPbs.d.ts → types-DChCz22D.d.ts} +1 -1
  185. package/dist/{types-legacy-DdVjg81H.d.cts → types-legacy-fT5Y1Wuy.d.ts} +1 -1
  186. package/dist/userDBKeys-ne1g4Xuq.d.ts +16 -0
  187. package/dist/util/Loggable.mjs +14 -0
  188. package/dist/util/Loggable.mjs.map +1 -0
  189. package/dist/util/dataDirectory.mjs +47 -0
  190. package/dist/util/dataDirectory.mjs.map +1 -0
  191. package/dist/util/logger.mjs +86 -0
  192. package/dist/util/logger.mjs.map +1 -0
  193. package/dist/util/migrator/FileSystemAdapter.mjs +18 -0
  194. package/dist/util/migrator/FileSystemAdapter.mjs.map +1 -0
  195. package/dist/util/migrator/StaticToCouchDBMigrator.mjs +428 -0
  196. package/dist/util/migrator/StaticToCouchDBMigrator.mjs.map +1 -0
  197. package/dist/util/migrator/types.mjs +11 -0
  198. package/dist/util/migrator/types.mjs.map +1 -0
  199. package/dist/util/migrator/validation.mjs +334 -0
  200. package/dist/util/migrator/validation.mjs.map +1 -0
  201. package/dist/util/packer/CouchDBToStaticPacker.mjs +438 -0
  202. package/dist/util/packer/CouchDBToStaticPacker.mjs.map +1 -0
  203. package/dist/util/packer/{index.js → index.cjs} +73 -9
  204. package/dist/util/packer/index.cjs.map +1 -0
  205. package/dist/util/packer/index.d.ts +3 -3
  206. package/dist/util/packer/index.mjs +2 -537
  207. package/eslint.config.mjs +9 -1
  208. package/package.json +25 -13
  209. package/rolldown.config.mjs +44 -0
  210. package/src/core/UserDBDebugger.ts +47 -46
  211. package/src/core/navigators/Pipeline.ts +10 -10
  212. package/src/core/navigators/PipelineDebugger.ts +55 -55
  213. package/src/core/navigators/filters/eloDistance.ts +1 -1
  214. package/src/core/navigators/generators/elo.ts +5 -1
  215. package/src/core/navigators/generators/prescribed.ts +42 -16
  216. package/src/core/navigators/index.ts +9 -3
  217. package/src/factory.ts +10 -1
  218. package/src/impl/common/BaseUserDB.ts +16 -5
  219. package/src/impl/common/index.ts +2 -0
  220. package/src/impl/common/userDBHelpers.ts +4 -58
  221. package/src/impl/common/userDBKeys.ts +64 -0
  222. package/src/impl/couch/CourseSyncService.ts +130 -20
  223. package/src/impl/couch/PouchDataLayerProvider.ts +14 -1
  224. package/src/impl/couch/courseAPI.ts +26 -12
  225. package/src/impl/couch/courseDB.ts +35 -15
  226. package/src/impl/couch/index.ts +18 -23
  227. package/src/impl/couch/pouchdb-setup.ts +8 -0
  228. package/src/index.ts +1 -1
  229. package/src/study/MixerDebugger.ts +46 -46
  230. package/src/study/SessionDebugger.ts +20 -20
  231. package/src/study/SessionOverlay.ts +4 -4
  232. package/src/util/logger.ts +112 -13
  233. package/tests/core/navigators/eloGenerator.test.ts +36 -0
  234. package/tests/impl/courseSync.test.ts +139 -0
  235. package/tsup.config.ts +24 -21
  236. package/dist/SyncStrategy-BXliog1m.d.cts +0 -116
  237. package/dist/classroomDB-DLTtLZct.d.cts +0 -86
  238. package/dist/contentSource-FQZcZopC.d.cts +0 -2007
  239. package/dist/core/index.d.cts +0 -521
  240. package/dist/core/index.js.map +0 -1
  241. package/dist/core/index.mjs.map +0 -1
  242. package/dist/dataLayerProvider-3y21KtF-.d.cts +0 -61
  243. package/dist/diagnostics/index.d.cts +0 -561
  244. package/dist/diagnostics/index.mjs.map +0 -1
  245. package/dist/impl/couch/index.d.cts +0 -620
  246. package/dist/impl/couch/index.js.map +0 -1
  247. package/dist/impl/static/index.d.cts +0 -232
  248. package/dist/impl/static/index.js.map +0 -1
  249. package/dist/impl/static/index.mjs.map +0 -1
  250. package/dist/index-BIum9Ue2.d.cts +0 -137
  251. package/dist/index.d.cts +0 -1663
  252. package/dist/index.js.map +0 -1
  253. package/dist/index.mjs.map +0 -1
  254. package/dist/pouch/index.d.cts +0 -1
  255. package/dist/pouch/index.js.map +0 -1
  256. package/dist/pouch/index.mjs.map +0 -1
  257. package/dist/types-BcWVH4ww.d.cts +0 -58
  258. package/dist/types-legacy-DdVjg81H.d.ts +0 -168
  259. package/dist/util/packer/index.d.cts +0 -5
  260. package/dist/util/packer/index.js.map +0 -1
  261. package/dist/util/packer/index.mjs.map +0 -1
  262. package/src/study/getCardDataShape.ts +0 -34
  263. /package/dist/diagnostics/{index.js.map → index.cjs.map} +0 -0
@@ -0,0 +1,108 @@
1
+ import "../_virtual/_rolldown/runtime.mjs";
2
+ import { logger } from "../util/logger.mjs";
3
+ import { areQuestionRecords } from "../core/util/index.mjs";
4
+ import moment from "moment";
5
+ import { isTaggedPerformance } from "@vue-skuilder/common";
6
+ //#region src/study/SpacedRepetition.ts
7
+ const duration = moment.duration;
8
+ /**
9
+ * Longest interval (seconds) after a correct answer flagged `fluent: false`.
10
+ * Matches the 20h floor in `lastSuccessfulInterval`: due again next day.
11
+ */
12
+ const SLOW_CORRECT_MAX_INTERVAL = 1200 * 60;
13
+ /**
14
+ * Returns the minimum number of seconds that should pass before a
15
+ * card is redisplayed for review / practice.
16
+ *
17
+ * @param cardHistory The user's history working with the given card
18
+ */
19
+ function newInterval(user, cardHistory) {
20
+ if (areQuestionRecords(cardHistory)) return newQuestionInterval(user, cardHistory);
21
+ else return 1e5;
22
+ }
23
+ function newQuestionInterval(user, cardHistory) {
24
+ const records = cardHistory.records;
25
+ const currentAttempt = records[records.length - 1];
26
+ const lastInterval = lastSuccessfulInterval(records);
27
+ if (lastInterval > cardHistory.bestInterval) {
28
+ cardHistory.bestInterval = lastInterval;
29
+ user.update(cardHistory._id, { bestInterval: lastInterval }).catch((e) => {
30
+ logger.warn(`[SpacedRepetition] Failed to update bestInterval for ${cardHistory._id}: ${e?.message ?? e}`);
31
+ });
32
+ }
33
+ if (currentAttempt.isCorrect) {
34
+ const rawPerf = currentAttempt.performance;
35
+ const numericPerf = isTaggedPerformance(rawPerf) ? rawPerf._global : rawPerf;
36
+ const skill = Math.min(1, Math.max(0, numericPerf));
37
+ logger.debug(`Demontrated skill: \t${skill}`);
38
+ const interval = lastInterval * (.75 + skill);
39
+ cardHistory.lapses = getLapses(cardHistory.records);
40
+ cardHistory.streak = getStreak(cardHistory.records);
41
+ let ret = interval;
42
+ if (cardHistory.lapses && cardHistory.streak && cardHistory.bestInterval && (cardHistory.lapses >= 0 || cardHistory.streak >= 0)) {
43
+ ret = (cardHistory.lapses * interval + cardHistory.streak * cardHistory.bestInterval) / (cardHistory.lapses + cardHistory.streak);
44
+ logger.debug(`Weighted average interval calculation:
45
+ \t(${cardHistory.lapses} * ${interval} + ${cardHistory.streak} * ${cardHistory.bestInterval}) / (${cardHistory.lapses} + ${cardHistory.streak}) = ${ret}`);
46
+ }
47
+ if (currentAttempt.fluent === false) {
48
+ logger.debug(`Correct but not fluent: capping interval ${ret}s at ${SLOW_CORRECT_MAX_INTERVAL}s`);
49
+ return Math.min(ret, SLOW_CORRECT_MAX_INTERVAL);
50
+ }
51
+ return ret;
52
+ } else return 0;
53
+ }
54
+ /**
55
+ * Returns the amount of time, in seconds, of the most recent successful
56
+ * interval for this card. An interval is successful if the user answers
57
+ * a question correctly on the first attempt, and not flagged as too slow.
58
+ *
59
+ * @param cardHistory The record of user attempts with the question
60
+ */
61
+ function lastSuccessfulInterval(cardHistory) {
62
+ for (let i = cardHistory.length - 1; i >= 1; i--) if (cardHistory[i].priorAttemps === 0 && cardHistory[i].isCorrect && cardHistory[i].fluent !== false) {
63
+ const lastInterval = secondsBetween(cardHistory[i - 1].timeStamp, cardHistory[i].timeStamp);
64
+ const ret = Math.max(lastInterval, 1200 * 60);
65
+ logger.debug(`Last interval w/ this card was: ${lastInterval}s, returning ${ret}s`);
66
+ return ret;
67
+ }
68
+ return getInitialInterval(cardHistory);
69
+ }
70
+ /**
71
+ * Number of trailing consecutive correct records (retries within a single
72
+ * presentation count as separate records). Exported so the persisted
73
+ * `CardHistory.streak` can be kept in step with this derivation.
74
+ */
75
+ function getStreak(records) {
76
+ let streak = 0;
77
+ let index = records.length - 1;
78
+ while (index >= 0 && records[index].isCorrect) {
79
+ index--;
80
+ streak++;
81
+ }
82
+ return streak;
83
+ }
84
+ /**
85
+ * Total number of incorrect records on the card. Exported so the persisted
86
+ * `CardHistory.lapses` can be kept in step with this derivation.
87
+ */
88
+ function getLapses(records) {
89
+ return records.filter((r) => r.isCorrect === false).length;
90
+ }
91
+ function getInitialInterval(cardHistory) {
92
+ logger.warn(`history of length: ${cardHistory.length} ignored!`);
93
+ return 3600 * 24 * 3;
94
+ }
95
+ /**
96
+ * Returns the time in seconds between two Moment objects
97
+ * @param start The first time
98
+ * @param end The second time
99
+ */
100
+ function secondsBetween(start, end) {
101
+ start = moment(start);
102
+ end = moment(end);
103
+ return duration(end.diff(start)).asSeconds();
104
+ }
105
+ //#endregion
106
+ export { getLapses, getStreak, newInterval };
107
+
108
+ //# sourceMappingURL=SpacedRepetition.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"SpacedRepetition.mjs","names":[],"sources":["../../src/study/SpacedRepetition.ts"],"sourcesContent":["import { CardHistory, CardRecord, QuestionRecord } from '@db/core/types/types-legacy';\nimport { areQuestionRecords } from '@db/core/util';\nimport { Update } from '@db/impl/couch/updateQueue';\nimport moment from 'moment';\nimport { isTaggedPerformance } from '@vue-skuilder/common';\nimport { logger } from '../util/logger';\n\ntype Moment = moment.Moment;\nconst duration = moment.duration;\n\n/**\n * Longest interval (seconds) after a correct answer flagged `fluent: false`.\n * Matches the 20h floor in `lastSuccessfulInterval`: due again next day.\n */\nconst SLOW_CORRECT_MAX_INTERVAL = 20 * 60 * 60;\n\nexport interface DocumentUpdater {\n update<T extends PouchDB.Core.Document<object>>(id: string, update: Update<T>): Promise<T>;\n}\n\n/**\n * Returns the minimum number of seconds that should pass before a\n * card is redisplayed for review / practice.\n *\n * @param cardHistory The user's history working with the given card\n */\nexport function newInterval(user: DocumentUpdater, cardHistory: CardHistory<CardRecord>): number {\n if (areQuestionRecords(cardHistory)) {\n return newQuestionInterval(user, cardHistory);\n } else {\n return 100000; // random - replace\n }\n}\n\nfunction newQuestionInterval(user: DocumentUpdater, cardHistory: CardHistory<QuestionRecord>) {\n const records = cardHistory.records;\n const currentAttempt = records[records.length - 1];\n const lastInterval: number = lastSuccessfulInterval(records);\n\n if (lastInterval > cardHistory.bestInterval) {\n cardHistory.bestInterval = lastInterval;\n // update bestInterval on cardHistory in db\n user.update<CardHistory<QuestionRecord>>(cardHistory._id, {\n bestInterval: lastInterval,\n }).catch((e) => {\n logger.warn(`[SpacedRepetition] Failed to update bestInterval for ${cardHistory._id}: ${e?.message ?? e}`);\n });\n }\n\n if (currentAttempt.isCorrect) {\n const rawPerf = currentAttempt.performance;\n const numericPerf = isTaggedPerformance(rawPerf) ? rawPerf._global : rawPerf;\n const skill = Math.min(1.0, Math.max(0.0, numericPerf));\n logger.debug(`Demontrated skill: \\t${skill}`);\n const interval: number = lastInterval * (0.75 + skill);\n cardHistory.lapses = getLapses(cardHistory.records);\n cardHistory.streak = getStreak(cardHistory.records);\n\n let ret = interval;\n if (\n cardHistory.lapses &&\n cardHistory.streak &&\n cardHistory.bestInterval &&\n (cardHistory.lapses >= 0 || cardHistory.streak >= 0)\n ) {\n // weighted average of best-ever performance vs current performance, based\n // on how often the card has been failed, and the current streak of success\n ret =\n (cardHistory.lapses * interval + cardHistory.streak * cardHistory.bestInterval) /\n (cardHistory.lapses + cardHistory.streak);\n logger.debug(`Weighted average interval calculation:\n\\t(${cardHistory.lapses} * ${interval} + ${cardHistory.streak} * ${cardHistory.bestInterval}) / (${cardHistory.lapses} + ${cardHistory.streak}) = ${ret}`);\n }\n\n if (currentAttempt.fluent === false) {\n // Correct but too slow: keep it coming back until it's fast on a first presentation.\n logger.debug(\n `Correct but not fluent: capping interval ${ret}s at ${SLOW_CORRECT_MAX_INTERVAL}s`\n );\n return Math.min(ret, SLOW_CORRECT_MAX_INTERVAL);\n }\n return ret;\n } else {\n return 0;\n }\n}\n\n/**\n * Returns the amount of time, in seconds, of the most recent successful\n * interval for this card. An interval is successful if the user answers\n * a question correctly on the first attempt, and not flagged as too slow.\n *\n * @param cardHistory The record of user attempts with the question\n */\nfunction lastSuccessfulInterval(cardHistory: QuestionRecord[]): number {\n for (let i = cardHistory.length - 1; i >= 1; i--) {\n if (\n cardHistory[i].priorAttemps === 0 &&\n cardHistory[i].isCorrect &&\n cardHistory[i].fluent !== false\n ) {\n const lastInterval = secondsBetween(cardHistory[i - 1].timeStamp, cardHistory[i].timeStamp);\n const ret = Math.max(lastInterval, 20 * 60 * 60);\n logger.debug(`Last interval w/ this card was: ${lastInterval}s, returning ${ret}s`);\n return ret;\n }\n }\n\n return getInitialInterval(cardHistory); // used as a magic number here - indicates no prior intervals\n}\n\n/**\n * Number of trailing consecutive correct records (retries within a single\n * presentation count as separate records). Exported so the persisted\n * `CardHistory.streak` can be kept in step with this derivation.\n */\nexport function getStreak(records: QuestionRecord[]): number {\n let streak = 0;\n let index = records.length - 1;\n\n while (index >= 0 && records[index].isCorrect) {\n index--;\n streak++;\n }\n\n return streak;\n}\n/**\n * Total number of incorrect records on the card. Exported so the persisted\n * `CardHistory.lapses` can be kept in step with this derivation.\n */\nexport function getLapses(records: QuestionRecord[]): number {\n return records.filter((r) => r.isCorrect === false).length;\n}\n\nfunction getInitialInterval(cardHistory: QuestionRecord[]): number {\n logger.warn(`history of length: ${cardHistory.length} ignored!`);\n\n // todo make this a data-driven service, relying on:\n // - global experience w/ the card (ie, what interval\n // seems to be working well across the population)\n // - the individual user (how do they respond in general\n // when compared to the population)\n return 60 * 60 * 24 * 3; // 3 days\n}\n\n/**\n * Returns the time in seconds between two Moment objects\n * @param start The first time\n * @param end The second time\n */\nfunction secondsBetween(start: Moment, end: Moment): number {\n // assertion guard against mis-typed json from database\n start = moment(start);\n end = moment(end);\n const ret = duration(end.diff(start)).asSeconds();\n // console.log(`From start: ${start} to finish: ${end} is ${ret} seconds`);\n return ret;\n}\n"],"mappings":";;;;;;AAQA,MAAM,WAAW,OAAO;;;;;AAMxB,MAAM,4BAA4B,OAAU;;;;;;;AAY5C,SAAgB,YAAY,MAAuB,aAA8C;AAC/F,KAAI,mBAAmB,YAAY,CACjC,QAAO,oBAAoB,MAAM,YAAY;KAE7C,QAAO;;AAIX,SAAS,oBAAoB,MAAuB,aAA0C;CAC5F,MAAM,UAAU,YAAY;CAC5B,MAAM,iBAAiB,QAAQ,QAAQ,SAAS;CAChD,MAAM,eAAuB,uBAAuB,QAAQ;AAE5D,KAAI,eAAe,YAAY,cAAc;AAC3C,cAAY,eAAe;AAE3B,OAAK,OAAoC,YAAY,KAAK,EACxD,cAAc,cACf,CAAC,CAAC,OAAO,MAAM;AACd,UAAO,KAAK,wDAAwD,YAAY,IAAI,IAAI,GAAG,WAAW,IAAI;IAC1G;;AAGJ,KAAI,eAAe,WAAW;EAC5B,MAAM,UAAU,eAAe;EAC/B,MAAM,cAAc,oBAAoB,QAAQ,GAAG,QAAQ,UAAU;EACrE,MAAM,QAAQ,KAAK,IAAI,GAAK,KAAK,IAAI,GAAK,YAAY,CAAC;AACvD,SAAO,MAAM,wBAAwB,QAAQ;EAC7C,MAAM,WAAmB,gBAAgB,MAAO;AAChD,cAAY,SAAS,UAAU,YAAY,QAAQ;AACnD,cAAY,SAAS,UAAU,YAAY,QAAQ;EAEnD,IAAI,MAAM;AACV,MACE,YAAY,UACZ,YAAY,UACZ,YAAY,iBACX,YAAY,UAAU,KAAK,YAAY,UAAU,IAClD;AAGA,UACG,YAAY,SAAS,WAAW,YAAY,SAAS,YAAY,iBACjE,YAAY,SAAS,YAAY;AACpC,UAAO,MAAM;KACd,YAAY,OAAO,KAAK,SAAS,KAAK,YAAY,OAAO,KAAK,YAAY,aAAa,OAAO,YAAY,OAAO,KAAK,YAAY,OAAO,MAAM,MAAM;;AAGtJ,MAAI,eAAe,WAAW,OAAO;AAEnC,UAAO,MACL,4CAA4C,IAAI,OAAO,0BAA0B,GAClF;AACD,UAAO,KAAK,IAAI,KAAK,0BAA0B;;AAEjD,SAAO;OAEP,QAAO;;;;;;;;;AAWX,SAAS,uBAAuB,aAAuC;AACrE,MAAK,IAAI,IAAI,YAAY,SAAS,GAAG,KAAK,GAAG,IAC3C,KACE,YAAY,GAAG,iBAAiB,KAChC,YAAY,GAAG,aACf,YAAY,GAAG,WAAW,OAC1B;EACA,MAAM,eAAe,eAAe,YAAY,IAAI,GAAG,WAAW,YAAY,GAAG,UAAU;EAC3F,MAAM,MAAM,KAAK,IAAI,cAAc,OAAU,GAAG;AAChD,SAAO,MAAM,mCAAmC,aAAa,eAAe,IAAI,GAAG;AACnF,SAAO;;AAIX,QAAO,mBAAmB,YAAY;;;;;;;AAQxC,SAAgB,UAAU,SAAmC;CAC3D,IAAI,SAAS;CACb,IAAI,QAAQ,QAAQ,SAAS;AAE7B,QAAO,SAAS,KAAK,QAAQ,OAAO,WAAW;AAC7C;AACA;;AAGF,QAAO;;;;;;AAMT,SAAgB,UAAU,SAAmC;AAC3D,QAAO,QAAQ,QAAQ,MAAM,EAAE,cAAc,MAAM,CAAC;;AAGtD,SAAS,mBAAmB,aAAuC;AACjE,QAAO,KAAK,sBAAsB,YAAY,OAAO,WAAW;AAOhE,QAAO,OAAU,KAAK;;;;;;;AAQxB,SAAS,eAAe,OAAe,KAAqB;AAE1D,SAAQ,OAAO,MAAM;AACrB,OAAM,OAAO,IAAI;AAGjB,QAFY,SAAS,IAAI,KAAK,MAAM,CAAC,CAAC,WAAW"}
@@ -0,0 +1,136 @@
1
+ import "../_virtual/_rolldown/runtime.mjs";
2
+ import { logger } from "../util/logger.mjs";
3
+ import { getTag } from "../impl/couch/courseDB.mjs";
4
+ import { hasActiveFilter } from "@vue-skuilder/common";
5
+ //#region src/study/TagFilteredContentSource.ts
6
+ /**
7
+ * A StudyContentSource that filters cards based on tag inclusion/exclusion.
8
+ *
9
+ * This enables ephemeral, tag-scoped study sessions where users can focus
10
+ * on specific topics within a course without permanent configuration.
11
+ *
12
+ * Filter logic:
13
+ * - If `include` is non-empty: card must have at least one of the included tags
14
+ * - If `exclude` is non-empty: card must not have any of the excluded tags
15
+ * - Both filters are applied (include first, then exclude)
16
+ */
17
+ var TagFilteredContentSource = class {
18
+ courseId;
19
+ filter;
20
+ user;
21
+ resolvedCardIds = null;
22
+ constructor(courseId, filter, user) {
23
+ this.courseId = courseId;
24
+ this.filter = filter;
25
+ this.user = user;
26
+ logger.info(`[TagFilteredContentSource] Created for course "${courseId}" with filter:`, JSON.stringify(filter));
27
+ }
28
+ /**
29
+ * Resolves the TagFilter to a set of eligible card IDs.
30
+ *
31
+ * - Cards in `include` tags are OR'd together (card needs at least one)
32
+ * - Cards in `exclude` tags are removed from the result
33
+ */
34
+ async resolveFilteredCardIds() {
35
+ if (this.resolvedCardIds !== null) return this.resolvedCardIds;
36
+ const includedCardIds = /* @__PURE__ */ new Set();
37
+ if (this.filter.include.length > 0) for (const tagName of this.filter.include) try {
38
+ (await getTag(this.courseId, tagName)).taggedCards.forEach((cardId) => includedCardIds.add(cardId));
39
+ } catch (error) {
40
+ logger.warn(`[TagFilteredContentSource] Could not resolve tag "${tagName}" for inclusion:`, error);
41
+ }
42
+ if (includedCardIds.size === 0 && this.filter.include.length > 0) {
43
+ logger.warn(`[TagFilteredContentSource] No cards found for include tags: ${this.filter.include.join(", ")}`);
44
+ this.resolvedCardIds = /* @__PURE__ */ new Set();
45
+ return this.resolvedCardIds;
46
+ }
47
+ const excludedCardIds = /* @__PURE__ */ new Set();
48
+ if (this.filter.exclude.length > 0) for (const tagName of this.filter.exclude) try {
49
+ (await getTag(this.courseId, tagName)).taggedCards.forEach((cardId) => excludedCardIds.add(cardId));
50
+ } catch (error) {
51
+ logger.warn(`[TagFilteredContentSource] Could not resolve tag "${tagName}" for exclusion:`, error);
52
+ }
53
+ const finalCardIds = /* @__PURE__ */ new Set();
54
+ for (const cardId of includedCardIds) if (!excludedCardIds.has(cardId)) finalCardIds.add(cardId);
55
+ logger.info(`[TagFilteredContentSource] Resolved ${finalCardIds.size} cards (included: ${includedCardIds.size}, excluded: ${excludedCardIds.size})`);
56
+ this.resolvedCardIds = finalCardIds;
57
+ return finalCardIds;
58
+ }
59
+ /**
60
+ * Get cards with suitability scores for presentation.
61
+ *
62
+ * Filters cards by tag inclusion/exclusion and assigns score=1.0 to all.
63
+ * TagFilteredContentSource does not currently support pluggable navigation
64
+ * strategies - it returns flat-scored candidates.
65
+ *
66
+ * @param limit - Maximum number of cards to return
67
+ * @returns Cards sorted by score descending (all scores = 1.0)
68
+ */
69
+ async getWeightedCards(limit) {
70
+ if (!hasActiveFilter(this.filter)) {
71
+ logger.warn("[TagFilteredContentSource] getWeightedCards called with no active filter");
72
+ return { cards: [] };
73
+ }
74
+ const eligibleCardIds = await this.resolveFilteredCardIds();
75
+ const activeCards = await this.user.getActiveCards();
76
+ const activeCardIds = new Set(activeCards.map((c) => c.cardID));
77
+ const newCardWeighted = [];
78
+ for (const cardId of eligibleCardIds) {
79
+ if (!activeCardIds.has(cardId)) newCardWeighted.push({
80
+ cardId,
81
+ courseId: this.courseId,
82
+ score: 1,
83
+ provenance: [{
84
+ strategy: "tagFilter",
85
+ strategyName: "Tag Filter",
86
+ strategyId: "TAG_FILTER",
87
+ action: "generated",
88
+ score: 1,
89
+ reason: `Tag-filtered new card (tags: ${this.filter.include.join(", ")})`
90
+ }]
91
+ });
92
+ if (newCardWeighted.length >= limit) break;
93
+ }
94
+ logger.info(`[TagFilteredContentSource] Found ${newCardWeighted.length} new cards matching filter`);
95
+ const allReviews = await this.user.getPendingReviews(this.courseId);
96
+ const filteredReviews = allReviews.filter((review) => eligibleCardIds.has(review.cardId));
97
+ logger.info(`[TagFilteredContentSource] Found ${filteredReviews.length} pending reviews matching filter (of ${allReviews.length} total)`);
98
+ return { cards: [...filteredReviews.map((r) => ({
99
+ cardId: r.cardId,
100
+ courseId: r.courseId,
101
+ score: 1,
102
+ reviewID: r._id,
103
+ provenance: [{
104
+ strategy: "tagFilter",
105
+ strategyName: "Tag Filter",
106
+ strategyId: "TAG_FILTER",
107
+ action: "generated",
108
+ score: 1,
109
+ reason: `Tag-filtered review (tags: ${this.filter.include.join(", ")})`
110
+ }]
111
+ })), ...newCardWeighted].slice(0, limit) };
112
+ }
113
+ /**
114
+ * Clears the cached resolved card IDs.
115
+ * Call this if the underlying tag data may have changed during a session.
116
+ */
117
+ clearCache() {
118
+ this.resolvedCardIds = null;
119
+ }
120
+ /**
121
+ * Returns the course ID this source is filtering.
122
+ */
123
+ getCourseId() {
124
+ return this.courseId;
125
+ }
126
+ /**
127
+ * Returns the active tag filter.
128
+ */
129
+ getFilter() {
130
+ return this.filter;
131
+ }
132
+ };
133
+ //#endregion
134
+ export { TagFilteredContentSource };
135
+
136
+ //# sourceMappingURL=TagFilteredContentSource.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"TagFilteredContentSource.mjs","names":[],"sources":["../../src/study/TagFilteredContentSource.ts"],"sourcesContent":["import { StudyContentSource } from '@db/core/interfaces/contentSource';\nimport { WeightedCard } from '@db/core/navigators';\nimport type { GeneratorResult } from '@db/core/navigators/generators/types';\nimport { UserDBInterface } from '@db/core';\nimport { TagFilter, hasActiveFilter } from '@vue-skuilder/common';\nimport { getTag } from '../impl/couch/courseDB';\nimport { logger } from '@db/util/logger';\n\n/**\n * A StudyContentSource that filters cards based on tag inclusion/exclusion.\n *\n * This enables ephemeral, tag-scoped study sessions where users can focus\n * on specific topics within a course without permanent configuration.\n *\n * Filter logic:\n * - If `include` is non-empty: card must have at least one of the included tags\n * - If `exclude` is non-empty: card must not have any of the excluded tags\n * - Both filters are applied (include first, then exclude)\n */\nexport class TagFilteredContentSource implements StudyContentSource {\n private courseId: string;\n private filter: TagFilter;\n private user: UserDBInterface;\n\n // Cache resolved card IDs to avoid repeated lookups within a session\n private resolvedCardIds: Set<string> | null = null;\n\n constructor(courseId: string, filter: TagFilter, user: UserDBInterface) {\n this.courseId = courseId;\n this.filter = filter;\n this.user = user;\n\n logger.info(\n `[TagFilteredContentSource] Created for course \"${courseId}\" with filter:`,\n JSON.stringify(filter)\n );\n }\n\n /**\n * Resolves the TagFilter to a set of eligible card IDs.\n *\n * - Cards in `include` tags are OR'd together (card needs at least one)\n * - Cards in `exclude` tags are removed from the result\n */\n private async resolveFilteredCardIds(): Promise<Set<string>> {\n // Return cached result if available\n if (this.resolvedCardIds !== null) {\n return this.resolvedCardIds;\n }\n\n const includedCardIds = new Set<string>();\n\n // Build inclusion set (OR of all include tags)\n if (this.filter.include.length > 0) {\n for (const tagName of this.filter.include) {\n try {\n const tagDoc = await getTag(this.courseId, tagName);\n tagDoc.taggedCards.forEach((cardId) => includedCardIds.add(cardId));\n } catch (error) {\n logger.warn(\n `[TagFilteredContentSource] Could not resolve tag \"${tagName}\" for inclusion:`,\n error\n );\n }\n }\n }\n\n // If no include tags specified or none resolved, return empty set\n // (requiring explicit inclusion prevents \"study everything\" on empty filter)\n if (includedCardIds.size === 0 && this.filter.include.length > 0) {\n logger.warn(\n `[TagFilteredContentSource] No cards found for include tags: ${this.filter.include.join(', ')}`\n );\n this.resolvedCardIds = new Set();\n return this.resolvedCardIds;\n }\n\n // Build exclusion set\n const excludedCardIds = new Set<string>();\n if (this.filter.exclude.length > 0) {\n for (const tagName of this.filter.exclude) {\n try {\n const tagDoc = await getTag(this.courseId, tagName);\n tagDoc.taggedCards.forEach((cardId) => excludedCardIds.add(cardId));\n } catch (error) {\n logger.warn(\n `[TagFilteredContentSource] Could not resolve tag \"${tagName}\" for exclusion:`,\n error\n );\n }\n }\n }\n\n // Apply exclusion filter\n const finalCardIds = new Set<string>();\n for (const cardId of includedCardIds) {\n if (!excludedCardIds.has(cardId)) {\n finalCardIds.add(cardId);\n }\n }\n\n logger.info(\n `[TagFilteredContentSource] Resolved ${finalCardIds.size} cards ` +\n `(included: ${includedCardIds.size}, excluded: ${excludedCardIds.size})`\n );\n\n this.resolvedCardIds = finalCardIds;\n return finalCardIds;\n }\n\n /**\n * Get cards with suitability scores for presentation.\n *\n * Filters cards by tag inclusion/exclusion and assigns score=1.0 to all.\n * TagFilteredContentSource does not currently support pluggable navigation\n * strategies - it returns flat-scored candidates.\n *\n * @param limit - Maximum number of cards to return\n * @returns Cards sorted by score descending (all scores = 1.0)\n */\n public async getWeightedCards(limit: number): Promise<GeneratorResult> {\n if (!hasActiveFilter(this.filter)) {\n logger.warn('[TagFilteredContentSource] getWeightedCards called with no active filter');\n return { cards: [] };\n }\n\n const eligibleCardIds = await this.resolveFilteredCardIds();\n\n // Get new cards: eligible cards that are not already active\n const activeCards = await this.user.getActiveCards();\n const activeCardIds = new Set(activeCards.map((c) => c.cardID));\n\n const newCardWeighted: WeightedCard[] = [];\n for (const cardId of eligibleCardIds) {\n if (!activeCardIds.has(cardId)) {\n newCardWeighted.push({\n cardId,\n courseId: this.courseId,\n score: 1.0,\n provenance: [\n {\n strategy: 'tagFilter',\n strategyName: 'Tag Filter',\n strategyId: 'TAG_FILTER',\n action: 'generated' as const,\n score: 1.0,\n reason: `Tag-filtered new card (tags: ${this.filter.include.join(', ')})`,\n },\n ],\n });\n }\n\n if (newCardWeighted.length >= limit) {\n break;\n }\n }\n\n logger.info(\n `[TagFilteredContentSource] Found ${newCardWeighted.length} new cards matching filter`\n );\n\n // Get pending reviews: reviews for cards in the eligible set\n const allReviews = await this.user.getPendingReviews(this.courseId);\n const filteredReviews = allReviews.filter((review) => eligibleCardIds.has(review.cardId));\n\n logger.info(\n `[TagFilteredContentSource] Found ${filteredReviews.length} pending reviews matching filter ` +\n `(of ${allReviews.length} total)`\n );\n\n const reviewWeighted: WeightedCard[] = filteredReviews.map((r) => ({\n cardId: r.cardId,\n courseId: r.courseId,\n score: 1.0,\n reviewID: r._id,\n provenance: [\n {\n strategy: 'tagFilter',\n strategyName: 'Tag Filter',\n strategyId: 'TAG_FILTER',\n action: 'generated' as const,\n score: 1.0,\n reason: `Tag-filtered review (tags: ${this.filter.include.join(', ')})`,\n },\n ],\n }));\n\n // Reviews first, then new cards; respect limit\n return { cards: [...reviewWeighted, ...newCardWeighted].slice(0, limit) };\n }\n\n /**\n * Clears the cached resolved card IDs.\n * Call this if the underlying tag data may have changed during a session.\n */\n public clearCache(): void {\n this.resolvedCardIds = null;\n }\n\n /**\n * Returns the course ID this source is filtering.\n */\n public getCourseId(): string {\n return this.courseId;\n }\n\n /**\n * Returns the active tag filter.\n */\n public getFilter(): TagFilter {\n return this.filter;\n }\n}\n"],"mappings":"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"}
@@ -0,0 +1,172 @@
1
+ import "../../_virtual/_rolldown/runtime.mjs";
2
+ import { logger } from "../../util/logger.mjs";
3
+ import { displayableDataToViewData, isCourseElo, toCourseElo } from "@vue-skuilder/common";
4
+ //#region src/study/services/CardHydrationService.ts
5
+ /**
6
+ * Extract audio URLs from arbitrary field data using heuristic pattern matching.
7
+ * This is a "worse is better" approach - catches obvious URLs, silently ignores edge cases.
8
+ */
9
+ function parseAudioURIs(data) {
10
+ if (typeof data !== "string") return [];
11
+ return data.match(/https?:\/\/[^\s"'<>]+\.(wav|mp3|ogg|m4a|aac|webm)/gi) ?? [];
12
+ }
13
+ /**
14
+ * Prefetch an audio file by loading it into browser cache.
15
+ * Resolves when the audio is ready to play (or on error, to avoid blocking).
16
+ */
17
+ function prefetchAudio(url) {
18
+ return new Promise((resolve) => {
19
+ const audio = new Audio();
20
+ audio.preload = "auto";
21
+ const cleanup = () => {
22
+ audio.oncanplaythrough = null;
23
+ audio.onerror = null;
24
+ };
25
+ audio.oncanplaythrough = () => {
26
+ cleanup();
27
+ resolve();
28
+ };
29
+ audio.onerror = () => {
30
+ cleanup();
31
+ logger.warn(`[CardHydrationService] Failed to prefetch audio: ${url}`);
32
+ resolve();
33
+ };
34
+ audio.src = url;
35
+ });
36
+ }
37
+ /**
38
+ * Service responsible for managing hydrated (ready-to-display) cards.
39
+ * Uses a Map-based cache for direct ID lookup - no ordering assumptions.
40
+ * SessionController owns all ordering decisions.
41
+ */
42
+ var CardHydrationService = class {
43
+ hydratedCards = /* @__PURE__ */ new Map();
44
+ hydrationInFlight = /* @__PURE__ */ new Set();
45
+ hydrationInProgress = false;
46
+ constructor(getViewComponent, getCourseDB, getItemsToHydrate) {
47
+ this.getViewComponent = getViewComponent;
48
+ this.getCourseDB = getCourseDB;
49
+ this.getItemsToHydrate = getItemsToHydrate;
50
+ }
51
+ /**
52
+ * Get a hydrated card by ID.
53
+ * @returns Hydrated card or null if not in cache
54
+ */
55
+ getHydratedCard(cardId) {
56
+ return this.hydratedCards.get(cardId) ?? null;
57
+ }
58
+ /**
59
+ * Check if a card is hydrated.
60
+ */
61
+ hasHydratedCard(cardId) {
62
+ return this.hydratedCards.has(cardId);
63
+ }
64
+ /**
65
+ * Remove a card from the cache (call on successful dismiss to free memory).
66
+ */
67
+ removeCard(cardId) {
68
+ this.hydratedCards.delete(cardId);
69
+ }
70
+ /**
71
+ * Check if hydration should be triggered and start background hydration if needed.
72
+ */
73
+ async ensureHydratedCards() {
74
+ this.fillHydratedCards();
75
+ }
76
+ /**
77
+ * Wait for a specific card to become hydrated.
78
+ * @returns Promise that resolves to a hydrated card or null
79
+ */
80
+ async waitForCard(cardId) {
81
+ if (this.hydratedCards.has(cardId)) return this.hydratedCards.get(cardId);
82
+ if (!this.hydrationInProgress) this.fillHydratedCards();
83
+ const maxWaitMs = 1e4;
84
+ const pollIntervalMs = 25;
85
+ let elapsed = 0;
86
+ while (elapsed < maxWaitMs) {
87
+ if (this.hydratedCards.has(cardId)) return this.hydratedCards.get(cardId);
88
+ if (!this.hydrationInFlight.has(cardId) && !this.hydrationInProgress) break;
89
+ await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
90
+ elapsed += pollIntervalMs;
91
+ }
92
+ return this.hydratedCards.get(cardId) ?? null;
93
+ }
94
+ /**
95
+ * Get current hydrated cache size.
96
+ */
97
+ get hydratedCount() {
98
+ return this.hydratedCards.size;
99
+ }
100
+ /**
101
+ * Get list of currently hydrated card IDs (for debugging).
102
+ */
103
+ getHydratedCardIds() {
104
+ return Array.from(this.hydratedCards.keys());
105
+ }
106
+ /**
107
+ * Fill the hydrated cache by hydrating items from getItemsToHydrate().
108
+ * This is a pure cache-warming operation - no queue mutation.
109
+ */
110
+ async fillHydratedCards() {
111
+ if (this.hydrationInProgress) return;
112
+ this.hydrationInProgress = true;
113
+ try {
114
+ const itemsToHydrate = this.getItemsToHydrate();
115
+ for (const item of itemsToHydrate) {
116
+ if (this.hydratedCards.has(item.cardID) || this.hydrationInFlight.has(item.cardID)) continue;
117
+ try {
118
+ await this.hydrateCard(item);
119
+ } catch (e) {
120
+ logger.error(`[CardHydrationService] Error hydrating card ${item.cardID}:`, e);
121
+ }
122
+ }
123
+ } finally {
124
+ this.hydrationInProgress = false;
125
+ }
126
+ }
127
+ /**
128
+ * Hydrate a single card and add to cache.
129
+ */
130
+ async hydrateCard(item) {
131
+ if (this.hydratedCards.has(item.cardID) || this.hydrationInFlight.has(item.cardID)) return;
132
+ this.hydrationInFlight.add(item.cardID);
133
+ try {
134
+ const courseDB = this.getCourseDB(item.courseID);
135
+ const [cardData, tagsByCard] = await Promise.all([courseDB.getCourseDoc(item.cardID), courseDB.getAppliedTagsBatch([item.cardID])]);
136
+ if (!isCourseElo(cardData.elo)) cardData.elo = toCourseElo(cardData.elo);
137
+ const view = this.getViewComponent(cardData.id_view);
138
+ const dataDocs = await Promise.all(cardData.id_displayable_data.map((id) => courseDB.getCourseDoc(id, {
139
+ attachments: true,
140
+ binary: true
141
+ })));
142
+ const audioToPrefetch = [];
143
+ dataDocs.forEach((dd) => {
144
+ dd.data.forEach((f) => {
145
+ audioToPrefetch.push(...parseAudioURIs(f.data));
146
+ });
147
+ });
148
+ const uniqueAudioUrls = [...new Set(audioToPrefetch)];
149
+ if (uniqueAudioUrls.length > 0) {
150
+ logger.debug(`[CardHydrationService] Prefetching ${uniqueAudioUrls.length} audio files for card ${item.cardID}`);
151
+ await Promise.allSettled(uniqueAudioUrls.map(prefetchAudio));
152
+ }
153
+ const data = dataDocs.map(displayableDataToViewData).reverse();
154
+ this.hydratedCards.set(item.cardID, {
155
+ item: {
156
+ ...item,
157
+ elo: toCourseElo(cardData.elo).global.score
158
+ },
159
+ view,
160
+ data,
161
+ tags: tagsByCard.get(item.cardID) ?? []
162
+ });
163
+ logger.debug(`[CardHydrationService] Hydrated card ${item.cardID}`);
164
+ } finally {
165
+ this.hydrationInFlight.delete(item.cardID);
166
+ }
167
+ }
168
+ };
169
+ //#endregion
170
+ export { CardHydrationService };
171
+
172
+ //# sourceMappingURL=CardHydrationService.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"CardHydrationService.mjs","names":[],"sources":["../../../src/study/services/CardHydrationService.ts"],"sourcesContent":["import {\n displayableDataToViewData,\n CardData,\n DisplayableData,\n isCourseElo,\n toCourseElo,\n} from '@vue-skuilder/common';\nimport { StudySessionItem } from '@db/impl/couch';\nimport { logger } from '@db/util/logger';\nimport { CourseDBInterface } from '@db/core';\n\n/**\n * Extract audio URLs from arbitrary field data using heuristic pattern matching.\n * This is a \"worse is better\" approach - catches obvious URLs, silently ignores edge cases.\n */\nfunction parseAudioURIs(data: unknown): string[] {\n if (typeof data !== 'string') return [];\n\n // Match URLs ending in common audio extensions\n const audioPattern = /https?:\\/\\/[^\\s\"'<>]+\\.(wav|mp3|ogg|m4a|aac|webm)/gi;\n return data.match(audioPattern) ?? [];\n}\n\n/**\n * Prefetch an audio file by loading it into browser cache.\n * Resolves when the audio is ready to play (or on error, to avoid blocking).\n */\nfunction prefetchAudio(url: string): Promise<void> {\n return new Promise((resolve) => {\n const audio = new Audio();\n audio.preload = 'auto';\n\n const cleanup = () => {\n audio.oncanplaythrough = null;\n audio.onerror = null;\n };\n\n audio.oncanplaythrough = () => {\n cleanup();\n resolve();\n };\n\n audio.onerror = () => {\n cleanup();\n logger.warn(`[CardHydrationService] Failed to prefetch audio: ${url}`);\n resolve(); // Don't block hydration on failed prefetch\n };\n\n audio.src = url;\n });\n}\n\nexport interface HydratedCard<TView = unknown> {\n item: StudySessionItem;\n view: TView;\n data: any[];\n tags: string[];\n}\n\n/**\n * Service responsible for managing hydrated (ready-to-display) cards.\n * Uses a Map-based cache for direct ID lookup - no ordering assumptions.\n * SessionController owns all ordering decisions.\n */\nexport class CardHydrationService<TView = unknown> {\n private hydratedCards: Map<string, HydratedCard<TView>> = new Map();\n private hydrationInFlight: Set<string> = new Set();\n private hydrationInProgress: boolean = false;\n\n constructor(\n private getViewComponent: (viewId: string) => TView,\n private getCourseDB: (courseId: string) => CourseDBInterface,\n private getItemsToHydrate: () => StudySessionItem[]\n ) {}\n\n /**\n * Get a hydrated card by ID.\n * @returns Hydrated card or null if not in cache\n */\n public getHydratedCard(cardId: string): HydratedCard<TView> | null {\n return this.hydratedCards.get(cardId) ?? null;\n }\n\n /**\n * Check if a card is hydrated.\n */\n public hasHydratedCard(cardId: string): boolean {\n return this.hydratedCards.has(cardId);\n }\n\n /**\n * Remove a card from the cache (call on successful dismiss to free memory).\n */\n public removeCard(cardId: string): void {\n this.hydratedCards.delete(cardId);\n }\n\n /**\n * Check if hydration should be triggered and start background hydration if needed.\n */\n public async ensureHydratedCards(): Promise<void> {\n void this.fillHydratedCards();\n }\n\n /**\n * Wait for a specific card to become hydrated.\n * @returns Promise that resolves to a hydrated card or null\n */\n public async waitForCard(cardId: string): Promise<HydratedCard<TView> | null> {\n // If already hydrated, return immediately\n if (this.hydratedCards.has(cardId)) {\n return this.hydratedCards.get(cardId)!;\n }\n\n // Start hydration if not already in progress\n if (!this.hydrationInProgress) {\n void this.fillHydratedCards();\n }\n\n // Wait for the specific card to become available\n const maxWaitMs = 10000; // 10 second timeout\n const pollIntervalMs = 25;\n let elapsed = 0;\n\n while (elapsed < maxWaitMs) {\n if (this.hydratedCards.has(cardId)) {\n return this.hydratedCards.get(cardId)!;\n }\n\n // If the card is not in flight and not hydrated, it may have failed\n if (!this.hydrationInFlight.has(cardId) && !this.hydrationInProgress) {\n break;\n }\n\n await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));\n elapsed += pollIntervalMs;\n }\n\n return this.hydratedCards.get(cardId) ?? null;\n }\n\n /**\n * Get current hydrated cache size.\n */\n public get hydratedCount(): number {\n return this.hydratedCards.size;\n }\n\n /**\n * Get list of currently hydrated card IDs (for debugging).\n */\n public getHydratedCardIds(): string[] {\n return Array.from(this.hydratedCards.keys());\n }\n\n /**\n * Fill the hydrated cache by hydrating items from getItemsToHydrate().\n * This is a pure cache-warming operation - no queue mutation.\n */\n private async fillHydratedCards(): Promise<void> {\n if (this.hydrationInProgress) {\n return; // Prevent concurrent hydration\n }\n\n this.hydrationInProgress = true;\n // [perf] parked 2026-05 (pipeline-docs-workup) — batch hydration timing\n // const tFill0 = performance.now();\n // let hydratedThisBatch = 0;\n\n try {\n const itemsToHydrate = this.getItemsToHydrate();\n\n for (const item of itemsToHydrate) {\n // Skip if already hydrated or in flight\n if (this.hydratedCards.has(item.cardID) || this.hydrationInFlight.has(item.cardID)) {\n continue;\n }\n\n try {\n await this.hydrateCard(item);\n // hydratedThisBatch++; // [perf] parked\n } catch (e) {\n logger.error(`[CardHydrationService] Error hydrating card ${item.cardID}:`, e);\n }\n }\n } finally {\n this.hydrationInProgress = false;\n // [perf] parked: batch hydration timing\n // if (hydratedThisBatch > 0) {\n // logger.info(\n // `[perf][Hydrate] batch: hydrated ${hydratedThisBatch} card(s) in ` +\n // `${(performance.now() - tFill0).toFixed(0)}ms`\n // );\n // }\n }\n }\n\n /**\n * Hydrate a single card and add to cache.\n */\n private async hydrateCard(item: StudySessionItem): Promise<void> {\n if (this.hydratedCards.has(item.cardID) || this.hydrationInFlight.has(item.cardID)) {\n return; // Already hydrated or in progress\n }\n\n this.hydrationInFlight.add(item.cardID);\n\n try {\n // const tH0 = performance.now(); // [perf] parked\n const courseDB = this.getCourseDB(item.courseID);\n const [cardData, tagsByCard] = await Promise.all([\n courseDB.getCourseDoc<CardData>(item.cardID),\n courseDB.getAppliedTagsBatch([item.cardID]),\n ]);\n // const tFetch = performance.now(); // [perf] parked\n\n if (!isCourseElo(cardData.elo)) {\n cardData.elo = toCourseElo(cardData.elo);\n }\n\n const view = this.getViewComponent(cardData.id_view);\n const dataDocs = await Promise.all(\n cardData.id_displayable_data.map((id: string) =>\n courseDB.getCourseDoc<DisplayableData>(id, {\n attachments: true,\n binary: true,\n })\n )\n );\n // const tDocs = performance.now(); // [perf] parked\n\n // Extract audio URLs from all data fields and prefetch them\n const audioToPrefetch: string[] = [];\n dataDocs.forEach((dd) => {\n dd.data.forEach((f) => {\n audioToPrefetch.push(...parseAudioURIs(f.data));\n });\n });\n\n // Dedupe and prefetch, waiting for browser cache to be ready\n // const tAudioStart = performance.now(); // [perf] parked\n const uniqueAudioUrls = [...new Set(audioToPrefetch)];\n if (uniqueAudioUrls.length > 0) {\n logger.debug(\n `[CardHydrationService] Prefetching ${uniqueAudioUrls.length} audio files for card ${item.cardID}`\n );\n await Promise.allSettled(uniqueAudioUrls.map(prefetchAudio));\n }\n // const tAudio = performance.now(); // [perf] parked\n\n const data = dataDocs.map(displayableDataToViewData).reverse();\n\n // Attach the card doc's authored ELO to the item. Generators don't carry\n // card ELO onto StudySessionItems (reviews couldn't know it without a\n // lookup), so without this every downstream consumer of `item.elo` —\n // StudySession's `card_elo`, CardViewer's modify-difficulty, session\n // outcomes — fell back to the 1000 default for EVERY card. The doc is\n // already fetched here, making this the one seam that covers all card\n // origins for free. Copy rather than mutate: the queue holds the same\n // item reference.\n this.hydratedCards.set(item.cardID, {\n item: { ...item, elo: toCourseElo(cardData.elo).global.score },\n view,\n data,\n tags: tagsByCard.get(item.cardID) ?? [],\n });\n\n // [perf] parked: per-card hydration timing (cardDoc+tags / dataDocs / audio)\n // logger.info(\n // `[perf][Hydrate] ${item.cardID}: ` +\n // `cardDoc+tags=${(tFetch - tH0).toFixed(0)}ms ` +\n // `dataDocs=${(tDocs - tFetch).toFixed(0)}ms ` +\n // `audioPrefetch=${(tAudio - tAudioStart).toFixed(0)}ms(${uniqueAudioUrls.length} files) ` +\n // `total=${(tAudio - tH0).toFixed(0)}ms`\n // );\n logger.debug(`[CardHydrationService] Hydrated card ${item.cardID}`);\n } finally {\n this.hydrationInFlight.delete(item.cardID);\n }\n }\n}\n"],"mappings":"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"}