tessera-learn 0.0.10 → 0.0.13

package/src/runtime/adapters/cmi5.ts

@@ -5,7 +5,7 @@ import {
   formatCorrectPattern,
   XAPI_INTERACTION_FORMAT,
 } from '../interaction-format.js';
-import { formatISO8601Duration } from './retry.js';
+import { formatISO8601Duration } from './format.js';
 import { XAPIPublisher } from '../xapi/publisher.js';
 import { X_API_VERSION } from '../xapi/version.js';
 import type { XAPIAgent } from '../xapi/types.js';
@@ -26,7 +26,8 @@ const VERBS = {
   // registration state when Terminated lands without Completed.
 } as const;
 
-const CMI_INTERACTION_TYPE = 'http://adlnet.gov/expapi/activities/cmi.interaction';
+const CMI_INTERACTION_TYPE =
+  'http://adlnet.gov/expapi/activities/cmi.interaction';
 
 const CMI5_MASTERYSCORE_EXT =
   'https://w3id.org/xapi/cmi5/context/extensions/masteryscore';
@@ -36,26 +37,10 @@ const CMI5_MASTERYSCORE_EXT =
 // "failed" MUST additionally carry the "moveOn" Category. Without these, an
 // LRS will accept the statement as an arbitrary xAPI verb but won't roll it
 // up into cmi5 lifecycle state — the LMS never sees the AU as completed.
-const CMI5_CATEGORY_CMI5 =
-  'https://w3id.org/xapi/cmi5/context/categories/cmi5';
+const CMI5_CATEGORY_CMI5 = 'https://w3id.org/xapi/cmi5/context/categories/cmi5';
 const CMI5_CATEGORY_MOVEON =
   'https://w3id.org/xapi/cmi5/context/categories/moveon';
 
