@voltro/cms 0.86.0 → 0.87.0

package/dist/contentRouteTypes.js

@@ -0,0 +1,39 @@
+import { defineContentLocations as e } from "./contentLocations.js";
+//#region src/contentRouteTypes.ts
+var t = (e) => typeof e == "string" && e.length > 0, n = (e, t) => e < t ? -1 : +(e > t), r = (r) => {
+	if (r.length === 0 || r.some((e) => !t(e.name)) || new Set(r.map((e) => e.name)).size !== r.length) return {
+		ok: !1,
+		reason: "types"
+	};
+	let i = [];
+	for (let n of r) {
+		let r = e(n.locations ?? []);
+		if ((n.tree !== void 0 || n.address !== void 0) && r.length === 0) return {
+			ok: !1,
+			reason: "mapping"
+		};
+		for (let e of r) for (let t of e.segments) if (typeof t != "string" && ("field" in t && n.fields[t.field]?.kind !== "string" || "tree" in t && n.tree === void 0)) return {
+			ok: !1,
+			reason: "mapping"
+		};
+		let a = n.tree === void 0 ? null : {
+			parent: n.tree.parent,
+			segment: n.tree.segment
+		};
+		if (a !== null && (!t(a.parent) || !t(a.segment))) return {
+			ok: !1,
+			reason: "mapping"
+		};
+		i.push({
+			name: n.name,
+			locations: r,
+			tree: a
+		});
+	}
+	return {
+		ok: !0,
+		types: i.sort((e, t) => n(e.name, t.name))
+	};
+};
+//#endregion
+export { r as compileContentRouteTypes };

package/dist/contentSeo.js

