@useinsider/guido 3.6.0-beta.3e80683 → 3.6.0-beta.46ce04f

package/dist/src/config/migrator/recommendation/htmlBuilder.d.ts

@@ -8,4 +8,12 @@ export declare function buildBlockHtml(params: {
     extraClasses?: string;
     legacyId?: string;
     legacyBgColor?: string;
+    /**
+     * When set, the block's existing inner HTML is preserved verbatim instead
+     * of regenerating product rows — used for partner-customized blocks so
+     * their hand-authored `{{...}}` variables survive migration.
+     */
+    preserveInnerHtml?: string;
+    /** Adds the `ins-skip-compile` opt-out class to the migrated block. */
+    skipCompile?: boolean;
 }): string;

package/dist/src/extensions/Blocks/Recommendation/constants/index.d.ts

@@ -8,6 +8,6 @@
  */
 export { RecommendationBlockId } from './blockIds';
 export { RecommendationControlId } from './controlIds';
-export { BLOCK_ROOT_SELECTOR, CONTAINER_SELECTOR, DESKTOP_CONTAINER_SELECTOR, MOBILE_CONTAINER_SELECTOR, MOBILE_ROW_SELECTOR, CSS_CLASS_RECO_BUTTON, CURRENCY_ATTR, ATTR_PRODUCT_IMAGE, ATTR_PRODUCT_NAME, ATTR_PRODUCT_PRICE, ATTR_PRODUCT_OLD_PRICE, ATTR_PRODUCT_OMNIBUS_PRICE, ATTR_PRODUCT_OMNIBUS_DISCOUNT, ATTR_PRODUCT_BUTTON, ATTR_CUSTOM_PREFIX, ATTR_DATA_CUSTOM_ATTRIBUTES, ATTR_PRODUCT_ATTR, BUILT_IN_DEFAULT_ATTRIBUTES, } from './selectors';
+export { BLOCK_ROOT_SELECTOR, CONTAINER_SELECTOR, DESKTOP_CONTAINER_SELECTOR, MOBILE_CONTAINER_SELECTOR, MOBILE_ROW_SELECTOR, CSS_CLASS_RECO_BUTTON, CSS_CLASS_SKIP_COMPILE, RECOMMENDATION_VARIABLE_BUILTIN_ATTRIBUTES, CURRENCY_ATTR, ATTR_PRODUCT_IMAGE, ATTR_PRODUCT_NAME, ATTR_PRODUCT_PRICE, ATTR_PRODUCT_OLD_PRICE, ATTR_PRODUCT_OMNIBUS_PRICE, ATTR_PRODUCT_OMNIBUS_DISCOUNT, ATTR_PRODUCT_BUTTON, ATTR_CUSTOM_PREFIX, ATTR_DATA_CUSTOM_ATTRIBUTES, ATTR_PRODUCT_ATTR, BUILT_IN_DEFAULT_ATTRIBUTES, } from './selectors';
 export { LAYOUT_VALUES, LAYOUT_OPTIONS, DEFAULT_PRODUCTS_PER_ROW, DEFAULT_CARDS_IN_ROW, DEFAULT_MOBILE_CARDS_IN_ROW, MAX_PRODUCT_COUNT, MIN_PRODUCT_COUNT, MAX_PRODUCTS_PER_ROW, MIN_PRODUCTS_PER_ROW, MAX_MOBILE_PRODUCTS_PER_ROW, MIN_MOBILE_PRODUCTS_PER_ROW, DEFAULT_COLUMN_SPACING, DEFAULT_ROW_SPACING, DEFAULT_MOBILE_COLUMN_SPACING, DEFAULT_MOBILE_ROW_SPACING, MIN_SPACING, MAX_SPACING, SPACING_STEP, } from './layout';
 export { DEFAULT_NODE_CONFIG, DEFAULT_CURRENCY, DEFAULT_COMPOSITION, DEFAULT_VISIBILITY, CURRENT_CONFIG_VERSION, EXCLUDED_ALGORITHM_IDS, } from './defaultConfig';

package/dist/src/extensions/Blocks/Recommendation/constants/selectors.d.ts

@@ -23,6 +23,18 @@ export declare const MOBILE_ROW_SELECTOR = ".ins-recommendation-mobile-row";
  * `{{cId_pIdx_url}}` template variable.
  */
 export declare const CSS_CLASS_RECO_BUTTON = "reco-v3-button";
