@pushwoosh/rpc-gateway-ai-assistant 0.1.187 → 0.1.189

package/commonTypes.d.ts

@@ -1,12 +1,4 @@
 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

@@ -164,6 +164,20 @@ export const data = {
             }
         }
     },
+    "pushwoosh.aibuilder.v1.BackgroundGradient": {
+        "type": "I",
+        "fields": {
+            "from": {
+                "type": "string"
+            },
+            "to": {
+                "type": "string"
+            },
+            "angle": {
+                "type": "number"
+            }
+        }
+    },
     "pushwoosh.aibuilder.v1.ColumnsStyles": {
         "type": "I",
         "fields": {
@@ -237,6 +251,14 @@ export const data = {
             "fontFamily": {
                 "type": "string",
                 "optional": true
+            },
+            "backgroundImage": {
+                "type": "string",
+                "optional": true
+            },
+            "backgroundGradient": {
+                "type": "pushwoosh.aibuilder.v1.BackgroundGradient",
+                "optional": true
             }
         }
     },
@@ -390,6 +412,13 @@ export const data = {
             },
             "list": {
                 "type": "pushwoosh.aibuilder.v1.List"
+            },
+            "image": {
+                "type": "pushwoosh.aibuilder.v1.Image"
+            },
+            "padding": {
+                "type": "pushwoosh.aibuilder.v1.EdgeInsets",
+                "optional": true
             }
         },
         "oneofs": {
@@ -397,7 +426,8 @@ export const data = {
                 "oneof": [
                     "text",
                     "buttonGroup",
-                    "list"
+                    "list",
+                    "image"
                 ]
             }
         }
@@ -412,14 +442,6 @@ export const data = {
             "textPrompt": {
                 "type": "string",
                 "optional": true
-            },
-            "margin": {
-                "type": "pushwoosh.aibuilder.v1.EdgeInsets",
-                "optional": true
-            },
-            "padding": {
-                "type": "pushwoosh.aibuilder.v1.EdgeInsets",
-                "optional": true
             }
         }
     },
@@ -449,6 +471,13 @@ export const data = {
             },
             "origHeight": {
                 "type": "number"
+            },
+            "padding": {
+                "type": "pushwoosh.aibuilder.v1.EdgeInsets",
+                "optional": true
+            },
+            "align": {
+                "type": "pushwoosh.aibuilder.v1.TextAlign"
             }
         }
     },
@@ -519,6 +548,10 @@ export const data = {
             "width": {
                 "type": "string",
                 "optional": true
+            },
+            "padding": {
+                "type": "pushwoosh.aibuilder.v1.EdgeInsets",
+                "optional": true
             }
         }
     },
@@ -867,6 +900,12 @@ export const data = {
                 "response": "pushwoosh.aigen.v1.AiGenExtractStyleResponse",
                 "method": "post",
                 "path": "/api/v1/aigen/extract-style"
+            },
+            "ConvertUnlayer": {
+                "request": "pushwoosh.aigen.v1.AiGenConvertUnlayerRequest",
+                "response": "pushwoosh.aigen.v1.AiGenConvertUnlayerResponse",
+                "method": "post",
+                "path": "/api/v1/aigen/convert-unlayer"
             }
         }
     },
@@ -1293,6 +1332,41 @@ export const data = {
             }
         }
     },
