@vue-skuilder/db 0.2.35 → 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.
Files changed (258) 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} +6438 -7784
  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 +676 -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 +1103 -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 +242 -0
  108. package/dist/impl/couch/CourseSyncService.mjs.map +1 -0
  109. package/dist/impl/couch/PouchDataLayerProvider.mjs +74 -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 +183 -0
  120. package/dist/impl/couch/courseAPI.mjs.map +1 -0
  121. package/dist/impl/couch/courseDB.mjs +729 -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} +6911 -10367
  126. package/dist/impl/couch/index.cjs.map +1 -0
  127. package/dist/impl/couch/index.d.ts +12 -5
  128. package/dist/impl/couch/index.mjs +134 -12146
  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} +2461 -5992
  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} +14070 -14239
  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/index.ts +9 -3
  216. package/src/factory.ts +10 -1
  217. package/src/impl/common/BaseUserDB.ts +1 -3
  218. package/src/impl/common/index.ts +2 -0
  219. package/src/impl/common/userDBHelpers.ts +4 -58
  220. package/src/impl/common/userDBKeys.ts +64 -0
  221. package/src/impl/couch/courseDB.ts +15 -3
  222. package/src/impl/couch/index.ts +2 -18
  223. package/src/impl/couch/pouchdb-setup.ts +8 -0
  224. package/src/index.ts +1 -1
  225. package/src/study/MixerDebugger.ts +46 -46
  226. package/src/study/SessionDebugger.ts +20 -20
  227. package/src/study/SessionOverlay.ts +4 -4
  228. package/src/util/logger.ts +112 -13
  229. package/tests/core/navigators/eloGenerator.test.ts +36 -0
  230. package/tsup.config.ts +24 -21
  231. package/dist/SyncStrategy-BXliog1m.d.cts +0 -116
  232. package/dist/classroomDB-DLTtLZct.d.cts +0 -86
  233. package/dist/contentSource-FQZcZopC.d.cts +0 -2007
  234. package/dist/core/index.d.cts +0 -521
  235. package/dist/core/index.js.map +0 -1
  236. package/dist/core/index.mjs.map +0 -1
  237. package/dist/dataLayerProvider-3y21KtF-.d.cts +0 -61
  238. package/dist/diagnostics/index.d.cts +0 -561
  239. package/dist/diagnostics/index.mjs.map +0 -1
  240. package/dist/impl/couch/index.d.cts +0 -620
  241. package/dist/impl/couch/index.js.map +0 -1
  242. package/dist/impl/static/index.d.cts +0 -232
  243. package/dist/impl/static/index.js.map +0 -1
  244. package/dist/impl/static/index.mjs.map +0 -1
  245. package/dist/index-BIum9Ue2.d.cts +0 -137
  246. package/dist/index.d.cts +0 -1663
  247. package/dist/index.js.map +0 -1
  248. package/dist/index.mjs.map +0 -1
  249. package/dist/pouch/index.d.cts +0 -1
  250. package/dist/pouch/index.js.map +0 -1
  251. package/dist/pouch/index.mjs.map +0 -1
  252. package/dist/types-BcWVH4ww.d.cts +0 -58
  253. package/dist/types-legacy-DdVjg81H.d.ts +0 -168
  254. package/dist/util/packer/index.d.cts +0 -5
  255. package/dist/util/packer/index.js.map +0 -1
  256. package/dist/util/packer/index.mjs.map +0 -1
  257. package/src/study/getCardDataShape.ts +0 -34
  258. /package/dist/diagnostics/{index.js.map → index.cjs.map} +0 -0
