tessera-learn 0.0.10 → 0.0.13

package/src/runtime/xapi/client.ts

@@ -43,7 +43,7 @@ export class XAPIClient {
    */
   sendStatement(
     partial: PartialStatement,
-    options?: SendStatementOptions
+    options?: SendStatementOptions,
   ): Promise<SendStatementResult> {
     try {
       validatePartialStatement(partial);
@@ -59,8 +59,8 @@ export class XAPIClient {
     if (this.#publishers.every(blocked)) {
       return Promise.reject(
         new XAPIConfigError(
-          'XAPIClient.sendStatement: page is unloading; author statements queued during unload are dropped to keep Terminated last (cmi5 §9.3.6).'
-        )
+          'XAPIClient.sendStatement: page is unloading; author statements queued during unload are dropped to keep Terminated last (cmi5 §9.3.6).',
+        ),
       );
     }
     const id = uuidv4();
@@ -80,9 +80,9 @@ export class XAPIClient {
             endpoint: pub.getEndpoint(),
             ok: false,
             error: new XAPIConfigError(
-              'destination skipped: cmi5 publisher is unloading; statement dropped to keep Terminated last (cmi5 §9.3.6).'
+              'destination skipped: cmi5 publisher is unloading; statement dropped to keep Terminated last (cmi5 §9.3.6).',
             ),
-          })
+          }),
         );
         continue;
       }

package/src/runtime/xapi/derive-actor.ts

