@useinsider/guido 3.19.0 → 3.20.0-beta.7b31fec

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

@@ -1,4 +1,4 @@
-import type { Orientation, Languages, Currency, NumericSeparator, FiltersResponse, Filter, RecommendationCampaignUrlValue, RecommendationProduct, RrsStrategy } from '@@/Types/recommendation';
+import type { Orientation, Languages, Currency, NumericSeparator, FiltersResponse, Filter, RecommendationCampaignUrlValue, RecommendationProduct, RrsMigrationPayload, RrsMigrationTarget, RrsStrategy } from '@@/Types/recommendation';
 export interface PerBlockConfigs {
     cardsInRow: number;
     currencySettings: {
@@ -22,6 +22,7 @@ export interface PerBlockConfigs {
     shuffleProducts: boolean;
     strategy: string;
     strategyId: string;
+    nodeConfigVersion: number;
     textTrimming: boolean;
     unresponsive: boolean;
     size: string;
@@ -36,6 +37,7 @@ interface PerBlockState {
     filterSelectionDrawerStatus: boolean;
     assignStrategyDrawerStatus: boolean;
     removeStrategyModalStatus: boolean;
+    legacyStrategyUpdatedModalStatus: boolean;
     filterGroup: number;
     /** Whether initial API data (filters, algorithms, products) has been fetched for this block */
     isInitialized: boolean;
@@ -51,6 +53,7 @@ interface PerBlockState {
      * same id skipped the re-sync and kept the defaults (SD-150347).
      */
     syncedConfigFingerprint: string | null;
+    legacyConversionLoading: boolean;
 }
 /**
  * Persisted-config subset used by `seedBlockUrlConfig` to reconstruct
@@ -83,8 +86,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 +117,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 +146,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 +175,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 +201,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 +227,64 @@ 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;
+    isLegacyStrategyBlock(): boolean;
+    legacyConversionLoading(state: {
+        recommendationCampaignUrls: Record<string, RecommendationCampaignUrlValue>;
+        activePredictiveAlgorithms: number[];
+        languages: Languages;
+        currencyList: {
+            text: string;
+            value: string;
+        }[];
+        filterList: FiltersResponse;
+        strategies: {
+            [x: string]: unknown;
+            strategy_id: number;
+            name: string;
+            status: string;
+            suitable_channels: string;
+            size?: (number | string) | undefined;
+        }[];
+        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;
+    legacyStrategyUpdatedModalStatus(state: {
+        recommendationCampaignUrls: Record<string, RecommendationCampaignUrlValue>;
+        activePredictiveAlgorithms: number[];
+        languages: Languages;
+        currencyList: {
+            text: string;
+            value: string;
+        }[];
+        filterList: FiltersResponse;
+        strategies: {
+            [x: string]: unknown;
+            strategy_id: number;
+            name: string;
+            status: string;
+            suitable_channels: string;
+            size?: (number | string) | undefined;
+        }[];
+        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 +306,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 +335,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 +364,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 +394,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 +423,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 +452,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;
@@ -390,6 +482,10 @@ export declare const useRecommendationExtensionStore: import("pinia").StoreDefin
     /**
      * Deep-clones a block's state and mirrors its campaign URL under a new id.
      * Invoked from `onCreated` when a duplicate is detected (SD-142352).
+     *
+     * The clone keeps the source's data but drops its "already fetched / already
+     * synced" claims for strategy blocks, so it fetches again like a fresh drop
+     * (SD-149916).
      */
     cloneBlockState(sourceId: number, newId: number): void;
     /**
@@ -442,11 +538,65 @@ export declare const useRecommendationExtensionStore: import("pinia").StoreDefin
     cancelFilterDrawer(): void;
     openAssignStrategyDrawer(): void;
     closeAssignStrategyDrawer(): void;
+    openLegacyStrategyUpdatedModal(): void;
+    closeLegacyStrategyUpdatedModal(): void;
     openRemoveStrategyModal(): void;
     closeRemoveStrategyModal(): void;
     fetchStrategies(): Promise<void>;
+    /**
+     * Clears what a block inherited from the id it arrived holding, so the panel fetches for it.
+     * A re-dropped saved module can keep the source's id — and its "already fetched" entry —
+     * while the strategy's product count has moved on (SD-149916).
+     */
+    resetArrivedBlock(id: number): 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.
+     * @returns whether a tab actually opened, so callers can skip work that assumes one did
+     */
+    _armStrategyPageReturn(url: string): boolean;
+    /**
+     * 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(): boolean;
+    /**
+     * Opens the strategy's edit page. Every return refreshes the list so the block reflects the
+     * edited configuration.
+     */
+    openStrategyEdit(strategyId: string | number): boolean;
     resolveStrategyUrlTemplate(strategy: RrsStrategy, currency: string): Promise<string>;
     assignStrategy(strategy: RrsStrategy): void;
+    convertLegacyStrategy(payload: RrsMigrationPayload, target?: RrsMigrationTarget): Promise<string>;
+    /**
+     * Undoes the config half of a conversion whose document write never landed, so the
+     * panel and the drawer fall back to "Legacy Strategy" instead of showing an assignment
+     * the document never received.
+     */
+    revertLegacyConversion(blockId: number, previous: {
+        strategyId: string;
+        size: string;
+        nodeConfigVersion: number;
+    }): void;
     removeStrategy(): void;
     fetchRecommendationCreateData(): Promise<void>;
     fetchRecommendationFilters(): Promise<void>;
@@ -462,8 +612,19 @@ 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>;
+    /**
+     * Block-scoped counterpart of `fetchRecommendationProducts`, which only ever serves the
+     * selected block. The legacy conversion must refresh the products of the block that
+     * started it even after the user selected another one.
+     */
+    fetchStrategyProductsForBlock(blockId: number): Promise<void>;
     _doFetchStrategyProducts(blockId: number): Promise<void>;
     _setBlockProducts(blockId: number, products: RecommendationProduct[], size: number): void;
 }>;

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

@@ -0,0 +1,32 @@
+import type { RrsMigrationPayload, RrsMigrationTarget } from '@@/Types/recommendation';
+/**
+ * A block authored before reusable strategies: it still carries a plain feed
+ * configuration (compiled into a feed URL string) instead of a strategy id.
+ * Blocks created under RRS stamp at least `RRS_CONFIG_VERSION`, so the version is
+ * what separates "never converted" from "not assigned yet".
+ */
+export declare function isLegacyStrategyConfig({ strategyId, nodeConfigVersion }: {
+    strategyId: string;
+    nodeConfigVersion: number;
+}): boolean;
+export declare function resolveMigrationTarget({ campaignId, templateLibraryId }: {
+    campaignId?: string;
+    templateLibraryId?: string;
+}): RrsMigrationTarget;
+interface MigrationInputs {
+    blockId: number;
+    url: string;
+    campaignId: string;
+    variationId: string;
+    strategy: string;
+    productIds: string[];
+    target: RrsMigrationTarget;
+}
+/**
+ * The server names and de-duplicates the strategy, so nothing here derives a name, and the
+ * filters travel inside `url` — the endpoint parses the feed URL's filter DSL itself. The two
+ * routes take different identity fields — the campaign one names from `campaignId`/`variationId`
+ * (0 for modules, which carry no numeric campaign), the template one from `templateId`.
+ */
+export declare function buildLegacyMigrationPayload({ blockId, url, campaignId, variationId, strategy, productIds, target, }: MigrationInputs): RrsMigrationPayload;
+export {};

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;

package/dist/src/services/recommendationApi.d.ts

@@ -1,4 +1,4 @@
-import type { InitialResponse, FiltersResponse, RecommendationProduct, RecommendationProductsParams, RrsEndpointGenerateResponse, RrsStrategy } from '@@/Types/recommendation';
+import type { InitialResponse, FiltersResponse, RecommendationProduct, RecommendationProductsParams, RrsEndpointGenerateResponse, RrsMigrationPayload, RrsMigrationTarget, RrsStrategy } from '@@/Types/recommendation';
 export declare const useRecommendationApi: () => {
     fetchRecommendationCreateData: () => Promise<InitialResponse>;
     fetchRecommendationFilters: () => Promise<FiltersResponse>;
@@ -6,4 +6,5 @@ export declare const useRecommendationApi: () => {
     fetchRecommendationProductsByUrl: (url: string) => Promise<RecommendationProduct[]>;
     fetchRecommendationStrategies: () => Promise<RrsStrategy[]>;
     generateStrategyEndpoint: (strategy: RrsStrategy, currency: string) => Promise<RrsEndpointGenerateResponse | null>;
+    migrateLegacyStrategy: (payload: RrsMigrationPayload, target?: RrsMigrationTarget) => Promise<string>;
 };