@intellectif/lk-core 1.5.0 → 1.7.0

package/dist/index.js

@@ -1,10 +1,10 @@
-import { A as checkAiCoaching, B as checkAiExplanation, C as createItemGroupDraft, D as AI_COACHING_MAX_TIP_LENGTH, E as validateItemGroupDraft, F as aiExplanationRequest, H as hintRevealsAnswer, I as aiGradeOf, L as aiHintRequest, M as AI_HINT_TYPES, N as AI_TEXT_MAX_LENGTH, O as AI_COACHING_MAX_WORDS, P as aiAllowedByContent, R as aiSupports, S as createInteractiveVideoDraft, T as critiqueItemGroupDraft, U as readAiTextResult, V as checkAiHint, W as AI_MATERIAL_MAX_LENGTH, _ as aiCritiqueRequest, a as checkAiGrading, b as critiqueDraft, c as AI_DRAFTS_MAX_COUNT, d as aiDraftsRequest, f as checkAiDrafts, g as AI_CRITIQUE_MAX_FINDINGS, h as AI_CRITIQUE_MAX_FIELD_LENGTH, i as aiGradingRequest, j as AI_EXPLANATION_TYPES, k as aiCoachingRequest, l as AI_DRAFTS_MAX_REPAIRS, m as interactiveVideoFromDrafts, n as checkAiWritingFeedback, o as AI_WRITING_MAX_CORRECTIONS, p as generateDrafts, r as AI_GRADING_PROBABILITY_TOLERANCE, s as AI_WRITING_MAX_FIELD_LENGTH, t as aiWritingFeedbackRequest, u as aiDraftsRepairRequest, v as checkAiCritique, w as critiqueDrafts, x as validateDraft, y as createDraft, z as buildAiFacts } from "./ai-writing-D8PdhJJz.js";
-import { $ as RedactedScoringError, A as levenshteinDistance, C as READ_ALOUD_MAX_TAKES, I as countWords, Q as DeferredScoringError, S as READ_ALOUD_MAX_SECONDS, T as SPEECH_ASSESSMENT_MAX_WORDS, Z as ActivitySchemaError, a as readSchema, at as DICTATION_MAX_ACCEPTED_TRANSCRIPTS, b as READ_ALOUD_MAX_DIMENSION_WEIGHT, c as dictationType, ct as DICTATION_MAX_TEXT_LENGTH, d as multipleChoiceType, et as UnknownActivityTypeError, f as readAloudType, h as defineActivityType, ht as isBuiltInActivityType, it as dictationReferenceWords, j as matchText, l as fillInTheBlanksType, lt as DICTATION_MAX_TRANSCRIPT_LENGTH, m as guardOf, n as registerActivityType, nt as alignDictation, ot as DICTATION_MAX_EQUIVALENCES, p as writtenResponseType, pt as BUILT_IN_ACTIVITY_TYPES, r as registeredActivityTypes, s as MEDIA_FIELD_POLICY, st as DICTATION_MAX_EQUIVALENCE_LENGTH, t as getActivityTypeDescriptor, u as gapSelectType, x as READ_ALOUD_MAX_REFERENCE_LENGTH } from "./registry-DaZRpqjW.js";
-import { A as DEFAULT_ITEM_SCORING_POLICY, C as contentHash, D as classifyBand, E as computePassThreshold, M as resolveItemScoringPolicy, N as scoreTries, O as gte, P as validateItemScoringPolicy, S as canonicalJson, T as DEFAULT_PASS_THRESHOLD, _ as gradeFromRubric, a as inspectWav, b as calibrationReport, c as validateSpeechAssessment, d as inAuditSample, f as outcomeFromRoutedGrade, g as gradeFromJudgement, h as seededShuffle, i as outcomeFromUnscorable, j as ITEM_SCORING_MAX_RETRIES, k as roundGrade, l as diffDictationChars, m as hashSeed, n as evaluateTries, o as gradeReadAloud, p as routeGrade, r as score, s as alignReadAloud, t as evaluate, u as composeAssessmentScore, v as hasGrade, w as fingerprint, x as graderConfiguration, y as outcomeFromGrade } from "./scoring-BKNNTz-s.js";
-import { a as INTERACTIVE_VIDEO_ITEM_TYPES, c as TIMELINE_MAX_QUIZZES, i as validateItemGroup, l as TIMELINE_MAX_TITLE_LENGTH, n as RedactedItemGroupSchema, o as TIMELINE_MAX_CHAPTERS, s as TIMELINE_MAX_ITEMS, u as isInteractiveVideoItemType } from "./item-group-DdSUCUjM.js";
-import { a as fillInTheBlanksJsonSchema, c as jsonSchemaFor, d as stimulusJsonSchema, f as writtenResponseJsonSchema, i as dictationJsonSchema, l as multipleChoiceJsonSchema, n as validateMedia, o as gapSelectJsonSchema, r as validateOptionMedia, s as itemGroupJsonSchema, t as validateActivity, u as readAloudJsonSchema } from "./schemas-BioKFf3F.js";
-import { a as validateXAPIStatement, i as XAPI_VERB_DISPLAY, n as xapiDefinitionFor, r as XAPIVerb, t as xAPIBuilder } from "./xapi-wR6gu4qS.js";
-//#region src/delivery.ts
+import { A as AI_COACHING_MAX_TIP_LENGTH, B as aiHintRequest, C as createItemGroupDraft, D as listMediaRefs, E as validateItemGroupDraft, F as AI_HINT_TYPES, G as hintRevealsAnswer, H as buildAiFacts, I as AI_TEXT_MAX_LENGTH, K as readAiTextResult, L as aiAllowedByContent, M as aiCoachingRequest, N as checkAiCoaching, O as mapMediaRefs, P as AI_EXPLANATION_TYPES, R as aiExplanationRequest, S as createInteractiveVideoDraft, T as critiqueItemGroupDraft, U as checkAiExplanation, V as aiSupports, W as checkAiHint, _ as aiCritiqueRequest, a as checkAiGrading, b as critiqueDraft, c as AI_DRAFTS_MAX_COUNT, d as aiDraftsRequest, f as checkAiDrafts, g as AI_CRITIQUE_MAX_FINDINGS, h as AI_CRITIQUE_MAX_FIELD_LENGTH, i as aiGradingRequest, j as AI_COACHING_MAX_WORDS, k as transcriptOf, l as AI_DRAFTS_MAX_REPAIRS, m as interactiveVideoFromDrafts, n as checkAiWritingFeedback, o as AI_WRITING_MAX_CORRECTIONS, p as generateDrafts, q as AI_MATERIAL_MAX_LENGTH, r as AI_GRADING_PROBABILITY_TOLERANCE, s as AI_WRITING_MAX_FIELD_LENGTH, t as aiWritingFeedbackRequest, u as aiDraftsRepairRequest, v as checkAiCritique, w as critiqueDrafts, x as validateDraft, y as createDraft, z as aiGradeOf } from "./ai-writing-B7oMCt66.js";
+import { $ as DeferredScoringError, C as READ_ALOUD_MAX_TAKES, L as countWords, M as matchText, Q as ActivitySchemaError, S as READ_ALOUD_MAX_SECONDS, T as SPEECH_ASSESSMENT_MAX_WORDS, Tt as SCRIPT_MAX_TURNS, a as readSchema, at as dictationReferenceWords, b as READ_ALOUD_MAX_DIMENSION_WEIGHT, c as dictationType, ct as DICTATION_MAX_EQUIVALENCE_LENGTH, d as multipleChoiceType, et as RedactedScoringError, f as readAloudType, gt as isBuiltInActivityType, h as defineActivityType, j as levenshteinDistance, l as fillInTheBlanksType, lt as DICTATION_MAX_TEXT_LENGTH, m as guardOf, mt as BUILT_IN_ACTIVITY_TYPES, n as registerActivityType, ot as DICTATION_MAX_ACCEPTED_TRANSCRIPTS, p as writtenResponseType, r as registeredActivityTypes, rt as alignDictation, s as MEDIA_FIELD_POLICY, st as DICTATION_MAX_EQUIVALENCES, t as getActivityTypeDescriptor, tt as UnknownActivityTypeError, u as gapSelectType, ut as DICTATION_MAX_TRANSCRIPT_LENGTH, x as READ_ALOUD_MAX_REFERENCE_LENGTH } from "./registry-D92hz9iA.js";
+import { A as DEFAULT_ITEM_SCORING_POLICY, C as contentHash, D as classifyBand, E as computePassThreshold, M as resolveItemScoringPolicy, N as scoreTries, O as gte, P as validateItemScoringPolicy, S as canonicalJson, T as DEFAULT_PASS_THRESHOLD, _ as gradeFromRubric, a as inspectWav, b as calibrationReport, c as validateSpeechAssessment, d as inAuditSample, f as outcomeFromRoutedGrade, g as gradeFromJudgement, h as seededShuffle, i as outcomeFromUnscorable, j as ITEM_SCORING_MAX_RETRIES, k as roundGrade, l as diffDictationChars, m as hashSeed, n as evaluateTries, o as gradeReadAloud, p as routeGrade, r as score, s as alignReadAloud, t as evaluate, u as composeAssessmentScore, v as hasGrade, w as fingerprint, x as graderConfiguration, y as outcomeFromGrade } from "./scoring-DD1GHcLI.js";
+import { a as INTERACTIVE_VIDEO_ITEM_TYPES, c as TIMELINE_MAX_QUIZZES, i as validateItemGroup, l as TIMELINE_MAX_TITLE_LENGTH, n as RedactedItemGroupSchema, o as TIMELINE_MAX_CHAPTERS, s as TIMELINE_MAX_ITEMS, u as isInteractiveVideoItemType } from "./item-group-CeDk7mfM.js";
+import { a as dictationJsonSchema, c as itemGroupJsonSchema, d as readAloudJsonSchema, f as stimulusJsonSchema, i as contentJsonSchema, l as jsonSchemaFor, n as validateMedia, o as fillInTheBlanksJsonSchema, p as writtenResponseJsonSchema, r as validateOptionMedia, s as gapSelectJsonSchema, t as validateActivity, u as multipleChoiceJsonSchema } from "./schemas-C7TViWCg.js";
+import { a as validateXAPIStatement, i as XAPI_VERB_DISPLAY, n as xapiDefinitionFor, r as XAPIVerb, t as xAPIBuilder } from "./xapi-Cgicg-zU.js";
+// src/delivery.ts
 /**
 * The policy that restricts nothing: every setting `true`. It is what an absent
 * policy resolves to, and it is exactly the behaviour the SDK had before
@@ -158,8 +158,7 @@ function validateDeliveryPolicy(policy) {
 		data: given
 	};
 }
-//#endregion
-//#region src/item-group.ts
+// src/item-group.ts
 /** Narrows a sequence entry to an item group. */
 function isItemGroup(entry) {
 	return entry.type === "item-group";
@@ -283,8 +282,7 @@ function flattenSequence(entries, options = {}) {
 	}
 	return slots;
 }
