@useinsider/guido 3.18.2-beta.8ef3138 → 3.18.2-beta.963f84e

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

@@ -5,7 +5,9 @@ export declare const URLS: {
     PRODUCT_ATTRIBUTES_PATH: string;
     RECOMMENDATION_STRATEGIES_PATH: string;
     RECOMMENDATION_STRATEGIES_PANEL_PATH: string;
+    RECOMMENDATION_STRATEGY_CREATE_PATH: string;
 };
+export declare const strategyEditPath: (strategyId: string | number) => string;
 export declare const QUERY_PARAMS: {
     CLIENT_ID: string;
 };

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

@@ -10,6 +10,7 @@
 import type { RecommendationNodeConfig, CurrencyConfig, OmnibusTextConfig } from '../types/nodeConfig';
 export declare const PRE_RRS_CONFIG_VERSION = 1;
 export declare const CURRENT_CONFIG_VERSION = 2;
+export declare const RRS_CONFIG_VERSION = 2;
 /**
  * Default currency configuration
  * Uses USD as the base currency with standard formatting

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_RECOMMENDATION_TITLE, SELECTOR_TITLE_CELL, ATTR_CUSTOM_PREFIX, ATTR_DATA_CARD_COMPOSITION, ATTR_DATA_CUSTOM_ATTRIBUTES, ATTR_PRODUCT_ATTR, CSS_CLASS_ATTRIBUTE_ROW, CSS_CLASS_SPACER, SELECTOR_ATTRIBUTE_ROW, ATTR_DATA_ATTRIBUTE_TYPE, ATTR_DATA_VISIBILITY, 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, PRE_RRS_CONFIG_VERSION, EXCLUDED_ALGORITHM_IDS, } from './defaultConfig';
+export { DEFAULT_NODE_CONFIG, DEFAULT_CURRENCY, DEFAULT_COMPOSITION, DEFAULT_VISIBILITY, CURRENT_CONFIG_VERSION, PRE_RRS_CONFIG_VERSION, RRS_CONFIG_VERSION, EXCLUDED_ALGORITHM_IDS, } from './defaultConfig';

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

@@ -70,6 +70,8 @@ export declare class RecommendationBlockControl extends CommonControl {
      * state was rebuilt with (SD-150347).
      */
     private _syncNodeConfigIfChanged;
+    /** Whether the deferred write would move the node's strategyId — see the caller (SD-149916). */
+    private _isPendingStrategyIdChange;
     private _capturePendingNodeConfigWrite;
     /**
      * Accumulates the pending write into `documentModifier` without applying, so the

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

@@ -2,6 +2,7 @@ import { CommonControl } from '../../../common-control';
 export declare const STRATEGY_CONTROL_ID = "recommendation-strategy-control";
 export declare class StrategyControl extends CommonControl {
     private store;
+    private onboardingStore;
     private storeUnsubscription;
     private listeners;
     private lastPaintedState;
@@ -9,6 +10,14 @@ export declare class StrategyControl extends CommonControl {
     getTemplate(): string;
     private _strategyAction;
     onRender(): void;
+    /**
+     * Whether the document itself says this block has no strategy.
+     *
+     * Read the node, not the store: when the main control cannot resolve the block id off the
+     * node it never syncs the persisted config, so the store still holds defaults (empty
+     * strategyId) for an assigned block.
+     */
+    private _isNodeUnassigned;
     onDestroy(): void;
     private _teardown;
     private _setupButtonListeners;

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

@@ -107,7 +107,7 @@ export interface RegenerateWithStylesOptions extends Omit<RegenerateProductRowsO
  * HTML removes the need for any post-rebuild reapply pass.
  * @param options - Configuration options for regeneration
  */
