coursecode 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (362) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +322 -0
  3. package/THIRD_PARTY_NOTICES.md +22 -0
  4. package/bin/cli.js +331 -0
  5. package/framework/assets/logo-coursecode-black.svg +14 -0
  6. package/framework/assets/logo-coursecode-white.svg +14 -0
  7. package/framework/assets/logo-coursecode.svg +14 -0
  8. package/framework/css/01-base.css +160 -0
  9. package/framework/css/02-layout.css +499 -0
  10. package/framework/css/accessibility.css +834 -0
  11. package/framework/css/components/accordions.css +710 -0
  12. package/framework/css/components/assessments.css +520 -0
  13. package/framework/css/components/audio-player.css +570 -0
  14. package/framework/css/components/badges.css +80 -0
  15. package/framework/css/components/breadcrumbs.css +87 -0
  16. package/framework/css/components/buttons.css +707 -0
  17. package/framework/css/components/callouts.css +1280 -0
  18. package/framework/css/components/cards.css +475 -0
  19. package/framework/css/components/carousel.css +193 -0
  20. package/framework/css/components/checkbox-group.css +123 -0
  21. package/framework/css/components/checklist.css +203 -0
  22. package/framework/css/components/collapse.css +96 -0
  23. package/framework/css/components/comparison.css +33 -0
  24. package/framework/css/components/content-image.css +36 -0
  25. package/framework/css/components/document-gallery.css +425 -0
  26. package/framework/css/components/dropdown.css +115 -0
  27. package/framework/css/components/embed-frame.css +142 -0
  28. package/framework/css/components/engagement.css +412 -0
  29. package/framework/css/components/features.css +35 -0
  30. package/framework/css/components/flip-cards.css +253 -0
  31. package/framework/css/components/footer.css +353 -0
  32. package/framework/css/components/forms.css +294 -0
  33. package/framework/css/components/hero.css +216 -0
  34. package/framework/css/components/images.css +528 -0
  35. package/framework/css/components/interactive-timeline.css +274 -0
  36. package/framework/css/components/intro-cards.css +30 -0
  37. package/framework/css/components/lightbox.css +666 -0
  38. package/framework/css/components/loading.css +65 -0
  39. package/framework/css/components/modals.css +235 -0
  40. package/framework/css/components/notifications.css +107 -0
  41. package/framework/css/components/quote.css +150 -0
  42. package/framework/css/components/sidebar.css +684 -0
  43. package/framework/css/components/slide-header.css +52 -0
  44. package/framework/css/components/spinner.css +62 -0
  45. package/framework/css/components/stats.css +44 -0
  46. package/framework/css/components/steps.css +232 -0
  47. package/framework/css/components/tables.css +90 -0
  48. package/framework/css/components/tabs.css +347 -0
  49. package/framework/css/components/timeline.css +154 -0
  50. package/framework/css/components/toggle.css +95 -0
  51. package/framework/css/components/tooltip.css +226 -0
  52. package/framework/css/components/video-player.css +438 -0
  53. package/framework/css/design-tokens.css +707 -0
  54. package/framework/css/framework.css +86 -0
  55. package/framework/css/interactions/accessibility.css +75 -0
  56. package/framework/css/interactions/base.css +92 -0
  57. package/framework/css/interactions/drag-drop.css +295 -0
  58. package/framework/css/interactions/fill-in-the-blank.css +236 -0
  59. package/framework/css/interactions/hotspots.css +69 -0
  60. package/framework/css/interactions/index.css +45 -0
  61. package/framework/css/interactions/interactive-image.css +359 -0
  62. package/framework/css/interactions/likert.css +126 -0
  63. package/framework/css/interactions/matching.css +354 -0
  64. package/framework/css/interactions/numeric-input.css +78 -0
  65. package/framework/css/interactions/sequencing.css +378 -0
  66. package/framework/css/interactions/true-false.css +177 -0
  67. package/framework/css/layouts/article.css +258 -0
  68. package/framework/css/layouts/base.css +30 -0
  69. package/framework/css/layouts/canvas.css +38 -0
  70. package/framework/css/layouts/focused.css +236 -0
  71. package/framework/css/layouts/index.css +29 -0
  72. package/framework/css/layouts/presentation.css +191 -0
  73. package/framework/css/layouts/traditional.css +52 -0
  74. package/framework/css/responsive.css +439 -0
  75. package/framework/css/utilities/accessibility-utils.css +59 -0
  76. package/framework/css/utilities/animations.css +419 -0
  77. package/framework/css/utilities/borders.css +72 -0
  78. package/framework/css/utilities/colors.css +76 -0
  79. package/framework/css/utilities/container.css +46 -0
  80. package/framework/css/utilities/decorative.css +442 -0
  81. package/framework/css/utilities/display.css +257 -0
  82. package/framework/css/utilities/flexbox.css +80 -0
  83. package/framework/css/utilities/grid.css +69 -0
  84. package/framework/css/utilities/icons.css +534 -0
  85. package/framework/css/utilities/lists.css +190 -0
  86. package/framework/css/utilities/spacing.css +167 -0
  87. package/framework/css/utilities/tables.css +81 -0
  88. package/framework/css/utilities/typography.css +159 -0
  89. package/framework/css/utilities/visibility.css +117 -0
  90. package/framework/docs/COURSE_AUTHORING_GUIDE.md +1773 -0
  91. package/framework/docs/COURSE_OUTLINE_GUIDE.md +725 -0
  92. package/framework/docs/COURSE_OUTLINE_TEMPLATE.md +161 -0
  93. package/framework/docs/DATA_MODEL.md +409 -0
  94. package/framework/docs/FRAMEWORK_GUIDE.md +1088 -0
  95. package/framework/docs/USER_GUIDE.md +583 -0
  96. package/framework/docs/examples/cloudflare-channel-relay.js +169 -0
  97. package/framework/docs/examples/cloudflare-data-worker.js +102 -0
  98. package/framework/docs/examples/cloudflare-error-worker.js +228 -0
  99. package/framework/index.html +175 -0
  100. package/framework/js/app/AppActions.js +410 -0
  101. package/framework/js/app/AppState.js +225 -0
  102. package/framework/js/app/AppUI.js +616 -0
  103. package/framework/js/assessment/AssessmentActions.js +615 -0
  104. package/framework/js/assessment/AssessmentFactory.js +471 -0
  105. package/framework/js/assessment/AssessmentState.js +322 -0
  106. package/framework/js/assessment/AssessmentUI.js +451 -0
  107. package/framework/js/automation/api-engagement.js +196 -0
  108. package/framework/js/automation/api-interactions.js +167 -0
  109. package/framework/js/automation/api.js +242 -0
  110. package/framework/js/automation/index.js +41 -0
  111. package/framework/js/components/interactions/drag-drop.js +884 -0
  112. package/framework/js/components/interactions/fill-in.js +535 -0
  113. package/framework/js/components/interactions/hotspot.js +702 -0
  114. package/framework/js/components/interactions/interaction-base.js +511 -0
  115. package/framework/js/components/interactions/likert.js +301 -0
  116. package/framework/js/components/interactions/matching.js +699 -0
  117. package/framework/js/components/interactions/multiple-choice.js +377 -0
  118. package/framework/js/components/interactions/numeric.js +271 -0
  119. package/framework/js/components/interactions/sequencing.js +423 -0
  120. package/framework/js/components/interactions/true-false.js +241 -0
  121. package/framework/js/components/ui-components/accordion.js +442 -0
  122. package/framework/js/components/ui-components/alert.js +88 -0
  123. package/framework/js/components/ui-components/audio-player.js +1193 -0
  124. package/framework/js/components/ui-components/callout.js +121 -0
  125. package/framework/js/components/ui-components/carousel.js +145 -0
  126. package/framework/js/components/ui-components/checkbox-group.js +87 -0
  127. package/framework/js/components/ui-components/checklist.js +40 -0
  128. package/framework/js/components/ui-components/collapse.js +114 -0
  129. package/framework/js/components/ui-components/comparison.js +30 -0
  130. package/framework/js/components/ui-components/conditional-display.js +150 -0
  131. package/framework/js/components/ui-components/content-image.js +41 -0
  132. package/framework/js/components/ui-components/dropdown.js +262 -0
  133. package/framework/js/components/ui-components/embed-frame.js +274 -0
  134. package/framework/js/components/ui-components/features.js +33 -0
  135. package/framework/js/components/ui-components/flip-card.js +230 -0
  136. package/framework/js/components/ui-components/form-validator.js +76 -0
  137. package/framework/js/components/ui-components/hero.js +49 -0
  138. package/framework/js/components/ui-components/index.js +12 -0
  139. package/framework/js/components/ui-components/interactive-image.js +235 -0
  140. package/framework/js/components/ui-components/interactive-timeline.js +285 -0
  141. package/framework/js/components/ui-components/intro-cards.js +35 -0
  142. package/framework/js/components/ui-components/lightbox.js +652 -0
  143. package/framework/js/components/ui-components/modal.js +386 -0
  144. package/framework/js/components/ui-components/notifications.js +145 -0
  145. package/framework/js/components/ui-components/progress.js +88 -0
  146. package/framework/js/components/ui-components/quote.js +41 -0
  147. package/framework/js/components/ui-components/stats.js +33 -0
  148. package/framework/js/components/ui-components/steps.js +41 -0
  149. package/framework/js/components/ui-components/tabs.js +255 -0
  150. package/framework/js/components/ui-components/timeline.js +42 -0
  151. package/framework/js/components/ui-components/toggle-group.js +73 -0
  152. package/framework/js/components/ui-components/tooltip.js +458 -0
  153. package/framework/js/components/ui-components/value-display.js +133 -0
  154. package/framework/js/components/ui-components/video-player.js +686 -0
  155. package/framework/js/core/component-catalog.js +121 -0
  156. package/framework/js/core/event-bus.js +178 -0
  157. package/framework/js/core/interaction-catalog.js +149 -0
  158. package/framework/js/dev/runtime-linter.js +1725 -0
  159. package/framework/js/drivers/cmi5-driver.js +768 -0
  160. package/framework/js/drivers/driver-factory.js +77 -0
  161. package/framework/js/drivers/driver-interface.js +110 -0
  162. package/framework/js/drivers/http-driver-base.js +241 -0
  163. package/framework/js/drivers/lti-driver.js +508 -0
  164. package/framework/js/drivers/proxy-driver.js +444 -0
  165. package/framework/js/drivers/scorm-12-driver.js +560 -0
  166. package/framework/js/drivers/scorm-2004-driver.js +775 -0
  167. package/framework/js/drivers/scorm-driver-base.js +112 -0
  168. package/framework/js/engagement/engagement-manager.js +404 -0
  169. package/framework/js/engagement/engagement-progress.js +191 -0
  170. package/framework/js/engagement/engagement-trackers.js +215 -0
  171. package/framework/js/engagement/requirement-strategies.js +268 -0
  172. package/framework/js/main.js +727 -0
  173. package/framework/js/managers/accessibility-manager.js +499 -0
  174. package/framework/js/managers/assessment-manager.js +230 -0
  175. package/framework/js/managers/audio-manager.js +944 -0
  176. package/framework/js/managers/comment-manager.js +88 -0
  177. package/framework/js/managers/flag-manager.js +86 -0
  178. package/framework/js/managers/interaction-manager.js +254 -0
  179. package/framework/js/managers/interaction-registry.js +96 -0
  180. package/framework/js/managers/objective-manager.js +423 -0
  181. package/framework/js/managers/score-manager.js +441 -0
  182. package/framework/js/managers/video-manager.js +536 -0
  183. package/framework/js/navigation/Breadcrumbs.js +234 -0
  184. package/framework/js/navigation/NavigationActions.js +1132 -0
  185. package/framework/js/navigation/NavigationState.js +276 -0
  186. package/framework/js/navigation/NavigationUI.js +574 -0
  187. package/framework/js/navigation/document-gallery.js +357 -0
  188. package/framework/js/navigation/navigation-helpers.js +175 -0
  189. package/framework/js/navigation/navigation-validators.js +174 -0
  190. package/framework/js/state/index.js +8 -0
  191. package/framework/js/state/lms-connection.js +482 -0
  192. package/framework/js/state/lms-error-utils.js +58 -0
  193. package/framework/js/state/state-commits.js +200 -0
  194. package/framework/js/state/state-domains.js +86 -0
  195. package/framework/js/state/state-manager.js +502 -0
  196. package/framework/js/state/state-validation.js +311 -0
  197. package/framework/js/state/transaction-log.js +41 -0
  198. package/framework/js/state/xapi-statement-service.js +325 -0
  199. package/framework/js/utilities/access-control.js +99 -0
  200. package/framework/js/utilities/breakpoint-manager.js +315 -0
  201. package/framework/js/utilities/canvas-slide.js +35 -0
  202. package/framework/js/utilities/conditional-display.js +388 -0
  203. package/framework/js/utilities/course-channel.js +214 -0
  204. package/framework/js/utilities/course-helpers.js +420 -0
  205. package/framework/js/utilities/data-reporter.js +273 -0
  206. package/framework/js/utilities/error-reporter.js +313 -0
  207. package/framework/js/utilities/hotspot-helper.js +341 -0
  208. package/framework/js/utilities/icons.js +348 -0
  209. package/framework/js/utilities/logger.js +92 -0
  210. package/framework/js/utilities/markdown-renderer.js +45 -0
  211. package/framework/js/utilities/scroll-tracker.js +68 -0
  212. package/framework/js/utilities/ui-initializer.js +146 -0
  213. package/framework/js/utilities/utilities.js +293 -0
  214. package/framework/js/utilities/view-manager.js +227 -0
  215. package/framework/js/validation/html-validators.js +422 -0
  216. package/framework/js/validation/scorm-validators.js +438 -0
  217. package/framework/js/vendor/pipwerks.js +931 -0
  218. package/framework/scripts/generate-narration.js +629 -0
  219. package/framework/scripts/tts-providers/azure-provider.js +178 -0
  220. package/framework/scripts/tts-providers/base-provider.js +81 -0
  221. package/framework/scripts/tts-providers/deepgram-provider.js +135 -0
  222. package/framework/scripts/tts-providers/elevenlabs-provider.js +148 -0
  223. package/framework/scripts/tts-providers/google-provider.js +272 -0
  224. package/framework/scripts/tts-providers/index.js +158 -0
  225. package/framework/scripts/tts-providers/openai-provider.js +143 -0
  226. package/framework/version.json +63 -0
  227. package/lib/authoring-api.js +919 -0
  228. package/lib/build-linter.js +450 -0
  229. package/lib/build-packaging.js +186 -0
  230. package/lib/build.js +88 -0
  231. package/lib/cloud.js +691 -0
  232. package/lib/convert.js +341 -0
  233. package/lib/course-parser.js +936 -0
  234. package/lib/course-writer.js +258 -0
  235. package/lib/create.js +248 -0
  236. package/lib/css-index.js +237 -0
  237. package/lib/dev.js +51 -0
  238. package/lib/export-content.js +1246 -0
  239. package/lib/headless-browser.js +413 -0
  240. package/lib/import.js +377 -0
  241. package/lib/index.js +80 -0
  242. package/lib/info.js +79 -0
  243. package/lib/interaction-formatters.js +568 -0
  244. package/lib/manifest/cmi5-manifest.js +63 -0
  245. package/lib/manifest/lti-tool-config.js +53 -0
  246. package/lib/manifest/manifest-factory.js +99 -0
  247. package/lib/manifest/scorm-12-manifest.js +61 -0
  248. package/lib/manifest/scorm-2004-manifest.js +94 -0
  249. package/lib/manifest/scorm-proxy-manifest.js +104 -0
  250. package/lib/manifest-parser.js +96 -0
  251. package/lib/mcp-prompts.js +753 -0
  252. package/lib/mcp-server.js +316 -0
  253. package/lib/narration.js +53 -0
  254. package/lib/pdf-structure.js +142 -0
  255. package/lib/preview-export.js +231 -0
  256. package/lib/preview-routes-api.js +662 -0
  257. package/lib/preview-routes-editing.js +159 -0
  258. package/lib/preview-routes-lms.js +230 -0
  259. package/lib/preview-server.js +564 -0
  260. package/lib/project-utils.js +269 -0
  261. package/lib/proxy-templates/proxy.html +68 -0
  262. package/lib/proxy-templates/scorm-bridge.js +112 -0
  263. package/lib/scaffold.js +193 -0
  264. package/lib/schema-extractor.js +361 -0
  265. package/lib/slide-source-editor.js +586 -0
  266. package/lib/stub-player/app-viewer.js +195 -0
  267. package/lib/stub-player/app.js +370 -0
  268. package/lib/stub-player/catalog-panel.js +312 -0
  269. package/lib/stub-player/config-panel.js +1303 -0
  270. package/lib/stub-player/content-generator.js +586 -0
  271. package/lib/stub-player/content-viewer.js +173 -0
  272. package/lib/stub-player/debug-panel.js +420 -0
  273. package/lib/stub-player/edit-mode.js +922 -0
  274. package/lib/stub-player/edit-utils.js +400 -0
  275. package/lib/stub-player/header-bar.js +354 -0
  276. package/lib/stub-player/interaction-editor.js +210 -0
  277. package/lib/stub-player/interactions-panel.js +565 -0
  278. package/lib/stub-player/lms-api.js +1094 -0
  279. package/lib/stub-player/login-screen.js +74 -0
  280. package/lib/stub-player/outline-mode.js +689 -0
  281. package/lib/stub-player/styles/_assessments-panel.css +245 -0
  282. package/lib/stub-player/styles/_base.css +89 -0
  283. package/lib/stub-player/styles/_catalog-icons.css +96 -0
  284. package/lib/stub-player/styles/_catalog-panel.css +291 -0
  285. package/lib/stub-player/styles/_config-panel.css +636 -0
  286. package/lib/stub-player/styles/_content-viewer.css +834 -0
  287. package/lib/stub-player/styles/_debug-panel.css +576 -0
  288. package/lib/stub-player/styles/_edit-mode.css +128 -0
  289. package/lib/stub-player/styles/_header-bar.css +343 -0
  290. package/lib/stub-player/styles/_interaction-editor.css +140 -0
  291. package/lib/stub-player/styles/_interactions-panel.css +1038 -0
  292. package/lib/stub-player/styles/_login-screen.css +102 -0
  293. package/lib/stub-player/styles/_outline-mode.css +752 -0
  294. package/lib/stub-player/styles.css +15 -0
  295. package/lib/stub-player.js +160 -0
  296. package/lib/test-data-reporting.js +176 -0
  297. package/lib/test-error-reporting.js +146 -0
  298. package/lib/token.js +86 -0
  299. package/lib/upgrade.js +257 -0
  300. package/lib/validation-rules.js +517 -0
  301. package/lib/vite-plugin-content-discovery.js +296 -0
  302. package/package.json +108 -0
  303. package/schemas/XMLSchema.dtd +402 -0
  304. package/schemas/adlcp_v1p3.xsd +111 -0
  305. package/schemas/adlnav_v1p3.xsd +61 -0
  306. package/schemas/adlseq_v1p3.xsd +93 -0
  307. package/schemas/common/anyElement.xsd +27 -0
  308. package/schemas/common/dataTypes.xsd +138 -0
  309. package/schemas/common/elementNames.xsd +767 -0
  310. package/schemas/common/elementTypes.xsd +786 -0
  311. package/schemas/common/rootElement.xsd +31 -0
  312. package/schemas/common/vocabTypes.xsd +345 -0
  313. package/schemas/common/vocabValues.xsd +257 -0
  314. package/schemas/datatypes.dtd +203 -0
  315. package/schemas/ims_xml.xsd +35 -0
  316. package/schemas/imscp_v1p1.xsd +368 -0
  317. package/schemas/imsss_v1p0.xsd +67 -0
  318. package/schemas/imsss_v1p0auxresource.xsd +19 -0
  319. package/schemas/imsss_v1p0control.xsd +20 -0
  320. package/schemas/imsss_v1p0delivery.xsd +17 -0
  321. package/schemas/imsss_v1p0limit.xsd +47 -0
  322. package/schemas/imsss_v1p0objective.xsd +67 -0
  323. package/schemas/imsss_v1p0random.xsd +16 -0
  324. package/schemas/imsss_v1p0rollup.xsd +46 -0
  325. package/schemas/imsss_v1p0seqrule.xsd +108 -0
  326. package/schemas/imsss_v1p0util.xsd +94 -0
  327. package/schemas/license.txt +17 -0
  328. package/schemas/lom.xsd +102 -0
  329. package/schemas/lomCustom.xsd +62 -0
  330. package/schemas/lomLoose.xsd +62 -0
  331. package/schemas/lomStrict.xsd +62 -0
  332. package/schemas/xml.xsd +81 -0
  333. package/template/.env.example +92 -0
  334. package/template/course/assets/audio/example-intro.mp3 +0 -0
  335. package/template/course/assets/audio/example-ui-demo--compact-player.mp3 +0 -0
  336. package/template/course/assets/audio/example-ui-demo--demo-modal.mp3 +0 -0
  337. package/template/course/assets/audio/example-ui-demo--full-player.mp3 +0 -0
  338. package/template/course/assets/docs/example_md_1.md +39 -0
  339. package/template/course/assets/docs/example_md_2.md +41 -0
  340. package/template/course/assets/docs/example_pdf_1_thumbnail.png +0 -0
  341. package/template/course/assets/docs/example_pdf_2.pdf +0 -0
  342. package/template/course/assets/images/course-architecture.svg +36 -0
  343. package/template/course/assets/images/logo.svg +14 -0
  344. package/template/course/assets/widgets/counter-demo.html +190 -0
  345. package/template/course/assets/widgets/gravity-painter.html +384 -0
  346. package/template/course/course-config.js +539 -0
  347. package/template/course/icons.js +19 -0
  348. package/template/course/interactions/PLUGIN_GUIDE.md +97 -0
  349. package/template/course/slides/example-course-structure.js +138 -0
  350. package/template/course/slides/example-final-exam.js +144 -0
  351. package/template/course/slides/example-finishing.js +127 -0
  352. package/template/course/slides/example-interactions-showcase.js +615 -0
  353. package/template/course/slides/example-preview-tour.js +129 -0
  354. package/template/course/slides/example-remedial.js +143 -0
  355. package/template/course/slides/example-summary.js +103 -0
  356. package/template/course/slides/example-ui-showcase.js +1805 -0
  357. package/template/course/slides/example-welcome.js +123 -0
  358. package/template/course/slides/example-workflow.js +140 -0
  359. package/template/course/theme.css +165 -0
  360. package/template/eslint.config.js +47 -0
  361. package/template/package.json +28 -0
  362. package/template/vite.config.js +339 -0