+/**
+ * Opt-out class for partners who want to inject their own template variables
+ * into a recommendation block. When present on `.recommendation-block-v2`,
+ * Guido skips ONLY its product-data → template-variable substitution
+ * (`replaceProductAttributes`) for that block — partners author their own
+ * `{{recoId_index_attribute}}` variables. Everything else (campaign URL
+ * building, hidden-row removal, Outlook image widths, text-trim CSS, discount
+ * conditions, store hydration, store-level config validation, and general HTML
+ * optimizations) still applies. The class is preserved in the final compiled
+ * output so partners may use it for their own styling.
+ */
+export declare const CSS_CLASS_SKIP_COMPILE = "ins-skip-compile";
 /**
  * Currency HTML attributes set on the block element
  * These are read by the HTML compiler at runtime to format prices
@@ -61,3 +73,12 @@ export declare const ATTR_PRODUCT_ATTR = "product-attr";
  * Used to exclude these from the custom attribute dropdown to prevent duplication with toggles.
  */
 export declare const BUILT_IN_DEFAULT_ATTRIBUTES: Set<string>;
+/**
+ * Attribute names valid inside a `{{recoId_index_attributeName}}` template
+ * variable regardless of the account's custom attribute list. Every built-in
+ * composition attribute is valid, plus `currency` and `discount` which the
+ * compiler emits but are not composition toggles. Custom attributes are
+ * validated separately against the account's fetched attribute list
+ * (`stripo/email-recommendation-attributes`).
+ */
+export declare const RECOMMENDATION_VARIABLE_BUILTIN_ATTRIBUTES: Set<string>;

package/dist/src/extensions/Blocks/Recommendation/controls/cardComposition/index.d.ts

@@ -17,6 +17,13 @@ export declare class RecommendationCardCompositionControl extends CommonControl
     getId(): string;
     getTemplate(): string;
     onRender(): void;
+    /**
+     * Card composition restructures the block (toggles/reorders/adds attribute
+     * cells), which would corrupt a partner-managed (`ins-skip-compile`) block's
+     * preserved markup. There is no native tab-disable API, so the whole control
+     * container is rendered inert (greyed + non-interactive) instead.
+     */
+    _syncDisabledState(): void;
     onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
     onDestroy(): void;
     private _initializeComposition;

package/dist/src/extensions/Blocks/Recommendation/controls/main/layoutOrientation.d.ts

