@happyvertical/smrt-education 0.57.41 → 0.57.43

package/dist/chunks/{workbook-photo-service-D5DUgh-C.js → workbook-photo-service-C6mbUUp6.js}

@@ -1216,6 +1216,160 @@ async function familyAdoptionOwner(db, photo) {
 	return String(family.owner_profile_id);
 }
 //#endregion
+//#region src/group-sharing-contracts.ts
+var GroupSharingAuthorizationError = class extends Error {
+	constructor(message = "Group sharing authorization denied") {
+		super(message);
+		this.name = "GroupSharingAuthorizationError";
+	}
+};
+var GroupSharingConflictError = class extends Error {
+	constructor(message = "Group sharing state conflict") {
+		super(message);
+		this.name = "GroupSharingConflictError";
+	}
+};
+var GroupSharingPolicyValidationError = class extends Error {
+	constructor(message = "Invalid group sharing policy") {
+		super(message);
+		this.name = "GroupSharingPolicyValidationError";
+	}
+};
+function record$1(value) {
+	return !!value && typeof value === "object" && !Array.isArray(value) && (Object.getPrototypeOf(value) === Object.prototype || Object.getPrototypeOf(value) === null);
+}
+function keys(value, expected) {
+	const actual = Object.keys(value);
+	return actual.length === expected.length && actual.every((key) => expected.includes(key));
+}
+function selector(value) {
+	if (!record$1(value)) return false;
+	if (value.mode === "all") return keys(value, ["mode"]);
+	return value.mode === "include" && keys(value, ["mode", "values"]) && Array.isArray(value.values) && value.values.length <= 1e3 && value.values.every((v) => typeof v === "string" && v.length > 0 && v.length <= 256 && v.trim() === v) && new Set(value.values).size === value.values.length;
+}
+function validateGroupSharingPolicy(value) {
+	const booleans = [
+		"shareWork",
+		"shareMedia",
+		"shareFeedback",
+		"shareProgress",
+		"parentReviewedOnly"
+	];
+	if (!record$1(value) || !keys(value, [
+		"schemaVersion",
+		...booleans,
+		"commentVisibility",
+		"historyFrom",
+		"subjects",
+		"courseIds"
+	]) || value.schemaVersion !== 1 || !["parent-only", "learner-visible"].includes(value.commentVisibility) || !booleans.every((key) => typeof value[key] === "boolean") || typeof value.historyFrom !== "string" || !/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$/.test(value.historyFrom) || !Number.isFinite(Date.parse(value.historyFrom)) || new Date(value.historyFrom).toISOString() !== value.historyFrom || !selector(value.subjects) || !selector(value.courseIds)) throw new GroupSharingPolicyValidationError();
+}
+function canonicalGroupSharingPolicy(value) {
+	validateGroupSharingPolicy(value);
+	const ordered = (s) => s.mode === "all" ? { mode: "all" } : {
+		mode: "include",
+		values: [...s.values].sort()
+	};
+	return JSON.stringify({
+		schemaVersion: 1,
+		shareWork: value.shareWork,
+		shareMedia: value.shareMedia,
+		shareFeedback: value.shareFeedback,
+		shareProgress: value.shareProgress,
+		parentReviewedOnly: value.parentReviewedOnly,
+		commentVisibility: value.commentVisibility,
+		historyFrom: value.historyFrom,
+		subjects: ordered(value.subjects),
+		courseIds: ordered(value.courseIds)
+	});
+}
+//#endregion
+//#region src/group-sharing-policy.ts
+function evaluateGroupSharingPolicy(policy, facts) {
+	validateGroupSharingPolicy(policy);
+	const reasons = [];
+	const captured = Date.parse(facts.capturedAt);
+	if (!Number.isFinite(captured) || !Number.isFinite(Date.parse(policy.historyFrom)) || captured < Date.parse(policy.historyFrom)) reasons.push("history");
+	if (policy.courseIds.mode === "include" && (!facts.courseId || !policy.courseIds.values.includes(facts.courseId))) reasons.push("course");
+	if (policy.subjects.mode === "include" && (!facts.subject || !policy.subjects.values.includes(facts.subject))) reasons.push("subject");
+	if (policy.parentReviewedOnly && !facts.parentReviewed) reasons.push("parent-review");
+	const eligible = reasons.length === 0;
+	return {
+		eligible,
+		work: eligible && policy.shareWork,
+		media: eligible && policy.shareWork && policy.shareMedia,
+		feedback: eligible && policy.shareFeedback,
+		progress: eligible && policy.shareProgress,
+		reasons
+	};
+}
+function summarizeWorkbookEvidence(evidence) {
+	const summaries = /* @__PURE__ */ new Map();
+	const independentSeen = /* @__PURE__ */ new Set();
+	for (const { attempt, revisionId, assessment, confirmed } of evidence) for (const q of assessment.questions) for (const conceptId of q.conceptIds) {
+		const key = `${assessment.vocabulary.namespace}:${assessment.vocabulary.version}:${conceptId}`;
+		const concept = assessment.vocabulary.concepts.find((c) => c.id === conceptId);
+		if (!concept) throw new Error("Unknown workbook concept");
+		let summary = summaries.get(key);
+		if (!summary) {
+			summary = {
+				namespace: assessment.vocabulary.namespace,
+				version: assessment.vocabulary.version,
+				conceptId,
+				label: concept.label,
+				confirmed: {
+					independent: 0,
+					assisted: 0,
+					unknown: 0,
+					correct: 0,
+					needsCorrection: 0,
+					unassessed: 0
+				},
+				provisional: 0,
+				episodes: [],
+				revisionIds: [],
+				cues: [],
+				observations: []
+			};
+			summaries.set(key, summary);
+		}
+		if (!summary.episodes.includes(attempt.episodeId)) summary.episodes.push(attempt.episodeId);
+		if (!summary.revisionIds.includes(revisionId)) summary.revisionIds.push(revisionId);
+		const assistance = attempt.previousAttemptId && attempt.assistance === "independent" ? "unknown" : attempt.assistance;
+		summary.observations.push({
+			submissionId: attempt.submissionId,
+			revisionId,
+			questionId: q.id,
+			episodeId: attempt.episodeId,
+			result: q.result,
+			assistance,
+			isCorrection: Boolean(attempt.previousAttemptId),
+			capturedAt: attempt.capturedAt,
+			confirmed
+		});
+		if (!confirmed) {
+			summary.provisional++;
+			continue;
+		}
+		if (q.result === "unassessed") {
+			summary.confirmed.unassessed++;
+			continue;
+		}
+		const episodeQuestion = `${key}:${attempt.episodeId}:${q.id}`;
+		if (assistance !== "independent" || !independentSeen.has(episodeQuestion)) summary.confirmed[assistance]++;
+		if (assistance === "independent") independentSeen.add(episodeQuestion);
+		if (q.result === "correct") summary.confirmed.correct++;
+		else summary.confirmed.needsCorrection++;
+		if (attempt.previousAttemptId && q.result === "correct" && !summary.cues.includes("improving on this item")) summary.cues.push("improving on this item");
+	}
+	for (const summary of summaries.values()) {
+		if (!summary.confirmed.independent) summary.cues.push("needs a fresh independent check");
+		if (summary.confirmed.needsCorrection) summary.cues.push("needs practice");
+		if (!summary.confirmed.correct && !summary.confirmed.needsCorrection) summary.cues.push("not enough evidence");
+	}
+	return [...summaries.values()];
+}
+//#endregion
 //#region src/workbook-contracts.ts
 var WorkbookAssessmentValidationError = class extends Error {
 	constructor(message, reason = "invalid_assessment") {
@@ -25641,6 +25795,38 @@ var SubmissionService = class SubmissionService extends LearnerService {
 	async getSubmission(request) {
 		return this.view((await this.requireSubmission(request, "education.learner.read")).row, request.actorUserId);
 	}
+	/** Latest retained completed-work evidence; lesson completion is independent. */
+	async getLatestLessonSubmission(request) {
+		const enrollment = await this.requireEnrollment(request, "education.learner.read");
+		if (!(await this.catalog(request, enrollment.courseId)).sections.some((section) => section.lessons.some(({ lesson }) => lesson.id === request.lessonId))) throw new LearnerAuthorizationError();
+		const progress = await (await LessonProgressCollection.create({ db: this.db })).get({
+			enrollmentId: request.enrollmentId,
+			learnerId: request.learnerId,
+			lessonId: request.lessonId,
+			tenantId: request.tenantId
+		}, { cache: false });
+		if (!progress) return null;
+		const [row] = await (await SubmissionCollection.create({ db: this.db })).list({
+			where: {
+				tenantId: request.tenantId,
+				learnerId: request.learnerId,
+				lessonId: request.lessonId,
+				progressId: String(progress.id),
+				kind: "completed_work",
+				"status in": [
+					"captured",
+					"needs_review",
+					"graded"
+				]
+			},
+			orderBy: ["submittedAt DESC", "id DESC"],
+			limit: 1
+		});
+		return row ? this.getSubmission({
+			...request,
+			submissionId: String(row.id)
+		}) : null;
+	}
 	async grade(request, row, progress, score, feedback) {
 		if (typeof feedback !== "string") throw new Error("Feedback must be text");
 		if (score !== null && (typeof score !== "number" || !Number.isFinite(score) || score < 0 || score > 1)) throw new Error("Score must be null or a number from zero to one");
@@ -27341,8 +27527,7 @@ var WorkbookService = class WorkbookService extends SubmissionService {
 			learnerId: request.learnerId,
 			activityId: request.activityId
 		} });
-		const summaries = /* @__PURE__ */ new Map();
-		const independentSeen = /* @__PURE__ */ new Set();
+		const evidence = [];
 		const ordered = [...attempts].sort((a, b) => Number(Boolean(a.previousAttemptId)) - Number(Boolean(b.previousAttemptId)) || String(a.id).localeCompare(String(b.id)));
 		for (const attempt of ordered) {
 			const revisions = await this.revisions(request, String(attempt.id));
@@ -27350,70 +27535,16 @@ var WorkbookService = class WorkbookService extends SubmissionService {
 			const effective = confirmed ?? revisions.filter((r) => r.kind === "ai").at(-1);
 			if (!effective) continue;
 			const assessment = revisionView(effective).assessment;
-			for (const q of assessment.questions) for (const conceptId of q.conceptIds) {
-				const key = `${assessment.vocabulary.namespace}:${assessment.vocabulary.version}:${conceptId}`;
-				let summary = summaries.get(key);
-				if (!summary) {
-					summary = {
-						namespace: assessment.vocabulary.namespace,
-						version: assessment.vocabulary.version,
-						conceptId,
-						label: assessment.vocabulary.concepts.find((c) => c.id === conceptId).label,
-						confirmed: {
-							independent: 0,
-							assisted: 0,
-							unknown: 0,
-							correct: 0,
-							needsCorrection: 0,
-							unassessed: 0
-						},
-						provisional: 0,
-						episodes: [],
-						revisionIds: [],
-						cues: [],
-						observations: []
-					};
-					summaries.set(key, summary);
-				}
-				if (!summary.episodes.includes(attempt.episodeId)) summary.episodes.push(attempt.episodeId);
-				if (!summary.revisionIds.includes(String(effective.id))) summary.revisionIds.push(String(effective.id));
-				const observationAssistance = attempt.previousAttemptId && attempt.assistance === "independent" ? "unknown" : attempt.assistance;
-				summary.observations.push({
-					submissionId: attempt.submissionId,
-					revisionId: String(effective.id),
-					questionId: q.id,
-					episodeId: attempt.episodeId,
-					result: q.result,
-					assistance: observationAssistance,
-					isCorrection: Boolean(attempt.previousAttemptId),
-					capturedAt: attempt.capturedAt,
-					confirmed: Boolean(confirmed)
-				});
-				if (!confirmed) {
-					summary.provisional++;
-					continue;
-				}
-				if (q.result === "unassessed") {
-					summary.confirmed.unassessed++;
-					continue;
-				}
-				const episodeQuestion = `${key}:${attempt.episodeId}:${q.id}`;
-				const assistance = attempt.previousAttemptId && attempt.assistance === "independent" ? "unknown" : attempt.assistance;
-				if (assistance !== "independent" || !independentSeen.has(episodeQuestion)) summary.confirmed[assistance]++;
-				if (assistance === "independent") independentSeen.add(episodeQuestion);
-				if (q.result === "correct") summary.confirmed.correct++;
-				else summary.confirmed.needsCorrection++;
-				if (attempt.previousAttemptId && q.result === "correct" && !summary.cues.includes("improving on this item")) summary.cues.push("improving on this item");
-			}
-		}
-		for (const summary of summaries.values()) {
-			if (!summary.confirmed.independent) summary.cues.push("needs a fresh independent check");
-			if (summary.confirmed.needsCorrection) summary.cues.push("needs practice");
-			if (!summary.confirmed.correct && !summary.confirmed.needsCorrection) summary.cues.push("not enough evidence");
+			evidence.push({
+				attempt,
+				revisionId: String(effective.id),
+				assessment,
+				confirmed: Boolean(confirmed)
+			});
 		}
 		return {
 			algorithmVersion: "workbook-descriptive-v1",
-			concepts: [...summaries.values()]
+			concepts: summarizeWorkbookEvidence(evidence)
 		};
 	}
 };
@@ -27910,6 +28041,6 @@ var WorkbookPhotoService = class WorkbookPhotoService extends WorkbookService {
 	}
 };
 //#endregion
