veo-sdk 0.5.33 → 0.6.0

package/dist/builder.d.cts

@@ -1,5 +1,5 @@
-import { P as PreviewGuideInput } from './guide-preview-C73rKO0u.cjs';
-export { a as PreviewHandle, b as PreviewResult, c as closeGuidePreview, p as previewGuide } from './guide-preview-C73rKO0u.cjs';
+import { P as PreviewGuideInput } from './guide-preview-DylsEhrg.cjs';
+export { a as PreviewHandle, b as PreviewResult, c as closeGuidePreview, p as previewGuide } from './guide-preview-DylsEhrg.cjs';
 
 /** Dónde soltó el autor un bloque nuevo. */
 interface BlockDropPayload {
@@ -136,8 +136,14 @@ interface EditorChromeState {
         presentation: 'floating' | 'inline';
     }>;
     activeStep: number;
-    /** Qué muestra el panel: ajustes de activación o el paso activo. */
-    section: 'activation' | 'step' | 'badge' | 'target';
+    /**
+     * Qué muestra el panel. `step`, `block`, `add-block`, `row` y `structure`
+     * son vistas del paso activo (la fila de pasos lo marca); las pestañas del
+     * contenedor se «encienden» solo con `step` (contenedor) y `structure`.
+     */
+    section: 'activation' | 'step' | 'badge' | 'target' | 'block' | 'add-block' | 'row' | 'structure';
+    /** Editando un bloque del paso: su nombre («Encuesta Texto abierto») para el título del panel. */
+    blockLabel?: string | null;
     saving: boolean;
     dirty: boolean;
     /**
@@ -173,6 +179,21 @@ type PreviewStatus = {
     devices: 'desktop' | 'mobile';
 };
 /** Acciones que el usuario dispara en el chrome (barras) y el panel ejecuta. */
+/** Bloque de la preview: paso + id local del panel (`StepBlock.editorId`). */
+interface BlockRef {
+    stepIndex: number;
+    blockId: string;
+}
+type BlockToolbarAction = 'edit' | 'duplicate' | 'remove'
+/** Mover: arriba/abajo dentro de su columna, izquierda/derecha entre columnas de su fila. */
+ | 'move-up' | 'move-down' | 'move-left' | 'move-right';
+/** Barra de la FILA (hover o fila del bloque seleccionado): editar / duplicar / eliminar. */
+type RowToolbarAction = 'edit' | 'duplicate' | 'remove';
+/** Pestañas sobre el CONTENEDOR (hover): editar el paso o abrir la estructura de filas. */
+type CardToolbarAction = 'edit-container' | 'edit-rows';
+type BlockLayoutAction = 'row-before' | 'row-after' | 'col-before' | 'col-after'
+/** Bloque apilado en la MISMA celda (fila+columna), antes/después del bloque. */
+ | 'stack-before' | 'stack-after';
 type ChromeAction = {
     action: 'select-activation';
 } | {
@@ -180,6 +201,14 @@ type ChromeAction = {
     index: number;
 } | {
     action: 'add-step';
+}
+/** Hover sobre la tarjeta de un paso: duplicar (se inserta después) o eliminar. */
+ | {
+    action: 'duplicate-step';
+    index: number;
+} | {
+    action: 'remove-step';
+    index: number;
 } | {
     action: 'save';
     exit: boolean;
@@ -213,6 +242,47 @@ type BuilderEvent = {
 } | {
     type: 'block-dropped';
     payload: BlockDropPayload;
+}
+/** Clic simple (sin arrastre) sobre la tarjeta de la preview: el panel abre «Agregar bloque». */
+ | {
+    type: 'card-clicked';
+    payload: {
+        stepIndex: number;
+    };
+}
+/** Clic sobre un bloque de la preview: se selecciona en la app y el panel abre su editor. */
+ | {
+    type: 'block-clicked';
+    payload: BlockRef;
+}
+/** Barra del bloque seleccionado: editar / duplicar / eliminar. */
+ | {
+    type: 'block-action';
+    payload: BlockRef & {
+        action: BlockToolbarAction;
+    };
+}
+/** «+» en los bordes del bloque seleccionado: agregar fila arriba/abajo o columna izq/der. */
+ | {
+    type: 'block-layout';
+    payload: BlockRef & {
+        action: BlockLayoutAction;
+    };
+}
+/** Barra de una fila: `blockId` = primer bloque de la fila (la fila no tiene id propio). */
+ | {
+    type: 'row-action';
+    payload: BlockRef & {
+        action: RowToolbarAction;
+    };
+}
+/** Pestañas del contenedor (hover sobre la tarjeta): editar contenedor / editar filas. */
+ | {
+    type: 'card-action';
+    payload: {
+        stepIndex: number;
+        action: CardToolbarAction;
+    };
 } | {
     type: 'preview-status';
     payload: PreviewStatus;
@@ -240,6 +310,16 @@ type BuilderCommand = {
     label?: string;
 } | {
     type: 'close-preview';
+}
+/** El panel selecciona (o deselecciona con null) un bloque en la app. */
+ | {
+    type: 'select-block';
+    blockId: string | null;
+}
+/** El panel edita una fila: se marca en la app (por el id de un bloque de esa fila). */
+ | {
+    type: 'select-row';
+    blockId: string | null;
 } | {
     type: 'teardown';
 } | {
@@ -248,6 +328,14 @@ type BuilderCommand = {
 } | {
     type: 'panel-visibility';
     visible: boolean;
+}
+/** Tamaño compacto del panel (alto = contenido); `null` restaura el tamaño previo. */
+ | {
+    type: 'panel-size';
+    size: {
+        width: number;
+        height: number;
+    } | null;
 } | {
     type: 'panel-ready';
 };

package/dist/builder.d.ts

@@ -1,5 +1,5 @@
-import { P as PreviewGuideInput } from './guide-preview-C73rKO0u.js';
-export { a as PreviewHandle, b as PreviewResult, c as closeGuidePreview, p as previewGuide } from './guide-preview-C73rKO0u.js';
+import { P as PreviewGuideInput } from './guide-preview-DylsEhrg.js';
+export { a as PreviewHandle, b as PreviewResult, c as closeGuidePreview, p as previewGuide } from './guide-preview-DylsEhrg.js';
 
 /** Dónde soltó el autor un bloque nuevo. */
 interface BlockDropPayload {
@@ -136,8 +136,14 @@ interface EditorChromeState {
         presentation: 'floating' | 'inline';
     }>;
     activeStep: number;
-    /** Qué muestra el panel: ajustes de activación o el paso activo. */
-    section: 'activation' | 'step' | 'badge' | 'target';
+    /**
+     * Qué muestra el panel. `step`, `block`, `add-block`, `row` y `structure`
+     * son vistas del paso activo (la fila de pasos lo marca); las pestañas del
+     * contenedor se «encienden» solo con `step` (contenedor) y `structure`.
+     */
+    section: 'activation' | 'step' | 'badge' | 'target' | 'block' | 'add-block' | 'row' | 'structure';
+    /** Editando un bloque del paso: su nombre («Encuesta Texto abierto») para el título del panel. */
+    blockLabel?: string | null;
     saving: boolean;
     dirty: boolean;
     /**
@@ -173,6 +179,21 @@ type PreviewStatus = {
     devices: 'desktop' | 'mobile';
 };
 /** Acciones que el usuario dispara en el chrome (barras) y el panel ejecuta. */
+/** Bloque de la preview: paso + id local del panel (`StepBlock.editorId`). */
+interface BlockRef {
+    stepIndex: number;
+    blockId: string;
+}
+type BlockToolbarAction = 'edit' | 'duplicate' | 'remove'
+/** Mover: arriba/abajo dentro de su columna, izquierda/derecha entre columnas de su fila. */
+ | 'move-up' | 'move-down' | 'move-left' | 'move-right';
+/** Barra de la FILA (hover o fila del bloque seleccionado): editar / duplicar / eliminar. */
+type RowToolbarAction = 'edit' | 'duplicate' | 'remove';
+/** Pestañas sobre el CONTENEDOR (hover): editar el paso o abrir la estructura de filas. */
+type CardToolbarAction = 'edit-container' | 'edit-rows';
+type BlockLayoutAction = 'row-before' | 'row-after' | 'col-before' | 'col-after'
+/** Bloque apilado en la MISMA celda (fila+columna), antes/después del bloque. */
+ | 'stack-before' | 'stack-after';
 type ChromeAction = {
     action: 'select-activation';
 } | {
@@ -180,6 +201,14 @@ type ChromeAction = {
     index: number;
 } | {
     action: 'add-step';
+}
+/** Hover sobre la tarjeta de un paso: duplicar (se inserta después) o eliminar. */
+ | {
+    action: 'duplicate-step';
+    index: number;
+} | {
+    action: 'remove-step';
+    index: number;
 } | {
     action: 'save';
     exit: boolean;
@@ -213,6 +242,47 @@ type BuilderEvent = {
 } | {
     type: 'block-dropped';
     payload: BlockDropPayload;
+}
+/** Clic simple (sin arrastre) sobre la tarjeta de la preview: el panel abre «Agregar bloque». */
+ | {
+    type: 'card-clicked';
+    payload: {
+        stepIndex: number;
+    };
+}
+/** Clic sobre un bloque de la preview: se selecciona en la app y el panel abre su editor. */
+ | {
+    type: 'block-clicked';
+    payload: BlockRef;
+}
+/** Barra del bloque seleccionado: editar / duplicar / eliminar. */
+ | {
+    type: 'block-action';
+    payload: BlockRef & {
+        action: BlockToolbarAction;
+    };
+}
+/** «+» en los bordes del bloque seleccionado: agregar fila arriba/abajo o columna izq/der. */
+ | {
+    type: 'block-layout';
+    payload: BlockRef & {
+        action: BlockLayoutAction;
+    };
+}
+/** Barra de una fila: `blockId` = primer bloque de la fila (la fila no tiene id propio). */
+ | {
+    type: 'row-action';
+    payload: BlockRef & {
+        action: RowToolbarAction;
+    };
+}
+/** Pestañas del contenedor (hover sobre la tarjeta): editar contenedor / editar filas. */
+ | {
+    type: 'card-action';
+    payload: {
+        stepIndex: number;
+        action: CardToolbarAction;
+    };
 } | {
     type: 'preview-status';
     payload: PreviewStatus;
@@ -240,6 +310,16 @@ type BuilderCommand = {
     label?: string;
 } | {
     type: 'close-preview';
+}
+/** El panel selecciona (o deselecciona con null) un bloque en la app. */
+ | {
+    type: 'select-block';
+    blockId: string | null;
+}
+/** El panel edita una fila: se marca en la app (por el id de un bloque de esa fila). */
+ | {
+    type: 'select-row';
+    blockId: string | null;
 } | {
     type: 'teardown';
 } | {
@@ -248,6 +328,14 @@ type BuilderCommand = {
 } | {
     type: 'panel-visibility';
     visible: boolean;
+}
+/** Tamaño compacto del panel (alto = contenido); `null` restaura el tamaño previo. */
+ | {
+    type: 'panel-size';
+    size: {
+        width: number;
+        height: number;
+    } | null;
 } | {
     type: 'panel-ready';
 };

package/dist/builder.mjs

@@ -1,7 +1,7 @@
-import './chunk-FZ72JUAR.mjs';
-import { initBuilderMode } from './chunk-3ZOKCQ54.mjs';
-export { createBuilderSession, initBuilderMode, startElementPicker, stopElementPicker } from './chunk-3ZOKCQ54.mjs';
-export { closeGuidePreview, previewGuide } from './chunk-M6PB5UMW.mjs';
+import './chunk-GMXQMZ4X.mjs';
+import { initBuilderMode } from './chunk-N4VFMZFA.mjs';
+export { createBuilderSession, initBuilderMode, startElementPicker, stopElementPicker } from './chunk-N4VFMZFA.mjs';
+export { closeGuidePreview, previewGuide } from './chunk-O6USA4TU.mjs';
 import './chunk-PTG3BTJE.mjs';
 
 // src/builder.ts

package/dist/{chunk-FZ72JUAR.mjs → chunk-GMXQMZ4X.mjs}

@@ -1,4 +1,4 @@
-import { hasDocument, hasWindow, clearPreviewToken, DEFAULT_TRACKER_MAX_RETRIES, DEFAULT_TRACKER_BATCH_SIZE, DEFAULT_TRACKER_FLUSH_INTERVAL_MS, isDeviceAllowed, stepMatchesPage, CompositeRenderer, ModalRenderer, BannerRenderer, WalkthroughRenderer, BadgeRenderer, InlineFormRenderer, FormRenderer, InlineCustomRenderer, InlineRenderer, CustomRenderer, TooltipRenderer, previewGuide, FREQUENCY_CACHE_KEY_PREFIX, FREQUENCY_CACHE_TTL_MS, FREQUENCY_CACHE_MAX_ENTRIES, WALKTHROUGH_STATE_KEY_PREFIX, WALKTHROUGH_ABANDONMENT_TIMEOUT_MS } from './chunk-M6PB5UMW.mjs';
+import { hasDocument, hasWindow, isAutomaticActivation, activationDelayMs, clearPreviewToken, DEFAULT_TRACKER_MAX_RETRIES, DEFAULT_TRACKER_BATCH_SIZE, DEFAULT_TRACKER_FLUSH_INTERVAL_MS, isDeviceAllowed, isSnoozed, stepMatchesPage, CompositeRenderer, ModalRenderer, BannerRenderer, WalkthroughRenderer, BadgeRenderer, InlineFormRenderer, FormRenderer, InlineCustomRenderer, InlineRenderer, CustomRenderer, TooltipRenderer, previewGuide, FREQUENCY_CACHE_KEY_PREFIX, FREQUENCY_CACHE_TTL_MS, FREQUENCY_CACHE_MAX_ENTRIES, WALKTHROUGH_STATE_KEY_PREFIX, WALKTHROUGH_ABANDONMENT_TIMEOUT_MS } from './chunk-O6USA4TU.mjs';
 
 // src/plugins/plugin.ts
 function definePlugin(plugin) {
@@ -26,7 +26,7 @@ async function runPreviewMode(opts) {
   } catch (err) {
     if (opts.debug) console.warn("[veo] preview-resolve fall\xF3:", err);
   }
-  const submitToBackend = async (answers) => {
+  const submitToBackend = async (answers, meta) => {
     if (!guide) return false;
     const veo = window.veo;
     const endUserId = veo?.getEndUserId?.() ?? veo?.getAnonymousId?.() ?? null;
@@ -35,7 +35,12 @@ async function runPreviewMode(opts) {
       const res = await fetch(`${opts.apiUrl}/v1/guides/${guide.guideId}/form-response`, {
         method: "POST",
         headers: { "Content-Type": "application/json", "X-Api-Key": opts.apiKey },
-        body: JSON.stringify({ endUserId, answers })
+        body: JSON.stringify({
+          endUserId,
+          answers,
+          ...meta ? { stepPosition: meta.stepIndex } : {},
+          ...meta?.pollId ? { pollId: meta.pollId } : {}
+        })
       });
       return res.ok;
     } catch {
@@ -81,7 +86,7 @@ async function runPreviewMode(opts) {
     clearWaits();
     const rules = guide.activationRules;
     const selector = rules.selector?.trim();
-    if ((rules.trigger === "on_click" || rules.trigger === "on_hover") && selector) {
+    if ((rules.trigger === "on_click" || rules.trigger === "on_hover") && selector && !isAutomaticActivation(rules)) {
       const verb = rules.trigger === "on_hover" ? "pasa el mouse por" : "haz clic en";
       chip.setLabel(`${baseLabel} \xB7 ${verb} el elemento objetivo`);
       const onFire = (e) => {
@@ -104,7 +109,7 @@ async function runPreviewMode(opts) {
       };
       return;
     }
-    const delayMs = rules.trigger === "delayed" ? rules.delayMs ?? 0 : 0;
+    const delayMs = activationDelayMs(rules);
     if (delayMs > 0) {
       chip.setLabel(`${baseLabel} \xB7 aparece en ${Math.round(delayMs / 1e3)} s`);
       delayTimer = setTimeout(() => {
@@ -750,6 +755,12 @@ var GuidesController = class {
      * en cada `checkGuides` con {@link pruneComposite}.
      */
     this.activeComposite = /* @__PURE__ */ new Map();
+    /**
+     * Progreso de esta sesión, por guía: pasos vistos y completado, según las
+     * interacciones que ESTE SDK emitió (aunque el lote aún no haya viajado al
+     * backend). Se mezcla con la respuesta del backend en `fetchProgress`.
+     */
+    this.sessionProgress = /* @__PURE__ */ new Map();
     this.debug = config.debug === true;
     this.apiUrl = config.apiUrl;
     this.apiKey = config.apiKey;
@@ -814,12 +825,15 @@ var GuidesController = class {
     if (this.debug) console.log(`[veo] guides: ${guides.length} eligible at ${pageUrl}`);
     this.disarmTriggers();
     for (const guide of guides) {
-      const trigger = guide.activationRules.trigger;
-      if ((trigger === "on_click" || trigger === "on_hover") && guide.activationRules.selector) {
+      const rules = guide.activationRules;
+      const trigger = rules.trigger;
+      if ((trigger === "on_click" || trigger === "on_hover") && rules.selector) {
         this.armInteractionTrigger(guide, endUserId, sessionId, pageUrl);
-        continue;
+        if (!isAutomaticActivation(rules)) continue;
       }
-      await this.showGuide(guide, endUserId, sessionId, pageUrl);
+      await this.showGuide(guide, endUserId, sessionId, pageUrl, {
+        badgeOpen: trigger !== "manual"
+      });
     }
   }
   /**
@@ -827,12 +841,17 @@ var GuidesController = class {
    * tipo). Cuerpo original del loop de `checkGuides`, extraído para que los
    * disparadores por interacción pasen por LOS MISMOS chequeos al disparar.
    */
-  async showGuide(guide, endUserId, sessionId, pageUrl) {
+  async showGuide(guide, endUserId, sessionId, pageUrl, opts = {}) {
+    const badgeOpen = opts.badgeOpen !== false;
     if (this.frequencyCache.shouldFilter(guide.guideId, guide.displayFrequency)) {
       if (this.debug) console.log(`[veo] guides: filtered locally guideId=${guide.guideId}`);
       return;
     }
-    if (this.isHeldByRepeat(guide)) {
+    if (!opts.byUser && isSnoozed(guide.guideId)) {
+      if (this.debug) console.log(`[veo] guides: snoozed guideId=${guide.guideId}`);
+      return;
+    }
+    if (!opts.byUser && this.isHeldByRepeat(guide)) {
       if (this.debug) console.log(`[veo] guides: held by repeat guideId=${guide.guideId}`);
       return;
     }
@@ -850,7 +869,7 @@ var GuidesController = class {
       return;
     }
     if (guide.guideType === "composite") {
-      this.startComposite(guide, sessionId, pageUrl);
+      this.startComposite(guide, sessionId, pageUrl, badgeOpen);
       return;
     }
     this.runSingleStepRender(guide, sessionId, pageUrl);
@@ -879,7 +898,7 @@ var GuidesController = class {
         return;
       }
       disarm();
-      void this.showGuide(guide, endUserId, sessionId, pageUrl);
+      void this.showGuide(guide, endUserId, sessionId, pageUrl, { byUser: true });
     };
     const disarm = () => {
       document.removeEventListener(eventName, onFire, true);
@@ -959,7 +978,7 @@ ${pageUrl}`;
     const renderer = this.createSingleStepRenderer(guide.guideType);
     if (!renderer) return;
     this.activeByGuideId.set(guide.guideId, renderer);
-    const delayMs = guide.activationRules.delayMs ?? 0;
+    const delayMs = activationDelayMs(guide.activationRules);
     window.setTimeout(
       () => this.mountSingleStepRenderer(guide, renderer, sessionId, pageUrl),
       delayMs
@@ -970,23 +989,24 @@ ${pageUrl}`;
    * `pageLocation` matchea la URL actual (targeting por-paso) y lo pinta con el
    * `CompositeRenderer`. Si ningún paso aplica a esta página, no muestra nada.
    */
-  startComposite(guide, sessionId, pageUrl) {
+  startComposite(guide, sessionId, pageUrl, badgeOpen = true) {
     if (this.pendingComposite?.guide.guideId === guide.guideId) return;
     const steps = guide.guideSteps;
     const remembered = guide.activationRules.repeat?.onLoad === "resume" ? this.recallStep(guide.guideId) : null;
     const start = remembered !== null && stepMatchesPage(steps[remembered]?.pageLocation, pageUrl) ? remembered : steps.findIndex((s) => stepMatchesPage(s.pageLocation, pageUrl));
     if (start === -1) return;
+    if (guide.activationRules.trigger === "manual" && !steps[start]?.badge?.enabled) return;
     if (this.compositeDelays.has(guide.guideId)) return;
     this.resetDispatched(guide.guideId);
-    const delayMs = guide.activationRules.delayMs ?? 0;
+    const delayMs = activationDelayMs(guide.activationRules);
     if (delayMs <= 0) {
-      this.renderCompositeStep(guide, start, sessionId, pageUrl);
+      this.renderCompositeStep(guide, start, sessionId, pageUrl, badgeOpen);
       return;
     }
     const timer = setTimeout(() => {
       this.compositeDelays.delete(guide.guideId);
       if (this.activeByGuideId.has(guide.guideId)) return;
-      this.renderCompositeStep(guide, start, sessionId, pageUrl);
+      this.renderCompositeStep(guide, start, sessionId, pageUrl, badgeOpen);
     }, delayMs);
     this.compositeDelays.set(guide.guideId, { guide, stepIndex: start, timer });
   }
@@ -1088,7 +1108,7 @@ ${pageUrl}`;
    * que los botones next/prev avancen (misma página); en single-step los
    * botones cierran. Cada avance destruye el paso anterior y monta el siguiente.
    */
-  renderCompositeStep(guide, idx, sessionId, pageUrl) {
+  renderCompositeStep(guide, idx, sessionId, pageUrl, badgeOpen = true) {
     const steps = guide.guideSteps;
     this.rememberStep(guide.guideId, idx);
     const renderer = new CompositeRenderer();
@@ -1106,9 +1126,20 @@ ${pageUrl}`;
     const goToStep = (target) => {
       cleanup();
       if (target < 0 || target >= steps.length) return;
+      const endUserId = this.client.getEndUserId();
+      if (endUserId) {
+        this.enqueueInteraction(
+          guide.guideId,
+          endUserId,
+          sessionId,
+          pageUrl,
+          target > idx ? "step_advanced" : "step_back",
+          target
+        );
+      }
       const step = steps[target];
       if (step && stepMatchesPage(step.pageLocation, pageUrl)) {
-        this.renderCompositeStep(guide, target, sessionId, pageUrl);
+        this.renderCompositeStep(guide, target, sessionId, pageUrl, badgeOpen);
       } else {
         this.pendingComposite = { guide, stepIndex: target };
       }
@@ -1130,10 +1161,19 @@ ${pageUrl}`;
         onInteraction: (e) => this.handleInteraction(guide, sessionId, pageUrl, e),
         onClose: cleanup,
         onTrack: (name, props) => this.client.track(name, props),
-        onFormSubmit: (answers) => this.submitFormResponse(guide.guideId, answers),
+        onFormSubmit: (answers, meta) => this.submitFormResponse(guide.guideId, answers, meta),
         onOpenGuide: (targetGuideId) => {
           void this.openGuideById(targetGuideId, sessionId, pageUrl);
         },
+        // Lista de tareas: progreso del usuario y abrir una guía en su paso.
+        fetchProgress: (ids) => this.fetchProgress(ids),
+        onOpenGuideAt: (targetGuideId, stepIndex) => {
+          void this.openGuideById(targetGuideId, sessionId, pageUrl, stepIndex);
+        },
+        // Badge: cuando el MOTOR muestra la guía (automático, elemento objetivo
+        // o encadenada), el contenido se abre solo; el marcador queda para
+        // volver a verla. Solo `manual` deja el tooltip cerrado.
+        badgeOpen,
         ...nav ? { nav } : {}
       });
     } catch (err) {
@@ -1157,7 +1197,7 @@ ${pageUrl}`;
     const onTrack = (eventName, properties) => {
       this.client.track(eventName, properties);
     };
-    const onFormSubmit = (answers) => this.submitFormResponse(guide.guideId, answers);
+    const onFormSubmit = (answers, meta) => this.submitFormResponse(guide.guideId, answers, meta);
     const onOpenGuide = (targetGuideId) => {
       void this.openGuideById(targetGuideId, sessionId, pageUrl);
     };
@@ -1177,7 +1217,7 @@ ${pageUrl}`;
    * un botón); respeta el dedupe de guías activas y el flujo normal de
    * tracking. 404/red → no-op (la guía destino pudo borrarse).
    */
-  async openGuideById(guideId, sessionId, pageUrl) {
+  async openGuideById(guideId, sessionId, pageUrl, startStep) {
     if (this.activeByGuideId.has(guideId)) return;
     const guide = await this.resolver.fetchById(guideId);
     if (!guide) {
@@ -1185,6 +1225,15 @@ ${pageUrl}`;
       return;
     }
     const endUserId = this.client.getEndUserId() ?? this.client.getAnonymousId();
+    if (guide.guideType === "composite" && typeof startStep === "number") {
+      const total = guide.guideSteps.length;
+      const idx = Math.max(0, Math.min(total - 1, Math.floor(startStep)));
+      this.enqueueInteractionOnce(guide.guideId, endUserId, sessionId, pageUrl, "shown", 0);
+      if (idx > 0)
+        this.enqueueInteraction(guide.guideId, endUserId, sessionId, pageUrl, "step_advanced", idx);
+      this.renderCompositeStep(guide, idx, sessionId, pageUrl);
+      return;
+    }
     if (guide.guideType === "walkthrough" && guide.guideSteps.length > 1) {
       if (!this.walkthroughState.hasActive()) {
         await this.startWalkthrough(guide, endUserId, sessionId, pageUrl);
@@ -1395,6 +1444,7 @@ ${pageUrl}`;
         console.warn("[veo] guides: interaction without endUserId \u2014 skipping enqueue");
       return;
     }
+    this.noteProgress(guide.guideId, event.action, event.stepIndex);
     this.trackerQueue.enqueue({
       guideId: guide.guideId,
       payload: {
@@ -1414,6 +1464,7 @@ ${pageUrl}`;
    * una navegación distinta) y deduplicarlas perdería datos.
    */
   enqueueInteraction(guideId, endUserId, sessionId, pageUrl, action, stepIndex) {
+    this.noteProgress(guideId, action, stepIndex);
     this.trackerQueue.enqueue({
       guideId,
       payload: {
@@ -1426,6 +1477,45 @@ ${pageUrl}`;
       }
     });
   }
+  noteProgress(guideId, action, stepIndex) {
+    if (action !== "shown" && action !== "step_advanced" && action !== "step_back" && action !== "completed") {
+      return;
+    }
+    const cur = this.sessionProgress.get(guideId) ?? { maxStep: -1, completed: false };
+    this.sessionProgress.set(guideId, {
+      maxStep: Math.max(cur.maxStep, stepIndex),
+      completed: cur.completed || action === "completed"
+    });
+  }
+  /**
+   * Progreso del usuario en varias guías (bloque «Lista de tareas»): lo pide
+   * al backend y lo eleva con lo visto en esta sesión (nunca lo baja).
+   */
+  async fetchProgress(guideIds) {
+    const endUserId = this.client.getEndUserId() ?? this.client.getAnonymousId();
+    let rows = [];
+    try {
+      const params = new URLSearchParams({ endUserId, guideIds: guideIds.join(",") });
+      const res = await fetch(`${this.apiUrl}/v1/guides/progress?${params}`, {
+        headers: { "X-Api-Key": this.apiKey }
+      });
+      if (res.ok) rows = (await res.json()).items ?? [];
+      else if (this.debug) console.warn("[veo] guides/progress respondi\xF3", res.status);
+    } catch (err) {
+      if (this.debug) console.warn("[veo] guides/progress fall\xF3:", err);
+    }
+    return rows.map((r) => {
+      const local = this.sessionProgress.get(r.guideId);
+      if (!local) return r;
+      const seen = Math.min(r.totalSteps, local.maxStep + 1);
+      const completed = r.completed || local.completed || seen >= r.totalSteps;
+      return {
+        ...r,
+        currentStep: completed ? r.totalSteps : Math.max(r.currentStep, seen),
+        completed
+      };
+    });
+  }
   /**
    * Encola con dedup por sesión del SDK. Para `shown` del primer step:
    * no queremos re-emitirlo si el usuario navega entre dos páginas que
@@ -1470,13 +1560,19 @@ ${pageUrl}`;
    * propiedades del usuario. Usa el endUserId actual (o el anónimo si aún no
    * hubo identify — el backend pre-crea la fila igual que identify).
    */
-  async submitFormResponse(guideId, answers) {
+  async submitFormResponse(guideId, answers, meta) {
     const endUserId = this.client.getEndUserId() ?? this.client.getAnonymousId();
     try {
       const res = await fetch(`${this.apiUrl}/v1/guides/${guideId}/form-response`, {
         method: "POST",
         headers: { "Content-Type": "application/json", "X-Api-Key": this.apiKey },
-        body: JSON.stringify({ endUserId, answers })
+        body: JSON.stringify({
+          endUserId,
+          answers,
+          sessionId: this.client.getSessionId(),
+          ...meta ? { stepPosition: meta.stepIndex } : {},
+          ...meta?.pollId ? { pollId: meta.pollId } : {}
+        })
       });
       if (!res.ok && this.debug) {
         console.warn("[veo] form-response respondi\xF3", res.status);
@@ -1520,5 +1616,5 @@ function guidesPlugin(config) {
 }
 
 export { definePlugin, guidesPlugin, runPreviewMode };
-//# sourceMappingURL=chunk-FZ72JUAR.mjs.map
-//# sourceMappingURL=chunk-FZ72JUAR.mjs.map
+//# sourceMappingURL=chunk-GMXQMZ4X.mjs.map
+//# sourceMappingURL=chunk-GMXQMZ4X.mjs.map