@voltro/cms 0.85.0 → 0.87.0

package/dist/snapshotFieldPlan.js

@@ -0,0 +1,85 @@
+import { readCapturedPublication as e } from "./publicationState.js";
+import { pageSnapshotResources as t, readVerifiedSnapshotResource as n } from "./buildSnapshot.js";
+import { copySnapshotRenditionRequirements as r } from "./snapshotRenditions.js";
+import { SnapshotMediaUnavailable as i, compileSnapshotMediaFields as a } from "./snapshotMediaFields.js";
+import { canonicalJson as o } from "@voltro/runtime";
+//#region src/snapshotFieldPlan.ts
+var s = (e) => {
+	throw new i({ reason: e });
+}, c = async (i, c, l, u) => {
+	let { snapshot: d, document: f, output: p } = l, m = async (e) => {
+		let n = [], r;
+		for (;;) {
+			let a = await t(i, c, d.id, e, {
+				now: u,
+				limit: 200,
+				...r === void 0 ? {} : { after: r }
+			});
+			if (n.push(...a.items), n.length > 8192) return s("bounds");
+			if (a.next === null) return n;
+			r = a.next;
+		}
+	}, h = a(await m("schema"), await m("components")), g = h.find((e) => e.name === p.contentType), _ = await e(i, c, d.manifest.publication.id, p.contentType, p.sourceLocale, String(f.variantId), u);
+	if (g === void 0 || _ === null || _.documentId !== f.documentId || _.revisionId !== f.revisionId || _.revision !== f.revision) return s("publication");
+	let v = (await n(i, c, d, "assets", "configuration")).value, y = r(v.renditionRequirements), b = [], x = [], S = (e) => {
+		let t = p.values;
+		for (let n of e) {
+			if (typeof t != "object" || !t || !Object.hasOwn(t, n) || (Array.isArray(t) ? typeof n != "number" : typeof n != "string")) {
+				t = void 0;
+				break;
+			}
+			t = t[n];
+		}
+		return t;
+	}, C = [];
+	for (let e of g.dependencies(_)) {
+		let t = S(e.path);
+		if (t !== void 0) {
+			if (e.kind === "component") {
+				if (typeof t != "object" || !t || Array.isArray(t)) return s("publication");
+				if (t.componentId !== e.componentId) continue;
+			} else if (e.kind === "token" && t !== e.name) return s("publication");
+			if (C.push(e), C.length > 8192) return s("bounds");
+		}
+	}
+	for (let e of g.uses(_)) {
+		let t = S(e.path);
+		if (t === void 0) continue;
+		if (t !== ("mediaKey" in e ? e.mediaKey : e.targetDocumentId)) return s("publication");
+		if ("targetType" in e && (x.push(e), x.length > 8192)) return s("bounds");
+		let n = "targetType" in e ? h.find((t) => t.name === e.targetType) : e.path.length === 1 && g.definition.asset?.file === e.path[0] ? g : void 0;
+		if (!("targetType" in e && n?.definition.asset === void 0)) {
+			if (b.push({
+				fieldPath: [...e.path],
+				output: { kind: "original" }
+			}), n !== void 0) for (let t of y.filter((e) => e.contentType === n.name)) b.push({
+				fieldPath: [...e.path],
+				output: {
+					kind: "rendition",
+					slot: t.slot
+				}
+			});
+			if (b.length > 1024) return s("bounds");
+		}
+	}
+	let w = (e) => e.map((e) => ({
+		value: e,
+		key: o(e)
+	})).sort((e, t) => e.key < t.key ? -1 : +(e.key > t.key)).map((e) => e.value);
+	return {
+		references: w(x),
+		media: w(b),
+		dependencies: w(C),
+		content: {
+			contentType: p.contentType,
+			documentId: String(f.documentId),
+			variantId: String(f.variantId),
+			revisionId: String(f.revisionId),
+			revision: Number(f.revision),
+			sourceLocale: p.sourceLocale,
+			definitionDigest: g.digest
+		}
+	};
+};
+//#endregion
+export { c as readAdmittedSnapshotFieldPlan };

package/dist/snapshotFrontend.js

