@intellectif/lk-core 1.1.0 → 1.3.0

package/dist/xapi-DNzkSJ0S.cjs

@@ -0,0 +1,362 @@
+const require_registry = require("./registry-DVi0LR_i.cjs");
+let zod_v4 = require("zod/v4");
+zod_v4 = require_registry.__toESM(zod_v4, 1);
+//#region src/xapi/validators.ts
+const UUID_V4 = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+const IRI = /^[a-z][a-z0-9+.-]*:/i;
+const langMap = zod_v4.record(zod_v4.string(), zod_v4.string());
+const extensions = zod_v4.record(zod_v4.string(), zod_v4.unknown());
+const actorSchema = zod_v4.object({
+	objectType: zod_v4.literal("Agent"),
+	name: zod_v4.string().optional(),
+	mbox: zod_v4.string().regex(/^mailto:/, "mbox must be a mailto IRI").optional(),
+	account: zod_v4.object({
+		homePage: zod_v4.string(),
+		name: zod_v4.string()
+	}).optional()
+}).refine((actor) => actor.mbox !== void 0 || actor.account !== void 0, { error: "actor must be identified by an mbox or an account" });
+const statementSchema = zod_v4.object({
+	id: zod_v4.string().regex(UUID_V4, "id must be a UUID v4"),
+	actor: actorSchema,
+	verb: zod_v4.object({
+		id: zod_v4.string().regex(IRI, "verb.id must be an IRI"),
+		display: langMap
+	}),
+	object: zod_v4.object({
+		objectType: zod_v4.literal("Activity"),
+		id: zod_v4.string().regex(IRI, "object.id must be an IRI"),
+		definition: zod_v4.object({
+			name: langMap.optional(),
+			description: langMap.optional(),
+			type: zod_v4.string().optional(),
+			interactionType: zod_v4.string().optional(),
+			correctResponsesPattern: zod_v4.array(zod_v4.string()).optional(),
+			choices: zod_v4.array(zod_v4.object({
+				id: zod_v4.string(),
+				description: langMap.optional()
+			})).optional(),
+			extensions: extensions.optional()
+		}).optional()
+	}),
+	result: zod_v4.object({
+		score: zod_v4.object({
+			scaled: zod_v4.number().min(-1).max(1),
+			raw: zod_v4.number().optional(),
+			min: zod_v4.number().optional(),
+			max: zod_v4.number().optional()
+		}).optional(),
+		success: zod_v4.boolean().optional(),
+		completion: zod_v4.boolean().optional(),
+		duration: zod_v4.string().regex(/^P/, "duration must be an ISO 8601 duration").optional(),
+		response: zod_v4.string().optional(),
+		extensions: extensions.optional()
+	}).optional(),
+	context: zod_v4.object({
+		platform: zod_v4.string().optional(),
+		language: zod_v4.string().optional(),
+		contextActivities: zod_v4.object({
+			parent: zod_v4.array(zod_v4.object({
+				objectType: zod_v4.literal("Activity"),
+				id: zod_v4.string()
+			})).optional(),
+			grouping: zod_v4.array(zod_v4.object({
+				objectType: zod_v4.literal("Activity"),
+				id: zod_v4.string()
+			})).optional(),
+			category: zod_v4.array(zod_v4.object({
+				objectType: zod_v4.literal("Activity"),
+				id: zod_v4.string()
+			})).optional(),
+			other: zod_v4.array(zod_v4.object({
+				objectType: zod_v4.literal("Activity"),
+				id: zod_v4.string()
+			})).optional()
+		}).optional(),
+		extensions: extensions.optional()
+	}).optional(),
+	timestamp: zod_v4.string().refine((value) => !Number.isNaN(Date.parse(value)), "timestamp must be ISO 8601"),
+	version: zod_v4.literal("1.0.3")
+});
+/**
+* Whether this is a production build.
+*
+* **The literal `process.env.NODE_ENV`, spelled exactly so.** It is the one
+* expression bundlers replace at build time, and a browser has no `process` to
+* read at run time. The reading this replaces,
+* `globalThis.process?.env?.NODE_ENV`, is not that expression, so no bundler
+* touched it, and in a browser it found no `process` and answered "not
+* production" in every production app — so a malformed statement threw there
+* instead of being logged and sent. Tests running in Node never saw it,
+* because Node has a `process`.
+*
+* This package's own build must leave the literal in its output, for the
+* consumer's bundler to replace. The `try` covers code that reaches a runtime
+* unbundled, with no `process` at all: that is not production, as it always
+* was.
+*/
+function isProduction() {
+	try {
+		return process.env.NODE_ENV === "production";
+	} catch {
+		return false;
+	}
+}
+/**
+* Validates a constructed {@link XAPIStatement} against the xAPI 1.0.3
+* structural contract.
+*
+* In development a structural failure throws (caught early); in production it
+* logs a warning and returns (the statement is still sent — see the design's
+* Error Handling table). Uses a `zod/v4` schema rather than `ajv` + an
+* external JSON Schema to keep `lk-core` dependency-free.
+*
+* NOTE: `ActivitySchemaError` is reused here per the task spec; its
+* `activityType` field carries the sentinel `'xAPIStatement'`. A dedicated
+* `XAPIValidationError` would be semantically cleaner — flagged for review.
+*/
+function validateXAPIStatement(statement) {
+	const result = statementSchema.safeParse(statement);
+	if (result.success) return;
+	const errors = result.error.issues.map((issue) => ({
+		path: issue.path.map(String),
+		message: issue.message,
+		code: issue.code
+	}));
+	if (isProduction()) {
+		console.warn("[learning-kit] Invalid xAPI statement (sent anyway):", errors);
+		return;
+	}
+	throw new require_registry.ActivitySchemaError("xAPIStatement", errors);
+}
+//#endregion
+//#region src/xapi/verbs.ts
+/**
+* The set of xAPI verbs emitted by SDK activities, keyed by a stable
+* identifier mapped to its canonical xAPI verb IRI (xAPI 1.0.3 / ADL registry).
+*/
+const XAPIVerb = {
+	ANSWERED: "http://adlnet.gov/expapi/verbs/answered",
+	COMPLETED: "http://adlnet.gov/expapi/verbs/completed",
+	EXPERIENCED: "http://adlnet.gov/expapi/verbs/experienced",
+	INTERACTED: "http://adlnet.gov/expapi/verbs/interacted",
+	ATTEMPTED: "http://adlnet.gov/expapi/verbs/attempted",
+	PASSED: "http://adlnet.gov/expapi/verbs/passed",
+	FAILED: "http://adlnet.gov/expapi/verbs/failed",
+	WATCHED: "https://w3id.org/xapi/video/verbs/watched",
+	/**
+	* Emitted for deferred-grading submissions (e.g. written-response): the
+	* learner has submitted work whose grade does not exist yet, so `answered`
+	* (which implies a scored response) would be wrong. xAPI 1.0.3 defines no
+	* canonical "submit" verb; the Activity Streams 1.0 IRI is the established
+	* community choice.
+	*/
+	SUBMITTED: "http://activitystrea.ms/schema/1.0/submit",
+	/**
+	* Emitted when an asynchronous grader produces a grade for work that was
+	* previously only SUBMITTED. Distinct from `answered`, which asserts the
+	* grade existed at submission time — here the learner acted earlier and the
+	* grade arrived later, often from a different actor (an AI or a teacher).
+	*/
+	SCORED: "http://adlnet.gov/expapi/verbs/scored"
+};
+/**
+* Default `en-US` display label for each verb, used to populate
+* `XAPIVerbObject.display` when the builder resolves a verb key.
+*/
+const XAPI_VERB_DISPLAY = {
+	ANSWERED: { "en-US": "answered" },
+	COMPLETED: { "en-US": "completed" },
+	EXPERIENCED: { "en-US": "experienced" },
+	INTERACTED: { "en-US": "interacted" },
+	ATTEMPTED: { "en-US": "attempted" },
+	PASSED: { "en-US": "passed" },
+	FAILED: { "en-US": "failed" },
+	WATCHED: { "en-US": "watched" },
+	SUBMITTED: { "en-US": "submitted" },
+	SCORED: { "en-US": "scored" }
+};
+//#endregion
+//#region src/xapi/builder.ts
+/**
+* Converts a millisecond duration to an ISO 8601 seconds string with
+* centisecond precision (`PT1.23S`), per the xAPI 1.0.3 recommendation of
+* 0.01-second accuracy. Sub-second durations are preserved (previously any
+* duration under 500 ms collapsed to `PT0S`). Negative inputs (clock skew)
+* clamp to zero — a negative ISO duration is invalid.
+*/
+function msToIsoDuration(ms) {
+	return `PT${(Math.round(Math.max(0, ms) / 10) / 100).toFixed(2)}S`;
+}
+/**
+* UUID v4 that works outside secure contexts. `crypto.randomUUID` is
+* SecureContext-gated (undefined on plain-http LAN/staging origins), and a
+* statement is built at SUBMIT time — throwing here would lose the learner's
+* answer. `crypto.getRandomValues` is NOT gated, so the fallback still emits
+* a spec-valid v4 UUID (the statement validator enforces the v4 format).
+*/
+function uuidv4() {
+	const c = globalThis.crypto;
+	if (c?.randomUUID) return c.randomUUID();
+	const bytes = /* @__PURE__ */ new Uint8Array(16);
+	if (c?.getRandomValues) c.getRandomValues(bytes);
+	else for (let i = 0; i < 16; i += 1) bytes[i] = Math.floor(Math.random() * 256);
+	bytes[6] = bytes[6] & 15 | 64;
+	bytes[8] = bytes[8] & 63 | 128;
+	const hex = [...bytes].map((b) => b.toString(16).padStart(2, "0")).join("");
+	return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+}
+/** Builds the xAPI Activity object, including `definition` only when populated. */
+function buildObject(params) {
+	const definition = {
+		...params.name !== void 0 ? { name: params.name } : {},
+		...params.description !== void 0 ? { description: params.description } : {},
+		...params.type !== void 0 ? { type: params.type } : {},
+		...params.interactionType !== void 0 ? { interactionType: params.interactionType } : {},
+		...params.correctResponsesPattern !== void 0 ? { correctResponsesPattern: params.correctResponsesPattern } : {},
+		...params.choices !== void 0 ? { choices: params.choices } : {}
+	};
+	return {
+		objectType: "Activity",
+		id: params.id,
+		...Object.keys(definition).length > 0 ? { definition } : {}
+	};
+}
+/**
+* Maps a {@link ScoringResult} + timing to an {@link XAPIResult} per the
+* normative mapping in the design document.
+*/
+function buildResult(timeSpentMs, scoringResult, resultExtensions, response) {
+	return {
+		completion: true,
+		duration: msToIsoDuration(timeSpentMs),
+		...scoringResult !== void 0 ? {
+			score: {
+				scaled: scoringResult.score,
+				raw: scoringResult.score,
+				min: 0,
+				max: scoringResult.maxScore
+			},
+			success: scoringResult.passed
+		} : {},
+		...response !== void 0 ? { response } : {},
+		...resultExtensions !== void 0 ? { extensions: resultExtensions } : {}
+	};
+}
+/**
+* Constructs xAPI 1.0.3 Statements. Every call stamps a fresh UUID v4 `id`,
+* an ISO 8601 `timestamp`, and `version: '1.0.3'`. Not pure by design —
+* statements are unique events.
+*/
+const xAPIBuilder = {
+	buildStatement(params) {
+		const statement = {
+			id: uuidv4(),
+			actor: params.actor,
+			verb: {
+				id: XAPIVerb[params.verb],
+				display: XAPI_VERB_DISPLAY[params.verb]
+			},
+			object: buildObject(params.object),
+			...params.result !== void 0 ? { result: params.result } : {},
+			...params.context !== void 0 ? { context: params.context } : {},
+			timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+			version: "1.0.3"
+		};
+		validateXAPIStatement(statement);
+		return statement;
+	},
+	buildAnsweredStatement(params) {
+		return this.buildStatement({
+			actor: params.actor,
+			verb: "ANSWERED",
+			object: params.object,
+			result: buildResult(params.timeSpentMs, params.scoringResult, params.resultExtensions, params.response),
+			...params.context !== void 0 ? { context: params.context } : {}
+		});
+	},
+	/**
+	* Builds a statement for a deferred-grading submission (e.g. a written
+	* response). Verb is SUBMITTED and the result deliberately omits `score`,
+	* `success`, and `completion` — none of them exist until the asynchronous
+	* grader runs; only `duration`, `response`, and extensions are recorded.
+	*/
+	buildSubmittedStatement(params) {
+		return this.buildStatement({
+			actor: params.actor,
+			verb: "SUBMITTED",
+			object: params.object,
+			result: {
+				duration: msToIsoDuration(params.timeSpentMs),
+				...params.response !== void 0 ? { response: params.response } : {},
+				...params.resultExtensions !== void 0 ? { extensions: params.resultExtensions } : {}
+			},
+			...params.context !== void 0 ? { context: params.context } : {}
+		});
+	},
+	buildCompletedStatement(params) {
+		return this.buildStatement({
+			actor: params.actor,
+			verb: "COMPLETED",
+			object: params.object,
+			result: buildResult(params.timeSpentMs, params.scoringResult, params.resultExtensions, void 0),
+			...params.context !== void 0 ? { context: params.context } : {}
+		});
+	}
+};
+/**
+* Builds the xAPI `object.definition` interop fields for an activity from its
+* REGISTERED descriptor, rather than having every renderer hand-roll them.
+*
+* `ActivityTypeDescriptor.interop` declares the activity-type IRI, the
+* cmi.interaction type and how to derive `correctResponsesPattern`; before
+* this, those fields had no reader anywhere and each component rebuilt the
+* same strings inline — the same "declared but never used" defect the SDK
+* fixed elsewhere. Reading them here also means a consumer-registered type
+* gets correct interop for free.
+*
+* Returns an empty object for an unregistered type or one that declares no
+* interop, so it is always safe to spread.
+*/
+function xapiDefinitionFor(data) {
+	const interop = require_registry.getActivityTypeDescriptor(data.type)?.interop;
+	if (interop === void 0) return {};
+	const pattern = interop.correctResponsesPattern?.(data);
+	return {
+		...interop.xapiActivityTypeIri !== void 0 ? { type: interop.xapiActivityTypeIri } : {},
+		...interop.xapiInteractionType !== void 0 ? { interactionType: interop.xapiInteractionType } : {},
+		...pattern !== void 0 && pattern.length > 0 ? { correctResponsesPattern: pattern } : {}
+	};
+}
+//#endregion
+Object.defineProperty(exports, "XAPIVerb", {
+	enumerable: true,
+	get: function() {
+		return XAPIVerb;
+	}
+});
+Object.defineProperty(exports, "XAPI_VERB_DISPLAY", {
+	enumerable: true,
+	get: function() {
+		return XAPI_VERB_DISPLAY;
+	}
+});
+Object.defineProperty(exports, "validateXAPIStatement", {
+	enumerable: true,
+	get: function() {
+		return validateXAPIStatement;
+	}
+});
+Object.defineProperty(exports, "xAPIBuilder", {
+	enumerable: true,
+	get: function() {
+		return xAPIBuilder;
+	}
+});
+Object.defineProperty(exports, "xapiDefinitionFor", {
+	enumerable: true,
+	get: function() {
+		return xapiDefinitionFor;
+	}
+});
+
+//# sourceMappingURL=xapi-DNzkSJ0S.cjs.map

