@griddo/cx 11.10.46 → 11.10.47-rc.0

package/build/services/domains.d.ts

@@ -4,6 +4,7 @@
 declare function getInstanceDomains(): Promise<{
     id: number;
     url: string;
+    dryRun: boolean;
     slug: string;
 }[]>;
 export { getInstanceDomains };

package/build/shared/context.d.ts

@@ -10,6 +10,8 @@ interface RenderContextProps<T> {
         buildReportFileName: string;
     };
     renderArtifacts: RenderArtifacts;
+    dryRun: boolean;
+    buildReportFileName: string;
 }
 /**
  * Encapsulates the state, configuration, and artifacts for a single SSG
@@ -22,6 +24,8 @@ interface RenderContextProps<T> {
 export declare class RenderContext<T = unknown> {
     readonly domain: string;
     readonly renderMode: RenderMode;
+    readonly dryRun: boolean;
+    readonly buildReportFileName: string;
     readonly pathsHydratedWithDomain: Record<PlaceholderPath, string>;
     pagesToCreate: number[];
     pagesToDelete: number[];
@@ -31,6 +35,6 @@ export declare class RenderContext<T = unknown> {
         buildReportFileName: string;
     };
     renderArtifacts: RenderArtifacts;
-    constructor({ domain, renderMode, ssg, pathsHydratedWithDomain, renderMetadata, renderArtifacts }: RenderContextProps<T>);
+    constructor({ domain, renderMode, ssg, pathsHydratedWithDomain, renderMetadata, renderArtifacts, dryRun, buildReportFileName }: RenderContextProps<T>);
 }
 export {};

package/build/shared/types/global.d.ts

@@ -48,6 +48,7 @@ type Domain = {
     id: number;
     slug: string;
     url: string;
+    dryRun: boolean;
 };
 type Domains = Domain[];
 /** Describes the type of build process data object. */

package/build/shared/types/render.d.ts

@@ -37,6 +37,7 @@ type RenderDB = {
             isRendering?: boolean;
             renderInfo?: RenderInfo;
             renderModeReason?: string;
+            dryRun?: boolean;
         };
     };
 };

package/build/ssg-adapters/gatsby/actions/dry-render-sync.d.ts

@@ -0,0 +1,3 @@
+import type { RenderContext } from "../../../shared/context";
+import type { SSG } from "../shared/types";
+export declare function dryRenderSyncAction(context: RenderContext<SSG>): Promise<void>;

package/build/ssg-adapters/gatsby/actions/index.d.ts

@@ -0,0 +1,41 @@
+import type { RenderContext } from "../../../shared/context";
+import { cleanAction } from "./clean";
+import { closeAction } from "./close";
+import { dataAction } from "./data";
+import { dryRenderSyncAction } from "./dry-render-sync";
+import { healthCheckAction } from "./healthCheck";
+import { initAction } from "./init";
+import { logsAction } from "./logs";
+import { metaAction } from "./meta";
+import { prepareAction } from "./prepare";
+import { relocationAction } from "./relocation";
+import { reportAction } from "./report";
+import { restoreAction } from "./restore";
+import { ssgAction } from "./ssg";
+import { syncAction } from "./sync";
+/**
+ * Defines the signature of a Gatsby action.
+ * An action is a function that receives a RenderContext and performs
+ * a specific step in the render lifecycle.
+ */
+export type Action<T = any> = (context: RenderContext<T>) => Promise<void>;
+/**
+ * All available Gatsby actions grouped in a single namespace.
+ * Each action performs a specific step in the render process.
+ */
+export declare const actions: {
+    clean: typeof cleanAction;
+    close: typeof closeAction;
+    data: typeof dataAction;
+    dryRenderSync: typeof dryRenderSyncAction;
+    healthCheck: typeof healthCheckAction;
+    init: typeof initAction;
+    logs: typeof logsAction;
+    meta: typeof metaAction;
+    prepare: typeof prepareAction;
+    relocation: typeof relocationAction;
+    report: typeof reportAction;
+    restore: typeof restoreAction;
+    ssg: typeof ssgAction;
+    sync: typeof syncAction;
+};

package/build/ssg-adapters/gatsby/actions/report.d.ts

@@ -0,0 +1,2 @@
+import type { RenderContext } from "@shared/context";
+export declare function reportAction(context: RenderContext): Promise<void>;

