@useinsider/guido 3.19.0-beta.cac604e → 3.19.0-beta.cc48fee

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

@@ -1,4 +1,16 @@
 type ApplyStatus = 'pending' | 'applying' | 'applied' | 'failed';
+/**
+ * Terminal outcome of an apply; every promise here settles with one, since the bridge acks on it.
+ * `superseded`: a newer payload for the same key replaced this one and owns the ack.
+ */
+export type ApplyOutcome = {
+    status: 'applied';
+} | {
+    status: 'failed';
+    error: unknown;
+} | {
+    status: 'superseded';
+};
 /**
  * Applies email_template blueprints from the chat agent to the Stripo editor.
  *
@@ -9,18 +21,19 @@ 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 before Stripo is ready is queued and flushed when `isStripoInitialized` flips.
  */
 export declare const useEmailTemplateApplier: () => {
     applyStatus: import("vue").Ref<Record<string, ApplyStatus>>;
-    markPending: (blueprintId: string) => void;
-    applyTemplate: (blueprintId: string, data: {
+    markPending: (key: string) => void;
+    applyTemplate: (key: string, data: {
         html?: string;
         css?: string;
-    }) => void;
-    applyTemplateDebounced: (blueprintId: string, data: {
+    }) => Promise<ApplyOutcome>;
+    applyTemplateDebounced: (key: string, data: {
         html?: string;
         css?: string;
-    }) => void;
+    }) => Promise<ApplyOutcome>;
 };
 export declare const resetEmailTemplateApplier: () => void;
 export {};

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

@@ -19,6 +19,8 @@ export declare const provideGuidoActions: (actions: {
 }) => void;
 /**
  * Provides individual Guido action handlers
+ * @deprecated No consumer in src/ and not exported from library.ts — provideGuidoActions
+ * provides all four keys itself. Slated for deletion, see the SD-667788 dead-code ledger.
  */
 export declare const provideBackHandler: (handler: BackHandler) => void;
 export declare const provideSaveStartHandler: (handler: SaveStartHandler) => void;

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

@@ -16,6 +16,7 @@ export interface HttpError {
     status?: number;
     statusText?: string;
     response?: Response;
+    authReported?: boolean;
 }
 export declare const useHttp: (defaultOptions?: HttpOptions) => {
     loading: import("vue").ComputedRef<boolean>;
@@ -65,6 +66,7 @@ export declare const useHttp: (defaultOptions?: HttpOptions) => {
             json: () => Promise<any>;
             text: () => Promise<string>;
         } | undefined;
+        authReported?: boolean | undefined;
     } | null>;
     hasError: import("vue").ComputedRef<boolean>;
     request: <T = unknown>(method: HttpMethod, url: string, data?: unknown, options?: HttpOptions) => Promise<HttpResponse<T>>;

package/dist/src/config/migrator/index.d.ts

@@ -1,2 +1,3 @@
 import type { LegacyRecommendationConfig } from '@@/Types/config';
-export declare const migrate: (html: string, recommendationConfigs?: Record<string, LegacyRecommendationConfig>) => Promise<string>;
+import { type PartnerScopeMigrationOptions } from './recommendationPartnerMigrator';
+export declare const migrate: (html: string, recommendationConfigs?: Record<string, LegacyRecommendationConfig>, partnerScope?: PartnerScopeMigrationOptions) => Promise<string>;

package/dist/src/config/migrator/recommendationPartnerMigrator.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Empties recommendation blocks copied in from another account and stamps the
+ * current one, before the editor ever sees the template (SD-151945).
+ *
+ * Runs at load rather than on document change: the stamp makes it a one-time
+ * pass per template, the campaign-URL rule only ever applies to the loaded HTML,
+ * and Stripo takes the result as the original document, so nothing is dirtied.
+ */
+export interface PartnerScopeMigrationOptions {
+    partnerName: string;
+    /** `undefined` when the host does not pass the map — the unstamped check is then off. */
+    campaignUrls?: Record<string, unknown>;
+    rrsEnabled: boolean;
+}
+/**
+ * @param html Template HTML, already normalized by `migrateRecommendation`.
+ * @returns Migrated HTML, or the original when no block needed a reset or a stamp.
+ */
+export declare function migrateRecommendationPartnerScope(html: string, { partnerName, campaignUrls, rrsEnabled }: PartnerScopeMigrationOptions): string;

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

