@pushwoosh/rpc-gateway-ai-assistant 0.1.249 → 0.1.250

package/commonTypes.d.ts

@@ -1,4 +1,12 @@
 export type Duration = number;
+/** Arbitrary JSON value (google.protobuf.Value). */
+export type JsonValue = string | number | boolean | null | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+/** Arbitrary JSON object (google.protobuf.Struct). */
+export type JsonObject = {
+    [key: string]: JsonValue;
+};
 export type RpcMethod<Req, Res> = ((request: Req) => Promise<Res>) & {
     safe(request: Req): Promise<[{
         error: unknown;

package/data.js

@@ -134,6 +134,18 @@ export const data = {
             }
         }
     },
+    "pushwoosh.aibuilder.v1.DarkColorScheme": {
+        "type": "I",
+        "fields": {
+            "enabled": {
+                "type": "boolean"
+            },
+            "colors": {
+                "type": "pushwoosh.aibuilder.v1.ColorSchemeItem",
+                "mapKeyType": "string"
+            }
+        }
+    },
     "pushwoosh.aibuilder.v1.EdgeInsets": {
         "type": "I",
         "fields": {
@@ -844,6 +856,10 @@ export const data = {
             "mobilePadding": {
                 "type": "pushwoosh.aibuilder.v1.EdgeInsets",
                 "optional": true
+            },
+            "displayCondition": {
+                "type": "pushwoosh.aibuilder.v1.DisplayCondition",
+                "optional": true
             }
         },
         "oneofs": {
@@ -960,6 +976,18 @@ export const data = {
             "imagePosition": {
                 "type": "pushwoosh.aibuilder.v1.CardImagePosition",
                 "optional": true
+            },
+            "imageWrap": {
+                "type": "boolean",
+                "optional": true
+            },
+            "imageMobilePadding": {
+                "type": "pushwoosh.aibuilder.v1.EdgeInsets",
+                "optional": true
+            },
+            "sideImageRatio": {
+                "type": "number",
+                "optional": true
             }
         }
     },
@@ -996,6 +1024,22 @@ export const data = {
             "padding": {
                 "type": "pushwoosh.aibuilder.v1.EdgeInsets",
                 "optional": true
+            },
+            "imageSize": {
+                "type": "pushwoosh.aibuilder.v1.CardImageSize",
+                "optional": true
+            },
+            "imageFit": {
+                "type": "pushwoosh.aibuilder.v1.CardImageFit",
+                "optional": true
+            },
+            "imagePosition": {
+                "type": "pushwoosh.aibuilder.v1.CardImagePosition",
+                "optional": true
+            },
+            "imageRatio": {
+                "type": "number",
+                "optional": true
             }
         }
     },
@@ -1074,6 +1118,224 @@ export const data = {
             }
         }
     },