package/dist/xapi-DNzkSJ0S.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"xapi-DNzkSJ0S.cjs","names":["z","ActivitySchemaError","getActivityTypeDescriptor"],"sources":["../src/xapi/validators.ts","../src/xapi/verbs.ts","../src/xapi/builder.ts"],"sourcesContent":["import * as z from 'zod/v4';\nimport { ActivitySchemaError } from '../errors.js';\nimport type { ValidationError } from '../types/activity.js';\nimport type { XAPIStatement } from '../types/xapi.js';\n\nconst UUID_V4 = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;\n// Minimal IRI/URI check: a scheme followed by ':'.\nconst IRI = /^[a-z][a-z0-9+.-]*:/i;\n\nconst langMap = z.record(z.string(), z.string());\nconst extensions = z.record(z.string(), z.unknown());\n\nconst actorSchema = z\n  .object({\n    objectType: z.literal('Agent'),\n    name: z.string().optional(),\n    mbox: z\n      .string()\n      .regex(/^mailto:/, 'mbox must be a mailto IRI')\n      .optional(),\n    account: z.object({ homePage: z.string(), name: z.string() }).optional(),\n  })\n  .refine((actor) => actor.mbox !== undefined || actor.account !== undefined, {\n    error: 'actor must be identified by an mbox or an account',\n  });\n\nconst statementSchema = z.object({\n  id: z.string().regex(UUID_V4, 'id must be a UUID v4'),\n  actor: actorSchema,\n  verb: z.object({\n    id: z.string().regex(IRI, 'verb.id must be an IRI'),\n    display: langMap,\n  }),\n  object: z.object({\n    objectType: z.literal('Activity'),\n    id: z.string().regex(IRI, 'object.id must be an IRI'),\n    definition: z\n      .object({\n        name: langMap.optional(),\n        description: langMap.optional(),\n        type: z.string().optional(),\n        interactionType: z.string().optional(),\n        correctResponsesPattern: z.array(z.string()).optional(),\n        choices: z.array(z.object({ id: z.string(), description: langMap.optional() })).optional(),\n        extensions: extensions.optional(),\n      })\n      .optional(),\n  }),\n  result: z\n    .object({\n      // xAPI 1.0.3 permits scaled in [-1, 1]; the SDK only emits [0, 1].\n      score: z\n        .object({\n          scaled: z.number().min(-1).max(1),\n          raw: z.number().optional(),\n          min: z.number().optional(),\n          max: z.number().optional(),\n        })\n        .optional(),\n      success: z.boolean().optional(),\n      completion: z.boolean().optional(),\n      duration: z.string().regex(/^P/, 'duration must be an ISO 8601 duration').optional(),\n      response: z.string().optional(),\n      extensions: extensions.optional(),\n    })\n    .optional(),\n  context: z\n    .object({\n      platform: z.string().optional(),\n      language: z.string().optional(),\n      contextActivities: z\n        .object({\n          parent: z\n            .array(z.object({ objectType: z.literal('Activity'), id: z.string() }))\n            .optional(),\n          grouping: z\n            .array(z.object({ objectType: z.literal('Activity'), id: z.string() }))\n            .optional(),\n          category: z\n            .array(z.object({ objectType: z.literal('Activity'), id: z.string() }))\n            .optional(),\n          other: z\n            .array(z.object({ objectType: z.literal('Activity'), id: z.string() }))\n            .optional(),\n        })\n        .optional(),\n      extensions: extensions.optional(),\n    })\n    .optional(),\n  timestamp: z\n    .string()\n    .refine((value) => !Number.isNaN(Date.parse(value)), 'timestamp must be ISO 8601'),\n  version: z.literal('1.0.3'),\n});\n\n/**\n * The one global this module reads by name. Declared here, not globally: this\n * package compiles without Node's types on purpose, and nothing else in it may\n * come to rely on `process`.\n */\ndeclare const process: { env: { NODE_ENV?: string } };\n\n/**\n * Whether this is a production build.\n *\n * **The literal `process.env.NODE_ENV`, spelled exactly so.** It is the one\n * expression bundlers replace at build time, and a browser has no `process` to\n * read at run time. The reading this replaces,\n * `globalThis.process?.env?.NODE_ENV`, is not that expression, so no bundler\n * touched it, and in a browser it found no `process` and answered \"not\n * production\" in every production app — so a malformed statement threw there\n * instead of being logged and sent. Tests running in Node never saw it,\n * because Node has a `process`.\n *\n * This package's own build must leave the literal in its output, for the\n * consumer's bundler to replace. The `try` covers code that reaches a runtime\n * unbundled, with no `process` at all: that is not production, as it always\n * was.\n */\nfunction isProduction(): boolean {\n  try {\n    return process.env.NODE_ENV === 'production';\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Validates a constructed {@link XAPIStatement} against the xAPI 1.0.3\n * structural contract.\n *\n * In development a structural failure throws (caught early); in production it\n * logs a warning and returns (the statement is still sent — see the design's\n * Error Handling table). Uses a `zod/v4` schema rather than `ajv` + an\n * external JSON Schema to keep `lk-core` dependency-free.\n *\n * NOTE: `ActivitySchemaError` is reused here per the task spec; its\n * `activityType` field carries the sentinel `'xAPIStatement'`. A dedicated\n * `XAPIValidationError` would be semantically cleaner — flagged for review.\n */\nexport function validateXAPIStatement(statement: XAPIStatement): void {\n  const result = statementSchema.safeParse(statement);\n  if (result.success) {\n    return;\n  }\n\n  const errors: ValidationError[] = result.error.issues.map((issue) => ({\n    path: issue.path.map(String),\n    message: issue.message,\n    code: issue.code,\n  }));\n\n  if (isProduction()) {\n    console.warn('[learning-kit] Invalid xAPI statement (sent anyway):', errors);\n    return;\n  }\n\n  throw new ActivitySchemaError('xAPIStatement', errors);\n}\n","/**\n * The set of xAPI verbs emitted by SDK activities, keyed by a stable\n * identifier mapped to its canonical xAPI verb IRI (xAPI 1.0.3 / ADL registry).\n */\nexport const XAPIVerb = {\n  ANSWERED: 'http://adlnet.gov/expapi/verbs/answered',\n  COMPLETED: 'http://adlnet.gov/expapi/verbs/completed',\n  EXPERIENCED: 'http://adlnet.gov/expapi/verbs/experienced',\n  INTERACTED: 'http://adlnet.gov/expapi/verbs/interacted',\n  ATTEMPTED: 'http://adlnet.gov/expapi/verbs/attempted',\n  PASSED: 'http://adlnet.gov/expapi/verbs/passed',\n  FAILED: 'http://adlnet.gov/expapi/verbs/failed',\n  WATCHED: 'https://w3id.org/xapi/video/verbs/watched',\n  /**\n   * Emitted for deferred-grading submissions (e.g. written-response): the\n   * learner has submitted work whose grade does not exist yet, so `answered`\n   * (which implies a scored response) would be wrong. xAPI 1.0.3 defines no\n   * canonical \"submit\" verb; the Activity Streams 1.0 IRI is the established\n   * community choice.\n   */\n  SUBMITTED: 'http://activitystrea.ms/schema/1.0/submit',\n  /**\n   * Emitted when an asynchronous grader produces a grade for work that was\n   * previously only SUBMITTED. Distinct from `answered`, which asserts the\n   * grade existed at submission time — here the learner acted earlier and the\n   * grade arrived later, often from a different actor (an AI or a teacher).\n   */\n  SCORED: 'http://adlnet.gov/expapi/verbs/scored',\n} as const;\n\n/** Union of the valid `XAPIVerb` keys. */\nexport type XAPIVerbKey = keyof typeof XAPIVerb;\n\n/**\n * Default `en-US` display label for each verb, used to populate\n * `XAPIVerbObject.display` when the builder resolves a verb key.\n */\nexport const XAPI_VERB_DISPLAY: Record<XAPIVerbKey, Record<string, string>> = {\n  ANSWERED: { 'en-US': 'answered' },\n  COMPLETED: { 'en-US': 'completed' },\n  EXPERIENCED: { 'en-US': 'experienced' },\n  INTERACTED: { 'en-US': 'interacted' },\n  ATTEMPTED: { 'en-US': 'attempted' },\n  PASSED: { 'en-US': 'passed' },\n  FAILED: { 'en-US': 'failed' },\n  WATCHED: { 'en-US': 'watched' },\n  SUBMITTED: { 'en-US': 'submitted' },\n  SCORED: { 'en-US': 'scored' },\n};\n","import { getActivityTypeDescriptor } from '../registry/index.js';\nimport type { ScoringResult } from '../types/activity.js';\nimport type {\n  XAPIActor,\n  XAPIContext,\n  XAPIObject,\n  XAPIResult,\n  XAPIStatement,\n} from '../types/xapi.js';\nimport { validateXAPIStatement } from './validators.js';\nimport { XAPI_VERB_DISPLAY, XAPIVerb, type XAPIVerbKey } from './verbs.js';\n\n/** Caller-supplied activity object descriptor (mapped to an xAPI Activity). */\nexport interface XAPIObjectParams {\n  /** Activity IRI. */\n  id: string;\n  name?: Record<string, string>;\n  description?: Record<string, string>;\n  /** Activity type IRI. */\n  type?: string;\n  /** xAPI cmi.interaction type (e.g. `choice`, `fill-in`, `long-fill-in`). */\n  interactionType?: string;\n  /** Correct-responses patterns, per the xAPI CRP format. */\n  correctResponsesPattern?: string[];\n  /** For choice-family interactions: the available components. */\n  choices?: Array<{ id: string; description?: Record<string, string> }>;\n}\n\n/** Parameters for the generic {@link xAPIBuilder.buildStatement}. */\nexport interface XAPIStatementParams {\n  actor: XAPIActor;\n  verb: XAPIVerbKey;\n  object: XAPIObjectParams;\n  result?: XAPIResult;\n  context?: XAPIContext;\n}\n\n/** Parameters for {@link xAPIBuilder.buildAnsweredStatement} (verb = ANSWERED). */\nexport interface AnsweredStatementParams {\n  actor: XAPIActor;\n  object: XAPIObjectParams;\n  scoringResult: ScoringResult;\n  timeSpentMs: number;\n  /** Serialized learner response string. */\n  response?: string;\n  context?: XAPIContext;\n  resultExtensions?: Record<string, unknown>;\n}\n\n/**\n * Parameters for {@link xAPIBuilder.buildSubmittedStatement} (verb =\n * SUBMITTED — deferred-grading submissions). Carries NO score, success, or\n * completion: the grade does not exist yet.\n */\nexport interface SubmittedStatementParams {\n  actor: XAPIActor;\n  object: XAPIObjectParams;\n  timeSpentMs: number;\n  /** Serialized learner response string (e.g. the submitted text). */\n  response?: string;\n  context?: XAPIContext;\n  resultExtensions?: Record<string, unknown>;\n}\n\n/** Parameters for {@link xAPIBuilder.buildCompletedStatement} (verb = COMPLETED). */\nexport interface CompletedStatementParams {\n  actor: XAPIActor;\n  object: XAPIObjectParams;\n  scoringResult?: ScoringResult;\n  timeSpentMs: number;\n  context?: XAPIContext;\n  resultExtensions?: Record<string, unknown>;\n}\n\n/**\n * Converts a millisecond duration to an ISO 8601 seconds string with\n * centisecond precision (`PT1.23S`), per the xAPI 1.0.3 recommendation of\n * 0.01-second accuracy. Sub-second durations are preserved (previously any\n * duration under 500 ms collapsed to `PT0S`). Negative inputs (clock skew)\n * clamp to zero — a negative ISO duration is invalid.\n */\nfunction msToIsoDuration(ms: number): string {\n  return `PT${(Math.round(Math.max(0, ms) / 10) / 100).toFixed(2)}S`;\n}\n\n/**\n * UUID v4 that works outside secure contexts. `crypto.randomUUID` is\n * SecureContext-gated (undefined on plain-http LAN/staging origins), and a\n * statement is built at SUBMIT time — throwing here would lose the learner's\n * answer. `crypto.getRandomValues` is NOT gated, so the fallback still emits\n * a spec-valid v4 UUID (the statement validator enforces the v4 format).\n */\nfunction uuidv4(): string {\n  const c = (\n    globalThis as {\n      crypto?: { randomUUID?: () => string; getRandomValues?: (a: Uint8Array) => Uint8Array };\n    }\n  ).crypto;\n  if (c?.randomUUID) {\n    return c.randomUUID();\n  }\n  const bytes = new Uint8Array(16);\n  if (c?.getRandomValues) {\n    c.getRandomValues(bytes);\n  } else {\n    for (let i = 0; i < 16; i += 1) {\n      bytes[i] = Math.floor(Math.random() * 256);\n    }\n  }\n  bytes[6] = ((bytes[6] as number) & 0x0f) | 0x40;\n  bytes[8] = ((bytes[8] as number) & 0x3f) | 0x80;\n  const hex = [...bytes].map((b) => b.toString(16).padStart(2, '0')).join('');\n  return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;\n}\n\n/** Builds the xAPI Activity object, including `definition` only when populated. */\nfunction buildObject(params: XAPIObjectParams): XAPIObject {\n  const definition: NonNullable<XAPIObject['definition']> = {\n    ...(params.name !== undefined ? { name: params.name } : {}),\n    ...(params.description !== undefined ? { description: params.description } : {}),\n    ...(params.type !== undefined ? { type: params.type } : {}),\n    ...(params.interactionType !== undefined ? { interactionType: params.interactionType } : {}),\n    ...(params.correctResponsesPattern !== undefined\n      ? { correctResponsesPattern: params.correctResponsesPattern }\n      : {}),\n    ...(params.choices !== undefined ? { choices: params.choices } : {}),\n  };\n  return {\n    objectType: 'Activity',\n    id: params.id,\n    ...(Object.keys(definition).length > 0 ? { definition } : {}),\n  };\n}\n\n/**\n * Maps a {@link ScoringResult} + timing to an {@link XAPIResult} per the\n * normative mapping in the design document.\n */\nfunction buildResult(\n  timeSpentMs: number,\n  scoringResult: ScoringResult | undefined,\n  resultExtensions: Record<string, unknown> | undefined,\n  response: string | undefined,\n): XAPIResult {\n  return {\n    completion: true,\n    duration: msToIsoDuration(timeSpentMs),\n    ...(scoringResult !== undefined\n      ? {\n          score: {\n            scaled: scoringResult.score,\n            raw: scoringResult.score,\n            min: 0,\n            max: scoringResult.maxScore,\n          },\n          success: scoringResult.passed,\n        }\n      : {}),\n    ...(response !== undefined ? { response } : {}),\n    ...(resultExtensions !== undefined ? { extensions: resultExtensions } : {}),\n  };\n}\n\n/**\n * Constructs xAPI 1.0.3 Statements. Every call stamps a fresh UUID v4 `id`,\n * an ISO 8601 `timestamp`, and `version: '1.0.3'`. Not pure by design —\n * statements are unique events.\n */\nexport const xAPIBuilder = {\n  buildStatement(params: XAPIStatementParams): XAPIStatement {\n    const statement: XAPIStatement = {\n      id: uuidv4(),\n      actor: params.actor,\n      verb: {\n        id: XAPIVerb[params.verb],\n        display: XAPI_VERB_DISPLAY[params.verb],\n      },\n      object: buildObject(params.object),\n      ...(params.result !== undefined ? { result: params.result } : {}),\n      ...(params.context !== undefined ? { context: params.context } : {}),\n      timestamp: new Date().toISOString(),\n      version: '1.0.3',\n    };\n    // Design xAPIBuilder step 4: validate every statement (throws in dev,\n    // warns in prod). All build*Statement helpers route through here.\n    validateXAPIStatement(statement);\n    return statement;\n  },\n\n  buildAnsweredStatement(params: AnsweredStatementParams): XAPIStatement {\n    return this.buildStatement({\n      actor: params.actor,\n      verb: 'ANSWERED',\n      object: params.object,\n      result: buildResult(\n        params.timeSpentMs,\n        params.scoringResult,\n        params.resultExtensions,\n        params.response,\n      ),\n      ...(params.context !== undefined ? { context: params.context } : {}),\n    });\n  },\n\n  /**\n   * Builds a statement for a deferred-grading submission (e.g. a written\n   * response). Verb is SUBMITTED and the result deliberately omits `score`,\n   * `success`, and `completion` — none of them exist until the asynchronous\n   * grader runs; only `duration`, `response`, and extensions are recorded.\n   */\n  buildSubmittedStatement(params: SubmittedStatementParams): XAPIStatement {\n    return this.buildStatement({\n      actor: params.actor,\n      verb: 'SUBMITTED',\n      object: params.object,\n      result: {\n        duration: msToIsoDuration(params.timeSpentMs),\n        ...(params.response !== undefined ? { response: params.response } : {}),\n        ...(params.resultExtensions !== undefined ? { extensions: params.resultExtensions } : {}),\n      },\n      ...(params.context !== undefined ? { context: params.context } : {}),\n    });\n  },\n\n  buildCompletedStatement(params: CompletedStatementParams): XAPIStatement {\n    return this.buildStatement({\n      actor: params.actor,\n      verb: 'COMPLETED',\n      object: params.object,\n      result: buildResult(\n        params.timeSpentMs,\n        params.scoringResult,\n        params.resultExtensions,\n        undefined,\n      ),\n      ...(params.context !== undefined ? { context: params.context } : {}),\n    });\n  },\n};\n\n/**\n * Builds the xAPI `object.definition` interop fields for an activity from its\n * REGISTERED descriptor, rather than having every renderer hand-roll them.\n *\n * `ActivityTypeDescriptor.interop` declares the activity-type IRI, the\n * cmi.interaction type and how to derive `correctResponsesPattern`; before\n * this, those fields had no reader anywhere and each component rebuilt the\n * same strings inline — the same \"declared but never used\" defect the SDK\n * fixed elsewhere. Reading them here also means a consumer-registered type\n * gets correct interop for free.\n *\n * Returns an empty object for an unregistered type or one that declares no\n * interop, so it is always safe to spread.\n */\nexport function xapiDefinitionFor(data: { type: string }): Partial<XAPIObjectParams> {\n  const descriptor = getActivityTypeDescriptor(data.type);\n  const interop = descriptor?.interop;\n  if (interop === undefined) {\n    return {};\n  }\n  const pattern = interop.correctResponsesPattern?.(data);\n  return {\n    ...(interop.xapiActivityTypeIri !== undefined ? { type: interop.xapiActivityTypeIri } : {}),\n    ...(interop.xapiInteractionType !== undefined\n      ? { interactionType: interop.xapiInteractionType }\n      : {}),\n    ...(pattern !== undefined && pattern.length > 0 ? { correctResponsesPattern: pattern } : {}),\n  };\n}\n"],"mappings":"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"}

