@voltro/cms 0.85.0 → 0.87.0

package/dist/initializePublicRoutes.js

@@ -0,0 +1,28 @@
+import { PublicRouteRegistryUnavailable as e } from "./publicRouteRegistry.js";
+import { ChangeFeedUnavailable as t, SiteStateUnavailable as n } from "./errors.js";
+import { asTyped as r } from "./effectForm.js";
+import { compilePublicRouteRegistryDefinition as i, compilePublicRouteRouting as a } from "./publicRouteRegistryDefinition.js";
+import { bindInitialPublicRouteDefinition as o } from "./publicRouteRegistryBinding.js";
+//#region src/initializePublicRoutes.ts
+var s = (t) => {
+	try {
+		return i({
+			types: t.types,
+			site: t.site,
+			app: t.code,
+			routing: a(t.routing, t.routeDiscovery, t.code)
+		});
+	} catch (t) {
+		throw t instanceof e ? t : new e({ reason: "definition" });
+	}
+}, c = (i, a, c, l = {}) => r(async () => {
+	if (i.savepoint === void 0) throw new e({ reason: "configuration" });
+	let t = s(c);
+	return { revision: (await i.savepoint(() => o(i, a, {
+		expectedRevision: 0,
+		definition: t,
+		now: l.now ?? Date.now()
+	}))).revision };
+}, e, t, n);
+//#endregion
+export { s as compileCmsPublicRouteDeclaration, c as initializeCmsPublicRoutes };

package/dist/liveContentRouteView.js

@@ -0,0 +1,76 @@
+import { publicRouteRegistryFail as e } from "./publicRouteRegistry.js";
+import { compileSiteDelivery as t } from "./siteDelivery.js";
+import { queryPublicRouteIntegrity as n } from "./publicRouteIntegrity.js";
+import { copyOutputActivationScope as r } from "./outputActivation.js";
+import { readContentModificationTime as i } from "./contentValues.js";
+import { readPublicRouteBinding as a } from "./publicRouteRegistryBinding.js";
+import { and as o, eq as s, gt as c } from "@voltro/database";
+//#region src/liveContentRouteView.ts
+var l = (e) => typeof e == "string" && e.length > 0, u = async (u, d) => {
+	let f;
+	try {
+		f = r(d);
+	} catch {
+		return e("scope");
+	}
+	let p = await a(u, f);
+	if (p === null) return e("configuration");
+	let m = t(p.definition.site), h = new Set(p.definition.types.map((e) => e.name)), g = new Set(m.contentLocales), _ = (t, n) => !h.has(t) || !g.has(n) ? e("scope") : o(s("tenantId", f.tenantId), s("site", f.site), s("environment", f.environment), s("locale", n), s("status", "published")), v = (t, n) => {
+		if (![
+			t.id,
+			t.documentId,
+			t.revisionId
+		].every(l) || !Number.isSafeInteger(t.revision) || Number(t.revision) < 1 || t.tenantId !== f.tenantId || t.site !== f.site || t.environment !== f.environment || t.locale !== n || t.status !== "published") return e("state");
+		let r = i(t.updatedAt);
+		return r.ok ? {
+			content: t,
+			modifiedAt: r.value
+		} : e("state");
+	};
+	return {
+		binding: p,
+		site: m,
+		view: {
+			read: async (t, r, i) => {
+				if (!l(i)) return e("state");
+				let a = await n(u, {
+					table: t + "_published",
+					predicate: o(_(t, r), s("documentId", i)),
+					lock: "update",
+					order: [],
+					take: 2,
+					skip: void 0,
+					projection: void 0
+				});
+				if (a.length > 1) return e("state");
+				let c = a[0];
+				return c === void 0 ? null : c.documentId === i ? v(c, r) : e("state");
+			},
+			page: async (t, r, i) => {
+				if (i !== void 0 && (!l(i) || i.length > 256)) return e("bounds");
+				let a = await n(u, {
+					table: t + "_published",
+					predicate: o(_(t, r), ...i === void 0 ? [] : [c("id", i)]),
+					lock: "update",
+					order: [{
+						column: "id",
+						direction: "asc"
+					}],
+					take: 201,
+					skip: void 0,
+					projection: void 0
+				}), s = i ?? "";
+				for (let t of a) {
+					if (v(t, r), String(t.id) <= s) return e("state");
+					s = String(t.id);
+				}
+				return {
+					items: a.slice(0, 200),
+					next: a.length > 200 ? String(a[199].id) : null
+				};
+			}
+		}
+	};
+};
+//#endregion
+export { u as readLiveContentRouteView };