-export declare function regenerateProductRowsWithStyles(options: RegenerateWithStylesOptions): void;
+export declare function regenerateProductRowsWithStyles(options: RegenerateWithStylesOptions): boolean;
 /**
  * Adjusts a products array to a target size.
  * Used by ProductLayoutControl to synchronously match products to the new size
@@ -151,6 +151,11 @@ export interface UpdateProductContentInPlaceOptions {
     currentNode: ImmutableHtmlNode | null | undefined;
     documentModifier: DocumentModifier;
     products: RecommendationProduct[];
+    /**
+     * Called when the batch was actually committed. Identical products commit nothing, which
+     * leaves anything a caller staged into the same batch unwritten unless it applies itself.
+     */
+    onApplied?: () => void;
 }
 /**
  * Updates product content in-place without regenerating HTML structure.
@@ -161,7 +166,7 @@ export interface UpdateProductContentInPlaceOptions {
  * After updating desktop, also updates mobile container to keep them in sync.
  *
  * Falls back to false when product count changed (need to add/remove elements).
- * @param options - Configuration options
+ * @param options - Configuration options; `onApplied` fires only when a batch was committed
  * @returns true if in-place update was successful, false to fall back to full regeneration
  */
 export declare function updateProductContentInPlace(options: UpdateProductContentInPlaceOptions): boolean;

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

@@ -83,8 +83,11 @@ interface StoreState {
     strategies: RrsStrategy[];
     strategiesLoading: boolean;
     strategyUrlTemplates: Record<string, string>;
+    strategiesFetched: boolean;
+    strategiesSettled: boolean;
     blockStates: Record<number, PerBlockState>;
     currentRecommendationId: number | null;
+    strategyPanelOpen: boolean;
     configVersion: number;
 }
 export declare const useRecommendationExtensionStore: import("pinia").StoreDefinition<"guidoRecommendationExtension", StoreState, {
@@ -111,8 +114,11 @@ export declare const useRecommendationExtensionStore: import("pinia").StoreDefin
         }[];
         strategiesLoading: boolean;
         strategyUrlTemplates: Record<string, string>;
+        strategiesFetched: boolean;
+        strategiesSettled: boolean;
         blockStates: Record<number, PerBlockState>;
         currentRecommendationId: number | null;