@@ -39,7 +39,7 @@ export function defaultAccountHomePage(activityId: string): string | null {
 export function synthesizeSCORM12Actor(
   api: SCORM12API,
   activityId: string,
-  actorAccountHomePage?: string
+  actorAccountHomePage?: string,
 ): XAPIAgent | null {
   let id = '';
   let name = '';
@@ -68,7 +68,7 @@ export function synthesizeSCORM12Actor(
 export function synthesizeSCORM2004Actor(
   api: SCORM2004API,
   activityId: string,
-  actorAccountHomePage?: string
+  actorAccountHomePage?: string,
 ): XAPIAgent | null {
   let id = '';
   let name = '';

package/src/runtime/xapi/publisher.ts

@@ -12,8 +12,8 @@ import {
   validatePartialStatement,
   validateAgent,
   validateAuthCredential,
+  joinFieldError,
   XAPIConfigError,
-  XAPIStatementError,
 } from './validation.js';
 import { RETRY_ATTEMPTS, backoffMs } from '../adapters/retry.js';
 
@@ -21,16 +21,6 @@ import { RETRY_ATTEMPTS, backoffMs } from '../adapters/retry.js';
 const CMI5_SESSIONID_EXT =
   'https://w3id.org/xapi/cmi5/context/extensions/sessionid';
 
-/**
- * Combine a field label (e.g. `xapi.actor`) with the prefix-friendly suffix
- * returned by `validateAgent`. Sub-field suffixes start with `.` and chain
- * directly (`xapi.actor.mbox …`); top-level messages get a `: ` separator
- * (`xapi.actor: must be an object`).
- */
-function joinFieldError(label: string, suffix: string): string {
-  return suffix.startsWith('.') ? `${label}${suffix}` : `${label}: ${suffix}`;
-}
-
 export interface XAPIPublisherOptions {
   /** Resolved http(s) endpoint URL. The 'lms' sentinel is a config-layer concept and never reaches the publisher. */
   endpoint: string;
@@ -137,7 +127,7 @@ export class XAPIPublisher {
     }
     if (!/^https?:\/\//i.test(opts.endpoint)) {
       throw new XAPIConfigError(
-        'XAPIPublisher: endpoint must be an absolute http(s) URL'
+        'XAPIPublisher: endpoint must be an absolute http(s) URL',
       );
     }
     if (!opts.activityId) {
@@ -183,7 +173,7 @@ export class XAPIPublisher {
         resolved = await this.#actorValue();
       } catch (err) {
         throw new XAPIConfigError(
-          `xapi.actor resolver threw: ${err instanceof Error ? err.message : String(err)}`
+          `xapi.actor resolver threw: ${err instanceof Error ? err.message : String(err)}`,
         );
       }
       const err = validateAgent(resolved);
@@ -209,7 +199,7 @@ export class XAPIPublisher {
   getActor(): XAPIAgent {
     if (!this.#cachedActor) {
       throw new XAPIConfigError(
-        'XAPIPublisher.getActor() called before init() resolved. Await publisher.init() before reading the actor.'
+        'XAPIPublisher.getActor() called before init() resolved. Await publisher.init() before reading the actor.',
       );
     }
     return this.#cachedActor;
@@ -241,7 +231,7 @@ export class XAPIPublisher {
   buildStatement(partial: PartialStatement, opts?: { id?: string }): Statement {
     if (!this.#cachedActor) {
       throw new XAPIConfigError(
-        'XAPIPublisher.buildStatement() called before init() resolved.'
+        'XAPIPublisher.buildStatement() called before init() resolved.',
       );
     }
     const userCtx = partial.context ?? {};
@@ -284,7 +274,8 @@ export class XAPIPublisher {
       timestamp: new Date().toISOString(),
     };
     if (partial.result !== undefined) statement.result = partial.result;
-    if (partial.attachments !== undefined) statement.attachments = partial.attachments;
+    if (partial.attachments !== undefined)
+      statement.attachments = partial.attachments;
     return statement;
   }
 
@@ -299,7 +290,7 @@ export class XAPIPublisher {
    */
   sendStatement(
     partial: PartialStatement,
-    options?: SendStatementOptions & { id?: string }
+    options?: SendStatementOptions & { id?: string },
   ): Promise<SendStatementResult> {
     if (this.#unavailableReason) {
       return Promise.reject(this.#unavailableReason());
@@ -316,8 +307,8 @@ export class XAPIPublisher {
     if (!this.#cachedActor) {
       return Promise.reject(
         new XAPIConfigError(
-          'XAPIPublisher.sendStatement() called before init() resolved.'
-        )
+          'XAPIPublisher.sendStatement() called before init() resolved.',
+        ),
       );
     }
     const statement = this.buildStatement(partial, { id: options?.id });
@@ -336,7 +327,7 @@ export class XAPIPublisher {
    */
   enqueueBuilt(
     statementOrBatch: Statement | Statement[],
-    options?: SendStatementOptions
+    options?: SendStatementOptions,
   ): Promise<DestinationOutcome> {
     if (this.#unavailableReason) {
       return Promise.reject(this.#unavailableReason());
@@ -346,7 +337,7 @@ export class XAPIPublisher {
         endpoint: this.#endpoint,
         ok: false,
         error: new XAPIConfigError(
-          `XAPIPublisher queue saturated (${this.#queueDepth} in-flight); refusing further sends until the LRS catches up.`
+          `XAPIPublisher queue saturated (${this.#queueDepth} in-flight); refusing further sends until the LRS catches up.`,
         ),
       });
     }
@@ -355,7 +346,7 @@ export class XAPIPublisher {
       console.warn(
         `Tessera: xAPI publisher queue depth ${this.#queueDepth} (>= ${QUEUE_DEPTH_WARN}). ` +
           `Each pending statement is retained in the promise chain's closure until it drains; ` +
-          `consider rate-limiting authoring sends or batching before sendStatement.`
+          `consider rate-limiting authoring sends or batching before sendStatement.`,
       );
     }
     this.#queueDepth++;
@@ -377,7 +368,7 @@ export class XAPIPublisher {
           status: outcome.status,
           error: outcome.error,
         });
-      })
+      }),
     );
     return outcomePromise;
   }
@@ -395,7 +386,9 @@ export class XAPIPublisher {
       resolveTask = r;
     });
     this.#queue = this.#queue.then(() =>
-      fn().catch(() => {}).then(() => resolveTask())
+      fn()
+        .catch(() => {})
+        .then(() => resolveTask()),
     );
     return taskPromise;
   }
@@ -423,7 +416,7 @@ export class XAPIPublisher {
 
   #sendWithRetry(
     statementOrBatch: Statement | Statement[],
-    options?: SendStatementOptions
+    options?: SendStatementOptions,
   ): Promise<SendOutcome> {
     const body = JSON.stringify(statementOrBatch);
     const retry = options?.retry !== false; // default: retry enabled
@@ -442,7 +435,7 @@ export class XAPIPublisher {
           `Tessera: xAPI ${count}-statement batch is ${body.length} bytes, ` +
             `over the 64 KiB keepalive cap. The browser may silently drop this ` +
             `request during unload. Reduce per-statement size or split sends ` +
-            `before terminate.`
+            `before terminate.`,
         );
       }
       return this.#sendOnce(body, keepalive).then((outcome) => {
@@ -457,9 +450,9 @@ export class XAPIPublisher {
           return outcome;
         }
         if (isFinal) return outcome;
-        return new Promise<void>((r) =>
-          setTimeout(r, backoffMs(n))
-        ).then(() => attempt(n + 1));
+        return new Promise<void>((r) => setTimeout(r, backoffMs(n))).then(() =>
+          attempt(n + 1),
+        );
       });
     };
 
@@ -471,7 +464,7 @@ export class XAPIPublisher {
       return Promise.resolve({
         ok: false,
         error: new XAPIConfigError(
-          'xapi.auth was rejected by the LRS twice in a row; refusing further sends for the publisher lifetime. Reload the runtime to retry.'
+          'xapi.auth was rejected by the LRS twice in a row; refusing further sends for the publisher lifetime. Reload the runtime to retry.',
         ),
       });
     }
@@ -492,7 +485,7 @@ export class XAPIPublisher {
   #fetchWithToken(
     token: string,
     body: string,
-    keepalive: boolean
+    keepalive: boolean,
   ): Promise<SendOutcome> {
     const headers = new Headers();
     if (token) headers.set('Authorization', `Basic ${token}`);
@@ -514,7 +507,7 @@ export class XAPIPublisher {
   #handleResponse(
     resp: Response,
     body: string,
-    keepalive: boolean
+    keepalive: boolean,
   ): Promise<SendOutcome> | SendOutcome {
     if (resp.ok || resp.status === 409) {
       return { ok: true, status: resp.status };
@@ -550,7 +543,7 @@ export class XAPIPublisher {
               ok: false,
               status: 401,
               error: new Error(
-                'LRS rejected re-resolved auth (consecutive 401s); auth resolver marked dead'
+                'LRS rejected re-resolved auth (consecutive 401s); auth resolver marked dead',
               ),
             };
           }
@@ -565,7 +558,7 @@ export class XAPIPublisher {
             ok: false,
             status: 401,
             error: err instanceof Error ? err : new Error(String(err)),
-          })
+          }),
         );
     }
     // Append the LRS body to the error message so callers see the
