@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,320 @@
1
+ import "../../_virtual/_rolldown/runtime.mjs";
2
+ import { logger } from "../../util/logger.mjs";
3
+ import pouchdb_setup_default from "./pouchdb-setup.mjs";
4
+ import { getCourseDB } from "./index.mjs";
5
+ //#region src/impl/couch/CourseSyncService.ts
6
+ /**
7
+ * Written into the local replica when a sync completes. `_local/` docs don't
8
+ * replicate, so it describes this device's copy.
9
+ */
10
+ const SYNC_MARKER_ID = "_local/sk-course-sync-complete";
11
+ const DEFAULT_REPLICATION = {
12
+ batchSize: 1e3,
13
+ batchesLimit: 5
14
+ };
15
+ var CourseSyncService = class CourseSyncService {
16
+ static instance = null;
17
+ entries = /* @__PURE__ */ new Map();
18
+ replicationOptions = DEFAULT_REPLICATION;
19
+ constructor() {}
20
+ static getInstance() {
21
+ if (!CourseSyncService.instance) CourseSyncService.instance = new CourseSyncService();
22
+ return CourseSyncService.instance;
23
+ }
24
+ /**
25
+ * Apply replication tuning. Typically called once from `initializeDataLayer`.
26
+ * Partial overrides merge with defaults.
27
+ */
28
+ configure(opts) {
29
+ if (opts.replication) {
30
+ this.replicationOptions = {
31
+ ...DEFAULT_REPLICATION,
32
+ ...opts.replication
33
+ };
34
+ logger.info(`[CourseSyncService] Replication configured: batch_size=${this.replicationOptions.batchSize}, batches_limit=${this.replicationOptions.batchesLimit}`);
35
+ }
36
+ }
37
+ /**
38
+ * Reset the singleton (for testing).
39
+ */
40
+ static resetInstance() {
41
+ if (CourseSyncService.instance) {
42
+ for (const [, entry] of CourseSyncService.instance.entries) if (entry.localDB) entry.localDB.close().catch(() => {});
43
+ CourseSyncService.instance.entries.clear();
44
+ }
45
+ CourseSyncService.instance = null;
46
+ }
47
+ /**
48
+ * Ensure a course's local replica is synced.
49
+ *
50
+ * On first call for a course:
51
+ * 1. Fetches CourseConfig from remote to check localSync.enabled
52
+ * 2. If enabled, performs one-shot replication remote → local
53
+ * 3. Pre-warms PouchDB view indices (elo, getTags)
54
+ *
55
+ * On subsequent calls: returns immediately if already synced, or awaits
56
+ * the in-flight sync if one is in progress.
57
+ *
58
+ * Safe to call multiple times — concurrent calls coalesce to one sync.
59
+ *
60
+ * @param courseId - The course to sync
61
+ * @param forceEnabled - Skip the CourseConfig check and sync regardless.
62
+ * Useful when the caller already knows local sync is desired (e.g.,
63
+ * LettersPractice hardcodes this).
64
+ */
65
+ async ensureSynced(courseId, forceEnabled) {
66
+ const existing = this.entries.get(courseId);
67
+ if (existing?.status.state === "ready" && existing.localDB) return;
68
+ if (existing?.status.state === "disabled") return;
69
+ if (existing?.readyPromise) return existing.readyPromise;
70
+ const entry = {
71
+ localDB: null,
72
+ status: { state: "not-started" },
73
+ readyPromise: null
74
+ };
75
+ this.entries.set(courseId, entry);
76
+ entry.readyPromise = this.startSync(courseId, entry, forceEnabled);
77
+ return entry.readyPromise;
78
+ }
79
+ /**
80
+ * A replica completed on an earlier page load is ready now, refreshed in the
81
+ * background; anything else goes through a full performSync.
82
+ */
83
+ async startSync(courseId, entry, forceEnabled) {
84
+ const localDB = new pouchdb_setup_default(this.localDBName(courseId));
85
+ if (await this.hasSyncMarker(localDB)) {
86
+ entry.localDB = localDB;
87
+ entry.status = { state: "ready" };
88
+ entry.readyPromise = null;
89
+ logger.info(`[CourseSyncService] Using this device's replica of course ${courseId}; refreshing in the background`);
90
+ this.refreshInBackground(courseId, entry, forceEnabled);
91
+ return;
92
+ }
93
+ return this.performSync(courseId, entry, forceEnabled);
94
+ }
95
+ /**
96
+ * Bring a ready replica up to date without taking it away from readers.
97
+ * Failures leave it ready (and outdated).
98
+ */
99
+ async refreshInBackground(courseId, entry, forceEnabled) {
100
+ const localDB = entry.localDB;
101
+ try {
102
+ if (!forceEnabled && !await this.checkLocalSyncEnabled(courseId)) {
103
+ await this.clearSyncMarker(localDB);
104
+ logger.info(`[CourseSyncService] Local sync no longer enabled for course ${courseId}; replica kept for this page only`);
105
+ return;
106
+ }
107
+ if (await this.isLocalEpochStale(courseId, localDB)) {
108
+ await this.clearSyncMarker(localDB);
109
+ logger.info(`[CourseSyncService] Remote DB recreated for course ${courseId}: keeping the outdated replica for this page; it is rebuilt on the next page load`);
110
+ return;
111
+ }
112
+ const start = Date.now();
113
+ const result = await this.replicate(this.getRemoteDB(courseId), localDB);
114
+ const syncTimeMs = Date.now() - start;
115
+ const warmStart = Date.now();
116
+ await this.warmViewIndices(localDB);
117
+ const viewWarmTimeMs = Date.now() - warmStart;
118
+ await this.writeSyncMarker(localDB);
119
+ entry.status = {
120
+ state: "ready",
121
+ docsReplicated: result.docs_written,
122
+ syncTimeMs,
123
+ viewWarmTimeMs
124
+ };
125
+ logger.info(`[CourseSyncService] Background refresh of course ${courseId}: ${result.docs_written} docs in ${syncTimeMs}ms, views ${viewWarmTimeMs}ms`);
126
+ } catch (e) {
127
+ logger.warn(`[CourseSyncService] Background refresh of course ${courseId} failed; replica kept as is: ${e}`);
128
+ }
129
+ }
130
+ async hasSyncMarker(localDB) {
131
+ try {
132
+ await localDB.get(SYNC_MARKER_ID);
133
+ return true;
134
+ } catch {
135
+ return false;
136
+ }
137
+ }
138
+ async writeSyncMarker(localDB) {
139
+ try {
140
+ let _rev;
141
+ try {
142
+ _rev = (await localDB.get(SYNC_MARKER_ID))._rev;
143
+ } catch {}
144
+ await localDB.put({
145
+ _id: SYNC_MARKER_ID,
146
+ _rev,
147
+ completedAt: (/* @__PURE__ */ new Date()).toISOString()
148
+ });
149
+ } catch (e) {
150
+ logger.warn(`[CourseSyncService] Could not write sync marker: ${e}`);
151
+ }
152
+ }
153
+ async clearSyncMarker(localDB) {
154
+ try {
155
+ const marker = await localDB.get(SYNC_MARKER_ID);
156
+ await localDB.remove(marker);
157
+ } catch {}
158
+ }
159
+ /**
160
+ * Get the local PouchDB for a course, or null if not available.
161
+ *
162
+ * Returns null when:
163
+ * - Local sync is not enabled for this course
164
+ * - Sync has not been triggered yet
165
+ * - Sync is still in progress
166
+ * - Sync failed
167
+ */
168
+ getLocalDB(courseId) {
169
+ const entry = this.entries.get(courseId);
170
+ if (entry?.status.state === "ready" && entry.localDB) return entry.localDB;
171
+ return null;
172
+ }
173
+ /**
174
+ * Check whether a course has a ready local replica.
175
+ */
176
+ isReady(courseId) {
177
+ return this.entries.get(courseId)?.status.state === "ready";
178
+ }
179
+ /**
180
+ * Get detailed sync status for a course.
181
+ */
182
+ getStatus(courseId) {
183
+ return this.entries.get(courseId)?.status ?? { state: "not-started" };
184
+ }
185
+ async performSync(courseId, entry, forceEnabled) {
186
+ try {
187
+ if (!forceEnabled) {
188
+ entry.status = { state: "checking-config" };
189
+ if (!await this.checkLocalSyncEnabled(courseId)) {
190
+ entry.status = { state: "disabled" };
191
+ entry.readyPromise = null;
192
+ logger.debug(`[CourseSyncService] Local sync disabled for course ${courseId}`);
193
+ return;
194
+ }
195
+ }
196
+ entry.status = { state: "syncing" };
197
+ const localDBName = this.localDBName(courseId);
198
+ let localDB = new pouchdb_setup_default(localDBName);
199
+ if (await this.isLocalEpochStale(courseId, localDB)) {
200
+ logger.info(`[CourseSyncService] Stale local DB detected for course ${courseId} — destroying before sync`);
201
+ await localDB.destroy();
202
+ localDB = new pouchdb_setup_default(localDBName);
203
+ }
204
+ entry.localDB = localDB;
205
+ const remoteDB = this.getRemoteDB(courseId);
206
+ const syncStart = Date.now();
207
+ logger.info(`[CourseSyncService] Starting one-shot replication for course ${courseId} (batch_size=${this.replicationOptions.batchSize}, batches_limit=${this.replicationOptions.batchesLimit})`);
208
+ const result = await this.replicate(remoteDB, localDB);
209
+ const syncTimeMs = Date.now() - syncStart;
210
+ logger.info(`[CourseSyncService] Replication complete for course ${courseId}: ${result.docs_written} docs in ${syncTimeMs}ms`);
211
+ entry.status = { state: "warming-views" };
212
+ const warmStart = Date.now();
213
+ await this.warmViewIndices(localDB);
214
+ const viewWarmTimeMs = Date.now() - warmStart;
215
+ logger.info(`[CourseSyncService] View indices warmed for course ${courseId} in ${viewWarmTimeMs}ms`);
216
+ await this.writeSyncMarker(localDB);
217
+ entry.status = {
218
+ state: "ready",
219
+ docsReplicated: result.docs_written,
220
+ syncTimeMs,
221
+ viewWarmTimeMs
222
+ };
223
+ } catch (e) {
224
+ const errorMsg = e instanceof Error ? e.message : String(e);
225
+ logger.error(`[CourseSyncService] Sync failed for course ${courseId}: ${errorMsg}`);
226
+ entry.status = {
227
+ state: "error",
228
+ error: errorMsg
229
+ };
230
+ entry.readyPromise = null;
231
+ if (entry.localDB) {
232
+ try {
233
+ await entry.localDB.destroy();
234
+ } catch {}
235
+ entry.localDB = null;
236
+ }
237
+ }
238
+ }
239
+ /**
240
+ * Check CourseConfig.localSync.enabled on the remote DB.
241
+ */
242
+ async checkLocalSyncEnabled(courseId) {
243
+ try {
244
+ return (await this.getRemoteDB(courseId).get("CourseConfig")).localSync?.enabled === true;
245
+ } catch (e) {
246
+ logger.warn(`[CourseSyncService] Could not read CourseConfig for ${courseId}, assuming local sync disabled: ${e}`);
247
+ return false;
248
+ }
249
+ }
250
+ /**
251
+ * One-shot replication from remote to local.
252
+ */
253
+ replicate(source, target) {
254
+ return new Promise((resolve, reject) => {
255
+ pouchdb_setup_default.replicate(source, target, {
256
+ batch_size: this.replicationOptions.batchSize,
257
+ batches_limit: this.replicationOptions.batchesLimit
258
+ }).on("complete", (info) => {
259
+ resolve(info);
260
+ }).on("error", (err) => {
261
+ reject(err);
262
+ });
263
+ });
264
+ }
265
+ /**
266
+ * Pre-warm PouchDB view indices by running a minimal query against each
267
+ * design doc. This forces PouchDB to build the MapReduce index now
268
+ * (during a loading phase) rather than on first pipeline query.
269
+ */
270
+ async warmViewIndices(localDB) {
271
+ for (const viewName of ["elo", "getTags"]) try {
272
+ await localDB.query(viewName, { limit: 1 });
273
+ logger.debug(`[CourseSyncService] Warmed view index: ${viewName}`);
274
+ } catch (e) {
275
+ logger.debug(`[CourseSyncService] Could not warm view ${viewName}: ${e}`);
276
+ }
277
+ }
278
+ /**
279
+ * Check whether the local replica's `db-epoch` doc matches the remote.
280
+ *
281
+ * The seed script (and optionally upload-cards) writes a `db-epoch`
282
+ * document with a numeric timestamp. If the remote epoch differs from
283
+ * the local copy, the remote DB was recreated (e.g., `yarn db:seed`)
284
+ * and the local PouchDB is stale.
285
+ *
286
+ * Returns `true` if stale (epoch mismatch or remote has epoch but local
287
+ * doesn't). Returns `false` (not stale) if epochs match, or if the
288
+ * remote doesn't have an epoch doc at all (backwards compat).
289
+ */
290
+ async isLocalEpochStale(courseId, localDB) {
291
+ try {
292
+ const remoteEpoch = await this.getRemoteDB(courseId).get("db-epoch");
293
+ let localEpoch = null;
294
+ try {
295
+ localEpoch = await localDB.get("db-epoch");
296
+ } catch {
297
+ return true;
298
+ }
299
+ return remoteEpoch.epoch !== localEpoch.epoch;
300
+ } catch {
301
+ return false;
302
+ }
303
+ }
304
+ /**
305
+ * Get a remote PouchDB handle for a course.
306
+ */
307
+ getRemoteDB(courseId) {
308
+ return getCourseDB(courseId);
309
+ }
310
+ /**
311
+ * Local DB naming convention.
312
+ */
313
+ localDBName(courseId) {
314
+ return `coursedb-local-${courseId}`;
315
+ }
316
+ };
317
+ //#endregion
318
+ export { CourseSyncService };
319
+
320
+ //# sourceMappingURL=CourseSyncService.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"CourseSyncService.mjs","names":["pouch"],"sources":["../../../src/impl/couch/CourseSyncService.ts"],"sourcesContent":["import pouch from './pouchdb-setup';\nimport { getCourseDB } from '.';\nimport { logger } from '../../util/logger';\nimport type { CourseConfig } from '@vue-skuilder/common';\n\n// ============================================================================\n// COURSE SYNC SERVICE\n// ============================================================================\n//\n// Manages client-side PouchDB replicas of course databases.\n//\n// Courses opt in to local sync via CourseConfig.localSync.enabled. When\n// enabled, the service performs a one-shot replication from remote CouchDB\n// to a local PouchDB on first visit, then incremental sync on subsequent\n// visits. Pipeline scoring, tag hydration, and card lookup then run against\n// the local replica — eliminating network round trips from the study-session\n// hot path.\n//\n// Read/write split:\n// Local DB = read-only snapshot (pipeline, filters, card lookup)\n// Remote DB = all writes (ELO updates, tag mutations, admin ops)\n//\n// This avoids propagating per-interaction ELO write noise to every syncing\n// client. Each client's local snapshot refreshes on the next page load.\n//\n// A replica that completed a sync on an earlier page load carries a\n// `_local/` marker, and is handed out as ready immediately; its refresh\n// (epoch check, incremental pull, view warming) runs in the background, into\n// the same DB. Sessions may therefore start on the previous visit's data and\n// catch up seconds later. If that refresh finds the remote DB recreated (an\n// epoch change), the replica is NOT destroyed under running readers: the\n// marker is dropped, this page keeps the outdated copy, and the next page\n// load rebuilds it from scratch (the path a device without a replica takes).\n//\n// Live replication is intentionally NOT supported. The remote course DB\n// receives high-frequency ELO updates from all concurrent users — live\n// sync would cause constant re-indexing of local PouchDB views.\n//\n// ============================================================================\n\n/**\n * Sync state for a single course database.\n */\nexport type CourseSyncState =\n | 'not-started'\n | 'checking-config'\n | 'syncing'\n | 'warming-views'\n | 'ready'\n | 'disabled'\n | 'error';\n\n/**\n * Written into the local replica when a sync completes. `_local/` docs don't\n * replicate, so it describes this device's copy.\n */\nconst SYNC_MARKER_ID = '_local/sk-course-sync-complete';\n\n/**\n * Detailed sync status for observability.\n */\nexport interface CourseSyncStatus {\n state: CourseSyncState;\n /** Number of documents replicated (set after sync completes) */\n docsReplicated?: number;\n /** Total replication time in ms */\n syncTimeMs?: number;\n /** View warming time in ms */\n viewWarmTimeMs?: number;\n /** Error message if state is 'error' */\n error?: string;\n}\n\n/**\n * Internal tracking entry per course.\n */\ninterface SyncEntry {\n localDB: PouchDB.Database | null;\n status: CourseSyncStatus;\n /** Promise that resolves when sync is complete (or rejects on failure) */\n readyPromise: Promise<void> | null;\n}\n\n/**\n * Service that manages local PouchDB replicas of course databases.\n *\n * Usage:\n * ```typescript\n * const syncService = CourseSyncService.getInstance();\n *\n * // Trigger sync (typically on app load / pre-session)\n * await syncService.ensureSynced(courseId);\n *\n * // Get local DB for reads (returns null if sync not ready/enabled)\n * const localDB = syncService.getLocalDB(courseId);\n * ```\n *\n * The service is a singleton — course sync state is shared across the app.\n */\n/**\n * Tuning knobs for one-shot remote→local replication.\n * Defaults are chosen for one-shot snapshot replication of bounded course\n * corpora (text/JSON docs, no large attachments). PouchDB's built-in\n * defaults (100/10) target live continuous sync — too conservative for\n * cold-load UX on a course of a few thousand docs.\n *\n * Apps with smaller/larger corpora can override via\n * `initializeDataLayer({ options: { courseSync: { replication: {...} } } })`.\n */\nexport interface ReplicationOptions {\n /** Docs per `_bulk_get` HTTP request. Higher = fewer roundtrips. */\n batchSize?: number;\n /** Concurrent batches in flight. */\n batchesLimit?: number;\n}\n\nconst DEFAULT_REPLICATION: Required<ReplicationOptions> = {\n batchSize: 1000,\n batchesLimit: 5,\n};\n\nexport class CourseSyncService {\n private static instance: CourseSyncService | null = null;\n\n private entries: Map<string, SyncEntry> = new Map();\n private replicationOptions: Required<ReplicationOptions> = DEFAULT_REPLICATION;\n\n private constructor() {}\n\n static getInstance(): CourseSyncService {\n if (!CourseSyncService.instance) {\n CourseSyncService.instance = new CourseSyncService();\n }\n return CourseSyncService.instance;\n }\n\n /**\n * Apply replication tuning. Typically called once from `initializeDataLayer`.\n * Partial overrides merge with defaults.\n */\n configure(opts: { replication?: ReplicationOptions }): void {\n if (opts.replication) {\n this.replicationOptions = {\n ...DEFAULT_REPLICATION,\n ...opts.replication,\n };\n logger.info(\n `[CourseSyncService] Replication configured: ` +\n `batch_size=${this.replicationOptions.batchSize}, ` +\n `batches_limit=${this.replicationOptions.batchesLimit}`\n );\n }\n }\n\n /**\n * Reset the singleton (for testing).\n */\n static resetInstance(): void {\n if (CourseSyncService.instance) {\n // Close all local DBs\n for (const [, entry] of CourseSyncService.instance.entries) {\n if (entry.localDB) {\n entry.localDB.close().catch(() => {});\n }\n }\n CourseSyncService.instance.entries.clear();\n }\n CourseSyncService.instance = null;\n }\n\n // --------------------------------------------------------------------------\n // Public API\n // --------------------------------------------------------------------------\n\n /**\n * Ensure a course's local replica is synced.\n *\n * On first call for a course:\n * 1. Fetches CourseConfig from remote to check localSync.enabled\n * 2. If enabled, performs one-shot replication remote → local\n * 3. Pre-warms PouchDB view indices (elo, getTags)\n *\n * On subsequent calls: returns immediately if already synced, or awaits\n * the in-flight sync if one is in progress.\n *\n * Safe to call multiple times — concurrent calls coalesce to one sync.\n *\n * @param courseId - The course to sync\n * @param forceEnabled - Skip the CourseConfig check and sync regardless.\n * Useful when the caller already knows local sync is desired (e.g.,\n * LettersPractice hardcodes this).\n */\n async ensureSynced(courseId: string, forceEnabled?: boolean): Promise<void> {\n const existing = this.entries.get(courseId);\n\n // Ready on this page load. Its epoch was checked on the way (by\n // performSync, or by the background refresh, which keeps an outdated\n // replica rather than destroy it under running sessions).\n if (existing?.status.state === 'ready' && existing.localDB) {\n return;\n }\n\n // Already disabled\n if (existing?.status.state === 'disabled') {\n return;\n }\n\n // Sync in flight — coalesce\n if (existing?.readyPromise) {\n return existing.readyPromise;\n }\n\n // Start a new sync\n const entry: SyncEntry = {\n localDB: null,\n status: { state: 'not-started' },\n readyPromise: null,\n };\n this.entries.set(courseId, entry);\n\n entry.readyPromise = this.startSync(courseId, entry, forceEnabled);\n return entry.readyPromise;\n }\n\n /**\n * A replica completed on an earlier page load is ready now, refreshed in the\n * background; anything else goes through a full performSync.\n */\n private async startSync(\n courseId: string,\n entry: SyncEntry,\n forceEnabled?: boolean\n ): Promise<void> {\n const localDB = new pouch(this.localDBName(courseId));\n if (await this.hasSyncMarker(localDB)) {\n entry.localDB = localDB;\n entry.status = { state: 'ready' };\n entry.readyPromise = null;\n logger.info(\n `[CourseSyncService] Using this device's replica of course ${courseId}; refreshing in the background`\n );\n void this.refreshInBackground(courseId, entry, forceEnabled);\n return;\n }\n return this.performSync(courseId, entry, forceEnabled);\n }\n\n /**\n * Bring a ready replica up to date without taking it away from readers.\n * Failures leave it ready (and outdated).\n */\n private async refreshInBackground(\n courseId: string,\n entry: SyncEntry,\n forceEnabled?: boolean\n ): Promise<void> {\n const localDB = entry.localDB!;\n try {\n if (!forceEnabled && !(await this.checkLocalSyncEnabled(courseId))) {\n await this.clearSyncMarker(localDB);\n logger.info(\n `[CourseSyncService] Local sync no longer enabled for course ${courseId}; replica kept for this page only`\n );\n return;\n }\n\n if (await this.isLocalEpochStale(courseId, localDB)) {\n await this.clearSyncMarker(localDB);\n logger.info(\n `[CourseSyncService] Remote DB recreated for course ${courseId}: keeping the outdated replica ` +\n `for this page; it is rebuilt on the next page load`\n );\n return;\n }\n\n const start = Date.now();\n const result = await this.replicate(this.getRemoteDB(courseId), localDB);\n const syncTimeMs = Date.now() - start;\n const warmStart = Date.now();\n await this.warmViewIndices(localDB);\n const viewWarmTimeMs = Date.now() - warmStart;\n await this.writeSyncMarker(localDB);\n entry.status = {\n state: 'ready',\n docsReplicated: result.docs_written,\n syncTimeMs,\n viewWarmTimeMs,\n };\n logger.info(\n `[CourseSyncService] Background refresh of course ${courseId}: ` +\n `${result.docs_written} docs in ${syncTimeMs}ms, views ${viewWarmTimeMs}ms`\n );\n } catch (e) {\n logger.warn(\n `[CourseSyncService] Background refresh of course ${courseId} failed; replica kept as is: ${e}`\n );\n }\n }\n\n private async hasSyncMarker(localDB: PouchDB.Database): Promise<boolean> {\n try {\n await localDB.get(SYNC_MARKER_ID);\n return true;\n } catch {\n return false;\n }\n }\n\n private async writeSyncMarker(localDB: PouchDB.Database): Promise<void> {\n try {\n let _rev: string | undefined;\n try {\n _rev = (await localDB.get(SYNC_MARKER_ID))._rev;\n } catch {\n // First completion on this device.\n }\n await localDB.put({ _id: SYNC_MARKER_ID, _rev, completedAt: new Date().toISOString() });\n } catch (e) {\n // Costs the next page load the full-sync path, not correctness.\n logger.warn(`[CourseSyncService] Could not write sync marker: ${e}`);\n }\n }\n\n private async clearSyncMarker(localDB: PouchDB.Database): Promise<void> {\n try {\n const marker = await localDB.get(SYNC_MARKER_ID);\n await localDB.remove(marker);\n } catch {\n // Absent already.\n }\n }\n\n /**\n * Get the local PouchDB for a course, or null if not available.\n *\n * Returns null when:\n * - Local sync is not enabled for this course\n * - Sync has not been triggered yet\n * - Sync is still in progress\n * - Sync failed\n */\n getLocalDB(courseId: string): PouchDB.Database | null {\n const entry = this.entries.get(courseId);\n if (entry?.status.state === 'ready' && entry.localDB) {\n return entry.localDB;\n }\n return null;\n }\n\n /**\n * Check whether a course has a ready local replica.\n */\n isReady(courseId: string): boolean {\n return this.entries.get(courseId)?.status.state === 'ready';\n }\n\n /**\n * Get detailed sync status for a course.\n */\n getStatus(courseId: string): CourseSyncStatus {\n return (\n this.entries.get(courseId)?.status ?? { state: 'not-started' }\n );\n }\n\n // --------------------------------------------------------------------------\n // Internal\n // --------------------------------------------------------------------------\n\n private async performSync(\n courseId: string,\n entry: SyncEntry,\n forceEnabled?: boolean\n ): Promise<void> {\n try {\n // Step 1: Check if local sync is enabled for this course\n if (!forceEnabled) {\n entry.status = { state: 'checking-config' };\n const enabled = await this.checkLocalSyncEnabled(courseId);\n if (!enabled) {\n entry.status = { state: 'disabled' };\n entry.readyPromise = null;\n logger.debug(\n `[CourseSyncService] Local sync disabled for course ${courseId}`\n );\n return;\n }\n }\n\n // Step 2: Create local PouchDB and replicate\n entry.status = { state: 'syncing' };\n const localDBName = this.localDBName(courseId);\n let localDB = new pouch(localDBName);\n\n // Check for stale local replica before replicating. If the remote DB\n // was wiped and recreated (e.g., `yarn db:seed`), the local PouchDB\n // has documents at rev 1-oldHash while the remote has 1-newHash for\n // the same _ids. PouchDB replication treats this as a conflict rather\n // than an update, and the stale revision can win — causing partial or\n // incorrect data. Destroying the stale local DB avoids this entirely.\n const stale = await this.isLocalEpochStale(courseId, localDB);\n if (stale) {\n logger.info(\n `[CourseSyncService] Stale local DB detected for course ${courseId} — destroying before sync`\n );\n await localDB.destroy();\n localDB = new pouch(localDBName);\n }\n\n entry.localDB = localDB;\n\n const remoteDB = this.getRemoteDB(courseId);\n const syncStart = Date.now();\n\n logger.info(\n `[CourseSyncService] Starting one-shot replication for course ${courseId} ` +\n `(batch_size=${this.replicationOptions.batchSize}, ` +\n `batches_limit=${this.replicationOptions.batchesLimit})`\n );\n\n const result = await this.replicate(remoteDB, localDB);\n const syncTimeMs = Date.now() - syncStart;\n\n logger.info(\n `[CourseSyncService] Replication complete for course ${courseId}: ` +\n `${result.docs_written} docs in ${syncTimeMs}ms`\n );\n\n // Step 3: Pre-warm view indices\n entry.status = { state: 'warming-views' };\n const warmStart = Date.now();\n await this.warmViewIndices(localDB);\n const viewWarmTimeMs = Date.now() - warmStart;\n\n logger.info(\n `[CourseSyncService] View indices warmed for course ${courseId} in ${viewWarmTimeMs}ms`\n );\n\n await this.writeSyncMarker(localDB);\n\n // Done\n entry.status = {\n state: 'ready',\n docsReplicated: result.docs_written,\n syncTimeMs,\n viewWarmTimeMs,\n };\n } catch (e) {\n const errorMsg = e instanceof Error ? e.message : String(e);\n logger.error(\n `[CourseSyncService] Sync failed for course ${courseId}: ${errorMsg}`\n );\n entry.status = { state: 'error', error: errorMsg };\n entry.readyPromise = null;\n\n // Clean up the local DB on failure — don't leave a partial replica\n if (entry.localDB) {\n try {\n await entry.localDB.destroy();\n } catch {\n // Ignore cleanup errors\n }\n entry.localDB = null;\n }\n }\n }\n\n /**\n * Check CourseConfig.localSync.enabled on the remote DB.\n */\n private async checkLocalSyncEnabled(courseId: string): Promise<boolean> {\n try {\n const remoteDB = this.getRemoteDB(courseId);\n const config = await remoteDB.get<CourseConfig>('CourseConfig');\n return config.localSync?.enabled === true;\n } catch (e) {\n logger.warn(\n `[CourseSyncService] Could not read CourseConfig for ${courseId}, ` +\n `assuming local sync disabled: ${e}`\n );\n return false;\n }\n }\n\n /**\n * One-shot replication from remote to local.\n */\n private replicate(\n source: PouchDB.Database,\n target: PouchDB.Database\n ): Promise<PouchDB.Replication.ReplicationResultComplete<object>> {\n return new Promise((resolve, reject) => {\n void pouch.replicate(source, target, {\n // One-shot, not live. Local is a read-only snapshot.\n batch_size: this.replicationOptions.batchSize,\n batches_limit: this.replicationOptions.batchesLimit,\n })\n .on('complete', (info) => {\n resolve(info);\n })\n .on('error', (err) => {\n reject(err);\n });\n });\n }\n\n /**\n * Pre-warm PouchDB view indices by running a minimal query against each\n * design doc. This forces PouchDB to build the MapReduce index now\n * (during a loading phase) rather than on first pipeline query.\n */\n private async warmViewIndices(localDB: PouchDB.Database): Promise<void> {\n const viewsToWarm = ['elo', 'getTags'];\n\n for (const viewName of viewsToWarm) {\n try {\n await localDB.query(viewName, { limit: 1 });\n logger.debug(\n `[CourseSyncService] Warmed view index: ${viewName}`\n );\n } catch (e) {\n // View might not exist in this course DB — that's OK.\n // Not all courses have all design docs.\n logger.debug(\n `[CourseSyncService] Could not warm view ${viewName}: ${e}`\n );\n }\n }\n }\n\n /**\n * Check whether the local replica's `db-epoch` doc matches the remote.\n *\n * The seed script (and optionally upload-cards) writes a `db-epoch`\n * document with a numeric timestamp. If the remote epoch differs from\n * the local copy, the remote DB was recreated (e.g., `yarn db:seed`)\n * and the local PouchDB is stale.\n *\n * Returns `true` if stale (epoch mismatch or remote has epoch but local\n * doesn't). Returns `false` (not stale) if epochs match, or if the\n * remote doesn't have an epoch doc at all (backwards compat).\n */\n private async isLocalEpochStale(\n courseId: string,\n localDB: PouchDB.Database\n ): Promise<boolean> {\n try {\n const remoteDB = this.getRemoteDB(courseId);\n const remoteEpoch = await remoteDB.get<{ epoch: number }>('db-epoch');\n\n let localEpoch: { epoch: number } | null = null;\n try {\n localEpoch = await localDB.get<{ epoch: number }>('db-epoch');\n } catch {\n // Local doesn't have the epoch doc — stale\n return true;\n }\n\n return remoteEpoch.epoch !== localEpoch.epoch;\n } catch {\n // Remote doesn't have db-epoch — no epoch tracking, not stale\n return false;\n }\n }\n\n /**\n * Get a remote PouchDB handle for a course.\n */\n private getRemoteDB(courseId: string): PouchDB.Database {\n return getCourseDB(courseId);\n }\n\n /**\n * Local DB naming convention.\n */\n private localDBName(courseId: string): string {\n return `coursedb-local-${courseId}`;\n }\n}"],"mappings":"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"}
@@ -0,0 +1,89 @@
1
+ import "../../_virtual/_rolldown/runtime.mjs";
2
+ import { logger } from "../../util/logger.mjs";
3
+ import { AdminDB } from "./adminDB.mjs";
4
+ import { CourseDB, CoursesDB } from "./courseDB.mjs";
5
+ import { initializeDataDirectory } from "../../util/dataDirectory.mjs";
6
+ import { BaseUser } from "../common/BaseUserDB.mjs";
7
+ import { CourseSyncService } from "./CourseSyncService.mjs";
8
+ import { CouchDBSyncStrategy } from "./CouchDBSyncStrategy.mjs";
9
+ import { StudentClassroomDB, TeacherClassroomDB } from "./classroomDB.mjs";
10
+ //#region src/impl/couch/PouchDataLayerProvider.ts
11
+ var CouchDataLayerProvider = class {
12
+ initialized = false;
13
+ userDB;
14
+ currentUsername = "";
15
+ _courseIDs = [];
16
+ /**
17
+ * One CourseDB per course, so its caches (navigator, ELO pool, tags) last
18
+ * across sessions and card hydration. Rebuilt when the local replica it reads
19
+ * from changes (becomes ready, or is replaced); a session keeps the instance
20
+ * it started with.
21
+ */
22
+ _courseDBs = /* @__PURE__ */ new Map();
23
+ constructor(coursIDs) {
24
+ if (coursIDs) this._courseIDs = coursIDs;
25
+ }
26
+ async initialize() {
27
+ if (this.initialized) return;
28
+ if (typeof process !== "undefined" && process.versions != null && process.versions.node != null) {
29
+ logger.info("CouchDataLayerProvider: Running in Node.js environment, creating guest UserDB for testing.");
30
+ await initializeDataDirectory();
31
+ const syncStrategy = new CouchDBSyncStrategy();
32
+ this.userDB = await BaseUser.instance(syncStrategy);
33
+ } else {
34
+ const syncStrategy = new CouchDBSyncStrategy();
35
+ this.userDB = await BaseUser.instance(syncStrategy);
36
+ this.currentUsername = this.userDB.getUsername();
37
+ logger.debug(`Current username: ${this.currentUsername}`);
38
+ }
39
+ this.initialized = true;
40
+ }
41
+ async teardown() {
42
+ this.initialized = false;
43
+ }
44
+ getUserDB() {
45
+ return this.userDB;
46
+ }
47
+ getCourseDB(courseId) {
48
+ const localDB = CourseSyncService.getInstance().getLocalDB(courseId);
49
+ const cached = this._courseDBs.get(courseId);
50
+ if (cached && cached.localDB === localDB) return cached.db;
51
+ const db = new CourseDB(courseId, async () => this.getUserDB(), localDB ?? void 0);
52
+ this._courseDBs.set(courseId, {
53
+ db,
54
+ localDB
55
+ });
56
+ return db;
57
+ }
58
+ /**
59
+ * Trigger local sync for a course. Call during app initialization or
60
+ * pre-session loading for courses that opt in via CourseConfig.localSync.
61
+ *
62
+ * Safe to call multiple times — concurrent calls coalesce. Returns when
63
+ * sync is complete (or immediately if already synced / disabled).
64
+ *
65
+ * @param courseId - The course to sync locally
66
+ * @param forceEnabled - Skip CourseConfig check and sync regardless.
67
+ * Use when the caller already knows local sync is desired.
68
+ */
69
+ async ensureCourseSynced(courseId, forceEnabled) {
70
+ return CourseSyncService.getInstance().ensureSynced(courseId, forceEnabled);
71
+ }
72
+ getCoursesDB() {
73
+ return new CoursesDB(this._courseIDs);
74
+ }
75
+ async getClassroomDB(classId, type) {
76
+ if (type === "student") return await StudentClassroomDB.factory(classId, this.getUserDB());
77
+ else return await TeacherClassroomDB.factory(classId);
78
+ }
79
+ getAdminDB() {
80
+ return new AdminDB();
81
+ }
82
+ isReadOnly() {
83
+ return false;
84
+ }
85
+ };
86
+ //#endregion
87
+ export { CouchDataLayerProvider };
88
+
89
+ //# sourceMappingURL=PouchDataLayerProvider.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"PouchDataLayerProvider.mjs","names":[],"sources":["../../../src/impl/couch/PouchDataLayerProvider.ts"],"sourcesContent":["// db/src/impl/couch/PouchDataLayerProvider.ts\n\nimport {\n AdminDBInterface,\n ClassroomDBInterface,\n CoursesDBInterface,\n CourseDBInterface,\n DataLayerProvider,\n UserDBInterface,\n} from '../../core/interfaces';\nimport { logger } from '../../util/logger';\nimport { initializeDataDirectory } from '../../util/dataDirectory';\n\nimport { AdminDB } from './adminDB';\nimport { StudentClassroomDB, TeacherClassroomDB } from './classroomDB';\nimport { CourseDB, CoursesDB } from './courseDB';\nimport { CourseSyncService } from './CourseSyncService';\n\nimport { BaseUser } from '../common';\nimport { CouchDBSyncStrategy } from './CouchDBSyncStrategy';\n\nexport class CouchDataLayerProvider implements DataLayerProvider {\n private initialized: boolean = false;\n private userDB!: UserDBInterface;\n private currentUsername: string = '';\n\n // the scoped list of courseIDs for a UI focused on a specific course\n // or group of courses\n private _courseIDs: string[] = [];\n\n /**\n * One CourseDB per course, so its caches (navigator, ELO pool, tags) last\n * across sessions and card hydration. Rebuilt when the local replica it reads\n * from changes (becomes ready, or is replaced); a session keeps the instance\n * it started with.\n */\n private _courseDBs = new Map<string, { db: CourseDB; localDB: PouchDB.Database | null }>();\n\n constructor(coursIDs?: string[]) {\n if (coursIDs) {\n this._courseIDs = coursIDs;\n }\n }\n\n async initialize(): Promise<void> {\n if (this.initialized) return;\n\n // Check if we are in a Node.js environment\n const isNodeEnvironment =\n typeof process !== 'undefined' && process.versions != null && process.versions.node != null;\n\n if (isNodeEnvironment) {\n logger.info(\n 'CouchDataLayerProvider: Running in Node.js environment, creating guest UserDB for testing.'\n );\n await initializeDataDirectory();\n // In Node.js (testing) environment, create a guest user instance\n const syncStrategy = new CouchDBSyncStrategy();\n this.userDB = await BaseUser.instance(syncStrategy);\n } else {\n // Assume browser-like environment, proceed with user session logic\n // Let CouchDBSyncStrategy.getCurrentUsername() handle both logged-in and guest users\n const syncStrategy = new CouchDBSyncStrategy();\n this.userDB = await BaseUser.instance(syncStrategy);\n this.currentUsername = this.userDB.getUsername();\n logger.debug(`Current username: ${this.currentUsername}`);\n }\n\n this.initialized = true;\n }\n\n async teardown(): Promise<void> {\n // Close connections, etc.\n this.initialized = false;\n }\n\n getUserDB(): UserDBInterface {\n return this.userDB;\n }\n\n getCourseDB(courseId: string): CourseDBInterface {\n // If the CourseSyncService has a ready local replica for this course,\n // pass it to CourseDB so reads (pipeline, card hydration) run locally.\n // Writes always go to the remote DB (handled inside CourseDB).\n const localDB = CourseSyncService.getInstance().getLocalDB(courseId);\n const cached = this._courseDBs.get(courseId);\n if (cached && cached.localDB === localDB) return cached.db;\n\n const db = new CourseDB(courseId, async () => this.getUserDB(), localDB ?? undefined);\n this._courseDBs.set(courseId, { db, localDB });\n return db;\n }\n\n /**\n * Trigger local sync for a course. Call during app initialization or\n * pre-session loading for courses that opt in via CourseConfig.localSync.\n *\n * Safe to call multiple times — concurrent calls coalesce. Returns when\n * sync is complete (or immediately if already synced / disabled).\n *\n * @param courseId - The course to sync locally\n * @param forceEnabled - Skip CourseConfig check and sync regardless.\n * Use when the caller already knows local sync is desired.\n */\n async ensureCourseSynced(courseId: string, forceEnabled?: boolean): Promise<void> {\n return CourseSyncService.getInstance().ensureSynced(courseId, forceEnabled);\n }\n\n getCoursesDB(): CoursesDBInterface {\n return new CoursesDB(this._courseIDs);\n }\n\n async getClassroomDB(\n classId: string,\n type: 'student' | 'teacher'\n ): Promise<ClassroomDBInterface> {\n if (type === 'student') {\n return await StudentClassroomDB.factory(classId, this.getUserDB());\n } else {\n return await TeacherClassroomDB.factory(classId);\n }\n }\n\n getAdminDB(): AdminDBInterface {\n return new AdminDB();\n }\n\n isReadOnly(): boolean {\n return false;\n }\n}\n"],"mappings":";;;;;;;;;;AAqBA,IAAa,yBAAb,MAAiE;CAC/D,cAA+B;CAC/B;CACA,kBAAkC;CAIlC,aAA+B,EAAE;;;;;;;CAQjC,6BAAqB,IAAI,KAAiE;CAE1F,YAAY,UAAqB;AAC/B,MAAI,SACF,MAAK,aAAa;;CAItB,MAAM,aAA4B;AAChC,MAAI,KAAK,YAAa;AAMtB,MAFE,OAAO,YAAY,eAAe,QAAQ,YAAY,QAAQ,QAAQ,SAAS,QAAQ,MAElE;AACrB,UAAO,KACL,6FACD;AACD,SAAM,yBAAyB;GAE/B,MAAM,eAAe,IAAI,qBAAqB;AAC9C,QAAK,SAAS,MAAM,SAAS,SAAS,aAAa;SAC9C;GAGL,MAAM,eAAe,IAAI,qBAAqB;AAC9C,QAAK,SAAS,MAAM,SAAS,SAAS,aAAa;AACnD,QAAK,kBAAkB,KAAK,OAAO,aAAa;AAChD,UAAO,MAAM,qBAAqB,KAAK,kBAAkB;;AAG3D,OAAK,cAAc;;CAGrB,MAAM,WAA0B;AAE9B,OAAK,cAAc;;CAGrB,YAA6B;AAC3B,SAAO,KAAK;;CAGd,YAAY,UAAqC;EAI/C,MAAM,UAAU,kBAAkB,aAAa,CAAC,WAAW,SAAS;EACpE,MAAM,SAAS,KAAK,WAAW,IAAI,SAAS;AAC5C,MAAI,UAAU,OAAO,YAAY,QAAS,QAAO,OAAO;EAExD,MAAM,KAAK,IAAI,SAAS,UAAU,YAAY,KAAK,WAAW,EAAE,WAAW,KAAA,EAAU;AACrF,OAAK,WAAW,IAAI,UAAU;GAAE;GAAI;GAAS,CAAC;AAC9C,SAAO;;;;;;;;;;;;;CAcT,MAAM,mBAAmB,UAAkB,cAAuC;AAChF,SAAO,kBAAkB,aAAa,CAAC,aAAa,UAAU,aAAa;;CAG7E,eAAmC;AACjC,SAAO,IAAI,UAAU,KAAK,WAAW;;CAGvC,MAAM,eACJ,SACA,MAC+B;AAC/B,MAAI,SAAS,UACX,QAAO,MAAM,mBAAmB,QAAQ,SAAS,KAAK,WAAW,CAAC;MAElE,QAAO,MAAM,mBAAmB,QAAQ,QAAQ;;CAIpD,aAA+B;AAC7B,SAAO,IAAI,SAAS;;CAGtB,aAAsB;AACpB,SAAO"}
@@ -0,0 +1,61 @@
1
+ import "../../_virtual/_rolldown/runtime.mjs";
2
+ import { logger } from "../../util/logger.mjs";
3
+ import { ENV } from "../../factory.mjs";
4
+ import pouchdb_setup_default from "./pouchdb-setup.mjs";
5
+ import CourseLookup from "./courseLookupDB.mjs";
6
+ import { updateCredentialledCourseConfig } from "./courseDB.mjs";
7
+ import { getCredentialledCourseConfig } from "./courseAPI.mjs";
8
+ import { createPouchDBConfig, getStartAndEndKeys } from "./index.mjs";
9
+ import { ClassroomLookupDB, TeacherClassroomDB } from "./classroomDB.mjs";
10
+ //#region src/impl/couch/adminDB.ts
11
+ var AdminDB = class {
12
+ usersDB;
13
+ constructor() {
14
+ this.usersDB = new pouchdb_setup_default(ENV.COUCHDB_SERVER_PROTOCOL + "://" + ENV.COUCHDB_SERVER_URL + "_users", createPouchDBConfig());
15
+ }
16
+ async getUsers() {
17
+ return (await this.usersDB.allDocs({
18
+ include_docs: true,
19
+ ...getStartAndEndKeys("org.couchdb.user:")
20
+ })).rows.map((r) => r.doc);
21
+ }
22
+ async getCourses() {
23
+ const list = await CourseLookup.allCourseWare();
24
+ return await Promise.all(list.map((c) => {
25
+ return getCredentialledCourseConfig(c._id);
26
+ }));
27
+ }
28
+ async removeCourse(id) {
29
+ const delResp = await CourseLookup.delete(id);
30
+ const cfg = await getCredentialledCourseConfig(id);
31
+ cfg.deleted = true;
32
+ const isDeletedResp = await updateCredentialledCourseConfig(id, cfg);
33
+ return {
34
+ ok: delResp.ok && isDeletedResp.ok,
35
+ id: delResp.id,
36
+ rev: delResp.rev
37
+ };
38
+ }
39
+ async getClassrooms() {
40
+ const uuids = (await ClassroomLookupDB().allDocs({ include_docs: true })).rows.map((r) => r.doc.uuid);
41
+ logger.debug(uuids.join(", "));
42
+ const promisedCRDbs = [];
43
+ for (let i = 0; i < uuids.length; i++) try {
44
+ const db = await TeacherClassroomDB.factory(uuids[i]);
45
+ promisedCRDbs.push(db);
46
+ } catch (e) {
47
+ const err = e;
48
+ if (err.error && err.error === "not_found") logger.warn(`db ${uuids[i]} not found`);
49
+ }
50
+ return promisedCRDbs.map((db) => {
51
+ return {
52
+ ...db.getConfig(),
53
+ _id: db._id
54
+ };
55
+ });
56
+ }
57
+ };
58
+ //#endregion
59
+ export { AdminDB };
60
+
61
+ //# sourceMappingURL=adminDB.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"adminDB.mjs","names":["pouch"],"sources":["../../../src/impl/couch/adminDB.ts"],"sourcesContent":["import pouch from './pouchdb-setup';\nimport { ENV } from '@db/factory';\nimport {\n createPouchDBConfig,\n getStartAndEndKeys,\n getCredentialledCourseConfig,\n updateCredentialledCourseConfig,\n} from '.';\nimport { TeacherClassroomDB, ClassroomLookupDB } from './classroomDB';\nimport { PouchError } from './types';\n\nimport { AdminDBInterface } from '@db/core';\nimport CourseLookup from './courseLookupDB';\nimport { logger } from '@db/util/logger';\n\nexport class AdminDB implements AdminDBInterface {\n private usersDB!: PouchDB.Database;\n\n constructor() {\n // [ ] execute a check here against credentials, and throw an error\n // if the user is not an admin\n this.usersDB = new pouch(\n ENV.COUCHDB_SERVER_PROTOCOL + '://' + ENV.COUCHDB_SERVER_URL + '_users',\n createPouchDBConfig()\n );\n }\n\n public async getUsers() {\n return (\n await this.usersDB.allDocs({\n include_docs: true,\n ...getStartAndEndKeys('org.couchdb.user:'),\n })\n ).rows.map((r) => r.doc!);\n }\n\n public async getCourses() {\n const list = await CourseLookup.allCourseWare();\n return await Promise.all(\n list.map((c) => {\n return getCredentialledCourseConfig(c._id);\n })\n );\n }\n public async removeCourse(id: string) {\n // remove the indexer\n const delResp = await CourseLookup.delete(id);\n\n // set the 'CourseConfig' to 'deleted'\n const cfg = await getCredentialledCourseConfig(id);\n cfg.deleted = true;\n const isDeletedResp = await updateCredentialledCourseConfig(id, cfg);\n\n return {\n ok: delResp.ok && isDeletedResp.ok,\n id: delResp.id,\n rev: delResp.rev,\n };\n }\n\n public async getClassrooms() {\n // const joincodes =\n const uuids = (\n await ClassroomLookupDB().allDocs<{ uuid: string }>({\n include_docs: true,\n })\n ).rows.map((r) => r.doc!.uuid);\n logger.debug(uuids.join(', '));\n\n const promisedCRDbs: TeacherClassroomDB[] = [];\n for (let i = 0; i < uuids.length; i++) {\n try {\n const db = await TeacherClassroomDB.factory(uuids[i]);\n promisedCRDbs.push(db);\n } catch (e) {\n const err = e as PouchError;\n if (err.error && err.error === 'not_found') {\n logger.warn(`db ${uuids[i]} not found`);\n }\n }\n }\n\n return promisedCRDbs.map((db) => {\n return {\n ...db.getConfig(),\n _id: db._id,\n };\n });\n }\n}\n"],"mappings":";;;;;;;;;;AAeA,IAAa,UAAb,MAAiD;CAC/C;CAEA,cAAc;AAGZ,OAAK,UAAU,IAAIA,sBACjB,IAAI,0BAA0B,QAAQ,IAAI,qBAAqB,UAC/D,qBAAqB,CACtB;;CAGH,MAAa,WAAW;AACtB,UACE,MAAM,KAAK,QAAQ,QAAQ;GACzB,cAAc;GACd,GAAG,mBAAmB,oBAAoB;GAC3C,CAAC,EACF,KAAK,KAAK,MAAM,EAAE,IAAK;;CAG3B,MAAa,aAAa;EACxB,MAAM,OAAO,MAAM,aAAa,eAAe;AAC/C,SAAO,MAAM,QAAQ,IACnB,KAAK,KAAK,MAAM;AACd,UAAO,6BAA6B,EAAE,IAAI;IAC1C,CACH;;CAEH,MAAa,aAAa,IAAY;EAEpC,MAAM,UAAU,MAAM,aAAa,OAAO,GAAG;EAG7C,MAAM,MAAM,MAAM,6BAA6B,GAAG;AAClD,MAAI,UAAU;EACd,MAAM,gBAAgB,MAAM,gCAAgC,IAAI,IAAI;AAEpE,SAAO;GACL,IAAI,QAAQ,MAAM,cAAc;GAChC,IAAI,QAAQ;GACZ,KAAK,QAAQ;GACd;;CAGH,MAAa,gBAAgB;EAE3B,MAAM,SACJ,MAAM,mBAAmB,CAAC,QAA0B,EAClD,cAAc,MACf,CAAC,EACF,KAAK,KAAK,MAAM,EAAE,IAAK,KAAK;AAC9B,SAAO,MAAM,MAAM,KAAK,KAAK,CAAC;EAE9B,MAAM,gBAAsC,EAAE;AAC9C,OAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,IAChC,KAAI;GACF,MAAM,KAAK,MAAM,mBAAmB,QAAQ,MAAM,GAAG;AACrD,iBAAc,KAAK,GAAG;WACf,GAAG;GACV,MAAM,MAAM;AACZ,OAAI,IAAI,SAAS,IAAI,UAAU,YAC7B,QAAO,KAAK,MAAM,MAAM,GAAG,YAAY;;AAK7C,SAAO,cAAc,KAAK,OAAO;AAC/B,UAAO;IACL,GAAG,GAAG,WAAW;IACjB,KAAK,GAAG;IACT;IACD"}
@@ -0,0 +1,33 @@
1
+ import "../../_virtual/_rolldown/runtime.mjs";
2
+ import { logger } from "../../util/logger.mjs";
3
+ import { ENV } from "../../factory.mjs";
4
+ import fetch from "cross-fetch";
5
+ //#region src/impl/couch/auth.ts
6
+ async function getCurrentSession() {
7
+ try {
8
+ if (ENV.COUCHDB_SERVER_URL === "NOT_SET" || ENV.COUCHDB_SERVER_PROTOCOL === "NOT_SET") throw new Error(`CouchDB server configuration not properly initialized. Protocol: "${ENV.COUCHDB_SERVER_PROTOCOL}", URL: "${ENV.COUCHDB_SERVER_URL}"`);
9
+ const baseUrl = ENV.COUCHDB_SERVER_URL.endsWith("/") ? ENV.COUCHDB_SERVER_URL.slice(0, -1) : ENV.COUCHDB_SERVER_URL;
10
+ const url = `${ENV.COUCHDB_SERVER_PROTOCOL}://${baseUrl}/_session`;
11
+ logger.debug(`Attempting session check at: ${url}`);
12
+ const response = await fetch(url, {
13
+ method: "GET",
14
+ credentials: "include"
15
+ });
16
+ if (!response.ok) throw new Error(`Session check failed: ${response.status}`);
17
+ return await response.json();
18
+ } catch (error) {
19
+ const baseUrl = ENV.COUCHDB_SERVER_URL.endsWith("/") ? ENV.COUCHDB_SERVER_URL.slice(0, -1) : ENV.COUCHDB_SERVER_URL;
20
+ const url = `${ENV.COUCHDB_SERVER_PROTOCOL}://${baseUrl}/_session`;
21
+ logger.error(`Session check error attempting to connect to: ${url} - ${error}`);
22
+ throw new Error(`Session check failed connecting to ${url}: ${error}`);
23
+ }
24
+ }
25
+ async function getLoggedInUsername() {
26
+ const session = await getCurrentSession();
27
+ if (session.userCtx.name && session.userCtx.name !== "") return session.userCtx.name;
28
+ throw new Error("No logged in user");
29
+ }
30
+ //#endregion
31
+ export { getLoggedInUsername };
32
+
33
+ //# sourceMappingURL=auth.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"auth.mjs","names":[],"sources":["../../../src/impl/couch/auth.ts"],"sourcesContent":["import { ENV, NOT_SET } from '@db/factory';\nimport { logger } from '@db/util/logger';\nimport fetch from 'cross-fetch';\n\ninterface SessionResponse {\n info: unknown;\n ok: boolean;\n userCtx: {\n name: string;\n roles: string[];\n };\n}\n\nexport async function getCurrentSession(): Promise<SessionResponse> {\n // Legacy XMLHttpRequest implementation\n // return new Promise((resolve, reject) => {\n // const authXML = new XMLHttpRequest();\n // authXML.withCredentials = true;\n //\n // authXML.onerror = (e): void => {\n // reject(new Error('Session check failed:', e));\n // };\n //\n // authXML.addEventListener('load', () => {\n // try {\n // const resp: SessionResponse = JSON.parse(authXML.responseText);\n // resolve(resp);\n // } catch (e) {\n // reject(e);\n // }\n // });\n //\n // const url = `${ENV.COUCHDB_SERVER_PROTOCOL}://${ENV.COUCHDB_SERVER_URL}_session`;\n // authXML.open('GET', url);\n // authXML.send();\n // });\n \n try {\n // Handle case where ENV variables might not be properly set\n if (ENV.COUCHDB_SERVER_URL === NOT_SET || ENV.COUCHDB_SERVER_PROTOCOL === NOT_SET) {\n throw new Error(`CouchDB server configuration not properly initialized. Protocol: \"${ENV.COUCHDB_SERVER_PROTOCOL}\", URL: \"${ENV.COUCHDB_SERVER_URL}\"`);\n }\n \n // Ensure URL has proper slash before _session endpoint\n const baseUrl = ENV.COUCHDB_SERVER_URL.endsWith('/') \n ? ENV.COUCHDB_SERVER_URL.slice(0, -1) \n : ENV.COUCHDB_SERVER_URL;\n const url = `${ENV.COUCHDB_SERVER_PROTOCOL}://${baseUrl}/_session`;\n logger.debug(`Attempting session check at: ${url}`);\n \n const response = await fetch(url, {\n method: 'GET',\n credentials: 'include',\n });\n \n if (!response.ok) {\n throw new Error(`Session check failed: ${response.status}`);\n }\n \n const resp: SessionResponse = await response.json();\n return resp;\n } catch (error) {\n // Use same URL construction logic for error reporting\n const baseUrl = ENV.COUCHDB_SERVER_URL.endsWith('/') \n ? ENV.COUCHDB_SERVER_URL.slice(0, -1) \n : ENV.COUCHDB_SERVER_URL;\n const url = `${ENV.COUCHDB_SERVER_PROTOCOL}://${baseUrl}/_session`;\n logger.error(`Session check error attempting to connect to: ${url} - ${error}`);\n throw new Error(`Session check failed connecting to ${url}: ${error}`);\n }\n}\n\nexport async function getLoggedInUsername(): Promise<string> {\n const session = await getCurrentSession();\n if (session.userCtx.name && session.userCtx.name !== '') {\n return session.userCtx.name;\n }\n // Not logged in - throw so caller can handle guest account\n throw new Error('No logged in user');\n}\n"],"mappings":";;;;;AAaA,eAAsB,oBAA8C;AAwBlE,KAAI;AAEF,MAAI,IAAI,uBAAA,aAAkC,IAAI,4BAAA,UAC5C,OAAM,IAAI,MAAM,qEAAqE,IAAI,wBAAwB,WAAW,IAAI,mBAAmB,GAAG;EAIxJ,MAAM,UAAU,IAAI,mBAAmB,SAAS,IAAI,GAChD,IAAI,mBAAmB,MAAM,GAAG,GAAG,GACnC,IAAI;EACR,MAAM,MAAM,GAAG,IAAI,wBAAwB,KAAK,QAAQ;AACxD,SAAO,MAAM,gCAAgC,MAAM;EAEnD,MAAM,WAAW,MAAM,MAAM,KAAK;GAChC,QAAQ;GACR,aAAa;GACd,CAAC;AAEF,MAAI,CAAC,SAAS,GACZ,OAAM,IAAI,MAAM,yBAAyB,SAAS,SAAS;AAI7D,SAD8B,MAAM,SAAS,MAAM;UAE5C,OAAO;EAEd,MAAM,UAAU,IAAI,mBAAmB,SAAS,IAAI,GAChD,IAAI,mBAAmB,MAAM,GAAG,GAAG,GACnC,IAAI;EACR,MAAM,MAAM,GAAG,IAAI,wBAAwB,KAAK,QAAQ;AACxD,SAAO,MAAM,iDAAiD,IAAI,KAAK,QAAQ;AAC/E,QAAM,IAAI,MAAM,sCAAsC,IAAI,IAAI,QAAQ;;;AAI1E,eAAsB,sBAAuC;CAC3D,MAAM,UAAU,MAAM,mBAAmB;AACzC,KAAI,QAAQ,QAAQ,QAAQ,QAAQ,QAAQ,SAAS,GACnD,QAAO,QAAQ,QAAQ;AAGzB,OAAM,IAAI,MAAM,oBAAoB"}