-export { CourseCollection as $, WorkbookFeedbackDelivery as A, AuthoredCourse as At, validateWorkbookAssessment as B, WorkbookActivity as C, SubmissionAsset as Ct, WorkbookAttempt as D, Enrollment as Dt, WorkbookAssessmentRevisionCollection as E, Curriculum as Et, WorkbookWorkFilingCollection as F, Lesson as Ft, FamilyIntakeCollection as G, FamilyIntake as H, WORKBOOK_MATH_VOCABULARY as I, Reading as It, familyIntakeScopeId as J, FamilyIntakeDecision as K, WorkbookAssessmentValidationError as L, Video as Lt, WorkbookFeedbackRelease as M, CourseSection as Mt, WorkbookFeedbackReleaseCollection as N, Exercise as Nt, WorkbookAttemptCollection as O, Learner as Ot, WorkbookWorkFiling as P, ExternalCourse as Pt, AuthoredCourseCollection as Q, WorkbookCompletionConflictError as R, Worksheet as Rt, Workbook as S, Submission as St, WorkbookAssessmentRevision as T, LessonAsset as Tt, FamilyIntakeAsset as U, workbookAggregateFeedback as V, FamilyIntakeAssetCollection as W, CatalogService as X, CatalogAuthorizationError as Y, AttestationCollection as Z, WorkbookWorkflowRequiredError as _, WorksheetCollection as _t, WorkbookContextRevisionCollection as a, ExternalCourseCollection as at, WorkbookCompletionDecision as b, Grade as bt, WorkbookPhotoDecision as c, LessonAssetCollection as ct, WorkbookPhotoIntakeCollection as d, ReadingCollection as dt, CourseSectionCollection as et, validateWorkbookPhotoIdentification as f, ScannedSubmissionCollection as ft, SubmissionStorageCleanupError as g, VideoCollection as gt, SubmissionService as h, SubmissionIntakeBindingCollection as ht, WorkbookContextRevision as i, ExternalCompletionCollection as it, WorkbookFeedbackDeliveryCollection as j, Course as jt, WorkbookCollection as k, LessonProgress as kt, WorkbookPhotoDecisionCollection as l, LessonCollection as lt, normalizeWorkbookAnswerRegions as m, SubmissionCollection as mt, preservePhotoProposal as n, EnrollmentCollection as nt, WorkbookPhotoAsset as o, GradeCollection as ot, normalizeWorkbookObservedLayout as p, SubmissionAssetCollection as pt, FamilyIntakeDecisionCollection as q, WorkbookService as r, ExerciseCollection as rt, WorkbookPhotoAssetCollection as s, LearnerCollection as st, WorkbookPhotoService as t, CurriculumCollection as tt, WorkbookPhotoIntake as u, LessonProgressCollection as ut, LearnerAuthorizationError as v, Attestation as vt, WorkbookActivityCollection as w, SubmissionIntakeBinding as wt, WorkbookCompletionDecisionCollection as x, ScannedSubmission as xt, LearnerService as y, ExternalCompletion as yt, aggregateWorkbookQuestions as z };
+export { FamilyIntakeDecision as $, WorkbookFeedbackDelivery as A, SubmissionAsset as At, validateWorkbookAssessment as B, Exercise as Bt, WorkbookActivity as C, VideoCollection as Ct, WorkbookAttempt as D, Grade as Dt, WorkbookAssessmentRevisionCollection as E, ExternalCompletion as Et, WorkbookWorkFilingCollection as F, Learner as Ft, GroupSharingConflictError as G, Worksheet as Gt, evaluateGroupSharingPolicy as H, Lesson as Ht, WORKBOOK_MATH_VOCABULARY as I, LessonProgress as It, validateGroupSharingPolicy as J, GroupSharingPolicyValidationError as K, WorkbookAssessmentValidationError as L, AuthoredCourse as Lt, WorkbookFeedbackRelease as M, LessonAsset as Mt, WorkbookFeedbackReleaseCollection as N, Curriculum as Nt, WorkbookAttemptCollection as O, ScannedSubmission as Ot, WorkbookWorkFiling as P, Enrollment as Pt, FamilyIntakeCollection as Q, WorkbookCompletionConflictError as R, Course as Rt, Workbook as S, SubmissionIntakeBindingCollection as St, WorkbookAssessmentRevision as T, Attestation as Tt, summarizeWorkbookEvidence as U, Reading as Ut, workbookAggregateFeedback as V, ExternalCourse as Vt, GroupSharingAuthorizationError as W, Video as Wt, FamilyIntakeAsset as X, FamilyIntake as Y, FamilyIntakeAssetCollection as Z, WorkbookWorkflowRequiredError as _, LessonProgressCollection as _t, WorkbookContextRevisionCollection as a, AuthoredCourseCollection as at, WorkbookCompletionDecision as b, SubmissionAssetCollection as bt, WorkbookPhotoDecision as c, CurriculumCollection as ct, WorkbookPhotoIntakeCollection as d, ExternalCompletionCollection as dt, FamilyIntakeDecisionCollection as et, validateWorkbookPhotoIdentification as f, ExternalCourseCollection as ft, SubmissionStorageCleanupError as g, LessonCollection as gt, SubmissionService as h, LessonAssetCollection as ht, WorkbookContextRevision as i, AttestationCollection as it, WorkbookFeedbackDeliveryCollection as j, SubmissionIntakeBinding as jt, WorkbookCollection as k, Submission as kt, WorkbookPhotoDecisionCollection as l, EnrollmentCollection as lt, normalizeWorkbookAnswerRegions as m, LearnerCollection as mt, preservePhotoProposal as n, CatalogAuthorizationError as nt, WorkbookPhotoAsset as o, CourseCollection as ot, normalizeWorkbookObservedLayout as p, GradeCollection as pt, canonicalGroupSharingPolicy as q, WorkbookService as r, CatalogService as rt, WorkbookPhotoAssetCollection as s, CourseSectionCollection as st, WorkbookPhotoService as t, familyIntakeScopeId as tt, WorkbookPhotoIntake as u, ExerciseCollection as ut, LearnerAuthorizationError as v, ReadingCollection as vt, WorkbookActivityCollection as w, WorksheetCollection as wt, WorkbookCompletionDecisionCollection as x, SubmissionCollection as xt, LearnerService as y, ScannedSubmissionCollection as yt, aggregateWorkbookQuestions as z, CourseSection as zt };
 
-//# sourceMappingURL=workbook-photo-service-D5DUgh-C.js.map
+//# sourceMappingURL=workbook-photo-service-C6mbUUp6.js.map