@voltro/cms 0.86.0 → 0.88.0

package/dist/contentRouteMaterializer.js

@@ -0,0 +1,96 @@
+import { resolveContentLocation as e } from "./contentLocations.js";
+import { copySnapshotResource as t } from "./buildSnapshot.js";
+import { snapshotRouteOwnership as n } from "./snapshotRouting.js";
+import { resolveContentTreePath as r } from "./contentTreePath.js";
+import { contentRouteId as i } from "./contentRouteIdentity.js";
+import { Schema as a } from "effect";
+import { createHash as o } from "node:crypto";
+import { canonicalJson as s } from "@voltro/runtime";
+// src/contentRouteMaterializer.ts
+var c = class extends a.TaggedError()("ContentRouteMaterializationUnavailable", { reason: a.Literals([
+	"scope",
+	"publication",
+	"bounds"
+]) }) {}, l = (e) => {
+	throw new c({ reason: e });
+}, u = (e) => typeof e == "string" && e.length > 0, d = (e, t) => e < t ? -1 : +(e > t), f = (e) => o("sha256").update(s(e)).digest("hex");
+async function* p(a, o) {
+	let { scope: s, site: c, routing: p, definitionDigest: m } = a;
+	if (c.definition.id !== s.site || !c.definition.environments.includes(s.environment)) return l("scope");
+	for (let h of a.types) if (h.locations.length !== 0) for (let a of c.definition.locales.filter((e) => e.enabled).sort((e, t) => d(e.id, t.id))) {
+		let d = [a.contentLocale, ...c.fallback[a.contentLocale]], g = async (e) => {
+			for (let t of d) {
+				let n = await o.read(h.name, t, e);
+				if (n !== null) return n;
+			}
+			return null;
+		};
+		for (let c of d) {
+			let d;
+			for (;;) {
+				let _ = await o.page(h.name, c, d);
+				for (let o of _.items) {
+					if (!u(o.documentId)) return l("publication");
+					let c = await g(o.documentId), d = c?.content;
+					if (c === null || d === void 0 || d.id !== o.id) continue;
+					let _ = h.tree === null ? {
+						ok: !0,
+						path: "",
+						ancestors: []
+					} : await r(d, h.tree, async (e) => (await g(e))?.content ?? null);
+					if (!_.ok) return l(_.reason);
+					let v = _.path === null, y = _.ancestors;
+					for (let r of h.locations) {
+						let o = i(s, a.id, h.name, String(d.documentId), r.id), l = {
+							version: 1,
+							...s,
+							routeId: o,
+							mappingId: r.id,
+							contentType: h.name,
+							documentId: d.documentId,
+							localeId: a.id,
+							requestedLocale: a.contentLocale,
+							sourceLocale: d.locale,
+							fallback: d.locale !== a.contentLocale,
+							variantId: d.id,
+							revisionId: d.revisionId,
+							revision: d.revision,
+							definitionDigest: m,
+							lastModified: c.modifiedAt
+						}, u = v ? null : e(r, d, {
+							prefix: a.prefix,
+							...h.tree === null ? {} : { treePath: _.path }
+						}), g = u === null ? `unroutable:${o}` : `path:${f(u)}`;
+						yield t({
+							key: `identity:${o}`,
+							value: {
+								version: 1,
+								kind: "route-index",
+								target: g
+							}
+						}), v ? yield t({
+							key: `unroutable:${o}`,
+							value: {
+								...l,
+								state: "unroutable",
+								reason: "orphan"
+							}
+						}) : yield t({
+							key: g,
+							value: {
+								...l,
+								state: "resolved",
+								path: u,
+								ancestors: y,
+								ownership: n(p, u)
+							}
+						});
+					}
+				}
+				if (_.next === null) break;
+				d = _.next;
+			}
+		}
+	}
+}
+export { c as ContentRouteMaterializationUnavailable, p as materializeContentRoutes };

package/dist/contentRouteTypes.js

@@ -0,0 +1,38 @@
+import { defineContentLocations as e } from "./contentLocations.js";
+// 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))
+	};
+};
+export { r as compileContentRouteTypes };

package/dist/contentSeo.js

@@ -0,0 +1,188 @@
+import { ContentSeoUnavailable as e } from "./errors.js";
+// 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)))
+	});
+};
+export { s as defineContentSeo, c as defineContentSeoDefaults, u as resolveContentSeo, l as validateContentSeoFields };

package/dist/contentTreePath.js

@@ -0,0 +1,59 @@
+import { resolveContentLocation as e } from "./contentLocations.js";
+// 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
+	};
+};
+export { t as resolveContentTreePath };