easy-email-pro-core 1.57.13 → 1.58.0

package/lib/typings/__tests__/ai.test.d.ts

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

package/lib/typings/__tests__/validation.test.d.ts

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

package/lib/typings/ai/editor-context.d.ts

@@ -0,0 +1,18 @@
+import type { AiDecisionChoice, AiEditorContextPayload, EasyEmailImageResultPayload } from "./types";
+import { type AiToolTarget } from "./tools";
+export declare function selectedTargetFromContext(editorContext: AiEditorContextPayload | undefined): AiToolTarget | null;
+export declare function canReplaceTargetImage(target: AiToolTarget | null, selectedType: string | null): boolean;
+export declare function imageReplacementTarget(activeRun: Pick<{
+    selectedTarget: AiToolTarget | null;
+    selectedType: string | null;
+}, "selectedTarget" | "selectedType">, resultTarget?: AiToolTarget | null): AiToolTarget | null;
+export declare function isHighConfidenceImageTarget(target: AiToolTarget | null | undefined, confidence?: EasyEmailImageResultPayload["confidence"]): boolean;
+export declare function targetsSameBlock(a: AiToolTarget | null, b: AiToolTarget | null): boolean;
+export declare function canAutoReplaceImageTarget(activeRun: Pick<{
+    selectedTarget: AiToolTarget | null;
+    selectedType: string | null;
+}, "selectedTarget" | "selectedType">, target: AiToolTarget | null | undefined, confidence?: EasyEmailImageResultPayload["confidence"]): boolean;
+export declare function imageChoiceDescription(image: NonNullable<AiEditorContextPayload["images"]>[number]): string | undefined;
+export declare function imageDecisionChoices(payload: EasyEmailImageResultPayload, editorImages: AiEditorContextPayload["images"], imageLabel?: string): AiDecisionChoice[];
+export declare function imageTargetAttributeKey(editorImages: AiEditorContextPayload["images"], target: AiToolTarget | null | undefined): string;
+export declare function choiceImageAttributeKey(choice: AiDecisionChoice): string;

package/lib/typings/ai/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./tools";
+export * from "./types";
+export * from "./protocol";
+export * from "./editor-context";

package/lib/typings/ai/protocol.d.ts

@@ -0,0 +1,7 @@
+import type { AiAgentEvent, AiChatResult } from "./types";
+export declare const AI_AGENT_FEATURE = "AI_AGENT";
+export declare function assertAiAgentFeatureEnabled(): void;
+export declare function readEasyEmailAiError(response: Response): Promise<string>;
+export declare function parseEasyEmailSseMessage(rawMessage: string): AiAgentEvent | null;
+export declare function parseEasyEmailAiStream(stream: ReadableStream<Uint8Array>, onEvent?: (event: AiAgentEvent) => void): Promise<AiAgentEvent[]>;
+export declare function resolveAiChatResult(result: AiChatResult | undefined, onEvent?: (event: AiAgentEvent) => void): Promise<AiAgentEvent[]>;

package/lib/typings/ai/tools.d.ts

