@griddo/cx 11.7.6-rc.2 → 11.7.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (280) hide show
  1. package/README.md +226 -27
  2. package/build/adapters/gatsby/index.d.ts +4 -0
  3. package/build/adapters/gatsby/utils.d.ts +22 -0
  4. package/build/artifacts/index.d.ts +6 -0
  5. package/build/commands/end-render.d.ts +2 -0
  6. package/build/commands/move-assets.d.ts +1 -0
  7. package/build/commands/prepare-domains-render.d.ts +1 -0
  8. package/build/commands/reset-render.d.ts +2 -0
  9. package/build/commands/start-render.d.ts +2 -0
  10. package/build/commands/upload-search-content.d.ts +2 -0
  11. package/build/constants/endpoints.d.ts +19 -0
  12. package/build/constants/envs.d.ts +37 -0
  13. package/build/constants/index.d.ts +57 -0
  14. package/build/end-render.js +74 -0
  15. package/build/end-render.js.map +7 -0
  16. package/build/errors/errors-data.d.ts +22 -0
  17. package/build/errors/index.d.ts +15 -0
  18. package/build/index.d.ts +29 -0
  19. package/build/index.js +73 -0
  20. package/build/index.js.map +7 -0
  21. package/build/prepare-domains-render.js +73 -0
  22. package/build/prepare-domains-render.js.map +7 -0
  23. package/build/react/Favicon/index.d.ts +5 -0
  24. package/build/react/Favicon/utils.d.ts +9 -0
  25. package/build/react/GriddoIntegrations/index.d.ts +20 -0
  26. package/build/react/GriddoIntegrations/utils.d.ts +26 -0
  27. package/{react/index.tsx → build/react/index.d.ts} +0 -1
  28. package/build/react/index.js +3 -0
  29. package/build/registers/api.d.ts +9 -0
  30. package/build/registers/gatsby.d.ts +9 -0
  31. package/build/registers/index.d.ts +3 -0
  32. package/build/reset-render.js +74 -0
  33. package/build/reset-render.js.map +7 -0
  34. package/build/services/auth.d.ts +10 -0
  35. package/build/services/domains.d.ts +6 -0
  36. package/build/services/navigation.d.ts +50 -0
  37. package/build/services/reference-fields.d.ts +20 -0
  38. package/build/services/register.d.ts +36 -0
  39. package/build/services/robots.d.ts +19 -0
  40. package/build/services/settings.d.ts +4 -0
  41. package/build/services/sites.d.ts +29 -0
  42. package/build/services/store.d.ts +6 -0
  43. package/build/start-render.js +100 -0
  44. package/build/start-render.js.map +7 -0
  45. package/build/types/api.d.ts +142 -0
  46. package/build/types/global.d.ts +84 -0
  47. package/build/types/navigation.d.ts +28 -0
  48. package/build/types/pages.d.ts +144 -0
  49. package/build/types/sites.d.ts +57 -0
  50. package/build/types/templates.d.ts +8 -0
  51. package/build/upload-search-content.js +74 -0
  52. package/build/upload-search-content.js.map +7 -0
  53. package/build/utils/alerts.d.ts +3 -0
  54. package/build/utils/api.d.ts +23 -0
  55. package/build/utils/cache.d.ts +35 -0
  56. package/build/utils/core-utils.d.ts +107 -0
  57. package/build/utils/create-build-data.d.ts +8 -0
  58. package/build/utils/domains.d.ts +13 -0
  59. package/build/utils/folders.d.ts +53 -0
  60. package/build/utils/health-checks.d.ts +7 -0
  61. package/build/utils/images.d.ts +16 -0
  62. package/build/utils/instance.d.ts +21 -0
  63. package/build/utils/loggin.d.ts +51 -0
  64. package/build/utils/pages.d.ts +34 -0
  65. package/build/utils/render.d.ts +13 -0
  66. package/build/utils/searches.d.ts +15 -0
  67. package/build/utils/sites.d.ts +31 -0
  68. package/build/utils/store.d.ts +81 -0
  69. package/cx.config.d.ts +5 -0
  70. package/cx.config.js +36 -0
  71. package/exporter/adapters/gatsby/index.ts +147 -66
  72. package/exporter/adapters/gatsby/utils.ts +161 -0
  73. package/exporter/artifacts/README.md +34 -0
  74. package/exporter/artifacts/index.ts +33 -0
  75. package/exporter/build.sh +38 -4
  76. package/exporter/commands/end-render.ts +69 -73
  77. package/exporter/commands/move-assets.ts +11 -0
  78. package/exporter/commands/prepare-domains-render.ts +31 -144
  79. package/exporter/commands/reset-render.ts +1 -10
  80. package/exporter/commands/start-render.ts +44 -23
  81. package/exporter/commands/upload-search-content.ts +20 -194
  82. package/exporter/constants/envs.ts +55 -57
  83. package/exporter/constants/index.ts +129 -0
  84. package/exporter/{constants/errors.ts → errors/errors-data.ts} +14 -31
  85. package/exporter/{utils/errors.ts → errors/index.ts} +9 -10
  86. package/exporter/index.ts +82 -0
  87. package/{react → exporter/react}/Favicon/index.tsx +7 -1
  88. package/{react → exporter/react}/GriddoIntegrations/index.tsx +14 -6
  89. package/{react → exporter/react}/GriddoIntegrations/utils.ts +9 -4
  90. package/exporter/react/index.tsx +11 -0
  91. package/exporter/registers/api.ts +14 -0
  92. package/exporter/registers/gatsby.ts +14 -0
  93. package/exporter/registers/index.ts +4 -0
  94. package/exporter/services/auth.ts +6 -7
  95. package/exporter/services/domains.ts +16 -0
  96. package/exporter/services/navigation.ts +10 -4
  97. package/exporter/services/reference-fields.ts +23 -8
  98. package/exporter/services/register.ts +113 -0
  99. package/exporter/services/robots.ts +16 -9
  100. package/exporter/services/settings.ts +17 -0
  101. package/exporter/services/sites.ts +24 -35
  102. package/exporter/services/store.ts +78 -120
  103. package/exporter/types/api.ts +27 -24
  104. package/exporter/types/global.ts +10 -7
  105. package/exporter/types/navigation.ts +1 -1
  106. package/exporter/types/pages.ts +3 -2
  107. package/exporter/types/sites.ts +2 -1
  108. package/exporter/utils/alerts.ts +29 -0
  109. package/exporter/utils/api.ts +82 -46
  110. package/exporter/utils/cache.ts +62 -37
  111. package/exporter/utils/core-utils.ts +248 -129
  112. package/exporter/utils/create-build-data.ts +17 -0
  113. package/exporter/utils/domains.ts +7 -10
  114. package/exporter/utils/folders.ts +95 -187
  115. package/exporter/utils/health-checks.ts +64 -0
  116. package/exporter/utils/images.ts +6 -1
  117. package/exporter/utils/instance.ts +12 -9
  118. package/exporter/utils/loggin.ts +91 -32
  119. package/exporter/utils/pages.ts +88 -23
  120. package/exporter/utils/render.ts +48 -149
  121. package/exporter/utils/searches.ts +156 -0
  122. package/exporter/utils/sites.ts +90 -81
  123. package/exporter/utils/store.ts +180 -87
  124. package/gatsby-browser.tsx +58 -41
  125. package/gatsby-config.ts +12 -6
  126. package/gatsby-node.ts +77 -15
  127. package/gatsby-ssr.tsx +1 -2
  128. package/package.json +78 -36
  129. package/src/README.md +7 -0
  130. package/src/components/Head.tsx +46 -13
  131. package/src/components/template.tsx +30 -8
  132. package/src/gatsby-node-utils.ts +2 -91
  133. package/src/html.tsx +11 -2
  134. package/src/types.ts +5 -5
  135. package/start-render.js +7 -0
  136. package/tsconfig.json +3 -5
  137. package/build/adapters/gatsby/actions/clean.js +0 -10
  138. package/build/adapters/gatsby/actions/clean.js.map +0 -1
  139. package/build/adapters/gatsby/actions/close.js +0 -12
  140. package/build/adapters/gatsby/actions/close.js.map +0 -1
  141. package/build/adapters/gatsby/actions/data.js +0 -18
  142. package/build/adapters/gatsby/actions/data.js.map +0 -1
  143. package/build/adapters/gatsby/actions/healthCheck.js +0 -10
  144. package/build/adapters/gatsby/actions/healthCheck.js.map +0 -1
  145. package/build/adapters/gatsby/actions/init.js +0 -9
  146. package/build/adapters/gatsby/actions/init.js.map +0 -1
  147. package/build/adapters/gatsby/actions/meta.js +0 -14
  148. package/build/adapters/gatsby/actions/meta.js.map +0 -1
  149. package/build/adapters/gatsby/actions/prepare.js +0 -9
  150. package/build/adapters/gatsby/actions/prepare.js.map +0 -1
  151. package/build/adapters/gatsby/actions/relocation.js +0 -15
  152. package/build/adapters/gatsby/actions/relocation.js.map +0 -1
  153. package/build/adapters/gatsby/actions/restore.js +0 -26
  154. package/build/adapters/gatsby/actions/restore.js.map +0 -1
  155. package/build/adapters/gatsby/actions/ssg.js +0 -9
  156. package/build/adapters/gatsby/actions/ssg.js.map +0 -1
  157. package/build/adapters/gatsby/actions/sync.js +0 -51
  158. package/build/adapters/gatsby/actions/sync.js.map +0 -1
  159. package/build/adapters/gatsby/index.js +0 -78
  160. package/build/adapters/gatsby/index.js.map +0 -1
  161. package/build/adapters/gatsby/shared/context.js +0 -31
  162. package/build/adapters/gatsby/shared/context.js.map +0 -1
  163. package/build/adapters/gatsby/shared/diff-assets.js +0 -101
  164. package/build/adapters/gatsby/shared/diff-assets.js.map +0 -1
  165. package/build/adapters/gatsby/shared/extract-assets.js +0 -58
  166. package/build/adapters/gatsby/shared/extract-assets.js.map +0 -1
  167. package/build/adapters/gatsby/shared/gatsby-build.js +0 -49
  168. package/build/adapters/gatsby/shared/gatsby-build.js.map +0 -1
  169. package/build/adapters/gatsby/shared/sync-render.js +0 -212
  170. package/build/adapters/gatsby/shared/sync-render.js.map +0 -1
  171. package/build/adapters/gatsby/shared/types.js +0 -3
  172. package/build/adapters/gatsby/shared/types.js.map +0 -1
  173. package/build/commands/end-render.js +0 -88
  174. package/build/commands/end-render.js.map +0 -1
  175. package/build/commands/prepare-assets-directory.js +0 -32
  176. package/build/commands/prepare-assets-directory.js.map +0 -1
  177. package/build/commands/prepare-domains-render.js +0 -133
  178. package/build/commands/prepare-domains-render.js.map +0 -1
  179. package/build/commands/reset-render.js +0 -22
  180. package/build/commands/reset-render.js.map +0 -1
  181. package/build/commands/start-render.js +0 -45
  182. package/build/commands/start-render.js.map +0 -1
  183. package/build/commands/upload-search-content.js +0 -180
  184. package/build/commands/upload-search-content.js.map +0 -1
  185. package/build/constants/endpoints.js +0 -42
  186. package/build/constants/endpoints.js.map +0 -1
  187. package/build/constants/envs.js +0 -68
  188. package/build/constants/envs.js.map +0 -1
  189. package/build/constants/errors.js +0 -87
  190. package/build/constants/errors.js.map +0 -1
  191. package/build/services/auth.js +0 -40
  192. package/build/services/auth.js.map +0 -1
  193. package/build/services/db-class.js +0 -49
  194. package/build/services/db-class.js.map +0 -1
  195. package/build/services/db.js +0 -34
  196. package/build/services/db.js.map +0 -1
  197. package/build/services/navigation.js +0 -96
  198. package/build/services/navigation.js.map +0 -1
  199. package/build/services/reference-fields.js +0 -131
  200. package/build/services/reference-fields.js.map +0 -1
  201. package/build/services/robots.js +0 -60
  202. package/build/services/robots.js.map +0 -1
  203. package/build/services/sites.js +0 -109
  204. package/build/services/sites.js.map +0 -1
  205. package/build/services/store.js +0 -282
  206. package/build/services/store.js.map +0 -1
  207. package/build/types/api.js +0 -3
  208. package/build/types/api.js.map +0 -1
  209. package/build/types/global.js +0 -3
  210. package/build/types/global.js.map +0 -1
  211. package/build/types/navigation.js +0 -3
  212. package/build/types/navigation.js.map +0 -1
  213. package/build/types/pages.js +0 -3
  214. package/build/types/pages.js.map +0 -1
  215. package/build/types/render.js +0 -10
  216. package/build/types/render.js.map +0 -1
  217. package/build/types/sites.js +0 -3
  218. package/build/types/sites.js.map +0 -1
  219. package/build/types/templates.js +0 -3
  220. package/build/types/templates.js.map +0 -1
  221. package/build/utils/api.js +0 -161
  222. package/build/utils/api.js.map +0 -1
  223. package/build/utils/artifacts.js +0 -34
  224. package/build/utils/artifacts.js.map +0 -1
  225. package/build/utils/brush.js +0 -30
  226. package/build/utils/brush.js.map +0 -1
  227. package/build/utils/cache.js +0 -106
  228. package/build/utils/cache.js.map +0 -1
  229. package/build/utils/check-health.js +0 -68
  230. package/build/utils/check-health.js.map +0 -1
  231. package/build/utils/core-utils.js +0 -283
  232. package/build/utils/core-utils.js.map +0 -1
  233. package/build/utils/domains.js +0 -37
  234. package/build/utils/domains.js.map +0 -1
  235. package/build/utils/errors.js +0 -30
  236. package/build/utils/errors.js.map +0 -1
  237. package/build/utils/folders.js +0 -362
  238. package/build/utils/folders.js.map +0 -1
  239. package/build/utils/images.js +0 -45
  240. package/build/utils/images.js.map +0 -1
  241. package/build/utils/instance.js +0 -66
  242. package/build/utils/instance.js.map +0 -1
  243. package/build/utils/loggin.js +0 -108
  244. package/build/utils/loggin.js.map +0 -1
  245. package/build/utils/pages.js +0 -359
  246. package/build/utils/pages.js.map +0 -1
  247. package/build/utils/render.js +0 -144
  248. package/build/utils/render.js.map +0 -1
  249. package/build/utils/sites.js +0 -240
  250. package/build/utils/sites.js.map +0 -1
  251. package/build/utils/store.js +0 -193
  252. package/build/utils/store.js.map +0 -1
  253. package/exporter/adapters/gatsby/actions/clean.ts +0 -14
  254. package/exporter/adapters/gatsby/actions/close.ts +0 -17
  255. package/exporter/adapters/gatsby/actions/data.ts +0 -25
  256. package/exporter/adapters/gatsby/actions/healthCheck.ts +0 -10
  257. package/exporter/adapters/gatsby/actions/init.ts +0 -12
  258. package/exporter/adapters/gatsby/actions/meta.ts +0 -18
  259. package/exporter/adapters/gatsby/actions/prepare.ts +0 -9
  260. package/exporter/adapters/gatsby/actions/relocation.ts +0 -15
  261. package/exporter/adapters/gatsby/actions/restore.ts +0 -36
  262. package/exporter/adapters/gatsby/actions/ssg.ts +0 -12
  263. package/exporter/adapters/gatsby/actions/sync.ts +0 -71
  264. package/exporter/adapters/gatsby/shared/context.ts +0 -50
  265. package/exporter/adapters/gatsby/shared/diff-assets.ts +0 -113
  266. package/exporter/adapters/gatsby/shared/extract-assets.ts +0 -61
  267. package/exporter/adapters/gatsby/shared/gatsby-build.ts +0 -54
  268. package/exporter/adapters/gatsby/shared/sync-render.ts +0 -277
  269. package/exporter/adapters/gatsby/shared/types.ts +0 -35
  270. package/exporter/build-esbuild.noop +0 -42
  271. package/exporter/commands/prepare-assets-directory.ts +0 -33
  272. package/exporter/services/db-class.ts +0 -54
  273. package/exporter/services/db.ts +0 -32
  274. package/exporter/types/render.ts +0 -59
  275. package/exporter/utils/artifacts.ts +0 -34
  276. package/exporter/utils/brush.ts +0 -34
  277. package/exporter/utils/check-health.ts +0 -79
  278. package/plugins/gatsby-plugin-svgr-loader/gatsby-node.js +0 -55
  279. package/plugins/gatsby-plugin-svgr-loader/package.json +0 -8
  280. /package/{react → exporter/react}/Favicon/utils.ts +0 -0
