@compilacion/colleciones-clientos 2.0.24 → 2.0.28

package/dist/gtm/Colleciones Client/303/250s Etiqueta.tpl"

@@ -0,0 +1,574 @@
+___INFO___
+
+{
+  "type": "TAG",
+  "id": "cvt_temp_public_id",
+  "version": 1,
+  "securityGroups": [],
+  "displayName": "Colleciones Clientès Etiqueta",
+  "brand": {
+    "id": "brand_compilacion",
+    "displayName": "Compilacion",
+    "thumbnail": "data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4KPHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCA2NCA2NCIgd2lkdGg9IjY0IiBoZWlnaHQ9IjY0Ij4KICA8dGl0bGU+Q29tcG9zdGVsYSBzY2FsbG9wPC90aXRsZT4KICA8cmVjdCB3aWR0aD0iNjQiIGhlaWdodD0iNjQiIHJ4PSIxMCIgZmlsbD0iIzFENEVEOCIvPgogIDxwYXRoIGQ9Ik0zMiA1NCBMNyAyOCBROSAxNCAyMiA4IFEzMiA0IDQyIDggUTU1IDE0IDU3IDI4IFoiCiAgICAgICAgZmlsbD0iI0ZDRDM0RCIgc3Ryb2tlPSIjMUQ0RUQ4IiBzdHJva2Utd2lkdGg9IjIiIHN0cm9rZS1saW5lam9pbj0icm91bmQiLz4KICA8ZyBzdHJva2U9IiMxRDRFRDgiIHN0cm9rZS13aWR0aD0iMiIgc3Ryb2tlLWxpbmVjYXA9InJvdW5kIiBmaWxsPSJub25lIj4KICAgIDxwYXRoIGQ9Ik0zMiA1NCBMMzIgNiIvPgogICAgPHBhdGggZD0iTTMyIDU0IEwyMSA4Ii8+CiAgICA8cGF0aCBkPSJNMzIgNTQgTDQzIDgiLz4KICAgIDxwYXRoIGQ9Ik0zMiA1NCBMMTIgMTciLz4KICAgIDxwYXRoIGQ9Ik0zMiA1NCBMNTIgMTciLz4KICAgIDxwYXRoIGQ9Ik0zMiA1NCBMNyAyOCIvPgogICAgPHBhdGggZD0iTTMyIDU0IEw1NyAyOCIvPgogIDwvZz4KPC9zdmc+Cg=="
+  },
+  "description": "",
+  "containerContexts": [
+    "WEB"
+  ]
+}
+
+
+___TEMPLATE_PARAMETERS___
+
+[
+  {
+    "type": "TEXT",
+    "name": "entity",
+    "displayName": "Entity",
+    "simpleValueType": true,
+    "valueValidators": [
+      {
+        "type": "NON_EMPTY"
+      },
+      {
+        "type": "STRING_LENGTH",
+        "args": [
+          2,
+          100
+        ]
+      }
+    ],
+    "alwaysInSummary": true
+  },
+  {
+    "type": "TEXT",
+    "name": "action",
+    "displayName": "Action",
+    "simpleValueType": true,
+    "alwaysInSummary": true,
+    "valueValidators": [
+      {
+        "type": "NON_EMPTY"
+      },
+      {
+        "type": "STRING_LENGTH",
+        "args": [
+          2,
+          100
+        ]
+      }
+    ]
+  },
+  {
+    "type": "GROUP",
+    "name": "IdentifiersGroup",
+    "displayName": "Identifiers",
+    "groupStyle": "ZIPPY_CLOSED",
+    "subParams": [
+      {
+        "type": "LABEL",
+        "name": "IdentifiersGroupExplaining",
+        "displayName": "This is a list of all possible identifiers for the entity, always a name, what you call the id and the value of the identifier"
+      },
+      {
+        "type": "SIMPLE_TABLE",
+        "name": "identifiers",
+        "displayName": "",
+        "simpleTableColumns": [
+          {
+            "defaultValue": "",
+            "displayName": "Name",
+            "name": "name",
+            "type": "TEXT"
+          },
+          {
+            "defaultValue": "",
+            "displayName": "Value",
+            "name": "value",
+            "type": "TEXT"
+          }
+        ]
+      }
+    ]
+  },
+  {
+    "type": "GROUP",
+    "name": "adjectivesGroup",
+    "displayName": "Adjectives",
+    "groupStyle": "ZIPPY_CLOSED",
+    "subParams": [
+      {
+        "type": "SIMPLE_TABLE",
+        "name": "adjectives",
+        "displayName": "",
+        "simpleTableColumns": [
+          {
+            "defaultValue": "",
+            "displayName": "",
+            "name": "adjective",
+            "type": "TEXT"
+          }
+        ]
+      }
+    ]
+  },
+  {
+    "type": "GROUP",
+    "name": "contextGroup",
+    "displayName": "Context",
+    "groupStyle": "ZIPPY_CLOSED",
+    "subParams": [
+      {
+        "type": "SIMPLE_TABLE",
+        "name": "contexts",
+        "displayName": "",
+        "simpleTableColumns": [
+          {
+            "defaultValue": "",
+            "displayName": "Key",
+            "name": "key",
+            "type": "TEXT"
+          },
+          {
+            "defaultValue": "",
+            "displayName": "Value",
+            "name": "value",
+            "type": "TEXT"
+          }
+        ]
+      }
+    ]
+  },
+  {
+    "type": "GROUP",
+    "name": "actorGroup",
+    "displayName": "Actor",
+    "groupStyle": "ZIPPY_CLOSED",
+    "subParams": [
+      {
+        "type": "TEXT",
+        "name": "actor",
+        "displayName": "Actor",
+        "simpleValueType": true
+      },
+      {
+        "type": "SIMPLE_TABLE",
+        "name": "actorIdentifiers",
+        "displayName": "",
+        "simpleTableColumns": [
+          {
+            "defaultValue": "",
+            "displayName": "Name",
+            "name": "name",
+            "type": "TEXT"
+          },
+          {
+            "defaultValue": "",
+            "displayName": "Value",
+            "name": "value",
+            "type": "TEXT"
+          }
+        ]
+      }
+    ]
+  },
+  {
+    "type": "GROUP",
+    "name": "referencesGroup",
+    "displayName": "References",
+    "groupStyle": "ZIPPY_CLOSED",
+    "subParams": [
+      {
+        "type": "SIMPLE_TABLE",
+        "name": "references",
+        "displayName": "",
+        "simpleTableColumns": [
+          {
+            "defaultValue": "",
+            "displayName": "Entity",
+            "name": "entity",
+            "type": "TEXT"
+          },
+          {
+            "defaultValue": "",
+            "displayName": "identifier (name)",
+            "name": "identifierName",
+            "type": "TEXT"
+          },
+          {
+            "defaultValue": "",
+            "displayName": "Identifier value",
+            "name": "identifierValue",
+            "type": "TEXT"
+          }
+        ]
+      }
+    ]
+  },
+  {
+    "type": "GROUP",
+    "name": "collectionGroup",
+    "displayName": "Collection",
+    "groupStyle": "ZIPPY_CLOSED",
+    "subParams": [
+      {
+        "type": "PARAM_TABLE",
+        "name": "collections",
+        "displayName": "",
+        "paramTableColumns": [
+          {
+            "param": {
+              "type": "SELECT",
+              "name": "collectionVariable",
+              "displayName": "",
+              "macrosInSelect": true,
+              "selectItems": [],
+              "simpleValueType": true
+            },
+            "isUnique": false
+          }
+        ]
+      }
+    ]
+  },
+  {
+    "type": "GROUP",
+    "name": "trackerGroup",
+    "displayName": "Tracker Initialisation",
+    "groupStyle": "ZIPPY_CLOSED",
+    "subParams": [
+      {
+        "type": "SELECT",
+        "name": "trackerConfig",
+        "displayName": "Settings variable",
+        "macrosInSelect": true,
+        "selectItems": [],
+        "simpleValueType": true
+      }
+    ]
+  }
+]
+
+
+___SANDBOXED_JS_FOR_WEB_TEMPLATE___
+
+var callInWindow = require('callInWindow');
+var copyFromWindow = require('copyFromWindow');
+var createQueue = require('createQueue');
+var injectScript = require('injectScript');
+var log = require('logToConsole');
+var setInWindow = require('setInWindow');
+
+var queuePusherName = 'compilacionCollecionesClientosQueuePusher';
+var queueName = 'compilacionCollecionesClientosGtmQueue';
+
+function getQueuePush() {
+  var existing = copyFromWindow(queuePusherName);
+  if (existing) {
+    return existing;
+  }
+
+  log('Creating new queue for', queueName);
+  createQueue(queueName);
+
+  setInWindow(queuePusherName, function () {
+    var args = [];
+    for (var i = 1; i < arguments.length; i++) {
+      args.push(arguments[i]);
+    }
+
+    var queued = {
+      method: arguments[0],
+      arguments: args
+    };
+
+    callInWindow(queueName + '.push', queued);
+    callInWindow('window.compilacionCollecionesClientosGtmFlush', '');
+    log('Queued method call:', queued);
+  });
+
+  return copyFromWindow(queuePusherName);
+}
+
+if (data.trackerConfig.type === "compilacionCollecionesClientosGtmVariable_configuracion") {
+  var cdn = false;
+
+  if (data.trackerConfig.jsLibSource === "SELF") {
+    cdn = data.trackerConfig.jsLibSource_selfHostedUrl;
+  } else if (data.trackerConfig.jsLibSource === "UNPKG") {
+    cdn = "https://unpkg.com/@compilacion/colleciones-clientos@latest/dist/browser.gtm.min.js";
+  }
+  
+  var queuePush = getQueuePush();
+
+  if (cdn) {
+    injectScript(
+      cdn,
+      function () {
+        log('Script loaded. Executing tag.');
+        queuePush('tag', data);
+        data.gtmOnSuccess();
+      },
+      function () {
+        log('Failed to load script:', cdn);
+        data.gtmOnFailure();
+      },
+      'compilacionCollecionesLib'
+    );
+  } else {
+    log('No script URL provided. Falling back to direct queue push.');
+    queuePush('tag', data);
+    data.gtmOnSuccess();
+  }
+
+} else {
+  log('trackerConfig.type mismatch:', data.trackerConfig.type);
+  data.gtmOnFailure();
+}
+
+
+___WEB_PERMISSIONS___
+
+[
+  {
+    "instance": {
+      "key": {
+        "publicId": "logging",
+        "versionId": "1"
+      },
+      "param": [
+        {
+          "key": "environments",
+          "value": {
+            "type": 1,
+            "string": "debug"
+          }
+        }
+      ]
+    },
+    "clientAnnotations": {
+      "isEditedByUser": true
+    },
+    "isRequired": true
+  },
+  {
+    "instance": {
+      "key": {
+        "publicId": "access_globals",
+        "versionId": "1"
+      },
+      "param": [
+        {
+          "key": "keys",
+          "value": {
+            "type": 2,
+            "listItem": [
+              {
+                "type": 3,
+                "mapKey": [
+                  {
+                    "type": 1,
+                    "string": "key"
+                  },
+                  {
+                    "type": 1,
+                    "string": "read"
+                  },
+                  {
+                    "type": 1,
+                    "string": "write"
+                  },
+                  {
+                    "type": 1,
+                    "string": "execute"
+                  }
+                ],
+                "mapValue": [
+                  {
+                    "type": 1,
+                    "string": "compilacionCollecionesClientosQueuePusher"
+                  },
+                  {
+                    "type": 8,
+                    "boolean": true
+                  },
+                  {
+                    "type": 8,
+                    "boolean": true
+                  },
+                  {
+                    "type": 8,
+                    "boolean": true
+                  }
+                ]
+              },
+              {
+                "type": 3,
+                "mapKey": [
+                  {
+                    "type": 1,
+                    "string": "key"
+                  },
+                  {
+                    "type": 1,
+                    "string": "read"
+                  },
+                  {
+                    "type": 1,
+                    "string": "write"
+                  },
+                  {
+                    "type": 1,
+                    "string": "execute"
+                  }
+                ],
+                "mapValue": [
+                  {
+                    "type": 1,
+                    "string": "compilacionCollecionesClientosGtmQueue"
+                  },
+                  {
+                    "type": 8,
+                    "boolean": true
+                  },
+                  {
+                    "type": 8,
+                    "boolean": true
+                  },
+                  {
+                    "type": 8,
+                    "boolean": false
+                  }
+                ]
+              },
+              {
+                "type": 3,
+                "mapKey": [
+                  {
+                    "type": 1,
+                    "string": "key"
+                  },
+                  {
+                    "type": 1,
+                    "string": "read"
+                  },
+                  {
+                    "type": 1,
+                    "string": "write"
+                  },
+                  {
+                    "type": 1,
+                    "string": "execute"
+                  }
+                ],
+                "mapValue": [
+                  {
+                    "type": 1,
+                    "string": "compilacionCollecionesClientosGtmQueue.push"
+                  },
+                  {
+                    "type": 8,
+                    "boolean": false
+                  },
+                  {
+                    "type": 8,
+                    "boolean": false
+                  },
+                  {
+                    "type": 8,
+                    "boolean": true
+                  }
+                ]
+              },
+              {
+                "type": 3,
+                "mapKey": [
+                  {
+                    "type": 1,
+                    "string": "key"
+                  },
+                  {
+                    "type": 1,
+                    "string": "read"
+                  },
+                  {
+                    "type": 1,
+                    "string": "write"
+                  },
+                  {
+                    "type": 1,
+                    "string": "execute"
+                  }
+                ],
+                "mapValue": [
+                  {
+                    "type": 1,
+                    "string": "compilacionCollecionesClientosGtmFlush"
+                  },
+                  {
+                    "type": 8,
+                    "boolean": false
+                  },
+                  {
+                    "type": 8,
+                    "boolean": false
+                  },
+                  {
+                    "type": 8,
+                    "boolean": true
+                  }
+                ]
+              }
+            ]
+          }
+        }
+      ]
+    },
+    "clientAnnotations": {
+      "isEditedByUser": true
+    },
+    "isRequired": true
+  },
+  {
+    "instance": {
+      "key": {
+        "publicId": "inject_script",
+        "versionId": "1"
+      },
+      "param": [
+        {
+          "key": "urls",
+          "value": {
+            "type": 2,
+            "listItem": [
+              {
+                "type": 1,
+                "string": "https://unpkg.com/*"
+              },
+              {
+                "type": 1,
+                "string": "https://www.immoscoop.be/public/*"
+              }
+            ]
+          }
+        }
+      ]
+    },
+    "clientAnnotations": {
+      "isEditedByUser": true
+    },
+    "isRequired": true
+  }
+]
+
+
+___TESTS___
+
+scenarios: []
+
+
+___NOTES___
+
+Created on 02/07/2025, 13:59:46
+
+

