@griddo/cx 10.4.20 → 10.4.22

package/README.md

@@ -1,93 +1,28 @@
 # Griddo package
 
-## TO-DO
-
-- [ ] Crear el store utilizando un HASH como nombre de archivo y no el ID.
-- [ ] Manejar el store teniendo en cuenta el ID de las páginas leyendo el objeto y no el nombre del archivo.
-
----
 
 El package `griddo-cx` está dividido en dos carpetas principales: una para la lógica de negocio en `/exporter` y otra para Gatsby (builder) `/src`.
 
-Estas dos carpetas estarían representando dos estados o fases diferenciadas en la ejecución de un "render/build de cx" completo.
+## `/exporter`
 
-1. **Fetching**: Obtención, postprocesado y guardado de los datos en el sistema de archivos.
+**Griddo Exporter** es el script _orquestador_ que debe llamar **una vez por cada dominio** a los distintos procesos que implican la realización de la publicación de una instancia.
 
-2. **Rendering** Ejecución de Gatsby para construir los sites utilizando los datos descargados
+En el exporter se desarrolla todo lo necesario para la conexión con API, post-procesado de los datos y generación de JSONS finales de los sites con "el estándar Griddo". Aquí es donde se ejecuta la mayor parte de la lógica: obtención de páginas, listados, distribuidores, idomas, etc. Todo está implementado como una _library_, nada se ejecuta por sí solo. Lo tiene que hacer el Adapter.
 
-## 1. Fetching
+**Adapter**
 
-En la fase de Griddo se desarrolla todo lo necesario para la conexión con API, post-procesado de los datos y generación de JSONS finales de los sites con "un formato Griddo". Aquí es donde se ejecuta la mayor parte de la lógica: obtención de páginas, listados, distribuidores, idomas, etc.
+El adapter es una parte del código de CX que orquesta un render, utilizando como servicios la _library_ de CX y el framework de SSG disponible. Actualmente hay un SSG, Gatsby. Por lo tanto hay un adapter a Gatsby. Lógica de negocio y SSG ya no están mezclados.
 
 Si hay un requerimiento en CX es muy probable que sea en esta parte donde haya que trabajar.
 
-**Estructura de carpetas**
-
-```text
-| src/
-  | adapters/
-    | gatsby/ # Adapta la salida (JSON) de Griddo -> Gatsby
-  | services/
-  | types/
-  | utils/
-  | create-build-data.ts
-  | build-complete.ts
-  | index.ts
-  | reset-render.ts
-```
-
-## 2. Rendering (Gatsby)
-
-Esta fase se ejecuta inmediatamente después de la primera. Se ejecuta `yarn gatsby build` lo que generá un build utilizando todos los datos que se descargaron en la carpeta `store`.
-
-El código de Gatsby (por ahora el único SSG usado por Griddo) está en la carpeta `./src` junto con los archivos en el root: `gatsby-config.ts`, `gastsby-node.ts`, `gatsby-browser.ts` y `gatsby-ssr.ts`.
-
-```text
-| src/
-  | components/
-    | Head.tsx
-    | template.tsx
-  | htm.tsx
-  | gatsby-node-utils.ts
-  | types.ts
-  | utils.ts
-| gatsby-browser.ts
-| gatsby-config.ts
-| gatsby-node.ts
-| gatsby-ssr.ts
-```
-
-# Griddo Exporter
-
-El punto de entrada para CX está en `src/index.js` que ejecuta **Griddo Exporter**, publicado en `./build/index.js` del cual podemos encontrar el código TypeScript en `./scripts/griddo-exporter.ts`
+## `/src`
 
-**Griddo Exporter** es el script _orquestador_ que llama **una vez por cada dominio** a los distintos procesos que implican la realización del build de un dominio.
+Aquí es donde reside el SSG actual (Gatsby) junto a archivos en el raíz, como `gatsby-node`, etc. Este ssg será llamado por el Adapter dentro del `Data LifeCycle`. El SSG solo debe saber que hay una carpeta `/store/` con los .json que representan las páginas a renderizar. Desde la `cx-library` también podrá hacer uso de otras utilidades, servicios y componentes. Por ejemplo utilizará la función `getBuildPagesFromStore` para obtener las páginas anteriormente creadas desde el store. Es decir, El SSG "no sabe" dónde están las páginas, tan solo tiene una función que se las va a devolver.
 
-`BUILD-COMPLETO = PROCESOS * DOMINIOS`
 
-## Los procesos
-
-Los distintos procesos llamados desde **Griddo Exporter** son:
-
-### API Fetch
-
-**`yarn run api-fetch`**
-
-Realiza toda la consulta de datos a la API de los sites (páginas, distribuidores, etc...) de un dominio, post-procesa y construye los `pageObjets`. Estos `pageObjects` son guardados como archivos JSON en una carpeta del sistema de archivos, creando lo que llamamos un **Store**.
-
-Este Store no está acoplado con ningún sistema de renderización (Gatsby), son solo archivos JSON que describen los sites y páginas con el estándar que hemos diseñado desde Griddo.
-
-### Gatsby build
-
-**`gatsby-build`**
-
-Se leen los JSON del store y se crean las páginas pasándolos directamente (0 pre/post procesado) a la función `creatPages` de Gatsby.
-
-### Post build
+---
 
