@useinsider/guido 3.11.0 → 3.12.0-beta.1b68f97

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

@@ -5,7 +5,9 @@
  * All types are inferred from these schemas to ensure single source of truth.
  * @module @types/config/schemas
  */
+import type { DynamicContentNode } from '../generic';
 import type { SavedTemplateDetails } from '../stripo';
+import type { ActionButton } from '../toaster';
 import * as v from 'valibot';
 /**
  * Handler function for external validation before save
@@ -13,6 +15,18 @@ import * as v from 'valibot';
  * @returns Promise<boolean> - true if valid, false to cancel save
  */
 export type ExternalValidationHandler = (data: Omit<SavedTemplateDetails, 'metadata'>) => Promise<boolean>;
+/**
+ * Content for the domain-allowlist block toaster, supplied by the host. The host owns
+ * role-gating, the settings deep-link, and translated copy; Guido renders the result via
+ * its own toaster. `actionButton.onClick` runs the host action (e.g. the "Add to allowlist"
+ * deep-link). Returning null/void blocks the save with no toaster.
+ * @param blockedDomains - the non-allowlisted domains found in the template
+ */
+export interface AllowlistToastContent {
+    message: string;
+    actionButton?: ActionButton;
+}
+export type ResolveAllowlistToastHandler = (blockedDomains: string[]) => AllowlistToastContent | null | void;
 /**
  * Message type constants for email templates
  */
@@ -86,6 +100,21 @@ export declare const DynamicContentSchema: v.ObjectSchema<{
         readonly value: v.StringSchema<undefined>;
     }, undefined>, undefined>;
 }, undefined>;
+/**
+ * A node in the partner-keyed dynamic-content tree (backend categorized-fields
+ * shape). Loose so the many extra backend fields pass through untouched; Guido
+ * only reads text/tag_text/value and recurses children/select_items.
+ */
+export declare const DynamicContentNodeSchema: v.GenericSchema<DynamicContentNode>;
+/**
+ * Partner-keyed dynamic-content list: `{ [partnerName]: DynamicContentNode[] }`.
+ * Architect is multi-partner, so the raw structure is keyed by partner name.
+ *
+ * Per-entry `fallback`: the raw backend payload may carry non-array metadata
+ * keys, so a value that is not a node array degrades to `[]` instead of failing
+ * the whole config validation (the repair feature is fail-open).
+ */
+export declare const DynamicContentListSchema: v.RecordSchema<v.StringSchema<undefined>, v.SchemaWithFallback<v.ArraySchema<v.GenericSchema<DynamicContentNode>, undefined>, readonly []>, undefined>;
 /**
  * Legacy recommendation block config (v1 format) keyed by block ID.
  *
@@ -227,6 +256,13 @@ export declare const TemplateSchema: v.ObjectSchema<{
             readonly value: v.StringSchema<undefined>;
         }, undefined>, undefined>;
     }, undefined>, undefined>, readonly []>;
+    /**
+     * Partner-keyed set of dynamic-content items the account offers, e.g.
+     * `{ [partnerName]: [{ text, value, children }] }`. Guido flattens the active
+     * (first) partner's leaf attributes into the label→token map that repairs
+     * label-form placeholders (`{{ Phone Number }}`) in dropped saved modules.
+     */
+    readonly dynamicContentList: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.SchemaWithFallback<v.ArraySchema<v.GenericSchema<DynamicContentNode>, undefined>, readonly []>, undefined>, {}>;
     /** Valid custom field attribute names from the partner's categorized fields */
     readonly customFieldAttributes: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, readonly []>;
     /** Selected unsubscribe page IDs */
