@useinsider/guido 3.17.0-beta.ddd4dde → 3.17.0-beta.e23d5cd

package/dist/services/recommendationApi.js

@@ -1,52 +1,91 @@
-import { useHttp as d } from "../composables/useHttp.js";
-import { QUERY_PARAMS as l, URLS as u } from "../enums/extensions/recommendationBlock.js";
-const R = (o) => o.reduce(
-  (a, t, s) => (a[s] = {
-    attributeName: t.attributeName,
-    attributeJs: t.attributeJs,
-    attributeType: t.attributeType,
-    type: t.type,
-    displayName: t.displayName,
-    isFilterable: t.isFilterable
-  }, a),
+import { useHttp as l } from "../composables/useHttp.js";
+import { URLS as m, QUERY_PARAMS as u } from "../enums/extensions/recommendationBlock.js";
+const y = "[sr_strategies.status][=][active]*[sr_strategies.suitable_channels][~][EMAIL]", R = (c) => c.reduce(
+  (s, r, i) => (s[i] = {
+    attributeName: r.attributeName,
+    attributeJs: r.attributeJs,
+    attributeType: r.attributeType,
+    type: r.type,
+    displayName: r.displayName,
+    isFilterable: r.isFilterable
+  }, s),
   {}
-), f = () => {
-  const { get: o } = d(), { get: a } = d({ headers: {} }), t = "6KcLM9TwheVB1mgK";
+), _ = () => {
+  const { get: c, post: s } = l(), { get: r } = l({ headers: {} }), i = "6KcLM9TwheVB1mgK";
   return {
     fetchRecommendationCreateData: async () => {
       try {
-        return (await o("/newsletter/recommendations/create-data")).data;
+        return (await c("/newsletter/recommendations/create-data")).data;
       } catch (e) {
         throw console.error("fetchUserModalState error:", e), e;
       }
     },
     fetchRecommendationFilters: async () => {
       try {
-        const { data: e } = await o(
-          u.PRODUCT_ATTRIBUTES_PATH
-        ), n = Array.isArray(e) ? e : (e == null ? void 0 : e.data) ?? [];
-        return R(n);
+        const { data: e } = await c(
+          m.PRODUCT_ATTRIBUTES_PATH
+        ), o = Array.isArray(e) ? e : (e == null ? void 0 : e.data) ?? [];
+        return R(o);
       } catch (e) {
         throw console.error("fetchRecommendationFilters error:", e), e;
       }
     },
-    fetchRecommendationProducts: async (e, n) => {
-      var i;
+    fetchRecommendationProducts: async (e, o) => {
+      var t;
       try {
-        const r = new URLSearchParams(Object.entries(n));
-        r.set(l.CLIENT_ID, t);
-        const m = decodeURIComponent(r.toString());
-        console.debug("🏁 Recommendation API Query:", m);
-        const c = await a(
-          `${u.RECOMMENDATION_API_URL}/v2/${e}?${m}`
+        const n = new URLSearchParams(Object.entries(o));
+        n.set(u.CLIENT_ID, i);
+        const d = decodeURIComponent(n.toString());
+        console.debug("🏁 Recommendation API Query:", d);
+        const a = await r(
+          `${m.RECOMMENDATION_API_URL}/v2/${e}?${d}`
         );
-        return ((i = c == null ? void 0 : c.data) == null ? void 0 : i.data) ?? [];
-      } catch (r) {
-        throw console.error("fetchRecommendationProducts error:", r), r;
+        return ((t = a == null ? void 0 : a.data) == null ? void 0 : t.data) ?? [];
+      } catch (n) {
+        throw console.error("fetchRecommendationProducts error:", n), n;
+      }
+    },
+    fetchRecommendationProductsByUrl: async (e) => {
+      var o;
+      try {
+        const t = new RegExp(`[?&]${u.CLIENT_ID}=`).test(e), n = e.includes("?") ? "&" : "?", d = t ? e : `${e}${n}${u.CLIENT_ID}=${i}`, a = await r(
+          d
+        );
+        return ((o = a == null ? void 0 : a.data) == null ? void 0 : o.data) ?? [];
+      } catch (t) {
+        return console.error("fetchRecommendationProductsByUrl error:", t), [];
+      }
+    },
+    fetchRecommendationStrategies: async () => {
+      try {
+        const { data: e } = await c(
+          `${m.RECOMMENDATION_STRATEGIES_PATH}?filters=${encodeURIComponent(y)}`
+        );
+        return Array.isArray(e) ? e : (e == null ? void 0 : e.data) ?? [];
+      } catch (e) {
+        throw console.error("fetchRecommendationStrategies error:", e), e;
+      }
+    },
+    generateStrategyEndpoint: async (e, o) => {
+      try {
+        const { data: t } = await s(
+          `${m.RECOMMENDATION_STRATEGIES_PATH}/endpoint-generate`,
+          {
+            campaignId: 0,
+            pageTypes: [],
+            isPreviewer: !1,
+            strategy: e,
+            userId: "",
+            currency: o
+          }
+        );
+        return !t || typeof t != "object" || !("full_path" in t || "data" in t) ? (console.error("generateStrategyEndpoint unexpected response shape:", t), null) : "full_path" in t ? t : t.data;
+      } catch (t) {
+        return console.error("generateStrategyEndpoint error:", t), null;
       }
     }
   };
 };
 export {
-  f as useRecommendationApi
+  _ as useRecommendationApi
 };

package/dist/src/@types/config/schemas.d.ts

@@ -395,6 +395,7 @@ export declare const FeaturesSchema: v.ObjectSchema<{
     readonly allowlistEnabled: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
     /** Enable persistent link tracking-id assignment for the click heatmap (opt-in) */
     readonly linkTrackingIds: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
+    readonly reusableRecommendationStrategy: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
 }, undefined>;
 /**
  * Default block types available in Stripo
@@ -794,6 +795,7 @@ export declare const GuidoConfigSchema: v.ObjectSchema<{
         readonly allowlistEnabled: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
         /** Enable persistent link tracking-id assignment for the click heatmap (opt-in) */
         readonly linkTrackingIds: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
+        readonly reusableRecommendationStrategy: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
     }, undefined>, {}>;
     /** Block configuration */
     readonly blocks: v.OptionalSchema<v.ObjectSchema<{

package/dist/src/components/organisms/extensions/recommendation/AssignStrategyDrawer.vue.d.ts

@@ -0,0 +1,3 @@
+import '@useinsider/design-system-organisms/style';
+declare const _default: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue/types/v3-component-options.js").ComponentOptionsMixin, import("vue/types/v3-component-options.js").ComponentOptionsMixin, {}, string, Readonly<import("vue").ExtractPropTypes<{}>>, {}>;
+export default _default;

package/dist/src/components/organisms/extensions/recommendation/StrategyInfoBoxContent.vue.d.ts

@@ -0,0 +1,15 @@
+import type { RrsStrategy } from '@@/Types/recommendation';
+type __VLS_Props = {
+    strategy: RrsStrategy;
+};
+declare const _default: import("vue").DefineComponent<__VLS_TypePropsToOption<__VLS_Props>, {}, {}, {}, {}, import("vue/types/v3-component-options.js").ComponentOptionsMixin, import("vue/types/v3-component-options.js").ComponentOptionsMixin, {}, string, Readonly<import("vue").ExtractPropTypes<__VLS_TypePropsToOption<__VLS_Props>>>, {}>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToOption<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};

package/dist/src/composables/useConfig.d.ts

@@ -99,6 +99,7 @@ export declare const useConfig: () => {
             autosave: boolean;
             allowlistEnabled: boolean;
             linkTrackingIds: boolean;
+            reusableRecommendationStrategy: boolean;
         };
         blocks: {
             excludeDefaults: ("amp-accordion" | "amp-carousel" | "amp-form-controls" | "banner-block" | "button-block" | "html-block" | "image-block" | "menu-block" | "social-block" | "spacer-block" | "text-block" | "timer-block" | "video-block")[];
@@ -233,6 +234,7 @@ export declare const useConfig: () => {
         autosave: boolean;
         allowlistEnabled: boolean;
         linkTrackingIds: boolean;
+        reusableRecommendationStrategy: boolean;
     } | null>;
     blocks: import("vue").ComputedRef<{
         excludeDefaults: ("amp-accordion" | "amp-carousel" | "amp-form-controls" | "banner-block" | "button-block" | "html-block" | "image-block" | "menu-block" | "social-block" | "spacer-block" | "text-block" | "timer-block" | "video-block")[];

package/dist/src/composables/useRecommendation.d.ts

@@ -18,6 +18,7 @@ export declare const useRecommendation: () => {
     getRecommendationCampaignData: (id: string) => CampaignData;
     buildCampaignUrl: (campaignId: string, overrides?: {
         strategy: string;
+        strategyId: string;
         language: string;
         currencyCode: string;
         size: string;

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

@@ -8,5 +8,6 @@ export declare const ACADEMY_LINKS: {
     readonly EMAIL_EDITOR: "https://academy.insiderone.com/docs/email-drag-and-drop-editor";
     readonly GLOBAL_UNSUBSCRIBE: "https://academy.insiderone.com/docs/global-unsubscribe-preference-center";
     readonly AMP_FOR_EMAILS: "https://academy.insiderone.com/docs/amp-for-emails";
+    readonly EMAIL_RECOMMENDATION_BLOCK: "https://academy.insiderone.com/docs/new-editor-email-recommendation-block";
 };
 export type AcademyLinkKey = keyof typeof ACADEMY_LINKS;

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

@@ -1,4 +1,5 @@
 export declare const DEFAULT_LOCALE = "tr-TR";
+export declare const DOTTED_DATE_LOCALE = "tr-TR";
 export declare const DEFAULT = "default";
 export declare const DEFAULT_TZ = "UTC";
 export declare const FORMAT_MAPPING: Record<string, string>;

package/dist/src/enums/extensions/recommendationBlock.d.ts

@@ -3,6 +3,8 @@ import type { RecommendationFeedItem } from '@@/Types/recommendation';
 export declare const URLS: {
     RECOMMENDATION_API_URL: string;
     PRODUCT_ATTRIBUTES_PATH: string;
+    RECOMMENDATION_STRATEGIES_PATH: string;
+    RECOMMENDATION_STRATEGIES_PANEL_PATH: string;
 };
 export declare const QUERY_PARAMS: {
     CLIENT_ID: string;

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

@@ -16,8 +16,6 @@ export declare const BLOCK_ID: BlockId;
  * - Onboarding support
  */
 export declare class ItemsBlock extends Block {
-    /** Block instances whose currency attrs were already self-healed this session (SD-147588 — undo-safe). */
-    private _currencyHealed;
     getId(): string;
     getIcon(): string;
     getBlockCompositionType(): BlockCompositionType;
@@ -44,23 +42,4 @@ export declare class ItemsBlock extends Block {
      * relies on this td-level fallback in pairProductVariables.
      */
     private _stampProductTdDomAttributes;
-    /**
-     * Whether the currency self-heal should run for this block. Two guards (SD-147588):
-     * 1. Config is only authoritative when the symbol was actually customized — a symbol still at
-     *    the 'USD' sentinel may be a migrator default, so we trust the DOM's real value over a
-     *    defaulted config and never overwrite it.
-     * 2. Heal each instance at most once per session, so the auto-fix can't fight undo (undo
-     *    re-drifts the attr, which would otherwise re-trigger the heal forever).
-     */
-    private _shouldReconcileCurrency;
-    /** Marks a block instance's currency as reconciled so it is not healed again (undo-safe). */
-    private _markCurrencyHealed;
-    /**
-     * Stamps the export-read currency attrs onto every price `<p>` from config, so a template whose
-     * attrs drifted (e.g. a location toggle before the sync fix) self-heals to match the editor.
-     * Config is the source of truth — never derive from visible text. Callers gate this with
-     * `_shouldReconcileCurrency`. Returns true only when an attr actually changed, so the caller can
-     * skip an empty apply that would otherwise re-trigger onDocumentChanged and loop (SD-147588).
-     */
-    private _reconcileCurrencyDomAttributes;
 }

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

@@ -8,6 +8,8 @@
  * - Merging partial updates with existing config
  */
 import type { RecommendationNodeConfig, CurrencyConfig, OmnibusTextConfig } from '../types/nodeConfig';
+export declare const PRE_RRS_CONFIG_VERSION = 1;
+export declare const CURRENT_CONFIG_VERSION = 2;
 /**
  * Default currency configuration
  * Uses USD as the base currency with standard formatting
@@ -47,9 +49,3 @@ export declare const DEFAULT_NODE_CONFIG: RecommendationNodeConfig;
  * View Together and Purchase Together algorithms are disabled because these require product id.
  */
 export declare const EXCLUDED_ALGORITHM_IDS: number[];
-/**
- * Current configuration version
- * Increment this when making breaking changes to the schema
- * Used for migration detection
- */
-export declare const CURRENT_CONFIG_VERSION = 1;

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

@@ -10,4 +10,4 @@ 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, 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_CARD_COMPOSITION, ATTR_DATA_CUSTOM_ATTRIBUTES, ATTR_PRODUCT_ATTR, SELECTOR_ATTRIBUTE_ROW, ATTR_DATA_ATTRIBUTE_TYPE, PRODUCT_ATTRIBUTE_PREFIX, 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';
+export { DEFAULT_NODE_CONFIG, DEFAULT_CURRENCY, DEFAULT_COMPOSITION, DEFAULT_VISIBILITY, CURRENT_CONFIG_VERSION, PRE_RRS_CONFIG_VERSION, EXCLUDED_ALGORITHM_IDS, } from './defaultConfig';

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

@@ -9,8 +9,9 @@ import { PricePlacementControl, PRICE_PLACEMENT_CONTROL_ID } from './pricePlacem
 import { ProductCountControl, PRODUCT_COUNT_CONTROL_ID } from './productCount';
 import { ProductLayoutControl, PRODUCT_LAYOUT_CONTROL_ID } from './productLayout';
 import { ShuffleControl, SHUFFLE_CONTROL_ID } from './shuffle';
+import { StrategyControl, STRATEGY_CONTROL_ID } from './strategy';
 export declare const CONTROL_BLOCK_ID = "ui-elements-recommendation-block";
-export { AlgorithmControl, ALGORITHM_CONTROL_ID, LocaleControl, LOCALE_CONTROL_ID, CurrencyControl, CURRENCY_CONTROL_ID, ProductCountControl, PRODUCT_COUNT_CONTROL_ID, ProductLayoutControl, PRODUCT_LAYOUT_CONTROL_ID, FiltersControl, FILTERS_CONTROL_ID, ShuffleControl, SHUFFLE_CONTROL_ID, LayoutOrientationControl, LAYOUT_ORIENTATION_CONTROL_ID, PricePlacementControl, PRICE_PLACEMENT_CONTROL_ID, };
+export { AlgorithmControl, ALGORITHM_CONTROL_ID, LocaleControl, LOCALE_CONTROL_ID, CurrencyControl, CURRENCY_CONTROL_ID, ProductCountControl, PRODUCT_COUNT_CONTROL_ID, ProductLayoutControl, PRODUCT_LAYOUT_CONTROL_ID, FiltersControl, FILTERS_CONTROL_ID, ShuffleControl, SHUFFLE_CONTROL_ID, LayoutOrientationControl, LAYOUT_ORIENTATION_CONTROL_ID, PricePlacementControl, PRICE_PLACEMENT_CONTROL_ID, StrategyControl, STRATEGY_CONTROL_ID, };
 export * from './utils';
 /**
  * Main recommendation block control that composes all sub-controls
@@ -19,7 +20,9 @@ export * from './utils';
 export declare class RecommendationBlockControl extends CommonControl {
     private store;
     private storeUnsubscription;
-    private syncedBlockIds;
+    private syncedConfigs;
+    private pendingNodeConfigWrite;
+    private pendingConfigFlushTimer;
     private algorithmControl;
     private localeControl;
     private currencyControl;
@@ -29,8 +32,12 @@ export declare class RecommendationBlockControl extends CommonControl {
     private shuffleControl;
     private pricePlacementControl;
     private layoutOrientationControl;
+    private strategyControl;
+    private rrsEnabled;
     getId(): string;
+    private get _subControls();
     getTemplate(): string;
+    private _showControlsForBlock;
     onRender(): Promise<void>;
     onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
     onDestroy(): void;
@@ -42,7 +49,6 @@ export declare class RecommendationBlockControl extends CommonControl {
     /**
      * Syncs persisted node config into the Pinia store's block state.
      *
-     * setCurrentBlock() creates a default entry (USD, en_US, mostPopular).
      * For saved templates, the real config lives in the node (e.g., TRY, tr_TR).
      * This method reads it and patches the store so fetchRecommendationProducts()
      * uses the correct values.
@@ -50,6 +56,41 @@ export declare class RecommendationBlockControl extends CommonControl {
      * Uses triggerRefetch: false because the fetch hasn't happened yet —
      * values are being prepared for the upcoming initial fetch.
      */
+    /**
+     * Re-syncs the store when the node config moved since we last read it.
+     *
+     * Undo/redo, the code editor and version-history restore rewrite the node
+     * config behind the store's back — Stripo exposes no undo signal, so a
+     * fingerprint diff on this hook is the only way to notice (SD-149105).
+     * An unchanged fingerprint means the move came from us, so runtime store
+     * edits are never clobbered (SD-141049).
+     */
+    private _syncNodeConfigIfChanged;
+    private _capturePendingNodeConfigWrite;
+    /**
+     * Accumulates the pending write into `documentModifier` without applying, so the
+     * caller's apply() commits config and re-render as ONE undo entry.
+     *
+     * Deliberately does not consume the pending record: the product helpers call
+     * apply() only when they actually changed something, so this batch may never be
+     * committed and the flush has to stay able to write it standalone.
+     * @param documentModifier - The batch to accumulate into
+     * @returns Whether anything was staged
+     */
+    private _stagePendingNodeConfig;
+    /**
+     * Arms the guaranteed fallback write. The delay has to outlast the product fetch
+     * and the re-render debounce it triggers — firing earlier writes the config on
+     * its own and the undo entry splits in two again.
+     */
+    private _scheduleConfigFlush;
+    private _clearConfigFlush;
+    /**
+     * Writes the deferred change standalone when the batch it was staged into never
+     * committed. Always targets the LIVE node — the captured one is an immutable
+     * snapshot the intervening re-render staled, and saveConfig swallows that failure.
+     */
+    private _flushPendingNodeConfig;
     private _syncNodeConfigToStore;
     /**
      * Fetches initial data for a block in three phases:
@@ -106,9 +147,4 @@ export declare class RecommendationBlockControl extends CommonControl {
      * We skip that tick and update tracking references instead.
      */
     private _listenStateUpdates;
-    /**
-     * Persists the current filter state from Pinia store to the Stripo node config.
-     * This ensures filters survive template save/reload cycles.
-     */
-    private _persistFiltersToNodeConfig;
 }

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

@@ -0,0 +1,16 @@
+import { CommonControl } from '../../../common-control';
+export declare const STRATEGY_CONTROL_ID = "recommendation-strategy-control";
+export declare class StrategyControl extends CommonControl {
+    private store;
+    private storeUnsubscription;
+    private listeners;
+    private lastPaintedState;
+    getId(): string;
+    getTemplate(): string;
+    private _strategyAction;
+    onRender(): void;
+    onDestroy(): void;
+    private _teardown;
+    private _setupButtonListeners;
+    private _renderState;
+}

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

@@ -25,7 +25,7 @@ import { ModificationDescription } from '@stripoinc/ui-editor-extensions';
  * Stripo Extension API interface for document modifications
  * Extracted to allow type-safe usage without importing full Stripo types
  */
-interface DocumentModifier {
+export interface DocumentModifier {
     modifyHtml: (node: ImmutableHtmlNode) => {
         setNodeConfig: (config: Record<string, unknown>) => DocumentModifier;
         setAttribute: (name: string, value: string) => DocumentModifier;
@@ -90,6 +90,17 @@ export declare class RecommendationConfigService {
      * @returns The new complete configuration
      */
     static updateConfig(api: DocumentModifierApi, node: ImmutableHtmlNode, updates: PartialNodeConfig, description: string): RecommendationNodeConfig;
+    /**
+     * Accumulate a config update into an existing modifier batch, WITHOUT applying.
+     *
+     * The caller owns the apply(), so the write shares one undo entry with the rest
+     * of that batch — a change whose visible result only lands after an async product
+     * fetch would otherwise cost the user two undo presses (SD-149105).
+     * @param documentModifier - The batch to accumulate into (caller applies)
+     * @param node - The immutable HTML node to write to
+     * @param updates - Partial config with values to update
+     */
+    static stageConfig(documentModifier: DocumentModifier, node: ImmutableHtmlNode, updates: PartialNodeConfig): void;
     /**
      * Initialize configuration for a new block
      *