@intellectif/lk-react 23.1.0 → 23.1.2

package/dist/hooks/useSpeechRecorder.d.ts

@@ -1,127 +1,2 @@
-import { a as SpeechRecorderStatus, S as SpeechRecorderError, R as RecordedTake } from '../machine-CuwKqWXC.js';
-
-/**
- * The audio worklet module `useSpeechRecorder` captures through, as source
- * text — exported so an application with a strict Content-Security-Policy can
- * serve it itself.
- *
- * By default the hook loads this text from a `blob:` URL. A worklet module is
- * loaded as a script, so it is `script-src` that must allow `blob:` —
- * `worker-src` does not govern it. Where that is refused, write this string to
- * a file your policy's `script-src` does allow, at build time and from the
- * installed package so it moves with the version you run, and pass that file's
- * URL as `workletUrl`:
- *
- * ```ts
- * import { writeFileSync } from 'node:fs';
- * import { CAPTURE_PROCESSOR_SOURCE } from '@intellectif/lk-react/hooks/useSpeechRecorder';
- *
- * writeFileSync('public/lk-speech-capture.js', CAPTURE_PROCESSOR_SOURCE);
- * ```
- *
- * **The contract** a module at `workletUrl` must meet, which this source does:
- * register an `AudioWorkletProcessor` under the name `lk-speech-capture`, and
- * from its `process(inputs)` post the first input's channels to its `port` as
- * an array with one `Float32Array` per channel, **copied** — the render
- * quantum's buffers belong to the audio thread and are overwritten on the next
- * quantum, so a block posted without copying arrives as whatever the
- * microphone heard some milliseconds later. Return `true`, which keeps the
- * processor alive while its source is silent. Anything else changes what is
- * recorded, so serve this text unchanged rather than a copy of your own.
- */
-declare const CAPTURE_PROCESSOR_SOURCE: string;
-
-interface SpeechRecorderOptions {
-    /** The longest a take may be. Reached, the recording stops itself. */
-    maxDurationMs: number;
-    /** Shorter than this and the take is refused as `too-short`. */
-    minDurationMs?: number;
-    /** How many takes the learner may make. Unbounded when absent. */
-    maxTakes?: number;
-    /**
-     * The URL of a self-hosted copy of {@link CAPTURE_PROCESSOR_SOURCE}, for an
-     * application whose Content-Security-Policy does not allow `blob:` in
-     * `script-src`. Serve that string unchanged; the contract a module here must
-     * meet is written on it.
-     *
-     * **A URL that does not work is not reported.** If the module fails to load,
-     * or loads without registering `lk-speech-capture`, the hook records through
-     * the deprecated `ScriptProcessorNode` on the main thread instead — the
-     * fallback it keeps for engines without audio worklets — and a recorder with
-     * a broken `workletUrl` looks like a working one. Only an engine with neither
-     * path reports `error: 'unsupported'`. Check that the module is actually
-     * fetched.
-     */
-    workletUrl?: string;
-}
-interface SpeechRecorder {
-    status: SpeechRecorderStatus;
-    error: SpeechRecorderError | null;
-    /** The loudest block since the last update, 0..1. */
-    level: number;
-    /** How much audio has been captured, from the sample count. */
-    elapsedMs: number;
-    take: RecordedTake | null;
-    takesUsed: number;
-    /** Whether a take remains. Not whether a `start()` would be accepted now. */
-    canRecord: boolean;
-    /** Opens the microphone and begins capturing. **Never rejects.** */
-    start(): Promise<void>;
-    /** Ends the capture and encodes the take. */
-    stop(): void;
-    /** Throws the take away and releases the microphone. */
-    discard(): void;
-    /**
-     * Starts over: releases the microphone, throws the take away **and gives the
-     * budget back**.
-     *
-     * That last part is the whole difference from {@link SpeechRecorder.discard},
-     * which deliberately refunds nothing — a budget a re-record gave back would
-     * bound nothing. A reset is for a recorder that has been handed a different
-     * reading while it stayed mounted: the takes belong to the activity, so the
-     * next activity's are its own. Calling it for the same reading hands a
-     * learner takes they have already spent.
-     */
-    reset(): void;
-}
-/**
- * Records a take of speech as mono 16-bit PCM WAV at 16 kHz.
- *
- * That is the one format the SDK measures directly: `inspectWav` reads it
- * without a decoding library, and it is what every mainstream pronunciation
- * assessor accepts. A take is captured at whatever rate the device runs at,
- * downmixed to mono, low-pass filtered and resampled, then encoded — so what a
- * server measures is what this hook produced, not a claim about it.
- *
- * **Server rendering.** `status`, `error` and `canRecord` are derived from the
- * take count alone and never from a browser global, so the markup a server
- * produces is the markup the browser's first render produces. Support is
- * discovered inside {@link SpeechRecorder.start} and reported as
- * `error: 'unsupported'`; the obvious `!!navigator.mediaDevices` guard at
- * render time would make a server render and its hydration disagree.
- *
- * **Identity.** `start`, `stop`, `discard` and `reset` keep one identity for the
- * life of the hook, so they are safe in a dependency array. The returned object keeps
- * one identity for as long as none of its values changes, so a render caused
- * by something else does not invalidate an effect that depends on it.
- *
- * `start()` does nothing when no take remains, so `canRecord` is presentation:
- * mark the control `aria-disabled` rather than `disabled`, which would take it
- * out of the tab order and leave a learner nothing to read.
- *
- * ```tsx
- * const recorder = useSpeechRecorder({ maxDurationMs: 20_000, maxTakes: 3 });
- * <button
- *   type="button"
- *   aria-disabled={!recorder.canRecord}
- *   onClick={() => {
- *     void recorder.start();
- *   }}
- * >
- *   Record
- * </button>
- * ```
- */
-declare function useSpeechRecorder(options: SpeechRecorderOptions): SpeechRecorder;
-
-export { CAPTURE_PROCESSOR_SOURCE, RecordedTake, type SpeechRecorder, SpeechRecorderError, type SpeechRecorderOptions, SpeechRecorderStatus, useSpeechRecorder };
+import { a as RecordedTake, i as CAPTURE_PROCESSOR_SOURCE, n as SpeechRecorderOptions, o as SpeechRecorderError, r as useSpeechRecorder, s as SpeechRecorderStatus, t as SpeechRecorder } from "../useSpeechRecorder-DtAYvl02.js";
+export { CAPTURE_PROCESSOR_SOURCE, type RecordedTake, SpeechRecorder, type SpeechRecorderError, SpeechRecorderOptions, type SpeechRecorderStatus, useSpeechRecorder };