@@ -354,6 +390,8 @@ export declare const FeaturesSchema: v.ObjectSchema<{
     readonly liquidSyntax: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
     /** Enable autosave (3-min interval + tab-hide). User toggles on/off from the header. */
     readonly autosave: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
+    /** Enable pre-save domain-allowlist validation (opt-in; host supplies the block toaster via callbacks.resolveAllowlistToast) */
+    readonly allowlistEnabled: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
 }, undefined>;
 /**
  * Default block types available in Stripo
@@ -559,6 +597,12 @@ export declare const CallbacksSchema: v.ObjectSchema<{
      * Return false to cancel the save operation.
      */
     readonly externalValidation: v.OptionalSchema<v.CustomSchema<ExternalValidationHandler, v.ErrorMessage<v.CustomIssue> | undefined>, undefined>;
+    /**
+     * Resolves the block toaster's content when the domain-allowlist check (features.allowlistEnabled)
+     * blocks a save. Host-supplied so role-gating, the settings deep-link, and copy stay host-side.
+     * Returning null/void blocks the save with no toaster.
+     */
+    readonly resolveAllowlistToast: v.OptionalSchema<v.CustomSchema<ResolveAllowlistToastHandler, v.ErrorMessage<v.CustomIssue> | undefined>, undefined>;
 }, undefined>;
 /**
  * Complete Guido configuration schema
@@ -622,6 +666,13 @@ export declare const GuidoConfigSchema: v.ObjectSchema<{
                 readonly value: v.StringSchema<undefined>;
             }, undefined>, undefined>;
         }, undefined>, undefined>, readonly []>;
+        /**
+         * Partner-keyed set of dynamic-content items the account offers, e.g.
+         * `{ [partnerName]: [{ text, value, children }] }`. Guido flattens the active
+         * (first) partner's leaf attributes into the label→token map that repairs
+         * label-form placeholders (`{{ Phone Number }}`) in dropped saved modules.
+         */
+        readonly dynamicContentList: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.SchemaWithFallback<v.ArraySchema<v.GenericSchema<DynamicContentNode>, undefined>, readonly []>, undefined>, {}>;
         /** Valid custom field attribute names from the partner's categorized fields */
         readonly customFieldAttributes: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, readonly []>;
         /** Selected unsubscribe page IDs */
@@ -734,6 +785,8 @@ export declare const GuidoConfigSchema: v.ObjectSchema<{
         readonly liquidSyntax: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
         /** Enable autosave (3-min interval + tab-hide). User toggles on/off from the header. */
         readonly autosave: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
+        /** Enable pre-save domain-allowlist validation (opt-in; host supplies the block toaster via callbacks.resolveAllowlistToast) */
+        readonly allowlistEnabled: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
     }, undefined>, {}>;
     /** Block configuration */
     readonly blocks: v.OptionalSchema<v.ObjectSchema<{
@@ -804,5 +857,11 @@ export declare const GuidoConfigSchema: v.ObjectSchema<{
          * Return false to cancel the save operation.
          */
         readonly externalValidation: v.OptionalSchema<v.CustomSchema<ExternalValidationHandler, v.ErrorMessage<v.CustomIssue> | undefined>, undefined>;
+        /**
+         * Resolves the block toaster's content when the domain-allowlist check (features.allowlistEnabled)
+         * blocks a save. Host-supplied so role-gating, the settings deep-link, and copy stay host-side.
+         * Returning null/void blocks the save with no toaster.
+         */
+        readonly resolveAllowlistToast: v.OptionalSchema<v.CustomSchema<ResolveAllowlistToastHandler, v.ErrorMessage<v.CustomIssue> | undefined>, undefined>;
     }, undefined>, {}>;
 }, undefined>;

package/dist/src/@types/generic.d.ts

