@vue-skuilder/db 0.2.34 → 0.2.36
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CLAUDE.md +15 -4
- package/build.entries.mjs +12 -0
- package/dist/_virtual/_rolldown/runtime.mjs +8 -0
- package/dist/{contentSource-CTQ4kWhR.d.cts → contentSource-D_E7JaxR.d.ts} +2 -2
- package/dist/core/UserDBDebugger.mjs +285 -0
- package/dist/core/UserDBDebugger.mjs.map +1 -0
- package/dist/core/bulkImport/cardProcessor.mjs +106 -0
- package/dist/core/bulkImport/cardProcessor.mjs.map +1 -0
- package/dist/core/{index.js → index.cjs} +6438 -7784
- package/dist/core/index.cjs.map +1 -0
- package/dist/core/index.d.ts +5 -5
- package/dist/core/index.mjs +20 -11368
- package/dist/core/interfaces/contentSource.mjs +20 -0
- package/dist/core/interfaces/contentSource.mjs.map +1 -0
- package/dist/core/navigators/Pipeline.mjs +723 -0
- package/dist/core/navigators/Pipeline.mjs.map +1 -0
- package/dist/core/navigators/PipelineAssembler.mjs +86 -0
- package/dist/core/navigators/PipelineAssembler.mjs.map +1 -0
- package/dist/core/navigators/PipelineDebugger.mjs +771 -0
- package/dist/core/navigators/PipelineDebugger.mjs.map +1 -0
- package/dist/core/navigators/SrsDebugger.mjs +34 -0
- package/dist/core/navigators/SrsDebugger.mjs.map +1 -0
- package/dist/core/navigators/StrategyPressureDebugger.mjs +19 -0
- package/dist/core/navigators/StrategyPressureDebugger.mjs.map +1 -0
- package/dist/core/navigators/defaults.mjs +96 -0
- package/dist/core/navigators/defaults.mjs.map +1 -0
- package/dist/core/navigators/diversityRerank.mjs +85 -0
- package/dist/core/navigators/diversityRerank.mjs.map +1 -0
- package/dist/core/navigators/filters/WeightedFilter.mjs +81 -0
- package/dist/core/navigators/filters/WeightedFilter.mjs.map +1 -0
- package/dist/core/navigators/filters/eloDistance.mjs +244 -0
- package/dist/core/navigators/filters/eloDistance.mjs.map +1 -0
- package/dist/core/navigators/filters/hierarchyDefinition.mjs +235 -0
- package/dist/core/navigators/filters/hierarchyDefinition.mjs.map +1 -0
- package/dist/core/navigators/filters/interferenceMitigator.mjs +201 -0
- package/dist/core/navigators/filters/interferenceMitigator.mjs.map +1 -0
- package/dist/core/navigators/filters/relativePriority.mjs +135 -0
- package/dist/core/navigators/filters/relativePriority.mjs.map +1 -0
- package/dist/core/navigators/filters/userTagPreference.mjs +101 -0
- package/dist/core/navigators/filters/userTagPreference.mjs.map +1 -0
- package/dist/core/navigators/generators/CompositeGenerator.mjs +203 -0
- package/dist/core/navigators/generators/CompositeGenerator.mjs.map +1 -0
- package/dist/core/navigators/generators/elo.mjs +77 -0
- package/dist/core/navigators/generators/elo.mjs.map +1 -0
- package/dist/core/navigators/generators/prescribed.mjs +676 -0
- package/dist/core/navigators/generators/prescribed.mjs.map +1 -0
- package/dist/core/navigators/generators/srs.mjs +158 -0
- package/dist/core/navigators/generators/srs.mjs.map +1 -0
- package/dist/core/navigators/index.mjs +345 -0
- package/dist/core/navigators/index.mjs.map +1 -0
- package/dist/core/navigators/pipelinePlan.mjs +109 -0
- package/dist/core/navigators/pipelinePlan.mjs.map +1 -0
- package/dist/core/navigators/regulators.mjs +128 -0
- package/dist/core/navigators/regulators.mjs.map +1 -0
- package/dist/core/orchestration/gradient.mjs +101 -0
- package/dist/core/orchestration/gradient.mjs.map +1 -0
- package/dist/core/orchestration/index.mjs +115 -0
- package/dist/core/orchestration/index.mjs.map +1 -0
- package/dist/core/orchestration/learning.mjs +140 -0
- package/dist/core/orchestration/learning.mjs.map +1 -0
- package/dist/core/orchestration/recording.mjs +64 -0
- package/dist/core/orchestration/recording.mjs.map +1 -0
- package/dist/core/orchestration/signal.mjs +40 -0
- package/dist/core/orchestration/signal.mjs.map +1 -0
- package/dist/core/types/contentNavigationStrategy.mjs +10 -0
- package/dist/core/types/contentNavigationStrategy.mjs.map +1 -0
- package/dist/core/types/hydration.mjs +13 -0
- package/dist/core/types/hydration.mjs.map +1 -0
- package/dist/core/types/strategyState.mjs +16 -0
- package/dist/core/types/strategyState.mjs.map +1 -0
- package/dist/core/types/studySession.mjs +14 -0
- package/dist/core/types/studySession.mjs.map +1 -0
- package/dist/core/types/types-legacy.mjs +44 -0
- package/dist/core/types/types-legacy.mjs.map +1 -0
- package/dist/core/util/index.mjs +31 -0
- package/dist/core/util/index.mjs.map +1 -0
- package/dist/core/versionStamps.mjs +46 -0
- package/dist/core/versionStamps.mjs.map +1 -0
- package/dist/courseConfigRegistration.mjs +306 -0
- package/dist/courseConfigRegistration.mjs.map +1 -0
- package/dist/{dataLayerProvider-rlLE2Mf-.d.ts → dataLayerProvider-BDshhSp_.d.ts} +1 -1
- package/dist/diagnostics/dataset.mjs +118 -0
- package/dist/diagnostics/dataset.mjs.map +1 -0
- package/dist/diagnostics/derive.mjs +318 -0
- package/dist/diagnostics/derive.mjs.map +1 -0
- package/dist/diagnostics/{index.js → index.cjs} +130 -1
- package/dist/diagnostics/index.cjs.map +1 -0
- package/dist/diagnostics/index.d.ts +108 -5
- package/dist/diagnostics/index.mjs +7 -914
- package/dist/diagnostics/loader.mjs +151 -0
- package/dist/diagnostics/loader.mjs.map +1 -0
- package/dist/diagnostics/pipeline.mjs +161 -0
- package/dist/diagnostics/pipeline.mjs.map +1 -0
- package/dist/diagnostics/tagElo.mjs +177 -0
- package/dist/diagnostics/tagElo.mjs.map +1 -0
- package/dist/diagnostics/text.mjs +174 -0
- package/dist/diagnostics/text.mjs.map +1 -0
- package/dist/factory.mjs +70 -0
- package/dist/factory.mjs.map +1 -0
- package/dist/impl/common/BaseUserDB.mjs +1103 -0
- package/dist/impl/common/BaseUserDB.mjs.map +1 -0
- package/dist/impl/common/userDBHelpers.mjs +49 -0
- package/dist/impl/common/userDBHelpers.mjs.map +1 -0
- package/dist/impl/common/userDBKeys.mjs +45 -0
- package/dist/impl/common/userDBKeys.mjs.map +1 -0
- package/dist/impl/couch/CouchDBSyncStrategy.mjs +272 -0
- package/dist/impl/couch/CouchDBSyncStrategy.mjs.map +1 -0
- package/dist/impl/couch/CourseSyncService.mjs +242 -0
- package/dist/impl/couch/CourseSyncService.mjs.map +1 -0
- package/dist/impl/couch/PouchDataLayerProvider.mjs +74 -0
- package/dist/impl/couch/PouchDataLayerProvider.mjs.map +1 -0
- package/dist/impl/couch/adminDB.mjs +61 -0
- package/dist/impl/couch/adminDB.mjs.map +1 -0
- package/dist/impl/couch/auth.mjs +33 -0
- package/dist/impl/couch/auth.mjs.map +1 -0
- package/dist/impl/couch/classroomDB.mjs +227 -0
- package/dist/impl/couch/classroomDB.mjs.map +1 -0
- package/dist/impl/couch/clientCache.mjs +15 -0
- package/dist/impl/couch/clientCache.mjs.map +1 -0
- package/dist/impl/couch/courseAPI.mjs +183 -0
- package/dist/impl/couch/courseAPI.mjs.map +1 -0
- package/dist/impl/couch/courseDB.mjs +729 -0
- package/dist/impl/couch/courseDB.mjs.map +1 -0
- package/dist/impl/couch/courseLookupDB.mjs +94 -0
- package/dist/impl/couch/courseLookupDB.mjs.map +1 -0
- package/dist/impl/couch/{index.js → index.cjs} +6911 -10367
- package/dist/impl/couch/index.cjs.map +1 -0
- package/dist/impl/couch/index.d.ts +12 -5
- package/dist/impl/couch/index.mjs +134 -12146
- package/dist/impl/couch/index.mjs.map +1 -1
- package/dist/impl/couch/pouchdb-setup.mjs +15 -0
- package/dist/impl/couch/pouchdb-setup.mjs.map +1 -0
- package/dist/impl/couch/updateQueue.mjs +101 -0
- package/dist/impl/couch/updateQueue.mjs.map +1 -0
- package/dist/impl/couch/user-course-relDB.mjs +55 -0
- package/dist/impl/couch/user-course-relDB.mjs.map +1 -0
- package/dist/impl/static/NoOpSyncStrategy.mjs +49 -0
- package/dist/impl/static/NoOpSyncStrategy.mjs.map +1 -0
- package/dist/impl/static/StaticDataLayerProvider.mjs +94 -0
- package/dist/impl/static/StaticDataLayerProvider.mjs.map +1 -0
- package/dist/impl/static/StaticDataUnpacker.mjs +311 -0
- package/dist/impl/static/StaticDataUnpacker.mjs.map +1 -0
- package/dist/impl/static/courseDB.mjs +368 -0
- package/dist/impl/static/courseDB.mjs.map +1 -0
- package/dist/impl/static/coursesDB.mjs +38 -0
- package/dist/impl/static/coursesDB.mjs.map +1 -0
- package/dist/impl/static/{index.js → index.cjs} +2461 -5992
- package/dist/impl/static/index.cjs.map +1 -0
- package/dist/impl/static/index.d.ts +4 -4
- package/dist/impl/static/index.mjs +6 -10741
- package/dist/{index-CVGehe_t.d.ts → index-BLDpFYG3.d.ts} +1 -1
- package/dist/{index.js → index.cjs} +14070 -14239
- package/dist/index.cjs.map +1 -0
- package/dist/index.d.ts +12 -23
- package/dist/index.mjs +38 -16937
- package/dist/pouch/{index.js → index.cjs} +5 -1
- package/dist/pouch/index.cjs.map +1 -0
- package/dist/pouch/index.mjs +2 -19
- package/dist/study/ItemQueue.mjs +95 -0
- package/dist/study/ItemQueue.mjs.map +1 -0
- package/dist/study/MixerDebugger.mjs +303 -0
- package/dist/study/MixerDebugger.mjs.map +1 -0
- package/dist/study/SessionController.mjs +1187 -0
- package/dist/study/SessionController.mjs.map +1 -0
- package/dist/study/SessionDebugger.mjs +271 -0
- package/dist/study/SessionDebugger.mjs.map +1 -0
- package/dist/study/SessionOverlay.mjs +407 -0
- package/dist/study/SessionOverlay.mjs.map +1 -0
- package/dist/study/SourceMixer.mjs +45 -0
- package/dist/study/SourceMixer.mjs.map +1 -0
- package/dist/study/SpacedRepetition.mjs +108 -0
- package/dist/study/SpacedRepetition.mjs.map +1 -0
- package/dist/study/TagFilteredContentSource.mjs +136 -0
- package/dist/study/TagFilteredContentSource.mjs.map +1 -0
- package/dist/study/services/CardHydrationService.mjs +172 -0
- package/dist/study/services/CardHydrationService.mjs.map +1 -0
- package/dist/study/services/EloService.mjs +217 -0
- package/dist/study/services/EloService.mjs.map +1 -0
- package/dist/study/services/ResponseProcessor.mjs +190 -0
- package/dist/study/services/ResponseProcessor.mjs.map +1 -0
- package/dist/study/services/SrsService.mjs +49 -0
- package/dist/study/services/SrsService.mjs.map +1 -0
- package/dist/study/services/tagRecent.mjs +65 -0
- package/dist/study/services/tagRecent.mjs.map +1 -0
- package/dist/{types-dXWfyz9B.d.ts → types-DChCz22D.d.ts} +1 -1
- package/dist/{types-legacy-BkOYOR6U.d.cts → types-legacy-fT5Y1Wuy.d.ts} +1 -1
- package/dist/userDBKeys-ne1g4Xuq.d.ts +16 -0
- package/dist/util/Loggable.mjs +14 -0
- package/dist/util/Loggable.mjs.map +1 -0
- package/dist/util/dataDirectory.mjs +47 -0
- package/dist/util/dataDirectory.mjs.map +1 -0
- package/dist/util/logger.mjs +86 -0
- package/dist/util/logger.mjs.map +1 -0
- package/dist/util/migrator/FileSystemAdapter.mjs +18 -0
- package/dist/util/migrator/FileSystemAdapter.mjs.map +1 -0
- package/dist/util/migrator/StaticToCouchDBMigrator.mjs +428 -0
- package/dist/util/migrator/StaticToCouchDBMigrator.mjs.map +1 -0
- package/dist/util/migrator/types.mjs +11 -0
- package/dist/util/migrator/types.mjs.map +1 -0
- package/dist/util/migrator/validation.mjs +334 -0
- package/dist/util/migrator/validation.mjs.map +1 -0
- package/dist/util/packer/CouchDBToStaticPacker.mjs +438 -0
- package/dist/util/packer/CouchDBToStaticPacker.mjs.map +1 -0
- package/dist/util/packer/{index.js → index.cjs} +73 -9
- package/dist/util/packer/index.cjs.map +1 -0
- package/dist/util/packer/index.d.ts +3 -3
- package/dist/util/packer/index.mjs +2 -537
- package/eslint.config.mjs +9 -1
- package/package.json +25 -13
- package/rolldown.config.mjs +44 -0
- package/src/core/UserDBDebugger.ts +47 -46
- package/src/core/navigators/Pipeline.ts +10 -10
- package/src/core/navigators/PipelineDebugger.ts +55 -55
- package/src/core/navigators/filters/eloDistance.ts +11 -1
- package/src/core/navigators/generators/elo.ts +5 -1
- package/src/core/navigators/index.ts +9 -3
- package/src/diagnostics/derive.ts +6 -0
- package/src/diagnostics/index.ts +1 -0
- package/src/diagnostics/tagElo.ts +257 -0
- package/src/factory.ts +10 -1
- package/src/impl/common/BaseUserDB.ts +1 -3
- package/src/impl/common/index.ts +2 -0
- package/src/impl/common/userDBHelpers.ts +4 -58
- package/src/impl/common/userDBKeys.ts +64 -0
- package/src/impl/couch/courseDB.ts +15 -3
- package/src/impl/couch/index.ts +2 -18
- package/src/impl/couch/pouchdb-setup.ts +8 -0
- package/src/index.ts +1 -1
- package/src/study/MixerDebugger.ts +46 -46
- package/src/study/SessionDebugger.ts +20 -20
- package/src/study/SessionOverlay.ts +4 -4
- package/src/util/logger.ts +112 -13
- package/tests/core/navigators/eloGenerator.test.ts +36 -0
- package/tsup.config.ts +24 -21
- package/dist/SyncStrategy-BXliog1m.d.cts +0 -116
- package/dist/classroomDB-DLTtLZct.d.cts +0 -86
- package/dist/contentSource-JmWYu8IK.d.ts +0 -2007
- package/dist/core/index.d.cts +0 -521
- package/dist/core/index.js.map +0 -1
- package/dist/core/index.mjs.map +0 -1
- package/dist/dataLayerProvider-DfI_KYAe.d.cts +0 -61
- package/dist/diagnostics/index.d.cts +0 -458
- package/dist/diagnostics/index.js.map +0 -1
- package/dist/diagnostics/index.mjs.map +0 -1
- package/dist/impl/couch/index.d.cts +0 -620
- package/dist/impl/couch/index.js.map +0 -1
- package/dist/impl/static/index.d.cts +0 -232
- package/dist/impl/static/index.js.map +0 -1
- package/dist/impl/static/index.mjs.map +0 -1
- package/dist/index-Ktg72jKb.d.cts +0 -137
- package/dist/index.d.cts +0 -1663
- package/dist/index.js.map +0 -1
- package/dist/index.mjs.map +0 -1
- package/dist/pouch/index.d.cts +0 -1
- package/dist/pouch/index.js.map +0 -1
- package/dist/pouch/index.mjs.map +0 -1
- package/dist/types-D0oQeJAi.d.cts +0 -58
- package/dist/types-legacy-BkOYOR6U.d.ts +0 -168
- package/dist/util/packer/index.d.cts +0 -5
- package/dist/util/packer/index.js.map +0 -1
- package/dist/util/packer/index.mjs.map +0 -1
- package/src/study/getCardDataShape.ts +0 -34
|
@@ -0,0 +1,242 @@
|
|
|
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
|
+
const DEFAULT_REPLICATION = {
|
|
7
|
+
batchSize: 1e3,
|
|
8
|
+
batchesLimit: 5
|
|
9
|
+
};
|
|
10
|
+
var CourseSyncService = class CourseSyncService {
|
|
11
|
+
static instance = null;
|
|
12
|
+
entries = /* @__PURE__ */ new Map();
|
|
13
|
+
replicationOptions = DEFAULT_REPLICATION;
|
|
14
|
+
constructor() {}
|
|
15
|
+
static getInstance() {
|
|
16
|
+
if (!CourseSyncService.instance) CourseSyncService.instance = new CourseSyncService();
|
|
17
|
+
return CourseSyncService.instance;
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
* Apply replication tuning. Typically called once from `initializeDataLayer`.
|
|
21
|
+
* Partial overrides merge with defaults.
|
|
22
|
+
*/
|
|
23
|
+
configure(opts) {
|
|
24
|
+
if (opts.replication) {
|
|
25
|
+
this.replicationOptions = {
|
|
26
|
+
...DEFAULT_REPLICATION,
|
|
27
|
+
...opts.replication
|
|
28
|
+
};
|
|
29
|
+
logger.info(`[CourseSyncService] Replication configured: batch_size=${this.replicationOptions.batchSize}, batches_limit=${this.replicationOptions.batchesLimit}`);
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
* Reset the singleton (for testing).
|
|
34
|
+
*/
|
|
35
|
+
static resetInstance() {
|
|
36
|
+
if (CourseSyncService.instance) {
|
|
37
|
+
for (const [, entry] of CourseSyncService.instance.entries) if (entry.localDB) entry.localDB.close().catch(() => {});
|
|
38
|
+
CourseSyncService.instance.entries.clear();
|
|
39
|
+
}
|
|
40
|
+
CourseSyncService.instance = null;
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
* Ensure a course's local replica is synced.
|
|
44
|
+
*
|
|
45
|
+
* On first call for a course:
|
|
46
|
+
* 1. Fetches CourseConfig from remote to check localSync.enabled
|
|
47
|
+
* 2. If enabled, performs one-shot replication remote → local
|
|
48
|
+
* 3. Pre-warms PouchDB view indices (elo, getTags)
|
|
49
|
+
*
|
|
50
|
+
* On subsequent calls: returns immediately if already synced, or awaits
|
|
51
|
+
* the in-flight sync if one is in progress.
|
|
52
|
+
*
|
|
53
|
+
* Safe to call multiple times — concurrent calls coalesce to one sync.
|
|
54
|
+
*
|
|
55
|
+
* @param courseId - The course to sync
|
|
56
|
+
* @param forceEnabled - Skip the CourseConfig check and sync regardless.
|
|
57
|
+
* Useful when the caller already knows local sync is desired (e.g.,
|
|
58
|
+
* LettersPractice hardcodes this).
|
|
59
|
+
*/
|
|
60
|
+
async ensureSynced(courseId, forceEnabled) {
|
|
61
|
+
const existing = this.entries.get(courseId);
|
|
62
|
+
if (existing?.status.state === "ready" && existing.localDB) {
|
|
63
|
+
if (!await this.isLocalEpochStale(courseId, existing.localDB)) return;
|
|
64
|
+
logger.info(`[CourseSyncService] Remote DB epoch changed for course ${courseId} — destroying stale local replica`);
|
|
65
|
+
try {
|
|
66
|
+
await existing.localDB.destroy();
|
|
67
|
+
} catch {}
|
|
68
|
+
existing.localDB = null;
|
|
69
|
+
existing.readyPromise = null;
|
|
70
|
+
}
|
|
71
|
+
if (existing?.status.state === "disabled") return;
|
|
72
|
+
if (existing?.readyPromise) return existing.readyPromise;
|
|
73
|
+
const entry = {
|
|
74
|
+
localDB: null,
|
|
75
|
+
status: { state: "not-started" },
|
|
76
|
+
readyPromise: null
|
|
77
|
+
};
|
|
78
|
+
this.entries.set(courseId, entry);
|
|
79
|
+
entry.readyPromise = this.performSync(courseId, entry, forceEnabled);
|
|
80
|
+
return entry.readyPromise;
|
|
81
|
+
}
|
|
82
|
+
/**
|
|
83
|
+
* Get the local PouchDB for a course, or null if not available.
|
|
84
|
+
*
|
|
85
|
+
* Returns null when:
|
|
86
|
+
* - Local sync is not enabled for this course
|
|
87
|
+
* - Sync has not been triggered yet
|
|
88
|
+
* - Sync is still in progress
|
|
89
|
+
* - Sync failed
|
|
90
|
+
*/
|
|
91
|
+
getLocalDB(courseId) {
|
|
92
|
+
const entry = this.entries.get(courseId);
|
|
93
|
+
if (entry?.status.state === "ready" && entry.localDB) return entry.localDB;
|
|
94
|
+
return null;
|
|
95
|
+
}
|
|
96
|
+
/**
|
|
97
|
+
* Check whether a course has a ready local replica.
|
|
98
|
+
*/
|
|
99
|
+
isReady(courseId) {
|
|
100
|
+
return this.entries.get(courseId)?.status.state === "ready";
|
|
101
|
+
}
|
|
102
|
+
/**
|
|
103
|
+
* Get detailed sync status for a course.
|
|
104
|
+
*/
|
|
105
|
+
getStatus(courseId) {
|
|
106
|
+
return this.entries.get(courseId)?.status ?? { state: "not-started" };
|
|
107
|
+
}
|
|
108
|
+
async performSync(courseId, entry, forceEnabled) {
|
|
109
|
+
try {
|
|
110
|
+
if (!forceEnabled) {
|
|
111
|
+
entry.status = { state: "checking-config" };
|
|
112
|
+
if (!await this.checkLocalSyncEnabled(courseId)) {
|
|
113
|
+
entry.status = { state: "disabled" };
|
|
114
|
+
entry.readyPromise = null;
|
|
115
|
+
logger.debug(`[CourseSyncService] Local sync disabled for course ${courseId}`);
|
|
116
|
+
return;
|
|
117
|
+
}
|
|
118
|
+
}
|
|
119
|
+
entry.status = { state: "syncing" };
|
|
120
|
+
const localDBName = this.localDBName(courseId);
|
|
121
|
+
let localDB = new pouchdb_setup_default(localDBName);
|
|
122
|
+
if (await this.isLocalEpochStale(courseId, localDB)) {
|
|
123
|
+
logger.info(`[CourseSyncService] Stale local DB detected for course ${courseId} — destroying before sync`);
|
|
124
|
+
await localDB.destroy();
|
|
125
|
+
localDB = new pouchdb_setup_default(localDBName);
|
|
126
|
+
}
|
|
127
|
+
entry.localDB = localDB;
|
|
128
|
+
const remoteDB = this.getRemoteDB(courseId);
|
|
129
|
+
const syncStart = Date.now();
|
|
130
|
+
logger.info(`[CourseSyncService] Starting one-shot replication for course ${courseId} (batch_size=${this.replicationOptions.batchSize}, batches_limit=${this.replicationOptions.batchesLimit})`);
|
|
131
|
+
const result = await this.replicate(remoteDB, localDB);
|
|
132
|
+
const syncTimeMs = Date.now() - syncStart;
|
|
133
|
+
logger.info(`[CourseSyncService] Replication complete for course ${courseId}: ${result.docs_written} docs in ${syncTimeMs}ms`);
|
|
134
|
+
entry.status = { state: "warming-views" };
|
|
135
|
+
const warmStart = Date.now();
|
|
136
|
+
await this.warmViewIndices(localDB);
|
|
137
|
+
const viewWarmTimeMs = Date.now() - warmStart;
|
|
138
|
+
logger.info(`[CourseSyncService] View indices warmed for course ${courseId} in ${viewWarmTimeMs}ms`);
|
|
139
|
+
entry.status = {
|
|
140
|
+
state: "ready",
|
|
141
|
+
docsReplicated: result.docs_written,
|
|
142
|
+
syncTimeMs,
|
|
143
|
+
viewWarmTimeMs
|
|
144
|
+
};
|
|
145
|
+
} catch (e) {
|
|
146
|
+
const errorMsg = e instanceof Error ? e.message : String(e);
|
|
147
|
+
logger.error(`[CourseSyncService] Sync failed for course ${courseId}: ${errorMsg}`);
|
|
148
|
+
entry.status = {
|
|
149
|
+
state: "error",
|
|
150
|
+
error: errorMsg
|
|
151
|
+
};
|
|
152
|
+
entry.readyPromise = null;
|
|
153
|
+
if (entry.localDB) {
|
|
154
|
+
try {
|
|
155
|
+
await entry.localDB.destroy();
|
|
156
|
+
} catch {}
|
|
157
|
+
entry.localDB = null;
|
|
158
|
+
}
|
|
159
|
+
}
|
|
160
|
+
}
|
|
161
|
+
/**
|
|
162
|
+
* Check CourseConfig.localSync.enabled on the remote DB.
|
|
163
|
+
*/
|
|
164
|
+
async checkLocalSyncEnabled(courseId) {
|
|
165
|
+
try {
|
|
166
|
+
return (await this.getRemoteDB(courseId).get("CourseConfig")).localSync?.enabled === true;
|
|
167
|
+
} catch (e) {
|
|
168
|
+
logger.warn(`[CourseSyncService] Could not read CourseConfig for ${courseId}, assuming local sync disabled: ${e}`);
|
|
169
|
+
return false;
|
|
170
|
+
}
|
|
171
|
+
}
|
|
172
|
+
/**
|
|
173
|
+
* One-shot replication from remote to local.
|
|
174
|
+
*/
|
|
175
|
+
replicate(source, target) {
|
|
176
|
+
return new Promise((resolve, reject) => {
|
|
177
|
+
pouchdb_setup_default.replicate(source, target, {
|
|
178
|
+
batch_size: this.replicationOptions.batchSize,
|
|
179
|
+
batches_limit: this.replicationOptions.batchesLimit
|
|
180
|
+
}).on("complete", (info) => {
|
|
181
|
+
resolve(info);
|
|
182
|
+
}).on("error", (err) => {
|
|
183
|
+
reject(err);
|
|
184
|
+
});
|
|
185
|
+
});
|
|
186
|
+
}
|
|
187
|
+
/**
|
|
188
|
+
* Pre-warm PouchDB view indices by running a minimal query against each
|
|
189
|
+
* design doc. This forces PouchDB to build the MapReduce index now
|
|
190
|
+
* (during a loading phase) rather than on first pipeline query.
|
|
191
|
+
*/
|
|
192
|
+
async warmViewIndices(localDB) {
|
|
193
|
+
for (const viewName of ["elo", "getTags"]) try {
|
|
194
|
+
await localDB.query(viewName, { limit: 1 });
|
|
195
|
+
logger.debug(`[CourseSyncService] Warmed view index: ${viewName}`);
|
|
196
|
+
} catch (e) {
|
|
197
|
+
logger.debug(`[CourseSyncService] Could not warm view ${viewName}: ${e}`);
|
|
198
|
+
}
|
|
199
|
+
}
|
|
200
|
+
/**
|
|
201
|
+
* Check whether the local replica's `db-epoch` doc matches the remote.
|
|
202
|
+
*
|
|
203
|
+
* The seed script (and optionally upload-cards) writes a `db-epoch`
|
|
204
|
+
* document with a numeric timestamp. If the remote epoch differs from
|
|
205
|
+
* the local copy, the remote DB was recreated (e.g., `yarn db:seed`)
|
|
206
|
+
* and the local PouchDB is stale.
|
|
207
|
+
*
|
|
208
|
+
* Returns `true` if stale (epoch mismatch or remote has epoch but local
|
|
209
|
+
* doesn't). Returns `false` (not stale) if epochs match, or if the
|
|
210
|
+
* remote doesn't have an epoch doc at all (backwards compat).
|
|
211
|
+
*/
|
|
212
|
+
async isLocalEpochStale(courseId, localDB) {
|
|
213
|
+
try {
|
|
214
|
+
const remoteEpoch = await this.getRemoteDB(courseId).get("db-epoch");
|
|
215
|
+
let localEpoch = null;
|
|
216
|
+
try {
|
|
217
|
+
localEpoch = await localDB.get("db-epoch");
|
|
218
|
+
} catch {
|
|
219
|
+
return true;
|
|
220
|
+
}
|
|
221
|
+
return remoteEpoch.epoch !== localEpoch.epoch;
|
|
222
|
+
} catch {
|
|
223
|
+
return false;
|
|
224
|
+
}
|
|
225
|
+
}
|
|
226
|
+
/**
|
|
227
|
+
* Get a remote PouchDB handle for a course.
|
|
228
|
+
*/
|
|
229
|
+
getRemoteDB(courseId) {
|
|
230
|
+
return getCourseDB(courseId);
|
|
231
|
+
}
|
|
232
|
+
/**
|
|
233
|
+
* Local DB naming convention.
|
|
234
|
+
*/
|
|
235
|
+
localDBName(courseId) {
|
|
236
|
+
return `coursedb-local-${courseId}`;
|
|
237
|
+
}
|
|
238
|
+
};
|
|
239
|
+
//#endregion
|
|
240
|
+
export { CourseSyncService };
|
|
241
|
+
|
|
242
|
+
//# 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// 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 * 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 // Already synced — but check if the remote DB has been recreated\n // (e.g., after a dev reseed). The seed script writes a `db-epoch`\n // doc; if the remote epoch differs from our local copy, the local\n // replica is stale and must be destroyed before re-syncing.\n if (existing?.status.state === 'ready' && existing.localDB) {\n const stale = await this.isLocalEpochStale(courseId, existing.localDB);\n if (!stale) {\n return;\n }\n logger.info(\n `[CourseSyncService] Remote DB epoch changed for course ${courseId} — destroying stale local replica`\n );\n try {\n await existing.localDB.destroy();\n } catch {\n // Ignore cleanup errors\n }\n existing.localDB = null;\n existing.readyPromise = null;\n // Fall through to start a fresh sync\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.performSync(courseId, entry, forceEnabled);\n return entry.readyPromise;\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 // 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,74 @@
|
|
|
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
|
+
constructor(coursIDs) {
|
|
17
|
+
if (coursIDs) this._courseIDs = coursIDs;
|
|
18
|
+
}
|
|
19
|
+
async initialize() {
|
|
20
|
+
if (this.initialized) return;
|
|
21
|
+
if (typeof process !== "undefined" && process.versions != null && process.versions.node != null) {
|
|
22
|
+
logger.info("CouchDataLayerProvider: Running in Node.js environment, creating guest UserDB for testing.");
|
|
23
|
+
await initializeDataDirectory();
|
|
24
|
+
const syncStrategy = new CouchDBSyncStrategy();
|
|
25
|
+
this.userDB = await BaseUser.instance(syncStrategy);
|
|
26
|
+
} else {
|
|
27
|
+
const syncStrategy = new CouchDBSyncStrategy();
|
|
28
|
+
this.userDB = await BaseUser.instance(syncStrategy);
|
|
29
|
+
this.currentUsername = this.userDB.getUsername();
|
|
30
|
+
logger.debug(`Current username: ${this.currentUsername}`);
|
|
31
|
+
}
|
|
32
|
+
this.initialized = true;
|
|
33
|
+
}
|
|
34
|
+
async teardown() {
|
|
35
|
+
this.initialized = false;
|
|
36
|
+
}
|
|
37
|
+
getUserDB() {
|
|
38
|
+
return this.userDB;
|
|
39
|
+
}
|
|
40
|
+
getCourseDB(courseId) {
|
|
41
|
+
return new CourseDB(courseId, async () => this.getUserDB(), CourseSyncService.getInstance().getLocalDB(courseId) ?? void 0);
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
* Trigger local sync for a course. Call during app initialization or
|
|
45
|
+
* pre-session loading for courses that opt in via CourseConfig.localSync.
|
|
46
|
+
*
|
|
47
|
+
* Safe to call multiple times — concurrent calls coalesce. Returns when
|
|
48
|
+
* sync is complete (or immediately if already synced / disabled).
|
|
49
|
+
*
|
|
50
|
+
* @param courseId - The course to sync locally
|
|
51
|
+
* @param forceEnabled - Skip CourseConfig check and sync regardless.
|
|
52
|
+
* Use when the caller already knows local sync is desired.
|
|
53
|
+
*/
|
|
54
|
+
async ensureCourseSynced(courseId, forceEnabled) {
|
|
55
|
+
return CourseSyncService.getInstance().ensureSynced(courseId, forceEnabled);
|
|
56
|
+
}
|
|
57
|
+
getCoursesDB() {
|
|
58
|
+
return new CoursesDB(this._courseIDs);
|
|
59
|
+
}
|
|
60
|
+
async getClassroomDB(classId, type) {
|
|
61
|
+
if (type === "student") return await StudentClassroomDB.factory(classId, this.getUserDB());
|
|
62
|
+
else return await TeacherClassroomDB.factory(classId);
|
|
63
|
+
}
|
|
64
|
+
getAdminDB() {
|
|
65
|
+
return new AdminDB();
|
|
66
|
+
}
|
|
67
|
+
isReadOnly() {
|
|
68
|
+
return false;
|
|
69
|
+
}
|
|
70
|
+
};
|
|
71
|
+
//#endregion
|
|
72
|
+
export { CouchDataLayerProvider };
|
|
73
|
+
|
|
74
|
+
//# 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 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 return new CourseDB(courseId, async () => this.getUserDB(), localDB ?? undefined);\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;CAEjC,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;AAK/C,SAAO,IAAI,SAAS,UAAU,YAAY,KAAK,WAAW,EAD1C,kBAAkB,aAAa,CAAC,WAAW,SAAS,IACG,KAAA,EAAU;;;;;;;;;;;;;CAcnF,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"}
|