@@ -0,0 +1,189 @@
+import { ContentSeoUnavailable as e } from "./errors.js";
+//#region src/contentSeo.ts
+var t = (t) => {
+	throw new e({ reason: t });
+}, n = (e) => typeof e == "string" && /^[A-Za-z][A-Za-z0-9_]{0,63}$/.test(e), r = (e, n) => {
+	if (typeof e != "object" || !e || Array.isArray(e) || ![Object.prototype, null].includes(Object.getPrototypeOf(e)) || Object.getOwnPropertySymbols(e).length) return t("definition");
+	let r = Object.getOwnPropertyDescriptors(e);
+	return Object.entries(r).some(([e, t]) => !n.includes(e) || !t.enumerable || !("value" in t)) ? t("definition") : Object.fromEntries(Object.entries(r).map(([e, t]) => [e, t.value]));
+}, i = (e) => {
+	let i = r(e, [
+		"fields",
+		"required",
+		"recommendedMaxLength"
+	]), a = i.fields;
+	if (!Array.isArray(a) || a.length < 1 || a.length > 8 || Object.getOwnPropertySymbols(a).length || Object.keys(a).length !== a.length || Object.getOwnPropertyNames(a).length !== a.length + 1) return t("definition");
+	let o = Array.from({ length: a.length }, (e, r) => {
+		let i = Object.getOwnPropertyDescriptor(a, String(r));
+		return i === void 0 || !("value" in i) || !i.enumerable || !n(i.value) ? t("definition") : i.value;
+	});
+	return new Set(o).size !== o.length || "required" in i && typeof i.required != "boolean" || "recommendedMaxLength" in i && (!Number.isSafeInteger(i.recommendedMaxLength) || Number(i.recommendedMaxLength) < 1 || Number(i.recommendedMaxLength) > 1e4) ? t("definition") : Object.freeze({
+		fields: Object.freeze(o),
+		...i.required === void 0 ? {} : { required: i.required },
+		...i.recommendedMaxLength === void 0 ? {} : { recommendedMaxLength: Number(i.recommendedMaxLength) }
+	});
+}, a = (e) => {
+	let n = r(e, ["index", "follow"]);
+	return typeof n.index != "boolean" || typeof n.follow != "boolean" ? t("definition") : Object.freeze({
+		index: n.index,
+		follow: n.follow
+	});
+}, o = (e) => typeof e == "string" && e.length <= 1e4 && !/[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f]/.test(e), s = (e) => {
+	let o = r(e, [
+		"version",
+		"title",
+		"description",
+		"social",
+		"canonical",
+		"robots",
+		"sitemap",
+		"structuredData"
+	]);
+	if (o.version !== 1 || o.canonical !== void 0 && o.canonical !== "route" && o.canonical !== "omit" || o.sitemap !== void 0 && typeof o.sitemap != "boolean") return t("definition");
+	let s = o.social === void 0 ? void 0 : r(o.social, [
+		"title",
+		"description",
+		"image"
+	]);
+	if (s?.image !== void 0 && !n(s.image)) return t("definition");
+	let c = o.structuredData === void 0 ? void 0 : r(o.structuredData, [
+		"type",
+		"title",
+		"description",
+		"datePublished"
+	]);
+	return c !== void 0 && (typeof c.type != "string" || ![
+		"WebPage",
+		"Article",
+		"BlogPosting"
+	].includes(c.type) || !n(c.title) || ["description", "datePublished"].some((e) => c[e] !== void 0 && !n(c[e]))) ? t("definition") : Object.freeze({
+		version: 1,
+		title: i(o.title),
+		...o.description === void 0 ? {} : { description: i(o.description) },
+		...s === void 0 ? {} : { social: Object.freeze({
+			...s.title === void 0 ? {} : { title: i(s.title) },
+			...s.description === void 0 ? {} : { description: i(s.description) },
+			...s.image === void 0 ? {} : { image: s.image }
+		}) },
+		...o.canonical === void 0 ? {} : { canonical: o.canonical },
+		...o.robots === void 0 ? {} : { robots: a(o.robots) },
+		...o.sitemap === void 0 ? {} : { sitemap: o.sitemap },
+		...c === void 0 ? {} : { structuredData: Object.freeze({
+			type: c.type,
+			title: c.title,
+			...c.description === void 0 ? {} : { description: c.description },
+			...c.datePublished === void 0 ? {} : { datePublished: c.datePublished }
+		}) }
+	});
+}, c = (e) => {
+	let n = r(e, [
+		"title",
+		"description",
+		"social",
+		"robots",
+		"sitemap"
+	]), i = n.social === void 0 ? void 0 : r(n.social, ["title", "description"]);
+	if (["title", "description"].some((e) => n[e] !== void 0 && !o(n[e]) || i?.[e] !== void 0 && !o(i[e])) || n.sitemap !== void 0 && typeof n.sitemap != "boolean") return t("defaults");
+	let s = (e) => Object.fromEntries(["title", "description"].flatMap((t) => e[t] === void 0 || e[t].trim() === "" ? [] : [[t, e[t].trim()]]));
+	return Object.freeze({
+		...s(n),
+		...i === void 0 ? {} : { social: Object.freeze(s(i)) },
+		...n.robots === void 0 ? {} : { robots: a(n.robots) },
+		...n.sitemap === void 0 ? {} : { sitemap: n.sitemap }
+	});
+}, l = (e, r) => {
+	let i = s(e), a = (e, n) => {
+		if (!Object.hasOwn(r, e) || r[e]?.kind !== n) return t("field");
+	};
+	for (let e of [
+		i.title,
+		i.description,
+		i.social?.title,
+		i.social?.description
+	]) for (let t of e?.fields ?? []) a(t, "string");
+	if (i.social?.image !== void 0) {
+		let e = Object.hasOwn(r, i.social.image) ? r[i.social.image] : void 0;
+		if (e?.kind !== "media" && !(e?.kind === "reference" && n(e.referenceType))) return t("field");
+	}
+	i.structuredData !== void 0 && (a(i.structuredData.title, "string"), i.structuredData.description !== void 0 && a(i.structuredData.description, "string"), i.structuredData.datePublished !== void 0 && a(i.structuredData.datePublished, "datetime"));
+}, u = (e, n, r = {}) => {
+	let i = s(e), a = c(r);
+	if (typeof n != "object" || !n || Array.isArray(n) || ![Object.prototype, null].includes(Object.getPrototypeOf(n))) return t("values");
+	let l = [], u = {}, d = (e) => {
+		let r = Object.getOwnPropertyDescriptor(n, e);
+		if (r !== void 0) return "value" in r ? r.value : t("values");
+	}, f = (e, t, n = null, r = null) => {
+		let i = null;
+		u[t] = null;
+		for (let n of e?.fields ?? []) {
+			let e = d(n);
+			if (e != null && e !== "") {
+				if (!o(e)) l.push({
+					kind: "invalid",
+					target: t,
+					field: n,
+					rule: "text"
+				});
+				else if (e.trim() !== "") {
+					i = e.trim(), u[t] = n;
+					break;
+				}
+			}
+		}
+		return i === null && (i = n?.trim() || null, i !== null && (u[t] = r)), i === null && e?.required && l.push({
+			kind: "missing",
+			target: t,
+			field: null,
+			rule: "required"
+		}), i !== null && e?.recommendedMaxLength !== void 0 && i.length > e.recommendedMaxLength && l.push({
+			kind: "recommendation",
+			target: t,
+			field: u[t],
+			rule: "recommendedMaxLength"
+		}), i;
+	}, p = f(i.title, "title", a.title ?? null), m = f(i.description, "description", a.description ?? null), h = f(i.social?.title, "social.title", a.social?.title ?? p, a.social?.title === void 0 ? u.title : null), g = f(i.social?.description, "social.description", a.social?.description ?? m, a.social?.description === void 0 ? u.description : null), _ = f(i.social?.image === void 0 ? void 0 : { fields: [i.social.image] }, "social.image"), v = null;
+	if (i.structuredData !== void 0) {
+		let e = f({
+			fields: [i.structuredData.title],
+			required: !0
+		}, "structuredData.title"), t = f(i.structuredData.description === void 0 ? void 0 : { fields: [i.structuredData.description] }, "structuredData.description"), n = null;
+		if (i.structuredData.datePublished !== void 0) {
+			let e = i.structuredData.datePublished, t = d(e);
+			if (u["structuredData.datePublished"] = null, t != null && t !== "") {
+				let r = t instanceof Date ? t : typeof t == "string" ? new Date(t) : null;
+				r === null || !Number.isFinite(r.getTime()) ? l.push({
+					kind: "invalid",
+					target: "structuredData.datePublished",
+					field: e,
+					rule: "date"
+				}) : (n = r.toISOString(), u["structuredData.datePublished"] = e);
+			}
+		}
+		e !== null && (v = Object.freeze({
+			type: i.structuredData.type,
+			title: e,
+			description: t,
+			datePublished: n
+		}));
+	}
+	return Object.freeze({
+		title: p,
+		description: m,
+		canonical: i.canonical ?? "route",
+		robots: i.robots ?? a.robots ?? Object.freeze({
+			index: !1,
+			follow: !1
+		}),
+		sitemap: i.sitemap ?? a.sitemap ?? !1,
+		social: Object.freeze({
+			title: h,
+			description: g,
+			imageKey: _
+		}),
+		structuredData: v,
+		sources: Object.freeze(u),
+		findings: Object.freeze(l.map((e) => Object.freeze(e)))
+	});
+};
+//#endregion
+export { s as defineContentSeo, c as defineContentSeoDefaults, u as resolveContentSeo, l as validateContentSeoFields };