@@ -8,8 +8,8 @@ export declare const URLS: {
     NEWSLETTER_RECOMMENDATIONS_PATH: string;
     MIGRATE_STRATEGIES_PATH: string;
     TEMPLATE_MIGRATE_STRATEGIES_PATH: string;
-    RECOMMENDATION_STRATEGY_CREATE_PATH: string;
 };
+export declare const strategyCreatePath: () => string;
 export declare const strategyEditPath: (strategyId: string | number) => string;
 export declare const MIGRATION_PATHS: Record<RrsMigrationTarget['scope'], string>;
 export declare const QUERY_PARAMS: {

package/dist/src/extensions/Blocks/Items/constants/cardLayout.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Single owner for the Items card orientation-dependent layout contract (SD-149368).
+ *
+ * Two things depend on a card's orientation and are written across several layers:
+ *
+ * 1. Name column width — a horizontal card lays the name in a narrow side-by-side
+ *    column, so it is capped; a vertical card gives it a full-width row.
+ * 2. Block-cell padding — the collapsible price / original-price block-cell carries its
+ *    own inter-cell spacing (horizontal cards pad left/right, vertical cards pad
+ *    top/bottom) so a hidden element removes its own spacing instead of leaving a gap.
+ *
+ * Every layer that writes these — template render, layouts/horizontal.html,
+ * NameTrimmingControl (trimming toggle) and settingsControl (orientation change) — MUST
+ * derive them here, or a migrated / re-toggled card silently drifts out of sync with
+ * freshly generated markup (convention B1: cross-layer literals live in one module).
+ */
+export declare const NAME_HORIZONTAL_MAX_WIDTH = "130px";
+export declare const NAME_VERTICAL_MAX_WIDTH = "100%";
+/** Name max-width for a card orientation. Non-horizontal (incl. undefined) → full width. */
+export declare const nameMaxWidthFor: (orientation?: string) => string;
+/** Orientation-dependent inter-cell padding classes for a collapsible block-cell. */
+export declare const BLOCK_CELL_PADDING: {
+    readonly VERTICAL: "es-p5b es-p5t";
+    readonly HORIZONTAL: "es-p5l es-p5r";
+};
+/**
+ * Attribute the block-cell carries to mark its LAYOUT-owned padding orientation ('v'|'h').
+ * The orientation toggle keys off this marker so it only ever rewrites the padding the
+ * layout itself baked — a user's own es-p* padding classes are never matched or clobbered
+ * (SD-149368 F1), and a cell without the marker is left untouched rather than mis-swapped.
+ */
+export declare const BLOCK_CELL_PAD_ATTR = "data-items-cell-pad";
+/** Marker attribute (`data-items-cell-pad="v|h"`) for a block-cell in the given orientation. */
+export declare const blockCellPadMarker: (isVertical: boolean) => string;
+/** Padding classes (leading space included) for a block-cell in the given orientation. */
+export declare const blockCellPaddingFor: (isVertical: boolean) => string;
+/**
+ * Rewrites a block-cell's LAYOUT-owned padding classes to the target orientation, keyed off
+ * the BLOCK_CELL_PAD_ATTR marker. The orientation-change rebuild re-injects existing cells
+ * via getOuterHTML(), which still carry the previous orientation's padding — swap only the
+ * layout pair (and flip the marker) so price/original-price cells stay padded after a toggle
+ * (SD-149368 F3), while a user's own padding and any unmarked cell are left alone (F1).
+ */
+export declare const reorientBlockCellPadding: (html: string, toVertical: boolean) => string;

package/dist/src/extensions/Blocks/Items/enums/productEnums.d.ts

@@ -39,14 +39,17 @@ export declare const productPairs: {
             CART_ITEMS: {
                 ATTR: string;
                 DEFAULT: string;
+                LEGACY_DEFAULTS: readonly string[];
             };
             BROWSED_ITEMS: {
                 ATTR: string;
                 DEFAULT: string;
+                LEGACY_DEFAULTS: readonly string[];
             };
             PURCHASED_ITEMS: {
                 ATTR: string;
                 DEFAULT: string;
+                LEGACY_DEFAULTS: readonly string[];
             };
         };
         price: {

package/dist/src/extensions/Blocks/Items/template.d.ts

@@ -37,6 +37,25 @@ type TemplateParameters = {
     /** Price orientation within the card ('vertical' = stacked, 'horizontal' = side-by-side) */
     priceOrientation?: PriceOrientationType;
 };
+/**
+ * Applies price orientation styles to the generated HTML template.
+ *
+ * For Vertical Layout:
+ * - vertical price orientation: both cells 100% (stacked)
+ * - horizontal price orientation with both visible: both cells 50% (side-by-side)
+ * - horizontal price orientation with one hidden: visible cell 100%
+ *
+ * For Horizontal Layout:
+ * - horizontal price orientation: .horizontal-price visible, .vertical-price hidden
+ * - vertical price orientation: .horizontal-price hidden, .vertical-price visible
+ * @param html - The HTML template string with placeholders replaced
+ * @param layoutOrientation - The card layout orientation ('vertical' or 'horizontal')
+ * @param priceOrientation - The price orientation within the card ('vertical' or 'horizontal')
+ * @param isPriceVisible - Whether the price element is visible
+ * @param isOriginalPriceVisible - Whether the original price element is visible
+ * @returns HTML string with price orientation styles applied
+ */
+export declare const applyPriceOrientationStyles: (html: string, layoutOrientation: OrientationType, priceOrientation: PriceOrientationType, isPriceVisible?: boolean, isOriginalPriceVisible?: boolean) => string;
 /**
  * Generates the default template for the Items Block.
  * @param params - Template parameters including orientation, items type, item ID, and formatting options

package/dist/src/extensions/Blocks/Recommendation/block.d.ts

@@ -137,12 +137,6 @@ export declare class RecommendationBlock extends Block {
      * heals templates saved before this feature without dirtying current ones.
      */
     private _healHidePriceAttr;
-    /**
-     * Empties a block copied in from another account: its strategy and attribute types
-     * are account-scoped and would not resolve here (SD-151945). Layout, locale and
-     * currency stay. The write stamps the current account, so the next pass is a no-op.
-     */
-    private _resetForeignPartnerConfig;
     /**
      * Gets the recommendation-id from a block node
      */

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

@@ -543,11 +543,6 @@ export declare const useRecommendationExtensionStore: import("pinia").StoreDefin
     openRemoveStrategyModal(): void;
     closeRemoveStrategyModal(): void;
     fetchStrategies(): Promise<void>;
-    /**
-     * Drops what the store still holds for a block whose account-scoped config was just
-     * reset in the document (SD-151945), so the panel re-seeds from the emptied node.
-     */
-    resetPartnerScopedConfig(id: number): 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 —

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

@@ -4,24 +4,30 @@ import type { RecommendationNodeConfig } from '../types/nodeConfig';
  * string or an entry that names a strategy.
  */
 export declare function isDefinedCampaignUrl(value: unknown): boolean;
-/** Recommendation block ids present in the HTML the host loaded the editor with. */
-export declare function loadedRecommendationIds(html: string): Set<number>;
 export interface PartnerScopeInputs {
     config: Pick<RecommendationNodeConfig, 'strategyId' | 'partnerName'>;
     blockId: number;
     partnerName: string;
     /** `undefined` when the host does not pass the map — the unstamped check is then off. */
     campaignUrls: Record<string, unknown> | undefined;
-    loadedIds: Set<number>;
+    /** With RRS off `buildCampaignUrl` drops the block's map entry, so the map says nothing. */
+    rrsEnabled: boolean;
 }
 /**
  * Whether a block carries another account's strategy config (SD-151945).
  *
  * A stamped block is judged by its stamp. An unstamped one predates the stamp, so it
  * falls back to the backend's own signal: a cross-account duplicate drops the block's
- * strategy entry from the campaign URL map but leaves the HTML untouched. That check
- * only holds for blocks the host loaded, whose map entry the host actually sent — a
- * saved module or a clone arrives under an id the map never had.
+ * strategy entry from the campaign URL map but leaves the HTML untouched. That signal
+ * only holds while RRS is on, and only for the HTML the host loaded — which is what
+ * the caller, a load-time migrator, runs on.
  */
-export declare function carriesForeignPartnerConfig({ config, blockId, partnerName, campaignUrls, loadedIds }: PartnerScopeInputs): boolean;
+export declare function carriesForeignPartnerConfig({ config, blockId, partnerName, campaignUrls, rrsEnabled }: PartnerScopeInputs): boolean;
+/**
+ * Whether an unstamped block's ownership can be decided at all. `carriesForeignPartnerConfig`
+ * answers `false` both for "clean" and for "cannot tell", and stamping on the latter would
+ * record a foreign block as this account's and silence every later check. A block with no
+ * strategy reference has nothing foreign to carry, so it is always decidable.
+ */
+export declare function canJudgeUnstampedBlock({ config, campaignUrls, rrsEnabled }: Pick<PartnerScopeInputs, 'config' | 'campaignUrls' | 'rrsEnabled'>): boolean;
 export declare function withoutCustomAttributes(composition: string[]): string[];

package/dist/src/mock/cortexChatStore.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Dev-harness stand-in for the cortex-fe MFE's shared `chat` store.
+ *
+ * `useCortexBlueprintBridge` resolves that store by id off the host's pinia at
+ * Guido's setup time, so a store registered after mount is never seen. Installing
+ * it here — before `<Guido>` renders — lets e2e drive the bridge through its real
+ * registration path instead of re-invoking the composable by hand.
+ *
+ * Activated with `?chatStore=true`; the instance is exposed on `window` so a test
+ * can push agent messages into it.
+ */
+export declare const installMockChatStore: () => void;

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

@@ -1,3 +1,13 @@
+/** 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;
+}
 /** The published editor snapshot — the shape a consumer reads off the shared store. */
 export interface GuidoEmailEditorState {
     /** Current Stripo HTML — stripe tables only, no DOCTYPE/wrapper. */
@@ -8,6 +18,10 @@ export interface GuidoEmailEditorState {
     lastUpdatedAt: number;
     /** Template id from the editor config, so a consumer can 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>;
 }
 /**
  * Outbound contract Guido publishes to the host's shared Pinia singleton so a
@@ -18,17 +32,11 @@ export interface GuidoEmailEditorState {
  * 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.
+ * State-only by contract: cortex-fe reads `pinia.state.value['guidoEmailEditor']`, which misses
+ * actions and getters. Intended writers: `useGuidoStateBridge` and `useCortexBlueprintBridge`.
  *
- * 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.
+ * The id `guidoEmailEditor` is part of the cross-MFE contract; the internal
+ * store `guidoEditor` is intentionally separate.
  */
 export declare const useGuidoEmailEditorStore: import("pinia").StoreDefinition<"guidoEmailEditor", GuidoEmailEditorState, {
     /** True once the bridge has published at least one snapshot. */
@@ -37,5 +45,7 @@ export declare const useGuidoEmailEditorStore: import("pinia").StoreDefinition<"
         css: string;
         lastUpdatedAt: number;
         templateId: string;
+        bridgeActive: boolean;
+        applyAcks: Record<string, ApplyAck>;
     } & import("pinia").PiniaCustomStateProperties<GuidoEmailEditorState>) => boolean;
 }, {}>;

package/dist/src/stores/onboarding.d.ts

@@ -1,5 +1,6 @@
 import type { OnboardingCardConfig, OnboardingType, OnboardingStoreState } from '@@/Types/onboarding';
 export declare const useOnboardingStore: import("pinia").StoreDefinition<"guidoOnboarding", OnboardingStoreState, {
+    /** @deprecated Components use the type-specific getters. Slated for deletion, see the SD-667788 dead-code ledger. */
     getOnboarding: (state: {
         onboardings: {
             newVersionPopup: {
@@ -390,6 +391,7 @@ export declare const useOnboardingStore: import("pinia").StoreDefinition<"guidoO
         };
         isFetched: boolean;
     } & import("pinia").PiniaCustomStateProperties<OnboardingStoreState>) => (type: OnboardingType) => boolean;
+    /** @deprecated Components use getGenericCurrentCard / getTextBlockCurrentCard. Slated for deletion, see the SD-667788 dead-code ledger. */
     getCurrentCard: (state: {
         onboardings: {
             newVersionPopup: {
@@ -2190,6 +2192,7 @@ export declare const useOnboardingStore: import("pinia").StoreDefinition<"guidoO
     close(type: OnboardingType): Promise<void>;
     next(type: OnboardingType): void;
     previous(type: OnboardingType): void;
+    /** @deprecated No caller in src/. Slated for deletion, see the SD-667788 dead-code ledger. */
     updateCardPosition(type: OnboardingType, cardIndex: number, position: {
         top: string;
         position: string;
@@ -2198,6 +2201,7 @@ export declare const useOnboardingStore: import("pinia").StoreDefinition<"guidoO
     onDiscoverNowClicked(): Promise<void>;
     onRemindMeLater(): void;
     onNewVersionPopupClose(): Promise<void>;
+    /** @deprecated No caller in src/. Slated for deletion, see the SD-667788 dead-code ledger. */
     isOnboardingActive(): boolean;
     fetchUserModalState(): Promise<void>;
     setUserModalState(modal: string, state: string, page: string): Promise<void>;

package/dist/src/stores/recommendation.d.ts

@@ -6,5 +6,10 @@ type RecommendationConfig = {
 interface StoreState {
     recommendationConfigs: RecommendationConfig[];
 }
+/**
+ * @deprecated recommendationConfigs has no writer in src/, so the store is
+ * permanently empty and its only readers (useHtmlValidator.ts:496-497) are a
+ * no-op. Slated for deletion, see the SD-667788 dead-code ledger.
+ */
 export declare const useRecommendationStore: import("pinia").StoreDefinition<"guidoRecommendation", StoreState, {}, {}>;
 export {};

package/dist/src/utils/dateUtil.d.ts

@@ -3,12 +3,22 @@
  * en-US -> MM/DD/YYYY
  * en-GB -> DD/MM/YYYY
  * tr-TR -> DD.MM.YYYY
+ *
+ * The non-string branches below are unreachable: the only caller chain is
+ * formatShortDate -> AssignStrategyDrawer.vue:74, which passes a non-empty string.
+ * The function itself is live — do not delete it with them.
  */
 export declare const convertToDateObject: (date: string | number | Date | null | undefined) => Date;
 export declare const locale: () => string;
 export declare const localTz: string;
 export declare const timezone: () => string;
+/**
+ * @deprecated No caller in src/ and not exported from library.ts. Slated for deletion, see the SD-667788 dead-code ledger.
+ */
 export declare const hour12: () => boolean;
+/**
+ * @deprecated No caller in src/ and not exported from library.ts. Slated for deletion, see the SD-667788 dead-code ledger.
+ */
 export declare const dateFormat: () => string;
 /**
  * @example 04/22/2024

package/dist/src/utils/genericUtil.d.ts

@@ -24,6 +24,9 @@ export declare const getCsrfToken: () => string;
  */
 export declare const getUrlParams: () => URLSearchParams;
 export declare const getUrlParam: (paramName: string, defaultValue?: string) => string;
+/**
+ * @deprecated No caller in src/. Slated for deletion, see the SD-667788 dead-code ledger.
+ */
 export declare const replaceString: (string?: string, values?: Record<string, string | number>, isRemoveEmptyValues?: boolean) => string;
 /**
  * Narrows an unknown API value to a printable string; anything that is neither

package/dist/static/styles/components/version-history.css.js

@@ -1,4 +1,4 @@
-const n = `.patch-session-container {
+const r = `.patch-session-container {
     row-gap: 16px;
 }
 
@@ -28,11 +28,7 @@ ue-vh-patch.selected .patch-wrapper {
 .change-history-panel-wrapper .control-panel-header {
     padding: 16px 0 16px 16px;
 }
-
-.change-history-panel-wrapper .header-control-panel-label {
-    grid-area: 1 / 1 / 2 / 12;
-}
 `;
 export {
-  n as default
+  r as default
 };

package/dist/stores/guido-email-editor.js

@@ -4,7 +4,9 @@ const d = e("guidoEmailEditor", {
     html: "",
     css: "",
     lastUpdatedAt: 0,
-    templateId: ""
+    templateId: "",
+    bridgeActive: !1,
+    applyAcks: {}
   }),
   getters: {
     /** True once the bridge has published at least one snapshot. */

package/dist/stores/onboarding.js

@@ -20,8 +20,10 @@ const t = () => ({
 }), c = s("guidoOnboarding", {
   state: () => a(),
   getters: {
+    /** @deprecated Components use the type-specific getters. Slated for deletion, see the SD-667788 dead-code ledger. */
     getOnboarding: (n) => (o) => n.onboardings[o],
     isActive: (n) => (o) => n.onboardings[o].isActive,
+    /** @deprecated Components use getGenericCurrentCard / getTextBlockCurrentCard. Slated for deletion, see the SD-667788 dead-code ledger. */
     getCurrentCard: (n) => (o) => {
       const i = n.onboardings[o];
       return i.config[i.cardIndex];
@@ -81,6 +83,7 @@ const t = () => ({
     previous(n) {
       this.onboardings[n].cardIndex > 0 && this.onboardings[n].cardIndex--;
     },
+    /** @deprecated No caller in src/. Slated for deletion, see the SD-667788 dead-code ledger. */
     updateCardPosition(n, o, i) {
       const r = this.onboardings[n].config[o];
       r && (r.top = i.top, r.position = i.position);
@@ -97,6 +100,7 @@ const t = () => ({
     async onNewVersionPopupClose() {
       await this.setUserModalState("newVersionPopup", "true", "Guido");
     },
+    /** @deprecated No caller in src/. Slated for deletion, see the SD-667788 dead-code ledger. */
     isOnboardingActive() {
       return Object.values(this.onboardings).some((n) => n.isActive);
     },