@useinsider/guido 3.3.0-beta.86ea9cd → 3.3.0-beta.fb07834

package/dist/composables/useHtmlValidator.js

@@ -1,35 +1,37 @@
-import { useConfig as L } from "./useConfig.js";
-import { TemplateTypes as V } from "../enums/defaults.js";
-import { DISPLAY_CONDITIONS_REGEX as _, DISPLAY_CONDITIONS_EXCEPTIONS_REGEX as H, CampaignCouldNotBeSavedKey as P, CanNotMakeAnyChangesForRunningKey as G } from "../enums/html-validator.js";
+import { useConfig as _ } from "./useConfig.js";
+import { TemplateTypes as H } from "../enums/defaults.js";
+import { DISPLAY_CONDITIONS_REGEX as P, DISPLAY_CONDITIONS_EXCEPTIONS_REGEX as G, CampaignCouldNotBeSavedKey as M, CanNotMakeAnyChangesForRunningKey as $ } from "../enums/html-validator.js";
 import { ToasterTypeOptions as c } from "../enums/toaster.js";
-import { itemsBlockDynamicVariables as M } from "../extensions/Blocks/Items/enums/productEnums.js";
-import { useRecommendationStore as $ } from "../stores/recommendation.js";
-import { base64EncodeWithSpecialChars as X } from "../utils/base64.js";
-import { useHttp as j } from "./useHttp.js";
-import { useToaster as q } from "./useToaster.js";
-import { useTranslations as z } from "./useTranslations.js";
-const K = /recommendation-id="(\d+)"/g;
-function U(a) {
-  return [...a.matchAll(K)].map((u) => u[1]);
+import { itemsBlockDynamicVariables as q } from "../extensions/Blocks/Items/enums/productEnums.js";
+import { useRecommendationExtensionStore as X } from "../extensions/Blocks/Recommendation/store/recommendation.js";
+import { RecommendationRequiredFieldsKey as j } from "../extensions/Blocks/Recommendation/validation/requiredFields.js";
+import { useRecommendationStore as K } from "../stores/recommendation.js";
+import { base64EncodeWithSpecialChars as z } from "../utils/base64.js";
+import { useHttp as U } from "./useHttp.js";
+import { useToaster as Y } from "./useToaster.js";
+import { useTranslations as Z } from "./useTranslations.js";
+const J = /recommendation-id="(\d+)"/g;
+function Q(a) {
+  return [...a.matchAll(J)].map((u) => u[1]);
 }
-function Y(a, u) {
+function ee(a, u) {
   return u.some((d) => a.startsWith(`${d}_`));
 }
-const ce = () => {
+const ge = () => {
   var y, h;
-  const { showToaster: a } = q(), { post: u } = j(), { config: d } = L(), r = z(), g = $(), p = ((h = (y = d.value) == null ? void 0 : y.partner) == null ? void 0 : h.messageType) === V.transactional, b = async (e) => {
+  const { showToaster: a } = Y(), { post: u } = U(), { config: d } = _(), r = Z(), g = K(), S = X(), p = ((h = (y = d.value) == null ? void 0 : y.partner) == null ? void 0 : h.messageType) === H.transactional, b = async (e) => {
     const t = await u(
       "/newsletter/template-library/check-template-html-body",
-      { html: X(e) }
+      { html: z(e) }
     ), { status: n, message: l } = t.data;
     return n || a({
       type: c.Alert,
       message: n === void 0 ? l : r("newsletter.invalid-url-link-for-toaster")
-    }), r(P), l === r(G) && a({
+    }), r(M), l === r($) && a({
       type: c.Alert,
       message: r("newsletter.already-in-progress")
     }), n;
-  }, w = (e) => !["if", "endif", "else", "elif", "now"].includes(e.toLowerCase()), S = (e) => ["if", "endif"].includes(e.toLowerCase()), E = (e, s) => {
+  }, w = (e) => !["if", "endif", "else", "elif", "now"].includes(e.toLowerCase()), E = (e) => ["if", "endif"].includes(e.toLowerCase()), A = (e, s) => {
     const t = e.match(/({%(.*?)%})/g);
     let n = !0;
     return t !== null && !p && t.forEach((l) => {
@@ -42,13 +44,13 @@ const ce = () => {
         }), n = !1);
       }
     }), n;
-  }, A = async (e, s, t) => {
+  }, k = async (e, s, t) => {
     const n = t ? await b(e) : !0;
-    return E(e, s) && n;
-  }, I = (e) => e.length > 0 ? !0 : (a({
+    return A(e, s) && n;
+  }, x = (e) => e.length > 0 ? !0 : (a({
     type: c.Warning,
     message: r("newsletter.html-content-is-empty")
-  }), !1), k = (e) => {
+  }), !1), I = (e) => {
     const s = (e.match(/{/gm) || []).length, t = (e.match(/}/gm) || []).length;
     return s > t && a({
       type: c.Warning,
@@ -57,7 +59,7 @@ const ce = () => {
       type: c.Warning,
       message: r("custom-fields.missing-opening-braces")
     }), s === t;
-  }, x = (e) => {
+  }, F = (e) => {
     const s = e.match(/{{\s*(\w+\s+((\w+\|\w+)|(\w+)))\s*}}/gm) === null;
     return s || a({
       type: c.Warning,
@@ -66,10 +68,10 @@ const ce = () => {
   }, T = (e, s) => {
     const t = e.match(/{{([a-zA-Z0-9_\s]*)}}/gm);
     if (t && !p) {
-      const n = new Set(s.map((i) => i.toLowerCase())), l = U(e), o = [];
+      const n = new Set(s.map((i) => i.toLowerCase())), l = Q(e), o = [];
       if (t.forEach((i) => {
         const m = i.slice(2, -2).trim().toLowerCase();
-        (!n.has(m) || m === "") && !Y(m, l) && o.push(m);
+        (!n.has(m) || m === "") && !ee(m, l) && o.push(m);
       }), o.length > 0) {
         const i = `
                     <ul>
@@ -83,11 +85,11 @@ const ce = () => {
       }
     }
     return !0;
-  }, F = (e) => {
+  }, R = (e) => {
     const s = e.match(/{%(.*?)%}/g), t = [];
     let n = !0;
     if (s && s.forEach((l) => {
-      const o = l.match(_), i = l.match(H), m = (o == null ? void 0 : o.join("")) || "";
+      const o = l.match(P), i = l.match(G), m = (o == null ? void 0 : o.join("")) || "";
       (!o || l !== m) && !i && (a({
         type: c.Alert,
         message: r("newsletter.display-conditions-invalid-syntax")
@@ -98,7 +100,7 @@ const ce = () => {
         }), n = !1);
         const v = f.match(/^[a-zA-Z]*$/g);
         v && v.forEach((C) => {
-          S(C) && t.push(C);
+          E(C) && t.push(C);
         });
       });
     }), t.length) {
@@ -109,25 +111,28 @@ const ce = () => {
       }), n = !1);
     }
     return n;
-  }, W = (e) => {
+  }, B = (e) => {
     const s = (e.match(/{% /gm) || []).length, t = (e.match(/ %}/gm) || []).length, n = s === t;
     return n || a({
       type: c.Warning,
       message: r("custom-conditions.no-space-after-braces")
     }), n;
-  }, N = (e) => (e.match(/({%(.*?)%})/g) || []).filter((t) => t.includes("if")).map((t) => (t.match(/{{.*}}/gm) || []).length).reduce((t, n) => t + n, 0) > 0 ? (a({
+  }, W = (e) => (e.match(/({%(.*?)%})/g) || []).filter((t) => t.includes("if")).map((t) => (t.match(/{{.*}}/gm) || []).length).reduce((t, n) => t + n, 0) > 0 ? (a({
     type: c.Warning,
     message: r("custom-conditions.no-braces-inside-if-tag")
+  }), !1) : !0, N = () => S.hasInvalidBlock() ? (a({
+    type: c.Alert,
+    message: r(j)
   }), !1) : !0, O = () => g.recommendationConfigs && Object.values(g.recommendationConfigs).find((s) => s.filters.find((t) => t.value === "")) !== void 0 ? (a({
     type: c.Alert,
     message: r("newsletter.fill-all-necessary-fields")
-  }), !1) : !0, B = (e) => {
+  }), !1) : !0, D = (e) => {
     const s = /src="[^"]*\.(svg|pst)"/gm;
     return e.match(s) === null ? !0 : (a({
       type: c.Alert,
       message: r("newsletter.invalid-image-type")
     }), !1);
-  }, R = (e) => {
+  }, L = (e) => {
     const n = new DOMParser().parseFromString(e, "text/html").querySelectorAll(".checkbox-block-v2");
     return Array.from(n).find((o) => {
       var i;
@@ -136,7 +141,7 @@ const ce = () => {
       type: c.Alert,
       message: r("unsubscribe-templates.select-checkbox-groups")
     }), !1) : !0;
-  }, D = (e) => {
+  }, V = (e) => {
     const n = new DOMParser().parseFromString(e, "text/html").querySelectorAll(".radio-button-v2");
     return Array.from(n).find((o) => {
       var i;
@@ -150,12 +155,12 @@ const ce = () => {
     var o, i;
     const n = [
       ...s.map((m) => m.value),
-      ...M,
+      ...q,
       ...((i = (o = d.value) == null ? void 0 : o.template) == null ? void 0 : i.customFieldAttributes) ?? []
     ];
-    return await A(e, n, t) && I(e) && k(e) && x(e) && T(e, n) && F(e) && W(e) && N(e) && O() && B(e) && R(e) && D(e);
+    return await k(e, n, t) && x(e) && I(e) && F(e) && T(e, n) && R(e) && B(e) && W(e) && N() && O() && D(e) && L(e) && V(e);
   } };
 };
 export {
-  ce as useHtmlValidator
+  ge as useHtmlValidator
 };

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

@@ -1,33 +1,33 @@
-var k = Object.defineProperty;
-var _ = (r, n, t) => n in r ? k(r, n, { enumerable: !0, configurable: !0, writable: !0, value: t }) : r[n] = t;
-var g = (r, n, t) => _(r, typeof n != "symbol" ? n + "" : n, t);
-import { BlockId as B } from "../../../enums/block.js";
-import { getMigrationBannerHtml as b } from "../../../utils/migrationBannerHtml.js";
-import { Block as R, BlockCompositionType as y, ModificationDescription as C } from "../../../node_modules/@stripoinc/ui-editor-extensions/dist/esm/index.js";
-import { regenerateMobileProductRows as A } from "./controls/main/utils.js";
-import { ensureMobileCssRulesExist as d, setMobileLayoutOptOut as p, hasMobileLayoutOptOut as D } from "./controls/mobileLayout/cssRules.js";
-import { RecommendationConfigService as s } from "./services/configService.js";
-import { useRecommendationExtensionStore as f } from "./store/recommendation.js";
+var I = Object.defineProperty;
+var k = (r, n, t) => n in r ? I(r, n, { enumerable: !0, configurable: !0, writable: !0, value: t }) : r[n] = t;
+var u = (r, n, t) => k(r, typeof n != "symbol" ? n + "" : n, t);
+import { BlockId as _ } from "../../../enums/block.js";
+import { getMigrationBannerHtml as B } from "../../../utils/migrationBannerHtml.js";
+import { Block as b, BlockCompositionType as R, ModificationDescription as y } from "../../../node_modules/@stripoinc/ui-editor-extensions/dist/esm/index.js";
+import { regenerateMobileProductRows as C } from "./controls/main/utils.js";
+import { ensureMobileCssRulesExist as g, setMobileLayoutOptOut as d, hasMobileLayoutOptOut as A } from "./controls/mobileLayout/cssRules.js";
+import { RecommendationConfigService as c } from "./services/configService.js";
+import { useRecommendationExtensionStore as p } from "./store/recommendation.js";
 import { getDefaultTemplate as E } from "./templates/grid/template.js";
-const h = B.Recommendation, l = "recommendation-block-v2", m = "recommendation-id";
-let I = !1;
-class v extends R {
+const f = _.Recommendation, l = "recommendation-block-v2", m = "recommendation-id";
+let h = !1;
+class q extends b {
   constructor() {
     super();
     /**
      * Stores the ID generated in getTemplate() so onCreated() can reuse it.
      * This avoids generating a new (different) ID in onCreated().
      */
-    g(this, "_pendingBlockId", null);
+    u(this, "_pendingBlockId", null);
   }
   getId() {
-    return h;
+    return f;
   }
   getIcon() {
     return "recommendation-icon";
   }
   getBlockCompositionType() {
-    return y.CONTAINER;
+    return R.CONTAINER;
   }
   getName() {
     return this.api.translate("Recommendation Block");
@@ -38,8 +38,8 @@ class v extends R {
     );
   }
   getSettingsPanelTitleHtml() {
-    return b(
-      h,
+    return B(
+      f,
       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.")
     );
@@ -71,20 +71,13 @@ class v extends R {
       return;
     const i = this._pendingBlockId ?? this._generateNextId();
     this._pendingBlockId = null, this._assignRecommendationId(t, i);
-    const { config: o, wasFreshDrop: c } = s.initializeConfig(
-      this.api,
-      t,
-      { recommendationId: i }
-    ), a = f();
-    if (a.setCurrentBlock(i), c) {
-      d(this.api);
-      const u = this._getBlockElement(t);
-      u && (p(this.api, u, !0), A({
-        currentNode: t,
-        documentModifier: this.api.getDocumentModifier()
-      }));
-    }
-    a.patchCurrentBlockConfig({ language: o.language }, { triggerRefetch: !1 });
+    const o = c.initializeConfig(this.api, t, { recommendationId: i }), s = p();
+    s.setCurrentBlock(i), g(this.api);
+    const a = this._getBlockElement(t);
+    a && (d(this.api, a, !0), C({
+      currentNode: t,
+      documentModifier: this.api.getDocumentModifier()
+    })), s.patchCurrentBlockConfig({ language: o.language }, { triggerRefetch: !1 });
   }
   /**
    * Called when the document changes or template is loaded
@@ -97,20 +90,20 @@ class v extends R {
     if (!(!t || !("getNodeConfig" in t))) {
       if (!this._getRecommendationId(t)) {
         const e = this._generateNextId();
-        this._assignRecommendationId(t, e), s.hasConfig(t) && s.updateConfig(
+        this._assignRecommendationId(t, e), c.hasConfig(t) && c.updateConfig(
           this.api,
           t,
           { recommendationId: e },
           "Assign recommendation ID to legacy block"
         );
       }
-      s.needsMigration(t) && this._migrateFromLegacy(t);
+      c.needsMigration(t) && this._migrateFromLegacy(t);
       try {
-        I || (d(this.api), I = !0);
-        const e = s.getConfig(t), i = this._getBlockElement(t);
+        h || (g(this.api), h = !0);
+        const e = c.getConfig(t), i = this._getBlockElement(t);
         if (i) {
           const o = !e.mobileLayoutEnabled;
-          D(i) !== o && p(this.api, i, o);
+          A(i) !== o && d(this.api, i, o);
         }
       } catch {
       }
@@ -124,7 +117,7 @@ class v extends R {
    */
   onDelete(t) {
     const e = this._getRecommendationId(t);
-    e && f().removeBlockState(e);
+    e && p().removeBlockState(e);
   }
   /**
    * Generates the next unique recommendation ID by scanning all existing blocks
@@ -136,7 +129,7 @@ class v extends R {
       const e = this.api.getDocumentRoot();
       e && "querySelectorAll" in e && e.querySelectorAll(`.${l}`).forEach((o) => {
         if ("getAttribute" in o) {
-          const c = o.getAttribute(m), a = c ? parseInt(c) : 0;
+          const s = o.getAttribute(m), a = s ? parseInt(s) : 0;
           a > t && (t = a);
         }
       });
@@ -155,7 +148,7 @@ class v extends R {
     if (!i)
       return;
     const o = this.api.getDocumentModifier();
-    o.modifyHtml(i).setAttribute(m, e.toString()), o.apply(new C(`Assign recommendation ID ${e}`));
+    o.modifyHtml(i).setAttribute(m, e.toString()), o.apply(new y(`Assign recommendation ID ${e}`));
   }
   /**
    * Gets the recommendation-id from a block node
@@ -185,10 +178,10 @@ class v extends R {
    * Migrate configuration from legacy format
    */
   _migrateFromLegacy(t) {
-    s.migrateFromDataAttributes(this.api, t);
+    c.migrateFromDataAttributes(this.api, t);
   }
 }
 export {
-  h as BLOCK_ID,
-  v as RecommendationBlock
+  f as BLOCK_ID,
+  q as RecommendationBlock
 };

package/dist/extensions/Blocks/Recommendation/services/configService.js

@@ -1,5 +1,5 @@
-import { ModificationDescription as C } from "../../../../node_modules/@stripoinc/ui-editor-extensions/dist/esm/index.js";
-import { CURRENT_CONFIG_VERSION as l, DEFAULT_NODE_CONFIG as c } from "../constants/defaultConfig.js";
+import { ModificationDescription as h } from "../../../../node_modules/@stripoinc/ui-editor-extensions/dist/esm/index.js";
+import { CURRENT_CONFIG_VERSION as l, DEFAULT_NODE_CONFIG as r } from "../constants/defaultConfig.js";
 import { setCurrencyAttributes as D } from "../controls/main/utils.js";
 import { hasMinimalConfig as A } from "../types/nodeConfig.js";
 function S(e) {
@@ -8,7 +8,7 @@ function S(e) {
 function N(e) {
   return e === "." || e === "," || e === " " || e === "";
 }
-class M {
+class V {
   // ========================================================================
   // Read Operations
   // ========================================================================
@@ -83,7 +83,7 @@ class M {
    * @returns The new complete configuration
    */
   static updateConfig(i, t, o, n) {
-    const r = this.getConfig(t), u = this.deepMerge(r, o);
+    const c = this.getConfig(t), u = this.deepMerge(c, o);
     return this.saveConfig(i, t, u, n), u;
   }
   /**
@@ -91,28 +91,21 @@ class M {
    *
    * Called when a block is first created (dropped into template).
    * Can optionally merge in partial config from migration.
-   *
-   * The `wasFreshDrop` flag distinguishes a brand-new drop (no prior config)
-   * from a clone (Stripo replays the source's setNodeConfig payload before
-   * onCreated fires). Callers use this to skip side-effects already inherited
-   * from the source.
    * @example
    * // In Block.onCreated lifecycle
-   * const { config, wasFreshDrop } = RecommendationConfigService.initializeConfig(this.api, node);
+   * RecommendationConfigService.initializeConfig(this.api, node);
    * @param api - Stripo extension API with document modifier
    * @param node - The immutable HTML node to initialize
    * @param partialConfig - Optional partial config to merge with defaults
-   * @returns The initialized configuration and whether the node was a fresh drop
+   * @returns The initialized configuration
    */
   static initializeConfig(i, t, o) {
-    if (this.hasConfig(t))
-      return { config: o ? this.updateConfig(i, t, o, "Initialize recommendation block") : this.getConfig(t), wasFreshDrop: !1 };
     const n = o ? this.mergeWithDefaults(o) : this.cloneDefaults();
     return this.saveConfig(i, t, n, "Initialize recommendation block"), D({
       currentNode: t,
       documentModifier: i.getDocumentModifier(),
       currency: n.currency
-    }), { config: n, wasFreshDrop: !0 };
+    }), n;
   }
   /**
    * Save complete configuration to a node
@@ -125,9 +118,9 @@ class M {
    */
   static saveConfig(i, t, o, n) {
     try {
-      i.getDocumentModifier().modifyHtml(t).setNodeConfig(o).apply(new C(n));
-    } catch (r) {
-      console.warn("[RecommendationConfigService] Failed to save config:", r);
+      i.getDocumentModifier().modifyHtml(t).setNodeConfig(o).apply(new h(n));
+    } catch (c) {
+      console.warn("[RecommendationConfigService] Failed to save config:", c);
     }
   }
   // ========================================================================
@@ -164,29 +157,29 @@ class M {
           s && typeof s == "object" && (Object.assign(o, s), o.configVersion = l);
         } catch {
         }
-      const r = t.getAttribute("data-layout");
-      r === "list" || r === "horizontal" ? o.layout = "list" : (r === "grid" || r === "vertical") && (o.layout = "grid");
+      const c = t.getAttribute("data-layout");
+      c === "list" || c === "horizontal" ? o.layout = "list" : (c === "grid" || c === "vertical") && (o.layout = "grid");
       const u = t.getAttribute("data-card-composition");
       u && (o.composition = u.split(",").filter(Boolean));
-      const b = t.getAttribute("data-column-spacing");
-      b && (o.columnSpacing = parseInt(b) || c.columnSpacing);
-      const p = t.getAttribute("data-row-spacing");
-      if (p && (o.rowSpacing = parseInt(p) || c.rowSpacing), !o.currency) {
+      const p = t.getAttribute("data-column-spacing");
+      p && (o.columnSpacing = parseInt(p) || r.columnSpacing);
+      const b = t.getAttribute("data-row-spacing");
+      if (b && (o.rowSpacing = parseInt(b) || r.rowSpacing), !o.currency) {
         const s = t.getAttribute("currency"), y = t.getAttribute("currency-symbol"), d = t.getAttribute("currency-alignment"), f = t.getAttribute("currency-thousand-separator"), g = t.getAttribute("currency-decimal-separator"), m = t.getAttribute("currency-decimal-count");
         if (s || y || d || f || g || m) {
-          const a = c.currency, h = m ? parseInt(m) : NaN;
+          const a = r.currency, C = m ? parseInt(m) : NaN;
           o.currency = {
             code: s ?? a.code,
             symbol: y ?? a.symbol,
             alignment: d === "0" ? "before" : "after",
-            decimalCount: Number.isFinite(h) ? h : a.decimalCount,
+            decimalCount: Number.isFinite(C) ? C : a.decimalCount,
             decimalSeparator: S(g) ? g : a.decimalSeparator,
             thousandSeparator: N(f) ? f : a.thousandSeparator
           };
         }
       }
     }
-    return this.initializeConfig(i, t, o).config;
+    return this.initializeConfig(i, t, o);
   }
   /**
    * Check if configuration needs migration
@@ -204,12 +197,12 @@ class M {
    */
   static cloneDefaults() {
     return {
-      ...c,
-      currency: { ...c.currency },
-      omnibusPrice: { ...c.omnibusPrice },
-      omnibusDiscount: { ...c.omnibusDiscount },
-      composition: [...c.composition],
-      visibility: { ...c.visibility },
+      ...r,
+      currency: { ...r.currency },
+      omnibusPrice: { ...r.omnibusPrice },
+      omnibusDiscount: { ...r.omnibusDiscount },
+      composition: [...r.composition],
+      visibility: { ...r.visibility },
       filters: [],
       productIds: [],
       recommendationId: 0
@@ -279,5 +272,5 @@ class M {
   }
 }
 export {
-  M as RecommendationConfigService
+  V as RecommendationConfigService
 };

package/dist/extensions/Blocks/Recommendation/store/recommendation.js

@@ -7,8 +7,9 @@ import { EXCLUDED_ALGORITHM_IDS as D } from "../constants/defaultConfig.js";
 import { getDefaultProducts as g } from "../templates/utils.js";
 import { generateCompleteFilterQuery as b } from "../utils/filterUtil.js";
 import { isFilterValid as w } from "../validation/filterSchema.js";
+import { isConfigValid as v } from "../validation/requiredFields.js";
 const h = C();
-let u = null, m = null, d = null;
+let m = null, u = null, d = null;
 function k() {
   return {
     cardsInRow: F,
@@ -48,7 +49,7 @@ function I() {
     filterSnapshot: null
   };
 }
-const v = () => ({
+const N = () => ({
   recommendationCampaignUrls: {},
   activePredictiveAlgorithms: [],
   languages: {},
@@ -57,8 +58,8 @@ const v = () => ({
   blockStates: {},
   currentRecommendationId: null,
   configVersion: 0
-}), _ = P("guidoRecommendationExtension", {
-  state: () => v(),
+}), M = P("guidoRecommendationExtension", {
+  state: () => N(),
   getters: {
     // ====================================================================
     // Proxy Getters — Backward Compatible Access to Current Block State
@@ -293,11 +294,11 @@ const v = () => ({
     // ====================================================================
     async fetchRecommendationCreateData() {
       if (!this.activePredictiveAlgorithms.length) {
-        if (u) {
-          await u;
+        if (m) {
+          await m;
           return;
         }
-        u = (async () => {
+        m = (async () => {
           const {
             activePredictiveAlgorithms: t,
             languages: e,
@@ -310,26 +311,26 @@ const v = () => ({
           this.currencyList = r;
         })();
         try {
-          await u;
+          await m;
         } finally {
-          u = null;
+          m = null;
         }
       }
     },
     async fetchRecommendationFilters() {
       if (!Object.keys(this.filterList).length) {
-        if (m) {
-          await m;
+        if (u) {
+          await u;
           return;
         }
-        m = (async () => {
+        u = (async () => {
           const t = await h.fetchRecommendationFilters();
           this.filterList = t;
         })();
         try {
-          await m;
+          await u;
         } finally {
-          m = null;
+          u = null;
         }
       }
     },
@@ -398,6 +399,14 @@ const v = () => ({
     generateFilterQuery() {
       return b(this.recommendationConfigs.filters);
     },
+    /**
+     * Validation-only check invoked at save-CTA time. Defined as an action
+     * (not a getter) so reading it does not register reactive tracking on
+     * every block's recommendationConfigs across user edits.
+     */
+    hasInvalidBlock() {
+      return Object.values(this.blockStates).some((t) => !v(t.recommendationConfigs, this));
+    },
     // ====================================================================
     // Per-Block Product Fetching
     // ====================================================================
@@ -443,5 +452,5 @@ const v = () => ({
   }
 });
 export {
-  _ as useRecommendationExtensionStore
+  M as useRecommendationExtensionStore
 };

package/dist/extensions/Blocks/Recommendation/validation/requiredFields.js

@@ -0,0 +1,33 @@
+const o = [
+  {
+    key: "locale",
+    getValue: (e) => e.language,
+    getAvailableOptions: (e) => Object.keys(e.languages)
+  },
+  {
+    key: "currency",
+    getValue: (e) => e.currencySettings.value,
+    getAvailableOptions: (e) => e.currencyList.map((n) => n.text)
+  }
+], l = "newsletter.recommendation-fill-required-fields";
+function u(e, n) {
+  return o.filter((t) => {
+    var a;
+    if (t.condition && !t.condition(e))
+      return !1;
+    const i = t.getValue(e);
+    if (!i)
+      return !0;
+    const r = (a = t.getAvailableOptions) == null ? void 0 : a.call(t, n);
+    return r !== void 0 && !r.includes(i);
+  }).map((t) => t.key);
+}
+function s(e, n) {
+  return u(e, n).length === 0;
+}
+export {
+  o as REQUIRED_RECOMMENDATION_FIELDS,
+  l as RecommendationRequiredFieldsKey,
+  u as getInvalidFields,
+  s as isConfigValid
+};

package/dist/src/extensions/Blocks/Recommendation/services/configService.d.ts

@@ -95,23 +95,15 @@ export declare class RecommendationConfigService {
      *
      * Called when a block is first created (dropped into template).
      * Can optionally merge in partial config from migration.
-     *
-     * The `wasFreshDrop` flag distinguishes a brand-new drop (no prior config)
-     * from a clone (Stripo replays the source's setNodeConfig payload before
-     * onCreated fires). Callers use this to skip side-effects already inherited
-     * from the source.
      * @example
      * // In Block.onCreated lifecycle
-     * const { config, wasFreshDrop } = RecommendationConfigService.initializeConfig(this.api, node);
+     * RecommendationConfigService.initializeConfig(this.api, node);
      * @param api - Stripo extension API with document modifier
      * @param node - The immutable HTML node to initialize
      * @param partialConfig - Optional partial config to merge with defaults
-     * @returns The initialized configuration and whether the node was a fresh drop
+     * @returns The initialized configuration
      */
-    static initializeConfig(api: DocumentModifierApi, node: ImmutableHtmlNode, partialConfig?: PartialNodeConfig): {
-        config: RecommendationNodeConfig;
-        wasFreshDrop: boolean;
-    };
+    static initializeConfig(api: DocumentModifierApi, node: ImmutableHtmlNode, partialConfig?: PartialNodeConfig): RecommendationNodeConfig;
     /**
      * Save complete configuration to a node
      *

package/dist/src/extensions/Blocks/Recommendation/store/recommendation.d.ts

@@ -1,5 +1,5 @@
 import type { Orientation, Languages, Currency, NumericSeparator, FiltersResponse, Filter, RecommendationProduct } from '@@/Types/recommendation';
-interface PerBlockConfigs {
+export interface PerBlockConfigs {
     cardsInRow: number;
     currencySettings: {
         name: string;
@@ -272,6 +272,12 @@ export declare const useRecommendationExtensionStore: import("pinia").StoreDefin
     deleteFilter(filter: Filter): void;
     addFilter(filter: Filter): void;
     generateFilterQuery(): string;
+    /**
+     * Validation-only check invoked at save-CTA time. Defined as an action
+     * (not a getter) so reading it does not register reactive tracking on
+     * every block's recommendationConfigs across user edits.
+     */
+    hasInvalidBlock(): boolean;
     fetchRecommendationProducts(): Promise<void>;
     _doFetchProducts(): Promise<void>;
 }>;

package/dist/src/extensions/Blocks/Recommendation/validation/requiredFields.d.ts

@@ -0,0 +1,21 @@
+import type { PerBlockConfigs } from '../store/recommendation';
+import type { Currency, Languages } from '@@/Types/recommendation';
+/**
+ * Structural slice of the recommendation extension store that descriptors may read.
+ * Add new fields here when a future descriptor needs them.
+ */
+export interface ExtensionStoreSlice {
+    languages: Languages;
+    currencyList: Currency[];
+}
+interface RequiredField {
+    key: string;
+    getValue: (config: PerBlockConfigs) => string;
+    getAvailableOptions?: (store: ExtensionStoreSlice) => string[];
+    condition?: (config: PerBlockConfigs) => boolean;
+}
+export declare const REQUIRED_RECOMMENDATION_FIELDS: RequiredField[];
+export declare const RecommendationRequiredFieldsKey = "newsletter.recommendation-fill-required-fields";
+export declare function getInvalidFields(config: PerBlockConfigs, store: ExtensionStoreSlice): string[];
+export declare function isConfigValid(config: PerBlockConfigs, store: ExtensionStoreSlice): boolean;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@useinsider/guido",
-  "version": "3.3.0-beta.86ea9cd",
+  "version": "3.3.0-beta.fb07834",
   "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",