package/dist/gtm/icon-scallop.svg

@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64">
+  <title>Compostela scallop</title>
+  <rect width="64" height="64" rx="10" fill="#1D4ED8"/>
+  <path d="M32 54 L7 28 Q9 14 22 8 Q32 4 42 8 Q55 14 57 28 Z"
+        fill="#FCD34D" stroke="#1D4ED8" stroke-width="2" stroke-linejoin="round"/>
+  <g stroke="#1D4ED8" stroke-width="2" stroke-linecap="round" fill="none">
+    <path d="M32 54 L32 6"/>
+    <path d="M32 54 L21 8"/>
+    <path d="M32 54 L43 8"/>
+    <path d="M32 54 L12 17"/>
+    <path d="M32 54 L52 17"/>
+    <path d="M32 54 L7 28"/>
+    <path d="M32 54 L57 28"/>
+  </g>
+</svg>

package/dist/index.cjs

@@ -718,10 +718,13 @@ class CollecionesWebTracker extends CollecionesTracker {
 class CollecionesEventGroup {
 
     /**
-     * Creates a new event group with a generated groupId.
+     * Creates a new event group.
+     * The groupId is NOT generated up-front: a group's identity is defined by its composition,
+     * so the id is generated lazily in getEvents() and invalidated by every addEvent() call.
+     * Reading `group.groupId` before the first getEvents() returns null.
      */
     constructor() {
-        this.groupId = generateId();
+        this.groupId = null;
         this._events = [];
     }
 
@@ -731,6 +734,9 @@ class CollecionesEventGroup {
      * keeping the same familiar contract as building events directly.
      * An existing CollecionesEvent instance may also be passed in.
      *
+     * Adding an event changes the composition of the group, so the cached groupId is invalidated
+     * — the next getEvents() call will generate a fresh id and re-stamp every event.
+     *
      * @param {CollecionesEvent|null} [event=null] - An existing event to register, or null to create a fresh one.
      * @returns {CollecionesEvent} The event that was added.
      * @throws {Error} If a non-null, non-CollecionesEvent value is passed.
@@ -741,20 +747,30 @@ class CollecionesEventGroup {
         }
         const newEvent = event ?? new CollecionesEvent();
         this._events.push(newEvent);
+        this.groupId = null;
         return newEvent;
     }
 
     /**
      * Materialises group metadata onto every event and returns the full list.
-     * Each event receives:
-     *   - meta.eventGroup.id               — the groupId of this group
+     * If no groupId is currently set, a new one is generated here. Each event then receives:
+     *   - meta.eventGroup.id                  — the groupId of this group
      *   - meta.eventGroup.groupClientEventIds — clientEventIds of the sibling events (not self)
      *
-     * Safe to call multiple times; group metadata is always recalculated from the current state.
+     * Safe to call multiple times: idempotent as long as no addEvent() happened in between.
+     * After an addEvent() the cached groupId is null, so a subsequent getEvents() will mint a fresh id
+     * and re-stamp every event accordingly.
+     *
+     * Callers may also assign `group.groupId` directly (e.g. with a semantic name) before calling
+     * getEvents() to override the auto-generated value; do so AFTER all addEvent() calls,
+     * otherwise the next addEvent() will clear the override.
      *
      * @returns {CollecionesEvent[]} A shallow copy of the internal events array with group metadata applied.
      */
     getEvents() {
+        if (this.groupId === null) {
+            this.groupId = generateId();
+        }
         const allClientEventIds = this._events.map(e => e.meta.clientEventId);
         this._events.forEach(event => {
             const peers = allClientEventIds.filter(id => id !== event.meta.clientEventId);