package/dist/media.js

@@ -0,0 +1,29 @@
+import { asTyped as e } from "./effectForm.js";
+//#region src/media.ts
+var t = (e) => Object.entries(e.fields).filter(([, e]) => e.kind === "media").map(([e]) => e), n = async (e, t, r) => {
+	if (t == null) return t;
+	switch (e.kind) {
+		case "media": return typeof t == "string" ? await r(t) ?? t : t;
+		case "array": {
+			let i = e.element;
+			return i === void 0 || !Array.isArray(t) ? t : Promise.all(t.map((e) => n(i, e, r)));
+		}
+		case "struct": {
+			let i = e.struct;
+			if (i === void 0 || typeof t != "object" || Array.isArray(t)) return t;
+			let a = t, o = { ...a };
+			for (let [e, t] of Object.entries(i)) e in a && (o[e] = await n(t, a[e], r));
+			return o;
+		}
+		default: return t;
+	}
+}, r = async (e, t, r) => {
+	let i = { ...t };
+	for (let [a, o] of Object.entries(e.fields)) {
+		let e = o;
+		(e.kind === "media" || e.kind === "array" || e.kind === "struct") && a in t && (i[a] = await n(e, t[a], r));
+	}
+	return i;
+}, i = async (e, t, n) => Promise.all(t.map((t) => r(e, t, n))), a = (e) => t(e), o = (...t) => e(() => r(...t)), s = (...t) => e(() => i(...t));
+//#endregion
+export { a as mediaFields, r as resolveMedia, i as resolveMediaAll, s as resolveMediaAllEffect, o as resolveMediaEffect };

package/dist/metrics.js

@@ -0,0 +1,46 @@
+import { fnv1a as e } from "./fieldSchema.js";
+//#region src/metrics.ts
+var t = (e) => JSON.stringify([
+	e.id,
+	e.formula,
+	e.unit,
+	[...e.scope].sort(),
+	e.freshness,
+	[...e.quality].sort(),
+	[...e.drill].sort()
+]), n = (n) => {
+	if (!Number.isInteger(n.version) || n.version < 1) throw Error(`metric '${n.id}': version must be a positive integer`);
+	return {
+		...n,
+		fingerprint: e(t(n))
+	};
+}, r = (e, t) => {
+	let n = new Map(t.map((e) => [e.id, e]));
+	return e.filter((e) => {
+		let t = n.get(e.id);
+		return t !== void 0 && t.version === e.version && t.fingerprint !== e.fingerprint;
+	}).map((e) => e.id);
+}, i = (e, t) => {
+	let n = /* @__PURE__ */ new Map(), r = 0;
+	for (let { day: i, value: a } of t) {
+		let t = Date.parse(`${i}T23:59:59.999Z`), o = e.find((e) => Date.parse(e.from) <= t && (e.to === null || Date.parse(e.to) > t));
+		if (o === void 0) {
+			r += a;
+			continue;
+		}
+		let s = n.get(o) ?? {
+			value: 0,
+			days: 0
+		};
+		s.value += a, s.days += 1, n.set(o, s);
+	}
+	return {
+		shares: [...n.entries()].map(([e, t]) => ({
+			...e,
+			...t
+		})).sort((e, t) => Date.parse(e.from) - Date.parse(t.from)),
+		unattributed: r
+	};
+};
+//#endregion
+export { i as attributeToRevisions, n as defineMetric, r as metricVersionDrift };

package/dist/migration.js