package/dist/contentTreePath.js

@@ -0,0 +1,60 @@
+import { resolveContentLocation as e } from "./contentLocations.js";
+//#region src/contentTreePath.ts
+var t = async (t, n, r) => {
+	let i = [], a = [], o = /* @__PURE__ */ new Set(), s = t;
+	for (; s !== null;) {
+		let c = s.documentId;
+		if (typeof c != "string" || c.length === 0) return {
+			ok: !1,
+			reason: "publication"
+		};
+		if (o.has(c)) return {
+			ok: !0,
+			path: null,
+			ancestors: i
+		};
+		if (o.size >= 128) return {
+			ok: !1,
+			reason: "bounds"
+		};
+		o.add(c);
+		let l = s[n.segment];
+		if (l === "" || l == null) return {
+			ok: !0,
+			path: null,
+			ancestors: i
+		};
+		if (typeof l != "string") return {
+			ok: !1,
+			reason: "publication"
+		};
+		e({
+			id: "segment",
+			segments: [{ field: n.segment }]
+		}, s, { prefix: "" }), a.unshift(l), s !== t && i.unshift({
+			documentId: c,
+			variantId: String(s.id),
+			revisionId: String(s.revisionId),
+			revision: Number(s.revision),
+			locale: String(s.locale)
+		});
+		let u = s[n.parent];
+		if (u == null || u === "") return {
+			ok: !0,
+			path: a.join("/"),
+			ancestors: i
+		};
+		if (typeof u != "string") return {
+			ok: !1,
+			reason: "publication"
+		};
+		s = await r(u);
+	}
+	return {
+		ok: !0,
+		path: null,
+		ancestors: i
+	};
+};
+//#endregion
+export { t as resolveContentTreePath };