-//#endregion
-//#region src/media-budget.ts
+// src/media-budget.ts
 /**
 * The authored-entry prefix of a slot id: `"3"` for both `"3"` and `"3.1"`.
 *
@@ -398,8 +396,7 @@ function restoreMediaPlayLedger(plan, stored) {
 	if (stored.planHash !== plan.planHash) throw new Error(`restoreMediaPlayLedger: this ledger belongs to a different paper (ledger ${stored.planHash}, plan ${plan.planHash}). Restoring it would hold the learner to a play budget from an exam they never sat.`);
 	return serializeMediaPlayLedger(plan, stored.entries, { ...stored.savedAt !== void 0 ? { savedAt: stored.savedAt } : {} });
 }
-//#endregion
-//#region src/attempt-plan.ts
+// src/attempt-plan.ts
 /**
 * The activity as CONTENT, with its slot key removed.
 *
@@ -650,8 +647,7 @@ function scoredItemsFromPlan(plan, outcomes, options = {}) {
 		outcome: Object.hasOwn(outcomes, slot.slotId) ? outcomes[slot.slotId] : missingOutcome(slot, policy)
 	}));
 }
-//#endregion
-//#region src/attempt-state.ts
+// src/attempt-state.ts
 /**
 * A DEEP copy of the responses.
 *
@@ -775,8 +771,7 @@ function diffResponses(before, after) {
 	}
 	return entries;
 }
-//#endregion
-//#region src/redact.ts
+// src/redact.ts
 /** Merges per-call overrides over a registered policy, one level deep. */
 function mergePolicy(base, overrides) {
 	if (overrides === void 0) return base;
@@ -906,7 +901,8 @@ const ITEM_GROUP_FIELD_POLICY = {
 		media: MEDIA_FIELD_POLICY,
 		locale: "public",
 		attribution: "public",
-		transcript: "author-only"
+		transcript: "author-only",
+		script: "author-only"
 	},
 	timeline: {
 		cues: {
@@ -993,8 +989,56 @@ function assertRedactedItemGroup(data) {
 		}
 	});
 }