+        strategyPanelOpen: boolean;
         configVersion: number;
     } & import("pinia").PiniaCustomStateProperties<StoreState>): PerBlockConfigs;
     /**
@@ -137,8 +143,11 @@ export declare const useRecommendationExtensionStore: import("pinia").StoreDefin
         }[];
         strategiesLoading: boolean;
         strategyUrlTemplates: Record<string, string>;
+        strategiesFetched: boolean;
+        strategiesSettled: boolean;
         blockStates: Record<number, PerBlockState>;
         currentRecommendationId: number | null;
+        strategyPanelOpen: boolean;
         configVersion: number;
     } & import("pinia").PiniaCustomStateProperties<StoreState>): RecommendationProduct[];
     /**
@@ -163,8 +172,11 @@ export declare const useRecommendationExtensionStore: import("pinia").StoreDefin
         }[];
         strategiesLoading: boolean;
         strategyUrlTemplates: Record<string, string>;
+        strategiesFetched: boolean;
+        strategiesSettled: boolean;
         blockStates: Record<number, PerBlockState>;
         currentRecommendationId: number | null;
+        strategyPanelOpen: boolean;
         configVersion: number;
     } & import("pinia").PiniaCustomStateProperties<StoreState>): boolean;
     assignStrategyDrawerStatus(state: {
@@ -186,8 +198,11 @@ export declare const useRecommendationExtensionStore: import("pinia").StoreDefin
         }[];
         strategiesLoading: boolean;
         strategyUrlTemplates: Record<string, string>;
+        strategiesFetched: boolean;
+        strategiesSettled: boolean;
         blockStates: Record<number, PerBlockState>;
         currentRecommendationId: number | null;
+        strategyPanelOpen: boolean;
         configVersion: number;
     } & import("pinia").PiniaCustomStateProperties<StoreState>): boolean;
     removeStrategyModalStatus(state: {
@@ -209,8 +224,11 @@ export declare const useRecommendationExtensionStore: import("pinia").StoreDefin
         }[];
         strategiesLoading: boolean;
         strategyUrlTemplates: Record<string, string>;
+        strategiesFetched: boolean;
+        strategiesSettled: boolean;
         blockStates: Record<number, PerBlockState>;
         currentRecommendationId: number | null;
+        strategyPanelOpen: boolean;
         configVersion: number;
     } & import("pinia").PiniaCustomStateProperties<StoreState>): boolean;
     assignedStrategy(state: {
@@ -232,8 +250,11 @@ export declare const useRecommendationExtensionStore: import("pinia").StoreDefin
         }[];
         strategiesLoading: boolean;
         strategyUrlTemplates: Record<string, string>;
+        strategiesFetched: boolean;
+        strategiesSettled: boolean;
         blockStates: Record<number, PerBlockState>;
         currentRecommendationId: number | null;
+        strategyPanelOpen: boolean;
         configVersion: number;
     } & import("pinia").PiniaCustomStateProperties<StoreState>): RrsStrategy | null;
     /**
@@ -258,8 +279,11 @@ export declare const useRecommendationExtensionStore: import("pinia").StoreDefin
         }[];
         strategiesLoading: boolean;
         strategyUrlTemplates: Record<string, string>;
+        strategiesFetched: boolean;
+        strategiesSettled: boolean;
         blockStates: Record<number, PerBlockState>;
         currentRecommendationId: number | null;
+        strategyPanelOpen: boolean;
         configVersion: number;
     } & import("pinia").PiniaCustomStateProperties<StoreState>): boolean;
     /**
@@ -284,8 +308,11 @@ export declare const useRecommendationExtensionStore: import("pinia").StoreDefin
         }[];
         strategiesLoading: boolean;
         strategyUrlTemplates: Record<string, string>;
+        strategiesFetched: boolean;
+        strategiesSettled: boolean;
         blockStates: Record<number, PerBlockState>;
         currentRecommendationId: number | null;
+        strategyPanelOpen: boolean;
         configVersion: number;
     } & import("pinia").PiniaCustomStateProperties<StoreState>): number;
     hasFilters(): boolean;
@@ -311,8 +338,11 @@ export declare const useRecommendationExtensionStore: import("pinia").StoreDefin
         }[];
         strategiesLoading: boolean;
         strategyUrlTemplates: Record<string, string>;
+        strategiesFetched: boolean;
+        strategiesSettled: boolean;
         blockStates: Record<number, PerBlockState>;
         currentRecommendationId: number | null;
+        strategyPanelOpen: boolean;
         configVersion: number;
     } & import("pinia").PiniaCustomStateProperties<StoreState>) => {
         text: string;
@@ -337,8 +367,11 @@ export declare const useRecommendationExtensionStore: import("pinia").StoreDefin
         }[];
         strategiesLoading: boolean;
         strategyUrlTemplates: Record<string, string>;
+        strategiesFetched: boolean;
+        strategiesSettled: boolean;
         blockStates: Record<number, PerBlockState>;
         currentRecommendationId: number | null;
+        strategyPanelOpen: boolean;
         configVersion: number;
     } & import("pinia").PiniaCustomStateProperties<StoreState>) => {
         text: string;
@@ -363,8 +396,11 @@ export declare const useRecommendationExtensionStore: import("pinia").StoreDefin
         }[];
         strategiesLoading: boolean;
         strategyUrlTemplates: Record<string, string>;
+        strategiesFetched: boolean;
+        strategiesSettled: boolean;
         blockStates: Record<number, PerBlockState>;
         currentRecommendationId: number | null;
+        strategyPanelOpen: boolean;
         configVersion: number;
     } & import("pinia").PiniaCustomStateProperties<StoreState>) => {
         text: string;
@@ -445,6 +481,40 @@ export declare const useRecommendationExtensionStore: import("pinia").StoreDefin
     openRemoveStrategyModal(): void;
     closeRemoveStrategyModal(): void;
     fetchStrategies(): Promise<void>;
+    invalidateStrategies(): void;
+    /**
+     * Opens a Smart Recommender strategy page in a new tab and refreshes the list every time
+     * the user comes back. `visibilitychange` only: a `focus` listener would also fire when
+     * focus merely returns from the Stripo canvas iframe to the panel, refetching and
+     * regenerating the canvas while the user never left the editor (SD-149916).
+     *
+     * Deliberately NOT one-shot: the strategy tab stays open, so a user can create a second
+     * strategy in it and come back again — a listener that disarmed on the first return would
+     * leave that one missing from the list. It disarms on the first return AFTER that tab is
+     * closed instead, so an ordinary alt-tab later in the session costs nothing. Armed only
+     * once the user actually opens a strategy page, so anyone who never does pays nothing.
+     */
+    _armStrategyPageReturn(url: string): void;
+    /**
+     * Reloads the products of the block the user is on, so an edit made in the strategy tab
+     * lands on the canvas instead of waiting for the assign drawer to be reopened.
+     *
+     * Only the selected block: the canvas regeneration is driven off the active block's
+     * product array, so refreshing an unselected block would fetch without redrawing it.
+     */
+    _refreshAssignedStrategyProducts(): Promise<void>;
+    /** Lets the editor tear the return listeners down when it unmounts. */
+    disposeStrategyPageReturn(): void;
+    /**
+     * Opens Smart Recommender's strategy creation page. Every return refreshes the list so the
+     * new strategy is offered; the user picks it themselves.
+     */
+    openStrategyCreation(): void;
+    /**
+     * Opens the strategy's edit page. Every return refreshes the list so the block reflects the
+     * edited configuration.
+     */
+    openStrategyEdit(strategyId: string | number): void;
     resolveStrategyUrlTemplate(strategy: RrsStrategy, currency: string): Promise<string>;
     assignStrategy(strategy: RrsStrategy): void;
     removeStrategy(): void;