package/dist/contentType.js

@@ -1,19 +1,23 @@
-import { checkTemplates as e } from "./templates.js";
-import { checkSearch as t } from "./search.js";
-import { taxonomyProblem as n } from "./taxonomy.js";
-import { componentExampleViolations as r } from "./validation.js";
-import { boolean as i, date as a, id as o, integer as s, json as c, real as l, table as u, text as d, timestamp as f } from "@voltro/database";
-import { tenant as p } from "@voltro/plugin-multitenancy/mixin";
+import { ContentLocationUnavailable as e, ContentSeoUnavailable as t } from "./errors.js";
+import { defineContentSeo as n, validateContentSeoFields as r } from "./contentSeo.js";
+import { defineContentSeoSites as i } from "./publicationSeo.js";
+import { checkTemplates as a } from "./templates.js";
+import { checkSearch as o } from "./search.js";
+import { taxonomyProblem as s } from "./taxonomy.js";
+import { componentExampleViolations as c } from "./validation.js";
+import { defineContentLocations as l } from "./contentLocations.js";
+import { boolean as u, date as d, id as f, integer as p, json as m, real as h, table as g, text as _, timestamp as v } from "@voltro/database";
+import { tenant as y } from "@voltro/plugin-multitenancy/mixin";
 //#region src/contentType.ts
