@useinsider/guido 3.18.1-beta.280b4e1 → 3.18.1-beta.2e195ed

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

@@ -71,8 +71,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, {
@@ -99,8 +102,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;
     /**
@@ -125,8 +131,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[];
     /**
@@ -151,8 +160,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: {
@@ -174,8 +186,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: {
@@ -197,8 +212,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: {
@@ -220,8 +238,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;
     /**
@@ -246,8 +267,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;
     /**
@@ -272,8 +296,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;
@@ -299,8 +326,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;
@@ -325,8 +355,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;
@@ -351,8 +384,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;
@@ -433,6 +469,39 @@ 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` covers the tab case; `focus` covers the page
+     * landing in a separate window, where this document never goes hidden.
+     *
+     * 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;
@@ -450,6 +519,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/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/library.d.ts

@@ -2,7 +2,5 @@ export { default as Guido } from './components/Guido.vue';
 export type { GuidoConfig, GuidoConfigInput, IdentityConfig, PartnerConfig, TemplateConfig, TemplateMigrationConfig, LegacyRecommendationConfig, EditorConfig, UIConfig, FeaturesConfig, BlocksConfig, CompilerConfig, DynamicContent, EmailHeader, DefaultBlockType, CustomBlockType, ValidationResult, ValidationError, } from './@types/config';
 export { validateConfig, parseConfig, parseConfigSafe, isValidConfig, getValidationErrors, MessageType, ProductType, } from './@types/config';
 export { assignTrackingIds, readTrackFloor, readTrackSeq } from './public/trackingIds';
-export { useGuidoEmailEditorStore } from './public/editorState';
-export type { GuidoEmailEditorState } from './public/editorState';
 export type { StripoEventType } from './@types/events';
 export type { PositionData, DynamicContentEvent, MergeTagClickEvent, MergeTag, BaseDynamicContent, DynamicContentNode, DynamicContentList, TooltipOptions, TextValueObject, L10n, } from './@types/generic';

package/dist/src/public/trackingIds.d.ts

@@ -4,10 +4,6 @@
  * Importing from here pulls in nothing else, so the editor never enters a
  * consumer's module graph. Re-export surface only: this is the contract,
  * `utils/linkTrackingIds` is the implementation and stays free to move.
- *
- * Relative, not the `@@/Utils/` alias: vue-tsc copies the specifier into the emitted
- * .d.ts verbatim, and a consumer's TypeScript cannot resolve our alias table. A relative
- * path resolves against dist/src/, so the published types actually load.
  */
-export { assignTrackingIds, readTrackFloor, readTrackSeq, TRACK_ID_ATTRIBUTE, TRACK_SEQ_ATTRIBUTE, } from '../utils/linkTrackingIds';
-export type { TrackingIdResult } from '../utils/linkTrackingIds';
+export { assignTrackingIds, readTrackFloor, readTrackSeq, TRACK_ID_ATTRIBUTE, TRACK_SEQ_ATTRIBUTE, } from '@@/Utils/linkTrackingIds';
+export type { TrackingIdResult } from '@@/Utils/linkTrackingIds';

package/dist/src/stores/guido-email-editor.d.ts

@@ -1,41 +1,41 @@
-/** The published editor snapshot — the shape a consumer reads off the shared store. */
-export interface GuidoEmailEditorState {
+/**
+ * Outbound contract Guido publishes to the host's shared Pinia singleton so
+ * cortex-fe can pick up the current editor state and forward it as
+ * `clientState.editor` on the next chat-stream POST.
+ *
+ * State + getters only — `useGuidoStateBridge` writes via `$patch`, no actions
+ * live here (architecture invariant).
+ *
+ * Store id `guidoEmailEditor` is cross-MFE: cortex-fe reads it via
+ * `pinia._s.get('guidoEmailEditor')` at runtime. The internal Guido editor
+ * store keeps id `guidoEditor` — these are intentionally separate. The
+ * internal store carries UI state that cortex-fe should not see; this public
+ * store carries the contract Guido is willing to share.
+ */
+export declare const useGuidoEmailEditorStore: import("pinia").StoreDefinition<"guidoEmailEditor", {
     /** Current Stripo HTML — stripe tables only, no DOCTYPE/wrapper. */
     html: string;
     /** Current Stripo CSS — es-p* utility classes used by the html. */
     css: string;
     /** Wall-clock ms when html/css were last written by the bridge. */
     lastUpdatedAt: number;
-    /** Template id from the editor config, so a consumer can scope per-template. */
+    /** Template id from the editor config, for cortex-fe to scope per-template. */
     templateId: string;
-}
-/**
- * Outbound contract Guido publishes to the host's shared Pinia singleton so a
- * consumer can read the current editor state: cortex-fe forwards it as
- * `clientState.editor` on the next chat-stream POST, email-fe scans it for the
- * Array of Objects lock.
- *
- * Published as `@useinsider/guido/editor-state` and from the root barrel, so a
- * consumer imports this store instead of re-declaring one under the same id.
- *
- * State + getters only, no actions. `useGuidoStateBridge` is the only intended
- * writer, but that is Guido's own convention rather than something the store
- * enforces: publishing the definition hands a consumer `$patch` as well, exactly
- * as the runtime `pinia._s` probe always did.
- *
- * Store id `guidoEmailEditor` is cross-MFE: cortex-fe reads it via
- * `pinia._s.get('guidoEmailEditor')` at runtime rather than importing it, so the
- * id stays part of the contract. The internal Guido editor store keeps id
- * `guidoEditor` — these are intentionally separate. The internal store carries
- * UI state a consumer should not see; this public store carries the contract
- * Guido is willing to share.
- */
-export declare const useGuidoEmailEditorStore: import("pinia").StoreDefinition<"guidoEmailEditor", GuidoEmailEditorState, {
+}, {
     /** True once the bridge has published at least one snapshot. */
     hasSnapshot: (state: {
         html: string;
         css: string;
         lastUpdatedAt: number;
         templateId: string;
-    } & import("pinia").PiniaCustomStateProperties<GuidoEmailEditorState>) => boolean;
+    } & import("pinia").PiniaCustomStateProperties<{
+        /** Current Stripo HTML — stripe tables only, no DOCTYPE/wrapper. */
+        html: string;
+        /** Current Stripo CSS — es-p* utility classes used by the html. */
+        css: string;
+        /** Wall-clock ms when html/css were last written by the bridge. */
+        lastUpdatedAt: number;
+        /** Template id from the editor config, for cortex-fe to scope per-template. */
+        templateId: string;
+    }>) => boolean;
 }, {}>;