package/README.md CHANGED
@@ -1,47 +1,246 @@
1
- # Proceso de renderizado de Griddo con incremental builds.
1
+ # Griddo CX
2
2
 
3
- Este documento describe el flujo de trabajo del renderizado en Griddo, centrándose en el proceso genérico y el incremental build.
3
+ Griddo CX es un package dentro del monorepo de Griddo (`packages/griddo-cx`) que se encarga de ofrecer herramientas para orquestar el render de una instancia utilizando la biblioteca de componentes, un framework SSG y los datos obtenidos de la API privada de Griddo.
4
4
 
5
- ## 1. Flujo del render genérico
5
+ # Arquitectura
6
6
 
7
- El proceso de renderizado comienza cuando la **infra** detecta que es necesario un nuevo render y activa el flujo/orquestación. A continuación, se detallan las fases principales.
7
+ CX está escrito como una biblioteca en TypeScript. \**Los consumidores de la misma son el *Adapter, el framework SSG y una serie de scripts en TypeScript que viven en el propio `package/griddo-cx` y que son utilizados por infra, normalmente invocados mediante un `npm run ...`
8
8
 
9
- ### 1. `prepare-renders-domain`
9
+ \*Para los casos del Adapter y los “scripts para infra”, estos utilizarán directamente el código Typescript de la biblioteca de CX. Para el caso del SSG, este utilizará el código bundlelizado disponible en `@griddo/cx` y `griddo/cx/react`
10
10
 