package/dist/hooks/useSpeechRecorder.js

@@ -1,4 +1,4 @@
 'use client';
-export { CAPTURE_PROCESSOR_SOURCE, useSpeechRecorder } from '../chunk-MCO52PV5.js';
-//# sourceMappingURL=useSpeechRecorder.js.map
-//# sourceMappingURL=useSpeechRecorder.js.map
+"use client";
+import { n as CAPTURE_PROCESSOR_SOURCE, t as useSpeechRecorder } from "../useSpeechRecorder-zIi9Dlw8.js";
+export { CAPTURE_PROCESSOR_SOURCE, useSpeechRecorder };

package/dist/hooks/useXAPI.cjs

@@ -1,13 +1,129 @@
 'use client';
-'use strict';
+"use client";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let react = require("react");
+//#region src/hooks/useXAPI.ts
+/** Backoff before retry 1 / 2 / 3. */
+const BACKOFF_MS = [
+	1e3,
+	2e3,
+	4e3
+];
+/**
+* Applies the configured learner identity to a statement built by an activity
+* component. Components emit an anonymous placeholder actor and a
+* `urn:learning-kit:activity:*` object id (they cannot know identity — Req
+* 3.1); this hook is the documented place where `XAPIConfig.actor` and
+* `XAPIConfig.activityId` take over. Conservative on purpose: the actor is
+* replaced only when the statement still carries the SDK's anonymous
+* placeholder, and the object id only when it is still the SDK URN — a
+* consumer that already rewrote either keeps its own values.
+*/
+function applyIdentity(statement, cfg) {
+	const isAnonymous = statement.actor?.account?.name === "anonymous" && statement.actor.account.homePage === "https://github.com/intellectif/learning-kit";
+	const isSdkObjectId = statement.object?.objectType === "Activity" && typeof statement.object.id === "string" && statement.object.id.startsWith("urn:learning-kit:activity:");
+	if (!isAnonymous && !isSdkObjectId) return statement;
+	const mappedId = isSdkObjectId && cfg.activityId ? typeof cfg.activityId === "function" ? cfg.activityId(statement.object.id) : cfg.activityId : void 0;
+	return {
+		...statement,
+		...isAnonymous && cfg.actor !== void 0 ? { actor: cfg.actor } : {},
+		...mappedId !== void 0 ? { object: {
+			...statement.object,
+			id: mappedId
+		} } : {}
+	};
+}
+/** UTF-8-safe base64 (`btoa` is Latin1-only and breaks on non-ASCII creds). */
+function toBase64Utf8(input) {
+	const bytes = new TextEncoder().encode(input);
+	let binary = "";
+	for (const byte of bytes) binary += String.fromCharCode(byte);
+	return btoa(binary);
+}
+function authHeader(auth) {
+	return auth.type === "basic" ? `Basic ${toBase64Utf8(`${auth.username}:${auth.password}`)}` : `Bearer ${auth.token}`;
+}
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+/**
+* Delivers xAPI statements to a Learning Record Store, fire-and-forget.
+*
+* Telemetry must never break the learner's attempt, so
+* {@link UseXAPIResult.sendStatement} **never rejects**: network errors and 5xx
+* responses are retried (backoff 1s / 2s / 4s, up to 3 retries), a 4xx fails
+* immediately, and any final failure is reported to `config.onError` instead of
+* throwing. See `XAPIConfig` in `@intellectif/lk-core` for the options.
+*
+* The hook is also where learner identity is applied. Activity components
+* cannot know who the learner is, so they emit an anonymous placeholder actor
+* and a `urn:learning-kit:activity:*` object id; this hook substitutes
+* `config.actor` and `config.activityId` on the way out — and only while those
+* placeholders are still in place, so a statement you rewrote yourself is left
+* alone.
+*
+* `sendStatement` keeps a stable identity across renders even when `config` is
+* an inline object, so it is safe in a dependency array.
+*
+* ```tsx
+* const { sendStatement } = useXAPI({
+*   endpoint: 'https://your-lrs.example/xapi/statements',
+*   auth: { type: 'bearer', token: 'YOUR_TOKEN' },
+*   activityId: 'https://your-app.example/quiz/capital-jp',
+*   actor: { objectType: 'Agent', mbox: 'mailto:learner@example.com' },
+*   onError: (e) => console.error('xAPI send failed', e),
+* });
+*
+* <MultipleChoice data={quiz} onComplete={(r) => void sendStatement(r.xapiStatement)} />
+* ```
+*/
+function useXAPI(config) {
+	const configRef = (0, react.useRef)(config);
+	configRef.current = config;
+	return { sendStatement: (0, react.useCallback)(async (rawStatement) => {
+		const cfg = configRef.current;
+		const statement = applyIdentity(rawStatement, cfg);
+		const maxAttempts = 1 + BACKOFF_MS.length;
+		for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
+			let statusCode;
+			let message = "Request failed";
+			try {
+				const response = await fetch(cfg.endpoint, {
+					method: "POST",
+					headers: {
+						"Content-Type": "application/json",
+						"X-Experience-API-Version": "1.0.3",
+						Authorization: authHeader(cfg.auth)
+					},
+					body: JSON.stringify(statement)
+				});
+				if (response.ok) return;
+				statusCode = response.status;
+				message = `LRS responded with ${response.status}`;
+				if (response.status < 500) {
+					cfg.onError?.({
+						statement,
+						attempt,
+						statusCode,
+						message
+					});
+					return;
+				}
+			} catch (error) {
+				message = error instanceof Error ? error.message : "Network error";
+			}
+			if (attempt === maxAttempts) {
+				cfg.onError?.({
+					statement,
+					attempt,
+					...statusCode !== void 0 ? { statusCode } : {},
+					message
+				});
+				return;
+			}
+			await sleep(BACKOFF_MS[attempt - 1]);
+		}
+	}, []) };
+}
+//#endregion
+exports.useXAPI = useXAPI;
 
