@useinsider/guido 3.6.0-beta.5cbaa8f → 3.6.0-beta.6c3407e

package/dist/enums/toaster.js

@@ -1,4 +1,4 @@
-var c = /* @__PURE__ */ ((r) => (r.Success = "success", r.Warning = "warning", r.Alert = "alert", r))(c || {});
+var c = /* @__PURE__ */ ((r) => (r.Success = "success", r.Warning = "warning", r.Alert = "alert", r.Dark = "dark", r))(c || {});
 export {
   c as ToasterTypeOptions
 };

package/dist/extensions/Blocks/Recommendation/block.js

@@ -1,17 +1,18 @@
 var k = Object.defineProperty;
-var y = (a, r, t) => r in a ? k(a, r, { enumerable: !0, configurable: !0, writable: !0, value: t }) : a[r] = t;
-var d = (a, r, t) => y(a, typeof r != "symbol" ? r + "" : r, t);
-import { BlockId as B } from "../../../enums/block.js";
-import { getMigrationBannerHtml as D } from "../../../utils/migrationBannerHtml.js";
-import { Block as R, BlockCompositionType as C, ModificationDescription as h } from "../../../node_modules/@stripoinc/ui-editor-extensions/dist/esm/index.js";
+var B = (a, r, t) => r in a ? k(a, r, { enumerable: !0, configurable: !0, writable: !0, value: t }) : a[r] = t;
+var d = (a, r, t) => B(a, typeof r != "symbol" ? r + "" : r, t);
+import { BlockId as R } from "../../../enums/block.js";
+import { getMigrationBannerHtml as y } from "../../../utils/migrationBannerHtml.js";
+import { Block as D, BlockCompositionType as C, ModificationDescription as h } from "../../../node_modules/@stripoinc/ui-editor-extensions/dist/esm/index.js";
 import { regenerateMobileProductRows as b } from "./controls/main/utils.js";
 import { ensureMobileCssRulesExist as p, setMobileLayoutOptOut as f, hasMobileLayoutOptOut as A } from "./controls/mobileLayout/cssRules.js";
 import { RecommendationConfigService as c } from "./services/configService.js";
 import { useRecommendationExtensionStore as g } from "./store/recommendation.js";
 import { getDefaultTemplate as E } from "./templates/grid/template.js";