11
- La **infra** llama a `npm run prepare-renders-domain` para iniciar esta fase.
11
+ Como ejemplo aquí vemos un snippet dentro de Gatsby (actual framework SSG) importando un componente `<GriddoIntegrations>` que forma parte de la biblioteca de CX, en concreto del export de react.
12
12
 
13
- 1. Se crea el archivo `<ROOT>/.cx-cache/db.json`, que actúa como base de datos para almacenar meta-datos relevantes del render, como dominios, modos de render, hashes, etc. La carpeta `.cx-cache` también que se ha creado en este paso también guardará archivos de caché de Gatsby y CX. Es "la carpeta de caché de CX".
14
- 2. Se genera el archivo `<CX-PACKAGE>/domains.json` con la lista de dominios a renderizar (por ejemplo, `["pro-griddo", "pre-griddo"]`), ordenados, en principio, de menor a mayor por la cantidad de páginas. Esto se podría deprecar y usar exclusivamente el archivo `db.json` que contiene entre otras cosas la lista de dominios ordenados por el mismo criterio.
13
+ ```tsx
14
+ // src/components/template.tsx
15
+ import { GriddoIntegrations } from "@griddo/cx/react";
16
+ ```
15
17
 
16
- ### 2. `start-render` (bucle por dominios)
18
+ ## Exports
17
19
 
