@useinsider/guido 3.16.0-beta.ca26c4e → 3.16.0-beta.efbb91f

package/dist/src/enums/save-validation.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Stable discriminators for each save-validation rule site — one per rule that
+ * can produce a drawer row, kept in sync with the collector + legacy validator chains.
+ */
+export declare enum SaveValidationRule {
+    CouponTagModified = "coupon-tag-modified",
+    DuplicateUnsubBlock = "duplicate-unsub-block",
+    UnsubBlockMissingTemplate = "unsub-block-missing-template",
+    LiquidSyntax = "liquid-syntax",
+    InvalidLinks = "invalid-links",
+    LinkCheckInProgress = "link-check-in-progress",
+    CustomFieldScript = "custom-field-script",
+    EmptyHtml = "empty-html",
+    MismatchedBraces = "mismatched-braces",
+    InvalidDynamicTag = "invalid-dynamic-tag",
+    InvalidCustomField = "invalid-custom-field",
+    ConditionsSyntax = "conditions-syntax",
+    WrongEqualityOperator = "wrong-equality-operator",
+    MissingIfEndif = "missing-if-endif",
+    ConditionTagSpacing = "condition-tag-spacing",
+    BracesInsideIfTag = "braces-inside-if-tag",
+    RecommendationRequiredFields = "recommendation-required-fields",
+    RecommendationFilters = "recommendation-filters",
+    InvalidImageType = "invalid-image-type",
+    CheckboxUnsubGroup = "checkbox-unsub-group",
+    RadioButtonUnsubGroup = "radio-button-unsub-group"
+}

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

@@ -286,6 +286,11 @@ export declare const useRecommendationExtensionStore: import("pinia").StoreDefin
      * every block's recommendationConfigs across user edits.
      */
     hasInvalidBlock(): boolean;
+    /**
+     * Per-instance counterpart to `hasInvalidBlock`: the ids of every block
+     * that fails required-field validation, one drawer row each (SD-147430).
+     */
+    invalidBlockIds(): string[];
     fetchRecommendationProducts(): Promise<void>;
     _doFetchProducts(): Promise<void>;
 }>;

package/dist/src/stores/config.d.ts

@@ -2106,6 +2106,11 @@ export declare const useConfigStore: import("pinia").StoreDefinition<"guido-conf
             };
         } | null;
     } & import("pinia").PiniaCustomStateProperties<ConfigStoreState>) => number;
+    /**
+     * Transactional campaigns keep the hard save block. Reactive getter, so
+     * consumers stay safe in setup where a raw config read snapshots null (SD-147945).
+     */
+    isTransactional(): boolean;
     /**
      * Get the username
      */

package/dist/src/stores/save-validation.d.ts

@@ -0,0 +1,22 @@
+import type { SaveValidationError, SaveValidationIntent } from '@@/Types/save-validation';
+interface SaveValidationState {
+    errors: SaveValidationError[];
+    isDrawerOpen: boolean;
+    intent: SaveValidationIntent | null;
+}
+export declare const useSaveValidationStore: import("pinia").StoreDefinition<"guidoSaveValidation", SaveValidationState, {
+    errorCount: (state: {
+        errors: {
+            rule: import("../enums/save-validation").SaveValidationRule;
+            message: string;
+            detail?: string | undefined;
+            type: import("../enums/toaster").ToasterTypeOptions;
+        }[];
+        isDrawerOpen: boolean;
+        intent: SaveValidationIntent | null;
+    } & import("pinia").PiniaCustomStateProperties<SaveValidationState>) => number;
+}, {
+    open(errors: SaveValidationError[], intent: SaveValidationIntent): void;
+    close(): void;
+}>;
+export {};

package/dist/src/utils/templatePreparation.d.ts

@@ -15,6 +15,36 @@ import type { SavedTemplateDetails } from '@@/Types/stripo';
  * same source), so it is reliably present regardless of how the block was added.
  */
 export declare function getHtmlReferencedUnsubscribePages(html: string): number[];
