tessera-learn 0.0.11 → 0.0.13

package/src/runtime/xapi/publisher.ts

@@ -127,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) {
@@ -173,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);
@@ -199,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;
@@ -231,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 ?? {};
@@ -274,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;
   }
 
@@ -289,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());
@@ -306,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 });
@@ -326,7 +327,7 @@ export class XAPIPublisher {
    */
   enqueueBuilt(
     statementOrBatch: Statement | Statement[],
-    options?: SendStatementOptions
+    options?: SendStatementOptions,
   ): Promise<DestinationOutcome> {
     if (this.#unavailableReason) {
       return Promise.reject(this.#unavailableReason());
@@ -336,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.`,
         ),
       });
     }
@@ -345,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++;
@@ -367,7 +368,7 @@ export class XAPIPublisher {
           status: outcome.status,
           error: outcome.error,
         });
-      })
+      }),
     );
     return outcomePromise;
   }
@@ -385,7 +386,9 @@ export class XAPIPublisher {
       resolveTask = r;
     });
     this.#queue = this.#queue.then(() =>
-      fn().catch(() => {}).then(() => resolveTask())
+      fn()
+        .catch(() => {})
+        .then(() => resolveTask()),
     );
     return taskPromise;
   }
@@ -413,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
@@ -432,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) => {
@@ -447,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),
+        );
       });
     };
 
@@ -461,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.',
         ),
       });
     }
@@ -482,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}`);
@@ -504,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 };
@@ -540,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',
               ),
             };
           }
@@ -555,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
@@ -573,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}`),
-      })
+      }),
     );
   }
 
@@ -593,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);
@@ -603,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);
@@ -614,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, joinFieldError } 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;

package/styles/layout.css

@@ -104,8 +104,9 @@
   background: none;
   cursor: pointer;
   text-align: left;
-  transition: background-color var(--tessera-transition-fast),
-              color var(--tessera-transition-fast);
+  transition:
+    background-color var(--tessera-transition-fast),
+    color var(--tessera-transition-fast);
   border-left: 3px solid transparent;
 }
 
@@ -114,19 +115,19 @@
   color: var(--tessera-text);
 }
 
-.tessera-nav-page[aria-current="page"] {
+.tessera-nav-page[aria-current='page'] {
   background-color: var(--tessera-primary-light);
   color: var(--tessera-primary-dark);
   font-weight: 600;
   border-left-color: var(--tessera-primary);
 }
 
-.tessera-nav-page[aria-disabled="true"] {
+.tessera-nav-page[aria-disabled='true'] {
   opacity: 0.45;
   cursor: not-allowed;
 }
 
-.tessera-nav-page[aria-disabled="true"]:hover {
+.tessera-nav-page[aria-disabled='true']:hover {
   background-color: transparent;
   color: var(--tessera-text-light);
 }
@@ -176,8 +177,9 @@
   border: 1px solid var(--tessera-primary);
   border-radius: 6px;
   cursor: pointer;
-  transition: background-color var(--tessera-transition-fast),
-              color var(--tessera-transition-fast);
+  transition:
+    background-color var(--tessera-transition-fast),
+    color var(--tessera-transition-fast);
 }
 
 .tessera-page-nav-btn:hover:not(:disabled) {
@@ -250,8 +252,9 @@
   height: 2px;
   background-color: var(--tessera-text);
   border-radius: 1px;
-  transition: transform var(--tessera-transition-fast),
-              opacity var(--tessera-transition-fast);
+  transition:
+    transform var(--tessera-transition-fast),
+    opacity var(--tessera-transition-fast);
 }
 
 .tessera-hamburger-lines {
@@ -260,15 +263,21 @@
   gap: 5px;
 }
 
-.tessera-hamburger[aria-expanded="true"] .tessera-hamburger-lines .tessera-hamburger-line:nth-child(1) {
+.tessera-hamburger[aria-expanded='true']
+  .tessera-hamburger-lines
+  .tessera-hamburger-line:nth-child(1) {
   transform: translateY(7px) rotate(45deg);
 }
 
-.tessera-hamburger[aria-expanded="true"] .tessera-hamburger-lines .tessera-hamburger-line:nth-child(2) {
+.tessera-hamburger[aria-expanded='true']
+  .tessera-hamburger-lines
+  .tessera-hamburger-line:nth-child(2) {
   opacity: 0;
 }
 
-.tessera-hamburger[aria-expanded="true"] .tessera-hamburger-lines .tessera-hamburger-line:nth-child(3) {
+.tessera-hamburger[aria-expanded='true']
+  .tessera-hamburger-lines
+  .tessera-hamburger-line:nth-child(3) {
   transform: translateY(-7px) rotate(-45deg);
 }
 
@@ -334,7 +343,9 @@
   cursor: pointer;
   min-height: 44px;
   font-family: var(--tessera-font-family);
-  transition: background-color var(--tessera-transition-fast), opacity var(--tessera-transition-fast);
+  transition:
+    background-color var(--tessera-transition-fast),
+    opacity var(--tessera-transition-fast);
 }
 
 .tessera-btn-primary:hover:not(:disabled) {
@@ -401,7 +412,9 @@
   }
 
   .tessera-content {
-    padding-top: calc(var(--tessera-spacing-xl) + 44px + var(--tessera-spacing-md));
+    padding-top: calc(
+      var(--tessera-spacing-xl) + 44px + var(--tessera-spacing-md)
+    );
   }
 }
 
@@ -409,7 +422,9 @@
 @media (max-width: 640px) {
   .tessera-content {
     padding: var(--tessera-spacing-md);
-    padding-top: calc(var(--tessera-spacing-md) + 44px + var(--tessera-spacing-md));
+    padding-top: calc(
+      var(--tessera-spacing-md) + 44px + var(--tessera-spacing-md)
+    );
   }
 
   .tessera-page-nav {
@@ -423,7 +438,13 @@
     font-size: 1rem;
   }
 
-  h1 { font-size: 1.625rem; }
-  h2 { font-size: 1.375rem; }
-  h3 { font-size: 1.125rem; }
+  h1 {
+    font-size: 1.625rem;
+  }
+  h2 {
+    font-size: 1.375rem;
+  }
+  h3 {
+    font-size: 1.125rem;
+  }
 }

package/styles/theme.css

@@ -9,11 +9,23 @@
   --tessera-bg-secondary: #f9fafb;
   --tessera-border: #e5e7eb;
   --tessera-success: #16a34a;
-  --tessera-success-bg: color-mix(in srgb, var(--tessera-success) 8%, transparent);
-  --tessera-success-border: color-mix(in srgb, var(--tessera-success) 25%, transparent);
+  --tessera-success-bg: color-mix(
+    in srgb,
+    var(--tessera-success) 8%,
+    transparent
+  );
+  --tessera-success-border: color-mix(
+    in srgb,
+    var(--tessera-success) 25%,
+    transparent
+  );
   --tessera-error: #dc2626;
   --tessera-error-bg: color-mix(in srgb, var(--tessera-error) 8%, transparent);
-  --tessera-error-border: color-mix(in srgb, var(--tessera-error) 25%, transparent);
+  --tessera-error-border: color-mix(
+    in srgb,
+    var(--tessera-error) 25%,
+    transparent
+  );
   --tessera-warning: #d97706;
 
   /* Typography */