@riverbankcms/sdk 0.152.0 → 0.153.0

package/dist/server/config-validation.mjs

@@ -1731,12 +1731,14 @@ const unsafeAsSiteId = (id) => id;
 const unsafeAsApiKeyId = (id) => id;
 const unsafeAsEventOfferingId = (id) => id;
 const unsafeAsEventSeriesId = (id) => id;
+const unsafeAsMediaAssetId = (id) => id;
 const unsafeAsUserId = (id) => id;
 const unsafeAsContentVersionId = (id) => id;
 const parseSiteId = (value) => parseUuidBrand(value, unsafeAsSiteId);
 const parseApiKeyId = (value) => parseUuidBrand(value, unsafeAsApiKeyId);
 const parseEventOfferingId = (value) => parseUuidBrand(value, unsafeAsEventOfferingId);
 const parseUserId = (value) => parseUuidBrand(value, unsafeAsUserId);
+const parseMediaAssetId = (value) => parseUuidBrand(value, unsafeAsMediaAssetId);
 const parseContentVersionId = (value) => parseUuidBrand(value, unsafeAsContentVersionId);
 const parseEventSeriesId = (value) => parseUuidBrand(value, unsafeAsEventSeriesId);
 //#endregion
@@ -2387,7 +2389,7 @@ function parsePositiveInteger(value) {
 	return typeof value === "number" && Number.isSafeInteger(value) && value > 0 ? value : null;
 }
 function parseNewsletterListId(value) {
-	return parseTrimmedMatchingString(value, UUID_PATTERN);
+	return parseTrimmedMatchingString(typeof value === "string" ? value.toLowerCase() : value, UUID_PATTERN);
 }
 function parseMailchimpAccountId(value) {
 	return parseTrimmedMatchingString(value, OPAQUE_ID_PATTERN);
@@ -2429,8 +2431,15 @@ function parseMailingListProviderScope(value) {
 	}
 	return err("invalid_mailing_list_provider_scope");
 }
-//#endregion
-//#region ../core/src/mailing-list-setup-parser.ts
+z.unknown().transform((value, ctx) => {
+	const parsed = parseNewsletterAudience(value);
+	if (parsed.ok) return parsed.value;
+	ctx.addIssue({
+		code: "custom",
+		message: "Choose a valid newsletter audience."
+	});
+	return z.NEVER;
+});
 function parseMailingListGlobalForm(value) {
 	if (!isRecord$9(value)) return formError("shape");
 	const fields = parseGlobalFields(value.fields);
@@ -2450,6 +2459,16 @@ function parseMailingListGlobalForm(value) {
 		privacyNote
 	});
 }
