@intellectif/lk-core 1.4.0 → 1.6.0

package/dist/index.cjs

@@ -1,82 +1,10 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_registry = require("./registry-DVi0LR_i.cjs");
-const require_ai_writing = require("./ai-writing-G6tnCGzw.cjs");
-const require_scoring = require("./scoring-B2_HEhMT.cjs");
-const require_item_group = require("./item-group-DroFXgLb.cjs");
-const require_schemas = require("./schemas-DVbAOrtd.cjs");
-const require_xapi = require("./xapi-DNzkSJ0S.cjs");
-//#region src/content-hash.ts
-/**
-* Content fingerprinting — "is this the same content the learner was served?"
-*
-* A recorded attempt outlives the content it was taken against. Papers get
-* corrected, a typo is fixed, an option is reworded — and six months later a
-* remark, an appeal, or a per-item analysis is run against content that is no
-* longer what the learner saw. Nothing warns anybody, because the ids all still
-* match. A fingerprint stored with the attempt turns that silent drift into a
-* question somebody can answer.
-*/
-/**
-* Deterministic JSON: object keys sorted, arrays left in order, `undefined`
-* omitted from objects (matching `JSON.stringify`) and rendered as `null`
-* inside arrays.
-*
-* Key order is the whole point. Two objects that differ only in the order
-* their keys happened to be written are the SAME content, and a fingerprint
-* that disagreed would raise a false alarm every time a payload made a
-* round-trip through a different serializer.
-*/
-function canonicalJson(value, seen = /* @__PURE__ */ new Set()) {
-	if (value === null) return "null";
-	if (typeof value === "number") return Number.isFinite(value) ? JSON.stringify(value === 0 ? 0 : value) : `"#${String(value)}"`;
-	if (typeof value === "string" || typeof value === "boolean") return JSON.stringify(value);
-	if (typeof value === "bigint") return `"#${value.toString()}n"`;
-	if (typeof value === "object") {
-		if (seen.has(value)) throw new Error("canonicalJson: the value contains a circular reference and cannot be fingerprinted.");
-		seen.add(value);
-		try {
-			if (Array.isArray(value)) return `[${value.map((element) => element === void 0 ? "null" : canonicalJson(element, seen)).join(",")}]`;
-			const source = value;
-			const parts = [];
-			for (const key of Object.keys(source).sort()) {
-				const entry = source[key];
-				if (entry === void 0) continue;
-				parts.push(`${JSON.stringify(key)}:${canonicalJson(entry, seen)}`);
-			}
-			return `{${parts.join(",")}}`;
-		} finally {
-			seen.delete(value);
-		}
-	}
-	return "null";
-}
-const FNV_OFFSET = 14695981039346656037n;
-const FNV_PRIME = 1099511628211n;
-const MASK64 = (1n << 64n) - 1n;
-/**
-* FNV-1a over the UTF-8 bytes of `input`, as 16 lowercase hex digits.
-*
-* **This is a change-detection fingerprint, not a tamper-evident signature.**
-* It is deterministic across runtimes and dependency-free, which is what makes
-* it usable in a stored grade record — but an adversary who can edit content
-* can also, with effort, preserve the fingerprint. If you need the stronger
-* property, sign the plan with a key the content author does not hold; this
-* exists to catch honest edits, which is what actually happens.
-*/
-function fingerprint(input) {
-	const bytes = new TextEncoder().encode(input);
-	let hash = FNV_OFFSET;
-	for (const byte of bytes) hash = (hash ^ BigInt(byte)) * FNV_PRIME & MASK64;
-	return hash.toString(16).padStart(16, "0");
-}
-/**
-* Fingerprints any JSON-serialisable value through {@link canonicalJson}, so
-* the result depends on the content and not on how it was written.
-*/
-function contentHash(value) {
-	return fingerprint(canonicalJson(value));
-}
-//#endregion
+const require_registry = require("./registry-Ih5n4PVZ.cjs");
+const require_ai_writing = require("./ai-writing-C4YRVrFi.cjs");
+const require_scoring = require("./scoring-CaPS6q8b.cjs");
+const require_item_group = require("./item-group-CQRbb8Rx.cjs");
+const require_schemas = require("./schemas-Q2dyOgc2.cjs");
+const require_xapi = require("./xapi-BX0hvRRB.cjs");
 //#region src/delivery.ts
 /**
 * The policy that restricts nothing: every setting `true`. It is what an absent
@@ -232,44 +160,6 @@ function validateDeliveryPolicy(policy) {
 	};
 }
 //#endregion
-//#region src/shuffle.ts
-/**
-* Seeded, deterministic shuffling — the ONE algorithm every presentation-order
-* decision in the SDK goes through: option order in a multiple-choice item,
-* item order inside an item group, entry order in a sequence. A server and a
-* client holding the same seed derive the same order, and an order recorded
-* against an attempt can be rebuilt later from nothing but its seed.
-*
-* STABILITY: the hash and the generator are part of the wire contract. A
-* stored attempt may hold only a seed and rely on this function to reproduce
-* the order it presented; changing either would silently re-order every
-* recorded attempt. Any change here is a package major, and the pinned
-* permutation test exists so an accidental one fails loudly.
-*/
-/** FNV-1a hash of a string → unsigned 32-bit integer. */
-function hashSeed(input) {
-	let h = 2166136261;
-	for (let i = 0; i < input.length; i += 1) {
-		h ^= input.charCodeAt(i);
-		h = Math.imul(h, 16777619) >>> 0;
-	}
-	return h;
-}
-/** LCG-driven Fisher–Yates over a 32-bit seed; returns a permutation (no loss, no duplicate). */
-function shuffleWithSeed(items, seed, version) {
-	const out = [...items];
-	let s = seed >>> 0 || 1;
-	for (let i = out.length - 1; i > 0; i -= 1) {
-		s = Math.imul(s, 1664525) + 1013904223 >>> 0;
-		const j = version === 2 ? Math.floor(s / 4294967296 * (i + 1)) : s % (i + 1);
-		[out[i], out[j]] = [out[j], out[i]];
-	}
-	return out;
-}
-function seededShuffle(items, seed, options = {}) {
-	return shuffleWithSeed(items, hashSeed(seed), options.version ?? 1);
-}
-//#endregion
 //#region src/item-group.ts
 /** Narrows a sequence entry to an item group. */
 function isItemGroup(entry) {
@@ -342,7 +232,7 @@ function flattenSequence(entries, options = {}) {
 		entry,
 		entryIndex
 	}));