package/dist/xapi.cjs

@@ -1,16 +1,7 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
-
-
-
-
-
-var _chunkTJJFKKH2cjs = require('./chunk-TJJFKKH2.cjs');
-require('./chunk-DSDXL3JO.cjs');
-
-
-
-
-
-
-exports.XAPIVerb = _chunkTJJFKKH2cjs.XAPIVerb; exports.XAPI_VERB_DISPLAY = _chunkTJJFKKH2cjs.XAPI_VERB_DISPLAY; exports.validateXAPIStatement = _chunkTJJFKKH2cjs.validateXAPIStatement; exports.xAPIBuilder = _chunkTJJFKKH2cjs.xAPIBuilder; exports.xapiDefinitionFor = _chunkTJJFKKH2cjs.xapiDefinitionFor;
-//# sourceMappingURL=xapi.cjs.map
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_xapi = require("./xapi-DNzkSJ0S.cjs");
+exports.XAPIVerb = require_xapi.XAPIVerb;
+exports.XAPI_VERB_DISPLAY = require_xapi.XAPI_VERB_DISPLAY;
+exports.validateXAPIStatement = require_xapi.validateXAPIStatement;
+exports.xAPIBuilder = require_xapi.xAPIBuilder;
+exports.xapiDefinitionFor = require_xapi.xapiDefinitionFor;