+    "pushwoosh.aigen.v1.AiGenConvertUnlayerRequest": {
+        "type": "I",
+        "fields": {
+            "editorConfig": {
+                "type": "object"
+            },
+            "localizationData": {
+                "type": "object"
+            },
+            "language": {
+                "type": "string"
+            },
+            "application": {
+                "type": "string"
+            },
+            "templateName": {
+                "type": "string"
+            },
+            "subject": {
+                "type": "string"
+            }
+        }
+    },
+    "pushwoosh.aigen.v1.AiGenConvertUnlayerResponse": {
+        "type": "I",
+        "fields": {
+            "document": {
+                "type": "pushwoosh.aibuilder.v1.AiBuilderDocument"
+            },
+            "warnings": {
+                "type": "string",
+                "array": true
+            }
+        }
+    },
     "pushwoosh.accounts.assistant.v1.Role": {
         "type": "E",
         "values": [
@@ -1873,7 +1947,7 @@ export const data = {
                 "optional": true
             },
             "template": {
-                "type": "JsonObject"
+                "type": "object"
             },
             "categories": {
                 "type": "string",
@@ -2008,7 +2082,7 @@ export const data = {
                 "optional": true
             },
             "template": {
-                "type": "JsonObject"
+                "type": "object"
             },
             "categories": {
                 "type": "string",
@@ -2042,7 +2116,7 @@ export const data = {
                 "optional": true
             },
             "template": {
-                "type": "JsonObject"
+                "type": "object"
             },
             "updateCategories": {
                 "type": "boolean"

package/package.json

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

package/pushwoosh_aibuilder_v1.d.ts

@@ -206,6 +206,14 @@ export type BlockStyles = {
     /** Explicit 0 is distinct from unset and preserved. */
     borderRadius?: number;
 };
+/** Two-stop CSS linear gradient: `linear-gradient(<angle>deg, from, to)`. */
+export type BackgroundGradient = {
+    /** #RRGGBB */
+    from: string;
+    to: string;
+    /** CSS angle in degrees (180 = top→bottom). */
+    angle: number;
+};
 export type ColumnsStyles = {
     /** Padding applied to each column in the columns block. */
     columnPadding?: EdgeInsets;
@@ -258,6 +266,12 @@ export type DocumentSettings = {
      * button → variant → document → renderer default.
      */
     fontFamily?: string;
+    /**
+     * Document-wide backdrop behind all blocks (email body background).
+     * Same semantics as the BlockStyles pair. Client-managed.
+     */
+    backgroundImage?: string;
+    backgroundGradient?: BackgroundGradient;
 };
 export type TextBlock = {
     variant: string;
@@ -362,23 +376,22 @@ export type ContentItem_item_list = {
     type: 'list';
     data: List;
 };
-export type ContentItem_item = ContentItem_item_text | ContentItem_item_buttonGroup | ContentItem_item_list;
+export type ContentItem_item_image = {
+    type: 'image';
+    data: Image;
+};
+export type ContentItem_item = ContentItem_item_text | ContentItem_item_buttonGroup | ContentItem_item_list | ContentItem_item_image;
 export type ContentItem = {
+    /**
+     * Container padding of the item. Unset = client's default inter-item gap;
+     * set (even zeros) = used verbatim. Client-managed, hidden from the LLM.
+     */
+    padding?: EdgeInsets;
     item: ContentItem_item;
 };
 export type Content = {
     items: ContentItem[];
     textPrompt?: string;
-    /**
-     * Client-managed margin around the content block. Preserved by the backend
-     * across Update but never exposed to the LLM.
-     */
-    margin?: EdgeInsets;
-    /**
-     * Client-managed padding inside the content block. Preserved by the backend
-     * across Update but never exposed to the LLM.
-     */
-    padding?: EdgeInsets;
 };
 export type Image = {
     prompt: string;
@@ -389,6 +402,19 @@ export type Image = {
     mediaUuid: string;
     origWidth: number;
     origHeight: number;
+    /**
+     * Container padding of the image within its slot (card TOP image, column
+     * image). Same semantics as ContentItem.padding: client-managed, written
+     * by importers / the editor, never exposed to the LLM, round-tripped
+     * verbatim. Layouts without a discrete image box (BACKGROUND, LEFT/RIGHT
+     * fills) may ignore it.
+     */
+    padding?: EdgeInsets;
+    /**
+     * Horizontal alignment when the image is a content item; slots ignore it.
+     * UNSPECIFIED renders as center (Unlayer's image default).
+     */
+    align: TextAlign;
 };
 export type AiBuilderCard = {
     layout: CardLayout;
@@ -427,6 +453,12 @@ export type AiBuilderColumn = {
     image?: Image;
     content: Content;
     width?: string;
+    /**
+     * Container padding of this column, wrapping BOTH the image slot and the
+     * content (Unlayer column padding). Overrides ColumnsStyles.column_padding
+     * for this column when set. Client-managed; the LLM never sets it.
+     */
+    padding?: EdgeInsets;
 };
 /**
  * AiBuilderGroup is a structural stack container. Children live as

package/pushwoosh_aigen_v1.d.ts

@@ -5,6 +5,7 @@ import { TextVariantStyle as pushwoosh_aibuilder_v1_TextVariantStyle } from './p
 import { ColorSchemeItem as pushwoosh_aibuilder_v1_ColorSchemeItem } from './pushwoosh_aibuilder_v1';
 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>;
 /**
  * AiGenService unifies document create / edit / per-block regeneration and
  * targeted block insertion into a single streaming RPC. Dispatch rules:
@@ -58,6 +59,20 @@ export interface AiGenService {
      * design screenshot. Unary; the result is small.
      */
     ExtractStyle: AiGenService_ExtractStyle;
+    /**
+     * ConvertUnlayer deterministically converts an Unlayer email-template
+     * design (the `editorConfig` JSON stored in EmailContent.Unlayer) into
+     * an AiBuilderDocument, so templates built in the Unlayer block editor
+     * can be opened in the AI builder. No LLM involved — the mapping is
+     * pure and repeatable, and the same call can back a bulk migration.
+     *
+     * Unlayer widgets with no AiBuilderDocument equivalent (countdown
+     * timers, custom tools, raw HTML) become Placeholder blocks the AI can
+     * materialise on a follow-up edit; every such lossy step is reported
+     * in `warnings`. The returned document always passes the EMAIL-mode
+     * document validation. Unary; the result is document-sized.
+     */
+    ConvertUnlayer: AiGenService_ConvertUnlayer;
 }
 export type AiGenBlockTypeHint = 'AI_GEN_BLOCK_TYPE_HINT_UNSPECIFIED' | 'AI_GEN_BLOCK_TYPE_HINT_CARD' | 'AI_GEN_BLOCK_TYPE_HINT_COLUMNS'
 /** Top-level free-form Content block. Allowed in WEB_POPUP only. */
@@ -535,3 +550,54 @@ export type AiGenExtractStyleResponse = {
      */
     typographyNotes: string;
 };
+export type AiGenConvertUnlayerRequest = {
+    /**
+     * The Unlayer design JSON (EmailContent.Unlayer.editor_config): the
+     * object carrying body.rows[].columns[].contents[]. Required.
+     */
+    editorConfig: object;
+    /**
+     * Unlayer localization placeholders. Accepts either the per-language
+     * map {"<lang>": {"<path>": "<value>"}} stored alongside the design in
+     * EmailContent.Unlayer.localization_data, or an already-flat
+     * {"<path>": "<value>"} map. Values are substituted into the design's
+     * {{path|type|fallback}} tokens during conversion. Optional — without
+     * it tokens resolve to their inline fallbacks.
+     */
+    localizationData: object;
+    /**
+     * Language key to resolve localized values with when localization_data
+     * is per-language. Empty → "default", falling back to the first
+     * language present.
+     */
+    language: string;
+    /**
+     * Application code. Required by the server's application-scoping
+     * middleware (same as the other AiGen RPCs); the converter itself does
+     * not use it.
+     */
+    application: string;
+    /**
+     * Optional document metadata carried into the result verbatim: the
+     * template name (Meta.template_name) and the email subject
+     * (EmailSettings.subject). Both live outside editor_config on the
+     * stored EmailTemplate, so the caller supplies them.
+     */
+    templateName: string;
+    subject: string;
+};
+export type AiGenConvertUnlayerResponse = {
+    /**
+     * The converted document. Complete and EMAIL-mode valid; block ids are
+     * deterministic ("u<row>-<n>") so repeated conversions of the same
+     * design yield the same document.
+     */
+    document: pushwoosh_aibuilder_v1_AiBuilderDocument;
+    /**
+     * Human-readable notes about content that could not be mapped 1:1 —
+     * unsupported widgets replaced with placeholders, dropped image links,
+     * per-column backgrounds, and similar. Order follows document order.
+     * Empty when the conversion was lossless.
+     */
+    warnings: string[];
+};

package/pushwoosh_templates_v1.d.ts

@@ -1,4 +1,4 @@
-import { RpcMethod, JsonObject } from './commonTypes';
+import { RpcMethod } 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: JsonObject;
+    template: object;
     /** 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: JsonObject;
+    template: object;
     /** 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: JsonObject;
+    template: object;
     /**
      * Controls how categories is applied (PATCH semantics):
      * - true  → replace categories with the provided list