@@ -462,6 +532,11 @@ export declare const useRecommendationExtensionStore: import("pinia").StoreDefin
      * every block's recommendationConfigs across user edits.
      */
     hasInvalidBlock(): boolean;
+    /**
+     * Which required fields are missing across the design's blocks, so the save
+     * toaster can name the cause instead of always showing the generic message.
+     */
+    invalidBlockFields(): string[];
     fetchRecommendationProducts(): Promise<void>;
     _doFetchProducts(): Promise<void>;
     _doFetchStrategyProducts(blockId: number): Promise<void>;

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

@@ -0,0 +1,14 @@
+/**
+ * Writes a strategy change and its products straight to the document, without the settings panel.
+ *
+ * Every entry point is host-rendered UI outside `ui-editor`, and none of them can rely on the
+ * panel control: opening the strategy page deselects the block, so by the time the user comes back
+ * and presses Assign the control — and with it the subscription that does the node write, the
+ * product fetch and the repaint — is gone. The assignment then reaches Pinia and nothing else
+ * (SD-149916).
+ *
+ * Call AFTER the store change (`assignStrategy` / `removeStrategy`).
+ * @param description - labels the undo entry
+ * @returns whether the write reached a node
+ */
+export declare function commitStrategyChange(blockId: number, description: string): Promise<boolean>;

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

@@ -15,7 +15,11 @@ export interface RequiredField {
     getAvailableOptions?: (store: ExtensionStoreSlice) => string[];
     condition?: (config: PerBlockConfigs) => boolean;
 }
+/** Field key of the strategy/algorithm descriptor, used to pick the toaster message. */
+export declare const STRATEGY_FIELD_KEY = "strategy";
 export declare const REQUIRED_RECOMMENDATION_FIELDS: RequiredField[];
 export declare const RecommendationRequiredFieldsKey = "newsletter.recommendation-fill-required-fields";
+/** Shown instead of the generic message when the only thing missing is the strategy. */
+export declare const RecommendationAssignStrategyKey = "newsletter.recommendation-assign-strategy";
 export declare function getInvalidFields(config: PerBlockConfigs, store: ExtensionStoreSlice, fields?: RequiredField[]): string[];
 export declare function isConfigValid(config: PerBlockConfigs, store: ExtensionStoreSlice): boolean;