@useinsider/guido 3.18.2-beta.45f708c → 3.18.2-beta.545d1bd

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

@@ -1,4 +1,20 @@
 type ApplyStatus = 'pending' | 'applying' | 'applied' | 'failed';
+/**
+ * Terminal outcome of an apply. Every promise this composable hands out settles
+ * with exactly one of these — callers (the cortex bridge) ack on it, so a
+ * never-settling promise would strand cortex's Apply button forever.
+ *
+ * `superseded` means a newer payload for the same blueprint replaced this one:
+ * not a success, not a failure, and deliberately never acked.
+ */
+export type ApplyOutcome = {
+    status: 'applied';
+} | {
+    status: 'failed';
+    error: unknown;
+} | {
+    status: 'superseded';
+};
 /**
  * Applies email_template blueprints from the chat agent to the Stripo editor.
  *
@@ -9,6 +25,10 @@ type ApplyStatus = 'pending' | 'applying' | 'applied' | 'failed';
  * - manual Apply click (first apply): immediate.
  * - blueprint_update after the user has applied once: debounced 250 ms trailing
  *   so rapid mid-stream updates don't thrash updateHtmlAndCss.
+ *
+ * A click that lands before Stripo finished initializing is queued rather than
+ * dropped, and flushed when `isStripoInitialized` flips — the user does not
+ * have to click again.
  */
 export declare const useEmailTemplateApplier: () => {
     applyStatus: import("vue").Ref<Record<string, ApplyStatus>>;
@@ -16,11 +36,11 @@ export declare const useEmailTemplateApplier: () => {
     applyTemplate: (blueprintId: string, data: {
         html?: string;
         css?: string;
-    }) => void;
+    }) => Promise<ApplyOutcome>;
     applyTemplateDebounced: (blueprintId: string, data: {
         html?: string;
         css?: string;
-    }) => void;
+    }) => Promise<ApplyOutcome>;
 };
 export declare const resetEmailTemplateApplier: () => void;
 export {};

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

@@ -5,9 +5,7 @@ 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,7 +10,6 @@
 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, 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, EXCLUDED_ALGORITHM_IDS, } from './defaultConfig';

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

@@ -70,8 +70,6 @@ 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,7 +2,6 @@ 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;
@@ -10,14 +9,6 @@ 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): boolean;
+export declare function regenerateProductRowsWithStyles(options: RegenerateWithStylesOptions): void;
 /**
  * Adjusts a products array to a target size.
  * Used by ProductLayoutControl to synchronously match products to the new size
@@ -151,11 +151,6 @@ 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.
@@ -166,7 +161,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; `onApplied` fires only when a batch was committed
+ * @param options - Configuration options
  * @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,11 +83,8 @@ 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, {
@@ -114,11 +111,8 @@ 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;
     /**
@@ -143,11 +137,8 @@ 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[];
     /**
@@ -172,11 +163,8 @@ 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: {
@@ -198,11 +186,8 @@ 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: {
@@ -224,11 +209,8 @@ 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: {
@@ -250,11 +232,8 @@ 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;
     /**
@@ -279,11 +258,8 @@ 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;
     /**
@@ -308,11 +284,8 @@ 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;
@@ -338,11 +311,8 @@ 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;
@@ -367,11 +337,8 @@ 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;
@@ -396,11 +363,8 @@ 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;
@@ -481,40 +445,6 @@ 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;
@@ -532,11 +462,6 @@ 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,11 +15,7 @@ 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/stores/guido-email-editor.d.ts

@@ -1,16 +1,28 @@
+/** Terminal outcome of an editor write, keyed by `${blueprintId}:${version}`. */
+export interface ApplyAck {
+    status: 'applied' | 'failed';
+    /** The `applyRequestedAt` of the click this ack answers — lets cortex drop stale acks. */
+    requestedAt: number;
+    /** Strictly increasing per key, so two acks in the same millisecond still order. */
+    ackAt: number;
+    /** Stringified — cortex JSON-clones store-derived payloads, an Error would not survive. */
+    error?: string;
+}
 /**
  * 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).
+ * This store is **state-only, by contract**. It declares no actions and no
+ * non-trivial getters, so `pinia.state.value['guidoEmailEditor']` is a complete
+ * view of it. cortex-fe reads it through that public path; adding an action or
+ * a getter that cortex needs would silently break that read. Keep it
+ * state-only. (`hasSnapshot` stays — cortex does not read it.)
  *
- * 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.
+ * Store id `guidoEmailEditor` is cross-MFE. 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. */
@@ -21,6 +33,10 @@ export declare const useGuidoEmailEditorStore: import("pinia").StoreDefinition<"
     lastUpdatedAt: number;
     /** Template id from the editor config, for cortex-fe to scope per-template. */
     templateId: string;
+    /** True while a mounted Guido bridge is consuming the chat store. Gates cortex's Apply button. */
+    bridgeActive: boolean;
+    /** `${blueprintId}:${version}` → terminal outcome of the editor write, written only after it settles. */
+    applyAcks: Record<string, ApplyAck>;
 }, {
     /** True once the bridge has published at least one snapshot. */
     hasSnapshot: (state: {
@@ -28,6 +44,8 @@ export declare const useGuidoEmailEditorStore: import("pinia").StoreDefinition<"
         css: string;
         lastUpdatedAt: number;
         templateId: string;
+        bridgeActive: boolean;
+        applyAcks: Record<string, ApplyAck>;
     } & import("pinia").PiniaCustomStateProperties<{
         /** Current Stripo HTML — stripe tables only, no DOCTYPE/wrapper. */
         html: string;
@@ -37,5 +55,9 @@ export declare const useGuidoEmailEditorStore: import("pinia").StoreDefinition<"
         lastUpdatedAt: number;
         /** Template id from the editor config, for cortex-fe to scope per-template. */
         templateId: string;
+        /** True while a mounted Guido bridge is consuming the chat store. Gates cortex's Apply button. */
+        bridgeActive: boolean;
+        /** `${blueprintId}:${version}` → terminal outcome of the editor write, written only after it settles. */
+        applyAcks: Record<string, ApplyAck>;
     }>) => boolean;
 }, {}>;