+function parseNewsletterAudience(value) {
+	if (!isRecord$9(value)) return err("invalid_newsletter_audience");
+	if (value.kind === "general" && Object.keys(value).length === 1) return ok({ kind: "general" });
+	if (value.kind !== "topic" || Object.keys(value).some((key) => key !== "kind" && key !== "topicId")) return err("invalid_newsletter_audience");
+	const topicId = parseNewsletterListId(value.topicId);
+	return topicId === null ? err("invalid_newsletter_audience") : ok({
+		kind: "topic",
+		topicId
+	});
+}
 function parseGlobalFields(value) {
 	if (!isRecord$9(value) || typeof value.preset !== "string") return null;
 	switch (value.preset) {
@@ -2502,54 +2521,49 @@ function formError(field) {
 const DEFAULT_MAILING_LIST_TARGETING = { mode: "default" };
 function mailingListTargetingChoiceIds(targeting) {
 	switch (targeting.provider) {
-		case "native": return targeting.selection.tag === "fixed" ? targeting.selection.topicIds : targeting.selection.offeredTopicIds;
+		case "native": return targeting.selection.tag === "general" ? [] : targeting.selection.tag === "fixed" ? targeting.selection.topicIds : targeting.selection.offeredTopicIds;
 		case "brevo": return targeting.selection.tag === "fixed" ? targeting.selection.listIds : targeting.selection.offeredListIds;
 		case "mailchimp": return targeting.selection.tag === "fixed" ? targeting.selection.interestIds : targeting.selection.offeredInterestIds;
 	}
 }
 function planMailingListChoicePresentation(targeting) {
-	if (targeting.mode === "default" || targeting.selection.tag === "fixed") return { tag: "hidden" };
+	if (targeting.mode === "default" || targeting.selection.tag === "fixed" || targeting.selection.tag === "general") return { tag: "hidden" };
 	switch (targeting.provider) {
-		case "native": return targeting.selection.offeredTopicIds.length === 1 ? {
-			tag: "automatic",
-			selection: {
-				provider: "native",
-				topicIds: targeting.selection.offeredTopicIds
-			}
-		} : {
-			tag: "visitor_choice",
+		case "native": return presentVisitorSelection({
 			provider: "native",
-			optionCount: targeting.selection.offeredTopicIds.length
-		};
-		case "brevo": return targeting.selection.offeredListIds.length === 1 ? {
-			tag: "automatic",
-			selection: {
-				provider: "brevo",
-				listIds: targeting.selection.offeredListIds
-			}
-		} : {
-			tag: "visitor_choice",
+			topicIds: targeting.selection.offeredTopicIds
+		}, targeting.selection.offeredTopicIds.length);
+		case "brevo": return presentVisitorSelection({
 			provider: "brevo",
-			optionCount: targeting.selection.offeredListIds.length
-		};
-		case "mailchimp": return targeting.selection.offeredInterestIds.length === 1 ? {
-			tag: "automatic",
-			selection: {
-				provider: "mailchimp",
-				interestIds: targeting.selection.offeredInterestIds
-			}
-		} : {
-			tag: "visitor_choice",
+			listIds: targeting.selection.offeredListIds
+		}, targeting.selection.offeredListIds.length);
+		case "mailchimp": return presentVisitorSelection({
 			provider: "mailchimp",
-			optionCount: targeting.selection.offeredInterestIds.length
-		};
+			interestIds: targeting.selection.offeredInterestIds
+		}, targeting.selection.offeredInterestIds.length);
 	}
 }
+function presentVisitorSelection(selection, optionCount) {
+	return optionCount === 1 ? {
+		tag: "automatic",
+		selection
+	} : {
+		tag: "visitor_choice",
+		provider: selection.provider,
+		optionCount
+	};
+}
 //#endregion
 //#region ../core/src/mailing-list-targeting-availability.ts
 function resolveMailingListDefaultDestination(provider) {
 	switch (provider.provider) {
-		case "native": return provider.topics.find((item) => item.id === provider.defaultTopicId) ?? null;
+		case "native": {
+			const audience = provider.defaultAudience;
+			return audience.kind === "general" ? {
+				id: "general",
+				name: "General mailing list"
+			} : provider.topics.find((item) => item.id === audience.topicId) ?? null;
+		}
 		case "brevo": return provider.lists.find((item) => item.id === provider.defaultListId) ?? null;
 		case "mailchimp": return provider.audiences.find((item) => item.id === provider.defaultAudienceId) ?? null;
 	}
@@ -2687,11 +2701,12 @@ function parseRuntimeProvider(value) {
 	}
 }
 function parseNativeRuntimeProvider(value) {
-	const defaultTopicId = parseNewsletterListId(value.defaultTopicId);
+	if ("defaultTopicId" in value) return null;
+	const defaultAudience = parseNewsletterAudience(value.defaultAudience);
 	const topics = parseNamedItems(value.topics, parseNewsletterListId);
-	return defaultTopicId !== null && topics !== null ? {
+	return defaultAudience.ok && topics !== null ? {
 		provider: "native",
-		defaultTopicId,
+		defaultAudience: defaultAudience.value,
 		topics
 	} : null;
 }
@@ -2776,6 +2791,11 @@ function parseMailingListPlacementTargeting(value) {
 	}
 }
 function parseNativeTargeting(selection) {
+	if (selection.tag === "general") return Object.keys(selection).length === 1 ? ok({
+		mode: "custom",
+		provider: "native",
+		selection: { tag: "general" }
+	}) : targetingError("selection");
 	if (selection.tag === "fixed") {
 		const topicIds = parseNonEmptyUniqueIds(selection.topicIds, parseNewsletterListId);
 		return topicIds.ok ? ok({
@@ -7860,7 +7880,96 @@ const themeLookMetadataSchema = z.object({
 	skinMarks: skinMarksSchema.optional()
 });
 //#endregion
-//#region ../theme-core/src/lib/media.ts
+//#region ../media-core/src/identifiers.ts
+function slugifyMediaIdentifier(value) {
+	return value.toLowerCase().trim().replace(/[^a-z0-9\s-]/g, "").replace(/\s+/g, "-").replace(/-+/g, "-");
+}
+function parseMediaIdentifier(value) {
+	if (typeof value !== "string") return err({ kind: "not_string" });
+	const trimmed = value.trim();
+	if (trimmed.length === 0) return err({ kind: "empty_identifier" });
+	const normalized = slugifyMediaIdentifier(trimmed);
+	if (normalized.length === 0) return err({
+		kind: "empty_after_normalization",
+		value
+	});
+	return ok(normalized);
+}
+/**
+* Admits identifiers read from trusted persistence without repairing dirty data in memory.
+* User input should use parseMediaIdentifier, which intentionally canonicalizes it.
+*/
+function parseCanonicalMediaIdentifier(value) {
+	if (typeof value !== "string") return err({ kind: "not_string" });
+	const parsed = parseMediaIdentifier(value);
+	if (!parsed.ok) return parsed;
+	if (value !== parsed.value) return err({
+		kind: "non_canonical_identifier",
+		value,
+		canonical: parsed.value
+	});
+	return parsed;
+}
+//#endregion
+//#region ../media-core/src/mediaIdentifierSchema.ts
+/** Strict stored-reference admission delegates the canonical identifier decision. */
+const mediaIdentifierSchema = z.string().transform((value, context) => {
+	const parsed = parseCanonicalMediaIdentifier(value);
+	if (parsed.ok) return parsed.value;
+	context.addIssue({
+		code: "custom",
+		message: "Expected a canonical media identifier"
+	});
+	return z.NEVER;
+});
+//#endregion
+//#region ../media-core/src/mediaKinds.ts
+const mediaTypeDiscriminants = [
+	"image",
+	"video",
+	"audio",
+	"document",
+	"spreadsheet",
+	"archive"
+];
+//#endregion
+//#region ../media-core/src/renderableMediaAsset.ts
+/** A portable reference never uses an incidental UUID, URL or storage snapshot for identity. */
+function resolveManagedMediaReference(reference, index) {
+	const asset = index?.byIdentifier.get(reference.identifier);
+	return asset ? {
+		kind: "resolved",
+		reference,
+		asset
+	} : {
+		kind: "missing",
+		reference
+	};
+}
+//#endregion
+//#region ../media-core/src/renderableMediaAssetAdmission.ts
+const mediaAssetIdSchema = z.string().transform((value, context) => {
+	const parsed = parseMediaAssetId(value);
+	if (parsed.ok) return parsed.value;
+	context.addIssue({
+		code: "custom",
+		message: "Expected a media asset ID"
+	});
+	return z.NEVER;
+});
+const nonemptyStorageValue = z.string().refine((value) => value.trim().length > 0);
+const renderableMediaAssetSchema = z.object({
+	id: mediaAssetIdSchema,
+	identifier: mediaIdentifierSchema,
+	storageBucket: nonemptyStorageValue,
+	storagePath: nonemptyStorageValue,
+	mimeType: nonemptyStorageValue,
+	filename: z.string().optional(),
+	width: z.number().positive().nullable(),
+	height: z.number().positive().nullable()
+});
+//#endregion
+//#region ../media-core/src/media.ts
 const hotspotSchema = z.object({
 	x: z.number().min(0).max(1),
 	y: z.number().min(0).max(1),
@@ -7894,56 +8003,149 @@ const transformSchema = z.object({
 	rotation: rotationSchema.optional()
 });
 const mediaPosterSchema = z.discriminatedUnion("tag", [z.object({
-	tag: z.literal("storage"),
-	assetId: z.string().optional(),
-	storageBucket: z.string().min(1),
-	storagePath: z.string().min(1)
-}), z.object({
+	tag: z.literal("media"),
+	identifier: mediaIdentifierSchema
+}).strict(), z.object({
 	tag: z.literal("external-src"),
-	assetId: z.string().optional(),
 	src: z.string().url()
-})]);
-const mediaBaseSchema = z.object({
+}).strict()]);
+const mediaUsageShape = {
 	purpose: z.string().optional(),
 	placeholder: z.boolean().default(true).optional(),
-	assetId: z.string().optional(),
-	identifier: z.string().optional(),
-	src: z.string().optional(),
 	alt: z.string().optional(),
 	filename: z.string().optional(),
-	mimeType: z.string().optional(),
 	width: z.number().optional(),
 	height: z.number().optional(),
-	storageBucket: z.string().optional(),
-	storagePath: z.string().optional(),
 	poster: mediaPosterSchema.optional(),
 	transform: transformSchema.optional()
-});
-const mediaIdentifierSchema = z.string().trim().min(1).brand();
+};
+const environmentExclusions = {
+	assetId: z.never().optional(),
+	id: z.never().optional(),
+	src: z.never().optional(),
+	storageBucket: z.never().optional(),
+	storagePath: z.never().optional(),
+	mimeType: z.never().optional()
+};
+const mediaBaseSchema = z.object({
+	...mediaUsageShape,
+	...environmentExclusions,
+	identifier: mediaIdentifierSchema
+}).strict();
 const imageMediaSchema = mediaBaseSchema.extend({ type: z.literal("image") });
 const videoMediaSchema = mediaBaseSchema.extend({ type: z.literal("video") });
-const audioMediaSchema = mediaBaseSchema.extend({ type: z.literal("audio") });
-const documentMediaSchema = mediaBaseSchema.extend({ type: z.literal("document") });
-const spreadsheetMediaSchema = mediaBaseSchema.extend({ type: z.literal("spreadsheet") });
-const archiveMediaSchema = mediaBaseSchema.extend({ type: z.literal("archive") });
-const mediaSchema = z.discriminatedUnion("type", [
-	imageMediaSchema,
-	videoMediaSchema,
-	audioMediaSchema,
-	documentMediaSchema,
-	spreadsheetMediaSchema,
-	archiveMediaSchema
-]);
-const persistableMediaBaseSchema = mediaBaseSchema.extend({ identifier: mediaIdentifierSchema });
-z.discriminatedUnion("type", [
-	persistableMediaBaseSchema.extend({ type: z.literal("image") }),
-	persistableMediaBaseSchema.extend({ type: z.literal("video") }),
-	persistableMediaBaseSchema.extend({ type: z.literal("audio") }),
-	persistableMediaBaseSchema.extend({ type: z.literal("document") }),
-	persistableMediaBaseSchema.extend({ type: z.literal("spreadsheet") }),
-	persistableMediaBaseSchema.extend({ type: z.literal("archive") })
+const mediaSchema = mediaBaseSchema.extend({ type: z.enum(mediaTypeDiscriminants) });
+const externalMediaSchema = z.object({
+	...mediaUsageShape,
+	...environmentExclusions,
+	type: z.enum(mediaTypeDiscriminants),
+	src: z.string().min(1),
+	identifier: z.never().optional()
+}).strict();
+const assetMediaSchema = z.object({
+	...mediaUsageShape,
+	...environmentExclusions,
+	type: z.enum(mediaTypeDiscriminants),
+	asset: renderableMediaAssetSchema,
+	identifier: z.never().optional()
+}).strict();
+const runtimeMediaSchema = z.union([
+	mediaSchema,
+	externalMediaSchema,
+	assetMediaSchema
 ]);
 //#endregion
+//#region ../media-core/src/transformRect.ts
+function isValidTransformRectStructure(rect) {
+	if (!Array.isArray(rect) || rect.length !== 4) return false;
+	const [left, top, width, height] = rect;
+	return Number.isFinite(left) && Number.isFinite(top) && Number.isFinite(width) && Number.isFinite(height) && left >= 0 && top >= 0 && width > 0 && height > 0;
+}
+//#endregion
+//#region ../media-core/src/aspectTransforms.ts
+const DEFAULT_RECT_EPSILON = .5;
+function parseAspectRatioValue(value) {
+	if (typeof value === "number") return Number.isFinite(value) && value > 0 ? value : void 0;
+	if (typeof value !== "string") return void 0;
+	const normalized = value.trim();
+	if (!normalized) return void 0;
+	if (normalized === "auto") return void 0;
+	if (normalized.includes(":") || normalized.includes("/")) {
+		const delimiter = normalized.includes(":") ? ":" : "/";
+		const [wRaw, hRaw] = normalized.split(delimiter);
+		const width = Number(wRaw?.trim());
+		const height = Number(hRaw?.trim());
+		if (!Number.isFinite(width) || !Number.isFinite(height) || width <= 0 || height <= 0) return;
+		return width / height;
+	}
+	const numeric = Number(normalized);
+	if (!Number.isFinite(numeric) || numeric <= 0) return void 0;
+	return numeric;
+}
+const MAX_ASPECT_DISTANCE = .25;
+function resolveMediaTransformForAspect(transform, targetAspect) {
+	if (!transform) return {};
+	const base = {
+		rect: transform.rect,
+		hotspot: transform.hotspot,
+		rotation: transform.rotation
+	};
+	const target = parseAspectRatioValue(targetAspect);
+	const crops = transform.aspectCrops;
+	if (!target || !crops || Object.keys(crops).length === 0) return base;
+	let best = null;
+	let bestDistance = Number.POSITIVE_INFINITY;
+	for (const [key, candidate] of Object.entries(crops)) {
+		const candidateAspect = parseAspectRatioValue(candidate.aspect ?? key);
+		if (!candidateAspect) continue;
+		const distance = Math.abs(Math.log(candidateAspect / target));
+		if (distance < bestDistance) {
+			best = candidate;
+			bestDistance = distance;
+		}
+	}
+	if (!best) return base;
+	if (bestDistance > MAX_ASPECT_DISTANCE) return base;
+	return {
+		rect: best.rect ?? base.rect,
+		hotspot: best.hotspot ?? base.hotspot,
+		rotation: best.rotation ?? base.rotation
+	};
+}
+function isValidTransformRect(rect) {
+	return isValidTransformRectStructure(rect);
+}
+function isExplicitRectCrop(rect, sourceWidth, sourceHeight, epsilon = DEFAULT_RECT_EPSILON) {
+	if (!isValidTransformRect(rect)) return false;
+	if (!(typeof sourceWidth === "number" && Number.isFinite(sourceWidth) && sourceWidth > 0 && typeof sourceHeight === "number" && Number.isFinite(sourceHeight) && sourceHeight > 0)) return true;
+	const [x, y, width, height] = rect;
+	return !(Math.abs(x) <= epsilon && Math.abs(y) <= epsilon && Math.abs(width - sourceWidth) <= epsilon && Math.abs(height - sourceHeight) <= epsilon);
+}
+//#endregion
+//#region ../media-core/src/rotation.ts
+function rotateNormalizedPoint(point, rotation) {
+	const x = point.x;
+	const y = point.y;
+	switch (rotation) {
+		case 0: return {
+			x,
+			y
+		};
+		case 90: return {
+			x: 1 - y,
+			y: x
+		};
+		case 180: return {
+			x: 1 - x,
+			y: 1 - y
+		};
+		case 270: return {
+			x: y,
+			y: 1 - x
+		};
+	}
+}
+//#endregion
 //#region ../theme-core/src/palette/schema.ts
 const colourHexString = z.string().regex(/^#([0-9A-Fa-f]{3}){1,2}$/);
 const paletteColorSchema = z.object({
@@ -16492,6 +16694,21 @@ const boxBackgroundSchema = z.discriminatedUnion("type", [
 		showVideoOnMobile: z.boolean().nullable().optional()
 	})
 ]);
+/** Application rendering sources are admitted separately from saved references. */
+const runtimeBoxBackgroundSchema = z.discriminatedUnion("type", [
+	boxBackgroundSchema.options[0],
+	boxBackgroundSchema.options[1],
+	boxBackgroundSchema.options[2].extend({ image: z.union([
+		imageMediaSchema,
+		externalMediaSchema.extend({ type: z.literal("image") }),
+		assetMediaSchema.extend({ type: z.literal("image") })
+	]).nullable().optional() }),
+	boxBackgroundSchema.options[3].extend({ image: z.union([
+		videoMediaSchema,
+		externalMediaSchema.extend({ type: z.literal("video") }),
+		assetMediaSchema.extend({ type: z.literal("video") })
+	]).nullable().optional() })
+]);
 function normalizeAuthoringOpacity(value) {
 	if (!isRecord$6(value)) return value;
 	return {
@@ -23341,97 +23558,6 @@ function registerManifest(manifest) {
 	return manifest;
 }
 //#endregion
-//#region ../media-core/src/transformRect.ts
-function isValidTransformRectStructure(rect) {
-	if (!Array.isArray(rect) || rect.length !== 4) return false;
-	const [left, top, width, height] = rect;
-	return Number.isFinite(left) && Number.isFinite(top) && Number.isFinite(width) && Number.isFinite(height) && left >= 0 && top >= 0 && width > 0 && height > 0;
-}
-//#endregion
-//#region ../media-core/src/aspectTransforms.ts
-const DEFAULT_RECT_EPSILON = .5;
-function parseAspectRatioValue(value) {
-	if (typeof value === "number") return Number.isFinite(value) && value > 0 ? value : void 0;
-	if (typeof value !== "string") return void 0;
-	const normalized = value.trim();
-	if (!normalized) return void 0;
-	if (normalized === "auto") return void 0;
-	if (normalized.includes(":") || normalized.includes("/")) {
-		const delimiter = normalized.includes(":") ? ":" : "/";
-		const [wRaw, hRaw] = normalized.split(delimiter);
-		const width = Number(wRaw?.trim());
-		const height = Number(hRaw?.trim());
-		if (!Number.isFinite(width) || !Number.isFinite(height) || width <= 0 || height <= 0) return;
-		return width / height;
-	}
-	const numeric = Number(normalized);
-	if (!Number.isFinite(numeric) || numeric <= 0) return void 0;
-	return numeric;
-}
-const MAX_ASPECT_DISTANCE = .25;
-function resolveMediaTransformForAspect(transform, targetAspect) {
-	if (!transform) return {};
-	const base = {
-		rect: transform.rect,
-		hotspot: transform.hotspot,
-		rotation: transform.rotation
-	};
-	const target = parseAspectRatioValue(targetAspect);
-	const crops = transform.aspectCrops;
-	if (!target || !crops || Object.keys(crops).length === 0) return base;
-	let best = null;
-	let bestDistance = Number.POSITIVE_INFINITY;
-	for (const [key, candidate] of Object.entries(crops)) {
-		const candidateAspect = parseAspectRatioValue(candidate.aspect ?? key);
-		if (!candidateAspect) continue;
-		const distance = Math.abs(Math.log(candidateAspect / target));
-		if (distance < bestDistance) {
-			best = candidate;
-			bestDistance = distance;
-		}
-	}
-	if (!best) return base;
-	if (bestDistance > MAX_ASPECT_DISTANCE) return base;
-	return {
-		rect: best.rect ?? base.rect,
-		hotspot: best.hotspot ?? base.hotspot,
-		rotation: best.rotation ?? base.rotation
-	};
-}
-function isValidTransformRect(rect) {
-	return isValidTransformRectStructure(rect);
-}
-function isExplicitRectCrop(rect, sourceWidth, sourceHeight, epsilon = DEFAULT_RECT_EPSILON) {
-	if (!isValidTransformRect(rect)) return false;
-	if (!(typeof sourceWidth === "number" && Number.isFinite(sourceWidth) && sourceWidth > 0 && typeof sourceHeight === "number" && Number.isFinite(sourceHeight) && sourceHeight > 0)) return true;
-	const [x, y, width, height] = rect;
-	return !(Math.abs(x) <= epsilon && Math.abs(y) <= epsilon && Math.abs(width - sourceWidth) <= epsilon && Math.abs(height - sourceHeight) <= epsilon);
-}
-//#endregion
-//#region ../media-core/src/rotation.ts
-function rotateNormalizedPoint(point, rotation) {
-	const x = point.x;
-	const y = point.y;
-	switch (rotation) {
-		case 0: return {
-			x,
-			y
-		};
-		case 90: return {
-			x: 1 - y,
-			y: x
-		};
-		case 180: return {
-			x: 1 - x,
-			y: 1 - y
-		};
-		case 270: return {
-			x: y,
-			y: 1 - x
-		};
-	}
-}
-//#endregion
 //#region ../blocks/src/system/node/schema.ts
 const transformStepSchema = z.object({
 	id: z.string().min(1, "Transform requires an identifier"),
@@ -26357,6 +26483,12 @@ function parseBackgroundOverlay(value) {
 	const result = boxBackgroundOverlaySchema.safeParse(value);
 	return result.success ? result.data : void 0;
 }
+/** Rendering accepts explicit application sources separately from stored references. */
+const runtimeBackgroundContentSchema = runtimeBoxBackgroundSchema;
+function parseRuntimeBackgroundContent(value) {
+	const result = runtimeBackgroundContentSchema.safeParse(value);
+	return result.success ? result.data : null;
+}
 //#endregion
 //#region ../blocks/src/system/transforms/registry/_utils/themeColorResolution.ts
 function resolveBackgroundColorValue(value, context) {
@@ -35615,14 +35747,6 @@ const weeklySlotAvailabilityBlockDefinition = {
 	} }
 };
 //#endregion
-//#region ../blocks/src/lib/media.ts
-const PUBLIC_DOWNLOAD_MEDIA_TYPES = [
-	"document",
-	"spreadsheet",
-	"archive",
-	"audio"
-];
-//#endregion
 //#region ../blocks/src/system/manifest/richTextSchema.ts
 /**
 * Shared Rich Text Schema
@@ -36058,7 +36182,7 @@ const publicEventBaseSchema = z.object({
 	content: z.object({ body: RichTextDocSchema.nullable().optional() }).optional(),
 	presentation: z.object({
 		summary: z.string().nullable().optional(),
-		image: mediaSchema.nullable().optional()
+		image: runtimeMediaSchema.nullable().optional()
 	}).optional(),
 	slug: z.string(),
 	path: z.string().nullable(),
@@ -42949,6 +43073,14 @@ const audioPlayerBlockDefinition = { manifest: createBlockManifest({
 	}
 }) };
 //#endregion
+//#region ../blocks/src/lib/media.ts
+const PUBLIC_DOWNLOAD_MEDIA_TYPES = [
+	"document",
+	"spreadsheet",
+	"archive",
+	"audio"
+];
+//#endregion
 //#region ../blocks/src/system/blocks/file-download.ts
 const bound = (from) => ({ $bind: { from } });
 const fileDownloadLayout = styledSection({
@@ -45194,7 +45326,7 @@ const memberPhotoClassName = (baseClass) => cardRoleChildClass({
 	baseClass,
 	stylesFrom: "content._cardStyles"
 });
-const teamMemberPhotoSchema = mediaSchema.refine((media) => media.type === "image", { message: "Team member photos must be image media" }).nullable();
+const teamMemberPhotoSchema = runtimeMediaSchema.refine((media) => media.type === "image", { message: "Team member photos must be image media" }).nullable();
 const teamMemberDataSchema = z.object({
 	_type: z.literal("teamMember"),
 	id: z.string(),
@@ -46736,11 +46868,14 @@ const offeringsPreviewDatesReadEnabled = {
 //#endregion
 //#region ../blocks/src/system/helpers/backgroundMedia.ts
 function resolveBackgroundMedia(input) {
-	const parsedMedia = mediaSchema.safeParse(input.image);
+	const parsedMedia = runtimeMediaSchema.safeParse(input.image);
 	if (!parsedMedia.success) return null;
 	switch (parsedMedia.data.type) {
 		case "image":
-		case "video": return parsedMedia.data;
+		case "video": return {
+			...parsedMedia.data,
+			type: parsedMedia.data.type
+		};
 		case "audio":
 		case "document":
 		case "spreadsheet":
@@ -46752,6 +46887,75 @@ function backgroundVideoMobileClassNames(input) {
 	return input.showVideoOnMobile === true ? "" : "rb-hidden rb-md-block";
 }
 //#endregion
+//#region ../blocks/src/system/runtime/nodes/mediaContext.ts
+/**
+* Server-side: AsyncLocalStorage for request isolation.
+* Prevents race conditions when multiple requests are processed concurrently.
+*
+* Lazy initialization to avoid issues in environments that don't support async_hooks.
+*/
+const serverStorageState = {
+	storage: null,
+	checked: false
+};
+function getServerStorage() {
+	if (typeof window !== "undefined") return null;
+	if (serverStorageState.checked) return serverStorageState.storage;
+	serverStorageState.checked = true;
+	try {
+		const globalWithNonWebpackRequire = globalThis;
+		const AsyncLocalStorage = (typeof globalWithNonWebpackRequire.__non_webpack_require__ === "function" ? globalWithNonWebpackRequire.__non_webpack_require__ : new Function("id", "return require(id)"))("async_hooks").AsyncLocalStorage;
+		if (AsyncLocalStorage) {
+			serverStorageState.storage = new AsyncLocalStorage();
+			return serverStorageState.storage;
+		}
+		return null;
+	} catch {
+		if (process.env.NODE_ENV !== "production") console.warn("[blocks] AsyncLocalStorage not available - using module-level state");
+		return null;
+	}
+}
+/**
+* Client-side context storage.
+* Safe because browsers are single-threaded per tab.
+*
+* IMPORTANT: This must be shared across bundles.
+* SDK preview mode can load multiple independently-bundled entrypoints
+* (e.g. `@riverbankcms/sdk/rendering` + `@riverbankcms/sdk/preview-next/client`),
+* which can otherwise each get their own module-scoped singleton.
+*/
+const RB_MEDIA_CONTEXT_KEY = Symbol.for("riverbankcms.blocks.mediaContext");
+function getClientContextStore() {
+	const g = globalThis;
+	const existing = g[RB_MEDIA_CONTEXT_KEY];
+	if (existing && typeof existing === "object") return existing;
+	const next = {};
+	g[RB_MEDIA_CONTEXT_KEY] = next;
+	return next;
+}
+/**
+* Get the current media context.
+* Server-side: Uses AsyncLocalStorage for request isolation.
+* Client-side: Uses module-level state (safe in single-threaded browser).
+*/
+function getMediaContext() {
+	const storage = getServerStorage();
+	if (storage) return storage.getStore() ?? {};
+	return getClientContextStore();
+}
+function getCurrentResolveImageUrlContext() {
+	const context = getMediaContext();
+	if (!context.supabaseUrl && !context.siteId && !context.mediaAssetIndex) return;
+	return {
+		supabaseUrl: context.supabaseUrl,
+		siteId: context.siteId,
+		mediaAssetIndex: context.mediaAssetIndex
+	};
+}
+function getMediaAssetIndex(context) {
+	return context?.mediaAssetIndex ?? getMediaContext().mediaAssetIndex;
+}
+//#endregion
 //#region ../blocks/src/system/runtime/nodes/media.tsx
 function getValidSourceDimension(value) {
 	return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : void 0;
@@ -46787,41 +46991,72 @@ function applyRectTransform(existingStyle, patch) {
 	if (patch.transform) next.transform = appendTransform(existingStyle?.transform, patch.transform);
 	return next;
 }
-function computeMediaTransformStyle(value, style, targetAspectRatio, options) {
+/** Resolve portable content without exposing runtime metadata as saved values. */
+function resolveMediaWithContext(reference, context) {
+	return resolveManagedMediaReference(reference, getMediaAssetIndex(context ?? void 0));
+}
+function sourceFromAsset(value, asset) {
+	return {
+		type: value.type,
+		alt: value.alt,
+		filename: value.filename,
+		purpose: value.purpose,
+		placeholder: value.placeholder,
+		transform: value.transform,
+		poster: value.poster,
+		identifier: asset.identifier,
+		assetId: asset.id,
+		storageBucket: asset.storageBucket,
+		storagePath: asset.storagePath,
+		mimeType: asset.mimeType,
+		width: asset.width,
+		height: asset.height
+	};
+}
+function resolveRuntimeMedia(value, context) {
+	if ("asset" in value && value.asset) return sourceFromAsset(value, value.asset);
+	if ("src" in value && value.src) return value;
+	if (!value.identifier) return void 0;
+	const resolved = resolveMediaWithContext(value, context);
+	return resolved.kind === "resolved" ? sourceFromAsset(resolved.reference, resolved.asset) : void 0;
+}
+function usesProxyFraming(source, transform) {
+	if (!source?.assetId || !isExplicitCropProxyEnabled()) return false;
+	return Boolean(transform.rotation) || isExplicitRectCrop(transform.rect, getValidSourceDimension(source.width), getValidSourceDimension(source.height));
+}
+function rectFramingPatch(source, rect, proxy, style) {
+	if (!source || !rect || proxy) return {};
+	const patch = buildCssRectStylePatch(source, rect);
+	return patch ? applyRectTransform(style, patch) : {};
+}
+function hotspotFramingPatch(transform, proxy, rectPatch, style) {
+	if (!transform.hotspot || rectPatch.objectPosition !== void 0) return {};
+	const fit = style?.objectFit;
+	if (fit && fit !== "cover" && fit !== "contain") return {};
+	const point = proxy && transform.rotation ? rotateNormalizedPoint(transform.hotspot, transform.rotation) : transform.hotspot;
+	return { objectPosition: `${point.x * 100}% ${point.y * 100}%` };
+}
+function rotationFramingPatch(rotation, proxy, rectPatch, style) {
+	if (!rotation || proxy) return {};
+	return {
+		transform: appendTransform(rectPatch.transform ?? style?.transform, `rotate(${rotation}deg)`),
+		transformOrigin: rectPatch.transformOrigin ?? "center"
+	};
+}
+/** CSS framing is a pure projection of the resolved source and per-use transform. */
+function deriveMediaFramingStyle(source, transform, proxy, style) {
+	if (!transform.rect && !transform.hotspot && !transform.rotation) return style;
+	const rectPatch = rectFramingPatch(source, transform.rect, proxy, style);
+	return mergeStyles(style, {
+		...rectPatch,
+		...hotspotFramingPatch(transform, proxy, rectPatch, style),
+		...rotationFramingPatch(transform.rotation, proxy, rectPatch, style)
+	});
+}
+function computeMediaTransformStyle(value, style, targetAspectRatio, options, context) {
+	const source = resolveRuntimeMedia(value, context ?? getCurrentResolveImageUrlContext());
 	const transform = options?.resolvedTransform ?? resolveMediaTransformForAspect(value.transform, targetAspectRatio);
-	const rect = transform.rect;
-	const hotspot = transform.hotspot;
-	const rotation = transform.rotation;
-	if (!rect && !hotspot && !rotation) return style;
-	const stylePatch = {};
-	const heuristicSuppressCss = Boolean(isExplicitCropProxyEnabled() && value.assetId && (typeof rotation === "number" && rotation !== 0 || isExplicitRectCrop(rect, getValidSourceDimension(value.width), getValidSourceDimension(value.height))));
-	const shouldSuppressCss = options?.isProxy ?? heuristicSuppressCss;
-	if (rect && !shouldSuppressCss) {
-		const rectPatch = buildCssRectStylePatch(value, rect);
-		if (rectPatch) {
-			const mergedRect = applyRectTransform(style, rectPatch);
-			Object.assign(stylePatch, mergedRect);
-		}
-	}
-	if (hotspot) {
-		const effectiveObjectFit = stylePatch.objectFit ?? style?.objectFit;
-		if ((!effectiveObjectFit || effectiveObjectFit === "cover" || effectiveObjectFit === "contain") && stylePatch.objectPosition === void 0) {
-			const resolved = shouldSuppressCss && rotation ? rotateNormalizedPoint({
-				x: hotspot.x,
-				y: hotspot.y
-			}, rotation) : {
-				x: hotspot.x,
-				y: hotspot.y
-			};
-			stylePatch.objectPosition = `${resolved.x * 100}% ${resolved.y * 100}%`;
-		}
-	}
-	if (rotation && !shouldSuppressCss) {
-		const existingTransform = stylePatch.transform ?? style?.transform;
-		stylePatch.transform = existingTransform ? `${existingTransform} rotate(${rotation}deg)` : `rotate(${rotation}deg)`;
-		if (!stylePatch.transformOrigin) stylePatch.transformOrigin = "center";
-	}
-	return mergeStyles(style, stylePatch);
+	return deriveMediaFramingStyle(source, transform, options?.isProxy ?? usesProxyFraming(source, transform), style);
 }
 //#endregion
 //#region ../blocks/src/system/transforms/registry/background.ts
@@ -46970,11 +47205,11 @@ const backgroundTransforms = [
 	}
 ];
 function parseMediaBackground(value) {
-	const background = parseBackgroundContent(value);
+	const background = parseRuntimeBackgroundContent(value);
 	return background?.type === "image" || background?.type === "video" ? background : null;
 }
 function resolveBackgroundLayerStyle(value, fallbackToken, context) {
-	const background = parseBackgroundContent(value);
+	const background = parseRuntimeBackgroundContent(value);
 	const style = {};
 	const gradient = background?.type === "gradient" ? isString(background.gradient) ? background.gradient.trim() : gradientPresetCss(background.gradientPresetId) : null;
 	const color = background?.type === "color" && isString(background.color) ? background.color.trim() : null;