@tracearr/shared 2.2.4-beta.3 → 2.3.0-beta.1

package/dist/newsletters.d.ts

@@ -0,0 +1,1367 @@
+import { z } from 'zod';
+import { type EmailRichTextDoc } from './emailRichText.js';
+/** 12 is the largest cap at which the heaviest digest the assembler can emit stays clear of Gmail's 102 KB clip, proven by the size gate in packages/emails. */
+export declare const NEWSLETTER_SECTION_MAX = 12;
+export declare const NEWSLETTER_MOST_WATCHED_MAX = 10;
+export declare const NEWSLETTER_SEASONS_PER_SHOW_MAX = 8;
+export declare const NEWSLETTER_WINDOW_MAX_DAYS = 31;
+export declare const NEWSLETTER_EXTRA_ADDRESSES_MAX = 200;
+export declare const NEWSLETTER_EXCLUDED_USERS_MAX = 200;
+export declare const NEWSLETTER_SENDER_NAME_MAX = 100;
+export declare const NEWSLETTER_SEND_TRIGGERS: readonly ['schedule', 'manual', 'test'];
+export type NewsletterSendTrigger = (typeof NEWSLETTER_SEND_TRIGGERS)[number];
+export declare const NEWSLETTER_SEND_OUTCOMES: readonly ['rendering', 'sending', 'sent', 'partial', 'failed', 'skipped_empty'];
+export type NewsletterSendOutcome = (typeof NEWSLETTER_SEND_OUTCOMES)[number];
+export declare const NEWSLETTER_RECIPIENT_STATUSES: readonly ['queued', 'sent', 'failed', 'suppressed', 'unknown'];
+export type NewsletterRecipientStatus = (typeof NEWSLETTER_RECIPIENT_STATUSES)[number];
+export declare const NEWSLETTER_IMAGE_MODES: readonly ['auto', 'hosted', 'inline', 'none'];
+export type NewsletterImageMode = (typeof NEWSLETTER_IMAGE_MODES)[number];
+export declare const EMAIL_SUPPRESSION_REASONS: readonly ['unsubscribed', 'manual'];
+export type EmailSuppressionReason = (typeof EMAIL_SUPPRESSION_REASONS)[number];
+export declare const DEFAULT_NEWSLETTER_SUBJECT = "What's new on {{server_name}} ({{end_date}})";
+export declare const cronExpressionSchema: z.ZodString;
+export declare const newsletterScheduleSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"daily">;
+    time: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"weekly">;
+    dayOfWeek: z.ZodNumber;
+    time: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"monthly">;
+    dayOfMonth: z.ZodNumber;
+    time: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"cron">;
+    expression: z.ZodString;
+}, z.core.$strict>], "kind">;
+export type NewsletterSchedule = z.infer<typeof newsletterScheduleSchema>;
+export declare const newsletterWindowSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"since_last_send">;
+    fallbackDays: z.ZodNumber;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"fixed">;
+    days: z.ZodNumber;
+}, z.core.$strict>], "kind">;
+export type NewsletterWindow = z.infer<typeof newsletterWindowSchema>;
+export declare const newsletterSectionsSchema: z.ZodObject<{
+    movies: z.ZodObject<{
+        enabled: z.ZodBoolean;
+        max: z.ZodNumber;
+    }, z.core.$strict>;
+    shows: z.ZodObject<{
+        enabled: z.ZodBoolean;
+        max: z.ZodNumber;
+        maxSeasonsPerShow: z.ZodNumber;
+    }, z.core.$strict>;
+    music: z.ZodObject<{
+        enabled: z.ZodBoolean;
+        max: z.ZodNumber;
+    }, z.core.$strict>;
+    mostWatched: z.ZodObject<{
+        enabled: z.ZodBoolean;
+        max: z.ZodNumber;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type NewsletterSections = z.infer<typeof newsletterSectionsSchema>;
+export declare const DEFAULT_NEWSLETTER_SECTIONS: NewsletterSections;
+export declare const NEWSLETTER_SCOPE_LIBRARIES_MAX = 200;
+/** A library id is only unique with its server: Plex section ids start at 1 on every server. */
+export declare const newsletterScopeLibrarySchema: z.ZodObject<{
+    serverId: z.ZodUUID;
+    libraryId: z.ZodString;
+}, z.core.$strict>;
+export type NewsletterScopeLibrary = z.infer<typeof newsletterScopeLibrarySchema>;
+export declare const newsletterScopeSchema: z.ZodObject<{
+    serverIds: z.ZodDefault<z.ZodArray<z.ZodUUID>>;
+    libraries: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        serverId: z.ZodUUID;
+        libraryId: z.ZodString;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type NewsletterScope = z.infer<typeof newsletterScopeSchema>;
+export declare const newsletterRecipientsSchema: z.ZodObject<{
+    members: z.ZodDefault<z.ZodBoolean>;
+    extraAddresses: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        address: z.ZodPipe<z.ZodEmail, z.ZodTransform<string, string>>;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    excludeUserIds: z.ZodDefault<z.ZodArray<z.ZodUUID>>;
+}, z.core.$strict>;
+export type NewsletterRecipients = z.infer<typeof newsletterRecipientsSchema>;
+export declare const newsletterLinksSchema: z.ZodObject<{
+    tracearr: z.ZodBoolean;
+}, z.core.$strict>;
+export type NewsletterLinks = z.infer<typeof newsletterLinksSchema>;
+export declare const DEFAULT_NEWSLETTER_LINKS: NewsletterLinks;
+export declare const createNewsletterSchema: z.ZodObject<{
+    name: z.ZodString;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    destinationId: z.ZodDefault<z.ZodNullable<z.ZodUUID>>;
+    schedule: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"daily">;
+        time: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"weekly">;
+        dayOfWeek: z.ZodNumber;
+        time: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"monthly">;
+        dayOfMonth: z.ZodNumber;
+        time: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"cron">;
+        expression: z.ZodString;
+    }, z.core.$strict>], "kind">;
+    timezone: z.ZodString;
+    window: z.ZodDefault<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"since_last_send">;
+        fallbackDays: z.ZodNumber;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"fixed">;
+        days: z.ZodNumber;
+    }, z.core.$strict>], "kind">>;
+    scope: z.ZodDefault<z.ZodObject<{
+        serverIds: z.ZodDefault<z.ZodArray<z.ZodUUID>>;
+        libraries: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            serverId: z.ZodUUID;
+            libraryId: z.ZodString;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+    sections: z.ZodDefault<z.ZodObject<{
+        movies: z.ZodObject<{
+            enabled: z.ZodBoolean;
+            max: z.ZodNumber;
+        }, z.core.$strict>;
+        shows: z.ZodObject<{
+            enabled: z.ZodBoolean;
+            max: z.ZodNumber;
+            maxSeasonsPerShow: z.ZodNumber;
+        }, z.core.$strict>;
+        music: z.ZodObject<{
+            enabled: z.ZodBoolean;
+            max: z.ZodNumber;
+        }, z.core.$strict>;
+        mostWatched: z.ZodObject<{
+            enabled: z.ZodBoolean;
+            max: z.ZodNumber;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
+    subject: z.ZodDefault<z.ZodString>;
+    senderName: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    intro: z.ZodDefault<z.ZodPipe<z.ZodNullable<z.ZodObject<{
+        type: z.ZodLiteral<"doc">;
+        content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"paragraph">;
+            content: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"text">;
+                text: z.ZodString;
+                marks: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    type: z.ZodLiteral<"bold">;
+                }, z.core.$strict>, z.ZodObject<{
+                    type: z.ZodLiteral<"italic">;
+                }, z.core.$strict>, z.ZodObject<{
+                    type: z.ZodLiteral<"link">;
+                    attrs: z.ZodObject<{
+                        href: z.ZodPipe<z.ZodString, z.ZodURL>;
+                    }, z.core.$strict>;
+                }, z.core.$strict>], "type">>>;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"hardBreak">;
+            }, z.core.$strict>], "type">>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"bulletList">;
+            content: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"listItem">;
+                content: z.ZodArray<z.ZodObject<{
+                    type: z.ZodLiteral<"paragraph">;
+                    content: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        type: z.ZodLiteral<"text">;
+                        text: z.ZodString;
+                        marks: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                            type: z.ZodLiteral<"bold">;
+                        }, z.core.$strict>, z.ZodObject<{
+                            type: z.ZodLiteral<"italic">;
+                        }, z.core.$strict>, z.ZodObject<{
+                            type: z.ZodLiteral<"link">;
+                            attrs: z.ZodObject<{
+                                href: z.ZodPipe<z.ZodString, z.ZodURL>;
+                            }, z.core.$strict>;
+                        }, z.core.$strict>], "type">>>;
+                    }, z.core.$strict>, z.ZodObject<{
+                        type: z.ZodLiteral<"hardBreak">;
+                    }, z.core.$strict>], "type">>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>], "type">>;
+    }, z.core.$strict>>, z.ZodTransform<{
+        type: "doc";
+        content: ({
+            type: "paragraph";
+            content?: ({
+                type: "text";
+                text: string;
+                marks?: ({
+                    type: "bold";
+                } | {
+                    type: "italic";
+                } | {
+                    type: "link";
+                    attrs: {
+                        href: string;
+                    };
+                })[] | undefined;
+            } | {
+                type: "hardBreak";
+            })[] | undefined;
+        } | {
+            type: "bulletList";
+            content: {
+                type: "listItem";
+                content: {
+                    type: "paragraph";
+                    content?: ({
+                        type: "text";
+                        text: string;
+                        marks?: ({
+                            type: "bold";
+                        } | {
+                            type: "italic";
+                        } | {
+                            type: "link";
+                            attrs: {
+                                href: string;
+                            };
+                        })[] | undefined;
+                    } | {
+                        type: "hardBreak";
+                    })[] | undefined;
+                }[];
+            }[];
+        })[];
+    } | null, {
+        type: "doc";
+        content: ({
+            type: "paragraph";
+            content?: ({
+                type: "text";
+                text: string;
+                marks?: ({
+                    type: "bold";
+                } | {
+                    type: "italic";
+                } | {
+                    type: "link";
+                    attrs: {
+                        href: string;
+                    };
+                })[] | undefined;
+            } | {
+                type: "hardBreak";
+            })[] | undefined;
+        } | {
+            type: "bulletList";
+            content: {
+                type: "listItem";
+                content: {
+                    type: "paragraph";
+                    content?: ({
+                        type: "text";
+                        text: string;
+                        marks?: ({
+                            type: "bold";
+                        } | {
+                            type: "italic";
+                        } | {
+                            type: "link";
+                            attrs: {
+                                href: string;
+                            };
+                        })[] | undefined;
+                    } | {
+                        type: "hardBreak";
+                    })[] | undefined;
+                }[];
+            }[];
+        })[];
+    } | null>>>;
+    outro: z.ZodDefault<z.ZodPipe<z.ZodNullable<z.ZodObject<{
+        type: z.ZodLiteral<"doc">;
+        content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"paragraph">;
+            content: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"text">;
+                text: z.ZodString;
+                marks: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    type: z.ZodLiteral<"bold">;
+                }, z.core.$strict>, z.ZodObject<{
+                    type: z.ZodLiteral<"italic">;
+                }, z.core.$strict>, z.ZodObject<{
+                    type: z.ZodLiteral<"link">;
+                    attrs: z.ZodObject<{
+                        href: z.ZodPipe<z.ZodString, z.ZodURL>;
+                    }, z.core.$strict>;
+                }, z.core.$strict>], "type">>>;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"hardBreak">;
+            }, z.core.$strict>], "type">>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"bulletList">;
+            content: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"listItem">;
+                content: z.ZodArray<z.ZodObject<{
+                    type: z.ZodLiteral<"paragraph">;
+                    content: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        type: z.ZodLiteral<"text">;
+                        text: z.ZodString;
+                        marks: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                            type: z.ZodLiteral<"bold">;
+                        }, z.core.$strict>, z.ZodObject<{
+                            type: z.ZodLiteral<"italic">;
+                        }, z.core.$strict>, z.ZodObject<{
+                            type: z.ZodLiteral<"link">;
+                            attrs: z.ZodObject<{
+                                href: z.ZodPipe<z.ZodString, z.ZodURL>;
+                            }, z.core.$strict>;
+                        }, z.core.$strict>], "type">>>;
+                    }, z.core.$strict>, z.ZodObject<{
+                        type: z.ZodLiteral<"hardBreak">;
+                    }, z.core.$strict>], "type">>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>], "type">>;
+    }, z.core.$strict>>, z.ZodTransform<{
+        type: "doc";
+        content: ({
+            type: "paragraph";
+            content?: ({
+                type: "text";
+                text: string;
+                marks?: ({
+                    type: "bold";
+                } | {
+                    type: "italic";
+                } | {
+                    type: "link";
+                    attrs: {
+                        href: string;
+                    };
+                })[] | undefined;
+            } | {
+                type: "hardBreak";
+            })[] | undefined;
+        } | {
+            type: "bulletList";
+            content: {
+                type: "listItem";
+                content: {
+                    type: "paragraph";
+                    content?: ({
+                        type: "text";
+                        text: string;
+                        marks?: ({
+                            type: "bold";
+                        } | {
+                            type: "italic";
+                        } | {
+                            type: "link";
+                            attrs: {
+                                href: string;
+                            };
+                        })[] | undefined;
+                    } | {
+                        type: "hardBreak";
+                    })[] | undefined;
+                }[];
+            }[];
+        })[];
+    } | null, {
+        type: "doc";
+        content: ({
+            type: "paragraph";
+            content?: ({
+                type: "text";
+                text: string;
+                marks?: ({
+                    type: "bold";
+                } | {
+                    type: "italic";
+                } | {
+                    type: "link";
+                    attrs: {
+                        href: string;
+                    };
+                })[] | undefined;
+            } | {
+                type: "hardBreak";
+            })[] | undefined;
+        } | {
+            type: "bulletList";
+            content: {
+                type: "listItem";
+                content: {
+                    type: "paragraph";
+                    content?: ({
+                        type: "text";
+                        text: string;
+                        marks?: ({
+                            type: "bold";
+                        } | {
+                            type: "italic";
+                        } | {
+                            type: "link";
+                            attrs: {
+                                href: string;
+                            };
+                        })[] | undefined;
+                    } | {
+                        type: "hardBreak";
+                    })[] | undefined;
+                }[];
+            }[];
+        })[];
+    } | null>>>;
+    recipients: z.ZodDefault<z.ZodObject<{
+        members: z.ZodDefault<z.ZodBoolean>;
+        extraAddresses: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            address: z.ZodPipe<z.ZodEmail, z.ZodTransform<string, string>>;
+            name: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        excludeUserIds: z.ZodDefault<z.ZodArray<z.ZodUUID>>;
+    }, z.core.$strict>>;
+    imageMode: z.ZodDefault<z.ZodEnum<{
+        auto: "auto";
+        hosted: "hosted";
+        inline: "inline";
+        none: "none";
+    }>>;
+    skipWhenEmpty: z.ZodDefault<z.ZodBoolean>;
+    links: z.ZodDefault<z.ZodObject<{
+        tracearr: z.ZodBoolean;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type CreateNewsletterInput = z.infer<typeof createNewsletterSchema>;
+/** A PATCH body: absent keys stay absent instead of resetting to the create defaults. */
+export declare const updateNewsletterSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    destinationId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+    schedule: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"daily">;
+        time: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"weekly">;
+        dayOfWeek: z.ZodNumber;
+        time: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"monthly">;
+        dayOfMonth: z.ZodNumber;
+        time: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"cron">;
+        expression: z.ZodString;
+    }, z.core.$strict>], "kind">>;
+    timezone: z.ZodOptional<z.ZodString>;
+    window: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"since_last_send">;
+        fallbackDays: z.ZodNumber;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"fixed">;
+        days: z.ZodNumber;
+    }, z.core.$strict>], "kind">>;
+    scope: z.ZodOptional<z.ZodObject<{
+        serverIds: z.ZodDefault<z.ZodArray<z.ZodUUID>>;
+        libraries: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            serverId: z.ZodUUID;
+            libraryId: z.ZodString;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+    sections: z.ZodOptional<z.ZodObject<{
+        movies: z.ZodObject<{
+            enabled: z.ZodBoolean;
+            max: z.ZodNumber;
+        }, z.core.$strict>;
+        shows: z.ZodObject<{
+            enabled: z.ZodBoolean;
+            max: z.ZodNumber;
+            maxSeasonsPerShow: z.ZodNumber;
+        }, z.core.$strict>;
+        music: z.ZodObject<{
+            enabled: z.ZodBoolean;
+            max: z.ZodNumber;
+        }, z.core.$strict>;
+        mostWatched: z.ZodObject<{
+            enabled: z.ZodBoolean;
+            max: z.ZodNumber;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
+    subject: z.ZodOptional<z.ZodString>;
+    senderName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    intro: z.ZodOptional<z.ZodPipe<z.ZodNullable<z.ZodObject<{
+        type: z.ZodLiteral<"doc">;
+        content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"paragraph">;
+            content: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"text">;
+                text: z.ZodString;
+                marks: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    type: z.ZodLiteral<"bold">;
+                }, z.core.$strict>, z.ZodObject<{
+                    type: z.ZodLiteral<"italic">;
+                }, z.core.$strict>, z.ZodObject<{
+                    type: z.ZodLiteral<"link">;
+                    attrs: z.ZodObject<{
+                        href: z.ZodPipe<z.ZodString, z.ZodURL>;
+                    }, z.core.$strict>;
+                }, z.core.$strict>], "type">>>;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"hardBreak">;
+            }, z.core.$strict>], "type">>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"bulletList">;
+            content: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"listItem">;
+                content: z.ZodArray<z.ZodObject<{
+                    type: z.ZodLiteral<"paragraph">;
+                    content: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        type: z.ZodLiteral<"text">;
+                        text: z.ZodString;
+                        marks: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                            type: z.ZodLiteral<"bold">;
+                        }, z.core.$strict>, z.ZodObject<{
+                            type: z.ZodLiteral<"italic">;
+                        }, z.core.$strict>, z.ZodObject<{
+                            type: z.ZodLiteral<"link">;
+                            attrs: z.ZodObject<{
+                                href: z.ZodPipe<z.ZodString, z.ZodURL>;
+                            }, z.core.$strict>;
+                        }, z.core.$strict>], "type">>>;
+                    }, z.core.$strict>, z.ZodObject<{
+                        type: z.ZodLiteral<"hardBreak">;
+                    }, z.core.$strict>], "type">>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>], "type">>;
+    }, z.core.$strict>>, z.ZodTransform<{
+        type: "doc";
+        content: ({
+            type: "paragraph";
+            content?: ({
+                type: "text";
+                text: string;
+                marks?: ({
+                    type: "bold";
+                } | {
+                    type: "italic";
+                } | {
+                    type: "link";
+                    attrs: {
+                        href: string;
+                    };
+                })[] | undefined;
+            } | {
+                type: "hardBreak";
+            })[] | undefined;
+        } | {
+            type: "bulletList";
+            content: {
+                type: "listItem";
+                content: {
+                    type: "paragraph";
+                    content?: ({
+                        type: "text";
+                        text: string;
+                        marks?: ({
+                            type: "bold";
+                        } | {
+                            type: "italic";
+                        } | {
+                            type: "link";
+                            attrs: {
+                                href: string;
+                            };
+                        })[] | undefined;
+                    } | {
+                        type: "hardBreak";
+                    })[] | undefined;
+                }[];
+            }[];
+        })[];
+    } | null, {
+        type: "doc";
+        content: ({
+            type: "paragraph";
+            content?: ({
+                type: "text";
+                text: string;
+                marks?: ({
+                    type: "bold";
+                } | {
+                    type: "italic";
+                } | {
+                    type: "link";
+                    attrs: {
+                        href: string;
+                    };
+                })[] | undefined;
+            } | {
+                type: "hardBreak";
+            })[] | undefined;
+        } | {
+            type: "bulletList";
+            content: {
+                type: "listItem";
+                content: {
+                    type: "paragraph";
+                    content?: ({
+                        type: "text";
+                        text: string;
+                        marks?: ({
+                            type: "bold";
+                        } | {
+                            type: "italic";
+                        } | {
+                            type: "link";
+                            attrs: {
+                                href: string;
+                            };
+                        })[] | undefined;
+                    } | {
+                        type: "hardBreak";
+                    })[] | undefined;
+                }[];
+            }[];
+        })[];
+    } | null>>>;
+    outro: z.ZodOptional<z.ZodPipe<z.ZodNullable<z.ZodObject<{
+        type: z.ZodLiteral<"doc">;
+        content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"paragraph">;
+            content: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"text">;
+                text: z.ZodString;
+                marks: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    type: z.ZodLiteral<"bold">;
+                }, z.core.$strict>, z.ZodObject<{
+                    type: z.ZodLiteral<"italic">;
+                }, z.core.$strict>, z.ZodObject<{
+                    type: z.ZodLiteral<"link">;
+                    attrs: z.ZodObject<{
+                        href: z.ZodPipe<z.ZodString, z.ZodURL>;
+                    }, z.core.$strict>;
+                }, z.core.$strict>], "type">>>;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"hardBreak">;
+            }, z.core.$strict>], "type">>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"bulletList">;
+            content: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"listItem">;
+                content: z.ZodArray<z.ZodObject<{
+                    type: z.ZodLiteral<"paragraph">;
+                    content: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        type: z.ZodLiteral<"text">;
+                        text: z.ZodString;
+                        marks: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                            type: z.ZodLiteral<"bold">;
+                        }, z.core.$strict>, z.ZodObject<{
+                            type: z.ZodLiteral<"italic">;
+                        }, z.core.$strict>, z.ZodObject<{
+                            type: z.ZodLiteral<"link">;
+                            attrs: z.ZodObject<{
+                                href: z.ZodPipe<z.ZodString, z.ZodURL>;
+                            }, z.core.$strict>;
+                        }, z.core.$strict>], "type">>>;
+                    }, z.core.$strict>, z.ZodObject<{
+                        type: z.ZodLiteral<"hardBreak">;
+                    }, z.core.$strict>], "type">>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>], "type">>;
+    }, z.core.$strict>>, z.ZodTransform<{
+        type: "doc";
+        content: ({
+            type: "paragraph";
+            content?: ({
+                type: "text";
+                text: string;
+                marks?: ({
+                    type: "bold";
+                } | {
+                    type: "italic";
+                } | {
+                    type: "link";
+                    attrs: {
+                        href: string;
+                    };
+                })[] | undefined;
+            } | {
+                type: "hardBreak";
+            })[] | undefined;
+        } | {
+            type: "bulletList";
+            content: {
+                type: "listItem";
+                content: {
+                    type: "paragraph";
+                    content?: ({
+                        type: "text";
+                        text: string;
+                        marks?: ({
+                            type: "bold";
+                        } | {
+                            type: "italic";
+                        } | {
+                            type: "link";
+                            attrs: {
+                                href: string;
+                            };
+                        })[] | undefined;
+                    } | {
+                        type: "hardBreak";
+                    })[] | undefined;
+                }[];
+            }[];
+        })[];
+    } | null, {
+        type: "doc";
+        content: ({
+            type: "paragraph";
+            content?: ({
+                type: "text";
+                text: string;
+                marks?: ({
+                    type: "bold";
+                } | {
+                    type: "italic";
+                } | {
+                    type: "link";
+                    attrs: {
+                        href: string;
+                    };
+                })[] | undefined;
+            } | {
+                type: "hardBreak";
+            })[] | undefined;
+        } | {
+            type: "bulletList";
+            content: {
+                type: "listItem";
+                content: {
+                    type: "paragraph";
+                    content?: ({
+                        type: "text";
+                        text: string;
+                        marks?: ({
+                            type: "bold";
+                        } | {
+                            type: "italic";
+                        } | {
+                            type: "link";
+                            attrs: {
+                                href: string;
+                            };
+                        })[] | undefined;
+                    } | {
+                        type: "hardBreak";
+                    })[] | undefined;
+                }[];
+            }[];
+        })[];
+    } | null>>>;
+    recipients: z.ZodOptional<z.ZodObject<{
+        members: z.ZodDefault<z.ZodBoolean>;
+        extraAddresses: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            address: z.ZodPipe<z.ZodEmail, z.ZodTransform<string, string>>;
+            name: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        excludeUserIds: z.ZodDefault<z.ZodArray<z.ZodUUID>>;
+    }, z.core.$strict>>;
+    imageMode: z.ZodOptional<z.ZodEnum<{
+        auto: "auto";
+        hosted: "hosted";
+        inline: "inline";
+        none: "none";
+    }>>;
+    skipWhenEmpty: z.ZodOptional<z.ZodBoolean>;
+    links: z.ZodOptional<z.ZodObject<{
+        tracearr: z.ZodBoolean;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type UpdateNewsletterInput = z.infer<typeof updateNewsletterSchema>;
+/** The set of a newsletter's servers a person belongs to, as one string: the ids deduped, sorted and joined by a comma. */
+export declare function variantKey(serverIds: readonly string[]): string;
+/** The scoped servers a member has an account on, in the scope's order; every scoped server for null, an extra address that belongs to no server. */
+export declare function variantServerIds(memberServerIds: readonly string[] | null, scopedServerIds: readonly string[]): string[];
+/** A digest that covers several servers has no natural sender name, so the editor asks for one before the Tracearr fallback could fire. */
+export declare function needsSenderName(senderName: string | null, scopedServerCount: number): boolean;
+/** The shape variantKey() produces; anything else is refused before a send looks the variant up. */
+export declare const variantKeySchema: z.ZodString;
+export declare const newsletterTestSendSchema: z.ZodObject<{
+    address: z.ZodPipe<z.ZodEmail, z.ZodTransform<string, string>>;
+    variantKey: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/** POST /newsletters/preview: the form as the create route would receive it, plus the saved row's id when editing so the window starts at its watermark. */
+export declare const newsletterPreviewDraftSchema: z.ZodObject<{
+    newsletterId: z.ZodOptional<z.ZodUUID>;
+    newsletter: z.ZodObject<{
+        name: z.ZodString;
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        destinationId: z.ZodDefault<z.ZodNullable<z.ZodUUID>>;
+        schedule: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"daily">;
+            time: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"weekly">;
+            dayOfWeek: z.ZodNumber;
+            time: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"monthly">;
+            dayOfMonth: z.ZodNumber;
+            time: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"cron">;
+            expression: z.ZodString;
+        }, z.core.$strict>], "kind">;
+        timezone: z.ZodString;
+        window: z.ZodDefault<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"since_last_send">;
+            fallbackDays: z.ZodNumber;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"fixed">;
+            days: z.ZodNumber;
+        }, z.core.$strict>], "kind">>;
+        scope: z.ZodDefault<z.ZodObject<{
+            serverIds: z.ZodDefault<z.ZodArray<z.ZodUUID>>;
+            libraries: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                serverId: z.ZodUUID;
+                libraryId: z.ZodString;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
+        sections: z.ZodDefault<z.ZodObject<{
+            movies: z.ZodObject<{
+                enabled: z.ZodBoolean;
+                max: z.ZodNumber;
+            }, z.core.$strict>;
+            shows: z.ZodObject<{
+                enabled: z.ZodBoolean;
+                max: z.ZodNumber;
+                maxSeasonsPerShow: z.ZodNumber;
+            }, z.core.$strict>;
+            music: z.ZodObject<{
+                enabled: z.ZodBoolean;
+                max: z.ZodNumber;
+            }, z.core.$strict>;
+            mostWatched: z.ZodObject<{
+                enabled: z.ZodBoolean;
+                max: z.ZodNumber;
+            }, z.core.$strict>;
+        }, z.core.$strict>>;
+        subject: z.ZodDefault<z.ZodString>;
+        senderName: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        intro: z.ZodDefault<z.ZodPipe<z.ZodNullable<z.ZodObject<{
+            type: z.ZodLiteral<"doc">;
+            content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"paragraph">;
+                content: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    type: z.ZodLiteral<"text">;
+                    text: z.ZodString;
+                    marks: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        type: z.ZodLiteral<"bold">;
+                    }, z.core.$strict>, z.ZodObject<{
+                        type: z.ZodLiteral<"italic">;
+                    }, z.core.$strict>, z.ZodObject<{
+                        type: z.ZodLiteral<"link">;
+                        attrs: z.ZodObject<{
+                            href: z.ZodPipe<z.ZodString, z.ZodURL>;
+                        }, z.core.$strict>;
+                    }, z.core.$strict>], "type">>>;
+                }, z.core.$strict>, z.ZodObject<{
+                    type: z.ZodLiteral<"hardBreak">;
+                }, z.core.$strict>], "type">>>;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"bulletList">;
+                content: z.ZodArray<z.ZodObject<{
+                    type: z.ZodLiteral<"listItem">;
+                    content: z.ZodArray<z.ZodObject<{
+                        type: z.ZodLiteral<"paragraph">;
+                        content: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                            type: z.ZodLiteral<"text">;
+                            text: z.ZodString;
+                            marks: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                                type: z.ZodLiteral<"bold">;
+                            }, z.core.$strict>, z.ZodObject<{
+                                type: z.ZodLiteral<"italic">;
+                            }, z.core.$strict>, z.ZodObject<{
+                                type: z.ZodLiteral<"link">;
+                                attrs: z.ZodObject<{
+                                    href: z.ZodPipe<z.ZodString, z.ZodURL>;
+                                }, z.core.$strict>;
+                            }, z.core.$strict>], "type">>>;
+                        }, z.core.$strict>, z.ZodObject<{
+                            type: z.ZodLiteral<"hardBreak">;
+                        }, z.core.$strict>], "type">>>;
+                    }, z.core.$strict>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>], "type">>;
+        }, z.core.$strict>>, z.ZodTransform<{
+            type: "doc";
+            content: ({
+                type: "paragraph";
+                content?: ({
+                    type: "text";
+                    text: string;
+                    marks?: ({
+                        type: "bold";
+                    } | {
+                        type: "italic";
+                    } | {
+                        type: "link";
+                        attrs: {
+                            href: string;
+                        };
+                    })[] | undefined;
+                } | {
+                    type: "hardBreak";
+                })[] | undefined;
+            } | {
+                type: "bulletList";
+                content: {
+                    type: "listItem";
+                    content: {
+                        type: "paragraph";
+                        content?: ({
+                            type: "text";
+                            text: string;
+                            marks?: ({
+                                type: "bold";
+                            } | {
+                                type: "italic";
+                            } | {
+                                type: "link";
+                                attrs: {
+                                    href: string;
+                                };
+                            })[] | undefined;
+                        } | {
+                            type: "hardBreak";
+                        })[] | undefined;
+                    }[];
+                }[];
+            })[];
+        } | null, {
+            type: "doc";
+            content: ({
+                type: "paragraph";
+                content?: ({
+                    type: "text";
+                    text: string;
+                    marks?: ({
+                        type: "bold";
+                    } | {
+                        type: "italic";
+                    } | {
+                        type: "link";
+                        attrs: {
+                            href: string;
+                        };
+                    })[] | undefined;
+                } | {
+                    type: "hardBreak";
+                })[] | undefined;
+            } | {
+                type: "bulletList";
+                content: {
+                    type: "listItem";
+                    content: {
+                        type: "paragraph";
+                        content?: ({
+                            type: "text";
+                            text: string;
+                            marks?: ({
+                                type: "bold";
+                            } | {
+                                type: "italic";
+                            } | {
+                                type: "link";
+                                attrs: {
+                                    href: string;
+                                };
+                            })[] | undefined;
+                        } | {
+                            type: "hardBreak";
+                        })[] | undefined;
+                    }[];
+                }[];
+            })[];
+        } | null>>>;
+        outro: z.ZodDefault<z.ZodPipe<z.ZodNullable<z.ZodObject<{
+            type: z.ZodLiteral<"doc">;
+            content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"paragraph">;
+                content: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    type: z.ZodLiteral<"text">;
+                    text: z.ZodString;
+                    marks: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        type: z.ZodLiteral<"bold">;
+                    }, z.core.$strict>, z.ZodObject<{
+                        type: z.ZodLiteral<"italic">;
+                    }, z.core.$strict>, z.ZodObject<{
+                        type: z.ZodLiteral<"link">;
+                        attrs: z.ZodObject<{
+                            href: z.ZodPipe<z.ZodString, z.ZodURL>;
+                        }, z.core.$strict>;
+                    }, z.core.$strict>], "type">>>;
+                }, z.core.$strict>, z.ZodObject<{
+                    type: z.ZodLiteral<"hardBreak">;
+                }, z.core.$strict>], "type">>>;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"bulletList">;
+                content: z.ZodArray<z.ZodObject<{
+                    type: z.ZodLiteral<"listItem">;
+                    content: z.ZodArray<z.ZodObject<{
+                        type: z.ZodLiteral<"paragraph">;
+                        content: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                            type: z.ZodLiteral<"text">;
+                            text: z.ZodString;
+                            marks: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                                type: z.ZodLiteral<"bold">;
+                            }, z.core.$strict>, z.ZodObject<{
+                                type: z.ZodLiteral<"italic">;
+                            }, z.core.$strict>, z.ZodObject<{
+                                type: z.ZodLiteral<"link">;
+                                attrs: z.ZodObject<{
+                                    href: z.ZodPipe<z.ZodString, z.ZodURL>;
+                                }, z.core.$strict>;
+                            }, z.core.$strict>], "type">>>;
+                        }, z.core.$strict>, z.ZodObject<{
+                            type: z.ZodLiteral<"hardBreak">;
+                        }, z.core.$strict>], "type">>>;
+                    }, z.core.$strict>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>], "type">>;
+        }, z.core.$strict>>, z.ZodTransform<{
+            type: "doc";
+            content: ({
+                type: "paragraph";
+                content?: ({
+                    type: "text";
+                    text: string;
+                    marks?: ({
+                        type: "bold";
+                    } | {
+                        type: "italic";
+                    } | {
+                        type: "link";
+                        attrs: {
+                            href: string;
+                        };
+                    })[] | undefined;
+                } | {
+                    type: "hardBreak";
+                })[] | undefined;
+            } | {
+                type: "bulletList";
+                content: {
+                    type: "listItem";
+                    content: {
+                        type: "paragraph";
+                        content?: ({
+                            type: "text";
+                            text: string;
+                            marks?: ({
+                                type: "bold";
+                            } | {
+                                type: "italic";
+                            } | {
+                                type: "link";
+                                attrs: {
+                                    href: string;
+                                };
+                            })[] | undefined;
+                        } | {
+                            type: "hardBreak";
+                        })[] | undefined;
+                    }[];
+                }[];
+            })[];
+        } | null, {
+            type: "doc";
+            content: ({
+                type: "paragraph";
+                content?: ({
+                    type: "text";
+                    text: string;
+                    marks?: ({
+                        type: "bold";
+                    } | {
+                        type: "italic";
+                    } | {
+                        type: "link";
+                        attrs: {
+                            href: string;
+                        };
+                    })[] | undefined;
+                } | {
+                    type: "hardBreak";
+                })[] | undefined;
+            } | {
+                type: "bulletList";
+                content: {
+                    type: "listItem";
+                    content: {
+                        type: "paragraph";
+                        content?: ({
+                            type: "text";
+                            text: string;
+                            marks?: ({
+                                type: "bold";
+                            } | {
+                                type: "italic";
+                            } | {
+                                type: "link";
+                                attrs: {
+                                    href: string;
+                                };
+                            })[] | undefined;
+                        } | {
+                            type: "hardBreak";
+                        })[] | undefined;
+                    }[];
+                }[];
+            })[];
+        } | null>>>;
+        recipients: z.ZodDefault<z.ZodObject<{
+            members: z.ZodDefault<z.ZodBoolean>;
+            extraAddresses: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                address: z.ZodPipe<z.ZodEmail, z.ZodTransform<string, string>>;
+                name: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            excludeUserIds: z.ZodDefault<z.ZodArray<z.ZodUUID>>;
+        }, z.core.$strict>>;
+        imageMode: z.ZodDefault<z.ZodEnum<{
+            auto: "auto";
+            hosted: "hosted";
+            inline: "inline";
+            none: "none";
+        }>>;
+        skipWhenEmpty: z.ZodDefault<z.ZodBoolean>;
+        links: z.ZodDefault<z.ZodObject<{
+            tracearr: z.ZodBoolean;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type NewsletterPreviewDraftInput = z.infer<typeof newsletterPreviewDraftSchema>;
+export declare const emailSuppressionCreateSchema: z.ZodObject<{
+    address: z.ZodPipe<z.ZodEmail, z.ZodTransform<string, string>>;
+}, z.core.$strict>;
+export declare const newsletterSendsQuerySchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    pageSize: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+export declare const EMAIL_LOGO_MODES: readonly ['tracearr', 'none', 'url'];
+export type EmailLogoMode = (typeof EMAIL_LOGO_MODES)[number];
+export declare const emailBrandingSchema: z.ZodObject<{
+    logo: z.ZodDefault<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        mode: z.ZodLiteral<"tracearr">;
+    }, z.core.$strict>, z.ZodObject<{
+        mode: z.ZodLiteral<"none">;
+    }, z.core.$strict>, z.ZodObject<{
+        mode: z.ZodLiteral<"url">;
+        url: z.ZodPipe<z.ZodString, z.ZodURL>;
+    }, z.core.$strict>], "mode">>;
+    accentColor: z.ZodDefault<z.ZodString>;
+    footerText: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    postalAddress: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    mailtoUnsubscribe: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>;
+export type EmailBrandingSettings = z.infer<typeof emailBrandingSchema>;
+export declare const DEFAULT_EMAIL_BRANDING: EmailBrandingSettings;
+/** A block an older build wrote may carry keys this one dropped; the read path strips them instead of resetting to defaults. */
+export declare const emailBrandingReadSchema: z.ZodObject<{
+    logo: z.ZodDefault<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        mode: z.ZodLiteral<"tracearr">;
+    }, z.core.$strict>, z.ZodObject<{
+        mode: z.ZodLiteral<"none">;
+    }, z.core.$strict>, z.ZodObject<{
+        mode: z.ZodLiteral<"url">;
+        url: z.ZodPipe<z.ZodString, z.ZodURL>;
+    }, z.core.$strict>], "mode">>;
+    accentColor: z.ZodDefault<z.ZodString>;
+    footerText: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    postalAddress: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    mailtoUnsubscribe: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const NEWSLETTER_VIEW_TOKEN_LENGTH = 43;
+export declare const NEWSLETTER_SNAPSHOT_RETENTION_DAYS = 90;
+export declare const NEWSLETTER_SEND_RETENTION_DAYS = 365;
+export interface NewsletterSendHtml {
+    subject: string;
+    html: string;
+}
+export declare function newsletterCron(schedule: NewsletterSchedule): string;
+/** Null means the scoped server's name when the scope resolves to exactly one server; several servers have no natural name. */
+export declare function resolveSenderName(senderName: string | null, scopedServerNames: string[]): string;
+/** What one set of the newsletter's servers received: who, how much was trimmed to fit, how big, or that nothing was new there. */
+export interface NewsletterSendVariant {
+    key: string;
+    serverIds: string[];
+    serverNames: string[];
+    /** Deliverable recipients in this variant. */
+    recipientCount: number;
+    trimmed: NewsletterSectionCounts;
+    bytes: number;
+    /** Nothing new in the window for these servers: no snapshot, nobody in the variant was mailed. */
+    empty: boolean;
+}
+/** API shapes. Dates are ISO strings. */
+export interface NewsletterSendSummary {
+    id: string;
+    trigger: NewsletterSendTrigger;
+    outcome: NewsletterSendOutcome;
+    windowStart: string;
+    windowEnd: string;
+    recipientCount: number;
+    itemCounts: Record<string, number>;
+    error: string | null;
+    startedAt: string | null;
+    finishedAt: string | null;
+    hasSnapshot: boolean;
+    variants: NewsletterSendVariant[];
+}
+export interface Newsletter {
+    id: string;
+    name: string;
+    enabled: boolean;
+    destinationId: string | null;
+    schedule: NewsletterSchedule;
+    timezone: string;
+    window: NewsletterWindow;
+    scope: NewsletterScope;
+    sections: NewsletterSections;
+    subject: string;
+    senderName: string | null;
+    intro: EmailRichTextDoc | null;
+    outro: EmailRichTextDoc | null;
+    recipients: NewsletterRecipients;
+    imageMode: NewsletterImageMode;
+    skipWhenEmpty: boolean;
+    links: NewsletterLinks;
+    createdAt: string;
+    updatedAt: string;
+    lastSend: NewsletterSendSummary | null;
+    nextRunAt: string | null;
+}
+export interface NewsletterSendRecipient {
+    id: string;
+    address: string;
+    userId: string | null;
+    status: NewsletterRecipientStatus;
+    variantKey: string;
+    attempts: number;
+    error: string | null;
+    sentAt: string | null;
+}
+export interface NewsletterSendDetail extends NewsletterSendSummary {
+    recipients: NewsletterSendRecipient[];
+}
+export interface NewsletterSendsPage {
+    sends: NewsletterSendSummary[];
+    total: number;
+    page: number;
+    pageSize: number;
+}
+export interface NewsletterRecipientPerson {
+    userId: string;
+    /** The person's oldest account on a scoped server; the identity PATCH route and the user page key on it. */
+    serverUserId: string;
+    name: string | null;
+    username: string | null;
+    serverId: string;
+    serverName: string;
+    thumbUrl: string | null;
+    /** Every scoped server this person has an active account on, oldest account first. */
+    serverIds: string[];
+}
+export declare const NEWSLETTER_EXCLUDED_REASONS: readonly ['excluded', 'banned', 'pending', 'noServer'];
+export type NewsletterExcludedReason = (typeof NEWSLETTER_EXCLUDED_REASONS)[number];
+/** Why a person with an account on a scoped server is not on the list: the owner excluded them, or their identity is banned or still pending. */
+export interface NewsletterExcludedPerson extends NewsletterRecipientPerson {
+    reason: NewsletterExcludedReason;
+}
+export interface NewsletterResolvedRecipient {
+    address: string;
+    userId: string | null;
+    serverUserId: string | null;
+    name: string | null;
+    suppressed: boolean;
+    serverId: string | null;
+    username: string | null;
+    serverName: string | null;
+    thumbUrl: string | null;
+    /** Every scoped server the person has an account on; empty for an extra address. */
+    serverIds: string[];
+}
+/** GET /newsletters/:id/recipients: who the next send reaches, who has no address, and who the owner excluded. */
+export interface NewsletterRecipientsView {
+    recipients: NewsletterResolvedRecipient[];
+    missing: NewsletterRecipientPerson[];
+    excluded: NewsletterExcludedPerson[];
+}
+export interface EmailSuppression {
+    address: string;
+    reason: EmailSuppressionReason;
+    sourceSendId: string | null;
+    sourceNewsletterId: string | null;
+    createdAt: string;
+}
+/** Cards a section holds, albums counted across artists; also the shape of what the render-time fit loop removed per section. */
+export interface NewsletterSectionCounts {
+    movies: number;
+    shows: number;
+    albums: number;
+    mostWatched: number;
+}
+export interface NewsletterPreviewVariant {
+    key: string;
+    serverIds: string[];
+    serverNames: string[];
+    /** Deliverable recipients in this variant. */
+    recipientCount: number;
+    subject: string;
+    html: string;
+    counts: Record<string, number>;
+    /** Items the fit loop removed so the email stays under the clip budget; each shows in its section's "+N more" line. */
+    trimmed: NewsletterSectionCounts;
+}
+export interface NewsletterPreview {
+    /** fromWatermark is true when a since_last_send window started at the last counted send rather than the fallback days. */
+    window: {
+        start: string;
+        end: string;
+        fromWatermark: boolean;
+    };
+    recipients: {
+        resolved: number;
+        missingEmail: number;
+        suppressed: number;
+    };
+    /** The union of the newsletter's servers first, then one entry per set some recipient belongs to. */
+    variants: [NewsletterPreviewVariant, ...NewsletterPreviewVariant[]];
+}
+/** GET /newsletters/:id/variants: what each set of servers would get from the next send, without rendering. */
+export interface NewsletterVariantsView {
+    window: {
+        start: string;
+        end: string;
+    };
+    variants: {
+        key: string;
+        serverIds: string[];
+        serverNames: string[];
+        recipientCount: number;
+        counts: Record<string, number>;
+        isEmpty: boolean;
+    }[];
+}
+//# sourceMappingURL=newsletters.d.ts.map