@denarolabs/email-template 1.0.5 → 1.0.6

package/dist/index.d.ts

@@ -1,8 +1,425 @@
-export { AIEmailEditor, default } from "./components/ai-email-editor/AIEmailEditor";
-export type { AIEmailEditorProps, AIEmailModelOption, StoredEmailRecord, AIEmailEditorMode, AIEmailEditorErrorSource, AIEmailEditorErrorContext, AIEmailEditorSuccessSource, AIEmailEditorSuccessContext, SendTestEmailInput, } from "./types";
-export { AiEmailResponseSchema, type AiEmailResponse, } from "./schemas/aiEmailResponse";
-export { AiEmailChatMessageSchema, AiEmailHtmlSnapshotSchema, AiEmailImageSchema, AiEmailSessionSchema, type AiEmailChatMessage, type AiEmailHtmlSnapshot, type AiEmailImage, type AiEmailSession, } from "./schemas/aiEmail";
-export { buildAiEmailStreamRequestSchema, buildResponseFormatDirective, } from "./lib/ai-stream-contract";
-export { getMergeTagError, extractMergeTags, applyMergeTags } from "./lib/merge-tag-validation";
-export { buildDefaultSystemPrompt } from "./lib/build-default-system-prompt";
-export { DEFAULT_EDIT_SUGGESTIONS, DEFAULT_NEW_TEMPLATE_SUGGESTIONS, resolveInitialSuggestions, detectPhase, extractStreamParts, formatPlan, parseStructuredStream, phaseLabel, } from "./components/ai-email-editor/stream";
+import * as react from 'react';
+import { z } from 'zod';
+import { DeepPartial } from 'ai';
+
+declare const AiEmailImageSchema: z.ZodObject<{
+    id: z.ZodString;
+    url: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    url: string;
+    name?: string | undefined;
+}, {
+    id: string;
+    url: string;
+    name?: string | undefined;
+}>;
+declare const AiEmailChatMessageSchema: z.ZodObject<{
+    id: z.ZodString;
+    role: z.ZodEnum<["user", "assistant"]>;
+    content: z.ZodString;
+    contextImages: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        url: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        url: string;
+        name?: string | undefined;
+    }, {
+        id: string;
+        url: string;
+        name?: string | undefined;
+    }>, "many">>;
+    appliedHtml: z.ZodOptional<z.ZodBoolean>;
+    snapshotId: z.ZodOptional<z.ZodString>;
+    selectedBlockIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    phase: z.ZodOptional<z.ZodEnum<["thinking", "planning", "applying"]>>;
+    timestamp: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    role: "user" | "assistant";
+    content: string;
+    timestamp: number;
+    contextImages?: {
+        id: string;
+        url: string;
+        name?: string | undefined;
+    }[] | undefined;
+    appliedHtml?: boolean | undefined;
+    snapshotId?: string | undefined;
+    selectedBlockIds?: string[] | undefined;
+    phase?: "thinking" | "planning" | "applying" | undefined;
+}, {
+    id: string;
+    role: "user" | "assistant";
+    content: string;
+    timestamp: number;
+    contextImages?: {
+        id: string;
+        url: string;
+        name?: string | undefined;
+    }[] | undefined;
+    appliedHtml?: boolean | undefined;
+    snapshotId?: string | undefined;
+    selectedBlockIds?: string[] | undefined;
+    phase?: "thinking" | "planning" | "applying" | undefined;
+}>;
+declare const AiEmailHtmlSnapshotSchema: z.ZodObject<{
+    id: z.ZodString;
+    html: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    timestamp: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    html: string;
+    id: string;
+    timestamp: number;
+    label?: string | undefined;
+}, {
+    html: string;
+    id: string;
+    timestamp: number;
+    label?: string | undefined;
+}>;
+declare const AiEmailSessionSchema: z.ZodObject<{
+    messages: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        role: z.ZodEnum<["user", "assistant"]>;
+        content: z.ZodString;
+        contextImages: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            url: z.ZodString;
+            name: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            url: string;
+            name?: string | undefined;
+        }, {
+            id: string;
+            url: string;
+            name?: string | undefined;
+        }>, "many">>;
+        appliedHtml: z.ZodOptional<z.ZodBoolean>;
+        snapshotId: z.ZodOptional<z.ZodString>;
+        selectedBlockIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        phase: z.ZodOptional<z.ZodEnum<["thinking", "planning", "applying"]>>;
+        timestamp: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        role: "user" | "assistant";
+        content: string;
+        timestamp: number;
+        contextImages?: {
+            id: string;
+            url: string;
+            name?: string | undefined;
+        }[] | undefined;
+        appliedHtml?: boolean | undefined;
+        snapshotId?: string | undefined;
+        selectedBlockIds?: string[] | undefined;
+        phase?: "thinking" | "planning" | "applying" | undefined;
+    }, {
+        id: string;
+        role: "user" | "assistant";
+        content: string;
+        timestamp: number;
+        contextImages?: {
+            id: string;
+            url: string;
+            name?: string | undefined;
+        }[] | undefined;
+        appliedHtml?: boolean | undefined;
+        snapshotId?: string | undefined;
+        selectedBlockIds?: string[] | undefined;
+        phase?: "thinking" | "planning" | "applying" | undefined;
+    }>, "many">>;
+    snapshots: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        html: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        timestamp: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        html: string;
+        id: string;
+        timestamp: number;
+        label?: string | undefined;
+    }, {
+        html: string;
+        id: string;
+        timestamp: number;
+        label?: string | undefined;
+    }>, "many">>;
+    snapshotIndex: z.ZodDefault<z.ZodNumber>;
+    contextImages: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        url: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        url: string;
+        name?: string | undefined;
+    }, {
+        id: string;
+        url: string;
+        name?: string | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    contextImages: {
+        id: string;
+        url: string;
+        name?: string | undefined;
+    }[];
+    messages: {
+        id: string;
+        role: "user" | "assistant";
+        content: string;
+        timestamp: number;
+        contextImages?: {
+            id: string;
+            url: string;
+            name?: string | undefined;
+        }[] | undefined;
+        appliedHtml?: boolean | undefined;
+        snapshotId?: string | undefined;
+        selectedBlockIds?: string[] | undefined;
+        phase?: "thinking" | "planning" | "applying" | undefined;
+    }[];
+    snapshots: {
+        html: string;
+        id: string;
+        timestamp: number;
+        label?: string | undefined;
+    }[];
+    snapshotIndex: number;
+}, {
+    contextImages?: {
+        id: string;
+        url: string;
+        name?: string | undefined;
+    }[] | undefined;
+    messages?: {
+        id: string;
+        role: "user" | "assistant";
+        content: string;
+        timestamp: number;
+        contextImages?: {
+            id: string;
+            url: string;
+            name?: string | undefined;
+        }[] | undefined;
+        appliedHtml?: boolean | undefined;
+        snapshotId?: string | undefined;
+        selectedBlockIds?: string[] | undefined;
+        phase?: "thinking" | "planning" | "applying" | undefined;
+    }[] | undefined;
+    snapshots?: {
+        html: string;
+        id: string;
+        timestamp: number;
+        label?: string | undefined;
+    }[] | undefined;
+    snapshotIndex?: number | undefined;
+}>;
+type AiEmailImage = z.infer<typeof AiEmailImageSchema>;
+type AiEmailChatMessage = z.infer<typeof AiEmailChatMessageSchema>;
+type AiEmailHtmlSnapshot = z.infer<typeof AiEmailHtmlSnapshotSchema>;
+type AiEmailSession = z.infer<typeof AiEmailSessionSchema>;
+
+type AIEmailEditorMode = "email" | "landing";
+type AIEmailEditorErrorSource = "stream" | "upload" | "save" | "image" | "html" | "send";
+interface AIEmailEditorErrorContext {
+    source: AIEmailEditorErrorSource;
+}
+type AIEmailEditorSuccessSource = "upload" | "save" | "image" | "html" | "undo" | "revert" | "send";
+interface AIEmailEditorSuccessContext {
+    source: AIEmailEditorSuccessSource;
+    message: string;
+}
+interface SendTestEmailInput {
+    to: string;
+    subject: string;
+    html: string;
+    mergeTagValues: Record<string, string>;
+}
+interface AIEmailModelOption {
+    id: string;
+    label: string;
+    hint?: string;
+}
+interface StoredEmailRecord {
+    id: string;
+    name: string;
+    html: string;
+    createdAt: number;
+    updatedAt: number;
+    aiSession?: AiEmailSession;
+}
+interface AIEmailEditorProps {
+    name: string;
+    savedTemplate: StoredEmailRecord | null;
+    onSave: (record: StoredEmailRecord) => Promise<void> | void;
+    streamRoute: string;
+    mergeTags: string[];
+    defaultMergeTagValues?: Record<string, string>;
+    mode?: AIEmailEditorMode;
+    systemPrompt?: string;
+    onUploadImage: (file: File | Blob) => Promise<{
+        url: string;
+    }>;
+    onDeleteImage: (url: string) => Promise<void>;
+    onSendTestEmail?: (input: SendTestEmailInput) => Promise<void>;
+    defaultTestEmailRecipient?: string;
+    defaultTestEmailSubject?: string;
+    onError: (error: Error, context: AIEmailEditorErrorContext) => void;
+    onSuccess?: (context: AIEmailEditorSuccessContext) => void;
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    brandLabel?: string;
+    brandIconUrl?: string;
+    productLabel?: string;
+    models?: readonly AIEmailModelOption[];
+    defaultModel?: string;
+    initialSuggestions?: readonly string[];
+}
+
+declare function AIEmailEditor({ name, savedTemplate, onSave, streamRoute, mergeTags, defaultMergeTagValues, mode, systemPrompt, onUploadImage, onDeleteImage, onSendTestEmail, defaultTestEmailRecipient, defaultTestEmailSubject, onError, onSuccess, open, onOpenChange, brandLabel, brandIconUrl, productLabel, models, defaultModel, initialSuggestions, }: AIEmailEditorProps): react.JSX.Element | null;
+
+declare const AiEmailResponseSchema: z.ZodObject<{
+    plan: z.ZodArray<z.ZodString, "many">;
+    suggestions: z.ZodArray<z.ZodString, "many">;
+    html: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    html: string;
+    plan: string[];
+    suggestions: string[];
+}, {
+    html: string;
+    plan: string[];
+    suggestions: string[];
+}>;
+type AiEmailResponse = z.infer<typeof AiEmailResponseSchema>;
+
+declare function buildAiEmailStreamRequestSchema(): z.ZodObject<{
+    messages: z.ZodArray<z.ZodObject<{
+        role: z.ZodEnum<["user", "assistant"]>;
+        content: z.ZodString;
+        contextImages: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            label: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            label: string;
+            url: string;
+        }, {
+            label: string;
+            url: string;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        role: "user" | "assistant";
+        content: string;
+        contextImages?: {
+            label: string;
+            url: string;
+        }[] | undefined;
+    }, {
+        role: "user" | "assistant";
+        content: string;
+        contextImages?: {
+            label: string;
+            url: string;
+        }[] | undefined;
+    }>, "many">;
+    systemPrompt: z.ZodString;
+    model: z.ZodString;
+    sessionContextImages: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        label: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        url: string;
+    }, {
+        label: string;
+        url: string;
+    }>, "many">>;
+    previewScreenshot: z.ZodOptional<z.ZodString>;
+    currentHtml: z.ZodOptional<z.ZodString>;
+    selectedBlocks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        html: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        html: string;
+        id: string;
+    }, {
+        html: string;
+        id: string;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    messages: {
+        role: "user" | "assistant";
+        content: string;
+        contextImages?: {
+            label: string;
+            url: string;
+        }[] | undefined;
+    }[];
+    systemPrompt: string;
+    sessionContextImages: {
+        label: string;
+        url: string;
+    }[];
+    model: string;
+    previewScreenshot?: string | undefined;
+    currentHtml?: string | undefined;
+    selectedBlocks?: {
+        html: string;
+        id: string;
+    }[] | undefined;
+}, {
+    messages: {
+        role: "user" | "assistant";
+        content: string;
+        contextImages?: {
+            label: string;
+            url: string;
+        }[] | undefined;
+    }[];
+    systemPrompt: string;
+    model: string;
+    sessionContextImages?: {
+        label: string;
+        url: string;
+    }[] | undefined;
+    previewScreenshot?: string | undefined;
+    currentHtml?: string | undefined;
+    selectedBlocks?: {
+        html: string;
+        id: string;
+    }[] | undefined;
+}>;
+declare function buildResponseFormatDirective(): string;
+
+declare function extractMergeTags(content: string): string[];
+declare function applyMergeTags(html: string, values: Record<string, string>): string;
+declare function getMergeTagError(content: string, allowedTags: Iterable<string>): string | null;
+
+declare function buildDefaultSystemPrompt(mergeTags: string[], mode?: AIEmailEditorMode): string;
+
+type PartialAiEmailResponse = DeepPartial<AiEmailResponse>;
+declare function phaseLabel(phase: "thinking" | "planning" | "applying"): string;
+declare function formatPlan(plan: (string | undefined)[] | undefined): string;
+declare function extractStreamParts(partial: PartialAiEmailResponse | undefined): {
+    narration: string;
+    suggestions: string[];
+    html: string;
+};
+declare function parseStructuredStream(accumulatedText: string): Promise<{
+    html?: string | undefined;
+    plan?: (string | undefined)[] | undefined;
+    suggestions?: (string | undefined)[] | undefined;
+} | undefined>;
+declare function detectPhase(partial: PartialAiEmailResponse | undefined): "thinking" | "planning" | "applying";
+declare const DEFAULT_NEW_TEMPLATE_SUGGESTIONS: string[];
+declare const DEFAULT_EDIT_SUGGESTIONS: string[];
+declare function resolveInitialSuggestions(suggestions?: readonly string[]): readonly string[];
+
+export { AIEmailEditor, type AIEmailEditorErrorContext, type AIEmailEditorErrorSource, type AIEmailEditorMode, type AIEmailEditorProps, type AIEmailEditorSuccessContext, type AIEmailEditorSuccessSource, type AIEmailModelOption, type AiEmailChatMessage, AiEmailChatMessageSchema, type AiEmailHtmlSnapshot, AiEmailHtmlSnapshotSchema, type AiEmailImage, AiEmailImageSchema, type AiEmailResponse, AiEmailResponseSchema, type AiEmailSession, AiEmailSessionSchema, DEFAULT_EDIT_SUGGESTIONS, DEFAULT_NEW_TEMPLATE_SUGGESTIONS, type SendTestEmailInput, type StoredEmailRecord, applyMergeTags, buildAiEmailStreamRequestSchema, buildDefaultSystemPrompt, buildResponseFormatDirective, AIEmailEditor as default, detectPhase, extractMergeTags, extractStreamParts, formatPlan, getMergeTagError, parseStructuredStream, phaseLabel, resolveInitialSuggestions };