-	const ordered = shuffleEntries ? seededShuffle(authored, `${seed}:entries`, { version: 1 }) : authored;
+	const ordered = shuffleEntries ? require_scoring.seededShuffle(authored, `${seed}:entries`, { version: 1 }) : authored;
 	const slots = [];
 	for (const { entry, entryIndex } of ordered) {
 		const entryKey = keyOf(entry) ?? String(entryIndex);
@@ -361,7 +251,7 @@ function flattenSequence(entries, options = {}) {
 			item,
 			itemIndex
 		}));
-		const presented = timeline !== void 0 ? inQuizOrder(items, timeline) : entry.shuffle === "within-group" ? seededShuffle(items, `${seed}:group:${entry.id}`, { version: 1 }) : items;
+		const presented = timeline !== void 0 ? inQuizOrder(items, timeline) : entry.shuffle === "within-group" ? require_scoring.seededShuffle(items, `${seed}:group:${entry.id}`, { version: 1 }) : items;
 		const size = presented.length;
 		presented.forEach(({ item, itemIndex }, position) => {
 			const cue = timeline?.cues.find((candidate) => candidate.itemIds.includes(item.id));
@@ -579,11 +469,11 @@ function planSlot(slot, points) {
 		activityId: slot.activity.id,
 		activityType: slot.activity.type,
 		points,
-		contentHash: contentHash(contentOf(slot.activity)),
+		contentHash: require_scoring.contentHash(contentOf(slot.activity)),
 		...slot.group !== void 0 ? { group: {
 			id: slot.group.id,
 			...slot.group.title !== void 0 ? { title: slot.group.title } : {},
-			stimulusHash: contentHash(slot.group.stimulus),
+			stimulusHash: require_scoring.contentHash(slot.group.stimulus),
 			...slot.group.cue !== void 0 ? { cue: {
 				id: slot.group.cue.id,
 				at: slot.group.cue.at,
@@ -624,7 +514,7 @@ function planAttempt(entries, options = {}) {
 		planVersion: "1.0",
 		...seed !== void 0 ? { seed } : {},
 		...shuffleEntries !== void 0 ? { shuffleEntries } : {},
-		planHash: contentHash(delivery === void 0 && scoring === void 0 ? planned : {
+		planHash: require_scoring.contentHash(delivery === void 0 && scoring === void 0 ? planned : {
 			slots: planned,
 			...delivery !== void 0 ? { delivery } : {},
 			...scoring !== void 0 ? { scoring } : {}
@@ -669,14 +559,14 @@ function verifyAttemptPlan(plan, current) {
 	const changedCueSlotIds = [];
 	const changedPointsSlotIds = [];
 	const reorderedSlotIds = [];
-	const deliveryChanged = contentHash(plan.delivery ?? null) !== contentHash(current.delivery ?? null);
-	const scoringChanged = contentHash(plan.scoring ?? null) !== contentHash(current.scoring ?? null);
+	const deliveryChanged = require_scoring.contentHash(plan.delivery ?? null) !== require_scoring.contentHash(current.delivery ?? null);
+	const scoringChanged = require_scoring.contentHash(plan.scoring ?? null) !== require_scoring.contentHash(current.scoring ?? null);
 	for (const slot of plan.slots) {
 		const now = after.get(slot.slotId);
 		if (now === void 0) continue;
 		if (now.contentHash !== slot.contentHash) changedSlotIds.push(slot.slotId);
 		if (now.group?.stimulusHash !== slot.group?.stimulusHash) changedStimulusSlotIds.push(slot.slotId);
-		if (contentHash(now.group?.cue ?? null) !== contentHash(slot.group?.cue ?? null)) changedCueSlotIds.push(slot.slotId);
+		if (require_scoring.contentHash(now.group?.cue ?? null) !== require_scoring.contentHash(slot.group?.cue ?? null)) changedCueSlotIds.push(slot.slotId);
 		if (now.points !== slot.points) changedPointsSlotIds.push(slot.slotId);
 		if (now.index !== slot.index) reorderedSlotIds.push(slot.slotId);
 	}
@@ -877,7 +767,7 @@ function diffResponses(before, after) {
 			});
 			continue;
 		}
-		if (canonicalJson(from) !== canonicalJson(to)) entries.push({
+		if (require_scoring.canonicalJson(from) !== require_scoring.canonicalJson(to)) entries.push({
 			slotId,
 			change: "changed",
 			...from !== void 0 ? { before: from } : {},
@@ -925,6 +815,8 @@ function redactValue(value, policy, reveal) {
 			if (keepField(classification, reveal)) output[key] = fieldValue;
 			continue;
 		}
+		const guard = require_registry.guardOf(classification);
+		if (guard !== void 0 && !guard(fieldValue)) continue;
 		const nested = redactValue(fieldValue, classification, reveal);
 		if (nested !== void 0 && !isEmptyObject(nested)) output[key] = nested;
 	}
@@ -1015,7 +907,8 @@ const ITEM_GROUP_FIELD_POLICY = {
 		media: require_registry.MEDIA_FIELD_POLICY,
 		locale: "public",
 		attribution: "public",
-		transcript: "author-only"
+		transcript: "author-only",
+		script: "author-only"
 	},
 	timeline: {
 		cues: {
@@ -1102,6 +995,55 @@ function assertRedactedItemGroup(data) {
 		}
 	});
 }
+/** A deep copy of plain data with every field its policy calls `author-only` left out. */
+function withoutAuthorOnlyValue(value, policy) {
+	if (Array.isArray(value)) return value.map((element) => withoutAuthorOnlyValue(element, policy));
+	if (value === null || typeof value !== "object") return value;
+	const output = {};
+	for (const [key, field] of Object.entries(value)) {
+		const classification = policy?.[key];
+		if (classification === "author-only") continue;
+		output[key] = withoutAuthorOnlyValue(field, classification === void 0 || isSensitivity(classification) ? void 0 : classification);
+	}
+	return output;
+}
+/** The policy an activity is stripped under; the same one `redact()` reads. */
+function policyOf(type) {
+	const descriptor = typeof type === "string" ? require_registry.getActivityTypeDescriptor(type) : void 0;
+	if (descriptor === void 0) throw new require_registry.UnknownActivityTypeError(String(type));
+	if (descriptor.fieldPolicy === void 0) throw new Error(`Activity type "${descriptor.type}" has no fieldPolicy; withoutAuthorOnly() cannot tell which of its fields are author-only.`);
+	return descriptor.fieldPolicy;
+}
+/**
+* A copy of an activity or an item group without its `author-only` fields:
+* a recording's `transcript` and `script`, on an item's media, a
+* multiple-choice option's recording, a stimulus or its media. Everything
+* else is kept as stored, the answer key and your own fields included, and
+* the copy is not marked redacted, so it scores exactly as the stored item.
+*
+* For practice an app scores in the browser, where the learner may hold the
+* key but not the author's material. It is NOT a learner-safe projection: an
+* exam, or anything a learner must not be able to answer from the payload,
+* goes through {@link redact} / {@link redactItemGroup}, whose output a scorer
+* refuses.
+*
+* ```ts
+* res.json(withoutAuthorOnly(practiceItem));
+* ```
+*
+* @throws UnknownActivityTypeError when an activity's type is not registered,
+*   and Error when it declares no `fieldPolicy`.
+*/
+function withoutAuthorOnly(entry) {
+	if (typeof entry !== "object" || entry === null || Array.isArray(entry)) throw new TypeError("withoutAuthorOnly: expects an activity or an item group.");
+	const record = entry;
+	if (record.type !== "item-group") return withoutAuthorOnlyValue(entry, policyOf(record.type));
+	const { items, ...container } = record;
+	return {
+		...withoutAuthorOnlyValue(container, ITEM_GROUP_FIELD_POLICY),
+		...Array.isArray(items) ? { items: items.map((item) => withoutAuthorOnlyValue(item, policyOf(item?.type))) } : items !== void 0 ? { items } : {}
+	};
+}
 //#endregion
 //#region src/timeline.ts
 /**
@@ -1165,6 +1107,7 @@ exports.AI_CRITIQUE_MAX_FINDINGS = require_ai_writing.AI_CRITIQUE_MAX_FINDINGS;
 exports.AI_DRAFTS_MAX_COUNT = require_ai_writing.AI_DRAFTS_MAX_COUNT;
 exports.AI_DRAFTS_MAX_REPAIRS = require_ai_writing.AI_DRAFTS_MAX_REPAIRS;
 exports.AI_EXPLANATION_TYPES = require_ai_writing.AI_EXPLANATION_TYPES;
+exports.AI_GRADING_PROBABILITY_TOLERANCE = require_ai_writing.AI_GRADING_PROBABILITY_TOLERANCE;
 exports.AI_HINT_TYPES = require_ai_writing.AI_HINT_TYPES;
 exports.AI_MATERIAL_MAX_LENGTH = require_ai_writing.AI_MATERIAL_MAX_LENGTH;
 exports.AI_TEXT_MAX_LENGTH = require_ai_writing.AI_TEXT_MAX_LENGTH;
@@ -1188,6 +1131,7 @@ exports.READ_ALOUD_MAX_REFERENCE_LENGTH = require_registry.READ_ALOUD_MAX_REFERE
 exports.READ_ALOUD_MAX_SECONDS = require_registry.READ_ALOUD_MAX_SECONDS;
 exports.READ_ALOUD_MAX_TAKES = require_registry.READ_ALOUD_MAX_TAKES;
 exports.RedactedScoringError = require_registry.RedactedScoringError;
+exports.SCRIPT_MAX_TURNS = require_registry.SCRIPT_MAX_TURNS;
 exports.SPEECH_ASSESSMENT_MAX_WORDS = require_registry.SPEECH_ASSESSMENT_MAX_WORDS;
 exports.TIMELINE_MAX_CHAPTERS = require_item_group.TIMELINE_MAX_CHAPTERS;
 exports.TIMELINE_MAX_ITEMS = require_item_group.TIMELINE_MAX_ITEMS;
@@ -1203,6 +1147,7 @@ exports.aiDraftsRepairRequest = require_ai_writing.aiDraftsRepairRequest;
 exports.aiDraftsRequest = require_ai_writing.aiDraftsRequest;
 exports.aiExplanationRequest = require_ai_writing.aiExplanationRequest;
 exports.aiGradeOf = require_ai_writing.aiGradeOf;
+exports.aiGradingRequest = require_ai_writing.aiGradingRequest;
 exports.aiHintRequest = require_ai_writing.aiHintRequest;
 exports.aiSupports = require_ai_writing.aiSupports;
 exports.aiWritingFeedbackRequest = require_ai_writing.aiWritingFeedbackRequest;
@@ -1211,11 +1156,13 @@ exports.alignReadAloud = require_scoring.alignReadAloud;
 exports.assertRedacted = assertRedacted;
 exports.assertRedactedItemGroup = assertRedactedItemGroup;
 exports.buildAiFacts = require_ai_writing.buildAiFacts;
-exports.canonicalJson = canonicalJson;
+exports.calibrationReport = require_scoring.calibrationReport;
+exports.canonicalJson = require_scoring.canonicalJson;
 exports.checkAiCoaching = require_ai_writing.checkAiCoaching;
 exports.checkAiCritique = require_ai_writing.checkAiCritique;
 exports.checkAiDrafts = require_ai_writing.checkAiDrafts;
 exports.checkAiExplanation = require_ai_writing.checkAiExplanation;
+exports.checkAiGrading = require_ai_writing.checkAiGrading;
 exports.checkAiHint = require_ai_writing.checkAiHint;
 exports.checkAiWritingFeedback = require_ai_writing.checkAiWritingFeedback;
 exports.classifyBand = require_scoring.classifyBand;
@@ -1223,7 +1170,8 @@ exports.combineDeliveryPolicies = combineDeliveryPolicies;
 exports.composeAssessmentScore = require_scoring.composeAssessmentScore;
 exports.composeTimelineScore = composeTimelineScore;
 exports.computePassThreshold = require_scoring.computePassThreshold;
-exports.contentHash = contentHash;
+exports.contentHash = require_scoring.contentHash;
+exports.contentJsonSchema = require_schemas.contentJsonSchema;
 exports.countWords = require_registry.countWords;
 exports.createDraft = require_ai_writing.createDraft;
 exports.createInteractiveVideoDraft = require_ai_writing.createInteractiveVideoDraft;
@@ -1242,18 +1190,21 @@ exports.evaluate = require_scoring.evaluate;
 exports.evaluateTries = require_scoring.evaluateTries;
 exports.fillInTheBlanksJsonSchema = require_schemas.fillInTheBlanksJsonSchema;
 exports.fillInTheBlanksType = require_registry.fillInTheBlanksType;
-exports.fingerprint = fingerprint;
+exports.fingerprint = require_scoring.fingerprint;
 exports.flattenSequence = flattenSequence;
 exports.gapSelectJsonSchema = require_schemas.gapSelectJsonSchema;
 exports.gapSelectType = require_registry.gapSelectType;
 exports.generateDrafts = require_ai_writing.generateDrafts;
 exports.getActivityTypeDescriptor = require_registry.getActivityTypeDescriptor;
+exports.gradeFromJudgement = require_scoring.gradeFromJudgement;
 exports.gradeFromRubric = require_scoring.gradeFromRubric;
 exports.gradeReadAloud = require_scoring.gradeReadAloud;
+exports.graderConfiguration = require_scoring.graderConfiguration;
 exports.gte = require_scoring.gte;
 exports.hasGrade = require_scoring.hasGrade;
-exports.hashSeed = hashSeed;
+exports.hashSeed = require_scoring.hashSeed;
 exports.hintRevealsAnswer = require_ai_writing.hintRevealsAnswer;
+exports.inAuditSample = require_scoring.inAuditSample;
 exports.inspectWav = require_scoring.inspectWav;
 exports.interactiveVideoFromDrafts = require_ai_writing.interactiveVideoFromDrafts;
 exports.isBuiltInActivityType = require_registry.isBuiltInActivityType;
@@ -1262,10 +1213,13 @@ exports.isItemGroup = isItemGroup;
 exports.itemGroupJsonSchema = require_schemas.itemGroupJsonSchema;
 exports.jsonSchemaFor = require_schemas.jsonSchemaFor;
 exports.levenshteinDistance = require_registry.levenshteinDistance;
+exports.listMediaRefs = require_ai_writing.listMediaRefs;
+exports.mapMediaRefs = require_ai_writing.mapMediaRefs;
 exports.matchText = require_registry.matchText;
 exports.multipleChoiceJsonSchema = require_schemas.multipleChoiceJsonSchema;
 exports.multipleChoiceType = require_registry.multipleChoiceType;
 exports.outcomeFromGrade = require_scoring.outcomeFromGrade;
+exports.outcomeFromRoutedGrade = require_scoring.outcomeFromRoutedGrade;
 exports.outcomeFromUnscorable = require_scoring.outcomeFromUnscorable;
 exports.planAttempt = planAttempt;
 exports.planMediaBudgets = planMediaBudgets;
@@ -1283,15 +1237,17 @@ exports.resolvePlaybackPolicy = resolvePlaybackPolicy;
 exports.restoreAttemptState = restoreAttemptState;
 exports.restoreMediaPlayLedger = restoreMediaPlayLedger;
 exports.roundGrade = require_scoring.roundGrade;
+exports.routeGrade = require_scoring.routeGrade;
 exports.score = require_scoring.score;
 exports.scoreTries = require_scoring.scoreTries;
 exports.scoredItemsFromPlan = scoredItemsFromPlan;
-exports.seededShuffle = seededShuffle;
+exports.seededShuffle = require_scoring.seededShuffle;
 exports.serializeAttemptState = serializeAttemptState;
 exports.serializeMediaPlayLedger = serializeMediaPlayLedger;
 exports.slotMediaKey = slotMediaKey;
 exports.stimulusJsonSchema = require_schemas.stimulusJsonSchema;
 exports.stimulusMediaKey = stimulusMediaKey;
+exports.transcriptOf = require_ai_writing.transcriptOf;
 exports.validateActivity = require_schemas.validateActivity;
 exports.validateDeliveryPolicy = validateDeliveryPolicy;
 exports.validateDraft = require_ai_writing.validateDraft;
@@ -1303,6 +1259,7 @@ exports.validateOptionMedia = require_schemas.validateOptionMedia;
 exports.validateSpeechAssessment = require_scoring.validateSpeechAssessment;
 exports.validateXAPIStatement = require_xapi.validateXAPIStatement;
 exports.verifyAttemptPlan = verifyAttemptPlan;
+exports.withoutAuthorOnly = withoutAuthorOnly;
 exports.writtenResponseJsonSchema = require_schemas.writtenResponseJsonSchema;
 exports.writtenResponseType = require_registry.writtenResponseType;
 exports.xAPIBuilder = require_xapi.xAPIBuilder;