@@ -0,0 +1,108 @@
+export type AiToolTarget = {
+    selected: true;
+} | {
+    id: string;
+} | {
+    uid: string;
+} | {
+    type: string;
+    index?: number;
+};
+export type AiToolCall = {
+    name: "update_text";
+    target: AiToolTarget;
+    text: string;
+} | {
+    name: "update_attribute";
+    target: AiToolTarget;
+    key: string;
+    value: unknown;
+} | {
+    name: "update_mobile_attribute";
+    target: AiToolTarget;
+    key: string;
+    value: unknown;
+} | {
+    name: "update_attributes";
+    target: AiToolTarget;
+    attributes: Record<string, unknown>;
+    scope?: "desktop" | "mobile";
+} | {
+    name: "update_data";
+    target: AiToolTarget;
+    key: string;
+    value: unknown;
+} | {
+    name: "replace_children";
+    target: AiToolTarget;
+    children: unknown[];
+} | {
+    name: "set_visibility";
+    target: AiToolTarget;
+    desktop: boolean;
+    mobile: boolean;
+} | {
+    name: "replace_block";
+    target: AiToolTarget;
+    block: unknown;
+} | {
+    name: "update_link";
+    target: AiToolTarget;
+    href: string;
+    blank?: boolean;
+    title?: string;
+} | {
+    name: "move_up" | "move_down" | "duplicate" | "delete_node";
+    target: AiToolTarget;
+} | {
+    name: "add_block_after";
+    target: AiToolTarget;
+    block: unknown;
+} | {
+    name: "add_block_before";
+    target: AiToolTarget;
+    block: unknown;
+} | {
+    name: "select_node";
+    target: AiToolTarget;
+} | {
+    name: "apply_template";
+    template: unknown;
+};
+export type AiAppliedChange = {
+    id: string;
+    label: string;
+    description: string;
+    target: AiToolTarget;
+    path?: number[];
+};
+export type EasyEmailToolCallsPayload = {
+    summary?: string | null;
+    toolCalls: AiToolCall[];
+    fallbackTemplate?: unknown | null;
+};
+export type EasyEmailToolCallsPayloadInput = Partial<EasyEmailToolCallsPayload> & {
+    summary?: string | null;
+    toolCalls?: AiToolCall[];
+    fallbackTemplate?: unknown | null;
+    tool_calls?: AiToolCall[];
+    fallback_template?: unknown | null;
+};
+export type AiToolApplyResult = {
+    applied: number;
+    skipped: number;
+    errors: string[];
+    changes?: AiAppliedChange[];
+};
+export declare const missingInitialSelectionTarget: {
+    id: string;
+};
+export declare function isSelectedTarget(target: AiToolTarget): boolean;
+export declare function normalizeToolCallsPayload(payload: EasyEmailToolCallsPayloadInput): {
+    toolCalls: AiToolCall[];
+    fallbackTemplate: unknown;
+    summary?: string | null;
+    tool_calls?: AiToolCall[];
+    fallback_template?: unknown | null;
+};
+export declare function freezeSelectedTargets(toolCalls: AiToolCall[], selectedTarget: AiToolTarget | null): AiToolCall[];

package/lib/typings/ai/types.d.ts

