coursecode 0.1.11 → 0.1.13

package/bin/cli.js

@@ -166,12 +166,13 @@ program
 // Convert command
 program
   .command('convert [source]')
-  .description('Convert docx, pptx, and pdf files to markdown for course authoring')
+  .description('Convert docx, pptx, and pdf files to markdown for course authoring (PDF JSON sidecars optional)')
   .option('-o, --output <dir>', 'Output directory for converted files', './course/references/converted')
   .option('-f, --format <type>', 'Limit to format: docx, pptx, pdf, or all', 'all')
   .option('--dry-run', 'Show what would be converted without writing files')
   .option('--overwrite', 'Overwrite existing markdown files')
   .option('--flatten', 'Output all files to single directory (no subdirs)')
+  .option('--pdf-json', 'Also write PDF structure JSON sidecars (.json) next to converted markdown')
   .action(async (source = './course/references', options) => {
     const { convert } = await import('../lib/convert.js');
     await convert(source, options);

package/lib/cloud.js

@@ -29,8 +29,11 @@ const DEFAULT_CLOUD_URL = 'https://coursecodecloud.com';
 const FALLBACK_CLOUD_URL = 'https://coursecode-cloud-web.vercel.app';
 const LOCAL_CLOUD_URL = 'http://localhost:3000';
 let useLocal = false;
+let activeCloudUrl = null;
 const CREDENTIALS_DIR = path.join(os.homedir(), '.coursecode');
 const CREDENTIALS_PATH = path.join(CREDENTIALS_DIR, 'credentials.json');
+const PROJECT_CONFIG_DIR = '.coursecode';
+const PROJECT_CONFIG_PATH = path.join(PROJECT_CONFIG_DIR, 'project.json');
 
 const POLL_INTERVAL_MS = 2000;
 const POLL_TIMEOUT_MS = 15 * 60 * 1000; // 15 minutes (device code expiry)
@@ -91,12 +94,19 @@ function writeCredentials(token, cloudUrl = DEFAULT_CLOUD_URL) {
   fs.writeFileSync(getCredentialsPath(), data, { mode: 0o600 });
 }
 
+function updateCredentialsCloudUrl(cloudUrl) {
+  const creds = readCredentials();
+  if (!creds?.token) return;
+  writeCredentials(creds.token, cloudUrl);
+}
+
 function deleteCredentials() {
   try { fs.unlinkSync(getCredentialsPath()); } catch { /* already gone */ }
 }
 
 function getCloudUrl() {
   if (useLocal) return LOCAL_CLOUD_URL;
+  if (activeCloudUrl) return activeCloudUrl;
   return readCredentials()?.cloud_url || DEFAULT_CLOUD_URL;
 }
 
@@ -106,6 +116,32 @@ function getCloudUrl() {
  */
 export function setLocalMode() {
   useLocal = true;
+  activeCloudUrl = LOCAL_CLOUD_URL;
+}
+
+// =============================================================================
+// PROJECT BINDING (local: .coursecode/project.json)
+// =============================================================================
+
+function readProjectConfig() {
+  try {
+    const fullPath = path.join(process.cwd(), PROJECT_CONFIG_PATH);
+    if (!fs.existsSync(fullPath)) return null;
+    return JSON.parse(fs.readFileSync(fullPath, 'utf-8'));
+  } catch {
+    return null;
+  }
+}
+
+function writeProjectConfig(data) {
+  const dir = path.join(process.cwd(), PROJECT_CONFIG_DIR);
+  fs.mkdirSync(dir, { recursive: true });
+  const existing = readProjectConfig() || {};
+  Object.assign(existing, data);
+  fs.writeFileSync(
+    path.join(process.cwd(), PROJECT_CONFIG_PATH),
+    JSON.stringify(existing, null, 2) + '\n'
+  );
 }
 
 // =============================================================================
@@ -176,7 +212,10 @@ async function cloudFetch(urlPath, options = {}, token = null) {
     // Primary unreachable — try fallback before giving up
     if (!useLocal) {
       const fallback = await attemptFetch(FALLBACK_CLOUD_URL);
-      if (fallback) return fallback;
+      if (fallback) {
+        activeCloudUrl = FALLBACK_CLOUD_URL;
+        return fallback;
+      }
     }
     console.error('\n❌ Could not connect to CourseCode Cloud. Check your internet connection.\n');
     process.exit(1);
@@ -185,11 +224,29 @@ async function cloudFetch(urlPath, options = {}, token = null) {
   // Peek at the body: if it's an HTML block page, silently retry on the fallback.
   // We must buffer the text here since Response bodies can only be read once.
   const text = await res.text();
+
+  // Token may be valid on the alternate cloud origin. Before triggering re-auth,
+  // retry authenticated 401s once on the other known origin.
+  if (res.status === 401 && token && !useLocal) {
+    const alternateUrl = primaryUrl === FALLBACK_CLOUD_URL ? DEFAULT_CLOUD_URL : FALLBACK_CLOUD_URL;
+    const alternateRes = await attemptFetch(alternateUrl);
+    if (alternateRes) {
+      const alternateText = await alternateRes.text();
+      if (!isBlockPage(alternateText) && alternateRes.status !== 401) {
+        activeCloudUrl = alternateUrl;
+        updateCredentialsCloudUrl(alternateUrl);
+        return syntheticResponse(alternateText, alternateRes.status);
+      }
+    }
+  }
+
   if (isBlockPage(text) && !useLocal) {
     const fallbackRes = await attemptFetch(FALLBACK_CLOUD_URL);
     if (fallbackRes) {
       const fallbackText = await fallbackRes.text();
       if (!isBlockPage(fallbackText)) {
+        activeCloudUrl = FALLBACK_CLOUD_URL;
+        updateCredentialsCloudUrl(FALLBACK_CLOUD_URL);
         // Fallback succeeded — return a synthetic Response with the buffered text
         return syntheticResponse(fallbackText, fallbackRes.status);
       }
@@ -200,6 +257,7 @@ async function cloudFetch(urlPath, options = {}, token = null) {
   }
 
   // Primary response is fine — return a synthetic Response with the buffered text
+  activeCloudUrl = primaryUrl;
   return syntheticResponse(text, res.status);
 }
 
@@ -435,7 +493,7 @@ async function runLoginFlow({ jsonMode = false } = {}) {
     if (data.pending) continue;
 
     if (data.token) {
-      writeCredentials(data.token, getCloudUrl());
+      writeCredentials(data.token, activeCloudUrl || getCloudUrl());
       log('  ✓ Logged in successfully\n');
       return data.token;
     }
@@ -453,7 +511,7 @@ async function runLoginFlow({ jsonMode = false } = {}) {
  */
 async function runLegacyLoginFlow() {
   const nonce = crypto.randomBytes(32).toString('hex');
-  const cloudUrl = getCloudUrl();
+  const initialCloudUrl = getCloudUrl();
 
   console.log('  → Registering session...');
   const createRes = await cloudFetch('/api/auth/connect', {
@@ -469,7 +527,8 @@ async function runLegacyLoginFlow() {
     process.exit(1);
   }
 
-  const loginUrl = `${cloudUrl}/auth/connect?session=${nonce}`;
+  const effectiveCloudUrl = activeCloudUrl || initialCloudUrl;
+  const loginUrl = `${effectiveCloudUrl}/auth/connect?session=${nonce}`;
   console.log('  → Opening browser for authentication...');
   openBrowser(loginUrl);
 
@@ -490,7 +549,7 @@ async function runLegacyLoginFlow() {
     if (data.pending) continue;
 
     if (data.token) {
-      writeCredentials(data.token, cloudUrl);
+      writeCredentials(data.token, activeCloudUrl || initialCloudUrl);
       console.log('  ✓ Logged in successfully');
       return data.token;
     }
@@ -528,11 +587,21 @@ export async function ensureAuthenticated() {
  * Returns { orgId, courseId, orgName } or prompts the user.
  */
 async function resolveOrgAndCourse(slug, token) {
-  // .coursecoderc.json is committed and shared — it is the single source of truth
-  // for the cloud binding. If both cloudId and orgId are present, short-circuit.
+  // Shared binding (committed): cloudId in .coursecoderc.json.
+  // Local binding (per-user): orgId/courseId in .coursecode/project.json.
+  // This keeps login global while allowing per-course auth context.
   const rcConfig = readRcConfig();
-  if (rcConfig?.cloudId && rcConfig?.orgId) {
-    return { orgId: rcConfig.orgId, courseId: rcConfig.cloudId };
+  const projectConfig = readProjectConfig();
+  const rcCloudId = rcConfig?.cloudId;
+  const localOrgId = projectConfig?.orgId;
+  const localCourseId = projectConfig?.courseId;
+
+  if (rcCloudId && localOrgId) {
+    return { orgId: localOrgId, courseId: rcCloudId };
+  }
+
+  if (localOrgId && localCourseId) {
+    return { orgId: localOrgId, courseId: localCourseId };
   }
 
   // Call resolve endpoint
@@ -541,7 +610,8 @@ async function resolveOrgAndCourse(slug, token) {
 
   // Found in exactly one org
   if (data.found) {
-    writeRcConfig({ orgId: data.orgId, cloudId: data.courseId });
+    writeProjectConfig({ slug, orgId: data.orgId, courseId: data.courseId });
+    writeRcConfig({ cloudId: data.courseId, orgId: data.orgId });
     return { orgId: data.orgId, courseId: data.courseId, orgName: data.orgName };
   }
 
@@ -558,7 +628,8 @@ async function resolveOrgAndCourse(slug, token) {
       process.exit(1);
     }
     const match = data.matches[idx];
-    writeRcConfig({ orgId: match.orgId, cloudId: match.courseId });
+    writeProjectConfig({ slug, orgId: match.orgId, courseId: match.courseId });
+    writeRcConfig({ cloudId: match.courseId, orgId: match.orgId });
     return { orgId: match.orgId, courseId: match.courseId, orgName: match.orgName };
   }
 
@@ -638,7 +709,7 @@ export async function login(options = {}) {
 }
 
 /**
- * coursecode logout — delete credentials and local project.json
+ * coursecode logout — delete Cloud credentials
  */
 export async function logout(options = {}) {
   deleteCredentials();
@@ -817,8 +888,9 @@ export async function deploy(options = {}) {
 
   const result = await makeRequest();
 
-  // Step 6: Stamp cloudId + orgId into .coursecoderc.json (committed, shared with team)
+  // Step 6: Persist per-user binding and stamp cloud identity into .coursecoderc.json
   const finalCourseId = result.courseId || courseId;
+  writeProjectConfig({ slug, orgId: result.orgId || orgId, courseId: finalCourseId });
   writeRcConfig({
     cloudId: finalCourseId,
     orgId: result.orgId || orgId,

package/lib/convert.js

@@ -18,7 +18,8 @@ export async function convert(source, options) {
         format = 'all',
         dryRun = false,
         overwrite = false,
-        flatten = false
+        flatten = false,
+        pdfJson = false
     } = options;
 
     console.log('\n📄 Converting documents to markdown...\n');
@@ -111,8 +112,8 @@ export async function convert(source, options) {
             // Write output
             await fs.writeFile(outputFile, result.markdown, 'utf-8');
 
-            // Write structured data if available (for AI analysis)
-            if (result.data) {
+            // PDF structure sidecar is optional because it is much larger/token-heavier than markdown.
+            if (result.data && pdfJson) {
                 const jsonPath = outputFile.replace(/\.md$/, '.json');
                 await fs.writeFile(jsonPath, JSON.stringify(result.data, null, 2), 'utf-8');
             }

package/lib/stub-player/lms-api.js

@@ -9,7 +9,7 @@
  * Enforces real LMS behavior — lifecycle violations return 'false' with proper
  * error codes, read-only elements reject SetValue, and format-specific rules
  * are enforced. This catches bugs that silently pass in dev but explode in
- * production LMSs like SCORM Cloud, Moodle, Cornerstone, etc.
+ * production SCORM/cmi5/LTI environments and LMSs like Moodle or Cornerstone.
  */
 
 const isBrowser = typeof window !== 'undefined';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "coursecode",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "Multi-format course authoring framework with CLI tools (SCORM 2004, SCORM 1.2, cmi5, LTI 1.3)",
   "type": "module",
   "bin": {