package/cli.mjs

@@ -26,10 +26,11 @@ export const AVAILABLE_COMMANDS = [
 		name: "render",
 		description: "Render the instance",
 		domainArgument: "optional",
-		rootArgument: true,
+		rootArgument: false,
 		script: "render-full-instance",
 		isCommandPack: true,
 		commandPack: renderCommandPack,
+		noStaticFiles: "optional",
 	},
 	{
 		name: "prepare-assets-directory",
@@ -38,14 +39,16 @@ export const AVAILABLE_COMMANDS = [
 		script: "prepare-assets-directory",
 		rootArgument: true,
 		isCommandPack: false,
+		noStaticFiles: false,
 	},
 	{
 		name: "prepare-domains-render",
 		description: "Prepare domains",
 		domainArgument: false,
 		script: "prepare-domains-render",
-		rootArgument: true,
+		rootArgument: false,
 		isCommandPack: false,
+		noStaticFiles: "optional",
 	},
 	{
 		name: "start-render",
@@ -54,6 +57,7 @@ export const AVAILABLE_COMMANDS = [
 		script: "start-render",
 		rootArgument: false,
 		isCommandPack: false,
+		noStaticFiles: false,
 	},
 	{
 		name: "end-render",
@@ -62,6 +66,7 @@ export const AVAILABLE_COMMANDS = [
 		script: "end-render",
 		isCommandPack: false,
 		rootArgument: true,
+		noStaticFiles: false,
 	},
 	{
 		name: "upload-search-content",
@@ -70,6 +75,7 @@ export const AVAILABLE_COMMANDS = [
 		script: "upload-search-content",
 		isCommandPack: false,
 		rootArgument: true,
+		noStaticFiles: false,
 	},
 	{
 		name: "reset-render",
@@ -78,6 +84,7 @@ export const AVAILABLE_COMMANDS = [
 		script: "reset-render",
 		isCommandPack: false,
 		rootArgument: false,
+		noStaticFiles: false,
 	},
 ];
 
@@ -149,7 +156,7 @@ function executeCommand(command, config) {
 			return;
 		}
 
-		const commandToRun = `node ${scriptPath}${config.domain ? ` ${config.domain}` : ""}`;
+		const commandToRun = `node ${scriptPath}${config.domain ? ` ${config.domain}` : ""}${config.noStaticFiles ? " --dry-render" : ""}`;
 
 		execSync(commandToRun, {
 			stdio: "inherit",
@@ -203,6 +210,7 @@ function main() {
 		help: { type: "boolean", short: "h" },
 		domain: { type: "string" },
 		root: { type: "string" },
+		"dry-render": { type: "boolean" },
 	};
 
 	const { values, positionals } = parseArgs({
@@ -221,6 +229,7 @@ function main() {
 	const initialConfig = {
 		domain: values.domain,
 		root: values.root,
+		noStaticFiles: values["dry-render"],
 	};
 
 	const { command, config } = validateCommand(commandName, initialConfig);

package/exporter/commands/prepare-domains-render.ts

@@ -102,6 +102,8 @@ async function initRender() {
 }
 
 async function prepareDomains() {
+	const [dryRender] = process.argv.slice(2);
+
 	await AuthService.login();
 
 	const db = await readDB();
@@ -138,6 +140,7 @@ async function prepareDomains() {
 		db.domains[domainSlug].renderMode = renderMode;
 		db.domains[domainSlug].shouldBeRendered = shouldBeRendered;
 		db.domains[domainSlug].renderModeReason = reason;
+		db.domains[domainSlug].dryRun = domain.dryRun || !!dryRender;
 	}
 
 	await writeDB(db);

package/exporter/commands/upload-search-content.ts

@@ -185,11 +185,18 @@ async function getContentDirectories(domain: string) {
 
 async function uploadSearchContent() {
 	if (GRIDDO_SEARCH_FEATURE) {
-		const domains = (await getInstanceDomains()).map(({ slug }) => slug);
+		const domains = (await getInstanceDomains()).map(({ slug, dryRun }) => ({ slug, dryRun }));
+
 		for (const domain of domains) {
-			const { htmlContentDir, jsonContentDir } = await getContentDirectories(domain);
+			const { dryRun, slug } = domain;
+			if (dryRun) {
+				GriddoLog.verbose(`Domain ${slug} ignored by dry-render`);
+				continue;
+			}
+
+			const { htmlContentDir, jsonContentDir } = await getContentDirectories(slug);
 
-			GriddoLog.info(`Uploading search content for ${domain}`);
+			GriddoLog.info(`Uploading search content for ${slug}`);
 			await uploadRenderedSearchContentToAPI({
 				htmlContentDir,
 				jsonContentDir,

package/exporter/services/render.ts

@@ -215,6 +215,15 @@ async function generateBuildReport(domain: string) {
 
 	const reportFilePath = path.join(__root, "current-dist", buildReportFileName);
 
+	// Asegurarse que exite la carpeta destino
+	// Normalmente existirá salvo en los renders dry-render que puede no existir.
+	const rootCurrentDist = path.join(__root, "current-dist");
+	try {
+		await fsp.mkdir(rootCurrentDist, { recursive: true });
+	} catch (_e) {
+		GriddoLog.verbose(`directory: ${rootCurrentDist} already exists, creation skipped.`);
+	}
+
 	await fsp.writeFile(reportFilePath, JSON.stringify(report));
 
 	GriddoLog.verbose(`build report saved in ${reportFilePath}`);

package/exporter/shared/context.ts

@@ -11,6 +11,8 @@ interface RenderContextProps<T> {
 		buildReportFileName: string;
 	};
 	renderArtifacts: RenderArtifacts;
+	dryRun: boolean;
+	buildReportFileName: string;
 }
 
 /**
@@ -24,6 +26,8 @@ interface RenderContextProps<T> {
 export class RenderContext<T = unknown> {
 	readonly domain: string;
 	readonly renderMode: RenderMode;
+	readonly dryRun: boolean;
+	readonly buildReportFileName: string;
 	readonly pathsHydratedWithDomain: Record<PlaceholderPath, string>;
 	pagesToCreate: number[] = [];
 	pagesToDelete: number[] = [];
@@ -38,6 +42,8 @@ export class RenderContext<T = unknown> {
 		pathsHydratedWithDomain,
 		renderMetadata,
 		renderArtifacts,
+		dryRun,
+		buildReportFileName,
 	}: RenderContextProps<T>) {
 		this.domain = domain;
 		this.renderMode = renderMode;
@@ -45,5 +51,7 @@ export class RenderContext<T = unknown> {
 		this.renderMetadata = renderMetadata;
 		this.renderArtifacts = renderArtifacts;
 		this.ssg = ssg;
+		this.dryRun = dryRun;
+		this.buildReportFileName = buildReportFileName;
 	}
 }

package/exporter/shared/types/global.ts

@@ -53,6 +53,7 @@ type Domain = {
 	id: number;
 	slug: string;
 	url: string;
+	dryRun: boolean;
 };
 
 type Domains = Domain[];

package/exporter/shared/types/render.ts

@@ -42,6 +42,7 @@ type RenderDB = {
 			isRendering?: boolean;
 			renderInfo?: RenderInfo;
 			renderModeReason?: string;
+			dryRun?: boolean;
 		};
 	};
 };

package/exporter/ssg-adapters/gatsby/actions/clean.ts

@@ -15,7 +15,7 @@ export async function cleanAction(context: RenderContext<SSG>) {
 		renderMode,
 	} = context;
 
-	if (renderMode === RENDER_MODE.FROM_SCRATCH) {
+	if (renderMode === RENDER_MODE.FROM_SCRATCH && !context.dryRun) {
 		await fsp.rm(path.join(__cache, ".cache"), { recursive: true, force: true });
 		await fsp.rm(path.join(__exports, "dist"), { recursive: true, force: true });
 		await fsp.rm(path.join(__exports, "assets"), { recursive: true, force: true });

package/exporter/ssg-adapters/gatsby/actions/dry-render-sync.ts

@@ -0,0 +1,21 @@
+import type { RenderContext } from "../../../shared/context";
+import type { SSG } from "../shared/types";
+
+import fsp from "node:fs/promises";
+import path from "node:path";
+
+export async function dryRenderSyncAction(context: RenderContext<SSG>) {
+	const {
+		buildReportFileName,
+		pathsHydratedWithDomain: { __root, __exports },
+	} = context;
+
+	try {
+		await fsp.mkdir(path.join(__exports, "dist"));
+	} catch (_e) {}
+
+	await fsp.cp(
+		path.join(__root, "current-dist", buildReportFileName),
+		path.join(__exports, "dist", buildReportFileName),
+	);
+}

package/exporter/ssg-adapters/gatsby/actions/index.ts

@@ -0,0 +1,44 @@
+import type { RenderContext } from "../../../shared/context";
+
+import { cleanAction } from "./clean";
+import { closeAction } from "./close";
+import { dataAction } from "./data";
+import { dryRenderSyncAction } from "./dry-render-sync";
+import { healthCheckAction } from "./healthCheck";
+import { initAction } from "./init";
+import { logsAction } from "./logs";
+import { metaAction } from "./meta";
+import { prepareAction } from "./prepare";
+import { relocationAction } from "./relocation";
+import { reportAction } from "./report";
+import { restoreAction } from "./restore";
+import { ssgAction } from "./ssg";
+import { syncAction } from "./sync";
+
+/**
+ * Defines the signature of a Gatsby action.
+ * An action is a function that receives a RenderContext and performs
+ * a specific step in the render lifecycle.
+ */
+export type Action<T = any> = (context: RenderContext<T>) => Promise<void>;
+
+/**
+ * All available Gatsby actions grouped in a single namespace.
+ * Each action performs a specific step in the render process.
+ */
+export const actions = {
+	clean: cleanAction,
+	close: closeAction,
+	data: dataAction,
+	dryRenderSync: dryRenderSyncAction,
+	healthCheck: healthCheckAction,
+	init: initAction,
+	logs: logsAction,
+	meta: metaAction,
+	prepare: prepareAction,
+	relocation: relocationAction,
+	report: reportAction,
+	restore: restoreAction,
+	ssg: ssgAction,
+	sync: syncAction,
+} satisfies Record<string, Action>;

package/exporter/ssg-adapters/gatsby/actions/meta.ts

@@ -1,14 +1,12 @@
 import type { RenderContext } from "@shared/context";
 
 import { generateLLMs } from "@services/llms";
-import { generateBuildReport } from "@services/render";
 import { generateRobots } from "@services/robots";
 import { generateSitemaps } from "@services/sitemaps";
 
 export async function metaAction(context: RenderContext) {
 	const { domain } = context;
 
-	await generateBuildReport(domain);
 	await generateSitemaps(domain);
 	await generateRobots(domain);
 	await generateLLMs(domain);

package/exporter/ssg-adapters/gatsby/actions/report.ts

@@ -0,0 +1,9 @@
+import type { RenderContext } from "@shared/context";
+
+import { generateBuildReport } from "@services/render";
+
+export async function reportAction(context: RenderContext) {
+	const { domain } = context;
+
+	await generateBuildReport(domain);
+}

package/exporter/ssg-adapters/gatsby/index.ts

@@ -16,18 +16,7 @@ import { getRenderArtifacts } from "../../services/render-artifacts";
 import { RenderContext } from "../../shared/context";
 import { GRIDDO_ASSET_PREFIX, GRIDDO_BUILD_LOGS } from "../../shared/envs";
 import { RENDER_MODE } from "../../shared/types/render";
-import { cleanAction } from "./actions/clean";
-import { closeAction } from "./actions/close";
-import { dataAction } from "./actions/data";
-import { healthCheckAction } from "./actions/healthCheck";
-import { initAction } from "./actions/init";
-import { logsAction } from "./actions/logs";
-import { metaAction } from "./actions/meta";
-import { prepareAction } from "./actions/prepare";
-import { relocationAction } from "./actions/relocation";
-import { restoreAction } from "./actions/restore";
-import { ssgAction } from "./actions/ssg";
-import { syncAction } from "./actions/sync";
+import { actions } from "./actions";
 import { getGatsbyArtifacts } from "./shared/artifacts";
 import { disableRollbackOnError, enableRollbackOnError } from "./shared/render-rollback";
 
@@ -89,29 +78,51 @@ export async function gatsbyRenderDomain(domain: string) {
 		renderMetadata,
 		renderMode: derivedRenderMode,
 		ssg: { assetPrefix, ssgArtifacts },
+		dryRun: !!data.domains[domain].dryRun,
+		buildReportFileName: data.buildReportFileName,
 	});
 
-	// A las actions se les pasa siempre `context` y cada action ya utiliza lo que necesita.
-	// Si una action necesita devolver algo para otra, se guarda en el context.
-	// Ejemplo: el dataAction obtiene los ids de páginas para renderizar y
-	// borrar y los guarda en context.pathsToRender y context.pathsToDelete.
-	await doLifeCycle("Init", async () => initAction(context));
-	await doLifeCycle("Clean", async () => cleanAction(context));
-	await doLifeCycle("Prepare", async () => prepareAction(context));
-	await doLifeCycle("Restore", async () => restoreAction(context));
+	// Lifecycles disabled rules
+	const skipByDryRender = context.dryRun ? "dry-render is enabled" : false;
+	const skipByWetRender = context.dryRun ? false : "dry-render is disabled";
+	const isDisabledLogs = !GRIDDO_BUILD_LOGS ? "Build logs to file are disabled" : false;
+
+	// FROM_SCRATCH force to disable dry-renders and enable wetRenders
+	const isDryRender = derivedRenderMode === "FROM_SCRATCH" ? false : skipByDryRender;
+	const isWetRender =
+		derivedRenderMode === "FROM_SCRATCH" && context.dryRun
+			? "wet-render is forced enabled by FROM_SCRATCH render mode"
+			: skipByWetRender;
+
+	// Actions are always passed the `context`, and each action uses what it
+	// needs. If an action needs to return something for another one, it is
+	// stored in the context.
+	// Example: dataAction gets the page IDs to render and delete and stores
+	// them in `context.pathsToRender` and `context.pathsToDelete`.
+
+	await doLifeCycle("Init", async () => actions.init(context));
+	await doLifeCycle("Clean", async () => actions.clean(context));
+	await doLifeCycle("Prepare", async () => actions.prepare(context));
+	await doLifeCycle("Restore", async () => actions.restore(context));
 
 	await enableRollbackOnError();
 
-	await doLifeCycle("Data", async () => dataAction(context));
-	await doLifeCycle("SSG", async () => ssgAction(context));
-	await doLifeCycle("Relocation", async () => relocationAction(context));
-	await doLifeCycle("Meta", async () => metaAction(context));
-	await doLifeCycle("Sync", async () => syncAction(context));
-	await doLifeCycle("HealthCheck", async () => healthCheckAction(context));
-	await doLifeCycle("Logs", async () => logsAction(context), {
-		skip: !GRIDDO_BUILD_LOGS ? "Build logs to file are disabled" : false,
+	await doLifeCycle("Data", async () => actions.data(context));
+	await doLifeCycle("SSG", async () => actions.ssg(context), { skip: isDryRender });
+	await doLifeCycle("Relocation", async () => actions.relocation(context), {
+		skip: isDryRender,
 	});
-	await doLifeCycle("Close", async () => closeAction(context));
+	await doLifeCycle("Meta", async () => actions.meta(context), { skip: isDryRender });
+	await doLifeCycle("Report", async () => actions.report(context));
+	await doLifeCycle("DryRunSync", async () => actions.dryRenderSync(context), {
+		skip: isWetRender,
+	});
+	await doLifeCycle("Sync", async () => actions.sync(context), { skip: isDryRender });
+	await doLifeCycle("HealthCheck", async () => actions.healthCheck(context));
+	await doLifeCycle("Logs", async () => actions.logs(context), {
+		skip: isDryRender || isDisabledLogs,
+	});
+	await doLifeCycle("Close", async () => actions.close(context));
 
 	await disableRollbackOnError();
 }

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@griddo/cx",
 	"description": "Griddo SSG based on Gatsby",
-	"version": "11.10.46",
+	"version": "11.10.47-rc.0",
 	"authors": [
 		"Hisco <francis.vega@griddo.io>"
 	],
@@ -61,7 +61,7 @@
 	},
 	"devDependencies": {
 		"@biomejs/biome": "2.3.4",
-		"@griddo/core": "11.10.46",
+		"@griddo/core": "11.10.47-rc.0",
 		"@types/node": "20.19.4",
 		"@typescript/native-preview": "7.0.0-dev.20260108.1",
 		"cheerio": "1.1.2",
@@ -94,5 +94,5 @@
 	"publishConfig": {
 		"access": "public"
 	},
-	"gitHead": "fd83d3991eb31335881dc050377bdb915b6c5bb2"
+	"gitHead": "486216826a26ab0ebe02a4a676748e7208de906c"
 }