@@ -0,0 +1,103 @@
+import { copySnapshotResource as e, readVerifiedSnapshotResource as t } from "./buildSnapshot.js";
+import { snapshotComponentDefinition as n, snapshotDefinitionSources as r } from "./snapshotDefinitions.js";
+import { FrontendBindingUnavailable as i, copyFrontendContexts as a, copyFrontendOutputSelection as o, defineFrontendBindings as s, frontendRendererId as c, supportsFrontendContext as l } from "./frontendBindings.js";
+import { createHash as u } from "node:crypto";
+import { canonicalJson as d } from "@voltro/runtime";
+//#region src/snapshotFrontend.ts
+var f = (e) => u("sha256").update(d(e)).digest("hex"), p = (e, t, n) => ({
+	kind: "app-implementation",
+	app: e,
+	path: [
+		"frontend",
+		t,
+		n
+	]
+}), m = (e, t) => ({
+	empty: p(e, t, "empty"),
+	loading: p(e, t, "loading"),
+	error: p(e, t, "error")
+}), h = (e, t, a, c) => {
+	let l = s(t), u = new Map([...r(e, a).components.entries()].map((e) => [e.key, e.value]));
+	return {
+		version: 2,
+		output: o(c),
+		components: Object.entries(l).map(([e, t]) => {
+			let r = u.get(`component:${e}`);
+			if (r === void 0 || d(n(t.schema, a).value) !== d(r)) throw new i({ reason: "schema" });
+			return {
+				id: e,
+				digest: f(r),
+				renderer: t.renderer,
+				contexts: t.contexts,
+				...m(a, e),
+				render: p(a, e, "render"),
+				restricted: t.restricted === void 0 ? null : p(a, e, "restricted")
+			};
+		})
+	};
+}, g = () => {
+	throw new i({ reason: "definition" });
+}, _ = (t) => {
+	if (typeof t != "object" || !t || Array.isArray(t)) return g();
+	let n = e({
+		key: "frontend",
+		value: t
+	}).value;
+	return n.version !== 2 || !Array.isArray(n.components) || n.components.length > 4096 ? g() : n;
+}, v = (e, t, n) => {
+	let r = o(e.output), i = [], s = /* @__PURE__ */ new Set();
+	for (let r of e.components) {
+		if (typeof r != "object" || !r || Array.isArray(r)) return g();
+		let e = r;
+		if (typeof e.id != "string" || !/^[a-z][a-zA-Z0-9]*$/.test(e.id) || s.has(e.id) || !c(e.renderer)) return g();
+		s.add(e.id);
+		let o = n.get(e.id);
+		if (o === void 0) return g();
+		let l = o.definition;
+		if (l.id !== e.id || d(o.app) !== d(t) || l.consent !== void 0 && e.restricted === null) return g();
+		let u = a(e.contexts);
+		i.push({
+			id: e.id,
+			digest: f(o),
+			renderer: e.renderer,
+			contexts: u,
+			...m(t, e.id),
+			render: p(t, e.id, "render"),
+			restricted: e.restricted === null ? null : p(t, e.id, "restricted")
+		});
+	}
+	i.sort((e, t) => e.id < t.id ? -1 : +(e.id > t.id));
+	let l = {
+		version: 2,
+		output: r,
+		components: i
+	};
+	return d(e) === d(l) ? l : g();
+}, y = (e, t, n, i) => {
+	let a = new Map([...r(e, n).components.entries()].filter((e) => e.key.startsWith("component:")).map((e) => [e.key.slice(10), e.value])), s = v(_(t), n, a);
+	return d(s.output) === d(o(i)) ? s : g();
+}, b = async (e, n, r, i, a) => {
+	let o;
+	try {
+		o = _(i);
+	} catch {
+		return !1;
+	}
+	let s = /* @__PURE__ */ new Map();
+	for (let i of o.components) {
+		if (typeof i != "object" || !i || Array.isArray(i)) return !1;
+		let a = i.id;
+		if (typeof a != "string" || !/^[a-z][a-zA-Z0-9]*$/.test(a) || s.has(a)) return !1;
+		s.set(a, (await t(e, n, r, "components", `component:${a}`)).value);
+	}
+	try {
+		return v(o, a, s), !0;
+	} catch {
+		return !1;
+	}
+}, x = (e, t, n) => {
+	let r = e;
+	return t.every((e) => r.components.some((t) => t.id === e.id && t.digest === e.digest && (n === void 0 || l(t.contexts, n))));
+};
+//#endregion
+export { x as coversSnapshotComponents, b as matchesSnapshotFrontend, y as snapshotFrontendFromManifest, h as snapshotFrontendManifest };