@@ -583,14 +576,14 @@ export class XAPIPublisher {
         ok: false,
         status: resp.status,
         error: new Error(
-          `LRS responded ${resp.status}${respBody ? `: ${respBody.slice(0, 500)}` : ''}`
+          `LRS responded ${resp.status}${respBody ? `: ${respBody.slice(0, 500)}` : ''}`,
         ),
       }),
       (): SendOutcome => ({
         ok: false,
         status: resp.status,
         error: new Error(`LRS responded ${resp.status}`),
-      })
+      }),
     );
   }
 
@@ -603,7 +596,8 @@ export class XAPIPublisher {
       // where the LMS fetch URL produced no token); otherwise revalidate.
       if (this.#authValue.length > 0) {
         const err = validateAuthCredential(this.#authValue);
-        if (err) return Promise.reject(new XAPIConfigError(`xapi.auth: ${err}`));
+        if (err)
+          return Promise.reject(new XAPIConfigError(`xapi.auth: ${err}`));
       }
       this.#cachedAuth = this.#authValue;
       return Promise.resolve(this.#cachedAuth);
@@ -613,7 +607,7 @@ export class XAPIPublisher {
       .then((resolved) => {
         if (typeof resolved !== 'string' || !resolved) {
           throw new XAPIConfigError(
-            'xapi.auth resolver must return a non-empty string'
+            'xapi.auth resolver must return a non-empty string',
           );
         }
         const err = validateAuthCredential(resolved);
@@ -624,9 +618,8 @@ export class XAPIPublisher {
       .catch((err) => {
         if (err instanceof XAPIConfigError) throw err;
         throw new XAPIConfigError(
-          `xapi.auth resolver threw: ${err instanceof Error ? err.message : String(err)}`
+          `xapi.auth resolver threw: ${err instanceof Error ? err.message : String(err)}`,
         );
       });
   }
 }
-

package/src/runtime/xapi/setup.ts

@@ -34,8 +34,8 @@ class XAPIDevFallbackError extends Error {
       "Tessera xAPI: xapi.endpoint is 'lms' but no cmi5 launch parameters " +
         '(fetch / endpoint / activityId / actor) were present on the URL. ' +
         'Either launch this course from a real LMS / SCORM Cloud, or ' +
-        "temporarily change xapi.endpoint to an explicit URL pointed at a " +
-        'local LRS (e.g. http://localhost:8080/data/xAPI/) for dev work.'
+        'temporarily change xapi.endpoint to an explicit URL pointed at a ' +
+        'local LRS (e.g. http://localhost:8080/data/xAPI/) for dev work.',
     );
     this.name = 'XAPIDevFallbackError';
   }
@@ -72,14 +72,14 @@ class XAPISCORMDevFallbackError extends Error {
         'destination. Either supply xapi.actor explicitly in course.config.js, or launch from ' +
         'a real LMS / SCORM Cloud where ' +
         (standard === 'scorm12' ? 'cmi.core.student_id' : 'cmi.learner_id') +
-        ' is populated.'
+        ' is populated.',
     );
     this.name = 'XAPISCORMDevFallbackError';
   }
 }
 
 function makeSCORMDevFallbackPublisher(
-  standard: 'scorm12' | 'scorm2004'
+  standard: 'scorm12' | 'scorm2004',
 ): XAPIPublisher {
   return makeRejectingPublisher(() => new XAPISCORMDevFallbackError(standard));
 }
@@ -93,13 +93,13 @@ function makeSCORMDevFallbackPublisher(
 function resolveDestination(
   entry: XAPIConfig,
   config: CourseConfig,
-  adapter: PersistenceAdapter | null
+  adapter: PersistenceAdapter | null,
 ): DestinationSource | null {
   if (entry.endpoint === 'lms') {
     if (config.export?.standard !== 'cmi5') {
       // Build-time validator should reject this; defense in depth at runtime.
       console.warn(
-        "Tessera xAPI: ignoring xapi entry with endpoint: 'lms' under non-cmi5 export."
+        "Tessera xAPI: ignoring xapi entry with endpoint: 'lms' under non-cmi5 export.",
       );
       return null;
     }
@@ -121,14 +121,17 @@ function resolveDestination(
     (actorOrResolver as { __scormDevFallback?: 'scorm12' | 'scorm2004' })
       .__scormDevFallback
   ) {
-    const std = (actorOrResolver as { __scormDevFallback: 'scorm12' | 'scorm2004' })
-      .__scormDevFallback;
+    const std = (
+      actorOrResolver as { __scormDevFallback: 'scorm12' | 'scorm2004' }
+    ).__scormDevFallback;
     return { kind: 'explicit', publisher: makeSCORMDevFallbackPublisher(std) };
   }
   const publisher = new XAPIPublisher({
     endpoint: explicit.endpoint,
     auth: explicit.auth,
-    actor: actorOrResolver as XAPIAgent | (() => XAPIAgent | Promise<XAPIAgent>),
+    actor: actorOrResolver as
+      | XAPIAgent
+      | (() => XAPIAgent | Promise<XAPIAgent>),
     activityId: explicit.activityId,
     registration: explicit.registration,
   });
@@ -145,7 +148,7 @@ function resolveDestination(
 function resolveExplicitActor(
   explicit: XAPIExplicitConfig,
   config: CourseConfig,
-  adapter: PersistenceAdapter | null
+  adapter: PersistenceAdapter | null,
 ):
   | XAPIAgent
   | (() => XAPIAgent | Promise<XAPIAgent>)
@@ -170,7 +173,7 @@ function resolveExplicitActor(
       return synthesizeSCORM12Actor(
         adapter.getAPI(),
         explicit.activityId,
-        explicit.actorAccountHomePage
+        explicit.actorAccountHomePage,
       );
     }
     // Adapter is the WebAdapter dev fallback. Mirror the cmi5 'lms'
@@ -184,14 +187,14 @@ function resolveExplicitActor(
       return synthesizeSCORM2004Actor(
         adapter.getAPI(),
         explicit.activityId,
-        explicit.actorAccountHomePage
+        explicit.actorAccountHomePage,
       );
     }
     return { __scormDevFallback: 'scorm2004' };
   }
   // Web export with no actor — build-time validator should have errored.
   console.warn(
-    'Tessera xAPI: explicit destination has no actor and no derivation source — skipping.'
+    'Tessera xAPI: explicit destination has no actor and no derivation source — skipping.',
   );
   return null;
 }
@@ -206,7 +209,7 @@ function resolveExplicitActor(
  */
 export async function buildXAPIClient(
   config: CourseConfig,
-  adapter: PersistenceAdapter | null
+  adapter: PersistenceAdapter | null,
 ): Promise<XAPIClient | null> {
   const raw = config.xapi;
   if (raw === undefined || raw === null) return null;
@@ -233,7 +236,7 @@ export async function buildXAPIClient(
       } catch (err) {
         console.warn(
           'Tessera xAPI: failed to initialize an explicit destination — skipping.',
-          err
+          err,
         );
       }
     }

package/src/runtime/xapi/validation.ts

@@ -1,5 +1,9 @@
 import type { PartialStatement } from './types.js';
-export { validateAgent, validateAuthCredential } from './agent-rules.js';
+export {
+  validateAgent,
+  validateAuthCredential,
+  joinFieldError,
+} from './agent-rules.js';
 
 /** Thrown for runtime-validation failures (auth/actor resolver misuse). */
 export class XAPIConfigError extends Error {
@@ -32,7 +36,7 @@ export function validatePartialStatement(partial: PartialStatement): void {
   if (!partial || typeof partial !== 'object') {
     throw new XAPIStatementError(
       'sendStatement: partial statement must be an object',
-      partial
+      partial,
     );
   }
   if (
@@ -43,7 +47,7 @@ export function validatePartialStatement(partial: PartialStatement): void {
   ) {
     throw new XAPIStatementError(
       'sendStatement: verb.id is required and must be a non-empty string',
-      partial
+      partial,
     );
   }
   if (partial.object !== undefined) {
@@ -55,16 +59,21 @@ export function validatePartialStatement(partial: PartialStatement): void {
     ) {
       throw new XAPIStatementError(
         'sendStatement: object.id must be a non-empty string when object is supplied',
-        partial
+        partial,
       );
     }
   }
   const scaled = partial.result?.score?.scaled;
   if (scaled !== undefined) {
-    if (typeof scaled !== 'number' || !Number.isFinite(scaled) || scaled < -1 || scaled > 1) {
+    if (
+      typeof scaled !== 'number' ||
+      !Number.isFinite(scaled) ||
+      scaled < -1 ||
+      scaled > 1
+    ) {
       throw new XAPIStatementError(
         `sendStatement: result.score.scaled must be a number in [-1, 1], got ${scaled}`,
-        partial
+        partial,
       );
     }
   }

package/src/virtual.d.ts

@@ -14,7 +14,10 @@ declare module 'virtual:tessera-xapi-setup' {
   import type { CourseConfig } from 'tessera-learn/runtime/types.js';
   import type { PersistenceAdapter } from 'tessera-learn/runtime/persistence.js';
   import type { XAPIClient } from 'tessera-learn/runtime/xapi/client.js';
-  export function buildXAPIClient(config: CourseConfig, adapter: PersistenceAdapter): Promise<XAPIClient | null>;
+  export function buildXAPIClient(
+    config: CourseConfig,
+    adapter: PersistenceAdapter,
+  ): Promise<XAPIClient | null>;
 }
 
 interface ImportMetaEnv {

package/styles/base.css

@@ -47,7 +47,12 @@ object {
 }
 
 /* ---- Typography ---- */
-h1, h2, h3, h4, h5, h6 {
+h1,
+h2,
+h3,
+h4,
+h5,
+h6 {
   font-weight: 700;
   line-height: 1.25;
   color: var(--tessera-text);
@@ -55,12 +60,24 @@ h1, h2, h3, h4, h5, h6 {
   margin-bottom: var(--tessera-spacing-md);
 }
 
-h1 { font-size: 2rem; }
-h2 { font-size: 1.625rem; }
-h3 { font-size: 1.375rem; }
-h4 { font-size: 1.125rem; }
-h5 { font-size: 1rem; }
-h6 { font-size: 0.875rem; }
+h1 {
+  font-size: 2rem;
+}
+h2 {
+  font-size: 1.625rem;
+}
+h3 {
+  font-size: 1.375rem;
+}
+h4 {
+  font-size: 1.125rem;
+}
+h5 {
+  font-size: 1rem;
+}
+h6 {
+  font-size: 0.875rem;
+}
 
 h1:first-child,
 h2:first-child,
@@ -90,16 +107,19 @@ a:focus-visible {
   border-radius: 2px;
 }
 
-strong, b {
+strong,
+b {
   font-weight: 700;
 }
 
-em, i {
+em,
+i {
   font-style: italic;
 }
 
 /* ---- Lists ---- */
-ul, ol {
+ul,
+ol {
   margin-bottom: var(--tessera-spacing-md);
   padding-left: var(--tessera-spacing-xl);
 }
@@ -170,7 +190,8 @@ table {
   font-size: 0.9375rem;
 }
 
-th, td {
+th,
+td {
   padding: var(--tessera-spacing-sm) var(--tessera-spacing-md);
   border: 1px solid var(--tessera-border);
   text-align: left;