@useinsider/guido 3.18.2-beta.3eec9b0 → 3.18.2-beta.4d2b065

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

@@ -50,6 +50,14 @@ export declare const IdentitySchema: v.ObjectSchema<{
     readonly userId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, "userId is required">]>;
     /** Optional variation ID for A/B testing */
     readonly variationId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    /** Optional numeric campaign ID of the host campaign; absent for templates and modules */
+    readonly campaignId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    /**
+     * Optional numeric template-library id of the host template; absent for campaigns and
+     * modules. Distinct from `templateId`, which is the editor's document identity (a uuid /
+     * Stripo doc id) and is never an endpoint id.
+     */
+    readonly templateLibraryId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
 }, undefined>;
 /**
  * Partner configuration - organization and product context
@@ -625,6 +633,14 @@ export declare const GuidoConfigSchema: v.ObjectSchema<{
         readonly userId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, "userId is required">]>;
         /** Optional variation ID for A/B testing */
         readonly variationId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        /** Optional numeric campaign ID of the host campaign; absent for templates and modules */
+        readonly campaignId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        /**
+         * Optional numeric template-library id of the host template; absent for campaigns and
+         * modules. Distinct from `templateId`, which is the editor's document identity (a uuid /
+         * Stripo doc id) and is never an endpoint id.
+         */
+        readonly templateLibraryId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
     }, undefined>;
     /** Partner configuration (required) */
     readonly partner: v.ObjectSchema<{

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

@@ -0,0 +1,2 @@
+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/onboarding/RecommendationLegacyStrategyOnboarding.vue.d.ts

@@ -0,0 +1,2 @@
+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/onboarding/RecommendationStrategyOnboarding.vue.d.ts

@@ -0,0 +1,2 @@
+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/composables/useConfig.d.ts

@@ -11,6 +11,8 @@ export declare const useConfig: () => {
             templateId: string;
             userId: string;
             variationId?: string | undefined;
+            campaignId?: string | undefined;
+            templateLibraryId?: string | undefined;
         };
         partner: {
             name: string;
@@ -146,6 +148,8 @@ export declare const useConfig: () => {
         templateId: string;
         userId: string;
         variationId?: string | undefined;
+        campaignId?: string | undefined;
+        templateLibraryId?: string | undefined;
     } | null>;
     partner: import("vue").ComputedRef<{
         name: string;

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

@@ -1,26 +1,22 @@
 /**
  * Outbound bridge — publishes the current editor's html/css to the shared
- * Pinia store `guidoEmailEditor`. cortex-fe reads it at chat-stream submit
- * time and forwards it as `clientState.editor`, which is what enables
+ * Pinia store `guidoEmailEditor` so cortex-fe can read it at chat-stream
+ * submit time and forward it as `clientState.editor`. This is what enables
  * sub-case 1.3 (refine an already-loaded template via the email-agent).
  *
  * The bridge writes on three triggers:
  *
  *   1. Stripo finishes initializing — first snapshot.
- *   2. Every document change, via the `changeSeq` counter — debounced 500 ms
- *      so a streaming Stripo edit doesn't thrash the store.
+ *   2. Editor `hasChanges` flips to true — debounced 500 ms so a streaming
+ *      Stripo edit doesn't thrash the store.
  *   3. Editor `hasChanges` flips back to false (post-save / autosave) —
  *      immediate, since this is the canonical "saved" snapshot.
  *
  * `getTemplateData()` is a Stripo iframe call; it must not run before
  * `isStripoInitialized` is true. The bridge guards against that.
  *
- * The store is written even with no reader attached — it has zero overhead,
- * and a late reader still finds consistent state.
- *
- * Readers are not optional any more, so treat the publish timing as part of
- * the contract: the store ships as `@useinsider/guido/editor-state`, and
- * email-fe imports it to scan the live html for its Array of Objects lock.
- * Weakening a trigger here silently breaks that lock in the consumer.
+ * If cortex-fe isn't loaded the store still gets written — that's fine;
+ * the store has zero overhead and any future reader will find consistent
+ * state. The bridge is a one-way pipe with no consumer dependency.
  */
 export declare const useGuidoStateBridge: () => void;

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

@@ -0,0 +1,3 @@
+export declare const useLegacyStrategyConversion: () => {
+    convertLegacyStrategy: () => Promise<string>;
+};

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

@@ -1,11 +1,15 @@
 import type { TextValueObject } from '@@/Types/generic';
-import type { RecommendationFeedItem } from '@@/Types/recommendation';
+import type { RecommendationFeedItem, RrsMigrationTarget } from '@@/Types/recommendation';
 export declare const URLS: {
     RECOMMENDATION_API_URL: string;
     PRODUCT_ATTRIBUTES_PATH: string;
     RECOMMENDATION_STRATEGIES_PATH: string;
     RECOMMENDATION_STRATEGIES_PANEL_PATH: string;
+    NEWSLETTER_RECOMMENDATIONS_PATH: string;
+    MIGRATE_STRATEGIES_PATH: string;
+    TEMPLATE_MIGRATE_STRATEGIES_PATH: string;
 };
+export declare const MIGRATION_PATHS: Record<RrsMigrationTarget['scope'], string>;
 export declare const QUERY_PARAMS: {
     CLIENT_ID: string;
 };

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

@@ -2,6 +2,8 @@ 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 legacyConversion;
     private storeUnsubscription;
     private listeners;
     private lastPaintedState;

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

@@ -88,6 +88,8 @@ export interface RegenerateWithStylesOptions extends Omit<RegenerateProductRowsO
     products?: RecommendationProduct[];
     /** Optional: pass layout directly to avoid stale DOM reads after setAttribute */
     layout?: Orientation;
+    /** Applies the batch even when the rows are unchanged, for callers that staged their own edits. */
+    forceApply?: boolean;
 }
 /**
  * Regenerates product rows while preserving user-applied styles, in a SINGLE commit.
@@ -151,6 +153,8 @@ export interface UpdateProductContentInPlaceOptions {
     currentNode: ImmutableHtmlNode | null | undefined;
     documentModifier: DocumentModifier;
     products: RecommendationProduct[];
+    /** Applies the batch even when the cards are unchanged, for callers that staged their own edits. */
+    forceApply?: boolean;
 }
 /**
  * Updates product content in-place without regenerating HTML structure.

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
@@ -213,6 +216,53 @@ export declare const useRecommendationExtensionStore: import("pinia").StoreDefin
         currentRecommendationId: number | null;
         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>;
+        blockStates: Record<number, PerBlockState>;
+        currentRecommendationId: number | null;
+        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>;
+        blockStates: Record<number, PerBlockState>;
+        currentRecommendationId: number | null;
+        configVersion: number;
+    } & import("pinia").PiniaCustomStateProperties<StoreState>): boolean;
     assignedStrategy(state: {
         recommendationCampaignUrls: Record<string, RecommendationCampaignUrlValue>;
         activePredictiveAlgorithms: number[];
@@ -442,11 +492,24 @@ export declare const useRecommendationExtensionStore: import("pinia").StoreDefin
     cancelFilterDrawer(): void;
     openAssignStrategyDrawer(): void;
     closeAssignStrategyDrawer(): void;
+    openLegacyStrategyUpdatedModal(): void;
+    closeLegacyStrategyUpdatedModal(): void;
     openRemoveStrategyModal(): void;
     closeRemoveStrategyModal(): void;
     fetchStrategies(): Promise<void>;
     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>;
@@ -464,6 +527,12 @@ export declare const useRecommendationExtensionStore: import("pinia").StoreDefin
     hasInvalidBlock(): boolean;
     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 `CURRENT_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/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/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>;
 };