@griddo/cx 11.7.5 → 11.7.6-rc.0

package/build/exporter/adapters/gatsby/shared/types.d.ts

@@ -0,0 +1,34 @@
+interface SSG {
+    assetPrefix: string;
+    ssgArtifacts: {
+        disposables: string[];
+        cacheables: string[];
+    };
+}
+interface GatsbyPageData {
+    path: string;
+    result: {
+        pageContext: {
+            id: number;
+            title: string;
+            path: string;
+            openGraph: any;
+            pageMetadata: any;
+            page: {
+                site: number;
+                id: number;
+                fullPath: {
+                    compose: string;
+                };
+                language: number;
+                title: string;
+                fullUrl: string;
+                templateId: string;
+                template: {
+                    templateType: string;
+                };
+            };
+        };
+    };
+}
+export type { GatsbyPageData, SSG };

package/build/exporter/commands/start-render.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

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

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/build/{constants → exporter/constants}/envs.d.ts

@@ -1,6 +1,3 @@
-/**
- * Here are all the environment variables that the CX code uses.
- */
 declare const GRIDDO_API_URL: string | undefined;
 declare const GRIDDO_PUBLIC_API_URL: string | undefined;
 declare const GRIDDO_BOT_USER: string | undefined;
@@ -19,9 +16,6 @@ declare const GRIDDO_ASSET_PREFIX: string | undefined;
 declare const GRIDDO_REACT_APP_INSTANCE: string | undefined;
 declare const GRIDDO_AI_EMBEDDINGS: boolean;
 declare const GRIDDO_VERBOSE_LOGS: boolean;
-declare const GRIDDO_ALERT_FEATURE: boolean;
-declare const GRIDDO_API_MAX_RESPONSE_SIZE: number;
-declare const GRIDDO_SSG_MAX_PAGE_SIZE: number;
 declare const GRIDDO_INIT_LIFECYCLE_MAX_ATTEMPTS: number;
 declare const GRIDDO_CLEAN_LIFECYCLE_MAX_ATTEMPTS: number;
 declare const GRIDDO_CLOSE_LIFECYCLE_MAX_ATTEMPTS: number;
@@ -34,4 +28,4 @@ declare const GRIDDO_META_LIFECYCLE_MAX_ATTEMPTS: number;
 declare const GRIDDO_ARCHIVE_LIFECYCLE_MAX_ATTEMPTS: number;
 declare const GRIDDO_FIXTURES_DOMAIN_NAMES: string | undefined;
 declare const GRIDDO_FIXTURES_SITE_NAMES: string | undefined;