-var chunkPNNUPUH4_cjs = require('../chunk-PNNUPUH4.cjs');
-
-
-
-Object.defineProperty(exports, "useXAPI", {
-  enumerable: true,
-  get: function () { return chunkPNNUPUH4_cjs.useXAPI; }
-});
-//# sourceMappingURL=useXAPI.cjs.map
 //# sourceMappingURL=useXAPI.cjs.map

package/dist/hooks/useXAPI.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"useXAPI.cjs"}
+{"version":3,"file":"useXAPI.cjs","names":["useRef","useCallback"],"sources":["../../src/hooks/useXAPI.ts"],"sourcesContent":["'use client';\n\nimport type { XAPIConfig, XAPIStatement } from '@intellectif/lk-core';\nimport { useCallback, useRef } from 'react';\n\n/** Backoff before retry 1 / 2 / 3. */\nconst BACKOFF_MS = [1000, 2000, 4000] as const;\n\n/**\n * Applies the configured learner identity to a statement built by an activity\n * component. Components emit an anonymous placeholder actor and a\n * `urn:learning-kit:activity:*` object id (they cannot know identity — Req\n * 3.1); this hook is the documented place where `XAPIConfig.actor` and\n * `XAPIConfig.activityId` take over. Conservative on purpose: the actor is\n * replaced only when the statement still carries the SDK's anonymous\n * placeholder, and the object id only when it is still the SDK URN — a\n * consumer that already rewrote either keeps its own values.\n */\nfunction applyIdentity(statement: XAPIStatement, cfg: XAPIConfig): XAPIStatement {\n  const isAnonymous =\n    statement.actor?.account?.name === 'anonymous' &&\n    statement.actor.account.homePage === 'https://github.com/intellectif/learning-kit';\n  const isSdkObjectId =\n    statement.object?.objectType === 'Activity' &&\n    typeof statement.object.id === 'string' &&\n    statement.object.id.startsWith('urn:learning-kit:activity:');\n\n  if (!isAnonymous && !isSdkObjectId) {\n    return statement;\n  }\n  const mappedId =\n    isSdkObjectId && cfg.activityId\n      ? typeof cfg.activityId === 'function'\n        ? cfg.activityId(statement.object.id)\n        : cfg.activityId\n      : undefined;\n  return {\n    ...statement,\n    ...(isAnonymous && cfg.actor !== undefined ? { actor: cfg.actor } : {}),\n    ...(mappedId !== undefined ? { object: { ...statement.object, id: mappedId } } : {}),\n  };\n}\n\n/** UTF-8-safe base64 (`btoa` is Latin1-only and breaks on non-ASCII creds). */\nfunction toBase64Utf8(input: string): string {\n  const bytes = new TextEncoder().encode(input);\n  let binary = '';\n  for (const byte of bytes) {\n    binary += String.fromCharCode(byte);\n  }\n  return btoa(binary);\n}\n\nfunction authHeader(auth: XAPIConfig['auth']): string {\n  return auth.type === 'basic'\n    ? `Basic ${toBase64Utf8(`${auth.username}:${auth.password}`)}`\n    : `Bearer ${auth.token}`;\n}\n\nconst sleep = (ms: number): Promise<void> => new Promise((resolve) => setTimeout(resolve, ms));\n\nexport interface UseXAPIResult {\n  /**\n   * Sends a statement to the configured LRS. **Never rejects** — xAPI is\n   * fire-and-forget telemetry that must not break the learner's activity\n   * flow. Network errors and 5xx responses are retried (backoff 1s/2s/4s,\n   * up to 3 retries); a 4xx fails immediately. Any final failure is delivered\n   * to `config.onError`.\n   */\n  sendStatement: (statement: XAPIStatement) => Promise<void>;\n}\n\n/**\n * Delivers xAPI statements to a Learning Record Store, fire-and-forget.\n *\n * Telemetry must never break the learner's attempt, so\n * {@link UseXAPIResult.sendStatement} **never rejects**: network errors and 5xx\n * responses are retried (backoff 1s / 2s / 4s, up to 3 retries), a 4xx fails\n * immediately, and any final failure is reported to `config.onError` instead of\n * throwing. See `XAPIConfig` in `@intellectif/lk-core` for the options.\n *\n * The hook is also where learner identity is applied. Activity components\n * cannot know who the learner is, so they emit an anonymous placeholder actor\n * and a `urn:learning-kit:activity:*` object id; this hook substitutes\n * `config.actor` and `config.activityId` on the way out — and only while those\n * placeholders are still in place, so a statement you rewrote yourself is left\n * alone.\n *\n * `sendStatement` keeps a stable identity across renders even when `config` is\n * an inline object, so it is safe in a dependency array.\n *\n * ```tsx\n * const { sendStatement } = useXAPI({\n *   endpoint: 'https://your-lrs.example/xapi/statements',\n *   auth: { type: 'bearer', token: 'YOUR_TOKEN' },\n *   activityId: 'https://your-app.example/quiz/capital-jp',\n *   actor: { objectType: 'Agent', mbox: 'mailto:learner@example.com' },\n *   onError: (e) => console.error('xAPI send failed', e),\n * });\n *\n * <MultipleChoice data={quiz} onComplete={(r) => void sendStatement(r.xapiStatement)} />\n * ```\n */\nexport function useXAPI(config: XAPIConfig): UseXAPIResult {\n  // Keep the latest config without changing `sendStatement`'s identity when\n  // callers pass an inline config object.\n  const configRef = useRef(config);\n  configRef.current = config;\n\n  const sendStatement = useCallback(async (rawStatement: XAPIStatement): Promise<void> => {\n    const cfg = configRef.current;\n    const statement = applyIdentity(rawStatement, cfg);\n    const maxAttempts = 1 + BACKOFF_MS.length;\n\n    for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {\n      let statusCode: number | undefined;\n      let message = 'Request failed';\n\n      try {\n        const response = await fetch(cfg.endpoint, {\n          method: 'POST',\n          headers: {\n            'Content-Type': 'application/json',\n            'X-Experience-API-Version': '1.0.3',\n            Authorization: authHeader(cfg.auth),\n          },\n          body: JSON.stringify(statement),\n        });\n\n        if (response.ok) {\n          return;\n        }\n\n        statusCode = response.status;\n        message = `LRS responded with ${response.status}`;\n\n        // Only network errors and 5xx are retryable. A 4xx is a\n        // client error — fail immediately rather than waste retries.\n        if (response.status < 500) {\n          cfg.onError?.({ statement, attempt, statusCode, message });\n          return;\n        }\n      } catch (error) {\n        message = error instanceof Error ? error.message : 'Network error';\n      }\n\n      if (attempt === maxAttempts) {\n        cfg.onError?.({\n          statement,\n          attempt,\n          ...(statusCode !== undefined ? { statusCode } : {}),\n          message,\n        });\n        return;\n      }\n\n      await sleep(BACKOFF_MS[attempt - 1]);\n    }\n  }, []);\n\n  return { sendStatement };\n}\n"],"mappings":";;;;;AAMA,MAAM,aAAa;CAAC;CAAM;CAAM;AAAI;;;;;;;;;;;AAYpC,SAAS,cAAc,WAA0B,KAAgC;CAC/E,MAAM,cACJ,UAAU,OAAO,SAAS,SAAS,eACnC,UAAU,MAAM,QAAQ,aAAa;CACvC,MAAM,gBACJ,UAAU,QAAQ,eAAe,cACjC,OAAO,UAAU,OAAO,OAAO,YAC/B,UAAU,OAAO,GAAG,WAAW,4BAA4B;CAE7D,IAAI,CAAC,eAAe,CAAC,eACnB,OAAO;CAET,MAAM,WACJ,iBAAiB,IAAI,aACjB,OAAO,IAAI,eAAe,aACxB,IAAI,WAAW,UAAU,OAAO,EAAE,IAClC,IAAI,aACN,KAAA;CACN,OAAO;EACL,GAAG;EACH,GAAI,eAAe,IAAI,UAAU,KAAA,IAAY,EAAE,OAAO,IAAI,MAAM,IAAI,CAAC;EACrE,GAAI,aAAa,KAAA,IAAY,EAAE,QAAQ;GAAE,GAAG,UAAU;GAAQ,IAAI;EAAS,EAAE,IAAI,CAAC;CACpF;AACF;;AAGA,SAAS,aAAa,OAAuB;CAC3C,MAAM,QAAQ,IAAI,YAAY,CAAC,CAAC,OAAO,KAAK;CAC5C,IAAI,SAAS;CACb,KAAK,MAAM,QAAQ,OACjB,UAAU,OAAO,aAAa,IAAI;CAEpC,OAAO,KAAK,MAAM;AACpB;AAEA,SAAS,WAAW,MAAkC;CACpD,OAAO,KAAK,SAAS,UACjB,SAAS,aAAa,GAAG,KAAK,SAAS,GAAG,KAAK,UAAU,MACzD,UAAU,KAAK;AACrB;AAEA,MAAM,SAAS,OAA8B,IAAI,SAAS,YAAY,WAAW,SAAS,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4C7F,SAAgB,QAAQ,QAAmC;CAGzD,MAAM,aAAA,GAAYA,MAAAA,OAAAA,CAAO,MAAM;CAC/B,UAAU,UAAU;CAqDpB,OAAO,EAAE,gBAAA,GAnDaC,MAAAA,YAAAA,CAAY,OAAO,iBAA+C;EACtF,MAAM,MAAM,UAAU;EACtB,MAAM,YAAY,cAAc,cAAc,GAAG;EACjD,MAAM,cAAc,IAAI,WAAW;EAEnC,KAAK,IAAI,UAAU,GAAG,WAAW,aAAa,WAAW,GAAG;GAC1D,IAAI;GACJ,IAAI,UAAU;GAEd,IAAI;IACF,MAAM,WAAW,MAAM,MAAM,IAAI,UAAU;KACzC,QAAQ;KACR,SAAS;MACP,gBAAgB;MAChB,4BAA4B;MAC5B,eAAe,WAAW,IAAI,IAAI;KACpC;KACA,MAAM,KAAK,UAAU,SAAS;IAChC,CAAC;IAED,IAAI,SAAS,IACX;IAGF,aAAa,SAAS;IACtB,UAAU,sBAAsB,SAAS;IAIzC,IAAI,SAAS,SAAS,KAAK;KACzB,IAAI,UAAU;MAAE;MAAW;MAAS;MAAY;KAAQ,CAAC;KACzD;IACF;GACF,SAAS,OAAO;IACd,UAAU,iBAAiB,QAAQ,MAAM,UAAU;GACrD;GAEA,IAAI,YAAY,aAAa;IAC3B,IAAI,UAAU;KACZ;KACA;KACA,GAAI,eAAe,KAAA,IAAY,EAAE,WAAW,IAAI,CAAC;KACjD;IACF,CAAC;IACD;GACF;GAEA,MAAM,MAAM,WAAW,UAAU,EAAE;EACrC;CACF,GAAG,CAAC,CAEiB,EAAE;AACzB"}