@@ -0,0 +1,193 @@
+import { asTyped as e } from "./effectForm.js";
+import { MIGRATION_STAGES as t } from "./migrationStages.js";
+import { and as n, eq as r, id as i, table as a, text as o, timestamp as s } from "@voltro/database";
+import { tenant as c } from "@voltro/plugin-multitenancy/mixin";
+//#region src/migration.ts
+var l = "cms_migration_stages", u = "cms_migration_records", d = a(l, {
+	id: i({ prefix: "cmst" }),
+	source: o().maxLength(200),
+	stage: o().oneOf([...t]),
+	ownerId: o().nullable(),
+	status: o().oneOf(["open", "passed"]),
+	note: o().nullable(),
+	evidenceUri: o().nullable(),
+	passedBy: o().nullable(),
+	passedAt: s().nullable()
+}).with(c()).unique("cms_migration_stages_once", [
+	"tenantId",
+	"source",
+	"stage"
+]), f = a(u, {
+	id: i({ prefix: "cmrc" }),
+	source: o().maxLength(200),
+	sourceKey: o().maxLength(200),
+	sourceType: o().maxLength(64),
+	result: o().oneOf([
+		"created",
+		"already",
+		"skipped",
+		"failed"
+	]),
+	targetType: o().maxLength(64).nullable(),
+	targetDocumentId: o().maxLength(64).nullable(),
+	transformation: o().nullable(),
+	conflict: o().nullable(),
+	loss: o().nullable(),
+	recordedAt: s()
+}).with(c()).unique("cms_migration_records_once", [
+	"tenantId",
+	"source",
+	"sourceKey"
+]), p = (e, t) => ({
+	stage: e,
+	ownerId: typeof t?.ownerId == "string" ? t.ownerId : null,
+	status: t?.status === "passed" ? "passed" : "open",
+	note: typeof t?.note == "string" ? t.note : null,
+	evidenceUri: typeof t?.evidenceUri == "string" ? t.evidenceUri : null,
+	passedBy: typeof t?.passedBy == "string" ? t.passedBy : null,
+	passedAt: t?.passedAt instanceof Date ? t.passedAt : t?.passedAt ? new Date(String(t.passedAt)) : null
+}), m = async (e, n) => {
+	let i = await e.query({
+		table: l,
+		predicate: r("source", n),
+		order: [],
+		take: void 0,
+		skip: void 0,
+		projection: void 0
+	});
+	return t.map((e) => p(e, i.find((t) => t.stage === e)));
+}, h = async (e, t, i) => (await e.query({
+	table: l,
+	predicate: n(r("source", t), r("stage", i)),
+	order: [],
+	take: 1,
+	skip: void 0,
+	projection: void 0
+}))[0], g = async (e, t, n, r, i) => {
+	let a = await h(e, t, n);
+	return a?.status === "passed" ? {
+		ok: !1,
+		reason: "passed"
+	} : (a === void 0 ? await e.insert(l, {
+		source: t,
+		stage: n,
+		ownerId: r,
+		status: "open",
+		note: null,
+		evidenceUri: null,
+		passedBy: null,
+		passedAt: null,
+		...i === null ? {} : { tenantId: i }
+	}) : await e.update(l, String(a.id), { ownerId: r }), { ok: !0 });
+}, _ = async (e, n, r, i, a = /* @__PURE__ */ new Date()) => {
+	let o = await m(e, n), s = o.find((e) => e.stage === r);
+	if (s.status === "passed") return {
+		ok: !1,
+		reason: "passed"
+	};
+	if (s.ownerId === null) return {
+		ok: !1,
+		reason: "noOwner"
+	};
+	if (s.ownerId !== i.actorId) return {
+		ok: !1,
+		reason: "notOwner"
+	};
+	let c = i.note.trim();
+	if (c === "" || c.length > 1e3) return {
+		ok: !1,
+		reason: "noNote"
+	};
+	let u = o.slice(0, t.indexOf(r)).find((e) => e.status !== "passed");
+	if (u !== void 0) return {
+		ok: !1,
+		reason: "earlierOpen",
+		stage: u.stage
+	};
+	if (i.gate === !1) return {
+		ok: !1,
+		reason: "gateNotMet"
+	};
+	let d = await h(e, n, r);
+	return await e.update(l, String(d.id), {
+		status: "passed",
+		note: c,
+		evidenceUri: i.evidenceUri?.trim() ? i.evidenceUri.trim().slice(0, 500) : null,
+		passedBy: i.actorId,
+		passedAt: a
+	}), { ok: !0 };
+}, v = async (e, n, r) => {
+	let i = t.slice(t.indexOf(r)), a = 0;
+	for (let t of i) {
+		let r = await h(e, n, t);
+		r?.status === "passed" && (await e.update(l, String(r.id), {
+			status: "open",
+			passedBy: null,
+			passedAt: null
+		}), a++);
+	}
+	return a;
+}, y = async (e, t, i, a, o = /* @__PURE__ */ new Date()) => {
+	for (let s of i) {
+		let i = {
+			sourceType: s.sourceType,
+			result: s.result,
+			targetType: s.targetType ?? null,
+			targetDocumentId: s.targetDocumentId ?? null,
+			transformation: s.transformation ?? null,
+			conflict: s.conflict ?? null,
+			loss: s.loss ?? null,
+			recordedAt: o
+		}, [c] = await e.query({
+			table: u,
+			predicate: n(r("source", t), r("sourceKey", s.sourceKey)),
+			order: [],
+			take: 1,
+			skip: void 0,
+			projection: void 0
+		});
+		c === void 0 ? await e.insert(u, {
+			source: t,
+			sourceKey: s.sourceKey,
+			...i,
+			...a === null ? {} : { tenantId: a }
+		}) : await e.update(u, String(c.id), c.result === "created" && s.result === "already" ? { recordedAt: o } : i);
+	}
+}, b = async (e, t, n = 200) => {
+	let i = await e.query({
+		table: u,
+		predicate: r("source", t),
+		order: [{
+			column: "sourceKey",
+			direction: "asc"
+		}],
+		take: void 0,
+		skip: void 0,
+		projection: void 0
+	}), a = (e) => typeof e == "string" && e !== "" ? e : null, o = i.map((e) => ({
+		sourceKey: String(e.sourceKey),
+		sourceType: String(e.sourceType),
+		result: String(e.result),
+		targetType: a(e.targetType),
+		targetDocumentId: a(e.targetDocumentId),
+		transformation: a(e.transformation),
+		conflict: a(e.conflict),
+		loss: a(e.loss),
+		recordedAt: e.recordedAt instanceof Date ? e.recordedAt : new Date(String(e.recordedAt))
+	})), s = {
+		created: 0,
+		already: 0,
+		skipped: 0,
+		failed: 0
+	};
+	for (let e of o) s[e.result]++;
+	let c = (e) => Number(e.conflict !== null || e.loss !== null);
+	return {
+		counts: s,
+		withConflict: o.filter((e) => e.conflict !== null).length,
+		withLoss: o.filter((e) => e.loss !== null).length,
+		records: [...o].sort((e, t) => c(t) - c(e)).slice(0, n)
+	};
+}, x = (...t) => e(() => m(...t)), S = (...t) => e(() => g(...t)), C = (...t) => e(() => _(...t)), w = (...t) => e(() => v(...t)), T = (...t) => e(() => y(...t)), E = (...t) => e(() => b(...t));
+//#endregion
+export { u as CMS_MIGRATION_RECORDS_TABLE, l as CMS_MIGRATION_STAGES_TABLE, t as MIGRATION_STAGES, f as cmsMigrationRecordsTable, d as cmsMigrationStagesTable, b as migrationLedger, E as migrationLedgerEffect, m as migrationStages, x as migrationStagesEffect, _ as passStage, C as passStageEffect, y as recordMigrationRecords, T as recordMigrationRecordsEffect, v as reopenStage, w as reopenStageEffect, g as setStageOwner, S as setStageOwnerEffect };

