@lxpack/cli 0.2.0 → 0.2.1

package/README.md

@@ -7,7 +7,7 @@
 
 Command-line tool for scaffolding, previewing, validating, and packaging LXPack courses.
 
-Part of [LXPack](https://github.com/eddiethedean/lxpack) — an AI-native learning experience compiler and runtime (**v0.2.0**).
+Part of [LXPack](https://github.com/eddiethedean/lxpack) — an AI-native learning experience compiler and runtime (**v0.2.1**).
 
 | Related | Package |
 |---------|---------|
@@ -59,7 +59,7 @@ Output lands in `.lxpack/` unless overridden by `-o` or `lxpack.config.json`.
 
 **SCORM 2004** builds produce a multi-SCO ZIP: one launch page per activity under `sco/<activityId>/index.html`, plus shared `lxpack-runtime.js` and `lxpack-components.js`.
 
-**Preview** serves the runtime client, optional components bundle at `/runtime/components.js`, and installs SCORM API simulators (1.2 and 2004) for local testing.
+**Preview** serves the runtime client, optional components bundle at `/runtime/components.js`, and installs SCORM API simulators (1.2 and 2004) for local testing. Direct HTTP access to `assessments/*.yaml` under `/course/` returns 404; quiz content is embedded in the preview page config only.
 
 ### Course discovery
 

package/dist/cli.js

@@ -5,24 +5,19 @@ import { Command } from "commander";
 import pc5 from "picocolors";
 
 // src/commands/init.ts
-import { existsSync as existsSync2 } from "fs";
+import { existsSync as existsSync4 } from "fs";
 import { mkdir, writeFile } from "fs/promises";
-import { join as join2 } from "path";
+import { join as join4 } from "path";
 import pc from "picocolors";
 
 // src/utils.ts
+import { stringify as stringifyYaml } from "yaml";
+import { createRequire as createRequire2 } from "module";
+
+// src/lib/course-discovery.ts
 import { existsSync } from "fs";
-import { readFile } from "fs/promises";
-import { createRequire } from "module";
 import { dirname, join, resolve } from "path";
-import { stringify as stringifyYaml } from "yaml";
-import { z } from "zod";
-import {
-  loadManifest,
-  formatErrorMessage,
-  isPathContained
-} from "@lxpack/validators";
-var require2 = createRequire(import.meta.url);
+import { loadManifest } from "@lxpack/validators";
 function findCourseDir(startDir = process.cwd()) {
   let dir = resolve(startDir);
   while (dir !== dirname(dir)) {
@@ -35,22 +30,29 @@ function findCourseDir(startDir = process.cwd()) {
     "No course.yaml found. Run from a course directory or use lxpack init."
   );
 }
+
+// src/lib/bundle-io.ts
+import { existsSync as existsSync2 } from "fs";
+import { readFile } from "fs/promises";
+import { createRequire } from "module";
+import { dirname as dirname2, join as join2 } from "path";
+var require2 = createRequire(import.meta.url);
 function getRuntimeAssetsDir() {
-  return dirname(require2.resolve("@lxpack/runtime/client"));
+  return dirname2(require2.resolve("@lxpack/runtime/client"));
 }
 function getEmbeddedStyles() {
   return `:root { --lxpack-bg: #0f1419; } body { margin: 0; }`;
 }
 async function loadRuntimeStyles(assetsDir) {
   try {
-    return await readFile(join(assetsDir, "styles.css"), "utf-8");
+    return await readFile(join2(assetsDir, "styles.css"), "utf-8");
   } catch {
     return getEmbeddedStyles();
   }
 }
 async function readRuntimeBundle(assetsDir = getRuntimeAssetsDir()) {
-  const clientPath = join(assetsDir, "client.js");
-  if (!existsSync(clientPath)) {
+  const clientPath = join2(assetsDir, "client.js");
+  if (!existsSync2(clientPath)) {
     throw new Error(
       "Runtime bundle not found. Run `pnpm build` from the LXPack repo root, or reinstall @lxpack/runtime."
     );
@@ -74,6 +76,13 @@ async function readComponentsBundle() {
     return void 0;
   }
 }
+
+// src/lib/lxpack-config.ts
+import { existsSync as existsSync3 } from "fs";
+import { readFile as readFile2 } from "fs/promises";
+import { join as join3, resolve as resolve2 } from "path";
+import { z } from "zod";
+import { formatErrorMessage, isPathContained } from "@lxpack/validators";
 var lxpackConfigSchema = z.object({
   exports: z.object({
     defaultTarget: z.enum(["scorm12", "scorm2004", "standalone"]).optional()
@@ -83,10 +92,10 @@ var lxpackConfigSchema = z.object({
   }).optional()
 }).strict();
 async function loadLxpackConfig(courseDir) {
-  const configPath = join(courseDir, "lxpack.config.json");
-  if (!existsSync(configPath)) return null;
+  const configPath = join3(courseDir, "lxpack.config.json");
+  if (!existsSync3(configPath)) return null;
   try {
-    const content = await readFile(configPath, "utf-8");
+    const content = await readFile2(configPath, "utf-8");
     const raw = JSON.parse(content);
     const parsed = lxpackConfigSchema.safeParse(raw);
     if (!parsed.success) {
@@ -101,44 +110,47 @@ async function loadLxpackConfig(courseDir) {
     );
   }
 }
-function escapeHtml(text) {
-  return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
-}
-function formatCourseTitleForYaml(title) {
-  const doc = { title, version: "1.0.0" };
-  const yaml = stringifyYaml(doc);
-  const titleLine = yaml.split("\n").find((l) => l.startsWith("title:"));
-  if (!titleLine) {
-    return JSON.stringify(title);
-  }
-  return titleLine.replace(/^title:\s*/, "");
-}
-function getCliVersion() {
-  const pkg = require2("../package.json");
-  return pkg.version;
-}
 function resolvePathInCwd(relativePath) {
-  const cwd = resolve(process.cwd());
+  const cwd = resolve2(process.cwd());
   if (relativePath.startsWith("/") || /^[a-zA-Z]:\\/.test(relativePath)) {
     throw new Error(
       "Use a relative path for the output directory (must stay inside the current working directory)"
     );
   }
-  const target = resolve(cwd, relativePath);
+  const target = resolve2(cwd, relativePath);
   if (!isPathContained(cwd, target)) {
     throw new Error("Path must be inside the current working directory");
   }
   return target;
 }
 function resolveOutputDir(courseDir, outputDir) {
-  const root = resolve(courseDir);
-  const target = resolve(root, outputDir);
+  const root = resolve2(courseDir);
+  const target = resolve2(root, outputDir);
   if (!isPathContained(root, target)) {
     throw new Error("output.dir in lxpack.config.json must stay inside the course directory");
   }
   return target;
 }
 
+// src/lib/html.ts
+import { escapeHtml } from "@lxpack/validators";
+
+// src/utils.ts
+var require3 = createRequire2(import.meta.url);
+function formatCourseTitleForYaml(title) {
+  const doc = { title, version: "1.0.0" };
+  const yaml = stringifyYaml(doc);
+  const titleLine = yaml.split("\n").find((l) => l.startsWith("title:"));
+  if (!titleLine) {
+    return JSON.stringify(title);
+  }
+  return titleLine.replace(/^title:\s*/, "");
+}
+function getCliVersion() {
+  const pkg = require3("../package.json");
+  return pkg.version;
+}
+
 // src/commands/init.ts
 var COURSE_YAML_TEMPLATE = `title: {{title}}
 version: 1.0.0
@@ -274,7 +286,7 @@ async function initCommand(projectName, options = {}) {
   const targetDir = resolvePathInCwd(options.dir ?? projectName);
   const title = formatTitle(projectName);
   const yamlTitle = formatCourseTitleForYaml(title);
-  if (existsSync2(join2(targetDir, "course.yaml")) && !options.force) {
+  if (existsSync4(join4(targetDir, "course.yaml")) && !options.force) {
     console.error(
       pc.red(
         `Directory already contains a course. Use --force to overwrite: ${targetDir}`
@@ -284,29 +296,29 @@ async function initCommand(projectName, options = {}) {
   }
   const dirs = [
     targetDir,
-    join2(targetDir, "lessons"),
-    join2(targetDir, "interactions", "phishing-lab"),
-    join2(targetDir, "assets"),
-    join2(targetDir, "assessments"),
-    join2(targetDir, "theme"),
-    join2(targetDir, "components")
+    join4(targetDir, "lessons"),
+    join4(targetDir, "interactions", "phishing-lab"),
+    join4(targetDir, "assets"),
+    join4(targetDir, "assessments"),
+    join4(targetDir, "theme"),
+    join4(targetDir, "components")
   ];
   for (const dir of dirs) {
     await mkdir(dir, { recursive: true });
   }
   await writeFile(
-    join2(targetDir, "course.yaml"),
+    join4(targetDir, "course.yaml"),
     COURSE_YAML_TEMPLATE.replace("{{title}}", yamlTitle)
   );
-  await writeFile(join2(targetDir, "lessons", "welcome.md"), WELCOME_MD);
+  await writeFile(join4(targetDir, "lessons", "welcome.md"), WELCOME_MD);
   await writeFile(
-    join2(targetDir, "interactions", "phishing-lab", "index.html"),
+    join4(targetDir, "interactions", "phishing-lab", "index.html"),
     PHISHING_HTML
   );
-  await writeFile(join2(targetDir, "assessments", "final.yaml"), FINAL_ASSESSMENT);
-  await writeFile(join2(targetDir, "lxpack.config.json"), LXPACK_CONFIG);
-  await writeFile(join2(targetDir, "theme", ".gitkeep"), "");
-  await writeFile(join2(targetDir, "components", ".gitkeep"), "");
+  await writeFile(join4(targetDir, "assessments", "final.yaml"), FINAL_ASSESSMENT);
+  await writeFile(join4(targetDir, "lxpack.config.json"), LXPACK_CONFIG);
+  await writeFile(join4(targetDir, "theme", ".gitkeep"), "");
+  await writeFile(join4(targetDir, "components", ".gitkeep"), "");
   console.log(pc.green(`\u2713 Created LXPack course: ${targetDir}`));
   console.log();
   console.log("Next steps:");
@@ -320,8 +332,35 @@ async function initCommand(projectName, options = {}) {
 import Fastify from "fastify";
 import fastifyStatic from "@fastify/static";
 import pc2 from "picocolors";
-import { validateCourse, buildRuntimeAssessmentBundle } from "@lxpack/validators";
-import { safeJsonForHtml } from "@lxpack/scorm";
+import { validateCourse as validateCourse2 } from "@lxpack/validators";
+
+// src/lib/validated-course.ts
+import {
+  validateCourse,
+  buildRuntimeAssessmentBundleFromParsed
+} from "@lxpack/validators";
+async function loadValidatedCourseContext(courseDir) {
+  const validation = await validateCourse(courseDir);
+  if (!validation.valid || !validation.manifest) {
+    return null;
+  }
+  const parsed = validation.parsedAssessments ?? /* @__PURE__ */ new Map();
+  const assessmentBundle = buildRuntimeAssessmentBundleFromParsed(parsed);
+  return {
+    courseDir,
+    validation,
+    manifest: validation.manifest,
+    assessmentBundle
+  };
+}
+function printValidationIssues(validation) {
+  for (const issue of validation.issues) {
+    console.error(`  ${issue.path}: ${issue.message}`);
+  }
+}
+
+// src/commands/preview.ts
+import { buildLearnerPageHtml, safeJsonForHtml } from "@lxpack/scorm";
 async function loadPreviewStyles(assetsDir = getRuntimeAssetsDir()) {
   return loadRuntimeStyles(assetsDir);
 }
@@ -341,6 +380,12 @@ function buildPreviewConfig(manifest, assessmentBundle) {
 async function createPreviewServer(courseDir, manifest, assessmentBundle) {
   const runtimeDir = getRuntimeAssetsDir();
   const app = Fastify({ logger: false });
+  app.addHook("onRequest", async (request, reply) => {
+    const path = request.url.split("?")[0] ?? "";
+    if (path.startsWith("/course/assessments/")) {
+      return reply.code(404).send("Not found");
+    }
+  });
   await app.register(fastifyStatic, {
     root: courseDir,
     prefix: "/course/",
@@ -360,52 +405,39 @@ async function createPreviewServer(courseDir, manifest, assessmentBundle) {
     });
   }
   app.get("/", async (_req, reply) => {
-    const html = `<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>${escapeHtml(manifest.title)} \u2014 Preview</title>
-  <style>${stylesCss}</style>
-</head>
-<body>
-  <div id="lxpack-app"></div>
-  <script type="application/json" id="lxpack-config">${config}</script>
-  <script>
-    window.__LXPACK_CONFIG__ = JSON.parse(document.getElementById('lxpack-config').textContent);
-  </script>
-  ${componentsJs ? '<script type="module" src="/runtime/components.js"></script>' : ""}
-  <script type="module" src="/runtime/client.js"></script>
-</body>
-</html>`;
+    const html = buildLearnerPageHtml({
+      title: `${manifest.title} \u2014 Preview`,
+      runtimeCss: stylesCss,
+      configJson: config,
+      runtimeScript: "/runtime/client.js",
+      componentsScript: componentsJs ? "/runtime/components.js" : void 0
+    });
     return reply.type("text/html").send(html);
   });
   app.get("/health", async () => ({ status: "ok" }));
   return app;
 }
 async function startPreview(courseDir, _options = {}) {
-  const validation = await validateCourse(courseDir);
-  if (!validation.manifest) {
-    console.error(pc2.red("Cannot preview: course manifest is invalid"));
-    for (const issue of validation.issues) {
-      console.error(`  ${issue.path}: ${issue.message}`);
+  const ctx = await loadValidatedCourseContext(courseDir);
+  if (!ctx) {
+    const validation2 = await validateCourse2(courseDir);
+    if (!validation2.manifest) {
+      console.error(pc2.red("Cannot preview: course manifest is invalid"));
+      for (const issue of validation2.issues) {
+        console.error(`  ${issue.path}: ${issue.message}`);
+      }
+      process.exit(1);
     }
-    process.exit(1);
-  }
-  if (!validation.valid) {
     console.error(pc2.red("Cannot preview: course validation failed"));
-    for (const issue of validation.issues) {
+    for (const issue of validation2.issues) {
       console.error(`  ${issue.path}: ${issue.message}`);
     }
     process.exit(1);
   }
-  const assessmentBundle = await buildRuntimeAssessmentBundle(
-    courseDir,
-    validation.manifest
-  );
+  const { validation, manifest, assessmentBundle } = ctx;
   const app = await createPreviewServer(
     courseDir,
-    validation.manifest,
+    manifest,
     assessmentBundle
   );
   return { app, validation };
@@ -452,11 +484,11 @@ function logPreviewStarted(host, port) {
 }
 
 // src/commands/validate.ts
-import { validateCourse as validateCourse2 } from "@lxpack/validators";
+import { validateCourse as validateCourse3 } from "@lxpack/validators";
 import pc3 from "picocolors";
 async function validateCommand() {
   const courseDir = findCourseDir();
-  const result = await validateCourse2(courseDir);
+  const result = await validateCourse3(courseDir);
   if (result.manifest) {
     console.log(
       pc3.dim(`Course: ${result.manifest.title} v${result.manifest.version}`)
@@ -479,13 +511,35 @@ async function validateCommand() {
 
 // src/commands/build.ts
 import { mkdir as mkdir2 } from "fs/promises";
-import { join as join3 } from "path";
-import { packageCourse, packageStandaloneDir, courseSlug } from "@lxpack/scorm";
-import {
-  validateCourse as validateCourse3,
-  buildRuntimeAssessmentBundle as buildRuntimeAssessmentBundle2
-} from "@lxpack/validators";
+import { join as join5 } from "path";
+import { courseSlug } from "@lxpack/scorm";
 import pc4 from "picocolors";
+
+// src/packagers/index.ts
+import {
+  packageCourse,
+  packageScorm2004Dir,
+  packageStandaloneDir
+} from "@lxpack/scorm";
+var zipPackagers = {
+  scorm12: { package: packageCourse },
+  scorm2004: { package: packageCourse },
+  standalone: { package: packageCourse }
+};
+var dirPackagers = {
+  scorm12: { package: packageStandaloneDir },
+  scorm2004: { package: packageScorm2004Dir },
+  standalone: { package: packageStandaloneDir }
+};
+function getZipPackager(target) {
+  return zipPackagers[target];
+}
+function getDirPackager(target) {
+  return dirPackagers[target];
+}
+
+// src/commands/build.ts
+import { validateCourse as validateCourse4 } from "@lxpack/validators";
 var VALID_TARGETS = ["scorm12", "scorm2004", "standalone"];
 async function buildCommand(options) {
   const courseDir = findCourseDir();
@@ -499,19 +553,14 @@ async function buildCommand(options) {
     );
     process.exit(1);
   }
-  const validation = await validateCourse3(courseDir);
-  if (!validation.valid || !validation.manifest) {
+  const ctx = await loadValidatedCourseContext(courseDir);
+  if (!ctx) {
     console.error(pc4.red("Cannot build: course validation failed"));
-    for (const issue of validation.issues) {
-      console.error(`  ${issue.path}: ${issue.message}`);
-    }
+    const validation = await validateCourse4(courseDir);
+    printValidationIssues(validation);
     process.exit(1);
   }
-  const manifest = validation.manifest;
-  const assessmentBundle = await buildRuntimeAssessmentBundle2(
-    courseDir,
-    manifest
-  );
+  const { manifest, assessmentBundle } = ctx;
   const [{ clientJs, css }, componentsBundleJs] = await Promise.all([
     readRuntimeBundle(),
     readComponentsBundle()
@@ -530,8 +579,8 @@ async function buildCommand(options) {
     assessmentBundle
   };
   if (options.dir) {
-    const outputDir = options.output ?? join3(outputRoot, target);
-    const result = await packageStandaloneDir({
+    const outputDir = options.output ?? join5(outputRoot, target);
+    const result = await getDirPackager(target).package({
       ...packageOptions,
       outputDir
     });
@@ -540,8 +589,8 @@ async function buildCommand(options) {
     console.log(`  Files: ${result.fileCount}`);
   } else {
     const defaultName = target === "standalone" ? `${slug}-standalone.zip` : target === "scorm2004" ? `${slug}-scorm2004.zip` : `${slug}-scorm12.zip`;
-    const outputPath = options.output ?? join3(outputRoot, defaultName);
-    const result = await packageCourse({
+    const outputPath = options.output ?? join5(outputRoot, defaultName);
+    const result = await getZipPackager(target).package({
       ...packageOptions,
       outputPath
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lxpack/cli",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "CLI for building, validating, and packaging LXPack courses",
   "license": "Apache-2.0",
   "repository": {
@@ -39,10 +39,10 @@
     "picocolors": "^1.1.1",
     "yaml": "^2.7.0",
     "zod": "^3.24.2",
-    "@lxpack/runtime": "0.2.0",
-    "@lxpack/components": "0.2.0",
-    "@lxpack/scorm": "0.2.0",
-    "@lxpack/validators": "0.2.0"
+    "@lxpack/components": "0.2.1",
+    "@lxpack/validators": "0.2.1",
+    "@lxpack/runtime": "0.2.1",
+    "@lxpack/scorm": "0.2.1"
   },
   "devDependencies": {
     "@types/node": "^22.13.10",