package/dist/snapshotLink.js

@@ -0,0 +1,8 @@
+//#region src/snapshotLink.ts
+var e = (e, t) => {
+	let n = Object.getOwnPropertyDescriptor(e, Symbol.for("voltro.cms.snapshot.link/v1"));
+	if (n === void 0 || n.enumerable || n.writable || typeof n.value != "function") throw Error("Snapshot link unavailable");
+	return n.value(t);
+};
+//#endregion
+export { e as snapshotLink };

package/dist/snapshotMedia.js

@@ -0,0 +1,111 @@
+import { pageCapturedPublications as e, readCapturedDocument as t, verifyPublicationState as n } from "./publicationState.js";
+import { copySnapshotResource as r } from "./buildSnapshot.js";
+import { snapshotDefinitionSources as i } from "./snapshotDefinitions.js";
+import { pinAssetRevision as a } from "./assetRevision.js";
+import { SnapshotMediaUnavailable as o, compileSnapshotMediaFields as s } from "./snapshotMediaFields.js";
+import { createHash as c } from "node:crypto";
+import { canonicalJson as l } from "@voltro/runtime";
+//#region src/snapshotMedia.ts
+var u = (e) => {
+	throw new o({ reason: e });
+}, d = (e) => c("sha256").update(l(e)).digest("hex"), f = (e) => typeof e == "string" && e.length > 0, p = (o, c, l, p, m = Date.now()) => {
+	let h = {
+		tenantId: c.tenantId,
+		site: c.site,
+		environment: c.environment
+	};
+	if (!Object.values(h).every(f)) return u("scope");
+	let g = i(l, p);
+	return {
+		format: "voltro.cms.media-uses/v1",
+		entries: async function* (i) {
+			let c = await n(o, h, i, m), l = [], p = [];
+			for await (let e of g.schema.entries()) l.push(e);
+			for await (let e of g.components.entries()) p.push(e);
+			let _ = s(l, p);
+			if (c.types.length !== _.length || c.types.some((e) => !_.some((t) => t.name === e))) return u("scope");
+			let v = d({
+				schemas: l,
+				components: p
+			});
+			yield r({
+				key: "configuration",
+				value: {
+					version: 1,
+					...h,
+					definitionDigest: v,
+					assetResolution: "exact-locale/v1",
+					app: l[0].value.app,
+					types: _.map((e) => e.name),
+					locales: c.locales
+				}
+			});
+			for (let n of _) for (let s of c.locales) {
+				let c;
+				for (;;) {
+					let l = await e(o, h, i.id, n.name, s, {
+						limit: 200,
+						now: m,
+						...c === void 0 ? {} : { after: c }
+					});
+					for (let e of l.items) {
+						if (![
+							e.id,
+							e.documentId,
+							e.revisionId
+						].every(f) || !Number.isSafeInteger(e.revision) || Number(e.revision) < 1) return u("publication");
+						let c = n.definition.asset === void 0 ? void 0 : a(h, n.definition, n.digest, e);
+						for (let l of n.uses(e)) {
+							let f = c !== void 0 && l.path.length === 1 && l.path[0] === c.fileField ? c : void 0, p, g;
+							if ("mediaKey" in l) p = l.mediaKey;
+							else {
+								let r = _.find((e) => e.name === l.targetType);
+								if (r === void 0 || r.definition.asset === void 0) continue;
+								let c = await t(o, h, i.id, r.name, s, l.targetDocumentId, m);
+								if (c === null) return u("asset");
+								f = a(h, r.definition, r.digest, c), p = f.fileRefId, g = {
+									id: d([
+										"cms-asset-placement/v1",
+										h.tenantId,
+										h.site,
+										n.name,
+										e.id,
+										l.path
+									]),
+									resolution: "exact-locale/v1"
+								};
+							}
+							yield r({
+								key: `media-use:${d([
+									n.name,
+									e.id,
+									l.path
+								])}`,
+								value: {
+									version: 1,
+									...h,
+									publicationId: i.id,
+									definitionDigest: v,
+									contentType: n.name,
+									documentId: e.documentId,
+									variantId: e.id,
+									revisionId: e.revisionId,
+									revision: e.revision,
+									locale: s,
+									path: l.path,
+									mediaKey: p,
+									...f === void 0 ? {} : { assetRevision: f },
+									...g === void 0 ? {} : { placement: g }
+								}
+							});
+						}
+					}
+					if (l.next === null) break;
+					c = l.next;
+				}
+			}
+		}
+	};
+};
+//#endregion
+export { p as snapshotMediaUsesSource };