package/dist/hooks/useXAPI.d.cts

@@ -1,14 +1,14 @@
-import { XAPIStatement, XAPIConfig } from '@intellectif/lk-core';
-
-interface UseXAPIResult {
-    /**
-     * Sends a statement to the configured LRS. **Never rejects** — xAPI is
-     * fire-and-forget telemetry that must not break the learner's activity
-     * flow. Network errors and 5xx responses are retried (backoff 1s/2s/4s,
-     * up to 3 retries); a 4xx fails immediately. Any final failure is delivered
-     * to `config.onError`.
-     */
-    sendStatement: (statement: XAPIStatement) => Promise<void>;
+import { XAPIConfig, XAPIStatement } from "@intellectif/lk-core";
+//#region src/hooks/useXAPI.d.ts
+export interface UseXAPIResult {
+  /**
+   * Sends a statement to the configured LRS. **Never rejects** — xAPI is
+   * fire-and-forget telemetry that must not break the learner's activity
+   * flow. Network errors and 5xx responses are retried (backoff 1s/2s/4s,
+   * up to 3 retries); a 4xx fails immediately. Any final failure is delivered
+   * to `config.onError`.
+   */
+  sendStatement: (statement: XAPIStatement) => Promise<void>;
 }
 /**
  * Delivers xAPI statements to a Learning Record Store, fire-and-forget.
@@ -41,6 +41,6 @@ interface UseXAPIResult {
  * <MultipleChoice data={quiz} onComplete={(r) => void sendStatement(r.xapiStatement)} />
  * ```
  */
-declare function useXAPI(config: XAPIConfig): UseXAPIResult;
-
-export { type UseXAPIResult, useXAPI };
+export declare function useXAPI(config: XAPIConfig): UseXAPIResult;
+//#endregion
+//# sourceMappingURL=useXAPI.d.cts.map

package/dist/hooks/useXAPI.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useXAPI.d.cts","names":[],"sources":["../../src/hooks/useXAPI.ts"],"mappings":";;iBA6DiB;;;;;;;;EAQf,gBAAgB,WAAW,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAkC/B,QAAQ,QAAQ,aAAa"}

package/dist/hooks/useXAPI.d.ts

@@ -1,14 +1,14 @@
-import { XAPIStatement, XAPIConfig } from '@intellectif/lk-core';
-
-interface UseXAPIResult {
-    /**
-     * Sends a statement to the configured LRS. **Never rejects** — xAPI is
-     * fire-and-forget telemetry that must not break the learner's activity
-     * flow. Network errors and 5xx responses are retried (backoff 1s/2s/4s,
-     * up to 3 retries); a 4xx fails immediately. Any final failure is delivered
-     * to `config.onError`.
-     */
-    sendStatement: (statement: XAPIStatement) => Promise<void>;
+import { XAPIConfig, XAPIStatement } from "@intellectif/lk-core";
+//#region src/hooks/useXAPI.d.ts
+export interface UseXAPIResult {
+  /**
+   * Sends a statement to the configured LRS. **Never rejects** — xAPI is
+   * fire-and-forget telemetry that must not break the learner's activity
+   * flow. Network errors and 5xx responses are retried (backoff 1s/2s/4s,
+   * up to 3 retries); a 4xx fails immediately. Any final failure is delivered
+   * to `config.onError`.
+   */
+  sendStatement: (statement: XAPIStatement) => Promise<void>;
 }
 /**
  * Delivers xAPI statements to a Learning Record Store, fire-and-forget.
@@ -41,6 +41,6 @@ interface UseXAPIResult {
  * <MultipleChoice data={quiz} onComplete={(r) => void sendStatement(r.xapiStatement)} />
  * ```
  */
-declare function useXAPI(config: XAPIConfig): UseXAPIResult;
-
-export { type UseXAPIResult, useXAPI };
+export declare function useXAPI(config: XAPIConfig): UseXAPIResult;
+//#endregion
+//# sourceMappingURL=useXAPI.d.ts.map

package/dist/hooks/useXAPI.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useXAPI.d.ts","names":[],"sources":["../../src/hooks/useXAPI.ts"],"mappings":";;iBA6DiB;;;;;;;;EAQf,gBAAgB,WAAW,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAkC/B,QAAQ,QAAQ,aAAa"}

package/dist/hooks/useXAPI.js

@@ -1,4 +1,128 @@
 'use client';
-export { useXAPI } from '../chunk-2TW6WLBC.js';
-//# sourceMappingURL=useXAPI.js.map
+"use client";
+import { useCallback, useRef } from "react";
+//#region src/hooks/useXAPI.ts
+/** Backoff before retry 1 / 2 / 3. */
+const BACKOFF_MS = [
+	1e3,
+	2e3,
+	4e3
+];
+/**
+* Applies the configured learner identity to a statement built by an activity
+* component. Components emit an anonymous placeholder actor and a
+* `urn:learning-kit:activity:*` object id (they cannot know identity — Req
+* 3.1); this hook is the documented place where `XAPIConfig.actor` and
+* `XAPIConfig.activityId` take over. Conservative on purpose: the actor is
+* replaced only when the statement still carries the SDK's anonymous
+* placeholder, and the object id only when it is still the SDK URN — a
+* consumer that already rewrote either keeps its own values.
+*/
+function applyIdentity(statement, cfg) {
+	const isAnonymous = statement.actor?.account?.name === "anonymous" && statement.actor.account.homePage === "https://github.com/intellectif/learning-kit";
+	const isSdkObjectId = statement.object?.objectType === "Activity" && typeof statement.object.id === "string" && statement.object.id.startsWith("urn:learning-kit:activity:");
+	if (!isAnonymous && !isSdkObjectId) return statement;
+	const mappedId = isSdkObjectId && cfg.activityId ? typeof cfg.activityId === "function" ? cfg.activityId(statement.object.id) : cfg.activityId : void 0;
+	return {
+		...statement,
+		...isAnonymous && cfg.actor !== void 0 ? { actor: cfg.actor } : {},
+		...mappedId !== void 0 ? { object: {
+			...statement.object,
+			id: mappedId
+		} } : {}
+	};
+}
+/** UTF-8-safe base64 (`btoa` is Latin1-only and breaks on non-ASCII creds). */
+function toBase64Utf8(input) {
+	const bytes = new TextEncoder().encode(input);
+	let binary = "";
+	for (const byte of bytes) binary += String.fromCharCode(byte);
+	return btoa(binary);
+}
+function authHeader(auth) {
+	return auth.type === "basic" ? `Basic ${toBase64Utf8(`${auth.username}:${auth.password}`)}` : `Bearer ${auth.token}`;
+}
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+/**
+* Delivers xAPI statements to a Learning Record Store, fire-and-forget.
+*
+* Telemetry must never break the learner's attempt, so
+* {@link UseXAPIResult.sendStatement} **never rejects**: network errors and 5xx
+* responses are retried (backoff 1s / 2s / 4s, up to 3 retries), a 4xx fails
+* immediately, and any final failure is reported to `config.onError` instead of
+* throwing. See `XAPIConfig` in `@intellectif/lk-core` for the options.
+*
+* The hook is also where learner identity is applied. Activity components
+* cannot know who the learner is, so they emit an anonymous placeholder actor
+* and a `urn:learning-kit:activity:*` object id; this hook substitutes
+* `config.actor` and `config.activityId` on the way out — and only while those
+* placeholders are still in place, so a statement you rewrote yourself is left
+* alone.
+*
+* `sendStatement` keeps a stable identity across renders even when `config` is
+* an inline object, so it is safe in a dependency array.
+*
+* ```tsx
+* const { sendStatement } = useXAPI({
+*   endpoint: 'https://your-lrs.example/xapi/statements',
+*   auth: { type: 'bearer', token: 'YOUR_TOKEN' },
+*   activityId: 'https://your-app.example/quiz/capital-jp',
+*   actor: { objectType: 'Agent', mbox: 'mailto:learner@example.com' },
+*   onError: (e) => console.error('xAPI send failed', e),
+* });
+*
+* <MultipleChoice data={quiz} onComplete={(r) => void sendStatement(r.xapiStatement)} />
+* ```
+*/
+function useXAPI(config) {
+	const configRef = useRef(config);
+	configRef.current = config;
+	return { sendStatement: useCallback(async (rawStatement) => {
+		const cfg = configRef.current;
+		const statement = applyIdentity(rawStatement, cfg);
+		const maxAttempts = 1 + BACKOFF_MS.length;
+		for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
+			let statusCode;
+			let message = "Request failed";
+			try {
+				const response = await fetch(cfg.endpoint, {
+					method: "POST",
+					headers: {
+						"Content-Type": "application/json",
+						"X-Experience-API-Version": "1.0.3",
+						Authorization: authHeader(cfg.auth)
+					},
+					body: JSON.stringify(statement)
+				});
+				if (response.ok) return;
+				statusCode = response.status;
+				message = `LRS responded with ${response.status}`;
+				if (response.status < 500) {
+					cfg.onError?.({
+						statement,
+						attempt,
+						statusCode,
+						message
+					});
+					return;
+				}
+			} catch (error) {
+				message = error instanceof Error ? error.message : "Network error";
+			}
+			if (attempt === maxAttempts) {
+				cfg.onError?.({
+					statement,
+					attempt,
+					...statusCode !== void 0 ? { statusCode } : {},
+					message
+				});
+				return;
+			}
+			await sleep(BACKOFF_MS[attempt - 1]);
+		}
+	}, []) };
+}
+//#endregion
+export { useXAPI };
+
 //# sourceMappingURL=useXAPI.js.map

package/dist/hooks/useXAPI.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"useXAPI.js"}
+{"version":3,"file":"useXAPI.js","names":[],"sources":["../../src/hooks/useXAPI.ts"],"sourcesContent":["'use client';\n\nimport type { XAPIConfig, XAPIStatement } from '@intellectif/lk-core';\nimport { useCallback, useRef } from 'react';\n\n/** Backoff before retry 1 / 2 / 3. */\nconst BACKOFF_MS = [1000, 2000, 4000] as const;\n\n/**\n * Applies the configured learner identity to a statement built by an activity\n * component. Components emit an anonymous placeholder actor and a\n * `urn:learning-kit:activity:*` object id (they cannot know identity — Req\n * 3.1); this hook is the documented place where `XAPIConfig.actor` and\n * `XAPIConfig.activityId` take over. Conservative on purpose: the actor is\n * replaced only when the statement still carries the SDK's anonymous\n * placeholder, and the object id only when it is still the SDK URN — a\n * consumer that already rewrote either keeps its own values.\n */\nfunction applyIdentity(statement: XAPIStatement, cfg: XAPIConfig): XAPIStatement {\n  const isAnonymous =\n    statement.actor?.account?.name === 'anonymous' &&\n    statement.actor.account.homePage === 'https://github.com/intellectif/learning-kit';\n  const isSdkObjectId =\n    statement.object?.objectType === 'Activity' &&\n    typeof statement.object.id === 'string' &&\n    statement.object.id.startsWith('urn:learning-kit:activity:');\n\n  if (!isAnonymous && !isSdkObjectId) {\n    return statement;\n  }\n  const mappedId =\n    isSdkObjectId && cfg.activityId\n      ? typeof cfg.activityId === 'function'\n        ? cfg.activityId(statement.object.id)\n        : cfg.activityId\n      : undefined;\n  return {\n    ...statement,\n    ...(isAnonymous && cfg.actor !== undefined ? { actor: cfg.actor } : {}),\n    ...(mappedId !== undefined ? { object: { ...statement.object, id: mappedId } } : {}),\n  };\n}\n\n/** UTF-8-safe base64 (`btoa` is Latin1-only and breaks on non-ASCII creds). */\nfunction toBase64Utf8(input: string): string {\n  const bytes = new TextEncoder().encode(input);\n  let binary = '';\n  for (const byte of bytes) {\n    binary += String.fromCharCode(byte);\n  }\n  return btoa(binary);\n}\n\nfunction authHeader(auth: XAPIConfig['auth']): string {\n  return auth.type === 'basic'\n    ? `Basic ${toBase64Utf8(`${auth.username}:${auth.password}`)}`\n    : `Bearer ${auth.token}`;\n}\n\nconst sleep = (ms: number): Promise<void> => new Promise((resolve) => setTimeout(resolve, ms));\n\nexport interface UseXAPIResult {\n  /**\n   * Sends a statement to the configured LRS. **Never rejects** — xAPI is\n   * fire-and-forget telemetry that must not break the learner's activity\n   * flow. Network errors and 5xx responses are retried (backoff 1s/2s/4s,\n   * up to 3 retries); a 4xx fails immediately. Any final failure is delivered\n   * to `config.onError`.\n   */\n  sendStatement: (statement: XAPIStatement) => Promise<void>;\n}\n\n/**\n * Delivers xAPI statements to a Learning Record Store, fire-and-forget.\n *\n * Telemetry must never break the learner's attempt, so\n * {@link UseXAPIResult.sendStatement} **never rejects**: network errors and 5xx\n * responses are retried (backoff 1s / 2s / 4s, up to 3 retries), a 4xx fails\n * immediately, and any final failure is reported to `config.onError` instead of\n * throwing. See `XAPIConfig` in `@intellectif/lk-core` for the options.\n *\n * The hook is also where learner identity is applied. Activity components\n * cannot know who the learner is, so they emit an anonymous placeholder actor\n * and a `urn:learning-kit:activity:*` object id; this hook substitutes\n * `config.actor` and `config.activityId` on the way out — and only while those\n * placeholders are still in place, so a statement you rewrote yourself is left\n * alone.\n *\n * `sendStatement` keeps a stable identity across renders even when `config` is\n * an inline object, so it is safe in a dependency array.\n *\n * ```tsx\n * const { sendStatement } = useXAPI({\n *   endpoint: 'https://your-lrs.example/xapi/statements',\n *   auth: { type: 'bearer', token: 'YOUR_TOKEN' },\n *   activityId: 'https://your-app.example/quiz/capital-jp',\n *   actor: { objectType: 'Agent', mbox: 'mailto:learner@example.com' },\n *   onError: (e) => console.error('xAPI send failed', e),\n * });\n *\n * <MultipleChoice data={quiz} onComplete={(r) => void sendStatement(r.xapiStatement)} />\n * ```\n */\nexport function useXAPI(config: XAPIConfig): UseXAPIResult {\n  // Keep the latest config without changing `sendStatement`'s identity when\n  // callers pass an inline config object.\n  const configRef = useRef(config);\n  configRef.current = config;\n\n  const sendStatement = useCallback(async (rawStatement: XAPIStatement): Promise<void> => {\n    const cfg = configRef.current;\n    const statement = applyIdentity(rawStatement, cfg);\n    const maxAttempts = 1 + BACKOFF_MS.length;\n\n    for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {\n      let statusCode: number | undefined;\n      let message = 'Request failed';\n\n      try {\n        const response = await fetch(cfg.endpoint, {\n          method: 'POST',\n          headers: {\n            'Content-Type': 'application/json',\n            'X-Experience-API-Version': '1.0.3',\n            Authorization: authHeader(cfg.auth),\n          },\n          body: JSON.stringify(statement),\n        });\n\n        if (response.ok) {\n          return;\n        }\n\n        statusCode = response.status;\n        message = `LRS responded with ${response.status}`;\n\n        // Only network errors and 5xx are retryable. A 4xx is a\n        // client error — fail immediately rather than waste retries.\n        if (response.status < 500) {\n          cfg.onError?.({ statement, attempt, statusCode, message });\n          return;\n        }\n      } catch (error) {\n        message = error instanceof Error ? error.message : 'Network error';\n      }\n\n      if (attempt === maxAttempts) {\n        cfg.onError?.({\n          statement,\n          attempt,\n          ...(statusCode !== undefined ? { statusCode } : {}),\n          message,\n        });\n        return;\n      }\n\n      await sleep(BACKOFF_MS[attempt - 1]);\n    }\n  }, []);\n\n  return { sendStatement };\n}\n"],"mappings":";;;;AAMA,MAAM,aAAa;CAAC;CAAM;CAAM;AAAI;;;;;;;;;;;AAYpC,SAAS,cAAc,WAA0B,KAAgC;CAC/E,MAAM,cACJ,UAAU,OAAO,SAAS,SAAS,eACnC,UAAU,MAAM,QAAQ,aAAa;CACvC,MAAM,gBACJ,UAAU,QAAQ,eAAe,cACjC,OAAO,UAAU,OAAO,OAAO,YAC/B,UAAU,OAAO,GAAG,WAAW,4BAA4B;CAE7D,IAAI,CAAC,eAAe,CAAC,eACnB,OAAO;CAET,MAAM,WACJ,iBAAiB,IAAI,aACjB,OAAO,IAAI,eAAe,aACxB,IAAI,WAAW,UAAU,OAAO,EAAE,IAClC,IAAI,aACN,KAAA;CACN,OAAO;EACL,GAAG;EACH,GAAI,eAAe,IAAI,UAAU,KAAA,IAAY,EAAE,OAAO,IAAI,MAAM,IAAI,CAAC;EACrE,GAAI,aAAa,KAAA,IAAY,EAAE,QAAQ;GAAE,GAAG,UAAU;GAAQ,IAAI;EAAS,EAAE,IAAI,CAAC;CACpF;AACF;;AAGA,SAAS,aAAa,OAAuB;CAC3C,MAAM,QAAQ,IAAI,YAAY,CAAC,CAAC,OAAO,KAAK;CAC5C,IAAI,SAAS;CACb,KAAK,MAAM,QAAQ,OACjB,UAAU,OAAO,aAAa,IAAI;CAEpC,OAAO,KAAK,MAAM;AACpB;AAEA,SAAS,WAAW,MAAkC;CACpD,OAAO,KAAK,SAAS,UACjB,SAAS,aAAa,GAAG,KAAK,SAAS,GAAG,KAAK,UAAU,MACzD,UAAU,KAAK;AACrB;AAEA,MAAM,SAAS,OAA8B,IAAI,SAAS,YAAY,WAAW,SAAS,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4C7F,SAAgB,QAAQ,QAAmC;CAGzD,MAAM,YAAY,OAAO,MAAM;CAC/B,UAAU,UAAU;CAqDpB,OAAO,EAAE,eAnDa,YAAY,OAAO,iBAA+C;EACtF,MAAM,MAAM,UAAU;EACtB,MAAM,YAAY,cAAc,cAAc,GAAG;EACjD,MAAM,cAAc,IAAI,WAAW;EAEnC,KAAK,IAAI,UAAU,GAAG,WAAW,aAAa,WAAW,GAAG;GAC1D,IAAI;GACJ,IAAI,UAAU;GAEd,IAAI;IACF,MAAM,WAAW,MAAM,MAAM,IAAI,UAAU;KACzC,QAAQ;KACR,SAAS;MACP,gBAAgB;MAChB,4BAA4B;MAC5B,eAAe,WAAW,IAAI,IAAI;KACpC;KACA,MAAM,KAAK,UAAU,SAAS;IAChC,CAAC;IAED,IAAI,SAAS,IACX;IAGF,aAAa,SAAS;IACtB,UAAU,sBAAsB,SAAS;IAIzC,IAAI,SAAS,SAAS,KAAK;KACzB,IAAI,UAAU;MAAE;MAAW;MAAS;MAAY;KAAQ,CAAC;KACzD;IACF;GACF,SAAS,OAAO;IACd,UAAU,iBAAiB,QAAQ,MAAM,UAAU;GACrD;GAEA,IAAI,YAAY,aAAa;IAC3B,IAAI,UAAU;KACZ;KACA;KACA,GAAI,eAAe,KAAA,IAAY,EAAE,WAAW,IAAI,CAAC;KACjD;IACF,CAAC;IACD;GACF;GAEA,MAAM,MAAM,WAAW,UAAU,EAAE;EACrC;CACF,GAAG,CAAC,CAEiB,EAAE;AACzB"}