@@ -13,6 +13,24 @@ export type BaseDynamicContent = {
 export type DynamicContent = BaseDynamicContent & {
     text: string;
 };
+/**
+ * A node in the partner-keyed dynamic-content tree (backend categorized-fields
+ * shape). Category nodes carry `children`/`select_items`; leaf nodes are the
+ * real attributes. Extra backend fields are allowed and ignored.
+ */
+export type DynamicContentNode = {
+    text?: string;
+    tag_text?: string;
+    value?: string;
+    children?: DynamicContentNode[];
+    select_items?: DynamicContentNode[];
+};
+/**
+ * Partner-keyed dynamic-content list. Architect is multi-partner, so the map is
+ * keyed by partner name; each entry is that partner's category tree. Guido
+ * flattens the active (first) partner's leaf attributes into a `DynamicContent[]`.
+ */
+export type DynamicContentList = Record<string, DynamicContentNode[]>;
 export type MergeTag = BaseDynamicContent & {
     label: string;
     selStart?: number;

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

@@ -34,6 +34,9 @@ export declare const useConfig: () => {
                     value: string;
                 } | undefined;
             }[];
+            dynamicContentList: {
+                [x: string]: import("../library").DynamicContentNode[];
+            };
             customFieldAttributes: string[];
             selectedUnsubscribePages: number[];
             forceRecreate: boolean;
@@ -93,6 +96,7 @@ export declare const useConfig: () => {
             modulesDisabled: boolean;
             liquidSyntax: boolean;
             autosave: boolean;
+            allowlistEnabled: boolean;
         };
         blocks: {
             excludeDefaults: ("amp-accordion" | "amp-carousel" | "amp-form-controls" | "banner-block" | "button-block" | "html-block" | "image-block" | "menu-block" | "social-block" | "spacer-block" | "text-block" | "timer-block" | "video-block")[];
@@ -132,6 +136,7 @@ export declare const useConfig: () => {
         };
         callbacks: {
             externalValidation?: import("@@/Types/config").ExternalValidationHandler | undefined;
+            resolveAllowlistToast?: import("../@types/config/schemas").ResolveAllowlistToastHandler | undefined;
         };
     } | null>;
     initialized: import("vue").Ref<boolean>;
@@ -162,6 +167,9 @@ export declare const useConfig: () => {
                 value: string;
             } | undefined;
         }[];
+        dynamicContentList: {
+            [x: string]: import("../library").DynamicContentNode[];
+        };
         customFieldAttributes: string[];
         selectedUnsubscribePages: number[];
         forceRecreate: boolean;