@@ -21,6 +21,11 @@ export declare class LayoutOrientationControl extends CommonControl {
     getTemplate(): string;
     onRender(): void;
     onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
+    /**
+     * Layout orientation restructures the whole block, which is meaningless for
+     * partner-managed (`ins-skip-compile`) blocks — disable the control there.
+     */
+    _syncDisabledState(): void;
     _setFormValues(): void;
     /**
      * Handles layout change

package/dist/src/extensions/Blocks/Recommendation/controls/main/productLayout.d.ts

@@ -30,6 +30,12 @@ export declare class ProductLayoutControl extends CommonControl {
     getTemplate(): string;
     onRender(): void;
     onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
+    /**
+     * Products-per-row and mobile-layout restructure the block, which is
+     * meaningless for partner-managed (`ins-skip-compile`) blocks — disable
+     * these inputs there. Disabling coexists with the visibility logic above.
+     */
+    _syncDisabledState(): void;
     onDestroy(): void;
     _setFormValues(): void;
     /**

package/dist/src/extensions/Blocks/Recommendation/controls/main/utils.d.ts

@@ -35,6 +35,15 @@ interface DocumentModifier {
  * @returns The block element or null if not found
  */
 export declare function getBlockElement(currentNode: ImmutableHtmlNode | null | undefined): ImmutableHtmlNode | null;
+/**
+ * True when the recommendation block has opted out of Guido's content
+ * regeneration via the `ins-skip-compile` class. Partner-managed blocks carry
+ * hand-authored `{{...}}` variables in their cells, so Guido must never
+ * overwrite their content with product data (regenerate / in-place update).
+ * @param currentNode - The current template node
+ * @returns True if the block opted out of content regeneration
+ */
+export declare function isPartnerManagedBlock(currentNode: ImmutableHtmlNode | null | undefined): boolean;
 /**
  * Gets the current layout orientation from the block's data attribute
  * Supports both old (horizontal/vertical) and new (list/grid) values for backward compatibility

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

@@ -0,0 +1,7 @@
+/**
+ * Returns the extra recommendation feed query params for an account, if any.
+ * Accounts without customizations get an empty object.
+ * @param partnerName Account subdomain (`config.partner.name`)
+ * @param strategy    Recommendation strategy key of the block
+ */
+export declare function getPartnerRecommendationParams(partnerName: string, strategy: string): Record<string, string>;

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

@@ -1,20 +1,4 @@
 import type { SavedTemplateDetails } from '@@/Types/stripo';
-/**
- * Collects every unsubscribe page id referenced by the unsubscribe blocks
- * present in the email HTML, deduped.
- *
- * The email's unsubscribe link is variation-scoped on the backend, which
- * resolves the page to render from the page ids the FE persists for that
- * variation. Those ids must reflect the blocks actually in the email — not a
- * UI-only selection store — otherwise a block that entered the editor by any
- * path other than the page-selection UI (e.g. a dropped saved module) sends an
- * empty association and the backend falls back to the default page.
- *
- * Read from raw editor HTML: the `data-unsubscribe-page-list` attribute lives
- * on the block node there (the save-time sync-module extractor relies on the
- * same source), so it is reliably present regardless of how the block was added.
- */
-export declare function getHtmlReferencedUnsubscribePages(html: string): number[];
 export declare const useTemplatePreparation: () => {
     prepareTemplateDetails: () => Promise<Omit<SavedTemplateDetails, "metadata">>;
 };

package/dist/utils/templatePreparation.js

@@ -1,58 +1,58 @@
-import { useActionsApi as T } from "../composables/useActionsApi.js";
-import { useHtmlCompiler as D } from "../composables/useHtmlCompiler.js";
-import { DEFAULT_CURRENCY as l, DEFAULT_NODE_CONFIG as a } from "../extensions/Blocks/Recommendation/constants/defaultConfig.js";
+import { useActionsApi as C } from "../composables/useActionsApi.js";
+import { useHtmlCompiler as T } from "../composables/useHtmlCompiler.js";
+import { DEFAULT_CURRENCY as d, DEFAULT_NODE_CONFIG as s } from "../extensions/Blocks/Recommendation/constants/defaultConfig.js";
 import { useRecommendationExtensionStore as b } from "../extensions/Blocks/Recommendation/store/recommendation.js";
-import { DATA_ATTRIBUTES as h } from "../extensions/Blocks/Unsubscribe/utils/constants.js";
-import { parsePageList as P } from "../extensions/Blocks/Unsubscribe/utils/utils.js";
-import { useDynamicContentStore as w } from "../stores/dynamic-content.js";
-import { useUnsubscribeStore as E } from "../stores/unsubscribe.js";
-function U(c) {
-  const n = new DOMParser().parseFromString(c, "text/html").querySelectorAll(`[${h.PAGE_LIST}]`), t = [];
-  return n.forEach((s) => {
-    const r = s.getAttribute(h.PAGE_LIST);
-    r && t.push(...P(r));
-  }), [...new Set(t)];
+import { DATA_ATTRIBUTES as S } from "../extensions/Blocks/Unsubscribe/utils/constants.js";
+import { parsePageList as D } from "../extensions/Blocks/Unsubscribe/utils/utils.js";
+import { useDynamicContentStore as P } from "../stores/dynamic-content.js";
+import { useUnsubscribeStore as w } from "../stores/unsubscribe.js";
+function E(i, o) {
+  const t = new DOMParser().parseFromString(i, "text/html").querySelectorAll(`[${S.PAGE_LIST}]`), c = [];
+  return t.forEach((r) => {
+    const a = r.getAttribute(S.PAGE_LIST);
+    a && c.push(...D(a));
+  }), o.filter((r) => c.includes(r));
 }
-async function F(c) {
-  const i = new DOMParser().parseFromString(c, "text/html").querySelectorAll(".recommendation-block-v2");
-  if (i.length === 0)
+async function U(i) {
+  const m = new DOMParser().parseFromString(i, "text/html").querySelectorAll(".recommendation-block-v2");
+  if (m.length === 0)
     return;
-  const n = b();
-  i.forEach((t) => {
-    var p, g, f, o, y;
-    const s = t.getAttribute("recommendation-id"), r = s ? Number(s) : NaN;
+  const l = b();
+  m.forEach((t) => {
+    var g, f, u, n, y;
+    const c = t.getAttribute("recommendation-id"), r = c ? Number(c) : NaN;
     if (!Number.isFinite(r))
       return;
-    const d = t.getAttribute("esd-ext-config");
-    if (!d)
+    const a = t.getAttribute("esd-ext-config");
+    if (!a)
       return;
     let e;
     try {
-      e = JSON.parse(d);
+      e = JSON.parse(a);
     } catch {
       return;
     }
     if (!e || typeof e != "object" || Array.isArray(e))
       return;
-    const m = {
-      strategy: e.strategy ?? a.strategy,
-      language: e.language ?? a.language,
-      size: e.size ?? a.size,
+    const p = {
+      strategy: e.strategy ?? s.strategy,
+      language: e.language ?? s.language,
+      size: e.size ?? s.size,
       // Spread the default arrays so each block gets a fresh reference
       // instead of sharing the singleton in DEFAULT_NODE_CONFIG.
-      productIds: e.productIds ?? [...a.productIds],
-      filters: e.filters ?? [...a.filters],
-      shuffleProducts: e.shuffleProducts ?? a.shuffleProducts,
-      currencyCode: ((p = e.currency) == null ? void 0 : p.code) ?? l.code,
-      currencyAlignment: ((g = e.currency) == null ? void 0 : g.alignment) ?? l.alignment,
-      currencyDecimalCount: ((f = e.currency) == null ? void 0 : f.decimalCount) ?? l.decimalCount,
-      currencyDecimalSeparator: ((o = e.currency) == null ? void 0 : o.decimalSeparator) ?? l.decimalSeparator,
-      currencyThousandSeparator: ((y = e.currency) == null ? void 0 : y.thousandSeparator) ?? l.thousandSeparator
+      productIds: e.productIds ?? [...s.productIds],
+      filters: e.filters ?? [...s.filters],
+      shuffleProducts: e.shuffleProducts ?? s.shuffleProducts,
+      currencyCode: ((g = e.currency) == null ? void 0 : g.code) ?? d.code,
+      currencyAlignment: ((f = e.currency) == null ? void 0 : f.alignment) ?? d.alignment,
+      currencyDecimalCount: ((u = e.currency) == null ? void 0 : u.decimalCount) ?? d.decimalCount,
+      currencyDecimalSeparator: ((n = e.currency) == null ? void 0 : n.decimalSeparator) ?? d.decimalSeparator,
+      currencyThousandSeparator: ((y = e.currency) == null ? void 0 : y.thousandSeparator) ?? d.thousandSeparator
     };
-    n.seedBlockUrlConfig(r, m);
+    l.seedBlockUrlConfig(r, p);
   });
   try {
-    await n.fetchRecommendationCreateData();
+    await l.fetchRecommendationCreateData();
   } catch (t) {
     console.warn(
       "Recommendation reference data pre-load failed; validator will skip the availability check.",
@@ -60,43 +60,42 @@ async function F(c) {
     );
   }
 }
-const k = () => {
-  const c = w(), u = E(), { getCompiledEmail: i, getTemplateData: n } = T(), { compileHtml: t } = D();
+const _ = () => {
+  const i = P(), o = w(), { getCompiledEmail: m, getTemplateData: l } = C(), { compileHtml: t } = T();
   return {
     prepareTemplateDetails: async () => {
-      const { html: r, ampHtml: d = "", ampErrors: e = [] } = await i({
+      const { html: r, ampHtml: a = "", ampErrors: e = [] } = await m({
         minimize: !0,
         resetDataSavedFlag: !1
-      }), { html: m, css: p, syncModulesIds: g = [] } = await n();
-      u.selectedUnsubscribePages.length && await u.fetchTemplates(), await F(m);
-      const { compiledHtml: f, stats: o, appliedRules: y } = t(r), A = c.getSelectedDynamicContentList, C = b(), S = U(m);
+      }), { html: p, css: g, syncModulesIds: f = [] } = await l();
+      o.selectedUnsubscribePages.length && await o.fetchTemplates(), await U(p);
+      const { compiledHtml: u, stats: n, appliedRules: y } = t(r), h = i.getSelectedDynamicContentList, A = b();
       return console.debug("HTML Compilation Stats:", {
-        originalSize: o.originalSize,
-        compiledSize: o.compiledSize,
-        reduction: `${o.reductionPercentage.toFixed(2)}%`,
+        originalSize: n.originalSize,
+        compiledSize: n.compiledSize,
+        reduction: `${n.reductionPercentage.toFixed(2)}%`,
         appliedRules: y,
-        executionTime: `${o.executionTime.toFixed(2)}ms`
+        executionTime: `${n.executionTime.toFixed(2)}ms`
       }), {
-        dynamicContentList: A,
-        compiledHtml: f,
-        rawHtml: m,
-        css: p,
-        ampHtml: d,
+        dynamicContentList: h,
+        compiledHtml: u,
+        rawHtml: p,
+        css: g,
+        ampHtml: a,
         ampErrors: e,
-        modules: g.map(Number),
+        modules: f.map(Number),
         recommendation: {
-          campaignUrls: C.recommendationCampaignUrls,
+          campaignUrls: A.recommendationCampaignUrls,
           configs: {}
         },
         unsubscribe: {
-          status: S.length > 0,
-          config: S
+          status: o.unsubscribePagesStatus,
+          config: E(u, o.selectedUnsubscribePages)
         }
       };
     }
   };
 };
 export {
-  U as getHtmlReferencedUnsubscribePages,
-  k as useTemplatePreparation
+  _ as useTemplatePreparation
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@useinsider/guido",
-  "version": "3.6.0-beta.3e80683",
+  "version": "3.6.0-beta.46ce04f",
   "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",