tessera-learn 0.0.11 → 0.0.13

package/src/runtime/adapters/index.ts

@@ -20,7 +20,7 @@ export class LMSAdapterError extends Error {
 }
 
 function missingApiError(
-  standard: 'scorm12' | 'scorm2004' | 'cmi5'
+  standard: 'scorm12' | 'scorm2004' | 'cmi5',
 ): LMSAdapterError {
   const label =
     standard === 'scorm12'
@@ -36,7 +36,7 @@ function missingApiError(
     standard,
     `Tessera: this course is configured for ${label} but ${detail} ` +
       `The course must be launched from an LMS that provides the ${label} runtime. ` +
-      `If you are testing locally, run \`npm run dev\` instead, or set export.standard to "web".`
+      `If you are testing locally, run \`npm run dev\` instead, or set export.standard to "web".`,
   );
 }
 
@@ -63,13 +63,22 @@ export interface CreateAdapterOptions {
 type LMSStandard = 'scorm12' | 'scorm2004' | 'cmi5';
 
 /** Per-standard LMS detection. `detect` returns an adapter when the LMS runtime is reachable, else null. */
-const LMS_ADAPTERS: Record<LMSStandard, { detect: () => PersistenceAdapter | null; label: string }> = {
+const LMS_ADAPTERS: Record<
+  LMSStandard,
+  { detect: () => PersistenceAdapter | null; label: string }
+> = {
   scorm12: {
-    detect: () => { const api = findSCORM12API(); return api ? new SCORM12Adapter(api) : null; },
+    detect: () => {
+      const api = findSCORM12API();
+      return api ? new SCORM12Adapter(api) : null;
+    },
     label: 'SCORM 1.2 API',
   },
   scorm2004: {
-    detect: () => { const api = findSCORM2004API(); return api ? new SCORM2004Adapter(api) : null; },
+    detect: () => {
+      const api = findSCORM2004API();
+      return api ? new SCORM2004Adapter(api) : null;
+    },
     label: 'SCORM 2004 API',
   },
   cmi5: {
@@ -80,18 +89,21 @@ const LMS_ADAPTERS: Record<LMSStandard, { detect: () => PersistenceAdapter | nul
 
 export function createAdapter(
   config: CourseConfig,
-  options: CreateAdapterOptions = {}
+  options: CreateAdapterOptions = {},
 ): PersistenceAdapter {
-  const allowFallback =
-    options.allowFallback ?? import.meta.env?.DEV === true;
+  const allowFallback = options.allowFallback ?? import.meta.env?.DEV === true;
   const standard = config.export?.standard;
-  if (standard === 'scorm12' || standard === 'scorm2004' || standard === 'cmi5') {
+  if (
+    standard === 'scorm12' ||
+    standard === 'scorm2004' ||
+    standard === 'cmi5'
+  ) {
     const entry = LMS_ADAPTERS[standard];
     const adapter = entry.detect();
     if (adapter) return adapter;
     if (!allowFallback) throw missingApiError(standard);
     console.warn(
-      `Tessera (dev): ${entry.label} not found — falling back to localStorage`
+      `Tessera (dev): ${entry.label} not found — falling back to localStorage`,
     );
   }
   return new WebAdapter(config);

package/src/runtime/adapters/retry.ts

@@ -24,29 +24,37 @@ function lmsCallSucceeded(result: unknown): boolean {
 
 function readLastErrorCode(reporter: LMSErrorReporter | undefined): string {
   if (!reporter) return '';
-  try { return reporter.code(); } catch { return ''; }
+  try {
+    return reporter.code();
+  } catch {
+    return '';
+  }
 }
 
 function logRetryGiveUp(
   errorReporter: LMSErrorReporter | undefined,
   lastErrCode: string,
-  context: string | undefined
+  context: string | undefined,
 ): void {
   const ctx = context ? ` [${context}]` : '';
   console.warn(
-    `Tessera: LMS call failed after retries${ctx}${formatLMSErrorDetail(errorReporter, lastErrCode)}, continuing without persistence`
+    `Tessera: LMS call failed after retries${ctx}${formatLMSErrorDetail(errorReporter, lastErrCode)}, continuing without persistence`,
   );
 }
 
 export function formatLMSErrorDetail(
   errorReporter: LMSErrorReporter | undefined,
-  code: string
+  code: string,
 ): string {
   if (!errorReporter || !code || code === '0') return '';
   let msg = '';
   let diag = '';
-  try { msg = errorReporter.message(code); } catch {}
-  try { diag = errorReporter.diagnostic?.(code) ?? ''; } catch {}
+  try {
+    msg = errorReporter.message(code);
+  } catch {}
+  try {
+    diag = errorReporter.diagnostic?.(code) ?? '';
+  } catch {}
   let detail = ` (LMS error ${code}`;
   if (msg) detail += `: ${msg}`;
   if (diag && diag !== msg) detail += ` — ${diag}`;
@@ -56,24 +64,21 @@ export function formatLMSErrorDetail(
 
 /** Sync call that warns with the LMS error code on failure (terminate-path). */
 export function callSyncOrWarn(
-  fn: () => any,
+  fn: () => unknown,
   context: string,
-  errorReporter?: LMSErrorReporter
+  errorReporter?: LMSErrorReporter,
 ): boolean {
-  let ok = false;
+  let ok: boolean;
   try {
     ok = lmsCallSucceeded(fn());
   } catch (err) {
-    console.warn(
-      `Tessera: LMS call threw [${context}] during terminate`,
-      err
-    );
+    console.warn(`Tessera: LMS call threw [${context}] during terminate`, err);
     return false;
   }
   if (!ok) {
     const code = readLastErrorCode(errorReporter);
     console.warn(
-      `Tessera: LMS call failed [${context}] during terminate${formatLMSErrorDetail(errorReporter, code)}`
+      `Tessera: LMS call failed [${context}] during terminate${formatLMSErrorDetail(errorReporter, code)}`,
     );
   }
   return ok;
@@ -95,10 +100,10 @@ export function callSyncOrWarn(
  * for SCORM adapters where the underlying API calls are synchronous.
  */
 export async function withRetry(
-  fn: () => any,
+  fn: () => unknown,
   maxRetries = RETRY_ATTEMPTS,
   errorReporter?: LMSErrorReporter,
-  context?: string
+  context?: string,
 ): Promise<boolean> {
   let lastErrCode = '';
   let threw = false;
@@ -128,7 +133,7 @@ export async function withRetry(
  * Synchronous single-attempt LMS call. Used during page unload
  * where async retries cannot run.
  */
-export function callSync(fn: () => any): boolean {
+export function callSync(fn: () => unknown): boolean {
   try {
     return lmsCallSucceeded(fn());
   } catch {
@@ -143,7 +148,7 @@ export function callSync(fn: () => any): boolean {
  * the failed operation on the next flush trigger.
  */
 interface QueueEntry {
-  fn: () => any;
+  fn: () => unknown;
   context?: string;
 }
 
@@ -164,10 +169,10 @@ export class WriteQueue {
   /**
    * Enqueue an operation and trigger a flush.
    */
-  enqueue(fn: () => any, context?: string): void {
+  enqueue(fn: () => unknown, context?: string): void {
     this.#queue.push({ fn, context });
     if (!this.#flushing) {
-      this.#flush();
+      void this.#flush();
     }
   }
 

package/src/runtime/adapters/scorm-base.ts

@@ -71,11 +71,11 @@ export abstract class BaseScormAdapter<TApi> implements PersistenceAdapter {
       () => this.dialect.initialize(this.api),
       undefined,
       this.errorReporter,
-      'Initialize'
+      'Initialize',
     );
     if (!initialized) {
       console.warn(
-        'Tessera: LMS Initialize failed — all subsequent persistence calls will fail with error 301 (Not Initialized). Reload the launch from the LMS.'
+        'Tessera: LMS Initialize failed — all subsequent persistence calls will fail with error 301 (Not Initialized). Reload the launch from the LMS.',
       );
       return;
     }
@@ -86,7 +86,7 @@ export abstract class BaseScormAdapter<TApi> implements PersistenceAdapter {
     } catch (err) {
       console.warn(
         'Tessera: LMS threw on GetValue(cmi.suspend_data); resume disabled for this launch',
-        err
+        err,
       );
     }
     if (raw && raw.trim()) {
@@ -95,7 +95,7 @@ export abstract class BaseScormAdapter<TApi> implements PersistenceAdapter {
       } catch (err) {
         console.warn(
           'Tessera: cmi.suspend_data is not valid JSON; resume disabled for this launch (the LMS may have truncated a prior write)',
-          err
+          err,
         );
         this.#state = null;
       }
@@ -103,13 +103,13 @@ export abstract class BaseScormAdapter<TApi> implements PersistenceAdapter {
 
     // n indexing must continue from _count — restarting at 0 would overwrite
     // the prior session's records (the LMS uses n as the array key).
-    let countRaw = '';
+    let countRaw: string;
     try {
       countRaw = this.dialect.getValue(this.api, 'cmi.interactions._count');
     } catch (err) {
       console.warn(
         'Tessera: LMS threw on GetValue(cmi.interactions._count); new interactions will be written from index 0 and may overwrite prior session records',
-        err
+        err,
       );
       return;
     }
@@ -119,7 +119,7 @@ export abstract class BaseScormAdapter<TApi> implements PersistenceAdapter {
       this.interactionCount = n;
     } else {
       console.warn(
-        `Tessera: LMS returned non-numeric cmi.interactions._count="${countRaw}"; new interactions will be written from index 0 and may overwrite prior session records`
+        `Tessera: LMS returned non-numeric cmi.interactions._count="${countRaw}"; new interactions will be written from index 0 and may overwrite prior session records`,
       );
     }
   }
@@ -141,12 +141,12 @@ export abstract class BaseScormAdapter<TApi> implements PersistenceAdapter {
           `${this.dialect.suspendDataLimitLabel} limit. The LMS will likely ` +
           `truncate it and the next resume will lose state. Reduce ` +
           `usePersistence() payloads or switch export.standard to a ` +
-          `larger-limit standard (scorm2004/cmi5).`
+          `larger-limit standard (scorm2004/cmi5).`,
       );
     }
     this.queue.enqueue(
       () => this.dialect.setValue(this.api, 'cmi.suspend_data', json),
-      'cmi.suspend_data'
+      'cmi.suspend_data',
     );
   }
 
@@ -155,14 +155,14 @@ export abstract class BaseScormAdapter<TApi> implements PersistenceAdapter {
     this.queue.enqueue(
       () =>
         this.dialect.setValue(this.api, this.dialect.sessionTimeKey, formatted),
-      this.dialect.sessionTimeKey
+      this.dialect.sessionTimeKey,
     );
   }
 
   reportInteraction(
     questionId: string,
     interaction: Interaction,
-    correct: boolean | null
+    correct: boolean | null,
   ): void {
     const n = this.interactionCount++;
     const fields = buildScormInteractionFields(
@@ -177,12 +177,12 @@ export abstract class BaseScormAdapter<TApi> implements PersistenceAdapter {
         typeValue: this.dialect.interactionFields.typeValue(interaction.type),
         resultLabels: this.dialect.interactionFields.resultLabels,
         format: this.dialect.interactionFields.format,
-      }
+      },
     );
     for (const [key, value] of fields) {
       this.queue.enqueue(
         () => this.dialect.setValue(this.api, key, value),
-        key
+        key,
       );
     }
   }
@@ -196,11 +196,15 @@ export abstract class BaseScormAdapter<TApi> implements PersistenceAdapter {
     this.#terminated = true;
     // Async retries can't run during page unload — drain + commit + finish synchronously.
     this.queue.drainSync();
-    callSyncOrWarn(() => this.dialect.commit(this.api), 'Commit', this.errorReporter);
+    callSyncOrWarn(
+      () => this.dialect.commit(this.api),
+      'Commit',
+      this.errorReporter,
+    );
     callSyncOrWarn(
       () => this.dialect.terminate(this.api),
       'Terminate',
-      this.errorReporter
+      this.errorReporter,
     );
   }
 

package/src/runtime/adapters/scorm12.ts

@@ -67,24 +67,23 @@ export class SCORM12Adapter extends BaseScormAdapter<SCORM12API> {
     super.saveState(state);
     // §3.4.5.3 — bookmark for LMS "Resume from page N" affordances.
     this.queue.enqueue(
-      () =>
-        this.api.LMSSetValue('cmi.core.lesson_location', String(state.b)),
-      'cmi.core.lesson_location'
+      () => this.api.LMSSetValue('cmi.core.lesson_location', String(state.b)),
+      'cmi.core.lesson_location',
     );
   }
 
   setScore(score: number): void {
     this.queue.enqueue(
       () => this.api.LMSSetValue('cmi.core.score.raw', formatReal107(score)),
-      'cmi.core.score.raw'
+      'cmi.core.score.raw',
     );
     this.queue.enqueue(
       () => this.api.LMSSetValue('cmi.core.score.min', '0'),
-      'cmi.core.score.min'
+      'cmi.core.score.min',
     );
     this.queue.enqueue(
       () => this.api.LMSSetValue('cmi.core.score.max', '100'),
-      'cmi.core.score.max'
+      'cmi.core.score.max',
     );
   }
 
@@ -104,7 +103,7 @@ export class SCORM12Adapter extends BaseScormAdapter<SCORM12API> {
     const value = this.#successStatus ?? this.#completionStatus;
     this.queue.enqueue(
       () => this.api.LMSSetValue('cmi.core.lesson_status', value),
-      'cmi.core.lesson_status'
+      'cmi.core.lesson_status',
     );
   }
 
@@ -113,7 +112,7 @@ export class SCORM12Adapter extends BaseScormAdapter<SCORM12API> {
     const value = mode === 'suspend' ? 'suspend' : '';
     this.queue.enqueue(
       () => this.api.LMSSetValue('cmi.core.exit', value),
-      'cmi.core.exit'
+      'cmi.core.exit',
     );
   }
 }

package/src/runtime/adapters/scorm2004.ts

@@ -86,7 +86,7 @@ export class SCORM2004Adapter extends BaseScormAdapter<SCORM2004API> {
   }
 
   #readScaledThreshold(key: string): number | null {
-    let raw = '';
+    let raw: string;
     try {
       raw = this.api.GetValue(key);
     } catch {
@@ -104,7 +104,7 @@ export class SCORM2004Adapter extends BaseScormAdapter<SCORM2004API> {
     // §4.2.1.4 — bookmark for LMS "Resume from page N" affordances.
     this.queue.enqueue(
       () => this.api.SetValue('cmi.location', String(state.b)),
-      'cmi.location'
+      'cmi.location',
     );
   }
 
@@ -116,7 +116,7 @@ export class SCORM2004Adapter extends BaseScormAdapter<SCORM2004API> {
   reportInteraction(
     questionId: string,
     interaction: import('../interaction.js').Interaction,
-    correct: boolean | null
+    correct: boolean | null,
   ): void {
     if (!this.#canWrite) return;
     super.reportInteraction(questionId, interaction, correct);
@@ -129,19 +129,19 @@ export class SCORM2004Adapter extends BaseScormAdapter<SCORM2004API> {
     const scaled = formatReal107(Math.max(0, Math.min(1, score / 100)));
     this.queue.enqueue(
       () => this.api.SetValue('cmi.score.raw', raw),
-      'cmi.score.raw'
+      'cmi.score.raw',
     );
     this.queue.enqueue(
       () => this.api.SetValue('cmi.score.min', '0'),
-      'cmi.score.min'
+      'cmi.score.min',
     );
     this.queue.enqueue(
       () => this.api.SetValue('cmi.score.max', '100'),
-      'cmi.score.max'
+      'cmi.score.max',
     );
     this.queue.enqueue(
       () => this.api.SetValue('cmi.score.scaled', scaled),
-      'cmi.score.scaled'
+      'cmi.score.scaled',
     );
   }
 
@@ -150,13 +150,13 @@ export class SCORM2004Adapter extends BaseScormAdapter<SCORM2004API> {
     const value = status === 'complete' ? 'completed' : 'incomplete';
     this.queue.enqueue(
       () => this.api.SetValue('cmi.completion_status', value),
-      'cmi.completion_status'
+      'cmi.completion_status',
     );
     // §4.2.4.2 — writing 1.0 surfaces a "100%" reading on LMS dashboards.
     if (status === 'complete') {
       this.queue.enqueue(
         () => this.api.SetValue('cmi.progress_measure', '1'),
-        'cmi.progress_measure'
+        'cmi.progress_measure',
       );
     }
   }
@@ -167,15 +167,12 @@ export class SCORM2004Adapter extends BaseScormAdapter<SCORM2004API> {
     // a null status to "passed".
     this.queue.enqueue(
       () => this.api.SetValue('cmi.success_status', status),
-      'cmi.success_status'
+      'cmi.success_status',
     );
   }
 
   setExit(mode: 'suspend' | 'normal'): void {
     if (!this.#canWrite) return;
-    this.queue.enqueue(
-      () => this.api.SetValue('cmi.exit', mode),
-      'cmi.exit'
-    );
+    this.queue.enqueue(() => this.api.SetValue('cmi.exit', mode), 'cmi.exit');
   }
 }

package/src/runtime/adapters/web.ts

@@ -51,7 +51,7 @@ export class WebAdapter implements PersistenceAdapter {
   reportInteraction(
     _questionId: string,
     _interaction: Interaction,
-    _correct: boolean | null
+    _correct: boolean | null,
   ): void {
     // Web adapter has no external LMS; learner interaction data lives only
     // in memory. Authors who want to persist per-question state can use