package/dist/i18n/LkIntlProvider.cjs

@@ -1,33 +1,10 @@
 'use client';
-'use strict';
-
-var chunkBIGGXHAW_cjs = require('../chunk-BIGGXHAW.cjs');
-
-
-
-Object.defineProperty(exports, "DEFAULT_STRINGS", {
-  enumerable: true,
-  get: function () { return chunkBIGGXHAW_cjs.DEFAULT_STRINGS; }
-});
-Object.defineProperty(exports, "LkIntlProvider", {
-  enumerable: true,
-  get: function () { return chunkBIGGXHAW_cjs.LkIntlProvider; }
-});
-Object.defineProperty(exports, "directionForLocale", {
-  enumerable: true,
-  get: function () { return chunkBIGGXHAW_cjs.directionForLocale; }
-});
-Object.defineProperty(exports, "mergeStrings", {
-  enumerable: true,
-  get: function () { return chunkBIGGXHAW_cjs.mergeStrings; }
-});
-Object.defineProperty(exports, "useLkDirection", {
-  enumerable: true,
-  get: function () { return chunkBIGGXHAW_cjs.useLkDirection; }
-});
-Object.defineProperty(exports, "useLkStrings", {
-  enumerable: true,
-  get: function () { return chunkBIGGXHAW_cjs.useLkStrings; }
-});
-//# sourceMappingURL=LkIntlProvider.cjs.map
-//# sourceMappingURL=LkIntlProvider.cjs.map
+"use client";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_LkIntlProvider = require("../LkIntlProvider-oi57lYB0.cjs");
+exports.DEFAULT_STRINGS = require_LkIntlProvider.DEFAULT_STRINGS;
+exports.LkIntlProvider = require_LkIntlProvider.LkIntlProvider;
+exports.directionForLocale = require_LkIntlProvider.directionForLocale;
+exports.mergeStrings = require_LkIntlProvider.mergeStrings;
+exports.useLkDirection = require_LkIntlProvider.useLkDirection;
+exports.useLkStrings = require_LkIntlProvider.useLkStrings;