package/dist/xapi.d.cts

@@ -1,150 +1,2 @@
-import { aC as XAPIActor, at as ScoringResult, aE as XAPIContext, aI as XAPIResult, aK as XAPIStatement } from './activity-MBOYLBjR.cjs';
-
-/**
- * The set of xAPI verbs emitted by SDK activities, keyed by a stable
- * identifier mapped to its canonical xAPI verb IRI (xAPI 1.0.3 / ADL registry).
- */
-declare const XAPIVerb: {
-    readonly ANSWERED: "http://adlnet.gov/expapi/verbs/answered";
-    readonly COMPLETED: "http://adlnet.gov/expapi/verbs/completed";
-    readonly EXPERIENCED: "http://adlnet.gov/expapi/verbs/experienced";
-    readonly INTERACTED: "http://adlnet.gov/expapi/verbs/interacted";
-    readonly ATTEMPTED: "http://adlnet.gov/expapi/verbs/attempted";
-    readonly PASSED: "http://adlnet.gov/expapi/verbs/passed";
-    readonly FAILED: "http://adlnet.gov/expapi/verbs/failed";
-    readonly WATCHED: "https://w3id.org/xapi/video/verbs/watched";
-    /**
-     * Emitted for deferred-grading submissions (e.g. written-response): the
-     * learner has submitted work whose grade does not exist yet, so `answered`
-     * (which implies a scored response) would be wrong. xAPI 1.0.3 defines no
-     * canonical "submit" verb; the Activity Streams 1.0 IRI is the established
-     * community choice (design decision recorded per Task 25.4).
-     */
-    readonly SUBMITTED: "http://activitystrea.ms/schema/1.0/submit";
-    /**
-     * Emitted when an asynchronous grader produces a grade for work that was
-     * previously only SUBMITTED. Distinct from `answered`, which asserts the
-     * grade existed at submission time — here the learner acted earlier and the
-     * grade arrived later, often from a different actor (an AI or a teacher).
-     */
-    readonly SCORED: "http://adlnet.gov/expapi/verbs/scored";
-};
-/** Union of the valid `XAPIVerb` keys. */
-type XAPIVerbKey = keyof typeof XAPIVerb;
-/**
- * Default `en-US` display label for each verb, used to populate
- * `XAPIVerbObject.display` when the builder resolves a verb key.
- */
-declare const XAPI_VERB_DISPLAY: Record<XAPIVerbKey, Record<string, string>>;
-
-/** Caller-supplied activity object descriptor (mapped to an xAPI Activity). */
-interface XAPIObjectParams {
-    /** Activity IRI. */
-    id: string;
-    name?: Record<string, string>;
-    description?: Record<string, string>;
-    /** Activity type IRI. */
-    type?: string;
-    /** xAPI cmi.interaction type (e.g. `choice`, `fill-in`, `long-fill-in`). */
-    interactionType?: string;
-    /** Correct-responses patterns, per the xAPI CRP format. */
-    correctResponsesPattern?: string[];
-    /** For choice-family interactions: the available components. */
-    choices?: Array<{
-        id: string;
-        description?: Record<string, string>;
-    }>;
-}
-/** Parameters for the generic {@link xAPIBuilder.buildStatement}. */
-interface XAPIStatementParams {
-    actor: XAPIActor;
-    verb: XAPIVerbKey;
-    object: XAPIObjectParams;
-    result?: XAPIResult;
-    context?: XAPIContext;
-}
-/** Parameters for {@link xAPIBuilder.buildAnsweredStatement} (verb = ANSWERED). */
-interface AnsweredStatementParams {
-    actor: XAPIActor;
-    object: XAPIObjectParams;
-    scoringResult: ScoringResult;
-    timeSpentMs: number;
-    /** Serialized learner response string. */
-    response?: string;
-    context?: XAPIContext;
-    resultExtensions?: Record<string, unknown>;
-}
-/**
- * Parameters for {@link xAPIBuilder.buildSubmittedStatement} (verb =
- * SUBMITTED — deferred-grading submissions). Carries NO score, success, or
- * completion: the grade does not exist yet (Req 22.7).
- */
-interface SubmittedStatementParams {
-    actor: XAPIActor;
-    object: XAPIObjectParams;
-    timeSpentMs: number;
-    /** Serialized learner response string (e.g. the submitted text). */
-    response?: string;
-    context?: XAPIContext;
-    resultExtensions?: Record<string, unknown>;
-}
-/** Parameters for {@link xAPIBuilder.buildCompletedStatement} (verb = COMPLETED). */
-interface CompletedStatementParams {
-    actor: XAPIActor;
-    object: XAPIObjectParams;
-    scoringResult?: ScoringResult;
-    timeSpentMs: number;
-    context?: XAPIContext;
-    resultExtensions?: Record<string, unknown>;
-}
-/**
- * Constructs xAPI 1.0.3 Statements. Every call stamps a fresh UUID v4 `id`,
- * an ISO 8601 `timestamp`, and `version: '1.0.3'`. Not pure by design —
- * statements are unique events.
- */
-declare const xAPIBuilder: {
-    buildStatement(params: XAPIStatementParams): XAPIStatement;
-    buildAnsweredStatement(params: AnsweredStatementParams): XAPIStatement;
-    /**
-     * Builds a statement for a deferred-grading submission (e.g. a written
-     * response). Verb is SUBMITTED and the result deliberately omits `score`,
-     * `success`, and `completion` — none of them exist until the asynchronous
-     * grader runs; only `duration`, `response`, and extensions are recorded.
-     */
-    buildSubmittedStatement(params: SubmittedStatementParams): XAPIStatement;
-    buildCompletedStatement(params: CompletedStatementParams): XAPIStatement;
-};
-/**
- * Builds the xAPI `object.definition` interop fields for an activity from its
- * REGISTERED descriptor, rather than having every renderer hand-roll them.
- *
- * `ActivityTypeDescriptor.interop` declares the activity-type IRI, the
- * cmi.interaction type and how to derive `correctResponsesPattern`; before
- * this, those fields had no reader anywhere and each component rebuilt the
- * same strings inline — the same "declared but never used" defect the SDK
- * fixed elsewhere. Reading them here also means a consumer-registered type
- * gets correct interop for free.
- *
- * Returns an empty object for an unregistered type or one that declares no
- * interop, so it is always safe to spread.
- */
-declare function xapiDefinitionFor(data: {
-    type: string;
-}): Partial<XAPIObjectParams>;
-
-/**
- * Validates a constructed {@link XAPIStatement} against the xAPI 1.0.3
- * structural contract.
- *
- * In development a structural failure throws (caught early); in production it
- * logs a warning and returns (the statement is still sent — see the design's
- * Error Handling table). Uses a `zod/v4` schema rather than `ajv` + an
- * external JSON Schema to keep `lk-core` dependency-free.
- *
- * NOTE: `ActivitySchemaError` is reused here per the task spec; its
- * `activityType` field carries the sentinel `'xAPIStatement'`. A dedicated
- * `XAPIValidationError` would be semantically cleaner — flagged for review.
- */
-declare function validateXAPIStatement(statement: XAPIStatement): void;
-
-export { type AnsweredStatementParams, type CompletedStatementParams, type SubmittedStatementParams, type XAPIObjectParams, type XAPIStatementParams, XAPIVerb, type XAPIVerbKey, XAPI_VERB_DISPLAY, validateXAPIStatement, xAPIBuilder, xapiDefinitionFor };
+import { a as XAPIObjectParams, c as xapiDefinitionFor, d as XAPI_VERB_DISPLAY, i as SubmittedStatementParams, l as XAPIVerb, n as AnsweredStatementParams, o as XAPIStatementParams, r as CompletedStatementParams, s as xAPIBuilder, t as validateXAPIStatement, u as XAPIVerbKey } from "./index-CXyOV8sm.cjs";
+export { type AnsweredStatementParams, type CompletedStatementParams, type SubmittedStatementParams, type XAPIObjectParams, type XAPIStatementParams, XAPIVerb, type XAPIVerbKey, XAPI_VERB_DISPLAY, validateXAPIStatement, xAPIBuilder, xapiDefinitionFor };