@axium/email 0.0.1

package/dist/common.d.ts

@@ -0,0 +1,454 @@
+import * as z from 'zod';
+/** A single address in a message header, e.g. `"James" <james@example.com>` */
+export declare const Mailbox: z.ZodObject<{
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    address: z.ZodEmail;
+}, z.core.$strip>;
+export interface Mailbox extends z.infer<typeof Mailbox> {
+}
+export declare const emailFolders: readonly ["inbox", "sent", "drafts", "spam", "trash", "archive"];
+export declare const EmailFolder: z.ZodLiteral<"inbox" | "sent" | "drafts" | "spam" | "trash" | "archive">;
+export type EmailFolder = z.infer<typeof EmailFolder>;
+export declare const Attachment: z.ZodObject<{
+    id: z.ZodUUID;
+    emailId: z.ZodUUID;
+    filename: z.ZodString;
+    contentType: z.ZodString;
+    size: z.ZodCoercedBigInt<unknown>;
+}, z.core.$strip>;
+export interface Attachment extends z.infer<typeof Attachment> {
+}
+/** The body of a message being composed (sent or saved as a draft) */
+export declare const EmailInit: z.ZodObject<{
+    to: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        address: z.ZodEmail;
+    }, z.core.$strip>>>;
+    cc: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        address: z.ZodEmail;
+    }, z.core.$strip>>>;
+    bcc: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        address: z.ZodEmail;
+    }, z.core.$strip>>>;
+    subject: z.ZodDefault<z.ZodString>;
+    text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    inReplyTo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    isDraft: z.ZodDefault<z.ZodBoolean>;
+    draftId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+}, z.core.$strip>;
+export interface EmailInit extends z.infer<typeof EmailInit> {
+}
+export declare const Email: z.ZodObject<{
+    id: z.ZodUUID;
+    userId: z.ZodUUID;
+    messageId: z.ZodString;
+    inReplyTo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    references: z.ZodArray<z.ZodString>;
+    threadId: z.ZodUUID;
+    from: z.ZodObject<{
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        address: z.ZodEmail;
+    }, z.core.$strip>;
+    to: z.ZodArray<z.ZodObject<{
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        address: z.ZodEmail;
+    }, z.core.$strip>>;
+    cc: z.ZodArray<z.ZodObject<{
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        address: z.ZodEmail;
+    }, z.core.$strip>>;
+    bcc: z.ZodArray<z.ZodObject<{
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        address: z.ZodEmail;
+    }, z.core.$strip>>;
+    subject: z.ZodString;
+    snippet: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    html: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    date: z.ZodCoercedDate<unknown>;
+    received: z.ZodCoercedDate<unknown>;
+    folder: z.ZodLiteral<"inbox" | "sent" | "drafts" | "spam" | "trash" | "archive">;
+    read: z.ZodBoolean;
+    starred: z.ZodBoolean;
+    labels: z.ZodArray<z.ZodString>;
+    size: z.ZodInt;
+    attachments: z.ZodArray<z.ZodObject<{
+        id: z.ZodUUID;
+        emailId: z.ZodUUID;
+        filename: z.ZodString;
+        contentType: z.ZodString;
+        size: z.ZodCoercedBigInt<unknown>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export interface Email extends z.infer<typeof Email> {
+}
+/** Flag and draft changes */
+export declare const EmailChangeable: z.ZodObject<{
+    folder: z.ZodOptional<z.ZodLiteral<"inbox" | "sent" | "drafts" | "spam" | "trash" | "archive">>;
+    read: z.ZodOptional<z.ZodBoolean>;
+    starred: z.ZodOptional<z.ZodBoolean>;
+    labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    to: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        address: z.ZodEmail;
+    }, z.core.$strip>>>;
+    cc: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        address: z.ZodEmail;
+    }, z.core.$strip>>>;
+    bcc: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        address: z.ZodEmail;
+    }, z.core.$strip>>>;
+    subject: z.ZodOptional<z.ZodString>;
+    text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export interface EmailChangeable extends z.infer<typeof EmailChangeable> {
+}
+export declare const EmailListQuery: z.ZodObject<{
+    folder: z.ZodOptional<z.ZodLiteral<"inbox" | "sent" | "drafts" | "spam" | "trash" | "archive">>;
+    starred: z.ZodOptional<z.ZodBoolean>;
+    limit: z.ZodDefault<z.ZodInt>;
+    offset: z.ZodDefault<z.ZodInt>;
+}, z.core.$strip>;
+export interface EmailListQuery extends z.infer<typeof EmailListQuery> {
+}
+export declare const EmailConfig: z.ZodObject<{
+    inbound: z.ZodObject<{
+        enabled: z.ZodBoolean;
+        port: z.ZodInt;
+        max_size: z.ZodNumber;
+        ssl_key: z.ZodOptional<z.ZodString>;
+        ssl_cert: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export interface EmailConfig extends z.infer<typeof EmailConfig> {
+}
+declare module '@axium/core/plugins' {
+    interface $PluginConfigs {
+        '@axium/email': EmailConfig;
+    }
+}
+/**
+ * Split a plain text body into new content and the quoted ("nested") part of top-posted replies.
+ * Note this only handles plain text; quotes in HTML bodies are not detected.
+ */
+export declare function splitQuoted(text: string): {
+    content: string;
+    quoted: string | null;
+};
+declare module '@axium/core/socket' {
+    interface ServerToClient {
+        'email.received': z.ZodFunction<z.ZodTuple<[typeof Email]>, z.ZodVoid>;
+    }
+}
+declare const EmailAPI: {
+    readonly 'users/:id/email': {
+        readonly GET: readonly [z.ZodObject<{
+            folder: z.ZodOptional<z.ZodLiteral<"inbox" | "sent" | "drafts" | "spam" | "trash" | "archive">>;
+            starred: z.ZodOptional<z.ZodBoolean>;
+            limit: z.ZodDefault<z.ZodInt>;
+            offset: z.ZodDefault<z.ZodInt>;
+        }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+            id: z.ZodUUID;
+            userId: z.ZodUUID;
+            messageId: z.ZodString;
+            inReplyTo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            references: z.ZodArray<z.ZodString>;
+            threadId: z.ZodUUID;
+            from: z.ZodObject<{
+                name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                address: z.ZodEmail;
+            }, z.core.$strip>;
+            to: z.ZodArray<z.ZodObject<{
+                name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                address: z.ZodEmail;
+            }, z.core.$strip>>;
+            cc: z.ZodArray<z.ZodObject<{
+                name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                address: z.ZodEmail;
+            }, z.core.$strip>>;
+            bcc: z.ZodArray<z.ZodObject<{
+                name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                address: z.ZodEmail;
+            }, z.core.$strip>>;
+            subject: z.ZodString;
+            snippet: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            html: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            date: z.ZodCoercedDate<unknown>;
+            received: z.ZodCoercedDate<unknown>;
+            folder: z.ZodLiteral<"inbox" | "sent" | "drafts" | "spam" | "trash" | "archive">;
+            read: z.ZodBoolean;
+            starred: z.ZodBoolean;
+            labels: z.ZodArray<z.ZodString>;
+            size: z.ZodInt;
+            attachments: z.ZodArray<z.ZodObject<{
+                id: z.ZodUUID;
+                emailId: z.ZodUUID;
+                filename: z.ZodString;
+                contentType: z.ZodString;
+                size: z.ZodCoercedBigInt<unknown>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>];
+        readonly PUT: readonly [z.ZodObject<{
+            to: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                address: z.ZodEmail;
+            }, z.core.$strip>>>;
+            cc: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                address: z.ZodEmail;
+            }, z.core.$strip>>>;
+            bcc: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                address: z.ZodEmail;
+            }, z.core.$strip>>>;
+            subject: z.ZodDefault<z.ZodString>;
+            text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            inReplyTo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            isDraft: z.ZodDefault<z.ZodBoolean>;
+            draftId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+        }, z.core.$strip>, z.ZodObject<{
+            id: z.ZodUUID;
+            userId: z.ZodUUID;
+            messageId: z.ZodString;
+            inReplyTo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            references: z.ZodArray<z.ZodString>;
+            threadId: z.ZodUUID;
+            from: z.ZodObject<{
+                name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                address: z.ZodEmail;
+            }, z.core.$strip>;
+            to: z.ZodArray<z.ZodObject<{
+                name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                address: z.ZodEmail;
+            }, z.core.$strip>>;
+            cc: z.ZodArray<z.ZodObject<{
+                name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                address: z.ZodEmail;
+            }, z.core.$strip>>;
+            bcc: z.ZodArray<z.ZodObject<{
+                name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                address: z.ZodEmail;
+            }, z.core.$strip>>;
+            subject: z.ZodString;
+            snippet: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            html: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            date: z.ZodCoercedDate<unknown>;
+            received: z.ZodCoercedDate<unknown>;
+            folder: z.ZodLiteral<"inbox" | "sent" | "drafts" | "spam" | "trash" | "archive">;
+            read: z.ZodBoolean;
+            starred: z.ZodBoolean;
+            labels: z.ZodArray<z.ZodString>;
+            size: z.ZodInt;
+            attachments: z.ZodArray<z.ZodObject<{
+                id: z.ZodUUID;
+                emailId: z.ZodUUID;
+                filename: z.ZodString;
+                contentType: z.ZodString;
+                size: z.ZodCoercedBigInt<unknown>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>];
+    };
+    readonly 'email/:id': {
+        readonly GET: z.ZodObject<{
+            id: z.ZodUUID;
+            userId: z.ZodUUID;
+            messageId: z.ZodString;
+            inReplyTo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            references: z.ZodArray<z.ZodString>;
+            threadId: z.ZodUUID;
+            from: z.ZodObject<{
+                name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                address: z.ZodEmail;
+            }, z.core.$strip>;
+            to: z.ZodArray<z.ZodObject<{
+                name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                address: z.ZodEmail;
+            }, z.core.$strip>>;
+            cc: z.ZodArray<z.ZodObject<{
+                name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                address: z.ZodEmail;
+            }, z.core.$strip>>;
+            bcc: z.ZodArray<z.ZodObject<{
+                name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                address: z.ZodEmail;
+            }, z.core.$strip>>;
+            subject: z.ZodString;
+            snippet: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            html: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            date: z.ZodCoercedDate<unknown>;
+            received: z.ZodCoercedDate<unknown>;
+            folder: z.ZodLiteral<"inbox" | "sent" | "drafts" | "spam" | "trash" | "archive">;
+            read: z.ZodBoolean;
+            starred: z.ZodBoolean;
+            labels: z.ZodArray<z.ZodString>;
+            size: z.ZodInt;
+            attachments: z.ZodArray<z.ZodObject<{
+                id: z.ZodUUID;
+                emailId: z.ZodUUID;
+                filename: z.ZodString;
+                contentType: z.ZodString;
+                size: z.ZodCoercedBigInt<unknown>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        readonly PATCH: readonly [z.ZodObject<{
+            folder: z.ZodOptional<z.ZodLiteral<"inbox" | "sent" | "drafts" | "spam" | "trash" | "archive">>;
+            read: z.ZodOptional<z.ZodBoolean>;
+            starred: z.ZodOptional<z.ZodBoolean>;
+            labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            to: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                address: z.ZodEmail;
+            }, z.core.$strip>>>;
+            cc: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                address: z.ZodEmail;
+            }, z.core.$strip>>>;
+            bcc: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                address: z.ZodEmail;
+            }, z.core.$strip>>>;
+            subject: z.ZodOptional<z.ZodString>;
+            text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>, z.ZodObject<{
+            id: z.ZodUUID;
+            userId: z.ZodUUID;
+            messageId: z.ZodString;
+            inReplyTo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            references: z.ZodArray<z.ZodString>;
+            threadId: z.ZodUUID;
+            from: z.ZodObject<{
+                name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                address: z.ZodEmail;
+            }, z.core.$strip>;
+            to: z.ZodArray<z.ZodObject<{
+                name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                address: z.ZodEmail;
+            }, z.core.$strip>>;
+            cc: z.ZodArray<z.ZodObject<{
+                name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                address: z.ZodEmail;
+            }, z.core.$strip>>;
+            bcc: z.ZodArray<z.ZodObject<{
+                name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                address: z.ZodEmail;
+            }, z.core.$strip>>;
+            subject: z.ZodString;
+            snippet: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            html: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            date: z.ZodCoercedDate<unknown>;
+            received: z.ZodCoercedDate<unknown>;
+            folder: z.ZodLiteral<"inbox" | "sent" | "drafts" | "spam" | "trash" | "archive">;
+            read: z.ZodBoolean;
+            starred: z.ZodBoolean;
+            labels: z.ZodArray<z.ZodString>;
+            size: z.ZodInt;
+            attachments: z.ZodArray<z.ZodObject<{
+                id: z.ZodUUID;
+                emailId: z.ZodUUID;
+                filename: z.ZodString;
+                contentType: z.ZodString;
+                size: z.ZodCoercedBigInt<unknown>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>];
+        readonly DELETE: z.ZodObject<{
+            id: z.ZodUUID;
+            userId: z.ZodUUID;
+            messageId: z.ZodString;
+            inReplyTo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            references: z.ZodArray<z.ZodString>;
+            threadId: z.ZodUUID;
+            from: z.ZodObject<{
+                name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                address: z.ZodEmail;
+            }, z.core.$strip>;
+            to: z.ZodArray<z.ZodObject<{
+                name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                address: z.ZodEmail;
+            }, z.core.$strip>>;
+            cc: z.ZodArray<z.ZodObject<{
+                name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                address: z.ZodEmail;
+            }, z.core.$strip>>;
+            bcc: z.ZodArray<z.ZodObject<{
+                name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                address: z.ZodEmail;
+            }, z.core.$strip>>;
+            subject: z.ZodString;
+            snippet: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            html: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            date: z.ZodCoercedDate<unknown>;
+            received: z.ZodCoercedDate<unknown>;
+            folder: z.ZodLiteral<"inbox" | "sent" | "drafts" | "spam" | "trash" | "archive">;
+            read: z.ZodBoolean;
+            starred: z.ZodBoolean;
+            labels: z.ZodArray<z.ZodString>;
+            size: z.ZodInt;
+            attachments: z.ZodArray<z.ZodObject<{
+                id: z.ZodUUID;
+                emailId: z.ZodUUID;
+                filename: z.ZodString;
+                contentType: z.ZodString;
+                size: z.ZodCoercedBigInt<unknown>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+    };
+    readonly 'email/:id/thread': {
+        readonly GET: z.ZodArray<z.ZodObject<{
+            id: z.ZodUUID;
+            userId: z.ZodUUID;
+            messageId: z.ZodString;
+            inReplyTo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            references: z.ZodArray<z.ZodString>;
+            threadId: z.ZodUUID;
+            from: z.ZodObject<{
+                name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                address: z.ZodEmail;
+            }, z.core.$strip>;
+            to: z.ZodArray<z.ZodObject<{
+                name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                address: z.ZodEmail;
+            }, z.core.$strip>>;
+            cc: z.ZodArray<z.ZodObject<{
+                name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                address: z.ZodEmail;
+            }, z.core.$strip>>;
+            bcc: z.ZodArray<z.ZodObject<{
+                name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                address: z.ZodEmail;
+            }, z.core.$strip>>;
+            subject: z.ZodString;
+            snippet: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            html: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            date: z.ZodCoercedDate<unknown>;
+            received: z.ZodCoercedDate<unknown>;
+            folder: z.ZodLiteral<"inbox" | "sent" | "drafts" | "spam" | "trash" | "archive">;
+            read: z.ZodBoolean;
+            starred: z.ZodBoolean;
+            labels: z.ZodArray<z.ZodString>;
+            size: z.ZodInt;
+            attachments: z.ZodArray<z.ZodObject<{
+                id: z.ZodUUID;
+                emailId: z.ZodUUID;
+                filename: z.ZodString;
+                contentType: z.ZodString;
+                size: z.ZodCoercedBigInt<unknown>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    };
+};
+type EmailAPI = typeof EmailAPI;
+declare module '@axium/core/api' {
+    interface $API extends EmailAPI {
+    }
+}
+export {};

package/dist/common.js

@@ -0,0 +1,127 @@
+import { serverConfigs } from '@axium/core';
+import { $API } from '@axium/core/api';
+import { addServerToClient } from '@axium/core/socket';
+import * as z from 'zod';
+/** A single address in a message header, e.g. `"James" <james@example.com>` */
+export const Mailbox = z.object({
+    name: z.string().max(255).nullish(),
+    address: z.email().max(255),
+});
+export const emailFolders = ['inbox', 'sent', 'drafts', 'spam', 'trash', 'archive'];
+export const EmailFolder = z.literal(emailFolders);
+export const Attachment = z.object({
+    id: z.uuid(),
+    emailId: z.uuid(),
+    filename: z.string().max(255),
+    contentType: z.string().max(255),
+    size: z.coerce.bigint().nonnegative(),
+});
+/** The body of a message being composed (sent or saved as a draft) */
+export const EmailInit = z.object({
+    to: Mailbox.array().max(100).default([]),
+    cc: Mailbox.array().max(100).default([]),
+    bcc: Mailbox.array().max(100).default([]),
+    subject: z.string().max(998).default(''),
+    text: z.string().max(1_000_000).nullish(),
+    inReplyTo: z.string().max(998).nullish(),
+    /** Save as a draft instead of sending */
+    isDraft: z.boolean().default(false),
+    /** When sending a previously saved draft, its ID */
+    draftId: z.uuid().nullish(),
+});
+export const Email = z.object({
+    id: z.uuid(),
+    userId: z.uuid(),
+    messageId: z.string().max(998),
+    inReplyTo: z.string().max(998).nullish(),
+    references: z.string().array(),
+    threadId: z.uuid(),
+    from: Mailbox,
+    to: Mailbox.array(),
+    cc: Mailbox.array(),
+    bcc: Mailbox.array(),
+    subject: z.string(),
+    snippet: z.string().nullish(),
+    text: z.string().nullish(),
+    html: z.string().nullish(),
+    /** From the Date header */
+    date: z.coerce.date(),
+    /** When the message was stored */
+    received: z.coerce.date(),
+    folder: EmailFolder,
+    read: z.boolean(),
+    starred: z.boolean(),
+    labels: z.string().array(),
+    /** Size of the raw message in bytes */
+    size: z.int().nonnegative(),
+    attachments: Attachment.array(),
+});
+/** Flag and draft changes */
+export const EmailChangeable = z
+    .object({
+    folder: EmailFolder,
+    read: z.boolean(),
+    starred: z.boolean(),
+    labels: z.string().max(100).array().max(100),
+    // these can only be changed on drafts
+    to: Mailbox.array().max(100),
+    cc: Mailbox.array().max(100),
+    bcc: Mailbox.array().max(100),
+    subject: z.string().max(998),
+    text: z.string().max(1_000_000).nullable(),
+})
+    .partial();
+export const EmailListQuery = z.object({
+    folder: EmailFolder.optional(),
+    starred: z.boolean().optional(),
+    limit: z.int().min(1).max(200).default(50),
+    offset: z.int().nonnegative().default(0),
+});
+export const EmailConfig = z.object({
+    inbound: z.object({
+        enabled: z.boolean(),
+        port: z.int().min(1).max(65535),
+        /** Max inbound message size in KB */
+        max_size: z.number().min(0),
+        /** Override the web SSL certificate for STARTTLS */
+        ssl_key: z.string().optional(),
+        ssl_cert: z.string().optional(),
+    }),
+});
+serverConfigs.set('@axium/email', EmailConfig);
+/**
+ * Split a plain text body into new content and the quoted ("nested") part of top-posted replies.
+ * Note this only handles plain text; quotes in HTML bodies are not detected.
+ */
+export function splitQuoted(text) {
+    const lines = text.split('\n');
+    let start = lines.findIndex(line => /^\s*>/.test(line) || /^-{2,}\s*Original Message\s*-{2,}$/i.test(line));
+    if (start == -1)
+        return { content: text, quoted: null };
+    // include the attribution line (e.g. "On <date>, <name> wrote:") and blank lines directly above
+    let above = start - 1;
+    while (above >= 0 && !lines[above].trim())
+        above--;
+    if (above >= 0 && /wrote:\s*$/.test(lines[above]))
+        start = above;
+    const content = lines.slice(0, start).join('\n').trimEnd();
+    if (!content.trim())
+        return { content: text, quoted: null };
+    return { content, quoted: lines.slice(start).join('\n') };
+}
+addServerToClient({ 'email.received': [Email] });
+const EmailAPI = {
+    'users/:id/email': {
+        GET: [EmailListQuery, Email.array()],
+        PUT: [EmailInit, Email],
+    },
+    'email/:id': {
+        GET: Email,
+        PATCH: [EmailChangeable, Email],
+        DELETE: Email,
+    },
+    'email/:id/thread': {
+        GET: Email.array(),
+    },
+};
+Object.assign($API, EmailAPI);

package/dist/index.d.ts

@@ -0,0 +1 @@
+export * from './common.js';

package/dist/index.js

@@ -0,0 +1 @@
+export * from './common.js';

package/dist/server/api.d.ts

@@ -0,0 +1 @@
+import './db.js';