-var m = [
+var b = [
 	"site",
 	"environment",
 	"locale"
-], h = [
+], x = [
 	"draft",
 	"published",
 	"archived"
-], g = [
+], S = [
 	"id",
 	"status",
 	"publishAt",
@@ -29,58 +33,71 @@ var m = [
 	"updatedAt",
 	"createdBy",
 	"updatedBy"
-], _ = (i) => {
-	let a = {}, o = [], s = [];
-	for (let [e, t] of Object.entries(i.fields)) {
-		if (g.includes(e)) throw Error(`defineContentType('${i.name}'): field '${e}' collides with a reserved lifecycle column (${g.join(", ")}). Rename it.`);
+], C = (u) => {
+	let d = {}, f = [], p = [];
+	for (let [e, t] of Object.entries(u.fields)) {
+		if (S.includes(e)) throw Error(`defineContentType('${u.name}'): field '${e}' collides with a reserved lifecycle column (${S.join(", ")}). Rename it.`);
 		let n = t;
-		if (n.unique && n.kind !== "string") throw Error(`defineContentType('${i.name}'): field '${e}' is marked unique() but is a '${n.kind}' field — per-tenant uniqueness is only supported on string fields (a slug). Remove unique() or make it a Schema.String.`);
-		a[e] = n, n.derived && o.push(e), n.unique && s.push(e);
+		if (n.unique && n.kind !== "string") throw Error(`defineContentType('${u.name}'): field '${e}' is marked unique() but is a '${n.kind}' field — per-tenant uniqueness is only supported on string fields (a slug). Remove unique() or make it a Schema.String.`);
+		d[e] = n, n.derived && f.push(e), n.unique && p.push(e);
 	}
-	if (i.list) {
-		let e = /* @__PURE__ */ new Set([...Object.keys(a), ...g]);
-		for (let t of i.list.columns) if (!e.has(t)) throw Error(`defineContentType('${i.name}'): list.columns entry '${t}' is not a declared field (or lifecycle column) of this content type.`);
-		let t = i.list.defaultSort?.field;
-		if (t !== void 0 && !e.has(t)) throw Error(`defineContentType('${i.name}'): list.defaultSort.field '${t}' is not a declared field (or lifecycle column) of this content type.`);
+	let m = u.asset === void 0 ? void 0 : { file: u.asset.file };
+	if (m !== void 0 && (Object.keys(u.asset).some((e) => e !== "file") || typeof m.file != "string" || !Object.hasOwn(d, m.file) || d[m.file]?.kind !== "media" || d[m.file]?.isOptional === !0)) throw Error(`defineContentType('${u.name}'): asset.file must name a required Media field.`);
+	if (u.list) {
+		let e = /* @__PURE__ */ new Set([...Object.keys(d), ...S]);
+		for (let t of u.list.columns) if (!e.has(t)) throw Error(`defineContentType('${u.name}'): list.columns entry '${t}' is not a declared field (or lifecycle column) of this content type.`);
+		let t = u.list.defaultSort?.field;
+		if (t !== void 0 && !e.has(t)) throw Error(`defineContentType('${u.name}'): list.defaultSort.field '${t}' is not a declared field (or lifecycle column) of this content type.`);
 	}
-	if (i.tree && y(i.name, a, i.tree), i.address !== void 0) {
-		if (i.tree) throw Error(`defineContentType('${i.name}'): address is for a type outside a tree — a tree type is addressed by its tree.`);
-		if (a[i.address]?.kind !== "string") throw Error(`defineContentType('${i.name}'): address '${i.address}' must be a declared string field.`);
+	if (u.tree && T(u.name, d, u.tree), u.address !== void 0) {
+		if (u.tree) throw Error(`defineContentType('${u.name}'): address is for a type outside a tree — a tree type is addressed by its tree.`);
+		if (d[u.address]?.kind !== "string") throw Error(`defineContentType('${u.name}'): address '${u.address}' must be a declared string field.`);
 	}
-	i.availability && b(i.name, a, i.availability), i.templates && e(i.name, a, i.templates), i.search && t(i.name, a, i.search), i.quality && v(i.name, a, i.quality);
-	for (let e of Object.values(a)) for (let t of e.components ?? []) {
-		let [e] = r(t);
-		if (e !== void 0) throw Error(`defineContentType('${i.name}'): component '${t.id}' ${e.field}: ${e.message}.`);
+	u.availability && E(u.name, d, u.availability), u.templates && a(u.name, d, u.templates), u.search && o(u.name, d, u.search), u.quality && w(u.name, d, u.quality);
+	for (let e of Object.values(d)) for (let t of e.components ?? []) {
+		let [e] = c(t);
+		if (e !== void 0) throw Error(`defineContentType('${u.name}'): component '${t.id}' ${e.field}: ${e.message}.`);
 	}
-	if (i.taxonomy) {
-		let e = a[i.taxonomy.field];
-		if (e?.kind !== "array" || e.element?.kind !== "string") throw Error(`defineContentType('${i.name}'): taxonomy field '${i.taxonomy.field}' must be a declared Schema.Array(Schema.String) field.`);
-		let t = n(i.taxonomy);
-		if (t !== null) throw Error(`defineContentType('${i.name}'): taxonomy ${t}.`);
+	if (u.taxonomy) {
+		let e = d[u.taxonomy.field];
+		if (e?.kind !== "array" || e.element?.kind !== "string") throw Error(`defineContentType('${u.name}'): taxonomy field '${u.taxonomy.field}' must be a declared Schema.Array(Schema.String) field.`);
+		let t = s(u.taxonomy);
+		if (t !== null) throw Error(`defineContentType('${u.name}'): taxonomy ${t}.`);
+	}
+	if (u.lifecycle && !(Number.isInteger(u.lifecycle.reviewEveryDays) && u.lifecycle.reviewEveryDays > 0)) throw Error(`defineContentType('${u.name}'): lifecycle.reviewEveryDays must be a positive whole number of days.`);
+	let h = u.seo === void 0 ? void 0 : n(u.seo);
+	if (h !== void 0 && r(h, d), u.seoSites !== void 0 && h === void 0) throw new t({ reason: "definition" });
+	let g = u.seoSites === void 0 ? void 0 : i(u.seoSites), _ = u.locations === void 0 ? void 0 : l(u.locations);
+	for (let t of _ ?? []) for (let n of t.segments) if (typeof n != "string") {
+		if ("field" in n && d[n.field]?.kind !== "string") throw new e({ reason: "field" });
+		if ("tree" in n && u.tree === void 0) throw new e({ reason: "tree" });
 	}
-	if (i.lifecycle && !(Number.isInteger(i.lifecycle.reviewEveryDays) && i.lifecycle.reviewEveryDays > 0)) throw Error(`defineContentType('${i.name}'): lifecycle.reviewEveryDays must be a positive whole number of days.`);
 	return {
-		name: i.name,
-		displayName: i.displayName,
-		pluralName: i.pluralName,
-		fields: a,
-		...i.list ? { list: i.list } : {},
-		...i.idPrefix ? { idPrefix: i.idPrefix } : {},
-		...i.revalidate ? { revalidate: i.revalidate } : {},
-		...i.tree ? { tree: i.tree } : {},
-		...i.address === void 0 ? {} : { address: i.address },
-		...i.review ? { review: i.review } : {},
-		...i.availability ? { availability: i.availability } : {},
-		...i.lifecycle ? { lifecycle: i.lifecycle } : {},
-		...i.templates ? { templates: i.templates } : {},
-		...i.changeFeed === !0 ? { changeFeed: !0 } : {},
-		...i.search ? { search: i.search } : {},
-		...i.quality && i.quality.length > 0 ? { quality: i.quality } : {},
-		...i.taxonomy ? { taxonomy: i.taxonomy } : {},
-		derivedFields: o,
-		uniqueFields: s
+		name: u.name,
+		displayName: u.displayName,
+		pluralName: u.pluralName,
+		fields: d,
+		...m === void 0 ? {} : { asset: m },
+		...u.list ? { list: u.list } : {},
+		...u.idPrefix ? { idPrefix: u.idPrefix } : {},
+		...u.revalidate ? { revalidate: u.revalidate } : {},
+		...u.tree ? { tree: u.tree } : {},
+		...u.address === void 0 ? {} : { address: u.address },
+		..._ === void 0 ? {} : { locations: _ },
+		...h === void 0 ? {} : { seo: h },
+		...g === void 0 ? {} : { seoSites: g },
+		...u.review ? { review: u.review } : {},
+		...u.availability ? { availability: u.availability } : {},
+		...u.lifecycle ? { lifecycle: u.lifecycle } : {},
+		...u.templates ? { templates: u.templates } : {},
+		...u.changeFeed === !0 ? { changeFeed: !0 } : {},
+		...u.search ? { search: u.search } : {},
+		...u.quality && u.quality.length > 0 ? { quality: u.quality } : {},
+		...u.taxonomy ? { taxonomy: u.taxonomy } : {},
+		derivedFields: f,
+		uniqueFields: p
 	};
-}, v = (e, t, n) => {
+}, w = (e, t, n) => {
 	let r = /* @__PURE__ */ new Set();
 	for (let i of n) {
 		if (!/^[A-Za-z][A-Za-z0-9.-]{0,63}$/.test(i.id)) throw Error(`defineContentType('${e}'): quality rule id '${i.id}' must be letters, digits, '.' or '-', at most 64.`);
@@ -88,7 +105,7 @@ var m = [
 		if (r.add(i.id), t[i.field] === void 0) throw Error(`defineContentType('${e}'): quality rule '${i.id}' names '${i.field}', which is no field of this type.`);
 		if (i.sites?.length === 0 || i.locales?.length === 0) throw Error(`defineContentType('${e}'): quality rule '${i.id}' names an empty list of sites or locales — leave it out to apply everywhere.`);
 	}
-}, y = (e, t, n) => {
+}, T = (e, t, n) => {
 	let r = (t) => {
 		throw Error(`defineContentType('${e}'): tree ${t}`);
 	}, i = t[n.parent];
@@ -99,7 +116,7 @@ var m = [
 		let n = t[i.mask];
 		(n === void 0 || !n.isOptional || n.kind !== "boolean") && r(`inherit '${e}' mask '${i.mask}' must be a declared optional Boolean field.`), i.locked === !0 && r(`inherit '${e}' is locked, so it cannot be masked — drop 'mask' or 'locked'.`);
 	}
-}, b = (e, t, n) => {
+}, E = (e, t, n) => {
 	let r = n.until === void 0 ? void 0 : t[n.until];
 	if (n.until !== void 0 && (r === void 0 || r.kind !== "date" && r.kind !== "datetime")) throw Error(`defineContentType('${e}'): availability.until '${n.until}' must be a declared date or datetime field.`);
 	let i = n.blocked === void 0 ? void 0 : t[n.blocked];
@@ -114,78 +131,78 @@ var m = [
 		let i = n[r] === void 0 ? void 0 : t[n[r]];
 		if (n[r] !== void 0 && (i?.kind !== "array" || i.element?.kind !== "string" && i.element?.kind !== "literal")) throw Error(`defineContentType('${e}'): availability.${r} '${n[r]}' must be a declared list of text or choices.`);
 	}
-}, x = (e) => {
+}, D = (e) => {
 	switch (e.kind) {
-		case "string": return e.isOptional ? d().nullable() : d();
-		case "number": return e.fraction === !0 ? e.isOptional ? l().nullable() : l() : e.isOptional ? s().nullable() : s();
-		case "boolean": return e.isOptional ? i().nullable() : i();
-		case "date": return e.isOptional ? a().nullable() : a();
-		case "datetime": return e.isOptional ? f().nullable() : f();
+		case "string": return e.isOptional ? _().nullable() : _();
+		case "number": return e.fraction === !0 ? e.isOptional ? h().nullable() : h() : e.isOptional ? p().nullable() : p();
+		case "boolean": return e.isOptional ? u().nullable() : u();
+		case "date": return e.isOptional ? d().nullable() : d();
+		case "datetime": return e.isOptional ? v().nullable() : v();
 		case "literal": {
-			let t = e.literals ?? [], n = t.length > 0 ? d().oneOf(t) : d();
+			let t = e.literals ?? [], n = t.length > 0 ? _().oneOf(t) : _();
 			return e.isOptional ? n.nullable() : n;
 		}
 		case "richText":
 		case "array":
 		case "struct":
 		case "components": {
-			let t = c();
+			let t = m();
 			return e.isOptional ? t.nullable() : t;
 		}
 		case "media":
-		case "reference": return e.isOptional ? d().nullable() : d();
+		case "reference": return e.isOptional ? _().nullable() : _();
 	}
-}, S = (e) => {
+}, O = (e) => {
 	let t = {};
-	for (let [n, r] of Object.entries(e.fields)) t[n] = x(r);
+	for (let [n, r] of Object.entries(e.fields)) t[n] = D(r);
 	return t;
-}, C = (e) => e.idPrefix, w = (e, t) => {
-	let n = C(e), r = n ? o({ prefix: n }) : o(), i = u(`${e.name}_${t}`, {
+}, k = (e) => e.idPrefix, A = (e, t) => {
+	let n = k(e), r = n ? f({ prefix: n }) : f(), i = g(`${e.name}_${t}`, {
 		id: r,
-		status: d().oneOf(h),
+		status: _().oneOf(x),
 		...t === "drafts" ? {
-			publishAt: f().nullable(),
-			unpublishAt: f().nullable()
+			publishAt: v().nullable(),
+			unpublishAt: v().nullable()
 		} : {},
-		revisionId: d().default(""),
-		revision: s().default(0),
-		documentId: d().maxLength(64).backfill((e) => String(e.id)),
-		site: d().maxLength(64).default(""),
-		environment: d().maxLength(64).default(""),
-		locale: d().maxLength(64).default(""),
-		...S(e)
-	}).with(p()).unique(D(e, `${e.name}_${t}_variant_key`, "the document variant key"), [
+		revisionId: _().default(""),
+		revision: p().default(0),
+		documentId: _().maxLength(64).backfill((e) => String(e.id)),
+		site: _().maxLength(64).default(""),
+		environment: _().maxLength(64).default(""),
+		locale: _().maxLength(64).default(""),
+		...O(e)
+	}).with(y()).unique(N(e, `${e.name}_${t}_variant_key`, "the document variant key"), [
 		"tenantId",
-		...m,
+		...b,
 		"documentId"
 	]);
-	return e.uniqueFields.reduce((n, r) => n.unique(E(e, t, r), [
+	return e.uniqueFields.reduce((n, r) => n.unique(M(e, t, r), [
 		"tenantId",
-		...m,
+		...b,
 		r
 	]), i);
-}, T = 63, E = (e, t, n) => D(e, `${e.name}_${t}_uq_${n}`, `the unique constraint for field '${n}'`), D = (e, t, n) => {
-	if (t.length > T) throw Error(`contentTypeToEntities('${e.name}'): ${n} would be named '${t}' (${t.length} chars), past the ${T}-byte identifier limit. Shorten the content type name or the field name.`);
+}, j = 63, M = (e, t, n) => N(e, `${e.name}_${t}_uq_${n}`, `the unique constraint for field '${n}'`), N = (e, t, n) => {
+	if (t.length > j) throw Error(`contentTypeToEntities('${e.name}'): ${n} would be named '${t}' (${t.length} chars), past the ${j}-byte identifier limit. Shorten the content type name or the field name.`);
 	return t;
-}, O = "cms_revisions", k = u(O, {
-	id: o({ prefix: "crev" }),
-	contentType: d().maxLength(64),
-	documentId: d().maxLength(64),
-	number: s(),
-	site: d().maxLength(64).default(""),
-	environment: d().maxLength(64).default(""),
-	locale: d().maxLength(64).default(""),
-	values: c(),
-	basedOn: d().nullable()
-}).with(p()).unique("cms_revisions_uq_variant_number", [
+}, P = "cms_revisions", F = g(P, {
+	id: f({ prefix: "crev" }),
+	contentType: _().maxLength(64),
+	documentId: _().maxLength(64),
+	number: p(),
+	site: _().maxLength(64).default(""),
+	environment: _().maxLength(64).default(""),
+	locale: _().maxLength(64).default(""),
+	values: m(),
+	basedOn: _().nullable()
+}).with(y()).unique("cms_revisions_uq_variant_number", [
 	"tenantId",
 	"contentType",
 	"documentId",
-	...m,
+	...b,
 	"number"
-]), A = (e) => ({
-	draft: w(e, "drafts"),
-	published: w(e, "published")
+]), I = (e) => ({
+	draft: A(e, "drafts"),
+	published: A(e, "published")
 });
 //#endregion
-export { O as CMS_REVISIONS_TABLE, m as CMS_SCOPE_COLUMNS, h as CONTENT_STATUSES, g as RESERVED_FIELD_NAMES, k as cmsRevisionsTable, A as contentTypeToEntities, _ as defineContentType };
+export { P as CMS_REVISIONS_TABLE, b as CMS_SCOPE_COLUMNS, x as CONTENT_STATUSES, S as RESERVED_FIELD_NAMES, F as cmsRevisionsTable, I as contentTypeToEntities, C as defineContentType };

package/dist/contentValues.js

@@ -0,0 +1,18 @@
+//#region src/contentValues.ts
+var e = (e, t) => {
+	let n = {};
+	for (let r of Object.keys(e.fields)) r in t && (n[r] = t[r]);
+	return n;
+}, t = (e) => {
+	if (e == null) return {
+		ok: !0,
+		value: null
+	};
+	let t = e instanceof Date ? e : typeof e == "string" || typeof e == "number" ? new Date(e) : null;
+	return t === null || !Number.isFinite(t.getTime()) ? { ok: !1 } : {
+		ok: !0,
+		value: t.toISOString()
+	};
+};
+//#endregion
+export { e as pickDeclared, t as readContentModificationTime };

package/dist/copies.js

@@ -1,5 +1,5 @@
-import { asTyped as e } from "./effectForm.js";
-import { ContentIdConflict as t, ContentNotFound as n, ContentValidationFailed as r, RevisionMismatch as i } from "./errors.js";
+import { ContentIdConflict as e, ContentNotFound as t, ContentValidationFailed as n, RevisionMismatch as r } from "./errors.js";
+import { asTyped as i } from "./effectForm.js";
 import { saveDraft as a } from "./write.js";
 import { and as o, eq as s, id as c, table as l, text as u, timestamp as d } from "@voltro/database";
 import { tenant as f } from "@voltro/plugin-multitenancy/mixin";
@@ -84,6 +84,6 @@ var p = "cms_copies", m = l(p, {
 })).map((e) => ({
 	...b(e),
 	documentId: String(e.documentId)
-})), S = (...a) => e(() => v(...a), r, n, t, i), C = (...t) => e(() => y(...t)), w = (...t) => e(() => x(...t));
+})), S = (...a) => i(() => v(...a), n, t, e, r), C = (...e) => i(() => y(...e)), w = (...e) => i(() => x(...e));
 //#endregion
 export { p as CMS_COPIES_TABLE, m as cmsCopiesTable, x as copiesOf, w as copiesOfEffect, v as copyDocument, S as copyDocumentEffect, y as copyOrigin, C as copyOriginEffect };

package/dist/domainHost.js

@@ -0,0 +1,7 @@
+//#region src/domainHost.ts
+var e = /^(?=.{1,253}$)(?!-)[a-z0-9-]{1,63}(?<!-)(\.(?!-)[a-z0-9-]{1,63}(?<!-))+$/, t = (t) => {
+	let n = t.trim().toLowerCase().replace(/\.$/, "");
+	return e.test(n) && !/^\d+(\.\d+){3}$/.test(n) ? n : null;
+};
+//#endregion
+export { t as normalizeHost };