-export { GRIDDO_AI_EMBEDDINGS, GRIDDO_ALERT_FEATURE, GRIDDO_API_CONCURRENCY_COUNT, GRIDDO_API_MAX_RESPONSE_SIZE, GRIDDO_API_URL, GRIDDO_ARCHIVE_LIFECYCLE_MAX_ATTEMPTS, GRIDDO_ASSET_PREFIX, GRIDDO_BOT_PASSWORD, GRIDDO_BOT_USER, GRIDDO_BUILD_LOGS, GRIDDO_CLEAN_LIFECYCLE_MAX_ATTEMPTS, GRIDDO_CLOSE_LIFECYCLE_MAX_ATTEMPTS, GRIDDO_DATA_LIFECYCLE_MAX_ATTEMPTS, GRIDDO_DEBUG_LOGS, GRIDDO_FIXTURES_DOMAIN_NAMES, GRIDDO_FIXTURES_SITE_NAMES, GRIDDO_INIT_LIFECYCLE_MAX_ATTEMPTS, GRIDDO_META_LIFECYCLE_MAX_ATTEMPTS, GRIDDO_PREPARE_LIFECYCLE_MAX_ATTEMPTS, GRIDDO_PUBLIC_API_URL, GRIDDO_REACT_APP_INSTANCE, GRIDDO_RELOCATION_LIFECYCLE_MAX_ATTEMPTS, GRIDDO_RENDER_ALL_SITES, GRIDDO_RENDER_BREAKPOINTS_FEATURE, GRIDDO_RENDER_PAGES, GRIDDO_RENDER_SITE, GRIDDO_RESTORE_LIFECYCLE_MAX_ATTEMPTS, GRIDDO_SEARCH_FEATURE, GRIDDO_SKIP_BUILD_CHECKS, GRIDDO_SSG_LIFECYCLE_MAX_ATTEMPTS, GRIDDO_SSG_MAX_PAGE_SIZE, GRIDDO_SSG_VERBOSE_LOGS, GRIDDO_VERBOSE_LOGS, };
+export { GRIDDO_AI_EMBEDDINGS, GRIDDO_API_CONCURRENCY_COUNT, GRIDDO_API_URL, GRIDDO_ARCHIVE_LIFECYCLE_MAX_ATTEMPTS, GRIDDO_ASSET_PREFIX, GRIDDO_BOT_PASSWORD, GRIDDO_BOT_USER, GRIDDO_BUILD_LOGS, GRIDDO_CLEAN_LIFECYCLE_MAX_ATTEMPTS, GRIDDO_CLOSE_LIFECYCLE_MAX_ATTEMPTS, GRIDDO_DATA_LIFECYCLE_MAX_ATTEMPTS, GRIDDO_DEBUG_LOGS, GRIDDO_FIXTURES_DOMAIN_NAMES, GRIDDO_FIXTURES_SITE_NAMES, GRIDDO_INIT_LIFECYCLE_MAX_ATTEMPTS, GRIDDO_META_LIFECYCLE_MAX_ATTEMPTS, GRIDDO_PREPARE_LIFECYCLE_MAX_ATTEMPTS, GRIDDO_PUBLIC_API_URL, GRIDDO_REACT_APP_INSTANCE, GRIDDO_RELOCATION_LIFECYCLE_MAX_ATTEMPTS, GRIDDO_RENDER_ALL_SITES, GRIDDO_RENDER_BREAKPOINTS_FEATURE, GRIDDO_RENDER_PAGES, GRIDDO_RENDER_SITE, GRIDDO_RESTORE_LIFECYCLE_MAX_ATTEMPTS, GRIDDO_SEARCH_FEATURE, GRIDDO_SKIP_BUILD_CHECKS, GRIDDO_SSG_LIFECYCLE_MAX_ATTEMPTS, GRIDDO_SSG_VERBOSE_LOGS, GRIDDO_VERBOSE_LOGS, };

package/build/{errors/errors-data.d.ts → exporter/constants/errors.d.ts}

@@ -6,9 +6,9 @@
  * file by completing the `error` (ErrosType) and `message` (string) properties
  * obligatorily.
  */
-import type { ErrorData } from ".";
 import type { SpawnSyncReturns } from "node:child_process";
-type ErrorsType = "ArtifactError" | "ErrorInSSGBuildProcess" | "LifecycleExecutionError" | "LoginError" | "NoDomainsFoundError" | "NoJSConfigFileFound" | "ReadFromStoreError" | "ReferenceFieldSourcesNotFoundError" | "RenderUUIDError" | "WriteToStoreError";
+import type { ErrorData } from "../utils/errors";
+type ErrorsType = "UploadSearchError" | "ArtifactError" | "ErrorInSSGBuildProcess" | "LifecycleExecutionError" | "LoginError" | "NoDomainsFoundError" | "NoJSConfigFileFound" | "ReadFromStoreError" | "ReferenceFieldSourcesNotFoundError" | "RenderUUIDError" | "WriteToStoreError" | "CheckHealthError";
 declare const ArtifactError: ErrorData;
 declare const ErrorInSSGBuildProcess: (command: SpawnSyncReturns<string>) => ErrorData;
 declare const LifecycleExecutionError: (attempts: number, name: string) => ErrorData;
@@ -19,4 +19,6 @@ declare const ReadFromStoreError: ErrorData;
 declare const ReferenceFieldSourcesNotFoundError: ErrorData;
 declare const RenderUUIDError: ErrorData;
 declare const WriteToStoreError: ErrorData;