+/**
+ * Hydrates the recommendation extension store from the persisted `esd-ext-config`
+ * JSON blob on each `.recommendation-block-v2` element in the raw editor HTML.
+ *
+ * Why this runs before `compileHtml`:
+ *   The HTML compiler's `prepareRecommendationBlocks` rule asks
+ *   `useRecommendation.buildCampaignUrl(id)` to assemble each block's API URL
+ *   from `blockStates[id].recommendationConfigs`. That Pinia entry is normally
+ *   populated by `RecommendationBlockControl._syncNodeConfigToStore`, which
+ *   only fires when the user *selects* the block. Saving without ever
+ *   selecting a migrated block would otherwise build the URL from empty/
+ *   default state and the campaign URL would not be saved.
+ *
+ * Why we read raw HTML, not compiled HTML:
+ *   Stripo's `compileEmail()` strips editor-only attributes (`esd-*`) from the
+ *   compiled output, so `esd-ext-config` is gone by the time the compiler
+ *   pipeline sees the HTML. The raw HTML from `getTemplateData()` preserves
+ *   the attribute as the migrator wrote it.
+ *
+ * Reference data pre-load:
+ *   When the template has recommendation blocks, this also pre-loads the
+ *   shared reference data (languages / currency list) so the save-time
+ *   required-fields validator can check each block's locale and currency
+ *   against the partner's real options. Best-effort — on a fetch failure the
+ *   validator degrades to its empty-list guard (`requiredFields.ts`) instead
+ *   of blocking the save or stranding the Save button.
+ */
+declare function hydrateRecommendationStoreFromRawHtml(rawHtml: string): Promise<void>;
 export declare const useTemplatePreparation: () => {
     prepareTemplateDetails: () => Promise<Omit<SavedTemplateDetails, "metadata">>;
+    hydrateRecommendationStore: typeof hydrateRecommendationStoreFromRawHtml;
 };
+export {};

package/dist/stores/config.js

@@ -1,8 +1,8 @@
-import "../@types/config/schemas.js";
+import { MessageType as o } from "../@types/config/schemas.js";
 import "../@types/config/defaults.js";
