@griddo/cx 11.7.5 → 11.7.6-rc.0

package/exporter/utils/loggin.ts

@@ -1,52 +1,38 @@
 import type { Site } from "../types/sites";
 
-import kleur from "kleur";
+import fsp from "node:fs/promises";
+import path from "node:path";
 
-import { envs } from "../constants";
-import { getConfig } from "./core-utils";
+import { GRIDDO_BUILD_LOGS, GRIDDO_VERBOSE_LOGS } from "../constants/envs";
+import { brush } from "./brush";
 
 /**
  * Custom basic logging function controlled by a environment variable.
- *
  * @param str The string to be logged.
  */
 function verboseLog(str: string) {
-	if (envs.GRIDDO_VERBOSE_LOGS) {
-		console.log(
-			kleur.yellow("verbose"),
-			kleur.dim(str.replace(/(\s)\s+/g, "$1").trim()),
-		);
+	if (GRIDDO_VERBOSE_LOGS) {
+		console.log(brush.yellow("verbose"), brush.dim(str.replace(/(\s)\s+/g, "$1").trim()));
 	}
 }
 
 /**
  * Custom log inside a line-box.
- *
  * @param stringValue The string to be logged.
  * @param paddingInline The number of white spaces inside the box at left and right.
  * @param paddingBlock The number of white spaces inside the box at top and bottom.
  */
-function boxLog(
-	stringValue: string,
-	title = "",
-	paddingInline = 1,
-	paddingBlock = 1,
-) {
+function boxLog(stringValue: string, title = "", paddingInline = 1, paddingBlock = 1) {
 	const lines = stringValue
 		.split("\n") // lines
 		.map((line) => line.trim()); // remove extra spaces
 	const windowTitle = title ? ` ${title} ` : "";
 	const windowTitleLength = title ? windowTitle.length : 0;
-	const longerContent =
-		Math.max(...lines.map((l) => l.length)) + paddingInline * 2;
+	const longerContent = Math.max(...lines.map((l) => l.length)) + paddingInline * 2;
 	const longerLine = Math.max(longerContent, windowTitleLength);
-	const paddingBlockString = `│${" ".repeat(longerLine)}│\n`.repeat(
-		paddingBlock,
-	);
+	const paddingBlockString = `│${" ".repeat(longerLine)}│\n`.repeat(paddingBlock);
 	const minWidth = longerLine;
-	const borderTop = `╭${windowTitle}${"─".repeat(
-		minWidth - windowTitleLength,
-	)}╮\n`;
+	const borderTop = `╭${windowTitle}${"─".repeat(minWidth - windowTitleLength)}╮\n`;
 	const borderBottom = `╰${"─".repeat(minWidth)}╯`;
 	const content = lines
 		.map((l) => {
@@ -55,9 +41,7 @@ function boxLog(
 		})
 		.join("");
 
-	console.log(
-		`${borderTop}${paddingBlockString}${content}${paddingBlockString}${borderBottom}`,
-	);
+	console.log(`${borderTop}${paddingBlockString}${content}${paddingBlockString}${borderBottom}`);
 }
 
 /**
@@ -67,7 +51,7 @@ function boxLog(
  * @param str The string to be logged.
  */
 function buildLog(str: string) {
-	if (envs.GRIDDO_BUILD_LOGS) {
+	if (GRIDDO_BUILD_LOGS) {
 		console.log(str.replace(/(\s)\s+/g, "$1").trim());
 	}
 }
@@ -77,7 +61,7 @@ function buildLog(str: string) {
  * @param str The string to be logged.
  */
 function infoLog(str: string) {
-	console.log(`${kleur.blue("info")} ${str}`);
+	console.log(`${brush.blue("info")} ${str}`);
 }
 
 /**
@@ -85,99 +69,50 @@ function infoLog(str: string) {
  * @param str The string to be logged.
  */
 function successLog(str: string) {
-	console.log(`${kleur.green("success")} ${str}`);
-}
-
-/**
- * Internal log
- * @param values The values to be logged.
- */
-function debugLog(...values: Array<unknown>) {
-	if (!envs.GRIDDO_DEBUG_LOGS) {
-		return;
-	}
-	console.log(...values);
-}
-
-/**
- * Return a scale size colors with a number and a measure string (KB by default).
- *
- * @param size The page size in KB.
- * @param measure The measure string to be added in the log.
- */
-function pageSizeLog(size: number, measure = "KB") {
-	const sizeScale = {
-		low: 50,
-		mid: 80,
-		large: 130,
-		extraLarge: 210,
-	};
-
-	// Ternary pawa!
-	const color =
-		size > sizeScale.large
-			? "red"
-			: size > sizeScale.mid
-				? "magenta"
-				: size > sizeScale.low
-					? "blue"
-					: "green";
-
-	return kleur[color](kleur.bold(`${size}${measure}`));
+	console.log(`${brush.green("success")} ${str}`);
 }
 
 /**
  * Console log the Griddo exporter version.
  */
-function showExporterVersion() {
+async function showExporterVersion() {
 	console.clear();
-	const config = getConfig();
-	const { griddoVersion } = config;
-	const logo = `\n${kleur
-		.bgYellow()
-		.black()
-		.bold(" Griddo Exporter " + griddoVersion + " ")}\n`;
+	const { version } = JSON.parse(
+		await fsp.readFile(path.resolve(__dirname, "../..", "package.json"), "utf-8"),
+	) as { version: string };
+	const logo = `\n${brush.yellow(`Griddo Exporter ${version}`)}\n`;
 
 	console.log(logo);
 }
 
 function listSitesLog(title: string, sites: Array<Site>) {
 	const maxline = Math.max(
-		...sites.map(
-			(s) =>
-				s.name.length + (s.shouldBeUpdated ? 1 : 0) + s.id.toString().length,
-		),
+		...sites.map((s) => s.name.length + (s.shouldBeUpdated ? 1 : 0) + s.id.toString().length),
 	);
 
 	const sitesStr = sites.map((s) => {
 		const shouldBeUpdated = s.shouldBeUpdated ? "*" : "";
-		const lineLen =
-			s.name.length + shouldBeUpdated.length + s.id.toString().length;
+		const lineLen = s.name.length + shouldBeUpdated.length + s.id.toString().length;
 		const padding = " ".repeat(maxline - lineLen);
-		return `${kleur.bold(s.name)} ${kleur.dim("(" + s.id + ")")} ${shouldBeUpdated} ${padding}${kleur.dim("-")} ${kleur.dim(s.slug)}`;
+		return `${brush.bold(s.name)} ${brush.dim(`(${s.id})`)} ${shouldBeUpdated} ${padding}${brush.dim("-")} ${brush.dim(s.slug)}`;
 	});
 
-	const sitesOutput =
-		sitesStr.length > 0
-			? "\n\n" + sitesStr.join("\n")
-			: kleur.dim("--none--\n");
+	const sitesOutput = sitesStr.length > 0 ? `\n\n${sitesStr.join("\n")}` : brush.dim("--none--\n");
 
 	console.log(`
 ${title} ${sitesOutput}`);
 }
 
 function errorLabelLog(msg: string) {
-	console.error("\n" + kleur.black().bgRed(" " + msg + " ") + "\n");
+	console.error(`\n${brush.black(` ${msg} `)}\n`);
 }
 
 export {
 	boxLog,
 	buildLog,
-	debugLog,
 	errorLabelLog,
 	infoLog,
 	listSitesLog,
-	pageSizeLog,
 	showExporterVersion,
 	successLog,
 	verboseLog,

package/exporter/utils/pages.ts

@@ -1,3 +1,4 @@
+import type { Core, Fields } from "@griddo/core";
 import type {
 	APIPageObject,
 	GriddoListPage,
@@ -9,14 +10,9 @@ import type {
 	PageAdditionalInfo,
 } from "../types/pages";
 import type { TemplateWithReferenceField } from "../types/templates";
-import type { Core, Fields } from "@griddo/core";
-
-import dotenv from "dotenv";
 
 import { formatImage } from "./images";
 
-dotenv.config();
-
 // Consts
 const DEFAULT_ITEMS_PER_PAGE_FOR_LIST_TEMPLATES = 25;
 
@@ -31,10 +27,7 @@ function getOpenGraph({
 	socialTitle,
 	socialDescription,
 	socialImage,
-}: Pick<
-	Core.Page,
-	"socialTitle" | "socialDescription" | "socialImage"
->): Core.Page["openGraph"] {
+}: Pick<Core.Page, "socialTitle" | "socialDescription" | "socialImage">): Core.Page["openGraph"] {
 	return {
 		type: "website",
 		title: socialTitle,
@@ -49,9 +42,7 @@ function getOpenGraph({
  *
  * @param params A Page object
  */
-function getPageMetadata(
-	params: Core.Page,
-): GriddoPageObject["context"]["pageMetadata"] {
+function getPageMetadata(params: Core.Page): GriddoPageObject["context"]["pageMetadata"] {
 	const {
 		title,
 		metaTitle,
@@ -87,9 +78,7 @@ function getPageMetadata(
 		index: isIndexed ? "index" : "noindex",
 		follow: follow ? "follow" : "nofollow",
 		translate: metasAdvancedList.includes("notranslate") ? "notranslate" : "",
-		metasAdvanced: metasAdvancedList
-			.filter((item) => item !== "notranslate")
-			.join(),
+		metasAdvanced: metasAdvancedList.filter((item) => item !== "notranslate").join(),
 		pageLanguages,
 		metaKeywords: metaKeywords
 			?.filter(Boolean)
@@ -133,8 +122,9 @@ async function createGriddoPageObject(
 		siteSlug,
 		socials,
 		theme,
-		navigations: { header, footer },
+		navigations,
 	} = additionalInfo;
+	const { header, footer } = navigations;
 
 	// Update page object
 	page.breadcrumb = breadcrumb;
@@ -207,10 +197,7 @@ async function createGriddoPageObject(
  * @param page A Griddo single page object.
  * @param additionalInfo Additional page info.
  */
-async function createGriddoSinglePage(
-	page: GriddoSinglePage,
-	additionalInfo: PageAdditionalInfo,
-) {
+async function createGriddoSinglePage(page: GriddoSinglePage, additionalInfo: PageAdditionalInfo) {
 	return createGriddoPageObject(page, additionalInfo);
 }
 
@@ -218,14 +205,7 @@ async function createGriddoSinglePage(
  * Create multiples pages from one page as list paginated pages
  */
 async function createGriddoListPages(
-	{
-		page,
-		pages,
-		isRoot = false,
-		defaultLang,
-		template,
-		totalQueriedItems,
-	}: GriddoListPage,
+	{ page, pages, isRoot = false, defaultLang, template, totalQueriedItems }: GriddoListPage,
 	additionalInfo: PageAdditionalInfo,
 ) {
 	const allPages = pages.map(async (dataInPage, idx) => {
@@ -233,19 +213,8 @@ async function createGriddoListPages(
 		const pageNumber = idx + 1;
 		const { domainUrl, compose } = page.fullPath;
 
-		// Crea un id como número negativo y añadiendo un sufijo para los
-		// listados estáticos. Esto es así para marcarlas y posteriormente
-		// borrarlas siempre en cada nuevo render desde el Adapter.
-		//
-		// id de página con mode:"list": 1546
-		// ids de las "sub-páginas": -15460, -15461, -1546n, (-)id(idx)
-		//
-		// @todo eliminar el concepto multipage de CX, debería ser algo core de
-		// Griddo itself: API/AX, que fuesen páginas con sus ids, etc..
-
 		const paginatedPage = {
 			...page,
-			id: Number.parseInt(`-${page.id}${idx}`),
 			fullPath: {
 				...page.fullPath,
 				// Add a page number (tailPageNumber) from page 2 onwards
@@ -287,16 +256,11 @@ async function createGriddoListPages(
  * @param page A Griddo Multipage object.
  * @param additionalInfo Additional page info.
  */
-function createGriddoMultiPages(
-	page: GriddoMultiPage,
-	additionalInfo: PageAdditionalInfo,
-) {
+function createGriddoMultiPages(page: GriddoMultiPage, additionalInfo: PageAdditionalInfo) {
 	const { multiPageElements: multiPageElementsBulk, ...cleanPage } = page;
 	// TODO: Use structuredClone() when node 18 is available.
 	// WARN!! Se ha probado que parse(stringify()) está tan optimizado que puede ser más rápido que structuredClone...
-	const multiPageElements: MultiPageElements = JSON.parse(
-		JSON.stringify(multiPageElementsBulk),
-	);
+	const multiPageElements: MultiPageElements = JSON.parse(JSON.stringify(multiPageElementsBulk));
 
 	// Si no hay un elemento sin slug, como mínimo hay que dibujar una página
 	// principal para el conjunto de páginas.
@@ -305,7 +269,7 @@ function createGriddoMultiPages(
 	}
 
 	// Creates each page based on `multiPageElements` from the schema.
-	const allPages = multiPageElements.map(async (pageElement, idx) => {
+	const allPages = multiPageElements.map(async (pageElement) => {
 		// TODO: Use structuredClone() when node 18 is available.
 		// WARN!! Se ha probado que parse(stringify()) está tan optimizado que puede ser más rápido que structuredClone...
 		const paginatedPage: APIPageObject = JSON.parse(JSON.stringify(cleanPage));
@@ -323,9 +287,7 @@ function createGriddoMultiPages(
 
 		const cleanSectionSlug = sectionSlug?.replace(/\//g, "");
 		const isRootSlug = sectionSlug === "/";
-		const rightSectionSlug = isRootSlug
-			? cleanSectionSlug
-			: `${cleanSectionSlug}/`;
+		const rightSectionSlug = isRootSlug ? cleanSectionSlug : `${cleanSectionSlug}/`;
 
 		const slash = compose.endsWith("/") ? "" : "/";
 		const newCompose = `${compose}${slash}${rightSectionSlug}`;
@@ -338,24 +300,12 @@ function createGriddoMultiPages(
 			paginatedPage.metaDescription = metaDescription;
 		}
 
-		// Crea un id como número negativo y añadiendo un sufijo para las multipages.
-		// Esto es así para marcarlas y posteriormente borrarlas siempre en cada
-		// nuevo render desde el Adapter.
-		//
-		// id de página con hasMultipageTrue: 1546
-		// ids de las "sub-páginas": -15460, -15461, -1546n, (-)id(idx)
-		//
-		// @todo eliminar el concepto multipage de CX, debería ser algo core de
-		// Griddo itself: API/AX, que fuesen páginas con sus ids, etc..
-		paginatedPage.id = Number.parseInt(`-${paginatedPage.id}${idx}`);
-
 		paginatedPage.fullUrl = `${fullUrl}/${rightSectionSlug}`;
 		paginatedPage.fullPath.compose = newCompose;
 		paginatedPage.slug = newCompose;
 		paginatedPage.template.activeSectionSlug = sectionSlug;
 		paginatedPage.template.activeSectionBase = fullUrl;
-		paginatedPage.metaTitle =
-			metaTitle.trim() || title.trim() || paginatedPage.metaTitle;
+		paginatedPage.metaTitle = metaTitle.trim() || title.trim() || paginatedPage.metaTitle;
 
 		return createGriddoPageObject(paginatedPage, additionalInfo);
 	});
@@ -368,9 +318,7 @@ function createGriddoMultiPages(
  *
  * @param page The page to get the multipage parts.
  */
-function getMultiPageElements(
-	page: TemplateWithReferenceField,
-): Promise<MultiPageElements> | null {
+function getMultiPageElements(page: TemplateWithReferenceField): Promise<MultiPageElements> | null {
 	const multiPageElements = new Promise((resolve) => {
 		// Recursive
 		const getMultiPageComponent = (
@@ -391,11 +339,10 @@ function getMultiPageElements(
 					hasGriddoMultiPage: boolean;
 					elements: Array<Record<string, unknown>>;
 				};
-				const isValidComponent =
-					currentComponent || typeof currentComponent === "object";
-				const hasGriddoMultiPageProp = JSON.stringify(
-					currentComponent,
-				).includes('"hasGriddoMultiPage":true');
+				const isValidComponent = currentComponent || typeof currentComponent === "object";
+				const hasGriddoMultiPageProp = JSON.stringify(currentComponent).includes(
+					'"hasGriddoMultiPage":true',
+				);
 
 				if (!isValidComponent) {
 					continue;
@@ -445,11 +392,7 @@ function getMultiPageElements(
  * getPage(3, ["a", "b", "c", "d", "e", "f", "g", "h"], 2)
  * // -> ["d", "e", "f"]
  */
-function getPage(
-	itemsPerPage: number,
-	items: Array<Fields.QueriedDataItem>,
-	page: number,
-) {
+function getPage(itemsPerPage: number, items: Array<Fields.QueriedDataItem>, page: number) {
 	return items?.slice(itemsPerPage * (page - 1), itemsPerPage * page);
 }
 
@@ -463,16 +406,11 @@ function getPage(
  * getPageCluster(3, ["a", "b", "c", "d", "e", "f", "g", "h"])
  * // -> [["a", "b", "c"], ["d", "e", "f"], ["g", "h"]]
  */
-function getPageCluster(
-	itemsPerPage: number,
-	items: Array<Fields.QueriedDataItem>,
-) {
+function getPageCluster(itemsPerPage: number, items: Array<Fields.QueriedDataItem>) {
 	const totalPagesCount = Math.ceil(items.length / itemsPerPage) || 1;
 	const pageNumbers = Array.from({ length: totalPagesCount }, (_, i) => i + 1);
 
-	return pageNumbers?.map((pageNumber) =>
-		getPage(itemsPerPage, items, pageNumber),
-	);
+	return pageNumbers?.map((pageNumber) => getPage(itemsPerPage, items, pageNumber));
 }
 
 /**
@@ -482,8 +420,7 @@ function getPageCluster(
  */
 function getPaginatedPages(listTemplate: TemplateWithReferenceField) {
 	const items = listTemplate.queriedItems || [];
-	const itemsPerPage =
-		listTemplate?.itemsPerPage || DEFAULT_ITEMS_PER_PAGE_FOR_LIST_TEMPLATES;
+	const itemsPerPage = listTemplate?.itemsPerPage || DEFAULT_ITEMS_PER_PAGE_FOR_LIST_TEMPLATES;
 	const pageClusters = getPageCluster(itemsPerPage, items);
 
 	return pageClusters;
@@ -524,9 +461,7 @@ function addPageNumberToUrl(
 		return removeDuplicateTrailing(`${url}${endingSlash}`);
 	}
 
-	return removeDuplicateTrailing(
-		`${url}${trailingSlash}${pageNumber}${endingSlash}`,
-	);
+	return removeDuplicateTrailing(`${url}${trailingSlash}${pageNumber}${endingSlash}`);
 }
 
 /**

package/exporter/utils/render.ts

@@ -1,71 +1,170 @@
-import fs from "node:fs";
-import path from "node:path";
+import type { RenderModeTuple } from "../types/render";
 
-import { envs } from "../constants";
-import { throwError } from "../errors";
-import { RenderUUIDError } from "../errors/errors-data";
-import { apiRegister } from "../registers";
-import { insertAlert } from "./alerts";
-import { getConfig } from "./core-utils";
-import { debugLog } from "./loggin";
+import { execSync } from "node:child_process";
+import fsp from "node:fs/promises";
+import path from "node:path";
 
-const config = getConfig();
+import { RenderUUIDError } from "../constants/errors";
+import { readDB, writeDB } from "../services/db";
+import { RENDER_MODE } from "../types/render";
+import { throwError } from "./errors";
+import { pathExists } from "./folders";
 
 /**
  * Creates a sentinel file with the current date and time.
  * This file is used to track later if node_modules/@griddo/cx was cleaned by a
- * npm install from a deploy.
+ * npm install coming from a deploy.
  */
-function createSentinelRenderFile() {
-	const { __cx } = config.paths();
-	const renderSentinelFile = path.join(__cx, ".render-sentinel");
-	fs.writeFileSync(renderSentinelFile, new Date().toISOString());
+async function markRenderAsStarted(options: { domain: string; basePath: string }) {
+	const { domain } = options;
+
+	const db = await readDB();
+	db.domains[domain].isRendering = true;
+	await writeDB(db);
+
+	// Creamos un archivo centinela, si al terminar el render este archivo no
+	// existe es que ha habido un deploy por medio y hay que invalidar el render
+	const { __ssg } = await getRenderPathsFromDB();
+
+	const renderSentinelFile = path.join(__ssg, ".render-sentinel");
+	await fsp.writeFile(renderSentinelFile, new Date().toISOString());
 }
 
-function deleteSentinelRenderFile() {
-	const { __cx } = config.paths();
-	const renderSentinelFile = path.join(__cx, ".render-sentinel");
-	fs.unlinkSync(renderSentinelFile);
+async function markRenderAsCompleted(domain: string) {
+	const db = await readDB();
+	db.domains[domain].isRendering = false;
+	// db.domains[domain].renderMode = undefined;
+	// db.domains[domain].shouldBeRendered = false;
+	await writeDB(db);
+
+	// Borramos finalmente el archivo centinela
+	const { __ssg } = await getRenderPathsFromDB();
+	const renderSentinelFile = path.join(__ssg, ".render-sentinel");
+	await fsp.unlink(renderSentinelFile);
 }
 
-function isValidRender() {
-	const { __cx } = config.paths();
-	const renderSentinelFile = path.join(__cx, ".render-sentinel");
-	if (!fs.existsSync(renderSentinelFile)) {
+async function assertRenderIsValid() {
+	// Comprobamos que .render-sentinel exista, si no es que un deploy lo borro
+	// y hay que invalidar el render.
+	const { __ssg } = await getRenderPathsFromDB();
+	const renderSentinelFile = path.join(__ssg, ".render-sentinel");
+	if (!(await pathExists(renderSentinelFile))) {
 		throwError(RenderUUIDError);
 	}
 }
 
-/**
- * Send the default registers through Griddo alerts.
- */
-async function sendGriddoDefaultAlerts() {
-	if (envs.GRIDDO_ALERT_FEATURE) {
-		const registerContent = apiRegister.get("API_RESPONSE_TOO_BIG");
+// @todo add more messages...
+async function resolveDomainRenderMode(options: { domain: string; shouldBeRendered: boolean }) {
+	const { domain, shouldBeRendered } = options;
+	const { __cache, __exports } = await getRenderPathsFromDB({ domain });
+
+	// missing exports
+	const missingExports = !(await pathExists(path.join(__exports)));
+	// render with errors
+	const db = await readDB();
+	const wasRenderWithError = db.domains[domain]?.isRendering;
+	// new deploy or machine
+	const isNewDeploy = await hasNewCommit(__cache);
+
+	if (missingExports) {
+		console.log("[!] From Scratch due to missing exports (first render)");
+		return {
+			renderMode: RENDER_MODE.FROM_SCRATCH,
+			reason: "Missing exports directory",
+		};
+	}
+
+	if (wasRenderWithError) {
+		console.log("[!] From Scratch due to a previous render error");
+		return {
+			renderMode: RENDER_MODE.FROM_SCRATCH,
+			reason: "error in previous render",
+		};
+	}
+
+	if (isNewDeploy) {
+		console.log("[!] From Scratch due to a changes in the repo (commit hash)");
+		return { renderMode: RENDER_MODE.FROM_SCRATCH, reason: "new commit hash" };
+	}
+
+	if (!shouldBeRendered) {
+		console.log(`Skipping render for domain ${domain} as it is not marked for rendering (IDLE).`);
+		return { renderMode: RENDER_MODE.IDLE, reason: "" };
+	}
 
-		if (registerContent.entries.length < 1) {
-			return;
+	return { renderMode: RENDER_MODE.INCREMENTAL, reason: "" };
+}
+
+async function hasNewCommit(basePath: string): Promise<boolean> {
+	const commitFile = path.join(basePath, "commit");
+	const currentCommit = execSync("git rev-parse HEAD").toString().trim();
+
+	if (await pathExists(commitFile)) {
+		const savedCommit = (await fsp.readFile(commitFile, "utf-8")).trim();
+		if (savedCommit === currentCommit) {
+			return false; // No hay nuevo commit
 		}
 
-		debugLog("\nRender register report\n");
-		debugLog(registerContent);
-		debugLog();
-
-		await insertAlert({
-			description: `API response size is too large (${envs.GRIDDO_API_MAX_RESPONSE_SIZE}KB).`,
-			area: "Griddo",
-			level: "W",
-			fullData: {
-				output: registerContent,
-				date: new Date().toISOString(),
-			},
-		});
+		return true;
 	}
+
+	return true;
+}
+
+async function updateCommitFile(options: { basePath: string }) {
+	const { basePath } = options;
+	const currentCommit = execSync("git rev-parse HEAD").toString().trim();
+	await fsp.writeFile(path.join(basePath, "commit"), currentCommit);
+}
+
+async function getRenderMode(domain: string): Promise<RenderModeTuple> {
+	const db = await readDB();
+
+	if (!db.domains[domain].renderMode) {
+		throw new Error(`Render mode not found for domain ${domain}`);
+	}
+
+	return {
+		renderMode: db.domains[domain].renderMode,
+		reason: db.domains[domain].renderModeReason,
+	};
+}
+
+async function getRenderPathsFromDB(options?: { domain?: string; dbFilePath?: string }) {
+	const { domain, dbFilePath } = options || {};
+
+	const db = await readDB(dbFilePath);
+	const paths = db.paths;
+
+	return {
+		__root: paths.root,
+		__cache: path.join(paths.cxCache, domain || ""),
+		__components: paths.components,
+		__cx: paths.cx,
+		__sites: paths.exportsDir,
+		__exports: path.join(paths.exportsDir, domain || ""),
+		__ssg: paths.ssg,
+		__exports_dist: path.join(paths.exportsDir, domain || "", "dist"),
+		__cx_dist: path.join(paths.cx, "dist"),
+	};
+}
+
+async function getRenderMetadataFromDB() {
+	const db = await readDB();
+	return {
+		proDomain: db.proDomain,
+		griddoVersion: db.griddoVersion,
+		buildReportFileName: db.buildReportFileName,
+	};
 }
 
 export {
-	createSentinelRenderFile,
-	deleteSentinelRenderFile,
-	isValidRender,
-	sendGriddoDefaultAlerts,
+	assertRenderIsValid,
+	getRenderMetadataFromDB,
+	getRenderMode,
+	getRenderPathsFromDB,
+	markRenderAsCompleted,
+	markRenderAsStarted,
+	resolveDomainRenderMode,
+	updateCommitFile,
 };