package/dist/migrationStages.js

@@ -0,0 +1,13 @@
+//#region src/migrationStages.ts
+var e = [
+	"inventory",
+	"mapping",
+	"dryRun",
+	"reconciliation",
+	"delta",
+	"cutover",
+	"fallback",
+	"uat"
+];
+//#endregion
+export { e as MIGRATION_STAGES };

package/dist/nativeOutputDeploymentService.js

@@ -0,0 +1,205 @@
+import { copyOutputActivationScope as e, createOutputActivationSet as t, outputActivationHash as n } from "./outputActivation.js";
+import { verifyBuildSnapshot as r } from "./buildSnapshot.js";
+import { readSnapshotAppExecution as i } from "./snapshotAppExecution.js";
+import { readStaticPathSetEvidence as a } from "./staticPathSetStore.js";
+import { makeOutputActivationAdmission as o } from "./outputDeployment.js";
+import { CmsOutputDeploymentUnavailable as s, createCmsOutputDeploymentAuthority as c, createCmsOutputDeployments as l } from "./outputDeploymentService.js";
+import { OUTPUT_ACTIVATION_TARGETS as u } from "./outputActivationTargetTable.js";
+import { readOutputActivationTarget as d, retainOutputActivationTarget as f } from "./outputActivationTarget.js";
+import { and as p, eq as m } from "@voltro/database";
+import { canonicalJson as h } from "@voltro/protocol";
+//#region src/nativeOutputDeploymentService.ts
+var g = (e) => {
+	throw new s({ reason: e });
+}, _ = (e, t) => h(e) === h(t), v = (e) => typeof e?.id != "string" || !/^[A-Za-z0-9_-]{1,64}$/.test(e.id) || !(e.material instanceof Uint8Array) || e.material.byteLength < 32 ? g("configuration") : {
+	id: e.id,
+	material: new Uint8Array(e.material)
+}, y = (s) => {
+	let h = s.store, y = e(s.scope), b = s.now ?? Date.now, x = s.pathKeys.map(v), S = v(s.key), C = Object.keys(s.regions).sort(), w = s.quorum;
+	if (x.length < 1 || x.length > 64 || new Set(x.map((e) => e.id)).size !== x.length || C.length < 1 || C.length > 64 || !Number.isSafeInteger(w) || w < 1 || w > C.length) return g("configuration");
+	let T = Object.fromEntries(C.map((e) => {
+		let t = s.regions[e];
+		return !/^[A-Za-z0-9_-]{1,64}$/.test(e) || [
+			"stage",
+			"verify",
+			"readArtifacts",
+			"readRoutes"
+		].some((e) => typeof t[e] != "function") ? g("configuration") : [e, {
+			key: v(t.key),
+			verificationKeys: (t.verificationKeys ?? []).map(v),
+			stage: t.stage.bind(t),
+			verify: t.verify.bind(t),
+			readArtifacts: t.readArtifacts.bind(t),
+			readRoutes: t.readRoutes.bind(t)
+		}];
+	})), { boundary: E, transaction: D } = c(h, y, b), O = async (e, t, a) => {
+		if (typeof a != "string" || !/^[A-Za-z0-9_-]{1,64}$/.test(a)) return g("input");
+		let o = await r(e, y, t, b()), s = await i(e, y, o), c = s.definitions.value, l = (e) => o.manifest.parts.find((t) => t.part === e) ?? g("integrity"), u = n({
+			domain: "voltro.cms.output.schema/v1",
+			pin: l("schema")
+		}), d = n({
+			domain: "voltro.cms.output.bindings/v1",
+			components: l("components"),
+			projection: l("projection"),
+			frontend: c.frontend
+		}), f = n({
+			domain: "voltro.cms.output.cache-key/v1",
+			schemaDigest: u,
+			bindingsDigest: d,
+			site: c.site,
+			routing: c.routing,
+			consentPurposes: c.consentPurposes
+		});
+		return {
+			snapshot: {
+				id: o.id,
+				digest: o.digest,
+				releaseId: o.manifest.publication.releaseId ?? g("state"),
+				publicationGeneration: o.manifest.publication.generation
+			},
+			app: {
+				deploymentId: a,
+				inputsId: s.inputsId,
+				executionId: s.executionId,
+				contractVersion: 1,
+				schemaDigest: u,
+				bindingsDigest: d,
+				cacheKeyDigest: f
+			},
+			renderPolicyDigest: l("policies").digest
+		};
+	}, k = async (e, t) => await d(e, y, t) ?? g("state"), A = async (e, t) => {
+		let n = await O(e, t.set.manifest.snapshot, t.set.manifest.app.deploymentId);
+		return !_(n.app, t.set.manifest.app) || !_(n.snapshot, t.set.manifest.snapshot) || n.renderPolicyDigest !== t.set.manifest.renderPolicyDigest ? g("changed") : n;
+	}, j = o({
+		pathKeys: x,
+		use: s.use.bind(s),
+		now: b,
+		verifyArtifacts: async (e, t) => {
+			let n = await k(e, t.id);
+			if (!_(n.set, t)) return g("changed");
+			let r;
+			for (let e of n.outputs) {
+				let n = T[e.region] ?? g("regions");
+				await n.verify(t, e.outputId);
+				let i = await n.readArtifacts(t, e.outputId);
+				if (r !== void 0 && !_(r, i)) return g("integrity");
+				r = i;
+			}
+			if (r === void 0) return g("regions");
+			let i = [];
+			for (let r of n.pathSets) {
+				let n = t.manifest.paths.find((e) => e.host === r.host) ?? g("integrity");
+				i.push(await a(e, y, {
+					id: r.jobId,
+					digest: n.setId
+				}, x));
+			}
+			return {
+				...r,
+				pathSets: i
+			};
+		}
+	});
+	return {
+		...l({
+			store: h,
+			scope: y,
+			key: S,
+			...s.verificationKeys === void 0 ? {} : { verificationKeys: s.verificationKeys },
+			now: b,
+			readSet: async (e, t) => (await k(e, t)).set,
+			readDeployment: async (e, t) => {
+				let n = await e.query({
+					table: u,
+					predicate: p(m("tenantId", y.tenantId), m("site", y.site), m("environment", y.environment), m("deploymentId", t)),
+					order: [],
+					take: 2,
+					skip: void 0,
+					projection: ["targetId"]
+				});
+				if (n.length !== 1 || typeof n[0].targetId != "string") return g("state");
+				let r = await A(e, await k(e, n[0].targetId));
+				return {
+					app: r.app,
+					renderPolicyDigest: r.renderPolicyDigest
+				};
+			},
+			admit: j,
+			readRoutes: (e, t) => (T[t.region] ?? g("regions")).readRoutes(e, t.outputId),
+			regions: Object.fromEntries(C.map((e) => {
+				let t = T[e];
+				return [e, {
+					key: t.key,
+					verificationKeys: t.verificationKeys,
+					verify: async (n, r, i) => {
+						if ((await k(n, r.id)).outputs.find((t) => t.region === e)?.outputId !== i) return g("regions");
+						await t.verify(r, i);
+					}
+				}];
+			}))
+		}),
+		prepare: (e) => {
+			let r = structuredClone(e);
+			return E(async (e) => {
+				let i = await D(r.credential, e, async (e) => {
+					let i = await O(e, r.snapshot, r.deploymentId);
+					if (!Array.isArray(r.pathSets) || r.pathSets.length < 1 || r.pathSets.length > 256) return g("input");
+					let o = [...r.pathSets].sort((e, t) => e.host < t.host ? -1 : +(e.host > t.host)), s = [];
+					for (let t of o) {
+						let n = await a(e, y, {
+							id: t.jobId,
+							digest: t.digest
+						}, x);
+						s.push({
+							host: t.host,
+							setId: n.set.id,
+							count: n.set.manifest.count
+						});
+					}
+					let c = {
+						version: 2,
+						scope: y,
+						...i,
+						paths: s,
+						artifacts: r.artifacts,
+						regions: {
+							required: C,
+							quorum: w
+						}
+					};
+					return {
+						set: t({
+							...c,
+							cacheNamespace: n({
+								domain: "voltro.cms.output.namespace/v1",
+								manifest: c
+							})
+						}),
+						pathSets: o.map(({ host: e, jobId: t }) => ({
+							host: e,
+							jobId: t
+						}))
+					};
+				}), o = [];
+				for (let t of C) {
+					e.throwIfAborted();
+					let n = await T[t].stage(i.set);
+					e.throwIfAborted(), await T[t].verify(i.set, n.outputId), o.push({
+						region: t,
+						outputId: n.outputId
+					});
+				}
+				return D(r.credential, e, async (e) => {
+					let t = {
+						...i,
+						outputs: o
+					};
+					return await A(e, t), f(e, y, t, x);
+				});
+			});
+		}
+	};
+};
+//#endregion
+export { y as createCmsNativeOutputDeployments };