-import { parseConfig as o } from "../@types/config/validator.js";
-import { defineStore as r } from "pinia";
-const f = r("guido-config", {
+import { parseConfig as r } from "../@types/config/validator.js";
+import { defineStore as a } from "pinia";
+const g = a("guido-config", {
   state: () => ({
     initialized: !1,
     config: null
@@ -113,6 +113,13 @@ const f = r("guido-config", {
       var e, n;
       return ((n = (e = i.config) == null ? void 0 : e.partner) == null ? void 0 : n.messageType) ?? 1;
     },
+    /**
+     * Transactional campaigns keep the hard save block. Reactive getter, so
+     * consumers stay safe in setup where a raw config read snapshots null (SD-147945).
+     */
+    isTransactional() {
+      return this.messageType === o.TRANSACTIONAL;
+    },
     /**
      * Get the username
      */
@@ -143,7 +150,7 @@ const f = r("guido-config", {
      * Initialize the config store with validated configuration
      */
     init(i) {
-      const e = o(i);
+      const e = r(i);
       this.config = e, this.initialized = !0;
     },
     /**
@@ -155,5 +162,5 @@ const f = r("guido-config", {
   }
 });
 export {
-  f as useConfigStore
+  g as useConfigStore
 };

package/dist/stores/save-validation.js

@@ -0,0 +1,30 @@
+import { defineStore as n } from "pinia";
+function i(e) {
+  const t = /* @__PURE__ */ new Set();
+  return e.filter((r) => {
+    const s = JSON.stringify([r.message, r.detail ?? ""]);
+    return t.has(s) ? !1 : (t.add(s), !0);
+  });
+}
+const o = n("guidoSaveValidation", {
+  state: () => ({
+    errors: [],
+    isDrawerOpen: !1,
+    intent: null
+  }),
+  getters: {
+    errorCount: (e) => e.errors.length
+  },
+  actions: {
+    open(e, t) {
+      this.errors = i(e), this.intent = t, this.isDrawerOpen = !0;
+    },
+    // Errors are retained so rows don't blank during the ~300ms close animation.
+    close() {
+      this.isDrawerOpen = !1;
+    }
+  }
+});
+export {
+  o as useSaveValidationStore
+};

package/dist/utils/templatePreparation.js

@@ -1,27 +1,27 @@
-import { useActionsApi as k } from "../composables/useActionsApi.js";
+import { useActionsApi as R } from "../composables/useActionsApi.js";
 import { useConfig as U } from "../composables/useConfig.js";
 import { useHtmlCompiler as x } from "../composables/useHtmlCompiler.js";
 import { DEFAULT_CURRENCY as d, DEFAULT_NODE_CONFIG as s } from "../extensions/Blocks/Recommendation/constants/defaultConfig.js";
-import { useRecommendationExtensionStore as C } from "../extensions/Blocks/Recommendation/store/recommendation.js";
+import { useRecommendationExtensionStore as T } from "../extensions/Blocks/Recommendation/store/recommendation.js";
 import { mapLegacyStrategy as L } from "../extensions/Blocks/Recommendation/utils/legacyStrategyMap.js";
 import { DATA_ATTRIBUTES as A } from "../extensions/Blocks/Unsubscribe/utils/constants.js";
-import { parsePageList as R } from "../extensions/Blocks/Unsubscribe/utils/utils.js";
-import { useDynamicContentStore as N } from "../stores/dynamic-content.js";
-import { useEditorStore as z } from "../stores/editor.js";
-import { useUnsubscribeStore as _ } from "../stores/unsubscribe.js";
-import { assignTrackingIds as v } from "./linkTrackingIds.js";
-function O(m) {
+import { parsePageList as N } from "../extensions/Blocks/Unsubscribe/utils/utils.js";
+import { useDynamicContentStore as z } from "../stores/dynamic-content.js";
+import { useEditorStore as _ } from "../stores/editor.js";
+import { useUnsubscribeStore as v } from "../stores/unsubscribe.js";
+import { assignTrackingIds as O } from "./linkTrackingIds.js";
+function M(m) {
   const n = new DOMParser().parseFromString(m, "text/html").querySelectorAll(`[${A.PAGE_LIST}]`), t = [];
   return n.forEach((i) => {
     const o = i.getAttribute(A.PAGE_LIST);
-    o && t.push(...R(o));
+    o && t.push(...N(o));
   }), [...new Set(t)];
 }
-async function M(m) {
+async function C(m) {
   const a = new DOMParser().parseFromString(m, "text/html").querySelectorAll(".recommendation-block-v2");
   if (a.length === 0)
     return;
-  const n = C();
+  const n = T();
   a.forEach((t) => {
     var r, l, g, f, c;
     const i = t.getAttribute("recommendation-id"), o = i ? Number(i) : NaN;
@@ -68,39 +68,39 @@ async function M(m) {
   }
 }
 const Z = () => {
-  const m = N(), u = z(), a = _(), { getCompiledEmail: n, getTemplateData: t, updateHtmlAndCss: i } = k(), { compileHtml: o, compileAmpHtml: p } = x(), { isFeatureEnabled: e } = U();
+  const m = z(), u = _(), a = v(), { getCompiledEmail: n, getTemplateData: t, updateHtmlAndCss: i } = R(), { compileHtml: o, compileAmpHtml: p } = x(), { isFeatureEnabled: e } = U();
   return {
     prepareTemplateDetails: async () => {
       let { html: r, css: l, syncModulesIds: g = [] } = await t();
       if (e("linkTrackingIds"))
         try {
-          const { html: y, changed: H, nextSeq: I } = v(r, u.trackIdSessionFloor);
-          u.trackIdSessionFloor = I, H && (r = y, await i(y, l));
+          const { html: y, changed: I, nextSeq: k } = O(r, u.trackIdSessionFloor);
+          u.trackIdSessionFloor = k, I && (r = y, await i(y, l));
         } catch (y) {
           console.error("Tracking-id step failed, saving anyway:", y);
         }
-      const { html: f, ampHtml: c = "", ampErrors: T = [] } = await n({
+      const { html: f, ampHtml: c = "", ampErrors: w = [] } = await n({
         minimize: !0,
         resetDataSavedFlag: !1
       });
-      a.selectedUnsubscribePages.length && await a.fetchTemplates(), await M(r);
-      const { compiledHtml: w, stats: S, appliedRules: D } = o(f), E = c && p(c).compiledHtml, P = m.getSelectedDynamicContentList, F = C(), b = O(r);
+      a.selectedUnsubscribePages.length && await a.fetchTemplates(), await C(r);
+      const { compiledHtml: D, stats: S, appliedRules: E } = o(f), P = c && p(c).compiledHtml, F = m.getSelectedDynamicContentList, H = T(), b = M(r);
       return console.debug("HTML Compilation Stats:", {
         originalSize: S.originalSize,
         compiledSize: S.compiledSize,
         reduction: `${S.reductionPercentage.toFixed(2)}%`,
-        appliedRules: D,
+        appliedRules: E,
         executionTime: `${S.executionTime.toFixed(2)}ms`
       }), {
-        dynamicContentList: P,
-        compiledHtml: w,
+        dynamicContentList: F,
+        compiledHtml: D,
         rawHtml: r,
         css: l,
-        ampHtml: E,
-        ampErrors: T,
+        ampHtml: P,
+        ampErrors: w,
         modules: g.map(Number),
         recommendation: {
-          campaignUrls: F.recommendationCampaignUrls,
+          campaignUrls: H.recommendationCampaignUrls,
           configs: {}
         },
         unsubscribe: {
@@ -108,10 +108,13 @@ const Z = () => {
           config: b
         }
       };
-    }
+    },
+    // Exposed so the back/test validate-only path can seed the reco store the
+    // same way a full save does (required-field findings depend on it).
+    hydrateRecommendationStore: C
   };
 };
 export {
-  O as getHtmlReferencedUnsubscribePages,
+  M as getHtmlReferencedUnsubscribePages,
   Z as useTemplatePreparation
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@useinsider/guido",
-  "version": "3.16.0-beta.ca26c4e",
+  "version": "3.16.0-beta.efbb91f",
   "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",