mailpit-api 1.1.0 → 1.2.0

package/dist/mjs/src/index.d.ts

@@ -1,241 +0,0 @@
-interface Address {
-    Address: string;
-    Name: string;
-}
-interface Email {
-    Email: string;
-    Name: string;
-}
-interface Attachment {
-    ContentID: string;
-    ContentType: string;
-    FileName: string;
-    PartID: string;
-    Size: number;
-}
-interface ChaosTrigger {
-    ErrorCode: number;
-    Probability: number;
-}
-export interface MailpitInfoResponse {
-    Database: string;
-    DatabaseSize: number;
-    LatestVersion: string;
-    Messages: number;
-    RuntimeStats: {
-        Memory: number;
-        MessagesDeleted: number;
-        SMTPAccepted: number;
-        SMTPAcceptedSize: number;
-        SMTPIgnored: number;
-        SMTPRejected: number;
-        Uptime: number;
-    };
-    Tags: {
-        [key: string]: number;
-    };
-    Unread: number;
-    Version: string;
-}
-export interface MailpitConfigurationResponse {
-    DuplicatesIgnored: boolean;
-    Label: string;
-    SpamAssassin: boolean;
-    MessageRelay: {
-        AllowedRecipients: string;
-        Enabled: boolean;
-        ReturnPath: string;
-        SMTPServer: string;
-    };
-}
-export interface MailpitMessageSummaryResponse {
-    Attachments: Attachment[];
-    Bcc: Address[];
-    Cc: Address[];
-    Date: string;
-    From: Address;
-    HTML: string;
-    ID: string;
-    Inline: Attachment[];
-    MessageID: string;
-    ReplyTo: Address[];
-    ReturnPath: string;
-    Size: number;
-    Subject: string;
-    Tags: string[];
-    Text: string;
-    To: Address[];
-}
-export interface MailpitMessagesSummaryResponse {
-    messages: {
-        Attachments: number;
-        Size: number;
-        Snippet: string;
-        Subject: string;
-        Tags: string[];
-        ID: string;
-        MessageID: string;
-        Read: boolean;
-        Bcc: Address[];
-        Cc: Address[];
-        From: Address;
-        ReplyTo: Address[];
-        To: Address[];
-    }[];
-    messages_count: number;
-    start: number;
-    tags: string[];
-    total: number;
-    unread: number;
-}
-export interface MailpitMessageHeadersResponse {
-    [key: string]: string;
-}
-export interface MailpitSendRequest {
-    Attachments: {
-        Content: string;
-        Filename: string;
-    }[];
-    Bcc: string[];
-    Cc: Email[];
-    From: Email;
-    HTML: string;
-    Headers: {
-        [key: string]: string;
-    };
-    ReplyTo: Email[];
-    Subject: string;
-    Tags: string[];
-    Text: string;
-    To: Email[];
-}
-export interface MailpitSendMessageConfirmationResponse {
-    ID: string;
-}
-export interface MailpitHTMLCheckResponse {
-    Platforms: {
-        [key: string]: [string];
-    };
-    Total: {
-        Nodes: number;
-        Partial: number;
-        Supported: number;
-        Tests: number;
-        Unsupported: number;
-    };
-    Warnings: {
-        Category: "css" | "html";
-        Description: string;
-        Keywords: string;
-        NotesByNumber: {
-            [key: string]: string;
-        };
-        Results: {
-            Family: string;
-            Name: string;
-            NoteNumber: string;
-            Platform: string;
-            Support: "yes" | "no" | "partial";
-            Version: string;
-        }[];
-        Score: {
-            Found: number;
-            Partial: number;
-            Supported: number;
-            Unsupported: number;
-        };
-        Slug: string;
-        Tags: string[];
-        Title: string;
-        URL: string;
-    }[];
-}
-export interface MailpitLinkCheckResponse {
-    Errors: number;
-    Links: {
-        Status: string;
-        StatusCode: number;
-        URL: string;
-    }[];
-}
-export interface MailpitSpamAssassinResponse {
-    Errors: number;
-    IsSpam: boolean;
-    Rules: {
-        Description: string;
-        Name: string;
-        Score: number;
-    }[];
-    Score: number;
-}
-export interface MailpitReadStatusRequest {
-    IDs: string[];
-    Read: boolean;
-}
-export interface MailpitDeleteRequest {
-    IDs: string[];
-}
-export interface MailpitSearchRequest {
-    query: string;
-    start?: number;
-    limit?: number;
-    tz?: string;
-}
-export interface MailpitSearchDeleteRequest {
-    query: string;
-    tz?: string;
-}
-export interface MailpitSetTagsRequest {
-    IDs: string[];
-    Tags: string[];
-}
-export interface ChaosTriggersRequest {
-    Authentication?: ChaosTrigger;
-    Recipient?: ChaosTrigger;
-    Sender?: ChaosTrigger;
-}
-export interface ChaosTriggersResponse {
-    Authentication: ChaosTrigger;
-    Recipient?: ChaosTrigger;
-    Sender?: ChaosTrigger;
-}
-interface AttachmentResponse {
-    data: ArrayBuffer;
-    contentType: string;
-}
-export declare class MailpitClient {
-    private axiosInstance;
-    constructor(baseURL: string, auth?: {
-        username: string;
-        password: string;
-    });
-    private handleRequest;
-    getInfo(): Promise<MailpitInfoResponse>;
-    getConfiguration(): Promise<MailpitConfigurationResponse>;
-    getMessageSummary(id?: string): Promise<MailpitMessageSummaryResponse>;
-    getMessageHeaders(id?: string): Promise<MailpitMessageHeadersResponse>;
-    getMessageAttachment(id: string, partID: string): Promise<AttachmentResponse>;
-    getMessageSource(id?: string): Promise<string>;
-    getAttachmentThumbnail(id: string, partID: string): Promise<AttachmentResponse>;
-    releaseMessage(id: string, releaseRequest: {
-        To: string[];
-    }): Promise<string>;
-    sendMessage(sendReqest: MailpitSendRequest): Promise<MailpitSendMessageConfirmationResponse>;
-    htmlCheck(id?: string): Promise<MailpitHTMLCheckResponse>;
-    linkCheck(id?: string, follow?: "true" | "false"): Promise<MailpitLinkCheckResponse>;
-    spamAssassinCheck(id?: string): Promise<MailpitSpamAssassinResponse>;
-    listMessages(start?: number, limit?: number): Promise<MailpitMessagesSummaryResponse>;
-    setReadStatus(readStatus: MailpitReadStatusRequest): Promise<string>;
-    deleteMessages(deleteRequest?: MailpitDeleteRequest): Promise<string>;
-    searchMessages(search: MailpitSearchRequest): Promise<MailpitMessagesSummaryResponse>;
-    deleteMessagesBySearch(search: MailpitSearchDeleteRequest): Promise<string>;
-    getTags(): Promise<string[]>;
-    setTags(request: MailpitSetTagsRequest): Promise<string>;
-    renameTag(tag: string, newTagName: string): Promise<string>;
-    deleteTag(tag: string): Promise<string>;
-    renderMessageHTML(id?: string, embed?: 1): Promise<string>;
-    renderMessageText(id?: string): Promise<string>;
-    getChaosTriggers(): Promise<ChaosTriggersResponse>;
-    setChaosTriggers(triggers?: ChaosTriggersRequest): Promise<ChaosTriggersResponse>;
-}
-export {};