-export { ArtifactError, ErrorInSSGBuildProcess, LifecycleExecutionError, LoginError, NoDomainsFoundError, NoJSConfigFileFound, ReadFromStoreError, ReferenceFieldSourcesNotFoundError, RenderUUIDError, WriteToStoreError, type ErrorsType, };
+declare const UploadSearchError: ErrorData;
+declare const CheckHealthError: ErrorData;
+export { ArtifactError, ErrorInSSGBuildProcess, LifecycleExecutionError, LoginError, NoDomainsFoundError, NoJSConfigFileFound, ReadFromStoreError, ReferenceFieldSourcesNotFoundError, RenderUUIDError, UploadSearchError, WriteToStoreError, CheckHealthError, type ErrorsType, };

package/build/{services → exporter/services}/auth.d.ts

@@ -4,7 +4,7 @@ import type { AuthHeaders } from "../types/api";
  */
 declare class AuthService {
     headers: AuthHeaders | undefined;
-    login(): Promise<AuthHeaders | undefined>;
+    login(): Promise<AuthHeaders>;
 }
 declare const authService: AuthService;
 export { authService as AuthService };

package/build/exporter/services/db.d.ts

@@ -0,0 +1,4 @@
+import type { RenderDB } from "../types/render";
+declare function readDB(customDBPath?: string): Promise<RenderDB>;
+declare function writeDB(renderDB: RenderDB, customDBPath?: string): Promise<void>;
+export { readDB, writeDB };

package/build/{services → exporter/services}/robots.d.ts

@@ -1,14 +1,8 @@
 import type { Robots } from "../types/global";