-- Se crean Robots
-- Se crean sitemaps.xml del render
-- Se crear un archivo **build_report**info.json para notificar a la API de la finalización del render
-- Se mueven el bundle generado por Gatsby de /public a /dist (esto se debería deprecar)
+## TO-DO
 
-**`post-build`**
+- [ ] Crear el store utilizando un HASH como nombre de archivo y no el ID.
+- [ ] Manejar el store teniendo en cuenta el ID de las páginas leyendo el objeto y no el nombre del archivo.

package/build/adapters/gatsby/utils.d.ts

@@ -1,18 +1,14 @@
-import { Fields } from "@griddo/core";
-declare const attempts: {
-    prepare: any;
-    restore: any;
-    data: any;
-    ssg: any;
-    relocation: any;
-    meta: any;
-    archive: any;
-    clean: any;
-};
+import type { Fields } from "@griddo/core";
 /**
- * Return the assetPrefix url `assetPrefix/domain`
+ * Return the assetPrefix with the domain concatenated `assetPrefix/domain` only
+ * if the domain is "pro-" **and** there is a env `GRIDDO_ASSET_PREFIX` with any
+ * value different from `null`, `undefined` or `empty string`
+ *
+ * else...
+ * - If assetPrefix or domain is falsy, returns ""
+ * - If the domain is not "pro-", returns ""
  */
-declare function getGatsbyAssetPrefixSlug(domain: string): string;
+declare function getGatsbyAssetPrefixWithDomain(domain: string): string;
 /**
  * Format Cloudinary or DAM URL
  *
@@ -23,4 +19,15 @@ declare function getGatsbyAssetPrefixSlug(domain: string): string;
  * @returns A composed URL for the Cloudinary or DAM service
  */
 declare function formatImage(image: Fields.Image | string, width: number, height: number, format?: string): string | null;
-export { attempts, formatImage, getGatsbyAssetPrefixSlug };
+/**
+ * Spawn a new node process `yarn gatsby-build`
+ * @note This proccess (`yarn gatsby-build`) can not access to the custom Griddo
+ * `process.env` so it needs variables passed to it via the `env` prop.
+ */
+declare function gatsbyBuild(assetPrefixWithDomain: string): void;
+/**
+ * Update the Griddo's `/dist` dir with the contents from `public` dir only
+ * with files of type: js, json and css.
+ */
+declare function legacy__createDistFromGatsbyPublic(domain: string, needsAssetPrefix: boolean): Promise<void>;
+export { formatImage, gatsbyBuild, getGatsbyAssetPrefixWithDomain, legacy__createDistFromGatsbyPublic, };

package/build/browser/index.d.ts

@@ -1,4 +1,4 @@
-import { Core } from "@griddo/core";
+import type { Core } from "@griddo/core";
 declare function filterBodyIntegrationFromPosition(integrations: Array<Core.PageIntegration>, position: "start" | "end"): string[];
 declare function filterHeadIntegrations(integrations: Array<Core.PageIntegration>): string[];
 declare function filterPositionIntegrations(integrations: Array<Core.PageIntegration>, position: "head" | "start" | "end"): string[];

package/build/browser/index.js

@@ -1 +1 @@
-"use strict";var o=Object.defineProperty;var i=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var l=Object.prototype.hasOwnProperty;var u=(e,t)=>{for(var n in t)o(e,n,{get:t[n],enumerable:!0})},y=(e,t,n,a)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of f(t))!l.call(e,r)&&r!==n&&o(e,r,{get:()=>t[r],enumerable:!(a=i(t,r))||a.enumerable});return e};var s=e=>y(o({},"__esModule",{value:!0}),e);var P={};u(P,{filterBodyIntegrationFromPosition:()=>d,filterHeadIntegrations:()=>c,filterPositionIntegrations:()=>I});module.exports=s(P);function d(e,t){return e?.filter(n=>n.contentBody!==null&&n.contentBody!==""&&n.contentBodyPosition===t).map(n=>n.contentBody)||[]}function c(e){return e?.filter(t=>t.contentHead!==null&&t.contentHead!=="").map(t=>t.contentHead)||[]}function I(e,t){switch(t){case"head":return c(e);default:return d(e,t)}}0&&(module.exports={filterBodyIntegrationFromPosition,filterHeadIntegrations,filterPositionIntegrations});
+"use strict";var o=Object.defineProperty;var i=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var l=Object.prototype.hasOwnProperty;var u=(e,t)=>{for(var n in t)o(e,n,{get:t[n],enumerable:!0})},y=(e,t,n,a)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of f(t))!l.call(e,r)&&r!==n&&o(e,r,{get:()=>t[r],enumerable:!(a=i(t,r))||a.enumerable});return e};var s=e=>y(o({},"__esModule",{value:!0}),e);var I={};u(I,{filterBodyIntegrationFromPosition:()=>d,filterHeadIntegrations:()=>c,filterPositionIntegrations:()=>g});module.exports=s(I);function d(e,t){return e?.filter(n=>n.contentBody!==null&&n.contentBody!==""&&n.contentBodyPosition===t).map(n=>n.contentBody)||[]}function c(e){return e?.filter(t=>t.contentHead!==null&&t.contentHead!=="").map(t=>t.contentHead)||[]}function g(e,t){switch(t){case"head":return c(e);default:return d(e,t)}}0&&(module.exports={filterBodyIntegrationFromPosition,filterHeadIntegrations,filterPositionIntegrations});