package/dist/mjs/src/index.js

@@ -1,141 +0,0 @@
-import axios, { isAxiosError, } from "axios";
-export class MailpitClient {
-    axiosInstance;
-    constructor(baseURL, auth) {
-        this.axiosInstance = axios.create({
-            baseURL,
-            auth,
-            validateStatus: function (status) {
-                return status === 200;
-            },
-        });
-    }
-    async handleRequest(request, options = { fullResponse: false }) {
-        try {
-            const response = await request();
-            return options.fullResponse ? response : response.data;
-        }
-        catch (error) {
-            if (isAxiosError(error)) {
-                const url = error.config?.url || "UNKNOWN URL";
-                const method = error.config?.method?.toUpperCase() || "UNKNOWN METHOD";
-                if (error.response) {
-                    // Server responded with a status other than 2xx
-                    throw new Error(`Mailpit API Error: ${error.response.status.toString()} ${error.response.statusText} at ${method} ${url}: ${JSON.stringify(error.response.data)}`);
-                }
-                else if (error.request) {
-                    // Request was made but no response was received
-                    throw new Error(`Mailpit API Error: No response received from server at ${method} ${url}`);
-                }
-                else {
-                    // Something happened in setting up the request
-                    throw new Error(`Mailpit API Error: ${error.toString()} at ${method} ${url}`);
-                }
-            }
-            else {
-                throw new Error(`Unexpected Error: ${error}`);
-            }
-        }
-    }
-    // Application
-    async getInfo() {
-        return await this.handleRequest(() => this.axiosInstance.get("/api/v1/info"));
-    }
-    async getConfiguration() {
-        return await this.handleRequest(() => this.axiosInstance.get("/api/v1/webui"));
-    }
-    // Message
-    async getMessageSummary(id = "latest") {
-        return await this.handleRequest(() => this.axiosInstance.get(`/api/v1/message/${id}`));
-    }
-    async getMessageHeaders(id = "latest") {
-        return await this.handleRequest(() => this.axiosInstance.get(`/api/v1/message/${id}/headers`));
-    }
-    async getMessageAttachment(id, partID) {
-        const response = await this.handleRequest(() => this.axiosInstance.get(`/api/v1/message/${id}/part/${partID}`, { responseType: "arraybuffer" }), { fullResponse: true });
-        return {
-            data: response.data,
-            contentType: response.headers["content-type"],
-        };
-    }
-    async getMessageSource(id = "latest") {
-        return await this.handleRequest(() => this.axiosInstance.get(`/api/v1/message/${id}/raw`));
-    }
-    async getAttachmentThumbnail(id, partID) {
-        const response = await this.handleRequest(() => this.axiosInstance.get(`/api/v1/message/${id}/part/${partID}/thumb`, {
-            responseType: "arraybuffer",
-        }), { fullResponse: true });
-        return {
-            data: response.data,
-            contentType: response.headers["content-type"],
-        };
-    }
-    async releaseMessage(id, releaseRequest) {
-        return await this.handleRequest(() => this.axiosInstance.post(`/api/v1/message/${id}/release`, releaseRequest));
-    }
-    async sendMessage(sendReqest) {
-        return await this.handleRequest(() => this.axiosInstance.post(`/api/v1/send`, sendReqest));
-    }
-    // Other
-    async htmlCheck(id = "latest") {
-        return await this.handleRequest(() => this.axiosInstance.get(`/api/v1/message/${id}/html-check`));
-    }
-    async linkCheck(id = "latest", follow = "false") {
-        return await this.handleRequest(() => this.axiosInstance.get(`/api/v1/message/${id}/link-check`, { params: { follow } }));
-    }
-    async spamAssassinCheck(id = "latest") {
-        return await this.handleRequest(() => this.axiosInstance.get(`/api/v1/message/${id}/sa-check`));
-    }
-    // Messages
-    async listMessages(start = 0, limit = 50) {
-        return await this.handleRequest(() => this.axiosInstance.get(`/api/v1/messages`, { params: { start, limit } }));
-    }
-    async setReadStatus(readStatus) {
-        return await this.handleRequest(() => this.axiosInstance.put(`/api/v1/messages`, readStatus));
-    }
-    async deleteMessages(deleteRequest) {
-        return await this.handleRequest(() => this.axiosInstance.delete(`/api/v1/messages`, {
-            data: deleteRequest,
-        }));
-    }
-    // See https://mailpit.axllent.org/docs/usage/search-filters/
-    async searchMessages(search) {
-        return await this.handleRequest(() => this.axiosInstance.get(`/api/v1/search`, {
-            params: search,
-        }));
-    }
-    // See https://mailpit.axllent.org/docs/usage/search-filters/
-    async deleteMessagesBySearch(search) {
-        return await this.handleRequest(() => this.axiosInstance.delete(`/api/v1/search`, { params: search }));
-    }
-    // Tags
-    async getTags() {
-        return await this.handleRequest(() => this.axiosInstance.get(`/api/v1/tags`));
-    }
-    async setTags(request) {
-        return await this.handleRequest(() => this.axiosInstance.put(`/api/v1/tags`, request));
-    }
-    async renameTag(tag, newTagName) {
-        const encodedTag = encodeURI(tag);
-        return await this.handleRequest(() => this.axiosInstance.put(`/api/v1/tags/${encodedTag}`, {
-            Name: newTagName,
-        }));
-    }
-    async deleteTag(tag) {
-        const encodedTag = encodeURI(tag);
-        return await this.handleRequest(() => this.axiosInstance.delete(`/api/v1/tags/${encodedTag}`));
-    }
-    // Testing
-    async renderMessageHTML(id = "latest", embed) {
-        return await this.handleRequest(() => this.axiosInstance.get(`/view/${id}.html`, { params: { embed } }));
-    }
-    async renderMessageText(id = "latest") {
-        return await this.handleRequest(() => this.axiosInstance.get(`/view/${id}.txt`));
-    }
-    async getChaosTriggers() {
-        return await this.handleRequest(() => this.axiosInstance.get("/api/v1/chaos"));
-    }
-    async setChaosTriggers(triggers = {}) {
-        return await this.handleRequest(() => this.axiosInstance.put("/api/v1/chaos", triggers));
-    }
-}