@hostwebhook/node-types 1.78.0 → 1.79.0

package/dist/esm/registry.js

@@ -5,6 +5,40 @@
  * all per-node maps (colors, URLs, Redux keys, palette, delete, etc.)
  * from this registry. No more 18+ touch points.
  */
+/**
+ * Lo que un Firecrawl v1 entiende: exactamente lo que su entidad guardaba el
+ * día que apareció la v2, sin la identidad ni la topología. `formats`,
+ * `waitFor`, `includeTags`, `excludeTags`, `extractSchema` y `extractPrompt`
+ * ya existían en la entidad aunque la página no los enseñara: son de la v1.
+ */
+const FIRECRAWL_V1_FIELDS = [
+    "mode",
+    "credentialId",
+    "url",
+    "formats",
+    "onlyMainContent",
+    "waitFor",
+    "timeout",
+    "mobile",
+    "blockAds",
+    "includeTags",
+    "excludeTags",
+    "maxDepth",
+    "maxPages",
+    "includePaths",
+    "excludePaths",
+    "allowExternalLinks",
+    "crawlTimeout",
+    "query",
+    "searchLimit",
+    "sources",
+    "country",
+    "includeSubdomains",
+    "mapLimit",
+    "extractSchema",
+    "extractPrompt",
+    "triggerOn",
+];
 export const NODE_REGISTRY = {
     // ── Sources ──
     webhook: {
@@ -457,6 +491,35 @@ export const NODE_REGISTRY = {
         allStateKey: "allFirecrawlActions",
         color: "#f97316",
         testable: true,
+        /* [2026-09-12] El primer tipo que versiona (ADR-0002). Los dos llaman a
+           la API v2 de Firecrawl; lo que cambia es qué se puede CONFIGURAR:
+           la v2 del nodo expone los formatos (markdown · html · rawHtml · links ·
+           images · summary · screenshot · json), la extracción estructurada como
+           formato `json` de verdad, `waitFor`, las etiquetas, la limpieza por IA,
+           la localización y el control de la caché. La v1 sigue corriendo tal
+           cual para los nodos que ya existen —sin `nodeVersion` se lee 1—.
+    
+           `fields` son los campos de configuración que cada versión entiende: es
+           lo que se conserva o se pierde al cambiar de versión (`fieldsLost`), y
+           por eso ni `name`, ni `inputNodes`, ni `outputNodes`, ni `isActive`
+           van aquí. Los cuatro que la v2 añade son los que se pierden al volver a
+           la v1. */
+        versions: [
+            {
+                v: 2,
+                status: "current",
+                label: "Formats, JSON extraction, location & cache",
+                note: "Choose which formats come back, extract JSON with a schema, wait for the page, pick a location and control Firecrawl's cache.",
+                fields: [...FIRECRAWL_V1_FIELDS, "onlyCleanContent", "removeBase64Images", "location", "maxAge"],
+            },
+            {
+                v: 1,
+                status: "legacy",
+                label: "Original",
+                note: "Markdown only, no format selector. Kept so existing nodes keep running unchanged.",
+                fields: FIRECRAWL_V1_FIELDS,
+            },
+        ],
     },
     mailchimpAction: {
         type: "mailchimpAction",

package/dist/registry.js

@@ -16,6 +16,40 @@ exports.currentVersion = currentVersion;
 exports.fieldsLostBetween = fieldsLostBetween;
 exports.fieldsLost = fieldsLost;
 exports.versionCatalogErrors = versionCatalogErrors;
+/**
+ * Lo que un Firecrawl v1 entiende: exactamente lo que su entidad guardaba el
+ * día que apareció la v2, sin la identidad ni la topología. `formats`,
+ * `waitFor`, `includeTags`, `excludeTags`, `extractSchema` y `extractPrompt`
+ * ya existían en la entidad aunque la página no los enseñara: son de la v1.
+ */
+const FIRECRAWL_V1_FIELDS = [
+    "mode",
+    "credentialId",
+    "url",
+    "formats",
+    "onlyMainContent",
+    "waitFor",
+    "timeout",
+    "mobile",
+    "blockAds",
+    "includeTags",
+    "excludeTags",
+    "maxDepth",
+    "maxPages",
+    "includePaths",
+    "excludePaths",
+    "allowExternalLinks",
+    "crawlTimeout",
+    "query",
+    "searchLimit",
+    "sources",
+    "country",
+    "includeSubdomains",
+    "mapLimit",
+    "extractSchema",
+    "extractPrompt",
+    "triggerOn",
+];
 exports.NODE_REGISTRY = {
     // ── Sources ──
     webhook: {
@@ -468,6 +502,35 @@ exports.NODE_REGISTRY = {
         allStateKey: "allFirecrawlActions",
         color: "#f97316",
         testable: true,
+        /* [2026-09-12] El primer tipo que versiona (ADR-0002). Los dos llaman a
+           la API v2 de Firecrawl; lo que cambia es qué se puede CONFIGURAR:
+           la v2 del nodo expone los formatos (markdown · html · rawHtml · links ·
+           images · summary · screenshot · json), la extracción estructurada como
+           formato `json` de verdad, `waitFor`, las etiquetas, la limpieza por IA,
+           la localización y el control de la caché. La v1 sigue corriendo tal
+           cual para los nodos que ya existen —sin `nodeVersion` se lee 1—.
+    
+           `fields` son los campos de configuración que cada versión entiende: es
+           lo que se conserva o se pierde al cambiar de versión (`fieldsLost`), y
+           por eso ni `name`, ni `inputNodes`, ni `outputNodes`, ni `isActive`
+           van aquí. Los cuatro que la v2 añade son los que se pierden al volver a
+           la v1. */
+        versions: [
+            {
+                v: 2,
+                status: "current",
+                label: "Formats, JSON extraction, location & cache",
+                note: "Choose which formats come back, extract JSON with a schema, wait for the page, pick a location and control Firecrawl's cache.",
+                fields: [...FIRECRAWL_V1_FIELDS, "onlyCleanContent", "removeBase64Images", "location", "maxAge"],
+            },
+            {
+                v: 1,
+                status: "legacy",
+                label: "Original",
+                note: "Markdown only, no format selector. Kept so existing nodes keep running unchanged.",
+                fields: FIRECRAWL_V1_FIELDS,
+            },
+        ],
     },
     mailchimpAction: {
         type: "mailchimpAction",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hostwebhook/node-types",
-  "version": "1.78.0",
+  "version": "1.79.0",
   "description": "Shared node type definitions, connection rules, and dispatch config for HostWebhook",
   "main": "dist/index.js",
   "module": "dist/esm/index.js",