@@ -0,0 +1,15 @@
1
+ import PouchDB from "pouchdb";
2
+ import PouchDBFind from "pouchdb-find";
3
+ import PouchDBAuth from "@nilock2/pouchdb-authentication";
4
+ import process from "process";
5
+ //#region src/impl/couch/pouchdb-setup.ts
6
+ if (typeof window !== "undefined") window.process = process;
7
+ PouchDB.plugin(PouchDBFind);
8
+ PouchDB.plugin(PouchDBAuth);
9
+ if (typeof PouchDB.debug !== "undefined") PouchDB.debug.disable();
10
+ PouchDB.defaults({});
11
+ var pouchdb_setup_default = PouchDB;
12
+ //#endregion
13
+ export { pouchdb_setup_default as default };
14
+
15
+ //# sourceMappingURL=pouchdb-setup.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pouchdb-setup.mjs","names":[],"sources":["../../../src/impl/couch/pouchdb-setup.ts"],"sourcesContent":["import PouchDB from 'pouchdb';\nimport PouchDBFind from 'pouchdb-find';\nimport PouchDBAuth from '@nilock2/pouchdb-authentication';\nimport process from 'process';\n\n// PouchDB expects a global `process` in browsers (#18). Set here, beside the\n// plugin registration, so every path to PouchDB gets it. (This module is in\n// package.json's \"sideEffects\".)\nif (typeof window !== 'undefined') {\n (window as unknown as { process: unknown }).process = process;\n}\n\n// Register plugins\nPouchDB.plugin(PouchDBFind);\nPouchDB.plugin(PouchDBAuth);\n\n// Disable PouchDB debug logging to prevent interference with CLI prompts\n// Debug logging (like DerivedLogger.emit) will still go to the TUI log file\n// if initializeTuiLogging() has been called, but won't clutter terminal output\nif (typeof PouchDB.debug !== 'undefined') {\n PouchDB.debug.disable();\n}\n\n// Configure PouchDB globally\nPouchDB.defaults({\n // ajax: {\n // timeout: 60000,\n // },\n});\n\nexport default PouchDB;\n"],"mappings":";;;;;AAQA,IAAI,OAAO,WAAW,YACnB,QAA2C,UAAU;AAIxD,QAAQ,OAAO,YAAY;AAC3B,QAAQ,OAAO,YAAY;AAK3B,IAAI,OAAO,QAAQ,UAAU,YAC3B,SAAQ,MAAM,SAAS;AAIzB,QAAQ,SAAS,EAIhB,CAAC;AAEF,IAAA,wBAAe"}
@@ -0,0 +1,101 @@
1
+ import "../../_virtual/_rolldown/runtime.mjs";
2
+ import { logger } from "../../util/logger.mjs";
3
+ import { Loggable } from "../../util/Loggable.mjs";
4
+ //#region src/impl/couch/updateQueue.ts
5
+ var UpdateQueue = class extends Loggable {
6
+ _className = "UpdateQueue";
7
+ pendingUpdates = {};
8
+ inprogressUpdates = {};
9
+ readDB;
10
+ writeDB;
11
+ /**
12
+ * Queues an update for a document and applies it with conflict resolution.
13
+ *
14
+ * @param id - Document ID to update
15
+ * @param update - Partial object or function that transforms the document
16
+ * @returns Promise resolving to the updated document
17
+ *
18
+ * @throws {PouchError} with status 404 if document doesn't exist
19
+ *
20
+ * @remarks
21
+ * **Error Handling Pattern:**
22
+ * - This method does NOT create documents if they don't exist
23
+ * - Callers are responsible for handling 404 errors and creating documents
24
+ * - This design maintains separation of concerns (UpdateQueue handles conflicts, callers handle lifecycle)
25
+ *
26
+ * @example
27
+ * ```typescript
28
+ * try {
29
+ * await updateQueue.update(docId, (doc) => ({ ...doc, field: newValue }));
30
+ * } catch (e) {
31
+ * if ((e as PouchError).status === 404) {
32
+ * // Create the document with initial values
33
+ * await db.put({ _id: docId, field: newValue, ...initialFields });
34
+ * }
35
+ * }
36
+ * ```
37
+ */
38
+ update(id, update) {
39
+ logger.debug(`Update requested on doc: ${id}`);
40
+ if (this.pendingUpdates[id]) this.pendingUpdates[id].push(update);
41
+ else this.pendingUpdates[id] = [update];
42
+ return this.applyUpdates(id);
43
+ }
44
+ constructor(readDB, writeDB) {
45
+ super();
46
+ this.readDB = readDB;
47
+ this.writeDB = writeDB || readDB;
48
+ logger.debug(`UpdateQ initialized...`);
49
+ this.readDB.info().then((i) => {
50
+ logger.debug(`db info: ${JSON.stringify(i)}`);
51
+ });
52
+ }
53
+ async applyUpdates(id) {
54
+ logger.debug(`Applying updates on doc: ${id}`);
55
+ if (this.inprogressUpdates[id]) {
56
+ while (this.inprogressUpdates[id]) await new Promise((resolve) => setTimeout(resolve, Math.random() * 50));
57
+ return this.applyUpdates(id);
58
+ } else if (this.pendingUpdates[id] && this.pendingUpdates[id].length > 0) {
59
+ this.inprogressUpdates[id] = true;
60
+ const MAX_RETRIES = 5;
61
+ for (let i = 0; i < MAX_RETRIES; i++) try {
62
+ let updatedDoc = { ...await this.readDB.get(id) };
63
+ const updatesToApply = [...this.pendingUpdates[id]];
64
+ for (const update of updatesToApply) if (typeof update === "function") updatedDoc = {
65
+ ...updatedDoc,
66
+ ...update(updatedDoc)
67
+ };
68
+ else updatedDoc = {
69
+ ...updatedDoc,
70
+ ...update
71
+ };
72
+ await this.writeDB.put(updatedDoc);
73
+ this.pendingUpdates[id].splice(0, updatesToApply.length);
74
+ if (this.pendingUpdates[id].length === 0) {
75
+ this.inprogressUpdates[id] = false;
76
+ delete this.inprogressUpdates[id];
77
+ } else return this.applyUpdates(id);
78
+ return updatedDoc;
79
+ } catch (e) {
80
+ if (e.name === "conflict" && i < MAX_RETRIES - 1) {
81
+ logger.warn(`Conflict on update for doc ${id}, retry #${i + 1}`);
82
+ await new Promise((res) => setTimeout(res, 50 * Math.random()));
83
+ } else if (e.name === "not_found" && i === 0) {
84
+ logger.warn(`Update failed for ${id} - does not exist. Throwing to caller.`);
85
+ delete this.inprogressUpdates[id];
86
+ throw e;
87
+ } else {
88
+ delete this.inprogressUpdates[id];
89
+ if (this.pendingUpdates[id]) delete this.pendingUpdates[id];
90
+ logger.error(`Error on attemped update (retry ${i}): ${JSON.stringify(e)}`);
91
+ throw e;
92
+ }
93
+ }
94
+ throw new Error(`UpdateQueue failed for doc ${id} after ${MAX_RETRIES} retries.`);
95
+ } else throw new Error(`Empty Updates Queue Triggered`);
96
+ }
97
+ };
98
+ //#endregion
99
+ export { UpdateQueue as default };
100
+
101
+ //# sourceMappingURL=updateQueue.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"updateQueue.mjs","names":[],"sources":["../../../src/impl/couch/updateQueue.ts"],"sourcesContent":["import { Loggable } from '../../util/Loggable';\nimport { logger } from '../../util/logger';\n\nexport type Update<T> = Partial<T> | ((x: T) => T);\n\nexport default class UpdateQueue extends Loggable {\n _className: string = 'UpdateQueue';\n private pendingUpdates: {\n [index: string]: Update<unknown>[];\n } = {};\n private inprogressUpdates: {\n [index: string]: boolean;\n } = {};\n\n private readDB: PouchDB.Database; // Database for read operations\n private writeDB: PouchDB.Database; // Database for write operations (local-first)\n\n /**\n * Queues an update for a document and applies it with conflict resolution.\n *\n * @param id - Document ID to update\n * @param update - Partial object or function that transforms the document\n * @returns Promise resolving to the updated document\n *\n * @throws {PouchError} with status 404 if document doesn't exist\n *\n * @remarks\n * **Error Handling Pattern:**\n * - This method does NOT create documents if they don't exist\n * - Callers are responsible for handling 404 errors and creating documents\n * - This design maintains separation of concerns (UpdateQueue handles conflicts, callers handle lifecycle)\n *\n * @example\n * ```typescript\n * try {\n * await updateQueue.update(docId, (doc) => ({ ...doc, field: newValue }));\n * } catch (e) {\n * if ((e as PouchError).status === 404) {\n * // Create the document with initial values\n * await db.put({ _id: docId, field: newValue, ...initialFields });\n * }\n * }\n * ```\n */\n public update<T extends PouchDB.Core.Document<object>>(\n id: PouchDB.Core.DocumentId,\n update: Update<T>\n ) {\n logger.debug(`Update requested on doc: ${id}`);\n if (this.pendingUpdates[id]) {\n this.pendingUpdates[id].push(update);\n } else {\n this.pendingUpdates[id] = [update];\n }\n return this.applyUpdates<T>(id);\n }\n\n constructor(readDB: PouchDB.Database, writeDB?: PouchDB.Database) {\n super();\n // PouchDB.debug.enable('*');\n this.readDB = readDB;\n this.writeDB = writeDB || readDB; // Default to readDB if writeDB not provided\n logger.debug(`UpdateQ initialized...`);\n void this.readDB.info().then((i) => {\n logger.debug(`db info: ${JSON.stringify(i)}`);\n });\n }\n\n private async applyUpdates<T extends PouchDB.Core.Document<object>>(\n id: string\n ): Promise<T & PouchDB.Core.GetMeta & PouchDB.Core.RevisionIdMeta> {\n logger.debug(`Applying updates on doc: ${id}`);\n if (this.inprogressUpdates[id]) {\n // Poll instead of recursing to avoid infinite recursion\n while (this.inprogressUpdates[id]) {\n await new Promise(resolve => setTimeout(resolve, Math.random() * 50));\n }\n return this.applyUpdates<T>(id);\n } else {\n if (this.pendingUpdates[id] && this.pendingUpdates[id].length > 0) {\n this.inprogressUpdates[id] = true;\n\n const MAX_RETRIES = 5;\n for (let i = 0; i < MAX_RETRIES; i++) {\n try {\n const doc = await this.readDB.get<T>(id);\n\n // Create a new doc object to apply updates to for this attempt\n let updatedDoc = { ...doc };\n\n // Note: This loop is not fully safe if updates are functions that depend on a specific doc state\n // that might change between retries. But for simple object merges, it's okay.\n const updatesToApply = [...this.pendingUpdates[id]];\n for (const update of updatesToApply) {\n if (typeof update === 'function') {\n updatedDoc = { ...updatedDoc, ...update(updatedDoc) };\n } else {\n updatedDoc = {\n ...updatedDoc,\n ...update,\n };\n }\n }\n\n await this.writeDB.put<T>(updatedDoc);\n\n // Success! Remove the updates we just applied.\n this.pendingUpdates[id].splice(0, updatesToApply.length);\n\n if (this.pendingUpdates[id].length === 0) {\n this.inprogressUpdates[id] = false;\n delete this.inprogressUpdates[id];\n } else {\n // More updates came in, run again.\n return this.applyUpdates<T>(id);\n }\n return updatedDoc as any; // success, exit loop and function\n } catch (e: any) {\n if (e.name === 'conflict' && i < MAX_RETRIES - 1) {\n logger.warn(`Conflict on update for doc ${id}, retry #${i + 1}`);\n await new Promise((res) => setTimeout(res, 50 * Math.random()));\n // continue to next iteration of the loop\n } else if (e.name === 'not_found' && i === 0) {\n // Document not present - throw to caller for initialization\n logger.warn(`Update failed for ${id} - does not exist. Throwing to caller.`);\n delete this.inprogressUpdates[id];\n throw e; // Let caller handle\n } else {\n // Max retries reached or a non-conflict error\n delete this.inprogressUpdates[id];\n if (this.pendingUpdates[id]) {\n delete this.pendingUpdates[id];\n }\n logger.error(`Error on attemped update (retry ${i}): ${JSON.stringify(e)}`);\n throw e; // Let caller handle\n }\n }\n }\n // This should be unreachable, but it satisfies the compiler that a value is always returned or an error thrown.\n throw new Error(`UpdateQueue failed for doc ${id} after ${MAX_RETRIES} retries.`);\n } else {\n throw new Error(`Empty Updates Queue Triggered`);\n }\n }\n }\n}\n"],"mappings":";;;;AAKA,IAAqB,cAArB,cAAyC,SAAS;CAChD,aAAqB;CACrB,iBAEI,EAAE;CACN,oBAEI,EAAE;CAEN;CACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BA,OACE,IACA,QACA;AACA,SAAO,MAAM,4BAA4B,KAAK;AAC9C,MAAI,KAAK,eAAe,IACtB,MAAK,eAAe,IAAI,KAAK,OAAO;MAEpC,MAAK,eAAe,MAAM,CAAC,OAAO;AAEpC,SAAO,KAAK,aAAgB,GAAG;;CAGjC,YAAY,QAA0B,SAA4B;AAChE,SAAO;AAEP,OAAK,SAAS;AACd,OAAK,UAAU,WAAW;AAC1B,SAAO,MAAM,yBAAyB;AACjC,OAAK,OAAO,MAAM,CAAC,MAAM,MAAM;AAClC,UAAO,MAAM,YAAY,KAAK,UAAU,EAAE,GAAG;IAC7C;;CAGJ,MAAc,aACZ,IACiE;AACjE,SAAO,MAAM,4BAA4B,KAAK;AAC9C,MAAI,KAAK,kBAAkB,KAAK;AAE9B,UAAO,KAAK,kBAAkB,IAC5B,OAAM,IAAI,SAAQ,YAAW,WAAW,SAAS,KAAK,QAAQ,GAAG,GAAG,CAAC;AAEvE,UAAO,KAAK,aAAgB,GAAG;aAE3B,KAAK,eAAe,OAAO,KAAK,eAAe,IAAI,SAAS,GAAG;AACjE,QAAK,kBAAkB,MAAM;GAE7B,MAAM,cAAc;AACpB,QAAK,IAAI,IAAI,GAAG,IAAI,aAAa,IAC/B,KAAI;IAIF,IAAI,aAAa,EAAE,GAHP,MAAM,KAAK,OAAO,IAAO,GAAG,EAGb;IAI3B,MAAM,iBAAiB,CAAC,GAAG,KAAK,eAAe,IAAI;AACnD,SAAK,MAAM,UAAU,eACnB,KAAI,OAAO,WAAW,WACpB,cAAa;KAAE,GAAG;KAAY,GAAG,OAAO,WAAW;KAAE;QAErD,cAAa;KACX,GAAG;KACH,GAAG;KACJ;AAIL,UAAM,KAAK,QAAQ,IAAO,WAAW;AAGrC,SAAK,eAAe,IAAI,OAAO,GAAG,eAAe,OAAO;AAExD,QAAI,KAAK,eAAe,IAAI,WAAW,GAAG;AACxC,UAAK,kBAAkB,MAAM;AAC7B,YAAO,KAAK,kBAAkB;UAG9B,QAAO,KAAK,aAAgB,GAAG;AAEjC,WAAO;YACA,GAAQ;AACf,QAAI,EAAE,SAAS,cAAc,IAAI,cAAc,GAAG;AAChD,YAAO,KAAK,8BAA8B,GAAG,WAAW,IAAI,IAAI;AAChE,WAAM,IAAI,SAAS,QAAQ,WAAW,KAAK,KAAK,KAAK,QAAQ,CAAC,CAAC;eAEtD,EAAE,SAAS,eAAe,MAAM,GAAG;AAE5C,YAAO,KAAK,qBAAqB,GAAG,wCAAwC;AAC5E,YAAO,KAAK,kBAAkB;AAC9B,WAAM;WACD;AAEL,YAAO,KAAK,kBAAkB;AAC9B,SAAI,KAAK,eAAe,IACtB,QAAO,KAAK,eAAe;AAE7B,YAAO,MAAM,mCAAmC,EAAE,KAAK,KAAK,UAAU,EAAE,GAAG;AAC3E,WAAM;;;AAKZ,SAAM,IAAI,MAAM,8BAA8B,GAAG,SAAS,YAAY,WAAW;QAEjF,OAAM,IAAI,MAAM,gCAAgC"}
@@ -0,0 +1,55 @@
1
+ import "../../_virtual/_rolldown/runtime.mjs";
2
+ import { logger } from "../../util/logger.mjs";
3
+ import moment from "moment";
4
+ //#region src/impl/couch/user-course-relDB.ts
5
+ var UsrCrsData = class {
6
+ user;
7
+ _courseId;
8
+ constructor(user, courseId) {
9
+ this.user = user;
10
+ this._courseId = courseId;
11
+ }
12
+ async getReviewsForcast(daysCount) {
13
+ const time = moment.utc().add(daysCount, "days");
14
+ return this.getReviewstoDate(time);
15
+ }
16
+ async getPendingReviews() {
17
+ const now = moment.utc();
18
+ return this.getReviewstoDate(now);
19
+ }
20
+ async getScheduledReviewCount() {
21
+ return (await this.getPendingReviews()).length;
22
+ }
23
+ async getCourseSettings() {
24
+ const crsDoc = (await this.user.getCourseRegistrationsDoc()).courses.find((c) => c.courseID === this._courseId);
25
+ if (crsDoc && crsDoc.settings) return crsDoc.settings;
26
+ else {
27
+ logger.warn(`no settings found during lookup on course ${this._courseId}`);
28
+ return {};
29
+ }
30
+ }
31
+ updateCourseSettings(updates) {
32
+ if ("updateCourseSettings" in this.user) this.user.updateCourseSettings(this._courseId, updates);
33
+ }
34
+ async getStrategyState(strategyKey) {
35
+ return this.user.getStrategyState(this._courseId, strategyKey);
36
+ }
37
+ async putStrategyState(strategyKey, data) {
38
+ return this.user.putStrategyState(this._courseId, strategyKey, data);
39
+ }
40
+ async deleteStrategyState(strategyKey) {
41
+ return this.user.deleteStrategyState(this._courseId, strategyKey);
42
+ }
43
+ async getReviewstoDate(targetDate) {
44
+ const allReviews = await this.user.getPendingReviews(this._courseId);
45
+ logger.debug(`Fetching ${this.user.getUsername()}'s scheduled reviews for course ${this._courseId}.`);
46
+ return allReviews.filter((review) => {
47
+ const reviewTime = moment.utc(review.reviewTime);
48
+ return targetDate.isAfter(reviewTime);
49
+ });
50
+ }
51
+ };
52
+ //#endregion
53
+ export { UsrCrsData };
54
+
55
+ //# sourceMappingURL=user-course-relDB.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"user-course-relDB.mjs","names":[],"sources":["../../../src/impl/couch/user-course-relDB.ts"],"sourcesContent":["import {\n ScheduledCard,\n UserCourseSetting,\n UserCourseSettings,\n UsrCrsDataInterface,\n} from '@db/core';\n\nimport moment, { Moment } from 'moment';\n\nimport { UserDBInterface } from '@db/core';\nimport { logger } from '../../util/logger';\n\nexport class UsrCrsData implements UsrCrsDataInterface {\n private user: UserDBInterface;\n private _courseId: string;\n\n constructor(user: UserDBInterface, courseId: string) {\n this.user = user;\n this._courseId = courseId;\n }\n\n public async getReviewsForcast(daysCount: number) {\n const time = moment.utc().add(daysCount, 'days');\n return this.getReviewstoDate(time);\n }\n\n public async getPendingReviews() {\n const now = moment.utc();\n return this.getReviewstoDate(now);\n }\n\n public async getScheduledReviewCount(): Promise<number> {\n return (await this.getPendingReviews()).length;\n }\n\n public async getCourseSettings(): Promise<UserCourseSettings> {\n const regDoc = await this.user.getCourseRegistrationsDoc();\n const crsDoc = regDoc.courses.find((c) => c.courseID === this._courseId);\n\n if (crsDoc && crsDoc.settings) {\n return crsDoc.settings;\n } else {\n logger.warn(`no settings found during lookup on course ${this._courseId}`);\n return {};\n }\n }\n public updateCourseSettings(updates: UserCourseSetting[]): void {\n // TODO: Add updateCourseSettings method to UserDBInterface\n // For now, we'll need to cast to access the concrete implementation\n if ('updateCourseSettings' in this.user) {\n void (this.user as any).updateCourseSettings(this._courseId, updates);\n }\n }\n\n public async getStrategyState<T>(strategyKey: string): Promise<T | null> {\n return this.user.getStrategyState<T>(this._courseId, strategyKey);\n }\n\n public async putStrategyState<T>(strategyKey: string, data: T): Promise<void> {\n return this.user.putStrategyState<T>(this._courseId, strategyKey, data);\n }\n\n public async deleteStrategyState(strategyKey: string): Promise<void> {\n return this.user.deleteStrategyState(this._courseId, strategyKey);\n }\n\n private async getReviewstoDate(targetDate: Moment) {\n // Use the interface method instead of direct database access\n const allReviews = await this.user.getPendingReviews(this._courseId);\n\n logger.debug(\n `Fetching ${this.user.getUsername()}'s scheduled reviews for course ${this._courseId}.`\n );\n\n return allReviews.filter((review: ScheduledCard) => {\n const reviewTime = moment.utc(review.reviewTime);\n return targetDate.isAfter(reviewTime);\n });\n }\n}\n"],"mappings":";;;;AAYA,IAAa,aAAb,MAAuD;CACrD;CACA;CAEA,YAAY,MAAuB,UAAkB;AACnD,OAAK,OAAO;AACZ,OAAK,YAAY;;CAGnB,MAAa,kBAAkB,WAAmB;EAChD,MAAM,OAAO,OAAO,KAAK,CAAC,IAAI,WAAW,OAAO;AAChD,SAAO,KAAK,iBAAiB,KAAK;;CAGpC,MAAa,oBAAoB;EAC/B,MAAM,MAAM,OAAO,KAAK;AACxB,SAAO,KAAK,iBAAiB,IAAI;;CAGnC,MAAa,0BAA2C;AACtD,UAAQ,MAAM,KAAK,mBAAmB,EAAE;;CAG1C,MAAa,oBAAiD;EAE5D,MAAM,UADS,MAAM,KAAK,KAAK,2BAA2B,EACpC,QAAQ,MAAM,MAAM,EAAE,aAAa,KAAK,UAAU;AAExE,MAAI,UAAU,OAAO,SACnB,QAAO,OAAO;OACT;AACL,UAAO,KAAK,6CAA6C,KAAK,YAAY;AAC1E,UAAO,EAAE;;;CAGb,qBAA4B,SAAoC;AAG9D,MAAI,0BAA0B,KAAK,KAC3B,MAAK,KAAa,qBAAqB,KAAK,WAAW,QAAQ;;CAIzE,MAAa,iBAAoB,aAAwC;AACvE,SAAO,KAAK,KAAK,iBAAoB,KAAK,WAAW,YAAY;;CAGnE,MAAa,iBAAoB,aAAqB,MAAwB;AAC5E,SAAO,KAAK,KAAK,iBAAoB,KAAK,WAAW,aAAa,KAAK;;CAGzE,MAAa,oBAAoB,aAAoC;AACnE,SAAO,KAAK,KAAK,oBAAoB,KAAK,WAAW,YAAY;;CAGnE,MAAc,iBAAiB,YAAoB;EAEjD,MAAM,aAAa,MAAM,KAAK,KAAK,kBAAkB,KAAK,UAAU;AAEpE,SAAO,MACL,YAAY,KAAK,KAAK,aAAa,CAAC,kCAAkC,KAAK,UAAU,GACtF;AAED,SAAO,WAAW,QAAQ,WAA0B;GAClD,MAAM,aAAa,OAAO,IAAI,OAAO,WAAW;AAChD,UAAO,WAAW,QAAQ,WAAW;IACrC"}
@@ -0,0 +1,49 @@
1
+ import "../../_virtual/_rolldown/runtime.mjs";
2
+ import { getLocalUserDB } from "../common/userDBHelpers.mjs";
3
+ import { accomodateGuest } from "../common/BaseUserDB.mjs";
4
+ //#region src/impl/static/NoOpSyncStrategy.ts
5
+ /**
6
+ * Sync strategy for static deployments that provides no-op implementations
7
+ * for remote operations. Uses only local storage with no remote synchronization.
8
+ */
9
+ var NoOpSyncStrategy = class {
10
+ currentUsername = accomodateGuest().username;
11
+ setupRemoteDB(username) {
12
+ return getLocalUserDB(username);
13
+ }
14
+ getWriteDB(username) {
15
+ return getLocalUserDB(username);
16
+ }
17
+ startSync(_localDB, _remoteDB) {}
18
+ stopSync() {}
19
+ canCreateAccount() {
20
+ return false;
21
+ }
22
+ canAuthenticate() {
23
+ return false;
24
+ }
25
+ async createAccount(_username, _password) {
26
+ throw new Error("Account creation not supported in static mode. Use local account switching instead.");
27
+ }
28
+ async authenticate(_username, _password) {
29
+ throw new Error("Remote authentication not supported in static mode. Use local account switching instead.");
30
+ }
31
+ async logout() {
32
+ this.currentUsername = accomodateGuest().username;
33
+ return { ok: true };
34
+ }
35
+ async getCurrentUsername() {
36
+ return this.currentUsername;
37
+ }
38
+ /**
39
+ * Set the current username (for local account switching)
40
+ * This method is specific to NoOpSyncStrategy and not part of the base interface
41
+ */
42
+ setCurrentUsername(username) {
43
+ this.currentUsername = username;
44
+ }
45
+ };
46
+ //#endregion
47
+ export { NoOpSyncStrategy };
48
+
49
+ //# sourceMappingURL=NoOpSyncStrategy.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"NoOpSyncStrategy.mjs","names":[],"sources":["../../../src/impl/static/NoOpSyncStrategy.ts"],"sourcesContent":["// packages/db/src/impl/static/NoOpSyncStrategy.ts\nimport type { SyncStrategy } from '../common/SyncStrategy';\nimport type { AccountCreationResult, AuthenticationResult } from '../common/types';\nimport { getLocalUserDB, accomodateGuest } from '../common';\n\n/**\n * Sync strategy for static deployments that provides no-op implementations\n * for remote operations. Uses only local storage with no remote synchronization.\n */\nexport class NoOpSyncStrategy implements SyncStrategy {\n private currentUsername: string = accomodateGuest().username;\n\n setupRemoteDB(username: string): PouchDB.Database {\n // Return the same database instance as local - sync with self is a no-op\n return getLocalUserDB(username);\n }\n\n getWriteDB(username: string): PouchDB.Database {\n // In static mode, always write to local database\n return getLocalUserDB(username);\n }\n\n startSync(_localDB: PouchDB.Database, _remoteDB: PouchDB.Database): void {\n // No-op - in static mode, local and remote are the same database instance\n // PouchDB sync with itself is harmless and efficient\n }\n\n stopSync?(): void {\n // No-op - no sync to stop in static mode\n }\n\n canCreateAccount(): boolean {\n return false; // Account creation not supported in static mode\n }\n\n canAuthenticate(): boolean {\n return false; // Remote authentication not supported in static mode\n }\n\n async createAccount(_username: string, _password: string): Promise<AccountCreationResult> {\n throw new Error(\n 'Account creation not supported in static mode. Use local account switching instead.'\n );\n }\n\n async authenticate(_username: string, _password: string): Promise<AuthenticationResult> {\n throw new Error(\n 'Remote authentication not supported in static mode. Use local account switching instead.'\n );\n }\n\n async logout(): Promise<AuthenticationResult> {\n // In static mode, \"logout\" means switch back to guest user\n this.currentUsername = accomodateGuest().username;\n return {\n ok: true,\n };\n }\n\n async getCurrentUsername(): Promise<string> {\n // In static mode, always return guest username\n // TODO: This will be enhanced with local account switching to support multiple local users\n return this.currentUsername;\n }\n\n /**\n * Set the current username (for local account switching)\n * This method is specific to NoOpSyncStrategy and not part of the base interface\n */\n setCurrentUsername(username: string): void {\n this.currentUsername = username;\n }\n}\n"],"mappings":";;;;;;;;AASA,IAAa,mBAAb,MAAsD;CACpD,kBAAkC,iBAAiB,CAAC;CAEpD,cAAc,UAAoC;AAEhD,SAAO,eAAe,SAAS;;CAGjC,WAAW,UAAoC;AAE7C,SAAO,eAAe,SAAS;;CAGjC,UAAU,UAA4B,WAAmC;CAKzE,WAAkB;CAIlB,mBAA4B;AAC1B,SAAO;;CAGT,kBAA2B;AACzB,SAAO;;CAGT,MAAM,cAAc,WAAmB,WAAmD;AACxF,QAAM,IAAI,MACR,sFACD;;CAGH,MAAM,aAAa,WAAmB,WAAkD;AACtF,QAAM,IAAI,MACR,2FACD;;CAGH,MAAM,SAAwC;AAE5C,OAAK,kBAAkB,iBAAiB,CAAC;AACzC,SAAO,EACL,IAAI,MACL;;CAGH,MAAM,qBAAsC;AAG1C,SAAO,KAAK;;;;;;CAOd,mBAAmB,UAAwB;AACzC,OAAK,kBAAkB"}
@@ -0,0 +1,94 @@
1
+ import "../../_virtual/_rolldown/runtime.mjs";
2
+ import { logger } from "../../util/logger.mjs";
3
+ import { BaseUser } from "../common/BaseUserDB.mjs";
4
+ import { StaticDataUnpacker } from "./StaticDataUnpacker.mjs";
5
+ import { StaticCourseDB } from "./courseDB.mjs";
6
+ import { StaticCoursesDB } from "./coursesDB.mjs";
7
+ import { NoOpSyncStrategy } from "./NoOpSyncStrategy.mjs";
8
+ //#region src/impl/static/StaticDataLayerProvider.ts
9
+ var StaticDataLayerProvider = class {
10
+ config;
11
+ initialized = false;
12
+ courseUnpackers = /* @__PURE__ */ new Map();
13
+ manifests = {};
14
+ dependencyNameToCourseId = /* @__PURE__ */ new Map();
15
+ constructor(config) {
16
+ this.config = {
17
+ localStoragePrefix: config.localStoragePrefix || "skuilder-static",
18
+ rootManifest: config.rootManifest || { dependencies: {} },
19
+ rootManifestUrl: config.rootManifestUrl || "/"
20
+ };
21
+ }
22
+ async resolveCourseDependencies() {
23
+ logger.info("[StaticDataLayerProvider] Starting course dependency resolution...");
24
+ const rootManifest = this.config.rootManifest;
25
+ for (const [courseName, courseUrl] of Object.entries(rootManifest.dependencies || {})) try {
26
+ logger.debug(`[StaticDataLayerProvider] Resolving dependency: ${courseName} from ${courseUrl}`);
27
+ const courseManifestUrl = new URL(courseUrl, this.config.rootManifestUrl).href;
28
+ const courseJsonResponse = await fetch(courseManifestUrl);
29
+ if (!courseJsonResponse.ok) throw new Error(`Failed to fetch course manifest for ${courseName}`);
30
+ const courseJson = await courseJsonResponse.json();
31
+ if (courseJson.content && courseJson.content.manifest) {
32
+ const baseUrl = new URL(".", courseManifestUrl).href;
33
+ const finalManifestUrl = new URL(courseJson.content.manifest, courseManifestUrl).href;
34
+ const finalManifestResponse = await fetch(finalManifestUrl);
35
+ if (!finalManifestResponse.ok) throw new Error(`Failed to fetch final content manifest for ${courseName} at ${finalManifestUrl}`);
36
+ const finalManifest = await finalManifestResponse.json();
37
+ const courseId = finalManifest.courseId || finalManifest.courseConfig?.courseID;
38
+ if (!courseId) throw new Error(`Course manifest for ${courseName} missing courseId`);
39
+ this.manifests[courseId] = finalManifest;
40
+ const unpacker = new StaticDataUnpacker(finalManifest, baseUrl);
41
+ this.courseUnpackers.set(courseId, unpacker);
42
+ this.dependencyNameToCourseId.set(courseName, courseId);
43
+ logger.info(`[StaticDataLayerProvider] Successfully resolved and prepared course: ${courseName} (courseId: ${courseId})`);
44
+ }
45
+ } catch (e) {
46
+ logger.error(`[StaticDataLayerProvider] Failed to resolve dependency ${courseName}:`, e);
47
+ }
48
+ logger.info("[StaticDataLayerProvider] Course dependency resolution complete.");
49
+ }
50
+ async initialize() {
51
+ if (this.initialized) return;
52
+ logger.info("Initializing static data layer provider");
53
+ await this.resolveCourseDependencies();
54
+ this.initialized = true;
55
+ }
56
+ async teardown() {
57
+ this.courseUnpackers.clear();
58
+ this.initialized = false;
59
+ }
60
+ getUserDB() {
61
+ const syncStrategy = new NoOpSyncStrategy();
62
+ return BaseUser.Dummy(syncStrategy);
63
+ }
64
+ getCourseDB(courseId) {
65
+ let unpacker = this.courseUnpackers.get(courseId);
66
+ let actualCourseId = courseId;
67
+ if (!unpacker) {
68
+ const mappedCourseId = this.dependencyNameToCourseId.get(courseId);
69
+ if (mappedCourseId) {
70
+ unpacker = this.courseUnpackers.get(mappedCourseId);
71
+ actualCourseId = mappedCourseId;
72
+ }
73
+ }
74
+ if (!unpacker) throw new Error(`Course ${courseId} not found or failed to initialize in static data layer.`);
75
+ const manifest = this.manifests[actualCourseId];
76
+ return new StaticCourseDB(actualCourseId, unpacker, this.getUserDB(), manifest);
77
+ }
78
+ getCoursesDB() {
79
+ return new StaticCoursesDB(this.manifests, this.dependencyNameToCourseId);
80
+ }
81
+ async getClassroomDB(_classId, _type) {
82
+ throw new Error("Classrooms not supported in static mode");
83
+ }
84
+ getAdminDB() {
85
+ throw new Error("Admin functions not supported in static mode");
86
+ }
87
+ isReadOnly() {
88
+ return true;
89
+ }
90
+ };
91
+ //#endregion
92
+ export { StaticDataLayerProvider };
93
+
94
+ //# sourceMappingURL=StaticDataLayerProvider.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"StaticDataLayerProvider.mjs","names":[],"sources":["../../../src/impl/static/StaticDataLayerProvider.ts"],"sourcesContent":["\n// packages/db/src/impl/static/StaticDataLayerProvider.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 { StaticCourseManifest } from '../../util/packer/types';\nimport { StaticDataUnpacker } from './StaticDataUnpacker';\nimport { StaticCourseDB } from './courseDB';\nimport { StaticCoursesDB } from './coursesDB';\nimport { BaseUser } from '../common';\nimport { NoOpSyncStrategy } from './NoOpSyncStrategy';\n\n\ninterface SkuilderManifest {\n name?: string;\n version?: string;\n description?: string;\n dependencies?: Record<string, string>;\n}\n\ninterface StaticDataLayerConfig {\n localStoragePrefix?: string;\n rootManifest: SkuilderManifest; // The parsed root skuilder.json object\n rootManifestUrl: string; // The absolute URL where the root manifest was found\n}\n\nexport class StaticDataLayerProvider implements DataLayerProvider {\n private config: StaticDataLayerConfig;\n private initialized: boolean = false;\n private courseUnpackers: Map<string, StaticDataUnpacker> = new Map();\n private manifests: Record<string, StaticCourseManifest> = {};\n // Mapping from dependency name to actual courseId for backwards compatibility\n private dependencyNameToCourseId: Map<string, string> = new Map();\n\n constructor(config: Partial<StaticDataLayerConfig>) {\n this.config = {\n localStoragePrefix: config.localStoragePrefix || 'skuilder-static',\n rootManifest: config.rootManifest || { dependencies: {} },\n rootManifestUrl: config.rootManifestUrl || '/',\n };\n }\n\n private async resolveCourseDependencies(): Promise<void> {\n logger.info('[StaticDataLayerProvider] Starting course dependency resolution...');\n const rootManifest = this.config.rootManifest;\n\n for (const [courseName, courseUrl] of Object.entries(rootManifest.dependencies || {})) {\n try {\n logger.debug(`[StaticDataLayerProvider] Resolving dependency: ${courseName} from ${courseUrl}`);\n \n const courseManifestUrl = new URL(courseUrl as string, this.config.rootManifestUrl).href;\n const courseJsonResponse = await fetch(courseManifestUrl);\n if (!courseJsonResponse.ok) {\n throw new Error(`Failed to fetch course manifest for ${courseName}`);\n }\n const courseJson = await courseJsonResponse.json();\n\n if (courseJson.content && courseJson.content.manifest) {\n const baseUrl = new URL('.', courseManifestUrl).href;\n const finalManifestUrl = new URL(courseJson.content.manifest, courseManifestUrl).href;\n\n const finalManifestResponse = await fetch(finalManifestUrl);\n if (!finalManifestResponse.ok) {\n throw new Error(`Failed to fetch final content manifest for ${courseName} at ${finalManifestUrl}`);\n }\n const finalManifest = await finalManifestResponse.json();\n\n // Extract courseId from the manifest to use as the lookup key\n const courseId = finalManifest.courseId || finalManifest.courseConfig?.courseID;\n if (!courseId) {\n throw new Error(`Course manifest for ${courseName} missing courseId`);\n }\n\n this.manifests[courseId] = finalManifest;\n const unpacker = new StaticDataUnpacker(finalManifest, baseUrl);\n this.courseUnpackers.set(courseId, unpacker);\n\n // Also store mapping from dependency name to courseId for backwards compatibility\n // This allows lookup by either dependency name or courseId\n this.dependencyNameToCourseId.set(courseName, courseId);\n\n logger.info(`[StaticDataLayerProvider] Successfully resolved and prepared course: ${courseName} (courseId: ${courseId})`);\n }\n } catch (e) {\n logger.error(`[StaticDataLayerProvider] Failed to resolve dependency ${courseName}:`, e);\n // Continue to next dependency\n }\n }\n logger.info('[StaticDataLayerProvider] Course dependency resolution complete.');\n }\n\n async initialize(): Promise<void> {\n if (this.initialized) return;\n\n logger.info('Initializing static data layer provider');\n await this.resolveCourseDependencies();\n this.initialized = true;\n }\n\n async teardown(): Promise<void> {\n this.courseUnpackers.clear();\n this.initialized = false;\n }\n\n getUserDB(): UserDBInterface {\n const syncStrategy = new NoOpSyncStrategy();\n // For now, use guest user - local account switching will be added later\n return BaseUser.Dummy(syncStrategy);\n }\n\n getCourseDB(courseId: string): CourseDBInterface {\n // Try direct lookup by courseId first\n let unpacker = this.courseUnpackers.get(courseId);\n let actualCourseId = courseId;\n\n // If not found, try lookup by dependency name (backwards compatibility)\n if (!unpacker) {\n const mappedCourseId = this.dependencyNameToCourseId.get(courseId);\n if (mappedCourseId) {\n unpacker = this.courseUnpackers.get(mappedCourseId);\n actualCourseId = mappedCourseId;\n }\n }\n\n if (!unpacker) {\n throw new Error(`Course ${courseId} not found or failed to initialize in static data layer.`);\n }\n const manifest = this.manifests[actualCourseId];\n return new StaticCourseDB(actualCourseId, unpacker, this.getUserDB(), manifest);\n }\n\n getCoursesDB(): CoursesDBInterface {\n return new StaticCoursesDB(this.manifests, this.dependencyNameToCourseId);\n }\n\n async getClassroomDB(\n _classId: string,\n _type: 'student' | 'teacher'\n ): Promise<ClassroomDBInterface> {\n throw new Error('Classrooms not supported in static mode');\n }\n\n getAdminDB(): AdminDBInterface {\n throw new Error('Admin functions not supported in static mode');\n }\n\n isReadOnly(): boolean {\n return true;\n }\n}\n"],"mappings":";;;;;;;;AAiCA,IAAa,0BAAb,MAAkE;CAChE;CACA,cAA+B;CAC/B,kCAA2D,IAAI,KAAK;CACpE,YAA0D,EAAE;CAE5D,2CAAwD,IAAI,KAAK;CAEjE,YAAY,QAAwC;AAClD,OAAK,SAAS;GACZ,oBAAoB,OAAO,sBAAsB;GACjD,cAAc,OAAO,gBAAgB,EAAE,cAAc,EAAE,EAAE;GACzD,iBAAiB,OAAO,mBAAmB;GAC5C;;CAGH,MAAc,4BAA2C;AACvD,SAAO,KAAK,qEAAqE;EACjF,MAAM,eAAe,KAAK,OAAO;AAEjC,OAAK,MAAM,CAAC,YAAY,cAAc,OAAO,QAAQ,aAAa,gBAAgB,EAAE,CAAC,CACnF,KAAI;AACF,UAAO,MAAM,mDAAmD,WAAW,QAAQ,YAAY;GAE/F,MAAM,oBAAoB,IAAI,IAAI,WAAqB,KAAK,OAAO,gBAAgB,CAAC;GACpF,MAAM,qBAAqB,MAAM,MAAM,kBAAkB;AACzD,OAAI,CAAC,mBAAmB,GACtB,OAAM,IAAI,MAAM,uCAAuC,aAAa;GAEtE,MAAM,aAAa,MAAM,mBAAmB,MAAM;AAElD,OAAI,WAAW,WAAW,WAAW,QAAQ,UAAU;IACrD,MAAM,UAAU,IAAI,IAAI,KAAK,kBAAkB,CAAC;IAChD,MAAM,mBAAmB,IAAI,IAAI,WAAW,QAAQ,UAAU,kBAAkB,CAAC;IAEjF,MAAM,wBAAwB,MAAM,MAAM,iBAAiB;AAC3D,QAAI,CAAC,sBAAsB,GACzB,OAAM,IAAI,MAAM,8CAA8C,WAAW,MAAM,mBAAmB;IAEpG,MAAM,gBAAgB,MAAM,sBAAsB,MAAM;IAGxD,MAAM,WAAW,cAAc,YAAY,cAAc,cAAc;AACvE,QAAI,CAAC,SACH,OAAM,IAAI,MAAM,uBAAuB,WAAW,mBAAmB;AAGvE,SAAK,UAAU,YAAY;IAC3B,MAAM,WAAW,IAAI,mBAAmB,eAAe,QAAQ;AAC/D,SAAK,gBAAgB,IAAI,UAAU,SAAS;AAI5C,SAAK,yBAAyB,IAAI,YAAY,SAAS;AAEvD,WAAO,KAAK,wEAAwE,WAAW,cAAc,SAAS,GAAG;;WAEpH,GAAG;AACV,UAAO,MAAM,0DAA0D,WAAW,IAAI,EAAE;;AAI5F,SAAO,KAAK,mEAAmE;;CAGjF,MAAM,aAA4B;AAChC,MAAI,KAAK,YAAa;AAEtB,SAAO,KAAK,0CAA0C;AACtD,QAAM,KAAK,2BAA2B;AACtC,OAAK,cAAc;;CAGrB,MAAM,WAA0B;AAC9B,OAAK,gBAAgB,OAAO;AAC5B,OAAK,cAAc;;CAGrB,YAA6B;EAC3B,MAAM,eAAe,IAAI,kBAAkB;AAE3C,SAAO,SAAS,MAAM,aAAa;;CAGrC,YAAY,UAAqC;EAE/C,IAAI,WAAW,KAAK,gBAAgB,IAAI,SAAS;EACjD,IAAI,iBAAiB;AAGrB,MAAI,CAAC,UAAU;GACb,MAAM,iBAAiB,KAAK,yBAAyB,IAAI,SAAS;AAClE,OAAI,gBAAgB;AAClB,eAAW,KAAK,gBAAgB,IAAI,eAAe;AACnD,qBAAiB;;;AAIrB,MAAI,CAAC,SACH,OAAM,IAAI,MAAM,UAAU,SAAS,0DAA0D;EAE/F,MAAM,WAAW,KAAK,UAAU;AAChC,SAAO,IAAI,eAAe,gBAAgB,UAAU,KAAK,WAAW,EAAE,SAAS;;CAGjF,eAAmC;AACjC,SAAO,IAAI,gBAAgB,KAAK,WAAW,KAAK,yBAAyB;;CAG3E,MAAM,eACJ,UACA,OAC+B;AAC/B,QAAM,IAAI,MAAM,0CAA0C;;CAG5D,aAA+B;AAC7B,QAAM,IAAI,MAAM,+CAA+C;;CAGjE,aAAsB;AACpB,SAAO"}