-const _ = B.Recommendation, m = "recommendation-block-v2", u = "recommendation-id";
-let I = !1;
-class q extends R {
+import { useRecommendationBlockWarning as M } from "./useRecommendationBlockWarning.js";
+const I = R.Recommendation, m = "recommendation-block-v2", u = "recommendation-id";
+let _ = !1;
+class H extends D {
   constructor() {
     super();
     /**
@@ -21,7 +22,7 @@ class q extends R {
     d(this, "_pendingBlockId", null);
   }
   getId() {
-    return _;
+    return I;
   }
   getIcon() {
     return "recommendation-icon";
@@ -38,8 +39,8 @@ class q extends R {
     );
   }
   getSettingsPanelTitleHtml() {
-    return D(
-      _,
+    return y(
+      I,
       this.api.translate("Recommendation Block"),
       this.api.translate("This block is switched from the Old Version to the New Version. We recommend you check the Recommendation block and test your message to ensure it works properly.")
     );
@@ -95,7 +96,7 @@ class q extends R {
         documentModifier: this.api.getDocumentModifier()
       }));
     }
-    s.patchCurrentBlockConfig({ language: n.language }, { triggerRefetch: !1 });
+    s.patchCurrentBlockConfig({ language: n.language }, { triggerRefetch: !1 }), this._warnIfMultipleBlocks();
   }
   /**
    * Called when the document changes or template is loaded
@@ -117,7 +118,7 @@ class q extends R {
       }
       this._healLingeringDuplicate(t), c.needsMigration(t) && this._migrateFromLegacy(t);
       try {
-        I || (p(this.api), I = !0);
+        _ || (p(this.api), _ = !0);
         const e = c.getConfig(t), i = this._getBlockElement(t);
         if (i) {
           const n = !e.mobileLayoutEnabled;
@@ -137,6 +138,24 @@ class q extends R {
     const e = this._getRecommendationId(t);
     e && g().removeBlockState(e);
   }
+  /**
+   * Warns (dark advisory toaster) when the design holds more than one live
+   * recommendation block. Triggered from the user-add paths only (fresh drop
+   * and duplicate) — never from document-load/migration, so opening a template
+   * that already has multiple blocks does not fire it. `onCreated` also runs
+   * for a reco block that arrives inside a saved structure (SD-143028), so this
+   * covers that case too — no separate `module_dropped` handling is needed.
+   *
+   * Counting lives in `useRecommendationBlockWarning`, whose DOM-based logic
+   * ignores the empty shells deletions leave behind (SD-143028). Wrapped in
+   * try/catch because the document root may be unavailable during initial load.
+   */
+  _warnIfMultipleBlocks() {
+    try {
+      M().warnIfMultipleBlocks(this.api.getDocumentRootHtmlNode());
+    } catch {
+    }
+  }
   /**
    * Generates the next unique recommendation ID by scanning all existing blocks
    * in the document and finding the maximum existing ID + 1.
@@ -209,7 +228,7 @@ class q extends R {
   /** Assigns a fresh id to a duplicated block and syncs DOM, node config and store. */
   _handleDuplicate(t, e) {
     const i = this._reassignDuplicateId(t, e), n = g();
-    n.cloneBlockState(e, i), n.setCurrentBlock(i);
+    n.cloneBlockState(e, i), n.setCurrentBlock(i), this._warnIfMultipleBlocks();
   }
   /**
    * Core id-reassignment for a duplicated block: rewrites the DOM
@@ -291,6 +310,6 @@ class q extends R {
   }
 }
 export {
-  _ as BLOCK_ID,
-  q as RecommendationBlock
+  I as BLOCK_ID,
+  H as RecommendationBlock
 };

package/dist/extensions/Blocks/Recommendation/useRecommendationBlockWarning.js

@@ -0,0 +1,16 @@
+import { useToaster as r } from "../../../composables/useToaster.js";
+import { useTranslations as s } from "../../../composables/useTranslations.js";
+import { ToasterTypeOptions as n } from "../../../enums/toaster.js";
+import { countLiveRecommendationBlocks as i } from "./utils/recommendationBlockCount.js";
+const a = "newsletter.multiple-reco-blocks-warning", f = () => {
+  const { showToaster: o } = r(), t = s();
+  return { warnIfMultipleBlocks: (e) => {
+    i(e) > 1 && o({
+      type: n.Dark,
+      message: t(a)
+    });
+  } };
+};
+export {
+  f as useRecommendationBlockWarning
+};

package/dist/extensions/Blocks/Recommendation/utils/recommendationBlockCount.js

@@ -0,0 +1,9 @@
+const r = ".recommendation-block-v2", t = ".recommendation-product-row";
+function n(o) {
+  return Array.from(o.querySelectorAll(r)).filter((e) => e.querySelector(t)).length;
+}
+export {
+  r as RECOMMENDATION_BLOCK_SELECTOR,
+  t as RECOMMENDATION_PRODUCT_ROW_SELECTOR,
+  n as countLiveRecommendationBlocks
+};

package/dist/extensions/Blocks/Unsubscribe/block.js

@@ -1,41 +1,39 @@
-var S = Object.defineProperty;
-var L = (c, o, e) => o in c ? S(c, o, { enumerable: !0, configurable: !0, writable: !0, value: e }) : c[o] = e;
-var a = (c, o, e) => L(c, typeof o != "symbol" ? o + "" : o, e);
-import { useToaster as f } from "../../../composables/useToaster.js";
-import { ToasterTypeOptions as A } from "../../../enums/toaster.js";
-import { PAGE_TYPES as h } from "../../../enums/unsubscribe.js";
-import { useUnsubscribeStore as u } from "../../../stores/unsubscribe.js";
-import { Block as y, BlockCompositionType as T, ContextActionType as k, ModificationDescription as d, BlockType as I } from "../../../node_modules/@stripoinc/ui-editor-extensions/dist/esm/index.js";
-import { getDefaultTemplate as v } from "./template.js";
-import { DATA_ATTRIBUTES as n, UNSUBSCRIBE_EVENTS as p } from "./utils/constants.js";
-import { parsePageList as B } from "./utils/utils.js";
-const C = "unsubscribe-block", m = 'a[data-unsubscribe-link="true"]', E = ".unsubscribe-block-v2", N = "{{ins-unsubscribe-link}}", U = "https://academy.insiderone.com/docs/adding-unsubscribe-pages-into-emails", R = "Removing the unsubscribe text leaves an empty block, but an active unsubscribe link is required. Undo your last action to restore the text, or delete the unsubscribe block entirely.", D = {
-  [h.GLOBAL_UNSUBSCRIBE]: "{{ins-global-unsubscribe-link}}",
-  [h.SUBSCRIPTION_PREFERENCE_CENTER]: "{{ins-preferences-unsubscribe-link}}"
-}, w = 3;
-class H extends y {
+var g = Object.defineProperty;
+var k = (c, n, e) => n in c ? g(c, n, { enumerable: !0, configurable: !0, writable: !0, value: e }) : c[n] = e;
+var l = (c, n, e) => k(c, typeof n != "symbol" ? n + "" : n, e);
+import { useToaster as B } from "../../../composables/useToaster.js";
+import { ToasterTypeOptions as S } from "../../../enums/toaster.js";
+import { PAGE_TYPES as E } from "../../../enums/unsubscribe.js";
+import { useUnsubscribeStore as a } from "../../../stores/unsubscribe.js";
+import { Block as L, BlockCompositionType as f, ContextActionType as h, ModificationDescription as b, BlockType as v } from "../../../node_modules/@stripoinc/ui-editor-extensions/dist/esm/index.js";
+import { getDefaultTemplate as A } from "./template.js";
+import { DATA_ATTRIBUTES as i, UNSUBSCRIBE_EVENTS as d } from "./utils/constants.js";
+import { parsePageList as p } from "./utils/utils.js";
+const y = "unsubscribe-block", m = 'a[data-unsubscribe-link="true"]', _ = ".unsubscribe-block-v2", I = "{{ins-unsubscribe-link}}", T = "https://academy.insiderone.com/docs/adding-unsubscribe-pages-into-emails", C = "Removing the unsubscribe text leaves an empty block, but an active unsubscribe link is required. Undo your last action to restore the text, or delete the unsubscribe block entirely.", N = {
+  [E.GLOBAL_UNSUBSCRIBE]: "{{ins-global-unsubscribe-link}}",
+  [E.SUBSCRIPTION_PREFERENCE_CENTER]: "{{ins-preferences-unsubscribe-link}}"
+};
+class F extends L {
   constructor() {
     super();
-    a(this, "selectEventListener", null);
-    a(this, "cancelEventListener", null);
-    a(this, "currentNode");
+    l(this, "selectEventListener", null);
+    l(this, "cancelEventListener", null);
+    l(this, "currentNode");
     // Per-block "did this instance have a link last time we saw it?" tracking.
     // Keyed by the stable `data-unsubscribe-block-id` we assign, because
     // ImmutableHtmlNode instances are recreated on every document mutation and
     // can't be used as Map keys directly. A singleton boolean here would be
     // polluted across blocks since Stripo fires onDocumentChanged per-instance.
-    a(this, "linkStateByBlockId", /* @__PURE__ */ new Map());
-    // Per-block prepend retry counter for the leading text guard (SD-143097).
-    a(this, "guardAttemptsByBlockId", /* @__PURE__ */ new Map());
+    l(this, "linkStateByBlockId", /* @__PURE__ */ new Map());
   }
   getId() {
-    return C;
+    return y;
   }
   getIcon() {
     return "unsubscribe-icon";
   }
   getBlockCompositionType() {
-    return T.BLOCK;
+    return f.BLOCK;
   }
   getName() {
     return this.api.translate("Unsubscribe Block");
@@ -44,84 +42,36 @@ class H extends y {
     return this.api.translate("Unsubscribe Block Description");
   }
   getTemplate() {
-    return v();
+    return A();
   }
   getContextActionsIds() {
-    return [k.MOVE, k.REMOVE];
+    return [h.MOVE, h.REMOVE];
   }
   onSelect(e) {
     this.currentNode = e;
     const t = this._getOrAssignBlockId(e);
     t && this.linkStateByBlockId.set(t, this._hasUnsubscribeLink(e)), !("getAttribute" in e && e.getAttribute("data-migration")) && (this._resetStoreState(), this._loadBlockState(e), this._setupSelectEventListener(), this._setupCancelEventListener(), this._checkExistingBlocks(), this._openDrawer());
   }
-  onCreated(e) {
-    this._ensureLeadingTextGuard(e);
-  }
-  onDocumentInit() {
-    try {
-      const e = this.api.getDocumentRoot();
-      e && "querySelectorAll" in e && e.querySelectorAll(E).forEach((t) => {
-        this._ensureLeadingTextGuard(t);
-      });
-    } catch {
-    }
-  }
   onDocumentChanged(e) {
-    this._ensureLeadingTextGuard(e);
     const t = this._getOrAssignBlockId(e);
     if (!t)
       return;
-    const s = this._hasUnsubscribeLink(e);
-    this.linkStateByBlockId.get(t) === !0 && !s && this._warnLinkRemoved(), this.linkStateByBlockId.set(t, s);
+    const r = this._hasUnsubscribeLink(e);
+    this.linkStateByBlockId.get(t) === !0 && !r && this._warnLinkRemoved(), this.linkStateByBlockId.set(t, r);
   }
   onDelete(e) {
     this._removeEventListeners(), this._removeBlockTemplatesFromStore(e), this._resetStoreState();
     const t = this._readBlockId(e);
-    t && (this.linkStateByBlockId.delete(t), this.guardAttemptsByBlockId.delete(t));
+    t && this.linkStateByBlockId.delete(t);
   }
   onDestroy() {
-    this._removeEventListeners(), this.currentNode = void 0, this.linkStateByBlockId.clear(), this.guardAttemptsByBlockId.clear();
-  }
-  /**
-   * Guarantees a plain-text node before the link's wrapper inside the <p>.
-   * Without it the only caret position left of the link is inside the anchor,
-   * so anything typed there becomes part of the link (SD-143097).
-   */
-  _ensureLeadingTextGuard(e) {
-    if (!("querySelector" in e))
-      return;
-    const t = e.querySelector(m);
-    if (!t)
-      return;
-    let s = t, r = s.parent();
-    for (; r && "getTagName" in r && r.getTagName().toLowerCase() !== "p"; )
-      s = r, r = r.parent();
-    if (!r || !("getTagName" in r) || r.getTagName().toLowerCase() !== "p")
-      return;
-    const i = s.previousSibling();
-    if (!!(i && i.getType() === "text" && i.getTextContent())) {
-      const b = this._readBlockId(e);
-      b && this.guardAttemptsByBlockId.delete(b);
-      return;
-    }
-    const g = this._getOrAssignBlockId(e);
-    if (!g)
-      return;
-    const _ = this.guardAttemptsByBlockId.get(g) ?? 0;
-    if (!(_ >= w)) {
-      this.guardAttemptsByBlockId.set(g, _ + 1);
-      try {
-        this.api.getDocumentModifier().modifyHtml(r).prepend("&nbsp;").apply(new d("Ensure unsubscribe link text guard"));
-      } catch (b) {
-        console.warn("[UnsubscribeBlock] Failed to ensure link text guard:", b);
-      }
-    }
+    this._removeEventListeners(), this.currentNode = void 0, this.linkStateByBlockId.clear();
   }
   _hasUnsubscribeLink(e) {
     return "querySelector" in e ? !!e.querySelector(m) : !1;
   }
   _readBlockId(e) {
-    return "getAttribute" in e ? e.getAttribute(n.BLOCK_ID) : null;
+    return "getAttribute" in e ? e.getAttribute(i.BLOCK_ID) : null;
   }
   /**
    * Returns the block's stable id, assigning one via the document modifier if
@@ -135,13 +85,13 @@ class H extends y {
       return t;
     if (!("getAttribute" in e))
       return null;
-    const s = this._generateNextBlockId();
+    const r = this._generateNextBlockId();
     try {
-      this.api.getDocumentModifier().modifyHtml(e).setAttribute(n.BLOCK_ID, s).apply(new d(`Assign unsubscribe block id ${s}`));
-    } catch (r) {
-      return console.warn("[UnsubscribeBlock] Failed to assign block id:", r), null;
+      this.api.getDocumentModifier().modifyHtml(e).setAttribute(i.BLOCK_ID, r).apply(new b(`Assign unsubscribe block id ${r}`));
+    } catch (s) {
+      return console.warn("[UnsubscribeBlock] Failed to assign block id:", s), null;
     }
-    return s;
+    return r;
   }
   /**
    * Generates a unique id by scanning the document for the highest existing
@@ -152,10 +102,10 @@ class H extends y {
     let e = 0;
     try {
       const t = this.api.getDocumentRoot();
-      t && "querySelectorAll" in t && t.querySelectorAll(E).forEach((r) => {
-        if ("getAttribute" in r) {
-          const i = r.getAttribute(n.BLOCK_ID), l = i ? parseInt(i) : 0;
-          l > e && (e = l);
+      t && "querySelectorAll" in t && t.querySelectorAll(_).forEach((s) => {
+        if ("getAttribute" in s) {
+          const o = s.getAttribute(i.BLOCK_ID), u = o ? parseInt(o) : 0;
+          u > e && (e = u);
         }
       });
     } catch {
@@ -164,14 +114,14 @@ class H extends y {
   }
   _warnLinkRemoved() {
     try {
-      const { showToaster: e } = f();
+      const { showToaster: e } = B();
       e({
-        type: A.Warning,
-        message: this.api.translate(R),
+        type: S.Warning,
+        message: this.api.translate(C),
         actionButton: {
           text: this.api.translate("Visit Academy"),
           onClick: () => {
-            window.open(U, "_blank", "noopener,noreferrer");
+            window.open(T, "_blank", "noopener,noreferrer");
           }
         }
       });
@@ -181,26 +131,26 @@ class H extends y {
   }
   _setupSelectEventListener() {
     this._removeSelectEventListener(), this.selectEventListener = (e) => {
-      const t = e, { collectionType: s, selectedPages: r } = t.detail;
-      this._updateBlock(s, r.join(","));
-    }, document.addEventListener(p.SELECT, this.selectEventListener);
+      const t = e, { collectionType: r, selectedPages: s } = t.detail;
+      this._updateBlock(r, s.join(","));
+    }, document.addEventListener(d.SELECT, this.selectEventListener);
   }
   _removeSelectEventListener() {
-    this.selectEventListener && (document.removeEventListener(p.SELECT, this.selectEventListener), this.selectEventListener = null);
+    this.selectEventListener && (document.removeEventListener(d.SELECT, this.selectEventListener), this.selectEventListener = null);
   }
   _setupCancelEventListener() {
     this._removeCancelEventListener(), this.cancelEventListener = () => {
       this._handleCancel();
-    }, document.addEventListener(p.CANCEL, this.cancelEventListener);
+    }, document.addEventListener(d.CANCEL, this.cancelEventListener);
   }
   _removeCancelEventListener() {
-    this.cancelEventListener && (document.removeEventListener(p.CANCEL, this.cancelEventListener), this.cancelEventListener = null);
+    this.cancelEventListener && (document.removeEventListener(d.CANCEL, this.cancelEventListener), this.cancelEventListener = null);
   }
   _handleCancel() {
     try {
       if (!this.currentNode)
         return;
-      this.api.getDocumentModifier().modifyHtml(this.currentNode).replaceWith(`<${I.EMPTY_CONTAINER}/>`).apply(new d("Removed unsubscribe block due to cancel"));
+      this.api.getDocumentModifier().modifyHtml(this.currentNode).replaceWith(`<${v.EMPTY_CONTAINER}/>`).apply(new b("Removed unsubscribe block due to cancel"));
     } catch (e) {
       console.warn("[UnsubscribeBlock] Failed to remove unsubscribe block:", e);
     }
@@ -211,32 +161,32 @@ class H extends y {
   _updateBlock(e, t) {
     if (!this.currentNode || !("querySelector" in this.currentNode))
       return;
-    const s = this.currentNode.querySelector(m);
-    if (!s)
+    const r = this.currentNode.querySelector(m);
+    if (!r)
       return;
-    const r = this._getMergeTag(e);
-    this.api.getDocumentModifier().modifyHtml(s).setAttribute("href", r).apply(new d(`Updated unsubscribe link to ${r}`)), this.api.getDocumentModifier().modifyHtml(this.currentNode).setAttribute(n.PAGE_TYPE, e.toString()).setAttribute(n.PAGE_LIST, t).apply(new d("Updated unsubscribe block metadata"));
+    const s = this._getMergeTag(e);
+    this.api.getDocumentModifier().modifyHtml(r).setAttribute("href", s).apply(new b(`Updated unsubscribe link to ${s}`)), this.api.getDocumentModifier().modifyHtml(this.currentNode).setAttribute(i.PAGE_TYPE, e.toString()).setAttribute(i.PAGE_LIST, t).apply(new b("Updated unsubscribe block metadata"));
   }
   _getMergeTag(e) {
-    return D[e] ?? N;
+    return N[e] ?? I;
   }
   _openDrawer() {
     if (!(this.currentNode && this.currentNode.getAttribute("data-unsubscribe-page-type")))
       try {
-        const e = u();
+        const e = a();
         e.typeSelectionDrawerStatus = !0;
       } catch (e) {
         console.error("[UnsubscribeBlock] Failed to open drawer:", e);
       }
   }
   _checkExistingBlocks() {
-    const e = u();
-    e.isGlobalUnsubscribeDisabled = !1, e.isSubscriptionPreferencesCenterDisabled = !1, this.api.getDocumentRoot().querySelectorAll(E).forEach((s) => {
-      if ("getAttribute" in s) {
-        const r = s.getAttribute(n.PAGE_TYPE);
-        if (r) {
-          const i = Number(r);
-          i === h.GLOBAL_UNSUBSCRIBE ? e.isGlobalUnsubscribeDisabled = !0 : i === h.SUBSCRIPTION_PREFERENCE_CENTER && (e.isSubscriptionPreferencesCenterDisabled = !0);
+    const e = a();
+    e.isGlobalUnsubscribeDisabled = !1, e.isSubscriptionPreferencesCenterDisabled = !1, this.api.getDocumentRoot().querySelectorAll(_).forEach((r) => {
+      if ("getAttribute" in r) {
+        const s = r.getAttribute(i.PAGE_TYPE);
+        if (s) {
+          const o = Number(s);
+          o === E.GLOBAL_UNSUBSCRIBE ? e.isGlobalUnsubscribeDisabled = !0 : o === E.SUBSCRIPTION_PREFERENCE_CENTER && (e.isSubscriptionPreferencesCenterDisabled = !0);
         }
       }
     });
@@ -244,26 +194,26 @@ class H extends y {
   async _loadBlockState(e) {
     if (!("getAttribute" in e))
       return;
-    const t = e.getAttribute(n.PAGE_TYPE), s = e.getAttribute(n.PAGE_LIST);
-    if (!t || !s)
+    const t = e.getAttribute(i.PAGE_TYPE), r = e.getAttribute(i.PAGE_LIST);
+    if (!t || !r)
       return;
-    const r = u(), i = Number(t), l = B(s);
-    await r.fetchTemplates(), r.setCollectionWithoutAutoSelection(i), r.loadSelectedTemplates(l);
+    const s = a(), o = Number(t), u = p(r);
+    await s.fetchTemplates(), s.setCollectionWithoutAutoSelection(o), s.loadSelectedTemplates(u);
   }
   _resetStoreState() {
-    u().$reset();
+    a().$reset();
   }
   _removeBlockTemplatesFromStore(e) {
     if (!("getAttribute" in e))
       return;
-    const t = e.getAttribute(n.PAGE_LIST);
+    const t = e.getAttribute(i.PAGE_LIST);
     if (!t)
       return;
-    const s = u(), r = B(t);
-    s.removeUnsubscribePages(r);
+    const r = a(), s = p(t);
+    r.removeUnsubscribePages(s);
   }
 }
 export {
-  C as UNSUBSCRIBE_BLOCK_ID,
-  H as UnsubscribeBlock
+  y as UNSUBSCRIBE_BLOCK_ID,
+  F as UnsubscribeBlock
 };

package/dist/src/enums/toaster.d.ts

@@ -1,5 +1,6 @@
 export declare enum ToasterTypeOptions {
     Success = "success",
     Warning = "warning",
-    Alert = "alert"
+    Alert = "alert",
+    Dark = "dark"
 }

package/dist/src/extensions/Blocks/Recommendation/block.d.ts

@@ -55,6 +55,19 @@ export declare class RecommendationBlock extends Block {
      * @param node - The block node being deleted
      */
     onDelete(node: ImmutableHtmlNode): void;
+    /**
+     * Warns (dark advisory toaster) when the design holds more than one live
+     * recommendation block. Triggered from the user-add paths only (fresh drop
+     * and duplicate) — never from document-load/migration, so opening a template
+     * that already has multiple blocks does not fire it. `onCreated` also runs
+     * for a reco block that arrives inside a saved structure (SD-143028), so this
+     * covers that case too — no separate `module_dropped` handling is needed.
+     *
+     * Counting lives in `useRecommendationBlockWarning`, whose DOM-based logic
+     * ignores the empty shells deletions leave behind (SD-143028). Wrapped in
+     * try/catch because the document root may be unavailable during initial load.
+     */
+    private _warnIfMultipleBlocks;
     /**
      * Generates the next unique recommendation ID by scanning all existing blocks
      * in the document and finding the maximum existing ID + 1.

package/dist/src/extensions/Blocks/Recommendation/block.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/extensions/Blocks/Recommendation/useRecommendationBlockWarning.d.ts

@@ -0,0 +1,12 @@
+import type { QueryableRoot } from './utils/recommendationBlockCount';
+/**
+ * Advisory shown when a design ends up with more than one recommendation block,
+ * since multiple blocks can slow campaign delivery. Driven from the block
+ * lifecycle (`onCreated` for direct drop / duplicate, counting the editor's
+ * document root). `onCreated` also fires for a reco block that arrives inside a
+ * saved structure (SD-143028), so that case is covered without a separate
+ * `module_dropped` re-check.
+ */
+export declare const useRecommendationBlockWarning: () => {
+    warnIfMultipleBlocks: (root: QueryableRoot) => void;
+};

package/dist/src/extensions/Blocks/Recommendation/utils/recommendationBlockCount.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Counts *live* recommendation blocks in a document.
+ *
+ * Deleting a recommendation block strips its inner content but leaves an empty
+ * `.recommendation-block-v2` container shell behind — present in every document
+ * representation the editor exposes (`getDocumentRoot`, `getDocumentRootHtmlNode`
+ * and even `getTemplateData`). A raw class count therefore over-reports after a
+ * delete→add cycle (SD-143028). The product row (`.recommendation-product-row`)
+ * is present on every live block from drop time (the default template ships
+ * product rows, both grid and list layouts) and is removed from a deleted
+ * block's leftover shell, so filtering by it cleanly separates live blocks from
+ * ghosts without reading any store.
+ */
+export declare const RECOMMENDATION_BLOCK_SELECTOR = ".recommendation-block-v2";
+export declare const RECOMMENDATION_PRODUCT_ROW_SELECTOR = ".recommendation-product-row";
+interface QueryableNode {
+    querySelector(selector: string): unknown;
+}
+export interface QueryableRoot {
+    querySelectorAll(selector: string): Iterable<QueryableNode>;
+}
+/**
+ * Counts the live recommendation blocks reachable from `root`. Works on the
+ * editor's `ImmutableHtmlNode` document root (the `onCreated` drop / duplicate
+ * paths) and on any DOM-like root exposing `querySelectorAll`.
+ */
+export declare function countLiveRecommendationBlocks(root: QueryableRoot): number;
+export {};

package/dist/src/extensions/Blocks/Recommendation/utils/recommendationBlockCount.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/extensions/Blocks/Unsubscribe/block.d.ts

@@ -6,7 +6,6 @@ export declare class UnsubscribeBlock extends Block {
     private cancelEventListener;
     private currentNode?;
     private linkStateByBlockId;
-    private guardAttemptsByBlockId;
     constructor();
     getId(): string;
     getIcon(): string;
@@ -16,17 +15,9 @@ export declare class UnsubscribeBlock extends Block {
     getTemplate(): string;
     getContextActionsIds(): string[];
     onSelect(node: ImmutableHtmlElementNode): void;
-    onCreated(node: ImmutableHtmlNode): void;
-    onDocumentInit(): void;
     onDocumentChanged(node: ImmutableHtmlNode): void;
     onDelete(node: ImmutableHtmlElementNode): void;
     onDestroy(): void;
-    /**
-     * Guarantees a plain-text node before the link's wrapper inside the <p>.
-     * Without it the only caret position left of the link is inside the anchor,
-     * so anything typed there becomes part of the link (SD-143097).
-     */
-    private _ensureLeadingTextGuard;
     private _hasUnsubscribeLink;
     private _readBlockId;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@useinsider/guido",
-  "version": "3.6.0-beta.5cbaa8f",
+  "version": "3.6.0-beta.6c3407e",
   "description": "Guido is a Vue + TypeScript wrapper for Email Plugin. Easily embed the email editor in your Vue applications.",
   "main": "./dist/guido.umd.cjs",
   "module": "./dist/library.js",