18
- La **infra** ejecuta `npm run start-render <domain-name>` para cada dominio (los del `domains.json`)
20
+ CX tiene dos exports separados: **main y react**.
19
21
 
20
- 1. Se realiza un **`check-health`**. Si algo falla, el render se aborta.
21
- 2. Si el `check-health` es exitoso, comienza el render con sus fases correspondientes: **restore**, **data**, **ssg**, **archive**, etc.
22
- 3. Si el render falla, se aborta el proceso e **infra** llama a `npm run reset-render`.
23
- 4. Si el render finaliza correctamente, **infra** comienza a subir los archivos del render a S3.
22
+ - **main** se exporta en `@griddo/cx` . Es código que se ejecuta en un entorno nodejs.
23
+ - **react** se exporta en `@griddo-cx/react` . Es código React :)
24
24
 
25
- ### 3. `end-render` (bucle por dominios)
25
+ **Ejemplo de import**
26
26
 
27
- 1. Cuando la subida a S3 ha terminado, **infra** llama a `npm run end-render <domain-name>` para notificar el nuevo estado de las páginas.
27
+ ```tsx
28
+ // React import
29
+ import { GriddoIntegrations } from "@griddo/cx/react";
30
+ // Core import
31
+ import {
32
+ IS_COMPONENT_LIBRARY,
33
+ PROJECT_ALIASES,
34
+ resolveComponentsPath,
35
+ } from "@griddo/cx";
36
+ ```
28
37
 
29
- ### `upload-search-content`
38
+ ## Bundle
30
39
 