-export type CMI5MoveOn =
-  | 'Passed'
-  | 'Completed'
-  | 'CompletedAndPassed'
-  | 'CompletedOrPassed'
-  | 'NotApplicable';
-
-const VALID_MOVE_ON: ReadonlySet<CMI5MoveOn> = new Set([
-  'Passed',
-  'Completed',
-  'CompletedAndPassed',
-  'CompletedOrPassed',
-  'NotApplicable',
-]);
-
 /** cmi5 §10.2.2 — launch mode dictates which Defined Statements the AU may emit. */
 export type CMI5LaunchMode = 'Normal' | 'Browse' | 'Review';
 const VALID_LAUNCH_MODE: ReadonlySet<CMI5LaunchMode> = new Set([
@@ -87,31 +72,24 @@ interface CMI5LaunchData {
   };
   launchMode?: CMI5LaunchMode;
   launchMethod?: 'OwnWindow' | 'AnyWindow';
-  launchParameters?: string;
   returnURL?: string;
   masteryScore?: number;
-  moveOn?: CMI5MoveOn;
   entitlementKey?: Record<string, string>;
   [k: string]: unknown;
 }
 
-/** cmi5 §11.1 Learner Preferences Agent Profile document. */
-interface CMI5LearnerPreferences {
-  languagePreference?: string;
-  audioPreference?: 'on' | 'off';
-  [k: string]: unknown;
-}
-
 /** `.then` handler that warns on LRS non-2xx. Publisher resolves successfully on 4xx/5xx (failure is in the outcome), so `.catch` alone misses them. */
 function warnOnLRSReject(
-  verbName: string
-): (res: { destinations?: Array<{ ok?: boolean; status?: number; error?: Error }> }) => void {
+  verbName: string,
+): (res: {
+  destinations?: Array<{ ok?: boolean; status?: number; error?: Error }>;
+}) => void {
   return (res) => {
     const dest = res.destinations?.[0];
     if (dest && !dest.ok) {
       console.warn(
         `Tessera cmi5: ${verbName} statement rejected by LRS (${dest.status ?? 'network error'})`,
-        dest.error
+        dest.error,
       );
     }
   };
@@ -148,10 +126,8 @@ export class CMI5Adapter implements PersistenceAdapter {
   #terminated = false;
 
   // cmi5 §8 launch params. masteryScore (when present) overrides the
-  // course's manifest passingScore for this launch — the LMS is the
-  // authority. moveOn drives the optional Satisfied statement (§9.5.3).
+  // course's manifest passingScore for this launch — the LMS is the authority.
   #masteryScore: number | null = null;
-  #moveOn: CMI5MoveOn = 'NotApplicable';
 
   // cmi5 §10 LMS.LaunchData. `contextTemplate` is the AU's base context
   // (§9.6.2) — Publisher Activity and session id live there, and strict
@@ -161,10 +137,6 @@ export class CMI5Adapter implements PersistenceAdapter {
   #launchMode: CMI5LaunchMode = 'Normal';
   /** cmi5 §10.2.6 — AU redirects here on `exit()`. */
   #returnURL: string | undefined;
-  /** cmi5 §10.2.3 — opaque per-launch content config string. */
-  #launchParameters: string | undefined;
-  /** cmi5 §11.1 Learner Preferences. */
-  #learnerPreferences: CMI5LearnerPreferences | null = null;
 
   async init(): Promise<void> {
     const params = new URLSearchParams(window.location.search);
@@ -184,18 +156,7 @@ export class CMI5Adapter implements PersistenceAdapter {
         this.#masteryScore = m;
       } else {
         console.warn(
-          `Tessera cmi5: launch parameter 'masteryScore' is not a decimal in [0,1] (got "${rawMastery}"); ignoring.`
-        );
-      }
-    }
-
-    const rawMoveOn = params.get('moveOn');
-    if (rawMoveOn !== null && rawMoveOn !== '') {
-      if (VALID_MOVE_ON.has(rawMoveOn as CMI5MoveOn)) {
-        this.#moveOn = rawMoveOn as CMI5MoveOn;
-      } else {
-        console.warn(
-          `Tessera cmi5: launch parameter 'moveOn' is not a recognized value (got "${rawMoveOn}"); defaulting to NotApplicable.`
+          `Tessera cmi5: launch parameter 'masteryScore' is not a decimal in [0,1] (got "${rawMastery}"); ignoring.`,
         );
       }
     }
@@ -212,7 +173,8 @@ export class CMI5Adapter implements PersistenceAdapter {
       this.#actor = parsed as XAPIAgent;
     } catch (err) {
       throw new Error(
-        `Tessera cmi5: launch parameter 'actor' is malformed (${err instanceof Error ? err.message : String(err)}). The LMS did not send a valid Identified Agent JSON.`
+        `Tessera cmi5: launch parameter 'actor' is malformed (${err instanceof Error ? err.message : String(err)}). The LMS did not send a valid Identified Agent JSON.`,
+        { cause: err },
       );
     }
 
@@ -221,7 +183,7 @@ export class CMI5Adapter implements PersistenceAdapter {
     // Fail loud at launch instead of dribbling errors per statement.
     if (!fetchUrl) {
       throw new Error(
-        "Tessera cmi5: launch parameter 'fetch' is missing. Cannot acquire LMS auth token."
+        "Tessera cmi5: launch parameter 'fetch' is missing. Cannot acquire LMS auth token.",
       );
     }
     let resp: Response;
@@ -229,12 +191,13 @@ export class CMI5Adapter implements PersistenceAdapter {
       resp = await fetch(fetchUrl, { method: 'POST' });
     } catch (err) {
       throw new Error(
-        `Tessera cmi5: fetch token request failed (${err instanceof Error ? err.message : String(err)}). The cmi5 launch fetch URL is single-use; reload from the LMS to retry.`
+        `Tessera cmi5: fetch token request failed (${err instanceof Error ? err.message : String(err)}). The cmi5 launch fetch URL is single-use; reload from the LMS to retry.`,
+        { cause: err },
       );
     }
     if (!resp.ok) {
       throw new Error(
-        `Tessera cmi5: fetch token request returned ${resp.status}. The cmi5 launch fetch URL is single-use; reload from the LMS to retry.`
+        `Tessera cmi5: fetch token request returned ${resp.status}. The cmi5 launch fetch URL is single-use; reload from the LMS to retry.`,
       );
     }
     const text = (await resp.text()).trim();
@@ -255,15 +218,21 @@ export class CMI5Adapter implements PersistenceAdapter {
         if (typeof obj['auth-token'] === 'string') {
           token = (obj['auth-token'] as string).trim();
         } else {
-          const code = typeof obj['error-code'] === 'string' ? obj['error-code'] : undefined;
-          const errText = typeof obj['error-text'] === 'string' ? obj['error-text'] : undefined;
+          const code =
+            typeof obj['error-code'] === 'string'
+              ? obj['error-code']
+              : undefined;
+          const errText =
+            typeof obj['error-text'] === 'string'
+              ? obj['error-text']
+              : undefined;
           const detail =
             code !== undefined || errText !== undefined
               ? ` (error-code=${code ?? 'unknown'}${errText ? `: ${errText}` : ''})`
               : '';
           throw new Error(
             `Tessera cmi5: fetch URL returned a JSON response without an 'auth-token' field${detail}. ` +
-              'The cmi5 fetch URL is single-use (§8.2.3.1); reload from the LMS to obtain a fresh launch.'
+              'The cmi5 fetch URL is single-use (§8.2.3.1); reload from the LMS to obtain a fresh launch.',
           );
         }
       }
@@ -274,15 +243,15 @@ export class CMI5Adapter implements PersistenceAdapter {
     this.#authToken = token;
     if (!this.#authToken) {
       throw new Error(
-        'Tessera cmi5: fetch token request returned an empty token. Expected a JSON body of the form {"auth-token": "..."}.'
+        'Tessera cmi5: fetch token request returned an empty token. Expected a JSON body of the form {"auth-token": "..."}.',
       );
     }
 
     // cmi5 §10 — LaunchData is the only spec-defined channel for the
     // session id (§9.6.3.1) and Publisher Activity (§9.6.2.3) the LRS
-    // validates against, plus launchMode/returnURL/launchParameters/
-    // masteryScore/moveOn (§10.2). LaunchData values override the URL
-    // masteryScore parsed earlier (§10.2.4 makes it authoritative).
+    // validates against, plus launchMode/returnURL/masteryScore (§10.2).
+    // LaunchData values override the URL masteryScore parsed earlier
+    // (§10.2.4 makes it authoritative).
     this.#launchData = await this.#fetchLaunchData();
     const tmpl = this.#launchData?.contextTemplate ?? {};
     let sessionId: string | undefined;
@@ -303,9 +272,6 @@ export class CMI5Adapter implements PersistenceAdapter {
       ) {
         this.#returnURL = this.#launchData.returnURL;
       }
-      if (typeof this.#launchData.launchParameters === 'string') {
-        this.#launchParameters = this.#launchData.launchParameters;
-      }
       if (
         typeof this.#launchData.masteryScore === 'number' &&
         Number.isFinite(this.#launchData.masteryScore) &&
@@ -314,18 +280,12 @@ export class CMI5Adapter implements PersistenceAdapter {
       ) {
         this.#masteryScore = this.#launchData.masteryScore;
       }
-      if (
-        typeof this.#launchData.moveOn === 'string' &&
-        VALID_MOVE_ON.has(this.#launchData.moveOn)
-      ) {
-        this.#moveOn = this.#launchData.moveOn;
-      }
     }
 
     // cmi5 §11 — fetch the Agent Profile BEFORE Initialized. Strict
     // LRSes track the GET and reject Initialized otherwise. A 404 here
     // is legitimate (no prefs set); the GET itself is what's required.
-    this.#learnerPreferences = await this.#fetchLearnerPreferences();
+    await this.#fetchLearnerPreferences();
 
     this.#publisher = new XAPIPublisher({
       endpoint: this.#endpoint,
@@ -361,12 +321,12 @@ export class CMI5Adapter implements PersistenceAdapter {
         this.#state = await resp.json();
       } else if (resp.status !== 404) {
         console.warn(
-          `Tessera cmi5: State API GET returned ${resp.status}; resume disabled for this launch.`
+          `Tessera cmi5: State API GET returned ${resp.status}; resume disabled for this launch.`,
         );
       }
     } catch (err) {
       console.warn(
-        `Tessera cmi5: State API GET failed (${err instanceof Error ? err.message : String(err)}); resume disabled for this launch.`
+        `Tessera cmi5: State API GET failed (${err instanceof Error ? err.message : String(err)}); resume disabled for this launch.`,
       );
       this.#state = null;
     }
@@ -391,31 +351,11 @@ export class CMI5Adapter implements PersistenceAdapter {
     return this.#masteryScore;
   }
 
-  /** LMS-supplied moveOn criterion (defaults to "NotApplicable"). */
-  getMoveOn(): CMI5MoveOn {
-    return this.#moveOn;
-  }
-
   /** cmi5 §10.2.2 — "Normal" is the only mode where progress-bearing Defined Statements are permitted. */
   getLaunchMode(): CMI5LaunchMode {
     return this.#launchMode;
   }
 
-  /** cmi5 §10.2.6 — URL the AU navigates to on `exit()`. Returns undefined when the LMS didn't supply one. */
-  getReturnURL(): string | undefined {
-    return this.#returnURL;
-  }
-
-  /** cmi5 §10.2.3 — opaque per-launch content-config string. */
-  getLaunchParameters(): string | undefined {
-    return this.#launchParameters;
-  }
-
-  /** cmi5 §11.1 Learner Preferences. Null when the LMS didn't publish one. */
-  getLearnerPreferences(): CMI5LearnerPreferences | null {
-    return this.#learnerPreferences;
-  }
-
   getState(): SavedState | null {
     return this.#state;
   }
@@ -425,7 +365,7 @@ export class CMI5Adapter implements PersistenceAdapter {
     if (!this.#publisher) return;
     // Chain the State PUT onto the publisher's queue so it lands before
     // Terminated. We can't use sendStatement here (different URL/verb).
-    this.#publisher.chainTask(async () => {
+    void this.#publisher.chainTask(async () => {
       try {
         const resp = await this.#xapiFetch(this.#buildStateUrl(), {
           method: 'PUT',
@@ -434,7 +374,7 @@ export class CMI5Adapter implements PersistenceAdapter {
         });
         if (!resp.ok) {
           console.warn(
-            `Tessera cmi5: State API PUT returned ${resp.status}; learner progress did not persist.`
+            `Tessera cmi5: State API PUT returned ${resp.status}; learner progress did not persist.`,
           );
         }
       } catch (err) {
@@ -455,7 +395,7 @@ export class CMI5Adapter implements PersistenceAdapter {
 
   seedLifecycle(
     completion: 'incomplete' | 'complete',
-    success: 'unknown' | 'passed' | 'failed'
+    success: 'unknown' | 'passed' | 'failed',
   ): void {
     if (completion === 'complete') this.#completedEmitted = true;
     if (success === 'passed' || success === 'failed') {
@@ -464,7 +404,8 @@ export class CMI5Adapter implements PersistenceAdapter {
   }
 
   setCompletionStatus(status: 'incomplete' | 'complete'): void {
-    if (status !== 'complete' || this.#completedEmitted || !this.#publisher) return;
+    if (status !== 'complete' || this.#completedEmitted || !this.#publisher)
+      return;
     // cmi5 §10.2.2 — Browse/Review launches MUST NOT emit Completed.
     if (this.#launchMode !== 'Normal') return;
     this.#completedEmitted = true;
@@ -505,14 +446,16 @@ export class CMI5Adapter implements PersistenceAdapter {
       // The author asserted the verb, so on contradiction we keep the
       // verb and drop the score (and warn).
       if (this.#masteryScore !== null) {
-        const violatesPassed = status === 'passed' && scaled < this.#masteryScore;
-        const violatesFailed = status === 'failed' && scaled >= this.#masteryScore;
+        const violatesPassed =
+          status === 'passed' && scaled < this.#masteryScore;
+        const violatesFailed =
+          status === 'failed' && scaled >= this.#masteryScore;
         if (violatesPassed || violatesFailed) {
           console.warn(
             `Tessera cmi5: refusing to attach scaled score ${scaled.toFixed(3)} to ` +
               `${status === 'passed' ? 'Passed' : 'Failed'} (masteryScore=${this.#masteryScore}); ` +
               `per cmi5 §9.3.${status === 'passed' ? '4' : '5'} the score would contradict the verb. ` +
-              `Statement will be sent without a score.`
+              `Statement will be sent without a score.`,
           );
         } else {
           result.score = { scaled };
@@ -545,7 +488,7 @@ export class CMI5Adapter implements PersistenceAdapter {
   reportInteraction(
     questionId: string,
     interaction: Interaction,
-    correct: boolean | null
+    correct: boolean | null,
   ): void {
     if (!this.#publisher) return;
     const response = formatResponse(interaction, XAPI_INTERACTION_FORMAT);
@@ -637,10 +580,13 @@ export class CMI5Adapter implements PersistenceAdapter {
    * for Passed/Failed (§9.6.3.2).
    */
   #cmi5Context(
-    opts: { moveOn?: boolean; mastery?: boolean } = {}
+    opts: { moveOn?: boolean; mastery?: boolean } = {},
   ): Record<string, unknown> {
     const tmpl = this.#launchData?.contextTemplate ?? {};
-    const tmplActivities = (tmpl.contextActivities ?? {}) as Record<string, unknown>;
+    const tmplActivities = (tmpl.contextActivities ?? {}) as Record<
+      string,
+      unknown
+    >;
 
     // Concat-dedupe category to preserve any template-supplied entries
     // (§10.2.1 forbids overwriting them).
@@ -652,8 +598,14 @@ export class CMI5Adapter implements PersistenceAdapter {
         category.push({ id, objectType: 'Activity' });
       }
     };
-    const templateCategory = Array.isArray((tmplActivities as { category?: unknown }).category)
-      ? ((tmplActivities as { category: Array<{ id: string; objectType?: string }> }).category)
+    const templateCategory = Array.isArray(
+      (tmplActivities as { category?: unknown }).category,
+    )
+      ? (
+          tmplActivities as {
+            category: Array<{ id: string; objectType?: string }>;
+          }
+        ).category
       : [];
     for (const c of templateCategory) {
       if (c && typeof c.id === 'string') push(c.id);
@@ -715,35 +667,35 @@ export class CMI5Adapter implements PersistenceAdapter {
       console.warn(
         `Tessera cmi5: LMS.LaunchData State GET returned ${resp.status}; ` +
           'cmi5 Defined Statements may be rejected by strict LRSes ' +
-          '(missing Publisher Activity / session id).'
+          '(missing Publisher Activity / session id).',
       );
     } catch (err) {
       console.warn(
-        `Tessera cmi5: LMS.LaunchData State GET failed (${err instanceof Error ? err.message : String(err)}).`
+        `Tessera cmi5: LMS.LaunchData State GET failed (${err instanceof Error ? err.message : String(err)}).`,
       );
     }
     return null;
   }
 
-  /** GET cmi5 §11.1 Learner Preferences. 404 is normal (no prefs set). */
-  async #fetchLearnerPreferences(): Promise<CMI5LearnerPreferences | null> {
+  /**
+   * GET cmi5 §11.1 Learner Preferences. The GET itself is the §11
+   * obligation (it must precede Initialized); the response body is not
+   * consumed. 404 is normal (no prefs set).
+   */
+  async #fetchLearnerPreferences(): Promise<void> {
     try {
       const url = this.#buildAgentProfileUrl(CMI5_LEARNER_PREFS_PROFILE_ID);
       const resp = await this.#xapiFetch(url, { method: 'GET' });
-      if (resp.ok) {
-        return (await resp.json()) as CMI5LearnerPreferences;
-      }
-      if (resp.status !== 404) {
+      if (!resp.ok && resp.status !== 404) {
         console.warn(
-          `Tessera cmi5: Agent Profile GET (cmi5LearnerPreferences) returned ${resp.status}.`
+          `Tessera cmi5: Agent Profile GET (cmi5LearnerPreferences) returned ${resp.status}.`,
         );
       }
     } catch (err) {
       console.warn(
-        `Tessera cmi5: Agent Profile GET (cmi5LearnerPreferences) failed (${err instanceof Error ? err.message : String(err)}).`
+        `Tessera cmi5: Agent Profile GET (cmi5LearnerPreferences) failed (${err instanceof Error ? err.message : String(err)}).`,
       );
     }
-    return null;
   }
 
   async #xapiFetch(url: string, options: RequestInit = {}): Promise<Response> {

package/src/runtime/adapters/format.ts

@@ -0,0 +1,67 @@
+/**
+ * Time / number formatters for SCORM & cmi5 data-model writes.
+ */
+
+/**
+ * Format integer seconds as SCORM 1.2 `CMITimespan` (HHHH:MM:SS.SS).
+ *
+ * `DurationTracker.sessionSeconds` always feeds integer seconds via
+ * `Math.floor`, so the centisecond field is always `.00`. The format
+ * still includes it because `CMITimespan` is defined that way and some
+ * older LMS importers reject the bare HHHH:MM:SS form.
+ */
+export function formatHHMMSS(totalSeconds: number): string {
+  const whole = Math.floor(totalSeconds);
+  const hours = Math.floor(whole / 3600);
+  const minutes = Math.floor((whole % 3600) / 60);
+  const seconds = whole % 60;
+  const hh = String(hours).padStart(4, '0');
+  const mm = String(minutes).padStart(2, '0');
+  const ss = String(seconds).padStart(2, '0');
+  return `${hh}:${mm}:${ss}.00`;
+}
+
+/**
+ * SCORM 2004 4E §4.2/§4.3 define CMIDecimal-like elements as real(10,7) —
+ * `String(1/3)` exceeds that and trips SCORM Cloud with error 406. Rounds,
+ * then trims trailing zeros (no padded "0.8500000" forms).
+ */
+export function formatReal107(value: number): string {
+  if (!Number.isFinite(value)) return '0';
+  const rounded = Math.round(value * 1e7) / 1e7;
+  return rounded
+    .toFixed(7)
+    .replace(/(\.\d*?)0+$/, '$1')
+    .replace(/\.$/, '');
+}
+
+/**
+ * SCORM 2004 4E §3.3.10.1 references ISO 8601 §5.3.3 — local date+time, no
+ * zone designator. Strict validators reject `Z`, `±hh:mm`, and fractional
+ * seconds with error 406. UTC components are used so writes don't drift
+ * across local-TZ flips even though the format is zone-free.
+ */
+export function formatISO8601Timestamp(date: Date): string {
+  const yyyy = date.getUTCFullYear();
+  const mm = String(date.getUTCMonth() + 1).padStart(2, '0');
+  const dd = String(date.getUTCDate()).padStart(2, '0');
+  const hh = String(date.getUTCHours()).padStart(2, '0');
+  const mi = String(date.getUTCMinutes()).padStart(2, '0');
+  const ss = String(date.getUTCSeconds()).padStart(2, '0');
+  return `${yyyy}-${mm}-${dd}T${hh}:${mi}:${ss}`;
+}
+
+/**
+ * Format seconds as ISO 8601 duration: PT1H30M45S
+ */
+export function formatISO8601Duration(totalSeconds: number): string {
+  const hours = Math.floor(totalSeconds / 3600);
+  const minutes = Math.floor((totalSeconds % 3600) / 60);
+  const seconds = totalSeconds % 60;
+
+  let result = 'PT';
+  if (hours > 0) result += `${hours}H`;
+  if (minutes > 0) result += `${minutes}M`;
+  if (seconds > 0 || result === 'PT') result += `${seconds}S`;
+  return result;
+}

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".`,
   );
 }
 
@@ -60,40 +60,51 @@ export interface CreateAdapterOptions {
  * In dev mode, missing APIs warn and fall back to `WebAdapter` so authors
  * can still iterate locally.
  */
+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 }
+> = {
+  scorm12: {
+    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;
+    },
+    label: 'SCORM 2004 API',
+  },
+  cmi5: {
+    detect: () => (hasCMI5LaunchParams() ? new CMI5Adapter() : null),
+    label: 'cmi5 launch parameters',
+  },
+};
+
 export function createAdapter(
   config: CourseConfig,
-  options: CreateAdapterOptions = {}
+  options: CreateAdapterOptions = {},
 ): PersistenceAdapter {
-  const allowFallback =
-    options.allowFallback ?? import.meta.env?.DEV === true;
-  switch (config.export?.standard) {
-    case 'scorm12': {
-      const api = findSCORM12API();
-      if (api) return new SCORM12Adapter(api);
-      if (!allowFallback) throw missingApiError('scorm12');
-      console.warn(
-        'Tessera (dev): SCORM 1.2 API not found — falling back to localStorage'
-      );
-      return new WebAdapter(config);
-    }
-    case 'scorm2004': {
-      const api = findSCORM2004API();
-      if (api) return new SCORM2004Adapter(api);
-      if (!allowFallback) throw missingApiError('scorm2004');
-      console.warn(
-        'Tessera (dev): SCORM 2004 API not found — falling back to localStorage'
-      );
-      return new WebAdapter(config);
-    }
-    case 'cmi5': {
-      if (hasCMI5LaunchParams()) return new CMI5Adapter();
-      if (!allowFallback) throw missingApiError('cmi5');
-      console.warn(
-        'Tessera (dev): cmi5 launch parameters not found — falling back to localStorage'
-      );
-      return new WebAdapter(config);
-    }
-    default:
-      return new WebAdapter(config);
+  const allowFallback = options.allowFallback ?? import.meta.env?.DEV === true;
+  const standard = config.export?.standard;
+  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`,
+    );
   }
+  return new WebAdapter(config);
 }