+    "pushwoosh.aibuilder.v1.DisplayConditionOp": {
+        "type": "E",
+        "values": [
+            "DISPLAY_CONDITION_OP_UNSPECIFIED",
+            "DISPLAY_CONDITION_OP_EQ",
+            "DISPLAY_CONDITION_OP_NEQ",
+            "DISPLAY_CONDITION_OP_GT",
+            "DISPLAY_CONDITION_OP_GTE",
+            "DISPLAY_CONDITION_OP_LT",
+            "DISPLAY_CONDITION_OP_LTE",
+            "DISPLAY_CONDITION_OP_CONTAINS",
+            "DISPLAY_CONDITION_OP_NOT_CONTAINS",
+            "DISPLAY_CONDITION_OP_EXISTS",
+            "DISPLAY_CONDITION_OP_NOT_EXISTS"
+        ]
+    },
+    "pushwoosh.aibuilder.v1.DisplayConditionValueType": {
+        "type": "E",
+        "values": [
+            "DISPLAY_CONDITION_VALUE_TYPE_UNSPECIFIED",
+            "DISPLAY_CONDITION_VALUE_TYPE_STRING",
+            "DISPLAY_CONDITION_VALUE_TYPE_NUMBER",
+            "DISPLAY_CONDITION_VALUE_TYPE_BOOLEAN"
+        ]
+    },
+    "pushwoosh.aibuilder.v1.DisplayConditionCombinator": {
+        "type": "E",
+        "values": [
+            "DISPLAY_CONDITION_COMBINATOR_UNSPECIFIED",
+            "DISPLAY_CONDITION_COMBINATOR_AND",
+            "DISPLAY_CONDITION_COMBINATOR_OR"
+        ]
+    },
+    "pushwoosh.aibuilder.v1.DisplayConditionUnknown": {
+        "type": "E",
+        "values": [
+            "DISPLAY_CONDITION_UNKNOWN_UNSPECIFIED",
+            "DISPLAY_CONDITION_UNKNOWN_HIDE",
+            "DISPLAY_CONDITION_UNKNOWN_SHOW"
+        ]
+    },
+    "pushwoosh.aibuilder.v1.DisplayConditionChain": {
+        "type": "E",
+        "values": [
+            "DISPLAY_CONDITION_CHAIN_UNSPECIFIED",
+            "DISPLAY_CONDITION_CHAIN_ELSIF",
+            "DISPLAY_CONDITION_CHAIN_ELSE"
+        ]
+    },
+    "pushwoosh.aibuilder.v1.DisplayConditionRule": {
+        "type": "I",
+        "fields": {
+            "name": {
+                "type": "string"
+            },
+            "op": {
+                "type": "pushwoosh.aibuilder.v1.DisplayConditionOp"
+            },
+            "value": {
+                "type": "string"
+            },
+            "valueType": {
+                "type": "pushwoosh.aibuilder.v1.DisplayConditionValueType"
+            }
+        }
+    },
+    "pushwoosh.aibuilder.v1.DisplayCondition": {
+        "type": "I",
+        "fields": {
+            "enabled": {
+                "type": "boolean"
+            },
+            "combinator": {
+                "type": "pushwoosh.aibuilder.v1.DisplayConditionCombinator"
+            },
+            "rules": {
+                "type": "pushwoosh.aibuilder.v1.DisplayConditionRule",
+                "array": true
+            },
+            "unknown": {
+                "type": "pushwoosh.aibuilder.v1.DisplayConditionUnknown"
+            },
+            "liquidExpr": {
+                "type": "string"
+            },
+            "chain": {
+                "type": "pushwoosh.aibuilder.v1.DisplayConditionChain"
+            }
+        }
+    },
+    "pushwoosh.aibuilder.v1.ProductsSource": {
+        "type": "E",
+        "values": [
+            "PRODUCTS_SOURCE_UNSPECIFIED",
+            "PRODUCTS_SOURCE_MANUAL",
+            "PRODUCTS_SOURCE_RULE",
+            "PRODUCTS_SOURCE_CART"
+        ]
+    },
+    "pushwoosh.aibuilder.v1.ProductsRuleSort": {
+        "type": "E",
+        "values": [
+            "PRODUCTS_RULE_SORT_UNSPECIFIED",
+            "PRODUCTS_RULE_SORT_NEWEST",
+            "PRODUCTS_RULE_SORT_PRICE_ASC",
+            "PRODUCTS_RULE_SORT_PRICE_DESC",
+            "PRODUCTS_RULE_SORT_TITLE"
+        ]
+    },
+    "pushwoosh.aibuilder.v1.ProductsRule": {
+        "type": "I",
+        "fields": {
+            "application": {
+                "type": "string"
+            },
+            "feedOrigin": {
+                "type": "string"
+            },
+            "category": {
+                "type": "string"
+            },
+            "sort": {
+                "type": "pushwoosh.aibuilder.v1.ProductsRuleSort"
+            },
+            "limit": {
+                "type": "number"
+            }
+        }
+    },
+    "pushwoosh.aibuilder.v1.ProductsCart": {
+        "type": "I",
+        "fields": {
+            "application": {
+                "type": "string"
+            },
+            "feedOrigin": {
+                "type": "string"
+            },
+            "limit": {
+                "type": "number"
+            }
+        }
+    },
+    "pushwoosh.aibuilder.v1.ProductItem": {
+        "type": "I",
+        "fields": {
+            "catalogId": {
+                "type": "string"
+            },
+            "image": {
+                "type": "pushwoosh.aibuilder.v1.Image",
+                "optional": true
+            },
+            "title": {
+                "type": "string"
+            },
+            "titleTranslations": {
+                "type": "string",
+                "mapKeyType": "string"
+            },
+            "description": {
+                "type": "string"
+            },
+            "descriptionTranslations": {
+                "type": "string",
+                "mapKeyType": "string"
+            },
+            "price": {
+                "type": "string"
+            },
+            "oldPrice": {
+                "type": "string"
+            },
+            "url": {
+                "type": "string"
+            }
+        }
+    },
+    "pushwoosh.aibuilder.v1.ProductsData": {
+        "type": "I",
+        "fields": {
+            "source": {
+                "type": "pushwoosh.aibuilder.v1.ProductsSource"
+            },
+            "rule": {
+                "type": "pushwoosh.aibuilder.v1.ProductsRule",
+                "optional": true
+            },
+            "cart": {
+                "type": "pushwoosh.aibuilder.v1.ProductsCart",
+                "optional": true
+            },
+            "descriptionLimit": {
+                "type": "number",
+                "optional": true
+            },
+            "products": {
+                "type": "pushwoosh.aibuilder.v1.ProductItem",
+                "array": true
+            },
+            "template": {
+                "type": "pushwoosh.aibuilder.v1.AiBuilderCard",
+                "optional": true
+            },
+            "templateStyles": {
+                "type": "pushwoosh.aibuilder.v1.BlockStyles",
+                "optional": true
+            },
+            "columns": {
+                "type": "number",
+                "optional": true
+            },
+            "gap": {
+                "type": "number",
+                "optional": true
+            }
+        }
+    },
     "pushwoosh.aibuilder.v1.AiBuilderBlock": {
         "type": "I",
         "fields": {
@@ -1108,6 +1370,14 @@ export const data = {
             },
             "parentId": {
                 "type": "string"
+            },
+            "displayCondition": {
+                "type": "pushwoosh.aibuilder.v1.DisplayCondition",
+                "optional": true
+            },
+            "products": {
+                "type": "pushwoosh.aibuilder.v1.ProductsData",
+                "optional": true
             }
         },
         "oneofs": {
@@ -1279,9 +1549,33 @@ export const data = {
             "underlineLinks": {
                 "type": "boolean",
                 "optional": true
+            },
+            "socialIconShape": {
+                "type": "pushwoosh.aibuilder.v1.SocialIconShape"
+            },
+            "socialIconVariant": {
+                "type": "pushwoosh.aibuilder.v1.SocialIconVariant"
             }
         }
     },
+    "pushwoosh.aibuilder.v1.SocialIconShape": {
+        "type": "E",
+        "values": [
+            "SOCIAL_ICON_SHAPE_UNSPECIFIED",
+            "SOCIAL_ICON_SHAPE_CIRCLE",
+            "SOCIAL_ICON_SHAPE_SQUARE",
+            "SOCIAL_ICON_SHAPE_REGULAR"
+        ]
+    },
+    "pushwoosh.aibuilder.v1.SocialIconVariant": {
+        "type": "E",
+        "values": [
+            "SOCIAL_ICON_VARIANT_UNSPECIFIED",
+            "SOCIAL_ICON_VARIANT_BLACK",
+            "SOCIAL_ICON_VARIANT_WHITE",
+            "SOCIAL_ICON_VARIANT_COLOR"
+        ]
+    },
     "pushwoosh.aibuilder.v1.EmailSettings": {
         "type": "I",
         "fields": {
@@ -1420,6 +1714,10 @@ export const data = {
             "languages": {
                 "type": "string",
                 "array": true
+            },
+            "darkColorScheme": {
+                "type": "pushwoosh.aibuilder.v1.DarkColorScheme",
+                "optional": true
             }
         }
     },
@@ -1453,6 +1751,12 @@ export const data = {
                 "method": "post",
                 "path": "/api/v1/aigen/convert-unlayer"
             },
+            "DocumentToHtml": {
+                "request": "pushwoosh.aigen.v1.AiGenDocumentToHtmlRequest",
+                "response": "pushwoosh.aigen.v1.AiGenDocumentToHtmlResponse",
+                "method": "post",
+                "path": "/api/v1/aigen/document-to-html"
+            },
             "GenerateMediaImage": {
                 "request": "pushwoosh.aigen.v1.AiGenMediaImageRequest",
                 "response": "pushwoosh.aigen.v1.AiGenMediaImageResponse",
@@ -1907,10 +2211,10 @@ export const data = {
         "type": "I",
         "fields": {
             "editorConfig": {
-                "type": "object"
+                "type": "JsonObject"
             },
             "localizationData": {
-                "type": "object"
+                "type": "JsonObject"
             },
             "language": {
                 "type": "string"
@@ -1944,6 +2248,59 @@ export const data = {
             }
         }
     },
+    "pushwoosh.aigen.v1.AiGenDocumentToHtmlRequest": {
+        "type": "I",
+        "fields": {
+            "document": {
+                "type": "pushwoosh.aibuilder.v1.AiBuilderDocument"
+            },
+            "application": {
+                "type": "string"
+            },
+            "timerBaseUrl": {
+                "type": "string"
+            },
+            "syncedBlockTags": {
+                "type": "boolean",
+                "optional": true
+            },
+            "displayConditionTags": {
+                "type": "boolean",
+                "optional": true
+            },
+            "dynamicProductTags": {
+                "type": "boolean",
+                "optional": true
+            },
+            "webVersionLabel": {
+                "type": "string"
+            }
+        }
+    },
+    "pushwoosh.aigen.v1.LocalizationLanguage": {
+        "type": "I",
+        "fields": {
+            "values": {
+                "type": "string",
+                "mapKeyType": "string"
+            }
+        }
+    },
+    "pushwoosh.aigen.v1.AiGenDocumentToHtmlResponse": {
+        "type": "I",
+        "fields": {
+            "html": {
+                "type": "string"
+            },
+            "localizationData": {
+                "type": "pushwoosh.aigen.v1.LocalizationLanguage",
+                "mapKeyType": "string"
+            },
+            "document": {
+                "type": "pushwoosh.aibuilder.v1.AiBuilderDocument"
+            }
+        }
+    },
     "pushwoosh.aigen.v1.AiGenMediaImageRequest": {
         "type": "I",
         "fields": {
@@ -2882,7 +3239,7 @@ export const data = {
                 "optional": true
             },
             "template": {
-                "type": "object"
+                "type": "JsonObject"
             },
             "categories": {
                 "type": "string",
@@ -3017,7 +3374,7 @@ export const data = {
                 "optional": true
             },
             "template": {
-                "type": "object"
+                "type": "JsonObject"
             },
             "categories": {
                 "type": "string",
@@ -3051,7 +3408,7 @@ export const data = {
                 "optional": true
             },
             "template": {
-                "type": "object"
+                "type": "JsonObject"
             },
             "updateCategories": {
                 "type": "boolean"

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@pushwoosh/rpc-gateway-ai-assistant",
-    "version": "0.1.249",
+    "version": "0.1.250",
     "description": "AI Assistant api gateway HTTP API Types and Data",
     "main": "index.js",
     "module": "index.js",

package/pushwoosh_aibuilder_v1.d.ts

@@ -178,6 +178,21 @@ export type ColorSchemeItem = {
     color: string;
     description: string;
 };
+/**
+ * Authored dark palette. Blocks store resolved hex, not slot references, so
+ * dark mode works by value: the renderer builds light-hex → dark-hex maps from
+ * the two palettes and rewrites the emitted HTML, pairing `pwd-N` class hooks
+ * with @media (prefers-color-scheme: dark) overrides.
+ *
+ * Absent is NOT the same as disabled-with-a-palette: without one the document
+ * declares `color-scheme: only light`, opting out of client recolouring
+ * entirely, because one light palette recoloured by a mail client collapses
+ * dark text onto a dark canvas.
+ */
+export type DarkColorScheme = {
+    enabled: boolean;
+    colors: Record<string, ColorSchemeItem>;
+};
 export type EdgeInsets = {
     top: number;
     right: number;
@@ -776,6 +791,11 @@ export type ContentItem = {
      * the client's automatic mobile clamp. Client-managed, hidden from the LLM.
      */
     mobilePadding?: EdgeInsets;
+    /**
+     * Per-recipient visibility of this item, compiled to Liquid on save.
+     * Client-managed: the model must never invent targeting rules.
+     */
+    displayCondition?: DisplayCondition;
     item: ContentItem_item;
 };
 export type Content = {
@@ -844,6 +864,22 @@ export type AiBuilderCard = {
      * Unset → centre (50/50). Applies to the image layouts only.
      */
     imagePosition?: CardImagePosition;
+    /**
+     * LEFT/RIGHT only: float the image so copy flows around it instead of
+     * sitting in a separate column. Unset = off, which keeps pre-wrap documents
+     * on their two-column look. Client-managed.
+     */
+    imageWrap?: boolean;
+    /**
+     * Mobile override of image.padding for the TOP/LEFT/RIGHT slots.
+     * Client-managed.
+     */
+    imageMobilePadding?: EdgeInsets;
+    /**
+     * LEFT/RIGHT crop box: image height as a percentage of the image column's
+     * width. Unset = natural height. Client-managed.
+     */
+    sideImageRatio?: number;
 };
 export type AiBuilderColumns = {
     columns: AiBuilderColumn[];
@@ -861,6 +897,18 @@ export type AiBuilderColumn = {
      * for this column when set. Client-managed; the LLM never sets it.
      */
     padding?: EdgeInsets;
+    /**
+     * Slot-image geometry, same contract as the card's: size drives the WIDTH
+     * (unset = spans the cell), an explicit height or a crop ratio fixes the
+     * box, and the fit crops into it. CLIENT even though the card's image_fit is
+     * MODEL — for columns these have always been the editor's, and widening a
+     * policy later is safe while narrowing one is not.
+     */
+    imageSize?: CardImageSize;
+    imageFit?: CardImageFit;
+    imagePosition?: CardImagePosition;
+    /** Crop box: image height as a percentage of the cell width. Unset = natural. */
+    imageRatio?: number;
 };
 /**
  * AiBuilderGroup is a structural stack container. Children live as
@@ -969,6 +1017,118 @@ export type SyncedBlockRef = {
      */
     fragmentCode: string;
 };
+export type DisplayConditionOp = 
+/** Invalid: the rule is skipped at compile, as a malformed rule is today. */
+'DISPLAY_CONDITION_OP_UNSPECIFIED' | 'DISPLAY_CONDITION_OP_EQ' | 'DISPLAY_CONDITION_OP_NEQ' | 'DISPLAY_CONDITION_OP_GT' | 'DISPLAY_CONDITION_OP_GTE' | 'DISPLAY_CONDITION_OP_LT' | 'DISPLAY_CONDITION_OP_LTE' | 'DISPLAY_CONDITION_OP_CONTAINS' | 'DISPLAY_CONDITION_OP_NOT_CONTAINS'
+/** Presence checks; `value` is ignored. */
+ | 'DISPLAY_CONDITION_OP_EXISTS' | 'DISPLAY_CONDITION_OP_NOT_EXISTS';
+export type DisplayConditionValueType = 
+/** Renders as STRING. */
+'DISPLAY_CONDITION_VALUE_TYPE_UNSPECIFIED' | 'DISPLAY_CONDITION_VALUE_TYPE_STRING' | 'DISPLAY_CONDITION_VALUE_TYPE_NUMBER' | 'DISPLAY_CONDITION_VALUE_TYPE_BOOLEAN';
+export type DisplayConditionCombinator = 
+/** Renders as AND. */
+'DISPLAY_CONDITION_COMBINATOR_UNSPECIFIED' | 'DISPLAY_CONDITION_COMBINATOR_AND' | 'DISPLAY_CONDITION_COMBINATOR_OR';
+/** What to do for a recipient missing a referenced value. UNSPECIFIED = HIDE. */
+export type DisplayConditionUnknown = 'DISPLAY_CONDITION_UNKNOWN_UNSPECIFIED' | 'DISPLAY_CONDITION_UNKNOWN_HIDE' | 'DISPLAY_CONDITION_UNKNOWN_SHOW';
+/**
+ * Branch role in an if/elsif/else chain of ADJACENT siblings; exactly one
+ * branch renders. UNSPECIFIED = a standalone {% if %}.
+ */
+export type DisplayConditionChain = 'DISPLAY_CONDITION_CHAIN_UNSPECIFIED' | 'DISPLAY_CONDITION_CHAIN_ELSIF' | 'DISPLAY_CONDITION_CHAIN_ELSE';
+export type DisplayConditionRule = {
+    /**
+     * Tag / dynamic-content variable exactly as the user typed it; the emitter
+     * strips spaces to reach the Liquid binding name.
+     */
+    name: string;
+    op: DisplayConditionOp;
+    /** Raw input, parsed per value_type at compile. Ignored for EXISTS/NOT_EXISTS. */
+    value: string;
+    valueType: DisplayConditionValueType;
+};
+export type DisplayCondition = {
+    /** False keeps the rules stored without emitting anything. */
+    enabled: boolean;
+    combinator: DisplayConditionCombinator;
+    rules: DisplayConditionRule[];
+    unknown: DisplayConditionUnknown;
+    /**
+     * Advanced mode: a raw Liquid boolean expression. Non-empty REPLACES `rules`
+     * and is emitted verbatim — never escaped, never validated server-side.
+     * "" = unset.
+     */
+    liquidExpr: string;
+    chain: DisplayConditionChain;
+};
+export type ProductsSource = 
+/** Renders as MANUAL. */
+'PRODUCTS_SOURCE_UNSPECIFIED' | 'PRODUCTS_SOURCE_MANUAL' | 'PRODUCTS_SOURCE_RULE' | 'PRODUCTS_SOURCE_CART';
+export type ProductsRuleSort = 
+/** Invalid: the rule degrades to MANUAL, as a malformed payload does today. */
+'PRODUCTS_RULE_SORT_UNSPECIFIED' | 'PRODUCTS_RULE_SORT_NEWEST' | 'PRODUCTS_RULE_SORT_PRICE_ASC' | 'PRODUCTS_RULE_SORT_PRICE_DESC' | 'PRODUCTS_RULE_SORT_TITLE';
+/**
+ * Catalog feed. A payload missing feed_origin, sort or a positive limit
+ * degrades to MANUAL rather than emitting a call to a garbage URL.
+ */
+export type ProductsRule = {
+    application: string;
+    /** Environment-resolved feed host. "" = unset → degrades to MANUAL. */
+    feedOrigin: string;
+    /** "" = unset (the query parameter is omitted). */
+    category: string;
+    sort: ProductsRuleSort;
+    /** Grid cells emitted, and the feed limit. <= 0 → degrades to MANUAL. */
+    limit: number;
+};
+/** Abandoned cart of the recipient. Same degradation contract as ProductsRule. */
+export type ProductsCart = {
+    application: string;
+    feedOrigin: string;
+    limit: number;
+};
+/**
+ * One product row. The card design lives in ProductsData.template; elements
+ * whose plain text is exactly "$title" / "$description" / "$price" /
+ * "$oldPrice" bind to these fields, as do an image src of "$image" and a
+ * button url of "$url".
+ */
+export type ProductItem = {
+    /** Account catalog id when the row was picked from the catalog. "" = unset. */
+    catalogId: string;
+    image?: Image;
+    title: string;
+    titleTranslations: Record<string, string>;
+    description: string;
+    descriptionTranslations: Record<string, string>;
+    price: string;
+    oldPrice: string;
+    url: string;
+};
+export type ProductsData = {
+    source: ProductsSource;
+    rule?: ProductsRule;
+    cart?: ProductsCart;
+    /**
+     * Rendered-description cap in characters. Unset = renderer default,
+     * explicit 0 = off.
+     */
+    descriptionLimit?: number;
+    /**
+     * Rows for MANUAL, and the baked preview rows shown for RULE / CART outside
+     * the save path.
+     */
+    products: ProductItem[];
+    /**
+     * The card rendered once per row. Absent = the block falls back to the
+     * stand-in card in the oneof.
+     */
+    template?: AiBuilderCard;
+    templateStyles?: BlockStyles;
+    /** Grid columns, clamped 1..3 by the renderer. Unset = renderer default. */
+    columns?: number;
+    /** Gap between cells in px. Unset = renderer default. */
+    gap?: number;
+};
 export type AiBuilderBlock_block_card = {
     type: 'card';
     data: AiBuilderCard;
@@ -1009,6 +1169,14 @@ export type AiBuilderBlock = {
      * structures appropriate for each channel.
      */
     parentId: string;
+    /** Per-recipient visibility of this block, compiled to Liquid on save. */
+    displayCondition?: DisplayCondition;
+    /**
+     * Products repeater. When set it OWNS the block's rendering and the oneof
+     * holds a stand-in card, so the model (and an older editor) still sees a
+     * valid block.
+     */
+    products?: ProductsData;
     block: AiBuilderBlock_block;
 };
 /**
@@ -1099,7 +1267,25 @@ export type FooterStyle = {
      * Optional so absent keeps the client default (underlined).
      */
     underlineLinks?: boolean;
+    /**
+     * Look of the social icons; both UNSPECIFIED reproduce today's defaults
+     * (circle / black), so an absent value renders as it always has.
+     */
+    socialIconShape: SocialIconShape;
+    socialIconVariant: SocialIconVariant;
 };
+/**
+ * Renderer picks a hosted icon set from these two. The value names are not
+ * cosmetic: they are the asset path segment and filename suffix
+ * (<base>/<shape>/<platform>-<shape>-<variant>.png), so an invented value is a
+ * 404, not a fallback.
+ */
+export type SocialIconShape = 
+/** Renders as CIRCLE. */
+'SOCIAL_ICON_SHAPE_UNSPECIFIED' | 'SOCIAL_ICON_SHAPE_CIRCLE' | 'SOCIAL_ICON_SHAPE_SQUARE' | 'SOCIAL_ICON_SHAPE_REGULAR';
+export type SocialIconVariant = 
+/** Renders as BLACK. */
+'SOCIAL_ICON_VARIANT_UNSPECIFIED' | 'SOCIAL_ICON_VARIANT_BLACK' | 'SOCIAL_ICON_VARIANT_WHITE' | 'SOCIAL_ICON_VARIANT_COLOR';
 /**
  * EmailSettings holds the email-only document-level fields produced by
  * the meta generator under mode=EMAIL. Populated only when the
@@ -1231,4 +1417,9 @@ export type AiBuilderDocument = {
      * language may be listed before any translation exists. Client-managed.
      */
     languages: string[];
+    /**
+     * Authored dark palette, paired with color_scheme. Absent = the document
+     * opts out of dark mode; see DarkColorScheme. Client-managed.
+     */
+    darkColorScheme?: DarkColorScheme;
 };

package/pushwoosh_aigen_v1.d.ts

@@ -1,4 +1,4 @@
-import { RpcMethod } from './commonTypes';
+import { RpcMethod, JsonObject } from './commonTypes';
 import { AiBuilderDocument as pushwoosh_aibuilder_v1_AiBuilderDocument } from './pushwoosh_aibuilder_v1';
 import { DocumentSettings as pushwoosh_aibuilder_v1_DocumentSettings } from './pushwoosh_aibuilder_v1';
 import { TextVariantStyle as pushwoosh_aibuilder_v1_TextVariantStyle } from './pushwoosh_aibuilder_v1';
@@ -6,6 +6,7 @@ import { ColorSchemeItem as pushwoosh_aibuilder_v1_ColorSchemeItem } from './pus
 import { AiBuilderBlock as pushwoosh_aibuilder_v1_AiBuilderBlock } from './pushwoosh_aibuilder_v1';
 export type AiGenService_ExtractStyle = RpcMethod<AiGenExtractStyleRequest, AiGenExtractStyleResponse>;
 export type AiGenService_ConvertUnlayer = RpcMethod<AiGenConvertUnlayerRequest, AiGenConvertUnlayerResponse>;
+export type AiGenService_DocumentToHtml = RpcMethod<AiGenDocumentToHtmlRequest, AiGenDocumentToHtmlResponse>;
 export type AiGenService_GenerateMediaImage = RpcMethod<AiGenMediaImageRequest, AiGenMediaImageResponse>;
 export type AiGenService_SearchStockPhotos = RpcMethod<AiGenStockSearchRequest, AiGenStockSearchResponse>;
 export type AiGenService_ImportStockPhoto = RpcMethod<AiGenStockImportRequest, AiGenStockImportResponse>;
@@ -77,6 +78,22 @@ export interface AiGenService {
      * document validation. Unary; the result is document-sized.
      */
     ConvertUnlayer: AiGenService_ConvertUnlayer;
+    /**
+     * DocumentToHtml renders an AiBuilderDocument to the finished email HTML
+     * deterministically — no LLM, byte-for-byte the same output the editor
+     * produces on save. It is the counterpart of RenderHtml: use RenderHtml
+     * when you want the model to reimagine the layout ("style it like this
+     * design"), use this when you want THE html of this document.
+     *
+     * The response carries the rendered html, the per-language localization
+     * map, and the document that produced them, so a caller can write the
+     * whole smartcards EmailContent without a second round-trip and without
+     * being able to desync the three.
+     *
+     * EMAIL only for now. Unary: the render is fast and the result is one
+     * document.
+     */
+    DocumentToHtml: AiGenService_DocumentToHtml;
     /**
      * GenerateMediaImage generates ONE image from a prompt and stores it in
      * the application's media library — the media-gallery "Generate" tab.
@@ -593,7 +610,7 @@ export type AiGenConvertUnlayerRequest = {
      * The Unlayer design JSON (EmailContent.Unlayer.editor_config): the
      * object carrying body.rows[].columns[].contents[]. Required.
      */
-    editorConfig: object;
+    editorConfig: JsonObject;
     /**
      * Unlayer localization placeholders. Accepts either the per-language
      * map {"<lang>": {"<path>": "<value>"}} stored alongside the design in
@@ -602,7 +619,7 @@ export type AiGenConvertUnlayerRequest = {
      * {{path|type|fallback}} tokens during conversion. Optional — without
      * it tokens resolve to their inline fallbacks.
      */
-    localizationData: object;
+    localizationData: JsonObject;
     /**
      * Language key to resolve localized values with when localization_data
      * is per-language. Empty → "default", falling back to the first
@@ -653,6 +670,59 @@ export type AiGenConvertUnlayerResponse = {
      */
     warnings: string[];
 };
+export type AiGenDocumentToHtmlRequest = {
+    /** The document to render. Required; must carry at least one page. */
+    document: pushwoosh_aibuilder_v1_AiBuilderDocument;
+    /**
+     * Application id. Required: it scopes the request and it is how the
+     * renderer resolves the products feed credential, which is deliberately
+     * not a document field (see the note on ProductsRule).
+     */
+    application: string;
+    /**
+     * Base URL for the countdown-GIF service baked into timer items. Empty =
+     * the server default. Note it lands in SENT EMAIL, fetched by recipients'
+     * mail clients, so it is never a localhost route.
+     */
+    timerBaseUrl: string;
+    /**
+     * Save-path emission, all three ON when unset — that is what the editor
+     * does on save, and a plain proto-false default would quietly produce
+     * preview HTML (baked product rows, no Liquid) that looks right and sends
+     * wrong. Set false only to render a preview.
+     */
+    syncedBlockTags?: boolean;
+    displayConditionTags?: boolean;
+    dynamicProductTags?: boolean;
+    /**
+     * Anchor text of the "view in browser" strip. Empty = the built-in label
+     * for the document's default language.
+     */
+    webVersionLabel: string;
+};
+/**
+ * A per-language {key: value} map. proto forbids a map whose value is a map,
+ * so the inner one is wrapped.
+ */
+export type LocalizationLanguage = {
+    values: Record<string, string>;
+};
+export type AiGenDocumentToHtmlResponse = {
+    /** The complete email document, ready to store as EmailContent.Smartcards.html. */
+    html: string;
+    /**
+     * Per-language values for the {{key|html|}} tokens in `html`, keyed by
+     * language ("default" plus each translated language). Empty for a
+     * single-language document, which carries no tokens.
+     */
+    localizationData: Record<string, LocalizationLanguage>;
+    /**
+     * The document these two were rendered from. Returned so the caller stores
+     * the same triple the editor does — html, localization_data and content —
+     * without being able to desync them.
+     */
+    document: pushwoosh_aibuilder_v1_AiBuilderDocument;
+};
 export type AiGenMediaImageRequest = {
     application: string;
     /** Image generation prompt; required, capped server-side. */

package/pushwoosh_templates_v1.d.ts

@@ -1,4 +1,4 @@
-import { RpcMethod } from './commonTypes';
+import { RpcMethod, JsonObject } from './commonTypes';
 export type TemplatesService_List = RpcMethod<ListRequest, ListResponse>;
 export type TemplatesService_Get = RpcMethod<GetRequest, GetResponse>;
 export type TemplatesService_Create = RpcMethod<CreateRequest, CreateResponse>;
@@ -46,7 +46,7 @@ export type Template = {
      * The template document itself: any valid JSON object, opaque to this
      * service.
      */
-    template: object;
+    template: JsonObject;
     /** Category tags attached to this template. Order is not significant. */
     categories: string[];
     /** Creation timestamp. */
@@ -113,7 +113,7 @@ export type CreateRequest = {
     /** Optional free-form description. */
     description?: string;
     /** The template document: any valid JSON object. */
-    template: object;
+    template: JsonObject;
     /** Category tags to attach. May be empty. */
     categories: string[];
 };
@@ -134,7 +134,7 @@ export type UpdateRequest = {
      * New template document (any valid JSON object). Only applied when set
      * (message presence).
      */
-    template: object;
+    template: JsonObject;
     /**
      * Controls how categories is applied (PATCH semantics):
      * - true  → replace categories with the provided list