-//#endregion
-//#region src/timeline.ts
+/** 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" ? getActivityTypeDescriptor(type) : void 0;
+	if (descriptor === void 0) throw new 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 } : {}
+	};
+}
+// src/timeline.ts
 /**
 * Reads a stored {@link MediaProgress}. Never throws: anything that is not one
 * — a string, a stale shape, an object whose getters throw — answers `null`,
@@ -1048,7 +1092,6 @@ function composeTimelineScore(entryKey, items, policy) {
 		items: own
 	}], policy);
 }
-//#endregion
-export { AI_COACHING_MAX_TIP_LENGTH, AI_COACHING_MAX_WORDS, AI_CRITIQUE_MAX_FIELD_LENGTH, AI_CRITIQUE_MAX_FINDINGS, AI_DRAFTS_MAX_COUNT, AI_DRAFTS_MAX_REPAIRS, AI_EXPLANATION_TYPES, AI_GRADING_PROBABILITY_TOLERANCE, AI_HINT_TYPES, AI_MATERIAL_MAX_LENGTH, AI_TEXT_MAX_LENGTH, AI_WRITING_MAX_CORRECTIONS, AI_WRITING_MAX_FIELD_LENGTH, ActivitySchemaError, BUILT_IN_ACTIVITY_TYPES, DEFAULT_ITEM_SCORING_POLICY, DEFAULT_PASS_THRESHOLD, DICTATION_MAX_ACCEPTED_TRANSCRIPTS, DICTATION_MAX_EQUIVALENCES, DICTATION_MAX_EQUIVALENCE_LENGTH, DICTATION_MAX_TEXT_LENGTH, DICTATION_MAX_TRANSCRIPT_LENGTH, DeferredScoringError, INTERACTIVE_VIDEO_ITEM_TYPES, ITEM_SCORING_MAX_RETRIES, OPEN_DELIVERY_POLICY, READ_ALOUD_MAX_DIMENSION_WEIGHT, READ_ALOUD_MAX_REFERENCE_LENGTH, READ_ALOUD_MAX_SECONDS, READ_ALOUD_MAX_TAKES, RedactedScoringError, SPEECH_ASSESSMENT_MAX_WORDS, TIMELINE_MAX_CHAPTERS, TIMELINE_MAX_ITEMS, TIMELINE_MAX_QUIZZES, TIMELINE_MAX_TITLE_LENGTH, UnknownActivityTypeError, XAPIVerb, XAPI_VERB_DISPLAY, aiAllowedByContent, aiCoachingRequest, aiCritiqueRequest, aiDraftsRepairRequest, aiDraftsRequest, aiExplanationRequest, aiGradeOf, aiGradingRequest, aiHintRequest, aiSupports, aiWritingFeedbackRequest, alignDictation, alignReadAloud, assertRedacted, assertRedactedItemGroup, buildAiFacts, calibrationReport, canonicalJson, checkAiCoaching, checkAiCritique, checkAiDrafts, checkAiExplanation, checkAiGrading, checkAiHint, checkAiWritingFeedback, classifyBand, combineDeliveryPolicies, composeAssessmentScore, composeTimelineScore, computePassThreshold, contentHash, countWords, createDraft, createInteractiveVideoDraft, createItemGroupDraft, critiqueDraft, critiqueDrafts, critiqueItemGroupDraft, defineActivityType, dictationJsonSchema, dictationReferenceWords, dictationType, diffDictationChars, diffResponses, entryKeyOf, evaluate, evaluateTries, fillInTheBlanksJsonSchema, fillInTheBlanksType, fingerprint, flattenSequence, gapSelectJsonSchema, gapSelectType, generateDrafts, getActivityTypeDescriptor, gradeFromJudgement, gradeFromRubric, gradeReadAloud, graderConfiguration, gte, hasGrade, hashSeed, hintRevealsAnswer, inAuditSample, inspectWav, interactiveVideoFromDrafts, isBuiltInActivityType, isInteractiveVideoItemType, isItemGroup, itemGroupJsonSchema, jsonSchemaFor, levenshteinDistance, matchText, multipleChoiceJsonSchema, multipleChoiceType, outcomeFromGrade, outcomeFromRoutedGrade, outcomeFromUnscorable, planAttempt, planMediaBudgets, readAiTextResult, readAloudJsonSchema, readAloudType, readMediaProgress, redact, redactItemGroup, registerActivityType, registeredActivityTypes, resolveDeliveryPolicy, resolveItemScoringPolicy, resolvePlaybackPolicy, restoreAttemptState, restoreMediaPlayLedger, roundGrade, routeGrade, score, scoreTries, scoredItemsFromPlan, seededShuffle, serializeAttemptState, serializeMediaPlayLedger, slotMediaKey, stimulusJsonSchema, stimulusMediaKey, validateActivity, validateDeliveryPolicy, validateDraft, validateItemGroup, validateItemGroupDraft, validateItemScoringPolicy, validateMedia, validateOptionMedia, validateSpeechAssessment, validateXAPIStatement, verifyAttemptPlan, writtenResponseJsonSchema, writtenResponseType, xAPIBuilder, xapiDefinitionFor };
+export { AI_COACHING_MAX_TIP_LENGTH, AI_COACHING_MAX_WORDS, AI_CRITIQUE_MAX_FIELD_LENGTH, AI_CRITIQUE_MAX_FINDINGS, AI_DRAFTS_MAX_COUNT, AI_DRAFTS_MAX_REPAIRS, AI_EXPLANATION_TYPES, AI_GRADING_PROBABILITY_TOLERANCE, AI_HINT_TYPES, AI_MATERIAL_MAX_LENGTH, AI_TEXT_MAX_LENGTH, AI_WRITING_MAX_CORRECTIONS, AI_WRITING_MAX_FIELD_LENGTH, ActivitySchemaError, BUILT_IN_ACTIVITY_TYPES, DEFAULT_ITEM_SCORING_POLICY, DEFAULT_PASS_THRESHOLD, DICTATION_MAX_ACCEPTED_TRANSCRIPTS, DICTATION_MAX_EQUIVALENCES, DICTATION_MAX_EQUIVALENCE_LENGTH, DICTATION_MAX_TEXT_LENGTH, DICTATION_MAX_TRANSCRIPT_LENGTH, DeferredScoringError, INTERACTIVE_VIDEO_ITEM_TYPES, ITEM_SCORING_MAX_RETRIES, OPEN_DELIVERY_POLICY, READ_ALOUD_MAX_DIMENSION_WEIGHT, READ_ALOUD_MAX_REFERENCE_LENGTH, READ_ALOUD_MAX_SECONDS, READ_ALOUD_MAX_TAKES, RedactedScoringError, SCRIPT_MAX_TURNS, SPEECH_ASSESSMENT_MAX_WORDS, TIMELINE_MAX_CHAPTERS, TIMELINE_MAX_ITEMS, TIMELINE_MAX_QUIZZES, TIMELINE_MAX_TITLE_LENGTH, UnknownActivityTypeError, XAPIVerb, XAPI_VERB_DISPLAY, aiAllowedByContent, aiCoachingRequest, aiCritiqueRequest, aiDraftsRepairRequest, aiDraftsRequest, aiExplanationRequest, aiGradeOf, aiGradingRequest, aiHintRequest, aiSupports, aiWritingFeedbackRequest, alignDictation, alignReadAloud, assertRedacted, assertRedactedItemGroup, buildAiFacts, calibrationReport, canonicalJson, checkAiCoaching, checkAiCritique, checkAiDrafts, checkAiExplanation, checkAiGrading, checkAiHint, checkAiWritingFeedback, classifyBand, combineDeliveryPolicies, composeAssessmentScore, composeTimelineScore, computePassThreshold, contentHash, contentJsonSchema, countWords, createDraft, createInteractiveVideoDraft, createItemGroupDraft, critiqueDraft, critiqueDrafts, critiqueItemGroupDraft, defineActivityType, dictationJsonSchema, dictationReferenceWords, dictationType, diffDictationChars, diffResponses, entryKeyOf, evaluate, evaluateTries, fillInTheBlanksJsonSchema, fillInTheBlanksType, fingerprint, flattenSequence, gapSelectJsonSchema, gapSelectType, generateDrafts, getActivityTypeDescriptor, gradeFromJudgement, gradeFromRubric, gradeReadAloud, graderConfiguration, gte, hasGrade, hashSeed, hintRevealsAnswer, inAuditSample, inspectWav, interactiveVideoFromDrafts, isBuiltInActivityType, isInteractiveVideoItemType, isItemGroup, itemGroupJsonSchema, jsonSchemaFor, levenshteinDistance, listMediaRefs, mapMediaRefs, matchText, multipleChoiceJsonSchema, multipleChoiceType, outcomeFromGrade, outcomeFromRoutedGrade, outcomeFromUnscorable, planAttempt, planMediaBudgets, readAiTextResult, readAloudJsonSchema, readAloudType, readMediaProgress, redact, redactItemGroup, registerActivityType, registeredActivityTypes, resolveDeliveryPolicy, resolveItemScoringPolicy, resolvePlaybackPolicy, restoreAttemptState, restoreMediaPlayLedger, roundGrade, routeGrade, score, scoreTries, scoredItemsFromPlan, seededShuffle, serializeAttemptState, serializeMediaPlayLedger, slotMediaKey, stimulusJsonSchema, stimulusMediaKey, transcriptOf, validateActivity, validateDeliveryPolicy, validateDraft, validateItemGroup, validateItemGroupDraft, validateItemScoringPolicy, validateMedia, validateOptionMedia, validateSpeechAssessment, validateXAPIStatement, verifyAttemptPlan, withoutAuthorOnly, writtenResponseJsonSchema, writtenResponseType, xAPIBuilder, xapiDefinitionFor };
 
 //# sourceMappingURL=index.js.map