@@ -0,0 +1,179 @@
+import type { AiToolTarget, EasyEmailToolCallsPayload } from "./tools";
+export type AiAgentStatus = "RUNNING" | "FINISHED" | "ERROR";
+export type AiAgentImageAttachment = {
+    id: string;
+    name: string;
+    mimeType: string;
+    dataUrl?: string;
+    url?: string;
+    size?: number;
+};
+export type AiDecisionChoice = {
+    id: string;
+    label: string;
+    description?: string;
+    value?: unknown;
+    target?: AiToolTarget;
+    thumbnail?: string;
+    prompt?: string;
+};
+export type AiDecisionRequestPayload = {
+    id: string;
+    kind: "style_direction" | "target_block" | "missing_detail";
+    title: string;
+    message: string;
+    choices: AiDecisionChoice[];
+    allowCustom?: boolean;
+    required?: boolean;
+    image?: AiAgentImageAttachment;
+};
+export type AiDecisionResponsePayload = {
+    decisionId: string;
+    choiceId?: string;
+    label?: string;
+    value?: unknown;
+    customText?: string;
+};
+export type AiEditorContextPayload = {
+    selected?: {
+        id?: string;
+        uid?: string;
+        type?: string;
+        path?: number[];
+        title?: string;
+        attributes?: Record<string, unknown>;
+        data?: Record<string, unknown>;
+        layout?: {
+            width?: number;
+            height?: number;
+        };
+        descendants?: Array<{
+            id?: string;
+            uid?: string;
+            type?: string;
+            path?: number[];
+            title?: string;
+            text?: string;
+        }>;
+    } | null;
+    images?: Array<{
+        id?: string;
+        uid?: string;
+        type?: string;
+        path?: number[];
+        title?: string;
+        src?: string;
+        source?: "image" | "background";
+        attributeKey?: string;
+        width?: number;
+        height?: number;
+        index?: number;
+    }>;
+};
+export type EasyEmailResultPayload = {
+    valid: boolean;
+    errors: string[];
+    template: unknown | null;
+    commitSha?: string | null;
+    branchName?: string | null;
+    summary?: string | null;
+};
+export type EasyEmailAnswerPayload = {
+    answer: string;
+};
+export type EasyEmailImageResultPayload = {
+    summary?: string | null;
+    images: AiAgentImageAttachment[];
+    target?: AiToolTarget | null;
+    confidence?: "high" | "low" | "ambiguous" | null;
+    candidates?: AiDecisionChoice[];
+    intent?: "replace" | "insert" | "attach" | null;
+    revisedPrompt?: string | null;
+    model?: string | null;
+    size?: string | null;
+};
+export type AiTokenUsage = {
+    model?: string;
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+    cachedInputTokens?: number;
+    reasoningTokens?: number;
+};
+export type AiWebSource = {
+    url: string;
+    title?: string;
+};
+export type AiAgentEvent = {
+    seq: number;
+    type: "status";
+    payload: {
+        status: AiAgentStatus;
+        exitCode?: number | null;
+    };
+    createdAt: string;
+} | {
+    seq: number;
+    type: "input";
+    payload: {
+        text: string;
+    };
+    createdAt: string;
+} | {
+    seq: number;
+    type: "error";
+    payload: {
+        message: string;
+    };
+    createdAt: string;
+} | {
+    seq: number;
+    type: "easy_email_result";
+    payload: EasyEmailResultPayload;
+    createdAt: string;
+} | {
+    seq: number;
+    type: "easy_email_answer";
+    payload: EasyEmailAnswerPayload;
+    createdAt: string;
+} | {
+    seq: number;
+    type: "easy_email_tool_calls";
+    payload: EasyEmailToolCallsPayload;
+    createdAt: string;
+} | {
+    seq: number;
+    type: "image_result";
+    payload: EasyEmailImageResultPayload;
+    createdAt: string;
+} | {
+    seq: number;
+    type: "decision_request";
+    payload: AiDecisionRequestPayload;
+    createdAt: string;
+} | {
+    seq: number;
+    type: "usage";
+    payload: AiTokenUsage;
+    createdAt: string;
+} | {
+    seq: number;
+    type: "sources";
+    payload: {
+        sources: AiWebSource[];
+    };
+    createdAt: string;
+};
+export type RespondEasyEmailBody = {
+    message: string;
+    template?: unknown;
+    history?: unknown;
+    images?: AiAgentImageAttachment[];
+    editorContext?: AiEditorContextPayload;
+    decisionResponse?: AiDecisionResponsePayload;
+};
+export type AiChatRequest = RespondEasyEmailBody & {
+    signal?: AbortSignal;
+};
+export type AiChatResult = AiAgentEvent[] | ReadableStream<Uint8Array> | Response;
+export type AiChatHandler = (request: AiChatRequest) => Promise<AiChatResult>;

package/lib/typings/index.d.ts

@@ -3,6 +3,7 @@ export * from "./hooks";
 export * from "./utils";
 export * from "./blocks";
 export * from "./constants";
+export * from "./ai";
 export * from "./utils";
 export * as components from "./components";
 export * from "./typings";

package/lib/typings/validation/index.d.ts

@@ -0,0 +1,17 @@
+export type ValidationErrorCode = "invalid_element" | "invalid_text" | "missing_field" | "unknown_type" | "invalid_parent" | "duplicate_id" | "duplicate_uid";
+export type ValidationError = {
+    path: string;
+    code: ValidationErrorCode;
+    message: string;
+};
+export type ValidationResult = {
+    valid: boolean;
+    errors: ValidationError[];
+};
+export declare function validateEasyEmailElement(value: unknown, context?: {
+    path?: string;
+    parentType?: string;
+}): ValidationResult;
+export declare function validateEasyEmailTemplate(value: unknown): ValidationResult;
+export declare function normalizeEasyEmailTemplateShape<T>(value: T): T;
+export declare function repairEasyEmailTemplateNesting<T>(value: T): T;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "easy-email-pro-core",
-  "version": "1.57.13",
+  "version": "1.58.0",
   "description": "",
   "files": [
     "lib",