@@ -221,6 +229,7 @@ export declare const useConfig: () => {
         modulesDisabled: boolean;
         liquidSyntax: boolean;
         autosave: boolean;
+        allowlistEnabled: boolean;
     } | null>;
     blocks: import("vue").ComputedRef<{
         excludeDefaults: ("amp-accordion" | "amp-carousel" | "amp-form-controls" | "banner-block" | "button-block" | "html-block" | "image-block" | "menu-block" | "social-block" | "spacer-block" | "text-block" | "timer-block" | "video-block")[];
@@ -260,6 +269,7 @@ export declare const useConfig: () => {
     } | null>;
     callbacks: import("vue").ComputedRef<{
         externalValidation?: import("@@/Types/config").ExternalValidationHandler | undefined;
+        resolveAllowlistToast?: import("../@types/config/schemas").ResolveAllowlistToastHandler | undefined;
     } | null>;
     templateId: import("vue").ComputedRef<string>;
     userId: import("vue").ComputedRef<string>;

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

@@ -0,0 +1,18 @@
+import type { ModuleAddData, ModuleModifier } from '@@/Types/stripo';
+/**
+ * Host-registered translation key for the "some attributes could not be
+ * converted" toaster. Guido resolves it against the host's `window.trans.en`;
+ * the copy is registered host-side.
+ */
+export declare const UNRESOLVED_DYNAMIC_CONTENT_ON_DROP_KEY = "dynamic-content.unresolved-attributes-on-drop";
+/**
+ * Repairs label-form dynamic-content tokens in saved modules as they are dropped
+ * or copied into the editor. Saved modules serialize merge-tag chips by their
+ * display label (`{{ Phone Number }}`); this maps them back to their canonical
+ * token (`{{phone_number}}`) using the account's dynamic-content list.
+ *
+ * Wired into Stripo via the `onModuleAdd` init callback (see `useStripo`).
+ */
+export declare const useModuleDynamicContentRepair: () => {
+    handleModuleAdd: (data: ModuleAddData, modifier: ModuleModifier) => void;
+};

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

@@ -1,3 +1,3 @@
 export declare const usePreviewInteractionGuard: () => {
-    blockPreviewInteractions: (iframe: HTMLIFrameElement) => void;
+    guardPreviewInteractions: (iframe: HTMLIFrameElement) => void;
 };

package/dist/src/composables/validators/useAllowlistValidator.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Pre-save domain-allowlist validation. Extracts every external domain from the compiled
+ * HTML/CSS and asks the backend whether each is allowlisted, so an un-allowlisted link can
+ * block the save BEFORE anything is persisted. Gated by `features.allowlistEnabled` in
+ * `useSave`; the block toaster is rendered by Guido from host-supplied content.
+ */
+export declare const useAllowlistValidator: () => {
+    getBlockedDomains: (html: string, css: string) => Promise<string[]>;
+};

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

@@ -0,0 +1 @@
+export declare function migrateSocialIcons(html: string): string;

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

@@ -5,8 +5,8 @@
  * for easy maintenance and domain migration.
  */
 export declare const ACADEMY_LINKS: {
-    readonly EMAIL_EDITOR: "https://academy.insiderone.com//docs/email-drag-and-drop-editor";
-    readonly GLOBAL_UNSUBSCRIBE: "https://academy.insiderone.com//docs/global-unsubscribe-preference-center";
-    readonly AMP_FOR_EMAILS: "https://academy.insiderone.com//docs/amp-for-emails";
+    readonly EMAIL_EDITOR: "https://academy.insiderone.com/docs/email-drag-and-drop-editor";
+    readonly GLOBAL_UNSUBSCRIBE: "https://academy.insiderone.com/docs/global-unsubscribe-preference-center";
+    readonly AMP_FOR_EMAILS: "https://academy.insiderone.com/docs/amp-for-emails";
 };
 export type AcademyLinkKey = keyof typeof ACADEMY_LINKS;

package/dist/src/extensions/Blocks/Recommendation/constants/controlIds.d.ts

@@ -3,6 +3,7 @@
  * These IDs are returned by the getId() method of each control
  */
 export declare enum RecommendationControlId {
+    BLOCK_BACKGROUND = "recommendation-block-background-color-control",
     BUTTON_ALIGN = "recommendation-block-button-align-control",
     BUTTON_BORDER = "recommendation-block-button-border-control",
     BUTTON_BORDER_RADIUS = "recommendation-block-button-border-radius-control",

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

@@ -0,0 +1,14 @@
+export declare const BlockBackgroundColorControl: {
+    new (): {
+        getId(): string;
+        getLabels(): {
+            title: string;
+        };
+        getTargetNodes(root: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode[];
+        getAdditionalModifications(root: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").TemplateModifier<import("@stripoinc/ui-editor-extensions").HtmlNodeModifier, import("@stripoinc/ui-editor-extensions").CssNodeModifier> | undefined;
+        getParentControlId(): string;
+        api: import("@stripoinc/ui-editor-extensions").ControlApi;
+        getModificationDescription(): import("@stripoinc/ui-editor-extensions").ModificationDescription | undefined;
+        isVisible(_node: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): boolean;
+    };
+};

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

@@ -20,6 +20,7 @@ export { ButtonControls } from './button';
 export { ImageControls } from './image';
 export { CustomAttributeControls } from './customAttribute';
 export { SpacingControl, SPACING_CONTROL_ID } from './spacing';
+export { BlockBackgroundColorControl } from './blockBackground';
 export { CardBackgroundColorControl, CARD_BACKGROUND_COLOR_CONTROL_ID } from './cardBackground';
 export { RecommendationCardCompositionControl, COMPOSITION_CONTROL_BLOCK_ID } from './cardComposition';
 export { SyncInfoMessageControl, SYNC_INFO_MESSAGE_CONTROL_ID } from './syncInfoMessage';

package/dist/src/extensions/Blocks/Unsubscribe/utils/constants.d.ts

@@ -9,3 +9,4 @@ export declare const DATA_ATTRIBUTES: {
     readonly BLOCK_ID: "data-unsubscribe-block-id";
 };
 export declare const UNSUBSCRIBE_BLOCK_SELECTOR = ".unsubscribe-block-v2";
+export declare const UNSUBSCRIBE_LINK_SELECTOR = "a[data-unsubscribe-link=\"true\"], a.unsubscribe-link";

package/dist/src/extensions/Blocks/controlFactories.d.ts

@@ -115,6 +115,42 @@ export declare function createTextBackgroundColorControl(controlId: string, targ
         isVisible(_node: ImmutableHtmlNode): boolean;
     };
 };
+/**
+ * Factory for a background-color control that paints a whole extension block (SD-145082).
+ *
+ * Base is `ButtonBackgroundColorBuiltInControl` because its `GENERAL.BACKGROUND_COLOR` form key
+ * round-trips through `getValues()`; the block-text base (`TextBlockBackgroundBuiltInControl`, the
+ * built-in this replaces) reports `textBlockBackgroundColor`, which our read path never sees. That
+ * borrowed base targets the block's Buy buttons, so `getTargetNodes` here is a GUARD that keeps it
+ * off the buttons — not the write path.
+ *
+ * The write is entirely ours (`getAdditionalModifications`): Stripo's built-in emits a stylesheet
+ * rule that inline styles from regeneration outrank (SD-143023), so it would silently no-op on the
+ * next edit. We write inline `background-color` + `bgcolor` on the block `<td>` instead — surviving
+ * regeneration and reaching Outlook, matching the migrator's convention.
+ */
+export declare function createBlockBackgroundColorControl(controlId: string, blockRootSelector?: string): {
+    new (): {
+        getId(): string;
+        /** The parent control renders its own generic title; restore the block-level wording. */
+        getLabels(): {
+            title: string;
+        };
+        /** Guard: redirect the borrowed button parent onto the block `<td>` so it never paints the Buy buttons. */
+        getTargetNodes(root: ImmutableHtmlNode): ImmutableHtmlNode[];
+        /**
+         * Writes the picked background onto the block as an inline style plus a `bgcolor`
+         * attribute. This is the whole mechanism, not a mirror: the parent control's own
+         * write never reaches the block element (verified at runtime). `bgcolor` is the
+         * channel Outlook honours on a `<td>`, and matches what the migrator emits.
+         */
+        getAdditionalModifications(root: ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").TemplateModifier<import("@stripoinc/ui-editor-extensions").HtmlNodeModifier, import("@stripoinc/ui-editor-extensions").CssNodeModifier> | undefined;
+        getParentControlId(): string;
+        api: import("@stripoinc/ui-editor-extensions").ControlApi;
+        getModificationDescription(): import("@stripoinc/ui-editor-extensions").ModificationDescription | undefined;
+        isVisible(_node: ImmutableHtmlNode): boolean;
+    };
+};
 /**
  * Factory function to create paddings controls for different block elements
  * When targetBlockId and containerSelector are not provided, applies directly to root

package/dist/src/library.d.ts

@@ -2,4 +2,4 @@ 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 type { StripoEventType } from './@types/events';
-export type { PositionData, DynamicContentEvent, MergeTagClickEvent, MergeTag, BaseDynamicContent, TooltipOptions, TextValueObject, L10n, } from './@types/generic';
+export type { PositionData, DynamicContentEvent, MergeTagClickEvent, MergeTag, BaseDynamicContent, DynamicContentNode, DynamicContentList, TooltipOptions, TextValueObject, L10n, } from './@types/generic';