@happyvertical/smrt-education 0.57.36 → 0.57.38

package/dist/chunks/{workbook-photo-service-1wcnf-Xf.js → workbook-photo-service-DCmqeWLd.js}

@@ -4,8 +4,8 @@ import { AssetCollection, createAssetRuntime, withPrivateAssetAccess } from "@ha
 import { TenantCollection } from "@happyvertical/smrt-users";
 //#region \0rolldown/runtime.js
 var __create = Object.create;
-var __defProp$6 = Object.defineProperty;
-var __getOwnPropDesc$6 = Object.getOwnPropertyDescriptor;
+var __defProp$7 = Object.defineProperty;
+var __getOwnPropDesc$7 = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
@@ -13,35 +13,35 @@ var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).expor
 var __copyProps = (to, from, except, desc) => {
 	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
 		key = keys[i];
-		if (!__hasOwnProp.call(to, key) && key !== except) __defProp$6(to, key, {
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp$7(to, key, {
 			get: ((k) => from[k]).bind(null, key),
-			enumerable: !(desc = __getOwnPropDesc$6(from, key)) || desc.enumerable
+			enumerable: !(desc = __getOwnPropDesc$7(from, key)) || desc.enumerable
 		});
 	}
 	return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp$6(target, "default", {
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp$7(target, "default", {
 	value: mod,
 	enumerable: true
 }) : target, mod));
 //#endregion
 //#region src/catalog.ts
-var __defProp$5 = Object.defineProperty;
-var __getOwnPropDesc$5 = Object.getOwnPropertyDescriptor;
-var __defNormalProp$5 = (obj, key, value) => key in obj ? __defProp$5(obj, key, {
+var __defProp$6 = Object.defineProperty;
+var __getOwnPropDesc$6 = Object.getOwnPropertyDescriptor;
+var __defNormalProp$6 = (obj, key, value) => key in obj ? __defProp$6(obj, key, {
 	enumerable: true,
 	configurable: true,
 	writable: true,
 	value
 }) : obj[key] = value;
-var __decorateClass$5 = (decorators, target, key, kind) => {
-	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc$5(target, key) : target;
+var __decorateClass$6 = (decorators, target, key, kind) => {
+	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc$6(target, key) : target;
 	for (var i = decorators.length - 1, decorator; i >= 0; i--) if (decorator = decorators[i]) result = (kind ? decorator(target, key, result) : decorator(result)) || result;
-	if (kind && result) __defProp$5(target, key, result);
+	if (kind && result) __defProp$6(target, key, result);
 	return result;
 };
-var __publicField$5 = (obj, key, value) => __defNormalProp$5(obj, typeof key !== "symbol" ? key + "" : key, value);
-var closed$4 = {
+var __publicField$6 = (obj, key, value) => __defNormalProp$6(obj, typeof key !== "symbol" ? key + "" : key, value);
+var closed$5 = {
 	api: false,
 	mcp: false,
 	cli: false
@@ -81,7 +81,7 @@ var Course = class extends SmrtObject {
 		applyModelOptions(this, options);
 	}
 	/** A personal copy remains pinned to its original family and license. */
-	async save() {
+	async save(options) {
 		if (this.licenseKind === "personal-use-copy" && !this.tenantId) throw new Error("personal-use-copy courses require an owning tenant");
 		if (this.licenseKind === "personal-use-copy" && this.status === "published") throw new Error("personal-use-copy courses cannot be published");
 		const prior = this.id ? await this.db.get(this.tableName, { id: this.id }) : null;
@@ -97,27 +97,27 @@ var Course = class extends SmrtObject {
 				license_kind: this.licenseKind
 			})) throw new Error("Persisted courses require explicit re-authoring to change tenant or license");
 		}
-		return await super.save();
+		return await super.save(options);
 	}
 };
-__publicField$5(Course, "__smrtPackage__", "@happyvertical/smrt-education");
-__decorateClass$5([tenantId({ nullable: true })], Course.prototype, "tenantId", 2);
-__decorateClass$5([field({ required: true })], Course.prototype, "title", 2);
-Course = __decorateClass$5([TenantScoped({ mode: "optional" }), smrt({
+__publicField$6(Course, "__smrtPackage__", "@happyvertical/smrt-education");
+__decorateClass$6([tenantId({ nullable: true })], Course.prototype, "tenantId", 2);
+__decorateClass$6([field({ required: true })], Course.prototype, "title", 2);
+Course = __decorateClass$6([TenantScoped({ mode: "optional" }), smrt({
 	tableStrategy: "sti",
-	...closed$4
+	...closed$5
 })], Course);
 var ExternalCourse = class extends Course {};
-__publicField$5(ExternalCourse, "__smrtPackage__", "@happyvertical/smrt-education");
-ExternalCourse = __decorateClass$5([smrt({
+__publicField$6(ExternalCourse, "__smrtPackage__", "@happyvertical/smrt-education");
+ExternalCourse = __decorateClass$6([smrt({
 	tableName: "courses",
-	...closed$4
+	...closed$5
 })], ExternalCourse);
 var AuthoredCourse = class extends Course {};
-__publicField$5(AuthoredCourse, "__smrtPackage__", "@happyvertical/smrt-education");
-AuthoredCourse = __decorateClass$5([smrt({
+__publicField$6(AuthoredCourse, "__smrtPackage__", "@happyvertical/smrt-education");
+AuthoredCourse = __decorateClass$6([smrt({
 	tableName: "courses",
-	...closed$4
+	...closed$5
 })], AuthoredCourse);
 var CourseSection = class extends SmrtObject {
 	tenantId = null;
@@ -128,21 +128,21 @@ var CourseSection = class extends SmrtObject {
 		super(options);
 		applyModelOptions(this, options);
 	}
-	async save() {
+	async save(options) {
 		await requireParentTenant(this, "courses", this.courseId);
 		if ((this.id ? await this.db.get("course_sections", { id: this.id }) : null) && !await this.db.get("course_sections", {
 			id: this.id,
 			course_id: this.courseId,
 			tenant_id: this.tenantId
 		})) throw new Error("Persisted sections require explicit re-authoring to change parent");
-		return await super.save();
+		return await super.save(options);
 	}
 };
-__publicField$5(CourseSection, "__smrtPackage__", "@happyvertical/smrt-education");
-__decorateClass$5([tenantId({ nullable: true })], CourseSection.prototype, "tenantId", 2);
-__decorateClass$5([foreignKey("Course", { required: true })], CourseSection.prototype, "courseId", 2);
-__decorateClass$5([field({ required: true })], CourseSection.prototype, "title", 2);
-CourseSection = __decorateClass$5([TenantScoped({ mode: "optional" }), smrt({ ...closed$4 })], CourseSection);
+__publicField$6(CourseSection, "__smrtPackage__", "@happyvertical/smrt-education");
+__decorateClass$6([tenantId({ nullable: true })], CourseSection.prototype, "tenantId", 2);
+__decorateClass$6([foreignKey("Course", { required: true })], CourseSection.prototype, "courseId", 2);
+__decorateClass$6([field({ required: true })], CourseSection.prototype, "title", 2);
+CourseSection = __decorateClass$6([TenantScoped({ mode: "optional" }), smrt({ ...closed$5 })], CourseSection);
 var Lesson = class extends SmrtObject {
 	tenantId = null;
 	sectionId = "";
@@ -159,29 +159,29 @@ var Lesson = class extends SmrtObject {
 		super(options);
 		applyModelOptions(this, options);
 	}
-	async save() {
+	async save(options) {
 		await requireParentTenant(this, "course_sections", this.sectionId);
 		if ((this.id ? await this.db.get("lessons", { id: this.id }) : null) && !await this.db.get("lessons", {
 			id: this.id,
 			section_id: this.sectionId,
 			tenant_id: this.tenantId
 		})) throw new Error("Persisted lessons require explicit re-authoring to change parent");
-		return await super.save();
+		return await super.save(options);
 	}
 };
-__publicField$5(Lesson, "__smrtPackage__", "@happyvertical/smrt-education");
-__decorateClass$5([tenantId({ nullable: true })], Lesson.prototype, "tenantId", 2);
-__decorateClass$5([foreignKey("CourseSection", { required: true })], Lesson.prototype, "sectionId", 2);
-__decorateClass$5([field({ required: true })], Lesson.prototype, "title", 2);
-Lesson = __decorateClass$5([TenantScoped({ mode: "optional" }), smrt({
+__publicField$6(Lesson, "__smrtPackage__", "@happyvertical/smrt-education");
+__decorateClass$6([tenantId({ nullable: true })], Lesson.prototype, "tenantId", 2);
+__decorateClass$6([foreignKey("CourseSection", { required: true })], Lesson.prototype, "sectionId", 2);
+__decorateClass$6([field({ required: true })], Lesson.prototype, "title", 2);
+Lesson = __decorateClass$6([TenantScoped({ mode: "optional" }), smrt({
 	tableStrategy: "sti",
-	...closed$4
+	...closed$5
 })], Lesson);
 var Reading = class extends Lesson {};
-__publicField$5(Reading, "__smrtPackage__", "@happyvertical/smrt-education");
-Reading = __decorateClass$5([smrt({
+__publicField$6(Reading, "__smrtPackage__", "@happyvertical/smrt-education");
+Reading = __decorateClass$6([smrt({
 	tableName: "lessons",
-	...closed$4
+	...closed$5
 })], Reading);
 var Video = class extends Lesson {
 	videoUrl = "";
@@ -190,10 +190,10 @@ var Video = class extends Lesson {
 		applyModelOptions(this, options);
 	}
 };
-__publicField$5(Video, "__smrtPackage__", "@happyvertical/smrt-education");
-Video = __decorateClass$5([smrt({
+__publicField$6(Video, "__smrtPackage__", "@happyvertical/smrt-education");
+Video = __decorateClass$6([smrt({
 	tableName: "lessons",
-	...closed$4
+	...closed$5
 })], Video);
 var Worksheet = class extends Lesson {
 	printableUrl = "";
@@ -205,16 +205,16 @@ var Worksheet = class extends Lesson {
 		applyModelOptions(this, options);
 	}
 };
-__publicField$5(Worksheet, "__smrtPackage__", "@happyvertical/smrt-education");
-Worksheet = __decorateClass$5([smrt({
+__publicField$6(Worksheet, "__smrtPackage__", "@happyvertical/smrt-education");
+Worksheet = __decorateClass$6([smrt({
 	tableName: "lessons",
-	...closed$4
+	...closed$5
 })], Worksheet);
 var Exercise = class extends Lesson {};
-__publicField$5(Exercise, "__smrtPackage__", "@happyvertical/smrt-education");
-Exercise = __decorateClass$5([smrt({
+__publicField$6(Exercise, "__smrtPackage__", "@happyvertical/smrt-education");
+Exercise = __decorateClass$6([smrt({
 	tableName: "lessons",
-	...closed$4
+	...closed$5
 })], Exercise);
 GlobalInterceptors.register({
 	name: "education-catalog-identity",
@@ -246,22 +246,22 @@ GlobalInterceptors.register({
 });
 //#endregion
 //#region src/learners.ts
-var __defProp$4 = Object.defineProperty;
-var __getOwnPropDesc$4 = Object.getOwnPropertyDescriptor;
-var __defNormalProp$4 = (obj, key, value) => key in obj ? __defProp$4(obj, key, {
+var __defProp$5 = Object.defineProperty;
+var __getOwnPropDesc$5 = Object.getOwnPropertyDescriptor;
+var __defNormalProp$5 = (obj, key, value) => key in obj ? __defProp$5(obj, key, {
 	enumerable: true,
 	configurable: true,
 	writable: true,
 	value
 }) : obj[key] = value;
-var __decorateClass$4 = (decorators, target, key, kind) => {
-	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc$4(target, key) : target;
+var __decorateClass$5 = (decorators, target, key, kind) => {
+	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc$5(target, key) : target;
 	for (var i = decorators.length - 1, decorator; i >= 0; i--) if (decorator = decorators[i]) result = (kind ? decorator(target, key, result) : decorator(result)) || result;
-	if (kind && result) __defProp$4(target, key, result);
+	if (kind && result) __defProp$5(target, key, result);
 	return result;
 };
-var __publicField$4 = (obj, key, value) => __defNormalProp$4(obj, typeof key !== "symbol" ? key + "" : key, value);
-var closed$3 = {
+var __publicField$5 = (obj, key, value) => __defNormalProp$5(obj, typeof key !== "symbol" ? key + "" : key, value);
+var closed$4 = {
 	api: false,
 	mcp: false,
 	cli: false
@@ -306,7 +306,7 @@ var Learner = class extends SmrtObject {
 		if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error("Learner settings must be an object");
 		this.settings = JSON.stringify(value);
 	}
-	async save() {
+	async save(options) {
 		await immutableIdentity$1(this, {
 			user_id: this.userId,
 			profile_id: this.profileId
@@ -323,14 +323,14 @@ var Learner = class extends SmrtObject {
 			status: "active"
 		})) throw new Error("Learner requires a linked user/profile and active tenant membership");
 		if (!Number.isSafeInteger(this.level) || this.level < 0) throw new Error("Learner level must be a nonnegative integer");
-		return super.save();
+		return super.save(options);
 	}
 };
-__publicField$4(Learner, "__smrtPackage__", "@happyvertical/smrt-education");
-__decorateClass$4([tenantId()], Learner.prototype, "tenantId", 2);
-__decorateClass$4([crossPackageRef("@happyvertical/smrt-users:User", { required: true })], Learner.prototype, "userId", 2);
-__decorateClass$4([crossPackageRef("@happyvertical/smrt-profiles:Profile", { required: true })], Learner.prototype, "profileId", 2);
-Learner = __decorateClass$4([TenantScoped({ mode: "required" }), smrt({ ...closed$3 })], Learner);
+__publicField$5(Learner, "__smrtPackage__", "@happyvertical/smrt-education");
+__decorateClass$5([tenantId()], Learner.prototype, "tenantId", 2);
+__decorateClass$5([crossPackageRef("@happyvertical/smrt-users:User", { required: true })], Learner.prototype, "userId", 2);
+__decorateClass$5([crossPackageRef("@happyvertical/smrt-profiles:Profile", { required: true })], Learner.prototype, "profileId", 2);
+Learner = __decorateClass$5([TenantScoped({ mode: "required" }), smrt({ ...closed$4 })], Learner);
 var Curriculum = class extends SmrtObject {
 	tenantId = "";
 	learnerId = "";
@@ -342,7 +342,7 @@ var Curriculum = class extends SmrtObject {
 		super(options);
 		applyOptions$1(this, options);
 	}
-	async save() {
+	async save(options) {
 		await immutableIdentity$1(this, { learner_id: this.learnerId });
 		requireEnum$1(this.status, [
 			"planned",
@@ -354,15 +354,15 @@ var Curriculum = class extends SmrtObject {
 			id: this.learnerId,
 			tenant_id: this.tenantId
 		})) throw new Error("Curriculum requires its tenant learner");
-		return super.save();
+		return super.save(options);
 	}
 };
-__publicField$4(Curriculum, "__smrtPackage__", "@happyvertical/smrt-education");
-__decorateClass$4([tenantId()], Curriculum.prototype, "tenantId", 2);
-__decorateClass$4([foreignKey("Learner", { required: true })], Curriculum.prototype, "learnerId", 2);
-__decorateClass$4([field({ required: true })], Curriculum.prototype, "title", 2);
-Curriculum = __decorateClass$4([TenantScoped({ mode: "required" }), smrt({
-	...closed$3,
+__publicField$5(Curriculum, "__smrtPackage__", "@happyvertical/smrt-education");
+__decorateClass$5([tenantId()], Curriculum.prototype, "tenantId", 2);
+__decorateClass$5([foreignKey("Learner", { required: true })], Curriculum.prototype, "learnerId", 2);
+__decorateClass$5([field({ required: true })], Curriculum.prototype, "title", 2);
+Curriculum = __decorateClass$5([TenantScoped({ mode: "required" }), smrt({
+	...closed$4,
 	tableName: "curricula"
 })], Curriculum);
 var Enrollment = class extends SmrtObject {
@@ -379,7 +379,7 @@ var Enrollment = class extends SmrtObject {
 		super(options);
 		applyOptions$1(this, options);
 	}
-	async save() {
+	async save(options) {
 		await immutableIdentity$1(this, {
 			curriculum_id: this.curriculumId,
 			learner_id: this.learnerId,
@@ -398,16 +398,16 @@ var Enrollment = class extends SmrtObject {
 			tenant_id: this.tenantId
 		})) throw new Error("Enrollment learner must match its tenant curriculum");
 		if (!Number.isSafeInteger(this.targetMinutesPerWeek) || this.targetMinutesPerWeek < 0) throw new Error("Target minutes must be a nonnegative integer");
-		return super.save();
+		return super.save(options);
 	}
 };
-__publicField$4(Enrollment, "__smrtPackage__", "@happyvertical/smrt-education");
-__decorateClass$4([tenantId()], Enrollment.prototype, "tenantId", 2);
-__decorateClass$4([foreignKey("Curriculum", { required: true })], Enrollment.prototype, "curriculumId", 2);
-__decorateClass$4([foreignKey("Learner", { required: true })], Enrollment.prototype, "learnerId", 2);
-__decorateClass$4([foreignKey("Course", { required: true })], Enrollment.prototype, "courseId", 2);
-Enrollment = __decorateClass$4([TenantScoped({ mode: "required" }), smrt({
-	...closed$3,
+__publicField$5(Enrollment, "__smrtPackage__", "@happyvertical/smrt-education");
+__decorateClass$5([tenantId()], Enrollment.prototype, "tenantId", 2);
+__decorateClass$5([foreignKey("Curriculum", { required: true })], Enrollment.prototype, "curriculumId", 2);
+__decorateClass$5([foreignKey("Learner", { required: true })], Enrollment.prototype, "learnerId", 2);
+__decorateClass$5([foreignKey("Course", { required: true })], Enrollment.prototype, "courseId", 2);
+Enrollment = __decorateClass$5([TenantScoped({ mode: "required" }), smrt({
+	...closed$4,
 	conflictColumns: [
 		"tenant_id",
 		"curriculum_id",
@@ -429,7 +429,7 @@ var LessonProgress = class extends SmrtObject {
 		super(options);
 		applyOptions$1(this, options);
 	}
-	async save() {
+	async save(options) {
 		await immutableIdentity$1(this, {
 			enrollment_id: this.enrollmentId,
 			learner_id: this.learnerId,
@@ -455,20 +455,20 @@ var LessonProgress = class extends SmrtObject {
 		})) throw new Error("Progress requires its enrollment learner and course lesson");
 		for (const value of [this.attempts, this.timeSpentSeconds]) if (!Number.isSafeInteger(value) || value < 0) throw new Error("Progress counters must be nonnegative integers");
 		if (this.bestScore !== null && (!Number.isFinite(this.bestScore) || this.bestScore < 0 || this.bestScore > 1)) throw new Error("Score must be null or a number from zero to one");
-		return super.save();
+		return super.save(options);
 	}
 };
-__publicField$4(LessonProgress, "__smrtPackage__", "@happyvertical/smrt-education");
-__decorateClass$4([tenantId()], LessonProgress.prototype, "tenantId", 2);
-__decorateClass$4([foreignKey("Enrollment", { required: true })], LessonProgress.prototype, "enrollmentId", 2);
-__decorateClass$4([foreignKey("Learner", { required: true })], LessonProgress.prototype, "learnerId", 2);
-__decorateClass$4([foreignKey("Lesson", { required: true })], LessonProgress.prototype, "lessonId", 2);
-__decorateClass$4([field({
+__publicField$5(LessonProgress, "__smrtPackage__", "@happyvertical/smrt-education");
+__decorateClass$5([tenantId()], LessonProgress.prototype, "tenantId", 2);
+__decorateClass$5([foreignKey("Enrollment", { required: true })], LessonProgress.prototype, "enrollmentId", 2);
+__decorateClass$5([foreignKey("Learner", { required: true })], LessonProgress.prototype, "learnerId", 2);
+__decorateClass$5([foreignKey("Lesson", { required: true })], LessonProgress.prototype, "lessonId", 2);
+__decorateClass$5([field({
 	type: "decimal",
 	nullable: true
 })], LessonProgress.prototype, "bestScore", 2);
-LessonProgress = __decorateClass$4([TenantScoped({ mode: "required" }), smrt({
-	...closed$3,
+LessonProgress = __decorateClass$5([TenantScoped({ mode: "required" }), smrt({
+	...closed$4,
 	tableName: "lesson_progress",
 	conflictColumns: [
 		"tenant_id",
@@ -478,21 +478,21 @@ LessonProgress = __decorateClass$4([TenantScoped({ mode: "required" }), smrt({
 })], LessonProgress);
 //#endregion
 //#region src/lesson-assets.ts
-var __defProp$3 = Object.defineProperty;
-var __getOwnPropDesc$3 = Object.getOwnPropertyDescriptor;
-var __defNormalProp$3 = (obj, key, value) => key in obj ? __defProp$3(obj, key, {
+var __defProp$4 = Object.defineProperty;
+var __getOwnPropDesc$4 = Object.getOwnPropertyDescriptor;
+var __defNormalProp$4 = (obj, key, value) => key in obj ? __defProp$4(obj, key, {
 	enumerable: true,
 	configurable: true,
 	writable: true,
 	value
 }) : obj[key] = value;
-var __decorateClass$3 = (decorators, target, key, kind) => {
-	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc$3(target, key) : target;
+var __decorateClass$4 = (decorators, target, key, kind) => {
+	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc$4(target, key) : target;
 	for (var i = decorators.length - 1, decorator; i >= 0; i--) if (decorator = decorators[i]) result = (kind ? decorator(target, key, result) : decorator(result)) || result;
-	if (kind && result) __defProp$3(target, key, result);
+	if (kind && result) __defProp$4(target, key, result);
 	return result;
 };
-var __publicField$3 = (obj, key, value) => __defNormalProp$3(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __publicField$4 = (obj, key, value) => __defNormalProp$4(obj, typeof key !== "symbol" ? key + "" : key, value);
 var LessonAsset = class extends SmrtObject {
 	tenantId = null;
 	lessonId = "";
@@ -503,7 +503,7 @@ var LessonAsset = class extends SmrtObject {
 		super(options);
 		for (const [key, value] of Object.entries(options)) if (Object.hasOwn(this, key)) this[key] = value;
 	}
-	async save() {
+	async save(options) {
 		const lesson = await this.db.get("lessons", { id: this.lessonId });
 		if (!lesson) throw new Error(`education lesson ${this.lessonId} does not exist`);
 		if (!await this.db.get("lessons", {
@@ -523,15 +523,15 @@ var LessonAsset = class extends SmrtObject {
 			const asset = await (await AssetCollection.create({ db: this.db })).get(this.assetId, { cache: false });
 			if (!this.tenantId || !asset || asset.tenantId !== this.tenantId || asset.accessMode !== "private" || !asset.ownerProfileId) throw new Error("Private lesson material requires an authorized private asset");
 		}
-		return await super.save();
+		return await super.save(options);
 	}
 };
-__publicField$3(LessonAsset, "__smrtPackage__", "@happyvertical/smrt-education");
-__decorateClass$3([tenantId({ nullable: true })], LessonAsset.prototype, "tenantId", 2);
-__decorateClass$3([foreignKey("Lesson", { required: true })], LessonAsset.prototype, "lessonId", 2);
-__decorateClass$3([crossPackageRef("@happyvertical/smrt-assets:Asset", { required: true })], LessonAsset.prototype, "assetId", 2);
-__decorateClass$3([field({ required: true })], LessonAsset.prototype, "relationship", 2);
-LessonAsset = __decorateClass$3([TenantScoped({ mode: "optional" }), smrt({
+__publicField$4(LessonAsset, "__smrtPackage__", "@happyvertical/smrt-education");
+__decorateClass$4([tenantId({ nullable: true })], LessonAsset.prototype, "tenantId", 2);
+__decorateClass$4([foreignKey("Lesson", { required: true })], LessonAsset.prototype, "lessonId", 2);
+__decorateClass$4([crossPackageRef("@happyvertical/smrt-assets:Asset", { required: true })], LessonAsset.prototype, "assetId", 2);
+__decorateClass$4([field({ required: true })], LessonAsset.prototype, "relationship", 2);
+LessonAsset = __decorateClass$4([TenantScoped({ mode: "optional" }), smrt({
 	tableName: "lesson_assets",
 	conflictColumns: [
 		"tenant_id",
@@ -545,22 +545,22 @@ LessonAsset = __decorateClass$3([TenantScoped({ mode: "optional" }), smrt({
 })], LessonAsset);
 //#endregion
 //#region src/submissions.ts
-var __defProp$2 = Object.defineProperty;
-var __getOwnPropDesc$2 = Object.getOwnPropertyDescriptor;
-var __defNormalProp$2 = (obj, key, value) => key in obj ? __defProp$2(obj, key, {
+var __defProp$3 = Object.defineProperty;
+var __getOwnPropDesc$3 = Object.getOwnPropertyDescriptor;
+var __defNormalProp$3 = (obj, key, value) => key in obj ? __defProp$3(obj, key, {
 	enumerable: true,
 	configurable: true,
 	writable: true,
 	value
 }) : obj[key] = value;
-var __decorateClass$2 = (decorators, target, key, kind) => {
-	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc$2(target, key) : target;
+var __decorateClass$3 = (decorators, target, key, kind) => {
+	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc$3(target, key) : target;
 	for (var i = decorators.length - 1, decorator; i >= 0; i--) if (decorator = decorators[i]) result = (kind ? decorator(target, key, result) : decorator(result)) || result;
-	if (kind && result) __defProp$2(target, key, result);
+	if (kind && result) __defProp$3(target, key, result);
 	return result;
 };
-var __publicField$2 = (obj, key, value) => __defNormalProp$2(obj, typeof key !== "symbol" ? key + "" : key, value);
-var closed$2 = {
+var __publicField$3 = (obj, key, value) => __defNormalProp$3(obj, typeof key !== "symbol" ? key + "" : key, value);
+var closed$3 = {
 	api: false,
 	mcp: false,
 	cli: false
@@ -618,7 +618,7 @@ var Submission = class extends SmrtObject {
 		super(options);
 		applyOptions(this, options);
 	}
-	async save() {
+	async save(options) {
 		await immutableIdentity(this, {
 			learner_id: this.learnerId,
 			lesson_id: this.lessonId,
@@ -647,23 +647,23 @@ var Submission = class extends SmrtObject {
 			learner_id: this.learnerId,
 			lesson_id: this.lessonId
 		})) throw new Error("Submission requires its tenant learner, lesson, and progress record");
-		return super.save();
+		return super.save(options);
 	}
 };
-__publicField$2(Submission, "__smrtPackage__", "@happyvertical/smrt-education");
-__decorateClass$2([tenantId()], Submission.prototype, "tenantId", 2);
-__decorateClass$2([foreignKey("Learner", { required: true })], Submission.prototype, "learnerId", 2);
-__decorateClass$2([foreignKey("Lesson", { required: true })], Submission.prototype, "lessonId", 2);
-__decorateClass$2([foreignKey("LessonProgress", { required: true })], Submission.prototype, "progressId", 2);
-__decorateClass$2([field({ required: true })], Submission.prototype, "kind", 2);
-__decorateClass$2([foreignKey("Submission", { nullable: true })], Submission.prototype, "previousSubmissionId", 2);
-__decorateClass$2([field({
+__publicField$3(Submission, "__smrtPackage__", "@happyvertical/smrt-education");
+__decorateClass$3([tenantId()], Submission.prototype, "tenantId", 2);
+__decorateClass$3([foreignKey("Learner", { required: true })], Submission.prototype, "learnerId", 2);
+__decorateClass$3([foreignKey("Lesson", { required: true })], Submission.prototype, "lessonId", 2);
+__decorateClass$3([foreignKey("LessonProgress", { required: true })], Submission.prototype, "progressId", 2);
+__decorateClass$3([field({ required: true })], Submission.prototype, "kind", 2);
+__decorateClass$3([foreignKey("Submission", { nullable: true })], Submission.prototype, "previousSubmissionId", 2);
+__decorateClass$3([field({
 	type: "text",
 	nullable: true
 })], Submission.prototype, "intakeItemId", 2);
-Submission = __decorateClass$2([TenantScoped({ mode: "required" }), smrt({
+Submission = __decorateClass$3([TenantScoped({ mode: "required" }), smrt({
 	tableStrategy: "sti",
-	...closed$2
+	...closed$3
 })], Submission);
 var SubmissionIntakeBinding = class extends SmrtObject {
 	tenantId = "";
@@ -673,7 +673,7 @@ var SubmissionIntakeBinding = class extends SmrtObject {
 		super(options);
 		applyOptions(this, options);
 	}
-	async save() {
+	async save(options) {
 		if (!this.tenantId?.trim() || !this.intakeItemId?.trim()) throw new Error("Submission intake binding requires tenant and item");
 		if (this.intakeItemId.length > 200) throw new Error("Submission intake item id is invalid");
 		if (!await this.db.get("submissions", {
@@ -681,19 +681,19 @@ var SubmissionIntakeBinding = class extends SmrtObject {
 			tenant_id: this.tenantId,
 			intake_item_id: this.intakeItemId
 		})) throw new Error("Submission intake binding must match its submission");
-		return super.save();
+		return super.save(options);
 	}
 };
-__publicField$2(SubmissionIntakeBinding, "__smrtPackage__", "@happyvertical/smrt-education");
-__decorateClass$2([tenantId()], SubmissionIntakeBinding.prototype, "tenantId", 2);
-__decorateClass$2([field({
+__publicField$3(SubmissionIntakeBinding, "__smrtPackage__", "@happyvertical/smrt-education");
+__decorateClass$3([tenantId()], SubmissionIntakeBinding.prototype, "tenantId", 2);
+__decorateClass$3([field({
 	required: true,
 	type: "text"
 })], SubmissionIntakeBinding.prototype, "intakeItemId", 2);
-__decorateClass$2([foreignKey("Submission", { required: true })], SubmissionIntakeBinding.prototype, "submissionId", 2);
-SubmissionIntakeBinding = __decorateClass$2([TenantScoped({ mode: "required" }), smrt({
+__decorateClass$3([foreignKey("Submission", { required: true })], SubmissionIntakeBinding.prototype, "submissionId", 2);
+SubmissionIntakeBinding = __decorateClass$3([TenantScoped({ mode: "required" }), smrt({
 	tableName: "submission_intake_bindings",
-	...closed$2,
+	...closed$3,
 	conflictColumns: ["tenant_id", "intake_item_id"]
 })], SubmissionIntakeBinding);
 var ScannedSubmission = class extends Submission {
@@ -710,15 +710,15 @@ var ScannedSubmission = class extends Submission {
 	setExtracted(value) {
 		this.extracted = stringifyJsonObject(value, "Extracted answers");
 	}
-	async save() {
+	async save(options) {
 		requireNonnegativeInteger(this.pageCount, "Page count");
-		return super.save();
+		return super.save(options);
 	}
 };
-__publicField$2(ScannedSubmission, "__smrtPackage__", "@happyvertical/smrt-education");
-ScannedSubmission = __decorateClass$2([smrt({
+__publicField$3(ScannedSubmission, "__smrtPackage__", "@happyvertical/smrt-education");
+ScannedSubmission = __decorateClass$3([smrt({
 	tableName: "submissions",
-	...closed$2
+	...closed$3
 })], ScannedSubmission);
 var ExternalCompletion = class extends Submission {
 	reportedBy = "learner";
@@ -728,27 +728,27 @@ var ExternalCompletion = class extends Submission {
 		super(options);
 		applyOptions(this, options);
 	}
-	async save() {
+	async save(options) {
 		requireEnum(this.reportedBy, [
 			"learner",
 			"guardian",
 			"source"
 		]);
 		requireScore(this.reportedScore, "Reported score");
-		return super.save();
+		return super.save(options);
 	}
 };
-__publicField$2(ExternalCompletion, "__smrtPackage__", "@happyvertical/smrt-education");
-__decorateClass$2([field({ type: "decimal" })], ExternalCompletion.prototype, "reportedScore", 2);
-ExternalCompletion = __decorateClass$2([smrt({
+__publicField$3(ExternalCompletion, "__smrtPackage__", "@happyvertical/smrt-education");
+__decorateClass$3([field({ type: "decimal" })], ExternalCompletion.prototype, "reportedScore", 2);
+ExternalCompletion = __decorateClass$3([smrt({
 	tableName: "submissions",
-	...closed$2
+	...closed$3
 })], ExternalCompletion);
 var Attestation = class extends Submission {};
-__publicField$2(Attestation, "__smrtPackage__", "@happyvertical/smrt-education");
-Attestation = __decorateClass$2([smrt({
+__publicField$3(Attestation, "__smrtPackage__", "@happyvertical/smrt-education");
+Attestation = __decorateClass$3([smrt({
 	tableName: "submissions",
-	...closed$2
+	...closed$3
 })], Attestation);
 var SubmissionAsset = class extends SmrtObject {
 	tenantId = "";
@@ -760,7 +760,7 @@ var SubmissionAsset = class extends SmrtObject {
 		super(options);
 		applyOptions(this, options);
 	}
-	async save() {
+	async save(options) {
 		await immutableIdentity(this, {
 			submission_id: this.submissionId,
 			asset_id: this.assetId,
@@ -782,15 +782,15 @@ var SubmissionAsset = class extends SmrtObject {
 			tenant_id: this.tenantId,
 			profile_id: asset.owner_profile_id
 		})) throw new Error("Submission assets must be owned by the learner profile");
-		return super.save();
+		return super.save(options);
 	}
 };
-__publicField$2(SubmissionAsset, "__smrtPackage__", "@happyvertical/smrt-education");
-__decorateClass$2([tenantId()], SubmissionAsset.prototype, "tenantId", 2);
-__decorateClass$2([foreignKey("Submission", { required: true })], SubmissionAsset.prototype, "submissionId", 2);
-__decorateClass$2([crossPackageRef("@happyvertical/smrt-assets:Asset", { required: true })], SubmissionAsset.prototype, "assetId", 2);
-__decorateClass$2([field({ required: true })], SubmissionAsset.prototype, "relationship", 2);
-SubmissionAsset = __decorateClass$2([TenantScoped({ mode: "required" }), smrt({
+__publicField$3(SubmissionAsset, "__smrtPackage__", "@happyvertical/smrt-education");
+__decorateClass$3([tenantId()], SubmissionAsset.prototype, "tenantId", 2);
+__decorateClass$3([foreignKey("Submission", { required: true })], SubmissionAsset.prototype, "submissionId", 2);
+__decorateClass$3([crossPackageRef("@happyvertical/smrt-assets:Asset", { required: true })], SubmissionAsset.prototype, "assetId", 2);
+__decorateClass$3([field({ required: true })], SubmissionAsset.prototype, "relationship", 2);
+SubmissionAsset = __decorateClass$3([TenantScoped({ mode: "required" }), smrt({
 	tableName: "submission_assets",
 	conflictColumns: [
 		"tenant_id",
@@ -798,7 +798,7 @@ SubmissionAsset = __decorateClass$2([TenantScoped({ mode: "required" }), smrt({
 		"asset_id",
 		"relationship"
 	],
-	...closed$2
+	...closed$3
 })], SubmissionAsset);
 var Grade = class extends SmrtObject {
 	tenantId = "";
@@ -821,7 +821,7 @@ var Grade = class extends SmrtObject {
 	setRubricResults(value) {
 		this.rubricResults = stringifyJsonObject(value, "Rubric results");
 	}
-	async save() {
+	async save(options) {
 		await immutableIdentity(this, { submission_id: this.submissionId });
 		requireEnum(this.graderKind, [
 			"auto",
@@ -836,27 +836,27 @@ var Grade = class extends SmrtObject {
 		requireScore(this.score, "Score");
 		for (const [value, label] of [[this.pointsEarned, "Points earned"], [this.pointsPossible, "Points possible"]]) if (value !== null) requireNonnegativeInteger(value, label);
 		if (this.pointsEarned !== null && this.pointsPossible !== null && this.pointsEarned > this.pointsPossible) throw new Error("Points earned cannot exceed points possible");
-		return super.save();
+		return super.save(options);
 	}
 };
-__publicField$2(Grade, "__smrtPackage__", "@happyvertical/smrt-education");
-__decorateClass$2([tenantId()], Grade.prototype, "tenantId", 2);
-__decorateClass$2([foreignKey("Submission", { required: true })], Grade.prototype, "submissionId", 2);
-__decorateClass$2([field({ required: true })], Grade.prototype, "graderKind", 2);
-__decorateClass$2([crossPackageRef("@happyvertical/smrt-profiles:Profile", { nullable: true })], Grade.prototype, "graderProfileId", 2);
-__decorateClass$2([field({
+__publicField$3(Grade, "__smrtPackage__", "@happyvertical/smrt-education");
+__decorateClass$3([tenantId()], Grade.prototype, "tenantId", 2);
+__decorateClass$3([foreignKey("Submission", { required: true })], Grade.prototype, "submissionId", 2);
+__decorateClass$3([field({ required: true })], Grade.prototype, "graderKind", 2);
+__decorateClass$3([crossPackageRef("@happyvertical/smrt-profiles:Profile", { nullable: true })], Grade.prototype, "graderProfileId", 2);
+__decorateClass$3([field({
 	type: "decimal",
 	nullable: true
 })], Grade.prototype, "score", 2);
-__decorateClass$2([field({
+__decorateClass$3([field({
 	type: "integer",
 	nullable: true
 })], Grade.prototype, "pointsEarned", 2);
-__decorateClass$2([field({
+__decorateClass$3([field({
 	type: "integer",
 	nullable: true
 })], Grade.prototype, "pointsPossible", 2);
-Grade = __decorateClass$2([TenantScoped({ mode: "required" }), smrt({ ...closed$2 })], Grade);
+Grade = __decorateClass$3([TenantScoped({ mode: "required" }), smrt({ ...closed$3 })], Grade);
 //#endregion
 //#region src/collections.ts
 var CourseCollection = class extends SmrtCollection {
@@ -1053,6 +1053,169 @@ var CatalogService = class {
 	}
 };
 //#endregion
+//#region src/family-intake-contracts.ts
+function familyIntakeScopeId(tenantId) {
+	return `family-intake:${tenantId}`;
+}
+//#endregion
+//#region src/family-intake-models.ts
+var __defProp$2 = Object.defineProperty;
+var __getOwnPropDesc$2 = Object.getOwnPropertyDescriptor;
+var __defNormalProp$2 = (obj, key, value) => key in obj ? __defProp$2(obj, key, {
+	enumerable: true,
+	configurable: true,
+	writable: true,
+	value
+}) : obj[key] = value;
+var __decorateClass$2 = (decorators, target, key, kind) => {
+	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc$2(target, key) : target;
+	for (var i = decorators.length - 1, decorator; i >= 0; i--) if (decorator = decorators[i]) result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+	if (kind && result) __defProp$2(target, key, result);
+	return result;
+};
+var __publicField$2 = (obj, key, value) => __defNormalProp$2(obj, typeof key !== "symbol" ? key + "" : key, value);
+var closed$2 = {
+	api: false,
+	mcp: false,
+	cli: false
+};
+async function immutable(row) {
+	if (!row.tenantId || row.id && await row.db.get(row.tableName, { id: row.id })) throw new Error("Family intake history is immutable");
+}
+function noDelete() {
+	throw new Error("Family originals require an owning retention operation");
+}
+var FamilyIntake = class extends SmrtObject {
+	tenantId = "";
+	itemId = "";
+	actorUserId = "";
+	ownerProfileId = "";
+	contentDigest = "";
+	sourceJson = "{}";
+	constructor(options = {}) {
+		super(options);
+		Object.assign(this, Object.fromEntries(Object.entries(options).filter(([k]) => Object.hasOwn(this, k))));
+	}
+	async save(options) {
+		await immutable(this);
+		return super.save(options);
+	}
+	async delete() {
+		noDelete();
+	}
+};
+__publicField$2(FamilyIntake, "__smrtPackage__", "@happyvertical/smrt-education");
+__decorateClass$2([tenantId()], FamilyIntake.prototype, "tenantId", 2);
+__decorateClass$2([crossPackageRef("@happyvertical/smrt-profiles:Profile")], FamilyIntake.prototype, "ownerProfileId", 2);
+__decorateClass$2([field({ type: "text" })], FamilyIntake.prototype, "sourceJson", 2);
+FamilyIntake = __decorateClass$2([TenantScoped({ mode: "required" }), smrt({
+	tableName: "family_intakes",
+	conflictColumns: ["tenant_id", "item_id"],
+	...closed$2
+})], FamilyIntake);
+var FamilyIntakeCollection = class extends SmrtCollection {
+	static _itemClass = FamilyIntake;
+};
+var FamilyIntakeAsset = class extends SmrtObject {
+	tenantId = "";
+	intakeId = "";
+	assetId = "";
+	name = "";
+	mimeType = "";
+	sha256 = "";
+	position = 0;
+	constructor(options = {}) {
+		super(options);
+		Object.assign(this, Object.fromEntries(Object.entries(options).filter(([k]) => Object.hasOwn(this, k))));
+	}
+	async save(options) {
+		await immutable(this);
+		const parent = await this.db.get("family_intakes", {
+			id: this.intakeId,
+			tenant_id: this.tenantId
+		});
+		if (!parent || !await this.db.get("assets", {
+			id: this.assetId,
+			tenant_id: this.tenantId,
+			owner_profile_id: parent.owner_profile_id,
+			access_mode: "private"
+		})) throw new Error("Family original ownership mismatch");
+		return super.save(options);
+	}
+	async delete() {
+		noDelete();
+	}
+};
+__publicField$2(FamilyIntakeAsset, "__smrtPackage__", "@happyvertical/smrt-education");
+__decorateClass$2([tenantId()], FamilyIntakeAsset.prototype, "tenantId", 2);
+__decorateClass$2([foreignKey("FamilyIntake", { required: true })], FamilyIntakeAsset.prototype, "intakeId", 2);
+__decorateClass$2([crossPackageRef("@happyvertical/smrt-assets:Asset")], FamilyIntakeAsset.prototype, "assetId", 2);
+FamilyIntakeAsset = __decorateClass$2([TenantScoped({ mode: "required" }), smrt({
+	tableName: "family_intake_assets",
+	conflictColumns: [
+		"tenant_id",
+		"intake_id",
+		"asset_id"
+	],
+	...closed$2
+})], FamilyIntakeAsset);
+var FamilyIntakeAssetCollection = class extends SmrtCollection {
+	static _itemClass = FamilyIntakeAsset;
+};
+var FamilyIntakeDecision = class extends SmrtObject {
+	tenantId = "";
+	intakeId = "";
+	requestKey = "";
+	sequence = 0;
+	actorUserId = "";
+	bodyJson = "{}";
+	constructor(options = {}) {
+		super(options);
+		Object.assign(this, Object.fromEntries(Object.entries(options).filter(([k]) => Object.hasOwn(this, k))));
+	}
+	async save(options) {
+		await immutable(this);
+		if (!await this.db.get("family_intakes", {
+			id: this.intakeId,
+			tenant_id: this.tenantId
+		})) throw new Error("Family decision ownership mismatch");
+		return super.save(options);
+	}
+	async delete() {
+		noDelete();
+	}
+};
+__publicField$2(FamilyIntakeDecision, "__smrtPackage__", "@happyvertical/smrt-education");
+__decorateClass$2([tenantId()], FamilyIntakeDecision.prototype, "tenantId", 2);
+__decorateClass$2([foreignKey("FamilyIntake", { required: true })], FamilyIntakeDecision.prototype, "intakeId", 2);
+__decorateClass$2([field({ type: "text" })], FamilyIntakeDecision.prototype, "bodyJson", 2);
+FamilyIntakeDecision = __decorateClass$2([TenantScoped({ mode: "required" }), smrt({
+	tableName: "family_intake_decisions",
+	conflictColumns: [
+		"tenant_id",
+		"intake_id",
+		"request_key"
+	],
+	...closed$2
+})], FamilyIntakeDecision);
+var FamilyIntakeDecisionCollection = class extends SmrtCollection {
+	static _itemClass = FamilyIntakeDecision;
+};
+async function familyAdoptionOwner(db, photo) {
+	const family = await db.get("family_intakes", {
+		id: photo.family_intake_id,
+		tenant_id: photo.tenant_id,
+		item_id: photo.item_id,
+		actor_user_id: photo.actor_user_id
+	});
+	if (!family) throw new Error("Family adoption receipt mismatch");
+	if (!(await db.query("SELECT body_json FROM family_intake_decisions WHERE tenant_id=? AND intake_id=?", [photo.tenant_id, photo.family_intake_id])).rows.some((row) => {
+		const body = JSON.parse(String(row.body_json));
+		return body.kind === "adopt" && body.learnerId === photo.learner_id && body.photoIntakeId === photo.id;
+	})) throw new Error("Family adoption decision mismatch");
+	return String(family.owner_profile_id);
+}
+//#endregion
 //#region src/workbook-contracts.ts
 var WorkbookAssessmentValidationError = class extends Error {
 	constructor(message, reason = "invalid_assessment") {
@@ -1235,7 +1398,7 @@ var Workbook = class extends SmrtObject {
 		super(options);
 		optionsFor(this, options);
 	}
-	async save() {
+	async save(options) {
 		if (!this.tenantId.trim()) throw new Error("Workbook requires tenant");
 		if (!await this.db.get("learners", {
 			id: this.learnerId,
@@ -1250,7 +1413,7 @@ var Workbook = class extends SmrtObject {
 			edition: this.edition
 		})) throw new Error("Workbook identity cannot change");
 		if (typeof this.reviewRequired !== "boolean" || !Number.isSafeInteger(this.policyVersion) || this.policyVersion < 1) throw new Error("Invalid workbook policy");
-		return super.save();
+		return super.save(options);
 	}
 };
 __publicField$1(Workbook, "__smrtPackage__", "@happyvertical/smrt-education");
@@ -1285,7 +1448,7 @@ var WorkbookActivity = class extends SmrtObject {
 	async delete() {
 		throw new Error("Workbook history is immutable; deliberate family deletion requires an owning retention operation");
 	}
-	async save() {
+	async save(options) {
 		if (!this.tenantId.trim()) throw new Error("Workbook requires tenant");
 		if (this.id && await this.db.get(this.tableName, { id: this.id })) throw new Error("Workbook history is immutable");
 		if (!["identified", "unfiled"].includes(this.captureKind)) throw new Error("Invalid workbook capture kind");
@@ -1331,7 +1494,7 @@ var WorkbookActivity = class extends SmrtObject {
 				source_ref: this.photoIntakeId
 			})) throw new Error("Unfiled work requires exact private technical routing");
 		}
-		return super.save();
+		return super.save(options);
 	}
 };
 __publicField$1(WorkbookActivity, "__smrtPackage__", "@happyvertical/smrt-education");
@@ -1376,7 +1539,7 @@ var WorkbookWorkFiling = class extends SmrtObject {
 	async delete() {
 		throw new Error("Workbook history is immutable");
 	}
-	async save() {
+	async save(options) {
 		if (this.id && await this.db.get(this.tableName, { id: this.id })) throw new Error("Workbook history is immutable");
 		const owner = {
 			tenant_id: this.tenantId,
@@ -1407,7 +1570,7 @@ var WorkbookWorkFiling = class extends SmrtObject {
 			source_activity_id: this.sourceActivityId,
 			previous_revision_id: this.previousRevisionId
 		})) throw new Error("Workbook filing predecessor already superseded");
-		return super.save();
+		return super.save(options);
 	}
 };
 __publicField$1(WorkbookWorkFiling, "__smrtPackage__", "@happyvertical/smrt-education");
@@ -1449,7 +1612,7 @@ var WorkbookAttempt = class extends SmrtObject {
 	async delete() {
 		throw new Error("Workbook history is immutable; deliberate family deletion requires an owning retention operation");
 	}
-	async save() {
+	async save(options) {
 		if (!this.tenantId.trim()) throw new Error("Workbook requires tenant");
 		if (this.id && await this.db.get(this.tableName, { id: this.id })) throw new Error("Workbook history is immutable");
 		if (!await this.db.get("workbook_activities", {
@@ -1481,7 +1644,7 @@ var WorkbookAttempt = class extends SmrtObject {
 			"assisted",
 			"unknown"
 		].includes(this.assistance)) throw new Error("Invalid assistance");
-		return super.save();
+		return super.save(options);
 	}
 };
 __publicField$1(WorkbookAttempt, "__smrtPackage__", "@happyvertical/smrt-education");
@@ -1519,7 +1682,7 @@ var WorkbookAssessmentRevision = class extends SmrtObject {
 	async delete() {
 		throw new Error("Workbook history is immutable; deliberate family deletion requires an owning retention operation");
 	}
-	async save() {
+	async save(options) {
 		if (!this.tenantId.trim()) throw new Error("Workbook requires tenant");
 		if (this.id && await this.db.get(this.tableName, { id: this.id })) throw new Error("Workbook history is immutable");
 		validateWorkbookAssessment(JSON.parse(this.assessmentJson));
@@ -1535,7 +1698,7 @@ var WorkbookAssessmentRevision = class extends SmrtObject {
 			attempt_id: this.attemptId
 		})) throw new Error("Workbook reviewed source mismatch");
 		if (!["ai", "guardian"].includes(this.kind)) throw new Error("Invalid revision kind");
-		return super.save();
+		return super.save(options);
 	}
 };
 __publicField$1(WorkbookAssessmentRevision, "__smrtPackage__", "@happyvertical/smrt-education");
@@ -1573,7 +1736,7 @@ var WorkbookFeedbackRelease = class extends SmrtObject {
 	async delete() {
 		throw new Error("Workbook history is immutable; deliberate family deletion requires an owning retention operation");
 	}
-	async save() {
+	async save(options) {
 		if (!this.tenantId.trim()) throw new Error("Workbook requires tenant");
 		if (this.id && await this.db.get(this.tableName, { id: this.id })) throw new Error("Workbook history is immutable");
 		if (!await this.db.get("workbook_attempts", {
@@ -1587,7 +1750,7 @@ var WorkbookFeedbackRelease = class extends SmrtObject {
 			learner_id: this.learnerId,
 			attempt_id: this.attemptId
 		})) throw new Error("Workbook release revision mismatch");
-		return super.save();
+		return super.save(options);
 	}
 };
 __publicField$1(WorkbookFeedbackRelease, "__smrtPackage__", "@happyvertical/smrt-education");
@@ -1620,7 +1783,7 @@ var WorkbookFeedbackDelivery = class extends SmrtObject {
 		super(options);
 		optionsFor(this, options);
 	}
-	async save() {
+	async save(options) {
 		if (this.id && await this.db.get(this.tableName, { id: this.id })) throw new Error("Workbook delivery history is immutable");
 		if (!await this.db.get("workbook_assessment_revisions", {
 			id: this.revisionId,
@@ -1633,7 +1796,7 @@ var WorkbookFeedbackDelivery = class extends SmrtObject {
 			tenant_id: this.tenantId,
 			user_id: this.actorUserId
 		})) throw new Error("Workbook delivery must name own learner");
-		return super.save();
+		return super.save(options);
 	}
 	async delete() {
 		throw new Error("Workbook delivery history is immutable");
@@ -1813,8 +1976,12 @@ var LearnerService = class LearnerService {
 		this.writeTail = result.then(() => void 0, () => void 0);
 		return result;
 	}
-	async requireActor(request, action) {
+	/** Prevent escaped transaction-scoped services from using a released executor. */
+	assertServiceOpen() {
 		if (this.transactionState === "aborting" || this.transactionState === "closed") throw new Error("Learner transaction scope is closed");
+	}
+	async requireActor(request, action) {
+		this.assertServiceOpen();
 		const context = getCurrentTenant();
 		if (!context || !request.tenantId || !request.actorUserId || !request.learnerId || context.tenantId !== request.tenantId || context.userId !== request.actorUserId || context.superAdminBypass) throw new LearnerAuthorizationError();
 		const learner = await (await LearnerCollection.create({ db: this.db })).get({
@@ -25630,12 +25797,27 @@ var WorkbookPhotoIntake = class extends SmrtObject {
 	async delete() {
 		denyHistoryDeletion();
 	}
+	familyIntakeId = null;
 	itemId = "";
 	actorUserId = "";
 	contentDigest = "";
-	async save() {
+	async save(options) {
 		await assertPhotoHistory(this);
-		return super.save();
+		if (this.familyIntakeId && !await this.db.get("family_intakes", {
+			id: this.familyIntakeId,
+			tenant_id: this.tenantId,
+			item_id: this.itemId,
+			actor_user_id: this.actorUserId
+		})) throw new Error("Family adoption receipt mismatch");
+		if (this.familyIntakeId) await familyAdoptionOwner(this.db, {
+			id: String(this.id),
+			tenant_id: this.tenantId,
+			learner_id: this.learnerId,
+			item_id: this.itemId,
+			family_intake_id: this.familyIntakeId,
+			actor_user_id: this.actorUserId
+		});
+		return super.save(options);
 	}
 	constructor(options = {}) {
 		super(options);
@@ -25645,6 +25827,7 @@ var WorkbookPhotoIntake = class extends SmrtObject {
 __publicField(WorkbookPhotoIntake, "__smrtPackage__", "@happyvertical/smrt-education");
 __decorateClass([tenantId()], WorkbookPhotoIntake.prototype, "tenantId", 2);
 __decorateClass([foreignKey("Learner", { required: true })], WorkbookPhotoIntake.prototype, "learnerId", 2);
+__decorateClass([foreignKey("FamilyIntake")], WorkbookPhotoIntake.prototype, "familyIntakeId", 2);
 WorkbookPhotoIntake = __decorateClass([TenantScoped({ mode: "required" }), smrt({
 	tableName: "workbook_photo_intakes",
 	conflictColumns: ["tenant_id", "item_id"],
@@ -25669,7 +25852,7 @@ var WorkbookPhotoAsset = class extends SmrtObject {
 		super(options);
 		Object.assign(this, Object.fromEntries(Object.entries(options).filter(([key]) => Object.hasOwn(this, key))));
 	}
-	async save() {
+	async save(options) {
 		await assertPhotoHistory(this);
 		if (!await this.db.get("workbook_photo_intakes", {
 			id: this.intakeId,
@@ -25680,13 +25863,32 @@ var WorkbookPhotoAsset = class extends SmrtObject {
 			id: this.learnerId,
 			tenant_id: this.tenantId
 		});
-		if (!learner || !await this.db.get("assets", {
+		const photo = await this.db.get("workbook_photo_intakes", {
+			id: this.intakeId,
+			tenant_id: this.tenantId,
+			learner_id: this.learnerId
+		});
+		const family = photo?.family_intake_id ? await this.db.get("family_intakes", {
+			id: photo.family_intake_id,
+			tenant_id: this.tenantId,
+			item_id: photo.item_id
+		}) : null;
+		if (family) await familyAdoptionOwner(this.db, photo);
+		const borrowed = family && await this.db.get("family_intake_assets", {
+			intake_id: family.id,
+			tenant_id: this.tenantId,
+			asset_id: this.assetId,
+			sha256: this.sha256,
+			name: this.name,
+			mime_type: this.mimeType
+		});
+		if (!learner || photo?.family_intake_id && !borrowed || !await this.db.get("assets", {
 			id: this.assetId,
 			tenant_id: this.tenantId,
-			owner_profile_id: learner.profile_id,
+			owner_profile_id: family ? family.owner_profile_id : learner.profile_id,
 			access_mode: "private"
 		})) throw new Error("Photo original must be an owned private asset");
-		return super.save();
+		return super.save(options);
 	}
 };
 __publicField(WorkbookPhotoAsset, "__smrtPackage__", "@happyvertical/smrt-education");
@@ -25721,14 +25923,14 @@ var WorkbookPhotoDecision = class extends SmrtObject {
 		super(options);
 		Object.assign(this, Object.fromEntries(Object.entries(options).filter(([key]) => Object.hasOwn(this, key))));
 	}
-	async save() {
+	async save(options) {
 		await assertPhotoHistory(this);
 		if (!await this.db.get("workbook_photo_intakes", {
 			id: this.intakeId,
 			tenant_id: this.tenantId,
 			learner_id: this.learnerId
 		})) throw new Error("Photo decision ownership mismatch");
-		return super.save();
+		return super.save(options);
 	}
 };
 __publicField(WorkbookPhotoDecision, "__smrtPackage__", "@happyvertical/smrt-education");
@@ -25761,7 +25963,7 @@ var WorkbookContextRevision = class extends SmrtObject {
 		super(options);
 		Object.assign(this, Object.fromEntries(Object.entries(options).filter(([key]) => Object.hasOwn(this, key))));
 	}
-	async save() {
+	async save(options) {
 		await assertPhotoHistory(this);
 		if (!await this.db.get("workbooks", {
 			id: this.workbookId,
@@ -25773,7 +25975,7 @@ var WorkbookContextRevision = class extends SmrtObject {
 			tenant_id: this.tenantId,
 			learner_id: this.learnerId
 		})) throw new Error("Workbook context decision ownership mismatch");
-		return super.save();
+		return super.save(options);
 	}
 };
 __publicField(WorkbookContextRevision, "__smrtPackage__", "@happyvertical/smrt-education");
@@ -26928,6 +27130,28 @@ var WorkbookPhotoService = class WorkbookPhotoService extends WorkbookService {
 	createTransactionService(db) {
 		return new WorkbookPhotoService(db, this.authorize, this.authorizeCatalog, this.photoOptions);
 	}
+	/** Only an exact adopted receipt can bridge its immutable family source scope. */
+	async assertWorkbookPhotoScope(request, scope, itemId) {
+		if (scope.tenantId !== request.tenantId || scope.actorId !== request.actorUserId) throw new LearnerAuthorizationError();
+		if (scope.confidentialScopeId === request.learnerId) return;
+		if (scope.confidentialScopeId !== `family-intake:${request.tenantId}`) throw new LearnerAuthorizationError();
+		const view = await this.getWorkbookPhotoIntakeByItem({
+			...request,
+			itemId
+		});
+		const photo = await this.db.get("workbook_photo_intakes", {
+			id: view.id,
+			tenant_id: request.tenantId,
+			learner_id: request.learnerId,
+			item_id: itemId
+		});
+		if (!photo?.family_intake_id || !await this.db.get("family_intakes", {
+			id: photo.family_intake_id,
+			tenant_id: request.tenantId,
+			item_id: itemId
+		})) throw new LearnerAuthorizationError();
+		await familyAdoptionOwner(this.db, photo);
+	}
 	async authorizePhotoIntake(request) {
 		await this.requireActor(request, "education.learner.submit");
 	}
@@ -27156,18 +27380,40 @@ var WorkbookPhotoService = class WorkbookPhotoService extends WorkbookService {
 	async readWorkbookPhotoOriginal(request) {
 		const original = (await this.getWorkbookPhotoIntake(request)).originals.find((o) => o.assetId === request.assetId);
 		if (!original) throw new LearnerAuthorizationError();
-		const learner = await this.requireActor(request, "education.learner.read");
+		let ownerProfileId = (await this.requireActor(request, "education.learner.read")).profileId;
+		const photo = await this.db.get("workbook_photo_intakes", {
+			id: request.intakeId,
+			tenant_id: request.tenantId,
+			learner_id: request.learnerId
+		});
+		if (photo?.family_intake_id) {
+			await familyAdoptionOwner(this.db, photo);
+			const family = await this.db.get("family_intakes", {
+				id: photo.family_intake_id,
+				tenant_id: request.tenantId,
+				item_id: photo.item_id
+			});
+			if (!family || !await this.db.get("family_intake_assets", {
+				tenant_id: request.tenantId,
+				intake_id: family.id,
+				asset_id: request.assetId,
+				sha256: original.sha256,
+				name: original.name,
+				mime_type: original.mimeType
+			})) throw new LearnerAuthorizationError();
+			ownerProfileId = family.owner_profile_id;
+		}
 		return withPrivateAssetAccess({
 			tenantId: request.tenantId,
 			actorUserId: request.actorUserId,
-			ownerProfileId: learner.profileId,
+			ownerProfileId,
 			assetIds: [request.assetId]
 		}, async () => {
 			const runtime = await this.assets();
 			const asset = await runtime.collection.get({
 				id: request.assetId,
 				tenantId: request.tenantId,
-				ownerProfileId: learner.profileId
+				ownerProfileId
 			}, { cache: false });
 			if (asset?.accessMode !== "private") throw new LearnerAuthorizationError();
 			const data = await runtime.store.read(asset);
@@ -27354,6 +27600,6 @@ var WorkbookPhotoService = class WorkbookPhotoService extends WorkbookService {
 	}
 };
 //#endregion
-export { LessonCollection as $, WorkbookFeedbackRelease as A, CatalogService as B, WorkbookAssessmentRevision as C, Exercise as Ct, WorkbookCollection as D, Video as Dt, WorkbookAttemptCollection as E, Reading as Et, WorkbookAssessmentValidationError as F, CurriculumCollection as G, AuthoredCourseCollection as H, aggregateWorkbookQuestions as I, ExternalCompletionCollection as J, EnrollmentCollection as K, validateWorkbookAssessment as L, WorkbookWorkFiling as M, WorkbookWorkFilingCollection as N, WorkbookFeedbackDelivery as O, Worksheet as Ot, WORKBOOK_MATH_VOCABULARY as P, LessonAssetCollection as Q, workbookAggregateFeedback as R, WorkbookActivityCollection as S, CourseSection as St, WorkbookAttempt as T, Lesson as Tt, CourseCollection as U, AttestationCollection as V, CourseSectionCollection as W, GradeCollection as X, ExternalCourseCollection as Y, LearnerCollection as Z, WorkbookWorkflowRequiredError as _, Enrollment as _t, WorkbookContextRevisionCollection as a, SubmissionIntakeBindingCollection as at, Workbook as b, AuthoredCourse as bt, WorkbookPhotoDecision as c, Attestation as ct, WorkbookPhotoIntakeCollection as d, ScannedSubmission as dt, LessonProgressCollection as et, validateWorkbookPhotoIdentification as f, Submission as ft, SubmissionStorageCleanupError as g, Curriculum as gt, SubmissionService as h, LessonAsset as ht, WorkbookContextRevision as i, SubmissionCollection as it, WorkbookFeedbackReleaseCollection as j, WorkbookFeedbackDeliveryCollection as k, WorkbookPhotoDecisionCollection as l, ExternalCompletion as lt, normalizeWorkbookAnswerRegions as m, SubmissionIntakeBinding as mt, preservePhotoProposal as n, ScannedSubmissionCollection as nt, WorkbookPhotoAsset as o, VideoCollection as ot, normalizeWorkbookObservedLayout as p, SubmissionAsset as pt, ExerciseCollection as q, WorkbookService as r, SubmissionAssetCollection as rt, WorkbookPhotoAssetCollection as s, WorksheetCollection as st, WorkbookPhotoService as t, ReadingCollection as tt, WorkbookPhotoIntake as u, Grade as ut, LearnerAuthorizationError as v, Learner as vt, WorkbookAssessmentRevisionCollection as w, ExternalCourse as wt, WorkbookActivity as x, Course as xt, LearnerService as y, LessonProgress as yt, CatalogAuthorizationError as z };
+export { EnrollmentCollection as $, WorkbookFeedbackRelease as A, Exercise as At, FamilyIntakeAsset as B, WorkbookAssessmentRevision as C, Curriculum as Ct, WorkbookCollection as D, AuthoredCourse as Dt, WorkbookAttemptCollection as E, LessonProgress as Et, WorkbookAssessmentValidationError as F, Worksheet as Ft, familyIntakeScopeId as G, FamilyIntakeCollection as H, aggregateWorkbookQuestions as I, AttestationCollection as J, CatalogAuthorizationError as K, validateWorkbookAssessment as L, WorkbookWorkFiling as M, Lesson as Mt, WorkbookWorkFilingCollection as N, Reading as Nt, WorkbookFeedbackDelivery as O, Course as Ot, WORKBOOK_MATH_VOCABULARY as P, Video as Pt, CurriculumCollection as Q, workbookAggregateFeedback as R, WorkbookActivityCollection as S, LessonAsset as St, WorkbookAttempt as T, Learner as Tt, FamilyIntakeDecision as U, FamilyIntakeAssetCollection as V, FamilyIntakeDecisionCollection as W, CourseCollection as X, AuthoredCourseCollection as Y, CourseSectionCollection as Z, WorkbookWorkflowRequiredError as _, Grade as _t, WorkbookContextRevisionCollection as a, LessonAssetCollection as at, Workbook as b, SubmissionAsset as bt, WorkbookPhotoDecision as c, ReadingCollection as ct, WorkbookPhotoIntakeCollection as d, SubmissionCollection as dt, ExerciseCollection as et, validateWorkbookPhotoIdentification as f, SubmissionIntakeBindingCollection as ft, SubmissionStorageCleanupError as g, ExternalCompletion as gt, SubmissionService as h, Attestation as ht, WorkbookContextRevision as i, LearnerCollection as it, WorkbookFeedbackReleaseCollection as j, ExternalCourse as jt, WorkbookFeedbackDeliveryCollection as k, CourseSection as kt, WorkbookPhotoDecisionCollection as l, ScannedSubmissionCollection as lt, normalizeWorkbookAnswerRegions as m, WorksheetCollection as mt, preservePhotoProposal as n, ExternalCourseCollection as nt, WorkbookPhotoAsset as o, LessonCollection as ot, normalizeWorkbookObservedLayout as p, VideoCollection as pt, CatalogService as q, WorkbookService as r, GradeCollection as rt, WorkbookPhotoAssetCollection as s, LessonProgressCollection as st, WorkbookPhotoService as t, ExternalCompletionCollection as tt, WorkbookPhotoIntake as u, SubmissionAssetCollection as ut, LearnerAuthorizationError as v, ScannedSubmission as vt, WorkbookAssessmentRevisionCollection as w, Enrollment as wt, WorkbookActivity as x, SubmissionIntakeBinding as xt, LearnerService as y, Submission as yt, FamilyIntake as z };
 
-//# sourceMappingURL=workbook-photo-service-1wcnf-Xf.js.map
+//# sourceMappingURL=workbook-photo-service-DCmqeWLd.js.map