@useinsider/guido 3.3.0 → 3.4.0-beta.5d19726

package/dist/package.json.js

@@ -1,4 +1,4 @@
-const o = { stripo: { version: "2.62.0" } }, s = {
+const o = { stripo: { version: "2.64.0" } }, s = {
   guido: o
 };
 export {

package/dist/services/unsubscribeApi.js

@@ -1,13 +1,13 @@
 import { useHttp as t } from "../composables/useHttp.js";
-import { useToaster as n } from "../composables/useToaster.js";
+import { useToaster as a } from "../composables/useToaster.js";
 const u = () => {
-  const { get: r } = t(), { handleError: s } = n();
+  const { get: e } = t(), { handleError: s } = a();
   return { getUnsubscribePages: async () => {
     try {
-      const { data: e = [] } = await r("/unsubscribe-pages/get-all");
-      return e;
-    } catch (e) {
-      return s(e, "Failed to fetch unsubscribe pages"), [];
+      const { data: r } = await e("/unsubscribe-pages/get-all");
+      return Array.isArray(r) ? r : [];
+    } catch (r) {
+      return s(r, "Failed to fetch unsubscribe pages"), [];
     }
   } };
 };

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

@@ -0,0 +1,25 @@
+/**
+ * Bridges cortex-fe's chat store to Guido's Stripo editor.
+ *
+ * cortex-fe is a Module Federation MFE that registers `defineStore('chat', …)`
+ * on the host's shared (singleton) Pinia. Guido — bundled inside MFE consumers
+ * that also share that pinia — reads the same store at runtime via
+ * `getActivePinia()._s.get('chat')`. No build-time dep on cortex-fe.
+ *
+ * The bridge handles two segment shapes:
+ *
+ *   - `blueprint` segments with `blueprintType === 'email_template'` are
+ *     applied to the Stripo editor (immediate on first sighting, debounced on
+ *     update, identical-html no-ops).
+ *   - `error` segments (and message-level `isError` / `isCancelled`) trigger
+ *     a localized toaster.
+ *
+ * In dev (`import.meta.env.DEV`) every observed segment + message-level flag
+ * change is also `console.debug`-logged with the prefix `[guido:cortex]` so a
+ * developer can watch the agent stream in real time. In production this is
+ * gated behind `localStorage.guido:debug:ai === '1'`.
+ *
+ * If cortex-fe isn't loaded the chat store is undefined and the bridge is a
+ * no-op (intentional — Guido must still work standalone).
+ */
+export declare const useCortexBlueprintBridge: () => void;

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

@@ -0,0 +1,21 @@
+type ApplyStatus = 'pending' | 'applying' | 'applied' | 'failed';
+/**
+ * Applies email_template blueprints from the chat agent to the Stripo editor.
+ *
+ * - blueprint_create + manual Apply click: immediate.
+ * - blueprint_update: debounced 250 ms trailing so rapid mid-stream updates
+ *   don't thrash updateHtmlAndCss.
+ */
+export declare const useEmailTemplateApplier: () => {
+    applyStatus: import("vue").Ref<Record<string, ApplyStatus>>;
+    applyTemplate: (blueprintId: string, data: {
+        html?: string;
+        css?: string;
+    }) => void;
+    applyTemplateDebounced: (blueprintId: string, data: {
+        html?: string;
+        css?: string;
+    }) => void;
+};
+export declare const resetEmailTemplateApplier: () => void;
+export {};

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

@@ -0,0 +1,22 @@
+/**
+ * Outbound bridge — publishes the current editor's html/css to the shared
+ * 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. 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.
+ *
+ * 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/enums/extensions/recommendationBlock.d.ts

@@ -6,11 +6,16 @@ export declare const URLS: {
 export declare const QUERY_PARAMS: {
     CLIENT_ID: string;
 };
-export declare const RecommendationFeedSourceMaps: RecommendationFeedItem[];
+/**
+ * Get recommendation feed source maps lazily so translated names resolve at access time.
+ * Must be called within a Vue component context or after Pinia is initialized.
+ */
+export declare const getRecommendationFeedSourceMaps: () => RecommendationFeedItem[];
 export declare const PriceAttributes: string[];
 export declare const currencyLocationMaps: TextValueObject[];
 export declare const currencyOperators: TextValueObject[];
 export declare const currencyDecimalCounts: TextValueObject[];
+export declare const OP_ANY_OF = "||";
 export declare const operatorOptionsForStrings: TextValueObject[];
 export declare const operatorOptionsForArrayOfStrings: TextValueObject[];
 export declare const operatorOptionsForNumbers: TextValueObject[];

package/dist/src/enums/unsubscribe.d.ts

@@ -18,9 +18,14 @@ export declare const PRODUCT_TYPE_URL_SEGMENTS: {
     readonly 97: "email";
 };
 export declare const INSIDER_ID = "iid";
-export declare const DEFAULT_UNSUBSCRIBE_GROUP: {
-    readonly name: "Global Unsubscribe";
-    readonly sendGridId: "G";
+export declare const DEFAULT_UNSUBSCRIBE_GROUP_SEND_GRID_ID = "G";
+/**
+ * Get the default unsubscribe group lazily so the translated name resolves at access time.
+ * Must be called within a Vue component context or after Pinia is initialized.
+ */
+export declare const getDefaultUnsubscribeGroup: () => {
+    name: string;
+    sendGridId: string;
 };
 export declare const UNSUBSCRIBE_PAGES_LINK = "/email/unsubscribe-pages";
 export declare const PAGE_TYPES: {

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

@@ -1,4 +1,4 @@
-declare const migrationTemplate = "\n    <td\n        align=\"left\"\n        esd-extension-block-id=\"radio-button-block\"\n        esd-handler-name=\"esd-extension-RadioButtonBlock\"\n        class=\"\n            radio-button\n            radio-button-v2\n            esd-block-ra\n            esd-radio-button-block\n            esd-extension-block\n            es-p10t\n            es-p10b\n            es-p30r\n            es-p30l\"\n    >\n        <table cellpadding=\"0\" cellspacing=\"0\" role=\"presentation\" width=\"100%\">\n            <tbody>\n                <tr>\n                    <td align=\"left\" width=\"70%\" style=\"vertical-align: top;\">\n                        <table cellpadding=\"0\" cellspacing=\"0\" role=\"presentation\" width=\"100%\">\n                            <tbody>\n                                <tr>\n                                    {-{-TITLE-}-}\n                                </tr>\n                                <tr>\n                                    {-{-DESCRIPTION-}-}\n                                </tr>\n                            </tbody>\n                        </table>\n                    </td>\n                    <td align=\"right\" width=\"30%\" style=\"vertical-align: middle;\">\n                        <table cellpadding=\"0\" cellspacing=\"0\" role=\"presentation\" width=\"100%\">\n                            <tbody>\n                                <tr>\n                                    <td width=\"50%\">\n                                        <table width=\"100%\">\n                                            <tr>\n                                                <td width=\"24\">\n                                                    <input\n                                                        type=\"radio\"\n                                                        id=\"radioYes\"\n                                                        name=\"unsubscribe\"\n                                                        data-cke-editable=\"1\"\n                                                        style=\"margin: 0px; vertical-align: middle;\">\n                                                    </td>\n                                                {-{-YES-}-}\n                                            </tr>\n                                        </table>\n                                    </td>\n                                    <td width=\"50%\">\n                                        <table width=\"100%\">\n                                            <tr>\n                                                <td width=\"24\">\n                                                    <input\n                                                        type=\"radio\"\n                                                        id=\"radioNo\"\n                                                        name=\"unsubscribe\"\n                                                        data-cke-editable=\"1\"\n                                                        style=\"margin: 0px; vertical-align: middle;\">\n                                                </td>\n                                                {-{-NO-}-}\n                                            </tr>\n                                        </table>\n                                    </td>\n                                </tr>\n                            </tbody>\n                        </table>\n                    </td>\n                </tr>\n            </tbody>\n        </table>\n    </td>\n";
+declare const migrationTemplate = "\n    <td\n        align=\"left\"\n        esd-extension-block-id=\"radio-button-block\"\n        esd-handler-name=\"esd-extension-RadioButtonBlock\"\n        class=\"\n            radio-button-block\n            radio-button-v2\n            esd-block-ra\n            esd-radio-button-block\n            esd-extension-block\n            es-p10t\n            es-p10b\n            es-p30r\n            es-p30l\"\n    >\n        <table cellpadding=\"0\" cellspacing=\"0\" role=\"presentation\" width=\"100%\">\n            <tbody>\n                <tr>\n                    <td align=\"left\" width=\"70%\" style=\"vertical-align: top;\">\n                        <table cellpadding=\"0\" cellspacing=\"0\" role=\"presentation\" width=\"100%\">\n                            <tbody>\n                                <tr>\n                                    {-{-TITLE-}-}\n                                </tr>\n                                <tr>\n                                    {-{-DESCRIPTION-}-}\n                                </tr>\n                            </tbody>\n                        </table>\n                    </td>\n                    <td align=\"right\" width=\"30%\" style=\"vertical-align: middle;\">\n                        <table cellpadding=\"0\" cellspacing=\"0\" role=\"presentation\" width=\"100%\">\n                            <tbody>\n                                <tr>\n                                    <td width=\"50%\">\n                                        <table width=\"100%\">\n                                            <tr>\n                                                <td width=\"24\">\n                                                    <input\n                                                        type=\"radio\"\n                                                        id=\"radioYes\"\n                                                        name=\"unsubscribe\"\n                                                        data-cke-editable=\"1\"\n                                                        style=\"margin: 0px; vertical-align: middle;\">\n                                                    </td>\n                                                {-{-YES-}-}\n                                            </tr>\n                                        </table>\n                                    </td>\n                                    <td width=\"50%\">\n                                        <table width=\"100%\">\n                                            <tr>\n                                                <td width=\"24\">\n                                                    <input\n                                                        type=\"radio\"\n                                                        id=\"radioNo\"\n                                                        name=\"unsubscribe\"\n                                                        data-cke-editable=\"1\"\n                                                        style=\"margin: 0px; vertical-align: middle;\">\n                                                </td>\n                                                {-{-NO-}-}\n                                            </tr>\n                                        </table>\n                                    </td>\n                                </tr>\n                            </tbody>\n                        </table>\n                    </td>\n                </tr>\n            </tbody>\n        </table>\n    </td>\n";
 /**
  * @returns The template for the default checkbox block
  */

package/dist/src/extensions/Blocks/Recommendation/services/configService.d.ts

@@ -95,15 +95,23 @@ export declare class RecommendationConfigService {
      *
      * Called when a block is first created (dropped into template).
      * Can optionally merge in partial config from migration.
+     *
+     * The `wasFreshDrop` flag distinguishes a brand-new drop (no prior config)
+     * from a clone (Stripo replays the source's setNodeConfig payload before
+     * onCreated fires). Callers use this to skip side-effects already inherited
+     * from the source.
      * @example
      * // In Block.onCreated lifecycle
-     * RecommendationConfigService.initializeConfig(this.api, node);
+     * const { config, wasFreshDrop } = RecommendationConfigService.initializeConfig(this.api, node);
      * @param api - Stripo extension API with document modifier
      * @param node - The immutable HTML node to initialize
      * @param partialConfig - Optional partial config to merge with defaults
-     * @returns The initialized configuration
+     * @returns The initialized configuration and whether the node was a fresh drop
      */
-    static initializeConfig(api: DocumentModifierApi, node: ImmutableHtmlNode, partialConfig?: PartialNodeConfig): RecommendationNodeConfig;
+    static initializeConfig(api: DocumentModifierApi, node: ImmutableHtmlNode, partialConfig?: PartialNodeConfig): {
+        config: RecommendationNodeConfig;
+        wasFreshDrop: boolean;
+    };
     /**
      * Save complete configuration to a node
      *

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

@@ -1,5 +1,5 @@
 import type { Orientation, Languages, Currency, NumericSeparator, FiltersResponse, Filter, RecommendationProduct } from '@@/Types/recommendation';
-interface PerBlockConfigs {
+export interface PerBlockConfigs {
     cardsInRow: number;
     currencySettings: {
         name: string;
@@ -272,6 +272,12 @@ export declare const useRecommendationExtensionStore: import("pinia").StoreDefin
     deleteFilter(filter: Filter): void;
     addFilter(filter: Filter): void;
     generateFilterQuery(): string;
+    /**
+     * Validation-only check invoked at save-CTA time. Defined as an action
+     * (not a getter) so reading it does not register reactive tracking on
+     * every block's recommendationConfigs across user edits.
+     */
+    hasInvalidBlock(): boolean;
     fetchRecommendationProducts(): Promise<void>;
     _doFetchProducts(): Promise<void>;
 }>;

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

@@ -1,4 +1,6 @@
 import type { Filter } from '@@/Types/recommendation';
+export declare function safeDecodeURIComponent(value: string): string;
+export declare function parseTagList(value: string): string[];
 /**
  * Generates the complete query with outer group operators
  * @param filters Array of Filter objects

package/dist/src/extensions/Blocks/Recommendation/validation/requiredFields.d.ts

@@ -0,0 +1,21 @@
+import type { PerBlockConfigs } from '../store/recommendation';
+import type { Currency, Languages } from '@@/Types/recommendation';
+/**
+ * Structural slice of the recommendation extension store that descriptors may read.
+ * Add new fields here when a future descriptor needs them.
+ */
+export interface ExtensionStoreSlice {
+    languages: Languages;
+    currencyList: Currency[];
+}
+interface RequiredField {
+    key: string;
+    getValue: (config: PerBlockConfigs) => string;
+    getAvailableOptions?: (store: ExtensionStoreSlice) => string[];
+    condition?: (config: PerBlockConfigs) => boolean;
+}
+export declare const REQUIRED_RECOMMENDATION_FIELDS: RequiredField[];
+export declare const RecommendationRequiredFieldsKey = "newsletter.recommendation-fill-required-fields";
+export declare function getInvalidFields(config: PerBlockConfigs, store: ExtensionStoreSlice): string[];
+export declare function isConfigValid(config: PerBlockConfigs, store: ExtensionStoreSlice): boolean;
+export {};

package/dist/src/extensions/Blocks/Recommendation/validation/requiredFields.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,41 @@
+/**
+ * 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, for cortex-fe to scope per-template. */
+    templateId: string;
+}, {
+    /** True once the bridge has published at least one snapshot. */
+    hasSnapshot: (state: {
+        html: string;
+        css: string;
+        lastUpdatedAt: number;
+        templateId: string;
+    } & 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;
+}, {}>;

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

@@ -0,0 +1,20 @@
+import { defineStore as e } from "pinia";
+const d = e("guidoEmailEditor", {
+  state: () => ({
+    /** Current Stripo HTML — stripe tables only, no DOCTYPE/wrapper. */
+    html: "",
+    /** Current Stripo CSS — es-p* utility classes used by the html. */
+    css: "",
+    /** Wall-clock ms when html/css were last written by the bridge. */
+    lastUpdatedAt: 0,
+    /** Template id from the editor config, for cortex-fe to scope per-template. */
+    templateId: ""
+  }),
+  getters: {
+    /** True once the bridge has published at least one snapshot. */
+    hasSnapshot: (t) => t.lastUpdatedAt > 0 && t.html !== ""
+  }
+});
+export {
+  d as useGuidoEmailEditorStore
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@useinsider/guido",
-  "version": "3.3.0",
+  "version": "3.4.0-beta.5d19726",
   "description": "Guido is a Vue + TypeScript wrapper for Email Plugin. Easily embed the email editor in your Vue applications.",
   "main": "./dist/guido.umd.cjs",
   "module": "./dist/library.js",
@@ -39,7 +39,7 @@
     "@vueuse/core": "11.3.0",
     "lodash-es": "4.17.21",
     "pinia": "2.3.1",
-    "valibot": "1.1.0",
+    "valibot": "1.2.0",
     "vite": "6.3.5",
     "vue": "2.7.14"
   },
@@ -61,7 +61,6 @@
     "@typescript-eslint/parser": "7.18.0",
     "@useinsider/eslint-config": "1.5.3",
     "@vitejs/plugin-vue2": "2.3.1",
-    "@vue/eslint-config-typescript": "12.0.0",
     "eslint": "8.57.1",
     "eslint-config-airbnb-base": "15.0.0",
     "eslint-config-airbnb-typescript": "18.0.0",
@@ -82,6 +81,8 @@
     "vue-tsc": "2.2.10"
   },
   "overrides": {
+    "axios": "1.8.2",
+    "flatted": "3.4.2",
     "micromatch": "4.0.8",
     "path-to-regexp": "6.3.0"
   },
@@ -90,7 +91,7 @@
   },
   "guido": {
     "stripo": {
-      "version": "2.62.0"
+      "version": "2.64.0"
     }
   }
 }