package/lib/preview-routes-api.js ADDED
@@ -0,0 +1,662 @@
1
+ /**
2
+ * @file preview-routes-api.js
3
+ * Read-only API routes for the preview server.
4
+ * Handles config, theme, stage, outline, refs, catalog, assessments,
5
+ * content, component preview, stub-player assets, SSE, and MCP endpoints.
6
+ */
7
+
8
+ import fs from 'fs';
9
+ import path from 'path';
10
+ import os from 'os';
11
+ import { fileURLToPath, pathToFileURL } from 'url';
12
+ import { generateContentHtml } from './stub-player/content-generator.js';
13
+ import { parseCourse } from './course-parser.js';
14
+ import { getComponentCatalog, getInteractionCatalog, getIconCatalog, getWorkflowStatus, getRefsStatus } from './authoring-api.js';
15
+ import { getAllIcons, getAllSchemas } from './schema-extractor.js';
16
+
17
+ const __dirname = path.dirname(fileURLToPath(import.meta.url));
18
+
19
+ /**
20
+ * @param {Object} ctx - Shared server context
21
+ * @param {Object} ctx.paths - { coursePath, viteConfig }
22
+ * @param {string} ctx.distDir - Path to dist/
23
+ * @param {Object} ctx.buildState - { errors, warnings, lastBuildTime, lastBuildSuccess }
24
+ * @param {Set} ctx.sseClients - SSE client connections
25
+ * @param {Function} ctx.getMimeType - MIME type resolver
26
+ * @param {Function} ctx.findSlideById - Locate slide in structure
27
+ * @param {Function} ctx.countSlides - Count total slides
28
+ * @param {Function} ctx.collectSlideIds - Get all slide IDs
29
+ * @param {Function} ctx.simpleMarkdownToHtml - Markdown converter
30
+ * @param {Function} ctx.getExampleHtml - Component example HTML
31
+ * @param {Function} ctx.parseAndSaveFiles - Multipart file parser
32
+ * @param {Function} ctx.serveFile - Static file serving
33
+ */
34
+ export async function handleApiRoutes(ctx, req, res, url) {
35
+ const { paths, distDir, buildState, sseClients } = ctx;
36
+
37
+ const hasRichAssessmentQuestions = (assessments = []) => {
38
+ for (const assessment of assessments) {
39
+ const firstQuestion = assessment?.questions?.[0];
40
+ if (!firstQuestion) continue;
41
+ const keys = Object.keys(firstQuestion);
42
+ if (keys.some(k => !['id', 'type', 'slideId'].includes(k))) {
43
+ return true;
44
+ }
45
+ }
46
+ return false;
47
+ };
48
+
49
+ // SSE endpoint for live reload
50
+ if (url === '/__reload') {
51
+ res.writeHead(200, {
52
+ 'Content-Type': 'text/event-stream',
53
+ 'Cache-Control': 'no-cache',
54
+ 'Connection': 'keep-alive',
55
+ 'Access-Control-Allow-Origin': '*'
56
+ });
57
+ res.write('data: connected\n\n');
58
+ sseClients.add(res);
59
+ req.on('close', () => sseClients.delete(res));
60
+ return true;
61
+ }
62
+
63
+ // MCP endpoint for build errors and warnings
64
+ if (url === '/__mcp/errors') {
65
+ res.writeHead(200, { 'Content-Type': 'application/json', 'Cache-Control': 'no-cache' });
66
+ res.end(JSON.stringify(buildState, null, 2));
67
+ return true;
68
+ }
69
+
70
+ // Refresh course content HTML
71
+ if (url === '/__content') {
72
+ generateContentHtml({ coursePath: paths.coursePath, includeNarration: true })
73
+ .then(freshContent => {
74
+ res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8', 'Cache-Control': 'no-cache' });
75
+ res.end(freshContent || '');
76
+ })
77
+ .catch(err => {
78
+ res.writeHead(500, { 'Content-Type': 'text/plain' });
79
+ res.end('Error generating content: ' + err.message);
80
+ });
81
+ return true;
82
+ }
83
+
84
+ // Full page content view
85
+ if (url === '/__content-view') {
86
+ generateContentHtml({ coursePath: paths.coursePath, includeNarration: true })
87
+ .then(freshContent => {
88
+ res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8', 'Cache-Control': 'no-cache' });
89
+ res.end(`<!DOCTYPE html>
90
+ <html lang="en">
91
+ <head>
92
+ <meta charset="UTF-8">
93
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
94
+ <title>Course Content Review</title>
95
+ <link rel="stylesheet" href="/__stub-player/styles.css">
96
+ <style>
97
+ body {
98
+ padding: 40px;
99
+ max-width: 900px;
100
+ margin: 0 auto;
101
+ font-family: system-ui, -apple-system, sans-serif;
102
+ line-height: 1.6;
103
+ }
104
+ @media print {
105
+ body { padding: 20px; }
106
+ }
107
+ </style>
108
+ </head>
109
+ <body>
110
+ ${freshContent || '<p>No content available</p>'}
111
+ </body>
112
+ </html>`);
113
+ })
114
+ .catch(err => {
115
+ res.writeHead(500, { 'Content-Type': 'text/plain' });
116
+ res.end('Error generating content view: ' + err.message);
117
+ });
118
+ return true;
119
+ }
120
+
121
+ // Course config as JSON
122
+ if (url === '/__config') {
123
+ (async () => {
124
+ try {
125
+ const configPath = path.join(paths.coursePath, 'course-config.js');
126
+ const configUrl = `${pathToFileURL(configPath).href}?t=${Date.now()}`;
127
+ const configModule = await import(configUrl);
128
+ const config = configModule.courseConfig || configModule.default;
129
+
130
+ const editableConfig = {
131
+ metadata: config.metadata || {},
132
+ format: config.format || 'cmi5',
133
+ layout: config.layout,
134
+ slideDefaults: config.slideDefaults || {},
135
+ navigation: {
136
+ sidebar: config.navigation?.sidebar || {},
137
+ breadcrumbs: config.navigation?.breadcrumbs || {}
138
+ },
139
+ features: config.features || {},
140
+ scoring: config.scoring || null,
141
+ support: config.support || {},
142
+ completion: config.completion || {},
143
+ environment: config.environment || {},
144
+ objectives: config.objectives || [],
145
+ objectiveIds: (config.objectives || []).map(o => ({ id: o.id, description: o.description })),
146
+ slideIds: ctx.collectSlideIds(config.structure || []),
147
+ slideCount: ctx.countSlides(config.structure || [])
148
+ };
149
+
150
+ res.writeHead(200, { 'Content-Type': 'application/json', 'Cache-Control': 'no-cache' });
151
+ res.end(JSON.stringify(editableConfig, null, 2));
152
+ } catch (err) {
153
+ res.writeHead(500, { 'Content-Type': 'application/json' });
154
+ res.end(JSON.stringify({ error: err.message }));
155
+ }
156
+ })();
157
+ return true;
158
+ }
159
+
160
+ // Theme palette colors
161
+ if (url === '/__theme') {
162
+ try {
163
+ const paletteTokens = [
164
+ { name: '--palette-gray', label: 'Gray', hint: 'Neutral scale' },
165
+ { name: '--palette-blue', label: 'Blue', hint: 'Primary color' },
166
+ { name: '--palette-blue-light', label: 'Blue Light', hint: 'Info states' },
167
+ { name: '--palette-green', label: 'Green', hint: 'Success states' },
168
+ { name: '--palette-yellow', label: 'Yellow', hint: 'Accent/warnings' },
169
+ { name: '--palette-orange', label: 'Orange', hint: 'Secondary color' },
170
+ { name: '--palette-red', label: 'Red', hint: 'Error/vibrant' }
171
+ ];
172
+
173
+ const tokensPath = path.join(process.cwd(), 'framework', 'css', 'design-tokens.css');
174
+ const tokensContent = fs.readFileSync(tokensPath, 'utf-8');
175
+ const themePath = path.join(paths.coursePath, 'theme.css');
176
+ const themeContent = fs.existsSync(themePath) ? fs.readFileSync(themePath, 'utf-8') : '';
177
+
178
+ const extractValue = (content, varName) => {
179
+ // Strip CSS block comments so we don't match commented-out values
180
+ const uncommented = content.replace(/\/\*[\s\S]*?\*\//g, '');
181
+ const regex = new RegExp(`${varName.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}:\\s*([^;]+);`);
182
+ const match = uncommented.match(regex);
183
+ return match ? match[1].trim().split(/\s+/)[0] : null;
184
+ };
185
+
186
+ const tokens = paletteTokens.map(token => ({
187
+ name: token.name,
188
+ label: token.label,
189
+ hint: token.hint,
190
+ default: extractValue(tokensContent, token.name),
191
+ override: extractValue(themeContent, token.name),
192
+ get current() { return this.override || this.default; }
193
+ }));
194
+
195
+ res.writeHead(200, { 'Content-Type': 'application/json', 'Cache-Control': 'no-cache' });
196
+ res.end(JSON.stringify({ tokens }, null, 2));
197
+ } catch (err) {
198
+ res.writeHead(500, { 'Content-Type': 'application/json' });
199
+ res.end(JSON.stringify({ error: err.message }));
200
+ }
201
+ return true;
202
+ }
203
+
204
+ // Slide config by ID
205
+ if (url.startsWith('/__slide-config/')) {
206
+ const slideId = url.slice('/__slide-config/'.length);
207
+ (async () => {
208
+ try {
209
+ const configPath = path.join(paths.coursePath, 'course-config.js');
210
+ const configUrl = `${pathToFileURL(configPath).href}?t=${Date.now()}`;
211
+ const configModule = await import(configUrl);
212
+ const config = configModule.courseConfig || configModule.default;
213
+
214
+ const slide = ctx.findSlideById(config.structure || [], slideId);
215
+ if (!slide) {
216
+ res.writeHead(404, { 'Content-Type': 'application/json' });
217
+ res.end(JSON.stringify({ error: `Slide not found: ${slideId}` }));
218
+ return;
219
+ }
220
+
221
+ res.writeHead(200, { 'Content-Type': 'application/json', 'Cache-Control': 'no-cache' });
222
+ res.end(JSON.stringify(slide, null, 2));
223
+ } catch (err) {
224
+ res.writeHead(500, { 'Content-Type': 'application/json' });
225
+ res.end(JSON.stringify({ error: err.message }));
226
+ }
227
+ })();
228
+ return true;
229
+ }
230
+
231
+ // Assessments from build manifest
232
+ if (url === '/__assessments') {
233
+ try {
234
+ const manifestPath = path.join(distDir, '_content-manifest.json');
235
+ if (!fs.existsSync(manifestPath)) {
236
+ const parsedCourse = await parseCourse(paths.coursePath);
237
+ res.writeHead(200, { 'Content-Type': 'application/json', 'Cache-Control': 'no-cache' });
238
+ res.end(JSON.stringify({ assessments: parsedCourse.assessments || [] }));
239
+ return true;
240
+ }
241
+ const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf-8'));
242
+ let assessments = manifest.assessments || [];
243
+
244
+ // Backward compatibility: older manifests only stored {id,type,slideId} for questions.
245
+ if (!hasRichAssessmentQuestions(assessments)) {
246
+ const parsedCourse = await parseCourse(paths.coursePath);
247
+ assessments = parsedCourse.assessments || [];
248
+ }
249
+
250
+ res.writeHead(200, { 'Content-Type': 'application/json', 'Cache-Control': 'no-cache' });
251
+ res.end(JSON.stringify({ assessments }));
252
+ } catch (err) {
253
+ res.writeHead(500, { 'Content-Type': 'application/json' });
254
+ res.end(JSON.stringify({ error: err.message }));
255
+ }
256
+ return true;
257
+ }
258
+
259
+ // Interaction schemas for editor rendering
260
+ if (url === '/__interaction-schemas') {
261
+ try {
262
+ const schemas = getAllSchemas();
263
+ res.writeHead(200, { 'Content-Type': 'application/json', 'Cache-Control': 'no-cache' });
264
+ res.end(JSON.stringify({ schemas }));
265
+ } catch (err) {
266
+ res.writeHead(500, { 'Content-Type': 'application/json' });
267
+ res.end(JSON.stringify({ error: err.message }));
268
+ }
269
+ return true;
270
+ }
271
+
272
+ // Component/Interaction preview
273
+ if (url.startsWith('/__component-preview')) {
274
+ const params = new URL(req.url, 'http://localhost').searchParams;
275
+ const type = params.get('type');
276
+ const category = params.get('category') || 'component';
277
+
278
+ if (!type) {
279
+ res.writeHead(400, { 'Content-Type': 'text/plain' });
280
+ res.end('Missing ?type= parameter');
281
+ return true;
282
+ }
283
+
284
+ const exampleHtml = ctx.getExampleHtml(type, category);
285
+ const html = `<!DOCTYPE html>
286
+ <html>
287
+ <head>
288
+ <meta charset="utf-8">
289
+ <meta name="viewport" content="width=device-width, initial-scale=1">
290
+ <link rel="stylesheet" href="/course/assets/main.css">
291
+ <style>
292
+ html, body { margin: 0; padding: 0; background: #fff; font-family: system-ui, sans-serif; }
293
+ .preview-wrap { padding: 24px; max-width: 100%; overflow: hidden; }
294
+ .preview-wrap > *:first-child { margin-top: 0; }
295
+ </style>
296
+ </head>
297
+ <body>
298
+ <div class="preview-wrap">
299
+ ${exampleHtml}
300
+ </div>
301
+ </body>
302
+ </html>`;
303
+ res.writeHead(200, { 'Content-Type': 'text/html', 'Cache-Control': 'no-cache' });
304
+ res.end(html);
305
+ return true;
306
+ }
307
+
308
+ // Stage detection
309
+ if (url === '/__stage') {
310
+ getWorkflowStatus()
311
+ .then(status => {
312
+ res.writeHead(200, { 'Content-Type': 'application/json', 'Cache-Control': 'no-cache' });
313
+ res.end(JSON.stringify({
314
+ stage: status.stage,
315
+ stageNumber: status.stageNumber,
316
+ checklist: status.checklist,
317
+ nextAction: status.nextAction,
318
+ message: status.message
319
+ }));
320
+ })
321
+ .catch(err => {
322
+ res.writeHead(500, { 'Content-Type': 'application/json' });
323
+ res.end(JSON.stringify({ error: err.message }));
324
+ });
325
+ return true;
326
+ }
327
+
328
+ // Outline (COURSE_OUTLINE.md)
329
+ if (url === '/__outline') {
330
+ try {
331
+ const outlinePath = path.join(paths.coursePath, 'COURSE_OUTLINE.md');
332
+ if (!fs.existsSync(outlinePath)) {
333
+ res.writeHead(404, { 'Content-Type': 'application/json' });
334
+ res.end(JSON.stringify({ error: 'No COURSE_OUTLINE.md found' }));
335
+ return true;
336
+ }
337
+ const raw = fs.readFileSync(outlinePath, 'utf-8');
338
+ const html = ctx.simpleMarkdownToHtml(raw);
339
+ res.writeHead(200, { 'Content-Type': 'application/json', 'Cache-Control': 'no-cache' });
340
+ res.end(JSON.stringify({ raw, html, path: outlinePath }));
341
+ } catch (err) {
342
+ res.writeHead(500, { 'Content-Type': 'application/json' });
343
+ res.end(JSON.stringify({ error: err.message }));
344
+ }
345
+ return true;
346
+ }
347
+
348
+ // Reference document status
349
+ if (url === '/__refs') {
350
+ try {
351
+ const refs = getRefsStatus();
352
+ res.writeHead(200, { 'Content-Type': 'application/json', 'Cache-Control': 'no-cache' });
353
+ res.end(JSON.stringify(refs));
354
+ } catch (err) {
355
+ res.writeHead(500, { 'Content-Type': 'application/json' });
356
+ res.end(JSON.stringify({ error: err.message }));
357
+ }
358
+ return true;
359
+ }
360
+
361
+ // Component/Interaction/Assets catalog
362
+ if (url === '/__catalog') {
363
+ try {
364
+ const componentData = getComponentCatalog();
365
+ const interactionData = getInteractionCatalog();
366
+ const iconData = getIconCatalog();
367
+
368
+ // Build icon map for the gallery (category -> names + SVG content)
369
+ const iconsByCategory = iconData.icons || {};
370
+ // Attach SVG content as a separate _svgs map for rendering
371
+ const allIcons = getAllIcons();
372
+ const svgs = {};
373
+ for (const names of Object.values(iconsByCategory)) {
374
+ for (const name of names) {
375
+ if (allIcons[name]) svgs[name] = allIcons[name].svg;
376
+ }
377
+ }
378
+ iconsByCategory._svgs = svgs;
379
+
380
+ const assetsDir = path.join(paths.coursePath, 'assets');
381
+ const groups = {};
382
+ let totalFiles = 0;
383
+
384
+ if (fs.existsSync(assetsDir)) {
385
+ const subdirs = fs.readdirSync(assetsDir, { withFileTypes: true });
386
+ for (const entry of subdirs) {
387
+ if (entry.isDirectory()) {
388
+ const subFiles = fs.readdirSync(path.join(assetsDir, entry.name))
389
+ .filter(f => !f.startsWith('.'));
390
+ groups[entry.name] = subFiles;
391
+ totalFiles += subFiles.length;
392
+ } else if (!entry.name.startsWith('.')) {
393
+ if (!groups['other']) groups['other'] = [];
394
+ groups['other'].push(entry.name);
395
+ totalFiles++;
396
+ }
397
+ }
398
+ }
399
+
400
+ res.writeHead(200, { 'Content-Type': 'application/json', 'Cache-Control': 'no-cache' });
401
+ res.end(JSON.stringify({
402
+ components: componentData.components || {},
403
+ interactions: interactionData.interactions || {},
404
+ icons: iconsByCategory,
405
+ assets: { groups, totalFiles }
406
+ }));
407
+ } catch (err) {
408
+ res.writeHead(500, { 'Content-Type': 'application/json' });
409
+ res.end(JSON.stringify({ error: err.message }));
410
+ }
411
+ return true;
412
+ }
413
+
414
+ // Asset upload
415
+ if (url === '/__assets-upload' && req.method === 'POST') {
416
+ const assetsDir = path.join(paths.coursePath, 'assets');
417
+ const contentType = req.headers['content-type'] || '';
418
+ const boundaryMatch = contentType.match(/boundary=(.+)/);
419
+
420
+ if (!boundaryMatch) {
421
+ res.writeHead(400, { 'Content-Type': 'application/json' });
422
+ res.end(JSON.stringify({ error: 'Missing multipart boundary' }));
423
+ return true;
424
+ }
425
+
426
+ const boundary = boundaryMatch[1];
427
+ const chunks = [];
428
+ req.on('data', chunk => chunks.push(chunk));
429
+ req.on('end', () => {
430
+ try {
431
+ const buffer = Buffer.concat(chunks);
432
+ const uploaded = ctx.parseAndSaveFiles(buffer, boundary, assetsDir);
433
+ res.writeHead(200, { 'Content-Type': 'application/json' });
434
+ res.end(JSON.stringify({ success: true, uploaded }));
435
+ } catch (err) {
436
+ res.writeHead(500, { 'Content-Type': 'application/json' });
437
+ res.end(JSON.stringify({ error: err.message }));
438
+ }
439
+ });
440
+ return true;
441
+ }
442
+
443
+ // Convert reference files to markdown
444
+ if (url.startsWith('/__refs-convert') && req.method === 'POST') {
445
+ (async () => {
446
+ try {
447
+ const params = new URL(req.url, 'http://localhost').searchParams;
448
+ const overwrite = params.get('overwrite') !== 'false';
449
+ const source = path.join(paths.coursePath, 'references');
450
+ const output = path.join(paths.coursePath, 'references', 'converted');
451
+
452
+ const { convert } = await import('./convert.js');
453
+
454
+ // Capture console output
455
+ const logs = [];
456
+ const origLog = console.log;
457
+ const origErr = console.error;
458
+ console.log = (...args) => logs.push(args.join(' '));
459
+ console.error = (...args) => logs.push(args.join(' '));
460
+
461
+ try {
462
+ await convert(source, { output, overwrite });
463
+ } finally {
464
+ console.log = origLog;
465
+ console.error = origErr;
466
+ }
467
+
468
+ res.writeHead(200, { 'Content-Type': 'application/json' });
469
+ res.end(JSON.stringify({ success: true, logs }));
470
+ } catch (err) {
471
+ res.writeHead(500, { 'Content-Type': 'application/json' });
472
+ res.end(JSON.stringify({ success: false, error: err.message }));
473
+ }
474
+ })();
475
+ return true;
476
+ }
477
+
478
+ // Upload reference files (save directly to course/references/, no subdirs)
479
+ if (url === '/__refs-upload' && req.method === 'POST') {
480
+ const refsDir = path.join(paths.coursePath, 'references');
481
+ const contentType = req.headers['content-type'] || '';
482
+ const boundaryMatch = contentType.match(/boundary=(.+)/);
483
+
484
+ if (!boundaryMatch) {
485
+ res.writeHead(400, { 'Content-Type': 'application/json' });
486
+ res.end(JSON.stringify({ error: 'Missing multipart boundary' }));
487
+ return true;
488
+ }
489
+
490
+ const boundary = boundaryMatch[1];
491
+ const chunks = [];
492
+ req.on('data', chunk => chunks.push(chunk));
493
+ req.on('end', () => {
494
+ try {
495
+ if (!fs.existsSync(refsDir)) fs.mkdirSync(refsDir, { recursive: true });
496
+
497
+ const buffer = Buffer.concat(chunks);
498
+ const boundaryBuf = Buffer.from('--' + boundary);
499
+ const uploaded = [];
500
+ let pos = 0;
501
+
502
+ while (pos < buffer.length) {
503
+ const start = buffer.indexOf(boundaryBuf, pos);
504
+ if (start === -1) break;
505
+ const end = buffer.indexOf(boundaryBuf, start + boundaryBuf.length);
506
+ if (end === -1) break;
507
+
508
+ const part = buffer.slice(start + boundaryBuf.length, end);
509
+ const headerEnd = part.indexOf('\r\n\r\n');
510
+ if (headerEnd === -1) { pos = end; continue; }
511
+
512
+ const headers = part.slice(0, headerEnd).toString('utf-8');
513
+ const filenameMatch = headers.match(/filename="([^"]+)"/);
514
+ if (!filenameMatch) { pos = end; continue; }
515
+
516
+ const filename = path.basename(filenameMatch[1]);
517
+ const fileData = part.slice(headerEnd + 4, part.length - 2);
518
+
519
+ fs.writeFileSync(path.join(refsDir, filename), fileData);
520
+ uploaded.push(filename);
521
+ console.log(` 📄 Reference uploaded: ${filename}`);
522
+ pos = end;
523
+ }
524
+
525
+ res.writeHead(200, { 'Content-Type': 'application/json' });
526
+ res.end(JSON.stringify({ success: true, uploaded }));
527
+ } catch (err) {
528
+ res.writeHead(500, { 'Content-Type': 'application/json' });
529
+ res.end(JSON.stringify({ error: err.message }));
530
+ }
531
+ });
532
+ return true;
533
+ }
534
+
535
+ // PowerPoint import (in-place into current project)
536
+ if (url === '/__import' && req.method === 'POST') {
537
+ const contentType = req.headers['content-type'] || '';
538
+ const boundaryMatch = contentType.match(/boundary=(.+)/);
539
+
540
+ if (!boundaryMatch) {
541
+ res.writeHead(400, { 'Content-Type': 'application/json' });
542
+ res.end(JSON.stringify({ error: 'Missing multipart boundary' }));
543
+ return true;
544
+ }
545
+
546
+ const boundary = boundaryMatch[1];
547
+ const chunks = [];
548
+ req.on('data', chunk => chunks.push(chunk));
549
+ req.on('end', async () => {
550
+ try {
551
+ const buffer = Buffer.concat(chunks);
552
+ const boundaryBuf = Buffer.from('--' + boundary);
553
+
554
+ // Extract the .pptx file from multipart body
555
+ let pptxData = null;
556
+ let pptxName = 'import.pptx';
557
+ let pos = 0;
558
+
559
+ while (pos < buffer.length) {
560
+ const start = buffer.indexOf(boundaryBuf, pos);
561
+ if (start === -1) break;
562
+ const end = buffer.indexOf(boundaryBuf, start + boundaryBuf.length);
563
+ if (end === -1) break;
564
+
565
+ const part = buffer.slice(start + boundaryBuf.length, end);
566
+ const headerEnd = part.indexOf('\r\n\r\n');
567
+ if (headerEnd === -1) { pos = end; continue; }
568
+
569
+ const headers = part.slice(0, headerEnd).toString('utf-8');
570
+ const filenameMatch = headers.match(/filename="([^"]+)"/);
571
+ if (filenameMatch && filenameMatch[1].toLowerCase().endsWith('.pptx')) {
572
+ pptxName = path.basename(filenameMatch[1]);
573
+ pptxData = part.slice(headerEnd + 4, part.length - 2);
574
+ }
575
+ pos = end;
576
+ }
577
+
578
+ if (!pptxData) {
579
+ res.writeHead(400, { 'Content-Type': 'application/json' });
580
+ res.end(JSON.stringify({ error: 'No .pptx file found in upload' }));
581
+ return;
582
+ }
583
+
584
+ // Save to temp file
585
+ const tempPath = path.join(os.tmpdir(), `coursecode-import-${Date.now()}-${pptxName}`);
586
+ fs.writeFileSync(tempPath, pptxData);
587
+
588
+ console.log(` 📊 Importing PowerPoint: ${pptxName}`);
589
+
590
+ // Import in-place
591
+ const { importInPlace } = await import('./import.js');
592
+ const result = await importInPlace(tempPath, paths.coursePath);
593
+
594
+ // Cleanup temp file
595
+ try { fs.unlinkSync(tempPath); } catch {}
596
+
597
+ console.log(` ✅ ${result.slideCount} slides imported from ${pptxName}`);
598
+
599
+ res.writeHead(200, { 'Content-Type': 'application/json' });
600
+ res.end(JSON.stringify({
601
+ success: true,
602
+ slideCount: result.slideCount,
603
+ sourceFile: result.sourceFile,
604
+ textExtracted: result.textExtracted
605
+ }));
606
+ } catch (err) {
607
+ console.error(' ❌ Import failed:', err.message);
608
+ res.writeHead(500, { 'Content-Type': 'application/json' });
609
+ res.end(JSON.stringify({ error: err.message }));
610
+ }
611
+ });
612
+ return true;
613
+ }
614
+
615
+ // Stub player static files
616
+ if (url.startsWith('/__stub-player/')) {
617
+ const relativePath = url.slice('/__stub-player/'.length);
618
+ if (relativePath.includes('..')) {
619
+ res.writeHead(403);
620
+ res.end('Forbidden');
621
+ return true;
622
+ }
623
+
624
+ const filePath = path.join(__dirname, 'stub-player', relativePath);
625
+ fs.stat(filePath, (err, stats) => {
626
+ if (err || !stats.isFile()) {
627
+ res.writeHead(404);
628
+ res.end('Not found');
629
+ return;
630
+ }
631
+ const mimeType = relativePath.endsWith('.js') ? 'application/javascript' : ctx.getMimeType(filePath);
632
+ res.writeHead(200, {
633
+ 'Content-Type': mimeType,
634
+ 'Content-Length': stats.size,
635
+ 'Cache-Control': 'no-cache'
636
+ });
637
+ fs.createReadStream(filePath).pipe(res);
638
+ });
639
+ return true;
640
+ }
641
+
642
+ // Reset (clear storage + redirect)
643
+ if (url === '/__reset') {
644
+ const resetHtml = `<!DOCTYPE html>
645
+ <html>
646
+ <head><title>Resetting...</title></head>
647
+ <body>
648
+ <script>
649
+ const skipGating = localStorage.getItem('coursecode-skipGating');
650
+ localStorage.clear();
651
+ if (skipGating) localStorage.setItem('coursecode-skipGating', skipGating);
652
+ window.location.href = '/';
653
+ </script>
654
+ </body>
655
+ </html>`;
656
+ res.writeHead(200, { 'Content-Type': 'text/html' });
657
+ res.end(resetHtml);
658
+ return true;
659
+ }
660
+
661
+ return false;
662
+ }