31
- Este script sube contenido a la base de datos a través de una llamada `POST` a la API. Si la variable de entorno correspondiente no está activada, el script no hace nada.
40
+ El bundle del código TypeScript se genera con [esbuild](https://esbuild.github.io/). Compilando el código a CommonJS junto con las definiciones de tipos.
32
41
 
33
- Aunque este script funciona de manera independiente, necesita que se haya realizado un render previo para tener contenido que subir. Además, si están activados, también invoca a los **embeddings**.
42
+ Se puede ejecutar el bundle de todo CX con `yarn run build` desde `packages/griddo-cx` . Esto creará los distintos exports: _node_, _react_ y también los scripts para _infra_: reset-render, build-complete y upload-search-content junto con los archivos de definición de tipos.
34
43
 
35
- ---
44
+ Este comando, `yarn run build` se ejecuta en el despliegue del monorepo, npm prepare, etc. No es necesario que manualmente hagamos un build para los despliegues.
36
45
 
37
- ## 2. Flujo del render incremental
46
+ # Features
38
47
 
39
- Las fases del render incremental son las mismas que las del flujo genérico: `repare-domains-render`, `start-render`, `reset-render`/`end-render` y `upload-search-content`.
48
+ ## Archivo de configuración
40
49
 
41
- Cuando una orden de render llega a CX, `prepare-domains-render` evalúa todos los dominios de la instancia para determinar su `RenderMode` (nueva feature). Esta nueva función permite saber si un dominio tiene o no tiene cambios, si es la primera vez que se renderiza, etc.
50
+ CX tiene un archivo de configuración en el raíz del package `griddo-cx/cx.config.js` donde se establecen ciertos valores globales para todo el package.
42
51
 
43
- Estos son los nuevos `RenderModes` que el proceso de render ( `start-render` ) va a utilizar creando un render desde cero, uno de tipo incremental o directamente ignorando el render del dominio.
52
+ Los siguientes puntos están incluidos en el archivo de configuración y deben ser leídos de este, evitando hardcodear o volver a calcularlos en el resto del código.
44
53
 
45
- - **`FROM_SCRATCH`**: Indica que el dominio debe ser renderizado desde cero, incluyendo todas las páginas publicadas y pendientes de publicar. Esto puede ocurrir en el primer render de una máquina, cuando se ha subido código a la instancia o si hubo un error en un render anterior.
46
- - **`INCREMENTAL`**: (CAMBIOS GRANDES EN EL CÓDIGO DE CX) Indica que el dominio ya tiene un render previo. El nuevo render incluirá solo las páginas que necesitan ser renderizadas o eliminadas. Posteriormente, CX realizará una **sincronización** con el resultado del nuevo render y lo que ya existía del anterior. Este apartado es el que tiene el 90% del refactor en cuanto al incremental ya que la sincronización que hace Gatsby de los renders se ha delegado al 100% a CX y hay algo de "reverse engineering" de cómo funciona Gatsby por dentro en cuanto a los page-data, etc.
47
- - **`IDLE`**: El dominio no presenta ningún tipo de cambio y se ignora por completo. En este caso, no se ejecutan **`end-render`**, **`upload-search-content`**, ni otras fases.
54
+ ```jsx
55
+ const config = {
56
+ proDomain: "pro-", // Prefijo para los dominios "pro"
57
+ griddoVersion, // Versión de griddo obtenida del package.json
58
+ buildReportFileName: "build-report.json", // Archivo de reporte de render
59
+ // función que resuelve la ruta absoluta a los placeholders
60
+ paths: (domain) => ({
61
+ __cache: path.join(CX_CACHE_DIR, domain || ""),
62
+ __components: COMPONENTS_DIR,
63
+ __cx: CX_ROOT_DIR,
64
+ __exports: path.join(EXPORTS_DIR, domain || ""),
65
+ __root: REPO_ROOT_DIR,
66
+ __ssg: SSG_DIR,
67
+ }),
68
+ };
69
+ ```
70
+
71
+ El contenido del archivo de configuración se leerá con la función `getConfig()` donde sea que necesitemos acceder a la misma.
72
+
73
+ **Ejemplo**
74
+
75
+ ```tsx
76
+ const config = getConfig()
77
+ const { proDomain, ... } = config
78
+ ```
79
+
80
+ ### Dominio \*pro-\*\*
81
+
82
+ En los renders de Griddo se diferencia cuando el render es de un dominio de producción, esto es que el dominio interno empieza por `pro-` , por ejemplo `pro-griddo`
83
+
84
+ Este `pro-` se especifica directamente y una sola vez en el archivo de configuración.
85
+
86
+ ### Versión de Griddo
87
+
88
+ Si es necesario obtener la versión de CX la podemos tomar directamente del archivo de configuración
89
+
90
+ ### Sistema de paths interno
91
+
92
+ Mediante el archivo de configuración se establecen unas rutas absolutas globales a todo CX e instancia (ya sea instancia interna del monorepo o la de un cliente) que nos ayudará a orquestar los artefactos durante los LifeCycles de un render. Un uso parecido a los `__dirname` o `__filename` de javascript CommonJS.
93
+
94
+ **Rutas con el dominio actual concatenado**
95
+
96
+ Ya que la mayoría de las veces el uso de estas rutas son durante el render de un dominio, la ruta incluirá el dominio para así hacer operaciones más fácilmente sin tener que estar adjuntándolo (concat) constantemente. Esto es así para los placeholders `__exports` y `__cache` . Para ello a `paths()` hay que pasarle el dominio como único argumento cuando obtengamos las rutas con `config.paths()`
97
+
98
+ **Ejemplo**
99
+
100
+ ```tsx
101
+ const { __exports, __cache } = getConfig().paths("mi-dominio");
102
+ console.log(__exports); // ...export/sites/**mi-dominio**
103
+ console.log(__cache); // ...griddo-cx/.cx-cache/**mi-dominio**
104
+ ```
105
+
106
+ Esta son las rutas existentes.
107
+
108
+ - `__cx` La ruta absoluta del package de CX
109
+ - `__ssg` La ruta absoluta del SGG configurado
110
+ - `__exports` La ruta donde se aloja el render final
111
+ - `__cache` La ruta del caché de CX, donde se guardan artefactos entre renders
112
+ - `__components` La ruta de la instancia. En el monorepo la de `griddo-components`
113
+ - `__root` El directorio raíz siempre, en el monorepo y en la instancia. (uso residual)
114
+
115
+ **Ejemplo de uso real**
116
+
117
+ ```tsx
118
+ import { getConfig } from "./utils/config";
119
+
120
+ // Sin dominio
121
+ const config = await getConfig();
122
+ const { __cx, __ssg } = config.paths();
123
+ const storeDir = path.join(__cx, "store");
124
+ const templateFile = path.join(__ssg, "src/components/template.tsx");
125
+
126
+ // Con dominio
127
+ const { __cache } = config.paths("pre-griddo");
128
+ console.log(__exports); // /griddo/packages/griddo-cx/.cx-cache/**pre-griddo**
129
+ ```
130
+
131
+ ## LifeCycles
132
+
133
+ Los LifeCycles se utilizan dentro del contexto de un _Adapter_. Se usa a través de la función `doLifeCycle` que ejecuta un batch de funciones (`actions`) de forma secuencial. Informando por consola del inicio, fin y tiempo invertido en ejecutar todas las funciones del `actions`, manejando cualquier error en las mismas. En caso de error, es posible indicar un número de _attempts_ que hará que se ejecute de nuevo el clico de vida las veces indicadas.
134
+
135
+ En CX existen estos LifeCycles: `Prepare`, `Restore`, `Data`, `SSG`, `Relocation`, `Meta`, `Archive`, `Clean`, `HealthCheck` y uno de `__DEBUG__` internamente son iguales (usan `doLifeCycle`) y se utilizan estos distintos nombres para identificarlos dentro de un render, poner distintos _attempts_, etc..
136
+
137
+ **Ejemplo:**
138
+
139
+ ```tsx
140
+ await doLifeCycle({
141
+ name: "SSG",
142
+ attempts: 2, // intentará hacer **todos** las actions dos veces si hay un error en alguno de ellos
143
+ actions: [func1, func2, func3],
144
+ });
145
+ ```
146
+
147
+ # Scripts para infra.
148
+
149
+ Como hemos visto uno de los consumidores de CX son scripts “individuales” que están alojados en `griddo-cx/src/scripts` Estos scripts son siempre llamados por infra, o por el desarrollador cuando se hacen render en local.
150
+
151
+ ## `start-render`
152
+
153
+ CX es una biblioteca por lo tanto no tiene nada ejecutable como tal, no hay un entry point desde el punto de vista del _package_. En el package.json existe un binario `griddo-cx` que usa infra/API para ejecutar un render, este binario apunta a `griddo-cx/start-rener.js` con el que se desencadena el proceso de publicación.
154
+
155
+ ## `reset-render`
156
+
157
+ Lo ejecuta infra mediante `yarn run reset-render` . Este resetea la API en caso de que un render salga mal. De esa manera la API al ser preguntada volverá a comunicar que hay un render pendiente y comenzará con ello de nuevo.
158
+
159
+ Si no se llamase correctamente al script, la API se quedaría esperando a que finalice el render “eternamente”. Hay un time-out de X horas.
160
+
161
+ ## `build-complete`
162
+
163
+ Lo ejecuta infra mediante `yarn run build-complete` cuando un render acaba de manera exitosa y el contenido ha sido subido al servidor, es decir, cuando se ha completado **una publicación**. Este script envía a la API información del render y le comunica que este ha terminado y que está disponible para un rrnuevo render.
164
+
165
+ ## `upload-search-content`
166
+
167
+ Lo ejecuta infra mediante `yarn run upload-search-content` cuando un render ha acabado o con cierta frecuencia. Sube contenido de los estáticos del render a un endpoint para el uso en buscadores.
168
+
169
+ # Adapter
170
+
171
+ Un Adapter es una función que se ejecuta en el script `start-render.js` que es el que se triggea cuando API avisa de un nuevo render. Los Adapters están en el directorio `griddo-cx/exporter/adapters`
172
+
173
+ El Adapter es el responsable de manejar el proceso de render mediante las utilidades de la biblioteca. En el proceso puede hacer lo que estime oportuno salvando ciertas obligaciones para que un render sea Griddo-compliant.
174
+
175
+ <aside>
176
+ 💡 Los Adapters utilizarán el código TypeScript de CX, no el bundlelizado. Ya que el propio adapter también se bundleliza.
177
+
178
+ </aside>
179
+
180
+ ### **Obligaciones de un Adapter**
181
+
182
+ **Exports**
183
+
184
+ **Dist**
185
+
186
+ Dejar una carpeta con los archivos estáticos finales en el path `__exports` , que es una carpeta `exports/sites/<dominio>/dist` donde `dominio` es cada dominio de la instancia de Griddo. Una vez terminado el render, _infra_ tomará esa carpeta y la subirá. Infra la sube mediante sincronización por lo que siempre tiene que estar actualizada y con la totalidad de los datos. Si en la carpeta destino hay un archivo que no existe en la carpeta fuente `exports/sites/<dominio>/dist` se borrará.
187
+
188
+ **Assets**
189
+
190
+ Igualmente dejar una carpeta con los “assets” de javascript. Esto es verdad en el mundo Gatsby no sabremos qué pasará con otros frameworks.
191
+
192
+ **Caches**
193
+
194
+ El adapter deberá manejar manualmente la caché de Griddo utilizando las funciones `moveDirsSync`, `copyDirsSync` y `removeDirsSync`.
195
+
196
+ La caché de Griddo son dos directorios que se crean en `griddo-cx` por cada render y dominio: `store` y `apiCache` . Para facilitar el trabajo CX cuenta con placeholders para las rutas, en este caso `__cache` que haría referencia `griddo-cx/.cx-cache/<domain>`
197
+
198
+ ```tsx
199
+ griddo-cx
200
+ |-.cx-cache
201
+ |- store
202
+ |- apiCache
203
+ ```
204
+
205
+ ¿Cómo se maneja la caché? ¿Qué hago con ella?
206
+
207
+ Los datos de la caché se generan de forma automática en `griddo-cx`El manejo se basa en _restaurar (Restore)_, _archivar_ (Arhive) o _invalidar (Clean)_ los directorios de la caché, tanto `store` como `apiCache`
208
+
209
+ **Restaurando la caché**
210
+
211
+ Cuando se inicia un render debemos mover tanto `store` como `apiCache` que estarán dentro de `griddo-cx/.rendrr-cache/<dominio>` al raíz de CX `griddo-cx` para que el proceso de render haga uso de las mismas.
212
+
213
+ **Archivando la caché**
214
+
215
+ Cuando el render de un dominio termina correctamente, se deben mover las carpetas `store` y `apiCache` a la carpeta de caches `griddo-cx/.cx-cache/<domain>` para poder restaurarlas en un próximo render.
216
+
217
+ **Invalidando la caché**
218
+
219
+ Si un render ha dado error pueden quedarse en el raíz de CX las carpetas `store` y `apiCache`. **Estas deben ser borradas** antes de la nueva fase de restauración. De hecho probablemente no exista nada que restaurar porque el render dio error. En ese caso lo que ocurre es que efectivamente no hay nada que restaurar y habrá que descargarse de nuevo todos los datos.
220
+
221
+ A su vez, en cada despliegue que exista en la instancia también se borrarán ya que de alguna manera se alojan en lo que sería el `node_modules` de la instancia. Y se borrará CX enteramente.
222
+
223
+ <aside>
224
+ 💡 Coming soon: Gestión automática de la caché de Griddo (no de los frameworks SSGS)
225
+
226
+ </aside>
227
+
228
+ # Logs
229
+
230
+
231
+
232
+ # Errores
233
+
234
+
235
+
236
+ # Testing
237
+
238
+
239
+
240
+ # FAQ’s
241
+
242
+ ### ¿Griddo procesa imágenes en tiempo de render?
243
+
244
+ No, los proyectos actuales de Griddo se apoyan en imágenes alojadas en remoto, en concreto en un servicio externo “DAM” propiedad de Secuoyas. Este servicio ofrece las transformaciones necesarias. Existen un componente de React en Griddo `<GriddoImage>` que las instancias pueden utilizar y que se integra con el “DAM”.
245
+
246
+ Algunas de las primeras instancias utilizan la misma estrategia con cloudinary, usando un componente de React proporcionado también por Griddo: `<CloudinaryImage>`
@@ -0,0 +1,4 @@
1
+ /**
2
+ * Render every instance domain with the Gatsby adapter.
3
+ */
4
+ export declare function renderDomainsWithGatsbyAdapter(domain: string): Promise<void>;
@@ -0,0 +1,22 @@
1
+ /**
2
+ * Return the assetPrefix with the domain concatenated `assetPrefix/domain` only
3
+ * if the domain is "pro-" **and** there is a env `GRIDDO_ASSET_PREFIX` with any
4
+ * value different from `null`, `undefined` or `empty string`
5
+ *
6
+ * else...
7
+ * - If assetPrefix or domain is falsy, returns ""
8
+ * - If the domain is not "pro-", returns ""
9
+ */
10
+ declare function getGatsbyAssetPrefixWithDomain(domain: string): string;
11
+ /**
12
+ * Spawn a new node process `yarn gatsby-build`
13
+ * @note This proccess (`yarn gatsby-build`) can not access to the custom Griddo
14
+ * `process.env` so it needs variables passed to it via the `env` prop.
15
+ */
16
+ declare function runGatsbyBuildCommand(assetPrefixWithDomain: string): void;
17
+ /**
18
+ * Update the Griddo's `/dist` dir with the contents from `public` dir only
19
+ * with files of type: js, json and css.
20
+ */
21
+ declare function createDistFromGatsbyPublic(domain: string, needsAssetPrefix: boolean): Promise<void>;
22
+ export { createDistFromGatsbyPublic, getGatsbyAssetPrefixWithDomain, runGatsbyBuildCommand, };
@@ -0,0 +1,6 @@
1
+ import type { Artifacts } from "../types/global";
2
+ /**
3
+ * Returns the artifacts of CX.
4
+ */
5
+ declare function getCxArtifacts(domain: string): Artifacts;
6
+ export default getCxArtifacts;
@@ -0,0 +1,2 @@
1
+ #!/usr/bin/env node
2
+ export {};
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,2 @@
1
+ #!/usr/bin/env node
2
+ export {};
@@ -0,0 +1,2 @@
1
+ #!/usr/bin/env node
2
+ export {};
@@ -0,0 +1,2 @@
1
+ #!/usr/bin/env node
2
+ export {};
@@ -0,0 +1,19 @@
1
+ declare const AI_EMBEDDINGS: string;
2
+ declare const ALERT: string;
3
+ declare const DOMAINS: string;
4
+ declare const GET_ALL: string;
5
+ declare const GET_PAGE: string;
6
+ declare const LOGIN: string;
7
+ declare const RESET_RENDER: string;
8
+ declare const ROBOTS: string;
9
+ declare const SEARCH: string;
10
+ declare const SETTINGS: string;
11
+ declare const BUILD_END: string[];
12
+ declare const BUILD_START: string[];
13
+ declare const GET_PAGES: string[];
14
+ declare const GET_REFERENCE_FIELD_DATA: string[];
15
+ declare const GET_SITEMAP: string[];
16
+ declare const INFO: string[];
17
+ declare const LANGUAGES: string[];
18
+ declare const SOCIALS: string[];
19
+ export { AI_EMBEDDINGS, ALERT, BUILD_END, BUILD_START, DOMAINS, GET_ALL, GET_PAGE, GET_PAGES, GET_REFERENCE_FIELD_DATA, GET_SITEMAP, INFO, LANGUAGES, LOGIN, RESET_RENDER, ROBOTS, SEARCH, SETTINGS, SOCIALS, };
@@ -0,0 +1,37 @@
1
+ /**
2
+ * Here are all the environment variables that the CX code uses.
3
+ */
4
+ declare const GRIDDO_API_URL: string | undefined;
5
+ declare const GRIDDO_PUBLIC_API_URL: string | undefined;
6
+ declare const GRIDDO_BOT_USER: string | undefined;
7
+ declare const GRIDDO_BOT_PASSWORD: string | undefined;
8
+ declare const GRIDDO_API_CONCURRENCY_COUNT: number;
9
+ declare const GRIDDO_RENDER_ALL_SITES: boolean;
10
+ declare const GRIDDO_RENDER_SITE: number;
11
+ declare const GRIDDO_RENDER_PAGES: number[];
12
+ declare const GRIDDO_SKIP_BUILD_CHECKS: boolean;
13
+ declare const GRIDDO_DEBUG_LOGS: boolean;
14
+ declare const GRIDDO_BUILD_LOGS: boolean;
15
+ declare const GRIDDO_RENDER_BREAKPOINTS_FEATURE: boolean;
16
+ declare const GRIDDO_SSG_VERBOSE_LOGS: boolean;
17
+ declare const GRIDDO_SEARCH_FEATURE: boolean;
18
+ declare const GRIDDO_ASSET_PREFIX: string | undefined;
19
+ declare const GRIDDO_REACT_APP_INSTANCE: string | undefined;
20
+ declare const GRIDDO_AI_EMBEDDINGS: boolean;
21
+ declare const GRIDDO_VERBOSE_LOGS: boolean;
22
+ declare const GRIDDO_ALERT_FEATURE: boolean;
23
+ declare const GRIDDO_API_MAX_RESPONSE_SIZE: number;
24
+ declare const GRIDDO_SSG_MAX_PAGE_SIZE: number;
25
+ declare const GRIDDO_INIT_LIFECYCLE_MAX_ATTEMPTS: number;
26
+ declare const GRIDDO_CLEAN_LIFECYCLE_MAX_ATTEMPTS: number;
27
+ declare const GRIDDO_CLOSE_LIFECYCLE_MAX_ATTEMPTS: number;
28
+ declare const GRIDDO_PREPARE_LIFECYCLE_MAX_ATTEMPTS: number;
29
+ declare const GRIDDO_RESTORE_LIFECYCLE_MAX_ATTEMPTS: number;
30
+ declare const GRIDDO_DATA_LIFECYCLE_MAX_ATTEMPTS: number;
31
+ declare const GRIDDO_SSG_LIFECYCLE_MAX_ATTEMPTS: number;
32
+ declare const GRIDDO_RELOCATION_LIFECYCLE_MAX_ATTEMPTS: number;
33
+ declare const GRIDDO_META_LIFECYCLE_MAX_ATTEMPTS: number;
34
+ declare const GRIDDO_ARCHIVE_LIFECYCLE_MAX_ATTEMPTS: number;
35
+ declare const GRIDDO_FIXTURES_DOMAIN_NAMES: string | undefined;
36
+ declare const GRIDDO_FIXTURES_SITE_NAMES: string | undefined;
37
+ 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, };
@@ -0,0 +1,57 @@
1
+ import type { LifeCyclesNames } from "../types/global";
2
+ declare const endpoints: {
3
+ ALERT: string;
4
+ AI_EMBEDDINGS: string;
5
+ BUILD_END: string[];
6
+ BUILD_START: string[];
7
+ DOMAINS: string;
8
+ GET_ALL: string;
9
+ GET_PAGE: string;
10
+ GET_PAGES: string[];
11
+ GET_REFERENCE_FIELD_DATA: string[];
12
+ GET_SITEMAP: string[];
13
+ INFO: string[];
14
+ LANGUAGES: string[];
15
+ LOGIN: string;
16
+ RESET_RENDER: string;
17
+ ROBOTS: string;
18
+ SEARCH: string;
19
+ SETTINGS: string;
20
+ SOCIALS: string[];
21
+ };
22
+ declare const envs: {
23
+ GRIDDO_AI_EMBEDDINGS: boolean;
24
+ GRIDDO_ALERT_FEATURE: boolean;
25
+ GRIDDO_API_CONCURRENCY_COUNT: number;
26
+ GRIDDO_API_MAX_RESPONSE_SIZE: number;
27
+ GRIDDO_API_URL: string | undefined;
28
+ GRIDDO_ARCHIVE_LIFECYCLE_MAX_ATTEMPTS: number;
29
+ GRIDDO_ASSET_PREFIX: string | undefined;
30
+ GRIDDO_BOT_PASSWORD: string | undefined;
31
+ GRIDDO_BOT_USER: string | undefined;
32
+ GRIDDO_BUILD_LOGS: boolean;
33
+ GRIDDO_CLEAN_LIFECYCLE_MAX_ATTEMPTS: number;
34
+ GRIDDO_CLOSE_LIFECYCLE_MAX_ATTEMPTS: number;
35
+ GRIDDO_DATA_LIFECYCLE_MAX_ATTEMPTS: number;
36
+ GRIDDO_DEBUG_LOGS: boolean;
37
+ GRIDDO_FIXTURES_DOMAIN_NAMES: string | undefined;
38
+ GRIDDO_FIXTURES_SITE_NAMES: string | undefined;
39
+ GRIDDO_META_LIFECYCLE_MAX_ATTEMPTS: number;
40
+ GRIDDO_PREPARE_LIFECYCLE_MAX_ATTEMPTS: number;
41
+ GRIDDO_PUBLIC_API_URL: string | undefined;
42
+ GRIDDO_REACT_APP_INSTANCE: string | undefined;
43
+ GRIDDO_RELOCATION_LIFECYCLE_MAX_ATTEMPTS: number;
44
+ GRIDDO_RENDER_ALL_SITES: boolean;
45
+ GRIDDO_RENDER_BREAKPOINTS_FEATURE: boolean;
46
+ GRIDDO_RENDER_PAGES: number[];
47
+ GRIDDO_RENDER_SITE: number;
48
+ GRIDDO_RESTORE_LIFECYCLE_MAX_ATTEMPTS: number;
49
+ GRIDDO_SEARCH_FEATURE: boolean;
50
+ GRIDDO_SKIP_BUILD_CHECKS: boolean;
51
+ GRIDDO_SSG_LIFECYCLE_MAX_ATTEMPTS: number;
52
+ GRIDDO_SSG_MAX_PAGE_SIZE: number;
53
+ GRIDDO_SSG_VERBOSE_LOGS: boolean;
54
+ GRIDDO_VERBOSE_LOGS: boolean;
55
+ };
56
+ declare const lifeCycleNames: Record<LifeCyclesNames, LifeCyclesNames>;
57
+ export { endpoints, envs, lifeCycleNames };