package/dist/snapshotMediaCapture.js

@@ -0,0 +1,246 @@
+import { deriveBuildSnapshot as e, pinnedSnapshotPartSource as t, readVerifiedSnapshotResource as n, verifyBuildSnapshot as r } from "./buildSnapshot.js";
+import { Effect as i, Schema as a, Stream as o } from "effect";
+import { and as s, eq as c, json as l, table as u, text as d, timestamp as f } from "@voltro/database";
+import { createHash as p, randomUUID as m } from "node:crypto";
+import { canonicalJson as h } from "@voltro/runtime";
+//#region src/snapshotMediaCapture.ts
+var g = "_voltro_cms_snapshot_media_captures", _ = u(g, {
+	id: d().maxLength(64),
+	captureId: d().maxLength(64),
+	tenantId: d().maxLength(64),
+	site: d().maxLength(64),
+	environment: d().maxLength(64),
+	contextDigest: d().maxLength(64),
+	config: l(),
+	state: d().oneOf([
+		"registering",
+		"registered",
+		"complete",
+		"abandoned"
+	]),
+	nonce: d().maxLength(64),
+	candidate: l().nullable(),
+	custody: l().nullable(),
+	result: l().nullable(),
+	expiresAt: f().nullable(),
+	cleanupCheckedAt: f()
+}).primaryKey(["id"]).index("cms_media_cleanup_order", ["cleanupCheckedAt", "id"]).nonReactive(), v = class extends a.TaggedError()("SnapshotMediaCaptureUnavailable", { reason: a.Literals([
+	"scope",
+	"identity",
+	"state",
+	"media",
+	"integrity"
+]) }) {}, y = (e) => {
+	throw new v({ reason: e });
+}, b = (e) => p("sha256").update(h(e)).digest("hex"), x = (e) => i.tryPromise({
+	try: e,
+	catch: (e) => e
+}), S = (e) => typeof e == "string" && /^[a-f0-9]{64}$/.test(e), C = (e) => typeof e == "string" && e.length > 0 && e.length <= 64, w = (e) => ({
+	tenantId: e.tenantId,
+	site: e.site,
+	environment: e.environment
+}), T = (e) => ({
+	id: e.id,
+	contextDigest: e.contextDigest
+}), E = (e, t) => !Object.values(w(e)).every(C) || !C(t.id) || !S(t.contextDigest) ? y("scope") : b([
+	e.tenantId,
+	e.site,
+	e.environment,
+	t.id
+]), D = (e, t) => s(c("id", E(e, t)), c("tenantId", e.tenantId), c("site", e.site), c("environment", e.environment)), O = (e) => {
+	let t = e;
+	return typeof t != "object" || !t || !C(t.id) || !S(t.digest) ? y("integrity") : {
+		id: t.id,
+		digest: t.digest
+	};
+}, k = (e, t, n) => b({
+	version: 1,
+	scope: e,
+	key: t,
+	candidate: n
+}), A = async (e, t, n, r = !1) => {
+	let [i] = await e.query({
+		table: g,
+		predicate: D(t, n),
+		order: [],
+		take: 1,
+		skip: void 0,
+		projection: void 0,
+		...r ? { lock: "update" } : {}
+	});
+	return i === void 0 || i.captureId !== n.id || i.contextDigest !== n.contextDigest ? y("identity") : [
+		"registering",
+		"registered",
+		"complete",
+		"abandoned"
+	].includes(String(i.state)) ? r && await e.update("_voltro_cms_snapshot_media_captures", E(t, n), { nonce: m() }) === null ? y("identity") : i : y("integrity");
+}, j = (e, t, n) => {
+	let r = O(e.candidate), i = e.custody;
+	return typeof i != "object" || !i || i.id !== E(t, n) || i.tenantId !== t.tenantId || i.contextDigest !== k(t, n, r) || typeof i.instance != "string" || typeof i.bucket != "string" ? y("integrity") : {
+		candidate: r,
+		custody: { ...i }
+	};
+}, M = (e, t, n, r) => {
+	let a = w(n);
+	return !Object.values(a).every(C) || !["voltro.cms.media-uses/v1", "voltro.cms.media-renditions/v1"].includes(r.format) ? y("media") : {
+		format: "voltro.cms.media-selection/v1",
+		entries: async function* (n) {
+			for await (let o of r.entries(n)) {
+				if (o.key === "configuration") {
+					yield o;
+					continue;
+				}
+				let n = o.value.mediaKey;
+				if (!C(n)) return y("media");
+				let r = await i.runPromise(t.inspect(e, {
+					id: n,
+					tenantId: a.tenantId
+				}));
+				for (let { rendition: e } of N(o.value)) if (h(e.source) !== h(r)) return y("media");
+				yield {
+					...o,
+					value: {
+						...o.value,
+						selectedSource: r
+					}
+				};
+			}
+		}
+	};
+}, N = (e) => {
+	if (e.renditions === void 0) return [];
+	let t = e.renditions;
+	return !Array.isArray(t) || t.length > 64 || t.some((t) => !t || !t.selection || !t.rendition || t.selection.renditionId !== t.rendition.id || !S(t.selection.revisionId) || t.rendition.source?.id !== e.mediaKey || !t.rendition.output?.renditionProof) ? y("media") : t;
+}, P = (e, n, r, i) => {
+	let a = t(e, n, r, "assets", i);
+	return a.format === "voltro.cms.media-selection/v1" ? {
+		format: a.format,
+		entries: async function* (e) {
+			let t;
+			for await (let r of a.entries(e)) {
+				let i = r.value;
+				if (i.version !== 1 || i.tenantId !== n.tenantId || i.site !== n.site || i.environment !== n.environment || !S(i.definitionDigest)) return y("media");
+				if (r.key === "configuration") {
+					if (t !== void 0) return y("media");
+					t = i.definitionDigest;
+				} else {
+					let a = i.path, o = i.selectedSource;
+					if (o == null || o.version !== 1 || o.id !== i.mediaKey || o.tenantId !== n.tenantId || !S(o.digest) || !S(o.sourceDigest) || t === void 0 || i.definitionDigest !== t || i.publicationId !== e.id || ![
+						i.mediaKey,
+						i.contentType,
+						i.documentId,
+						i.variantId,
+						i.revisionId,
+						i.locale
+					].every(C) || !Array.isArray(a) || a.length === 0 || a.length > 128 || !a.every((e) => typeof e == "string" || Number.isSafeInteger(e) && Number(e) >= 0) || !Number.isSafeInteger(i.revision) || Number(i.revision) < 1 || r.key !== `media-use:${b([
+						i.contentType,
+						i.variantId,
+						a
+					])}`) return y("media");
+				}
+				r.key !== "configuration" && N(i), yield r;
+			}
+			if (t === void 0) return y("media");
+		}
+	} : y("media");
+}, F = async (e, t, n, a, o) => {
+	let s = w(n), c = T(a), l = E(s, c), u = o.maxBytes, d = o.capture;
+	if (!Number.isSafeInteger(u) || u < 0) return y("scope");
+	await e.insertIgnore(g, {
+		id: l,
+		captureId: c.id,
+		...s,
+		contextDigest: c.contextDigest,
+		config: { maxBytes: u },
+		state: "registering",
+		nonce: m(),
+		candidate: null,
+		custody: null,
+		result: null,
+		expiresAt: null,
+		cleanupCheckedAt: /* @__PURE__ */ new Date(0)
+	}, { conflictColumns: ["id"] });
+	let f = await A(e, s, c, !0);
+	if (h(f.config) !== h({ maxBytes: u })) return y("identity");
+	if (f.state === "abandoned") return y("state");
+	if (f.state !== "registering") return j(f, s, c), c;
+	let p = await d(e), _ = o.now ?? Date.now(), v = await r(e, s, O(p), _), b = O(v), x = P(e, s, v, _), S = await i.runPromise(t.register(e, {
+		id: l,
+		tenantId: s.tenantId,
+		contextDigest: k(s, c, b),
+		maxBytes: u,
+		sources: async function* () {
+			for await (let e of x.entries(v.manifest.publication)) if (e.key !== "configuration") {
+				yield e.value.selectedSource;
+				for (let { rendition: t } of N(e.value)) yield t.output;
+			}
+		}
+	}));
+	return await e.update(g, l, {
+		state: "registered",
+		candidate: b,
+		custody: S.key,
+		expiresAt: new Date(v.expiresAt)
+	}), c;
+}, I = (t, a, s, c, l = Date.now) => i.gen(function* () {
+	let u = w(s), d = T(c), f = yield* x(() => A(t, u, d));
+	if (f.state !== "registered" && f.state !== "complete") return yield* i.fail(new v({ reason: "state" }));
+	let p = j(f, u, d);
+	return yield* x(() => r(t, u, f.state === "complete" ? O(f.result) : p.candidate, l())), yield* a.run(p.custody), yield* x(() => t.transactional(async (t) => {
+		let s = await A(t, u, d, !0), c = l();
+		if (s.state === "complete") return r(t, u, O(s.result), c);
+		if (s.state !== "registered") return y("state");
+		let f = j(s, u, d), p = await r(t, u, f.candidate, c), m = await i.runPromise(a.seal(t, f.custody)), h = P(t, u, p, c), _ = (e) => `binary:${b([m.source?.instance ?? m.instance, e])}`, v = await e(t, u, f.candidate, { assets: {
+			format: "voltro.cms.media-custody/v2",
+			entries: async function* (e) {
+				yield {
+					key: "custody",
+					value: {
+						version: 1,
+						capture: m
+					}
+				};
+				for await (let e of o.toAsyncIterable(a.items(m, t))) yield {
+					key: _(e.sourceId),
+					value: {
+						version: 1,
+						binaryId: b([
+							"cms-binary/v1",
+							u.tenantId,
+							e.checksum,
+							e.size,
+							e.contentType
+						]),
+						object: e
+					}
+				};
+				for await (let t of h.entries(e)) yield t.key === "configuration" ? t : {
+					...t,
+					value: {
+						...t.value,
+						binaryKey: _(String(t.value.mediaKey)),
+						...t.value.renditions === void 0 ? {} : { renditions: N(t.value).map((e) => ({
+							...e,
+							binaryKey: _(e.rendition.output.id)
+						})) }
+					}
+				};
+			}
+		} }, c);
+		for await (let e of h.entries(p.manifest.publication)) {
+			let r = N(e.value);
+			if (r.length === 0) continue;
+			let i = (await n(t, u, v, "assets", _(String(e.value.mediaKey)))).value.object;
+			for (let { rendition: e } of r) {
+				let r = (await n(t, u, v, "assets", _(e.output.id))).value.object, a = e.output.renditionProof;
+				for (let [e, t] of [[i, a.source], [r, a.output]]) if (!e || e.checksum !== t.checksum || e.size !== t.size || e.contentType !== t.contentType) return y("media");
+			}
+		}
+		return await t.update(g, E(u, d), {
+			state: "complete",
+			result: O(v)
+		}), v;
+	}));
+});
+//#endregion
+export { g as SNAPSHOT_MEDIA_CAPTURES, v as SnapshotMediaCaptureUnavailable, F as beginSnapshotMediaCapture, I as resumeSnapshotMediaCapture, _ as snapshotMediaCapturesTable, M as snapshotMediaSelectionSource };