-/**
- * TODO: JSDoc
- */
 declare class RobotsService {
     robots: Robots;
     settings: Record<string, unknown>;
     constructor();
-    /**
-     * TODO: JSDoc
-     */
     private getRobots;
     /**
      * Write robots.txt files for the domain.

package/build/{services → exporter/services}/sites.d.ts

@@ -1,6 +1,6 @@
+import type { Core } from "@griddo/core";
 import type { AllSitesReponse, EndPageInfoResponse, EndSiteRenderBody, LanguagesResponse, ReferenceFieldBody, ReferenceFieldResponse, SitemapAPIResponse, SocialsResponse, StartPageRenderResponse } from "../types/api";
 import type { Site } from "../types/sites";
-import type { Core } from "@griddo/core";
 /**
  * Get a list of site objects.
  */
@@ -24,6 +24,9 @@ declare function startSiteRender(id: number): Promise<StartPageRenderResponse>;
  */
 declare function endSiteRender(id: number, body: EndSiteRenderBody): Promise<EndPageInfoResponse>;
 declare function getReferenceFieldSiteData(page: Core.Page, body: ReferenceFieldBody, cacheKey: string, dataSiteId?: number, dataLangID?: number): Promise<ReferenceFieldResponse>;
-declare function getSitemap(id: number): Promise<SitemapAPIResponse>;
+declare function getSitemap(options: {
+    siteId: number;
+    headers?: Record<string, string>;
+}): Promise<SitemapAPIResponse>;
 declare function getSiteSocials(id: number, cacheKey?: string): Promise<SocialsResponse>;
 export { endSiteRender, getAllSites, getAllSitesFromDomain, getPage, getReferenceFieldSiteData, getSiteInfo, getSiteLanguages, getSitemap, getSiteSocials, startSiteRender, };

package/build/exporter/services/store.d.ts

@@ -0,0 +1,15 @@
+import type { RenderMode } from "../types/render";
+/**
+ * Fetch, process and save object pages and sites data into the file system to
+ * be consumed by other services (Griddo itself, Adapters, etc.)
+ */
+declare function createStore(options: {
+    domain: string;
+    renderMode: RenderMode;
+    griddoVersion: string;
+    basePath: string;
+}): Promise<{
+    pagesToCreate: number[];
+    pagesToDelete: number[];
+}>;
+export { createStore };

package/build/{types → exporter/types}/api.d.ts

@@ -1,7 +1,7 @@
+import type { Core, Fields } from "@griddo/core";
 import type { Domains, Robots, Settings } from "./global";
 import type { APIPageObject } from "./pages";
 import type { Site } from "./sites";
-import type { Core, Fields } from "@griddo/core";
 /** EndSiteRender Body */
 export type EndSiteRenderBody = {
     /** Site hashes to publish. */
@@ -25,6 +25,7 @@ export interface ReferenceFieldBody {
     fixed?: Array<number>;
     referenceId?: number;
 }
+/** Describes the props of the body object for the get page */
 /** Describes an item in a sitemap. */
 interface SitemapItem {
     /** The URL of the page. */
@@ -84,10 +85,8 @@ export interface APIRequest {
     attempt?: number;
     /**
      * Headers for the post api fetch
-     * @shame any
-     * @todo type this correctly from axios types
      */
-    headers?: any;
+    headers?: Record<string, unknown>;
     useApiCacheDir?: boolean;
 }
 /** Type with the POST request properties. */

package/build/{types → exporter/types}/global.d.ts

@@ -1,6 +1,6 @@
+import type { Core, Fields } from "@griddo/core";
 import type { EndSiteRenderBody } from "./api";
 import type { Site } from "./sites";
-import type { Core, Fields } from "@griddo/core";
 interface Settings {
     apiVersion?: string;
     avoidCanonicalsOnSitemaps?: boolean;
@@ -62,14 +62,13 @@ interface RenderInfo {
     createdPages: Array<number>;
     sitesToPublish: Array<Site>;
 }
-type LifeCycleSteps = Array<(...args: Array<unknown>) => unknown | Promise<unknown>>;
-type LifeCyclesNames = "Init" | "Prepare" | "Restore" | "Data" | "SSG" | "Relocation" | "Meta" | "Archive" | "Clean" | "Close" | "HealthCheck" | "Close" | "__DEBUG__";
-type PlaceholderPath = "__exports" | "__cache" | "__cx" | "__ssg" | "__components" | "__root" | "__exports_dist" | "__cx_dist";
+type LifeCycleAction = (...args: Array<unknown>) => void | Promise<void>;
+type LifeCyclesNames = "Init" | "Prepare" | "Restore" | "Data" | "SSG" | "Relocation" | "Meta" | "Sync" | "Clean" | "Close" | "HealthCheck" | "Close";
+type PlaceholderPath = "__exports" | "__cache" | "__cx" | "__ssg" | "__components" | "__root" | "__exports_dist" | "__cx_dist" | "__sites";
 interface CXConfig {
     proDomain: string;
     griddoVersion: string;
     buildReportFileName: string;
-    paths: (domain?: string) => Record<PlaceholderPath, string>;
 }
 interface AIEmbeddingsResponse {
     code: number;
@@ -80,5 +79,6 @@ interface Artifacts {
     cacheables: Array<string>;
     initials: Array<string>;
     archivables: Array<string>;
+    restaurable: Array<string>;
 }
-export type { AIEmbeddingsResponse, Artifacts, BuildProcessData, CXConfig, Domain, Domains, FetchDataProps, LifeCyclesNames, Petition, PlaceholderPath, PostSearchInfoProps, RenderInfo, Robot, Robots, Settings, LifeCycleSteps, };
+export type { AIEmbeddingsResponse, Artifacts, BuildProcessData, CXConfig, Domain, Domains, FetchDataProps, LifeCyclesNames, Petition, PlaceholderPath, PostSearchInfoProps, RenderInfo, Robot, Robots, Settings, LifeCycleAction, };

package/build/{types → exporter/types}/navigation.d.ts

@@ -24,5 +24,5 @@ export type Footer = {
     setAsDefault: boolean;
     theme: null | string;
     title: string;
-    type: "header";
+    type: "footer";
 };

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

@@ -0,0 +1,50 @@
+import type { RenderInfo } from "./global";
+declare const RENDER_MODE: {
+    readonly FROM_SCRATCH: "FROM_SCRATCH";
+    readonly INCREMENTAL: "INCREMENTAL";
+    readonly IDLE: "IDLE";
+};
+type RenderMode = (typeof RENDER_MODE)[keyof typeof RENDER_MODE];
+export interface RenderModeTuple {
+    renderMode: RenderMode;
+    reason?: string;
+}
+type DomainLike = string;
+type RenderDB = {
+    proDomain: string;
+    griddoVersion: string;
+    buildReportFileName: string;
+    sortedDomains: Array<DomainLike>;
+    paths: {
+        root: string;
+        cx: string;
+        ssg: string;
+        cxCache: string;
+        components: string;
+        exportsDir: string;
+    };
+    domains: {
+        [key: DomainLike]: {
+            renderMode?: RenderMode;
+            shouldBeRendered?: boolean;
+            isRendering?: boolean;
+            renderInfo?: RenderInfo;
+            renderModeReason?: string;
+        };
+    };
+};
+interface Report {
+    authControl: {
+        Authorization: string;
+        "Cache-Control": string;
+        lang?: string | undefined;
+    } | undefined;
+    sites: Array<{
+        siteId: number;
+        publishHashes: Array<string>;
+        siteHash: string | null;
+        unpublishHashes: Array<string>;
+        publishPagesIds: Array<number>;
+    }>;
+}
+export { RENDER_MODE, type RenderDB, type RenderMode, type Report };

package/build/{types → exporter/types}/sites.d.ts

@@ -1,6 +1,6 @@
+import type { Core } from "@griddo/core";
 import type { SocialsResponse } from "./api";
 import type { Footer, Header } from "./navigation";
-import type { Core } from "@griddo/core";
 /**
  * Describes a Griddo site object from API.
  * This takes some type props from Core.Site.
@@ -26,7 +26,6 @@ export interface Site extends Required<Pick<Core.Site, "bigAvatar" | "favicon" |
      */
     pages: Array<number>;
     onlinePages: Array<number>;
-    changedPages: Array<number>;
     published: string;
     rendering: boolean;
     renderingHours: number;

package/build/exporter/utils/artifacts.d.ts

@@ -0,0 +1,6 @@
+import type { Artifacts } from "../types/global";
+/**
+ * Returns the artifacts of CX.
+ */
+declare function getCxArtifacts(domain: string): Promise<Artifacts>;
+export { getCxArtifacts };

package/build/exporter/utils/brush.d.ts

@@ -0,0 +1,18 @@
+declare const CODES: {
+    readonly black: "\u001B[30m";
+    readonly red: "\u001B[31m";
+    readonly green: "\u001B[32m";
+    readonly yellow: "\u001B[33m";
+    readonly blue: "\u001B[34m";
+    readonly magenta: "\u001B[35m";
+    readonly cyan: "\u001B[36m";
+    readonly white: "\u001B[37m";
+    readonly gray: "\u001B[90m";
+    readonly bold: "\u001B[1m";
+    readonly dim: "\u001B[2m";
+};
+type ColorFunction = (text: string | number) => string;
+type ColorName = keyof typeof CODES;
+type Brush = Record<ColorName, ColorFunction>;
+declare const brush: Brush;
+export { brush };

package/build/{utils → exporter/utils}/cache.d.ts

@@ -3,33 +3,28 @@ import type { SiteHash } from "../types/sites";
 /**
  * Creates an `apiCache` dir to store pages fetched from them API.
  */
-declare function createAPICacheDir(): void;
-/**
- * Generate a filename with a hash using a string.
- *
- * @todo Merge with generateFilenameWithHash
- * @param data A string to create a sha256 based on.
- */
-declare function createSha256(data: string): string;
+declare function createAPICacheDir(options: {
+    basePath: string;
+}): Promise<void>;
 /**
  * Save a file using a hash name.
  *
  * @param petition An object.
  * @param content Content to be saved.
  */
-declare function saveCache<T>(petition: Petition, content: T): void;
+declare function saveCache<T>(petition: Petition, content: T): Promise<void>;
 /**
  * Search in the `apiCache` dir for a file using the petition as hash generator.
  * Return the file content if found or null if not.
  *
  * @param petition An object
  */
-declare function searchCacheData<T>(petition: Petition): T | null;
+declare function searchCacheData<T>(petition: Petition): Promise<T | null>;
 /**
  * Update (write) the site hash file.
  *
  * @param siteId The id of the site.
  * @param siteHash The has of the site.
  */
-declare function updatedSiteHash(siteId: number, siteHash: SiteHash): string;
-export { createAPICacheDir, createSha256, saveCache, searchCacheData, updatedSiteHash, };
+declare function updatedSiteHash(siteId: number, siteHash: SiteHash): Promise<string>;
+export { createAPICacheDir, saveCache, searchCacheData, updatedSiteHash };

package/build/{utils/health-checks.d.ts → exporter/utils/check-health.d.ts}

@@ -1,7 +1,7 @@
+#!/usr/bin/env node
 /**
  * Check if the environment is secure to launch a render.
  * If something fails then log an error message and exit from the process.
  * Otherwise just return true.
  */
-declare function checkRenderHealthOrExit(): boolean;
-export { checkRenderHealthOrExit };
+export declare function checkHealth(): boolean;

package/build/exporter/utils/core-utils.d.ts

@@ -0,0 +1,77 @@
+import type { APIResponses } from "../types/api";
+import type { LifeCycleAction, LifeCyclesNames } from "../types/global";
+/**
+ * Returns true for "true", "on", true and positive numbers.
+ * Returns false for "false", "off", false, 0, negative integers and anything else.
+ */
+declare function isTruthy(value: any): boolean;
+/**
+ * Walk a directory and returns the JSON file absolute paths with one level of depth.
+ * /abs/.../sotre/<siteId>/jsonfile.json
+ * /abs/.../sotre/<siteId>/jsonfile.json
+ * /abs/.../sotre/<siteId>/jsonfile.json
+ * /abs/.../sotre/<siteId>/jsonfile.json
+ */
+declare function walkStore(storeDir: string): AsyncGenerator<string>;
+/**
+ * Custom delay using the "promise hack",
+ *
+ * @param ms Amount of miliseconds to be delayed
+ */
+declare function delay(ms: number): Promise<unknown>;
+/**
+ * Converts milliseconds to seconds with a fixed number of decimals.
+ *
+ * @param ms The number in milliseconds.
+ * @param fixed The amount of fixed decimals.
+ * @returns The converted number in seconds with the fixed number of decimals.
+ */
+declare function msToSec(ms: number, decimals?: number): string;
+/**
+ * Return a siteID from a response object if exist
+ * @param response A response object
+ */
+declare function getSafeSiteId(response: APIResponses): number | undefined;
+/**
+ * Remove props from an object
+ *
+ * @param obj The object
+ * @param props An array of props to be removed
+ */
+declare function removeProperties(obj: Record<string, unknown>, props: Array<string>): void;
+/**
+ * Measures the execution time of a series of sync or async functions.
+ *
+ * @async
+ * @param functions - Functions to be executed to measure their execution time.
+ * @returns A promise that resolves with the total execution time in seconds.
+ */
+declare function executeAndReturnExecutionTime<T>(func: () => T | Promise<T>): Promise<number>;
+/**
+ * Executes a life cycle process, which involves executing a callback
+ * function, printing to the console, and handling errors with optional retries.
+ *
+ * @async
+ * @param name - The name of the life cycle.
+ * @param action - A callback function to execute.
+ * @param options - Optional configuration for the life cycle process.
+ * @param options.maxRetrys - The maximum number of retries for the life cycle.
+ * @param options.enabled - Whether the life cycle process should be executed.
+ * @returns - A promise that resolves when the life cycle process is completed.
+ */
+declare function doLifeCycle(name: string, action: LifeCycleAction, options?: {
+    maxRetrys?: number;
+    spinner?: boolean;
+}): Promise<void>;
+declare function removeAllSiteDirsFromStore(): Promise<void>;
+/**
+ * Save render information to a file to use as debug log.
+ *
+ * This information will **not** be sent to any API.
+ */
+declare function saveBuildEndLogs(options: {
+    basePath: string;
+    domain: string;
+}): Promise<void>;
+declare const lifeCycleNames: Record<LifeCyclesNames, LifeCyclesNames>;
+export { delay, doLifeCycle, executeAndReturnExecutionTime, getSafeSiteId, isTruthy, lifeCycleNames, msToSec, removeAllSiteDirsFromStore, removeProperties, saveBuildEndLogs, walkStore, };

package/build/{utils → exporter/utils}/domains.d.ts

@@ -10,4 +10,4 @@ declare function getInstanceDomains(): Promise<string[]>;
  * @see Domains
  */
 declare function getDomainSlugs(domains: Domains): string[];
-export { getInstanceDomains, getDomainSlugs };
+export { getDomainSlugs, getInstanceDomains };

package/build/{errors/index.d.ts → exporter/utils/errors.d.ts}

@@ -1,4 +1,4 @@
-import type { ErrorsType } from "./errors-data";
+import type { ErrorsType } from "../constants/errors";
 export type ErrorData = {
     error: ErrorsType;
     message: string;
@@ -6,10 +6,10 @@ export type ErrorData = {
     hint?: string;
 };
 export declare class RenderError extends Error {
-    constructor();
+    constructor(originalError?: unknown);
 }
 /**
  * Throws an error with the provided error message, expected value, and hint.
  */
-declare function throwError(options: ErrorData, stack?: unknown): void;
+declare function throwError(options: ErrorData, stack?: unknown): never;
 export { throwError };

package/build/exporter/utils/folders.d.ts

@@ -0,0 +1,66 @@
+import type { MakeDirectoryOptions } from "node:fs";
+/**
+ * Remove an empty directory from the basePath recursively.
+ * If the directory has only .xml files it will handle as empty too (empty site)
+ *
+ * @param baseDir - The base directory.
+ */
+declare function deleteDisposableSiteDirs(baseDir: string): Promise<void>;
+/**
+ * Creates multiple artifact directories.
+ *
+ * @param dirs - An array of directory paths.
+ * @param options - Same option as `fs.mkdirSync()`
+ */
+declare function createDirs(dirs: Array<string>, options?: MakeDirectoryOptions): Promise<void>;
+declare function renamePath(src: string, dst: string): Promise<void>;
+/**
+ * Copy multiple directories with backup option.
+ *
+ * @param src - Source directory.
+ * @param dst - Destination directory.
+ * @param dirs - Directories to copy.
+ * @param options.withBackup - Create a previous backup before copy.
+ */
+declare function copyDirs(src: string, dst: string, dirs: Array<string>, options?: {
+    withBackup: boolean;
+}): Promise<void>;
+/**
+ * Move artifacts between cx-paths
+ *
+ * @param src - Source directory.
+ * @param dst - Destination directory.
+ * @param dirs - Directories to move.
+ * @param options - Options.
+ */
+declare function moveDirs(src: string, dst: string, dirs: Array<string>, options?: {
+    withBackup?: boolean;
+    override?: boolean;
+}): Promise<void>;
+/**
+ * Removes multiple artifact directories.
+ *
+ * @param dirs - An array of directory paths.
+ */
+declare function removeDirs(dirs: Array<string>): Promise<void>;
+/**
+ * Elimina todas las páginas del store (de todos los sites) cuyo nombre empiece
+ * con un guión "-". Estas páginas son "virtuales" y no tienen ids desde API por
+ * lo que mantenerlas en el store es un problema cuando se hacen modificaciones
+ * en la página "madre". La solución por ahora es borrarlas del store y
+ * rehacerlas en todos los renders.
+ */
+declare function removeVirtualPages(dirPath: string): Promise<void>;
+declare function prependFileSync(filePath: string, content: string): Promise<void>;
+/**
+ * Delete empty directories from the given directory in a recursive way.
+ */
+declare function deleteEmptyDirectories(dirPath: string): Promise<void>;
+declare function pathExists(dir: string): Promise<boolean>;
+declare function pkgDir(options?: {
+    readonly cwd?: string;
+}): Promise<string | undefined>;
+declare function pkgDirSync(options?: {
+    readonly cwd?: string;
+}): string | undefined;
+export { copyDirs, createDirs, deleteDisposableSiteDirs, deleteEmptyDirectories, moveDirs, pathExists, pkgDir, pkgDirSync, prependFileSync, removeDirs, removeVirtualPages, renamePath, };

package/build/{utils → exporter/utils}/loggin.d.ts

@@ -1,13 +1,11 @@
 import type { Site } from "../types/sites";
 /**
  * Custom basic logging function controlled by a environment variable.
- *
  * @param str The string to be logged.
  */
 declare function verboseLog(str: string): void;
 /**
  * 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.
@@ -30,22 +28,10 @@ declare function infoLog(str: string): void;
  * @param str The string to be logged.
  */
 declare function successLog(str: string): void;
-/**
- * Internal log
- * @param values The values to be logged.
- */
-declare function debugLog(...values: Array<unknown>): void;
-/**
- * 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.
- */
-declare function pageSizeLog(size: number, measure?: string): string;
 /**
  * Console log the Griddo exporter version.
  */
-declare function showExporterVersion(): void;
+declare function showExporterVersion(): Promise<void>;
 declare function listSitesLog(title: string, sites: Array<Site>): void;
 declare function errorLabelLog(msg: string): void;
-export { boxLog, buildLog, debugLog, errorLabelLog, infoLog, listSitesLog, pageSizeLog, showExporterVersion, successLog, verboseLog, };
+export { boxLog, buildLog, errorLabelLog, infoLog, listSitesLog, showExporterVersion, successLog, verboseLog, };

package/build/{utils → exporter/utils}/pages.d.ts

@@ -1,6 +1,6 @@
+import type { Fields } from "@griddo/core";
 import type { GriddoListPage, GriddoMultiPage, GriddoPageObject, GriddoSinglePage, MultiPageElements, PageAdditionalInfo } from "../types/pages";
 import type { TemplateWithReferenceField } from "../types/templates";
-import type { Fields } from "@griddo/core";
 /**
  * Create a single Griddo page object.
  *
@@ -11,7 +11,7 @@ declare function createGriddoSinglePage(page: GriddoSinglePage, additionalInfo:
 /**
  * Create multiples pages from one page as list paginated pages
  */
-declare function createGriddoListPages({ page, pages, isRoot, defaultLang, template, totalQueriedItems, }: GriddoListPage, additionalInfo: PageAdditionalInfo): Promise<GriddoPageObject[]>;
+declare function createGriddoListPages({ page, pages, isRoot, defaultLang, template, totalQueriedItems }: GriddoListPage, additionalInfo: PageAdditionalInfo): Promise<GriddoPageObject[]>;
 /**
  * Create multiples pages from a MultiPage module
  *

package/build/exporter/utils/render.d.ts

@@ -0,0 +1,49 @@
+import type { RenderModeTuple } from "../types/render";
+/**
+ * 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 coming from a deploy.
+ */
+declare function markRenderAsStarted(options: {
+    domain: string;
+    basePath: string;
+}): Promise<void>;
+declare function markRenderAsCompleted(domain: string): Promise<void>;
+declare function assertRenderIsValid(): Promise<void>;
+declare function resolveDomainRenderMode(options: {
+    domain: string;
+    shouldBeRendered: boolean;
+}): Promise<{
+    renderMode: "FROM_SCRATCH";
+    reason: string;
+} | {
+    renderMode: "IDLE";
+    reason: string;
+} | {
+    renderMode: "INCREMENTAL";
+    reason: string;
+}>;
+declare function updateCommitFile(options: {
+    basePath: string;
+}): Promise<void>;
+declare function getRenderMode(domain: string): Promise<RenderModeTuple>;
+declare function getRenderPathsFromDB(options?: {
+    domain?: string;
+    dbFilePath?: string;
+}): Promise<{
+    __root: string;
+    __cache: string;
+    __components: string;
+    __cx: string;
+    __sites: string;
+    __exports: string;
+    __ssg: string;
+    __exports_dist: string;
+    __cx_dist: string;
+}>;
+declare function getRenderMetadataFromDB(): Promise<{
+    proDomain: string;
+    griddoVersion: string;
+    buildReportFileName: string;
+}>;
+export { assertRenderIsValid, getRenderMetadataFromDB, getRenderMode, getRenderPathsFromDB, markRenderAsCompleted, markRenderAsStarted, resolveDomainRenderMode, updateCommitFile, };