mailpit-api 1.3.1 → 1.4.0

package/dist/cjs/index.js

@@ -1,562 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MailpitClient = void 0;
-const axios_1 = __importStar(require("axios"));
-/**
- * Client for interacting with the {@link https://mailpit.axllent.org/docs/api-v1/ | Mailpit API}.
- * @example
- * ```typescript
- * import { MailpitClient } from "mailpit-api";
- * const mailpit = new MailpitClient("http://localhost:8025");
- * console.log(await mailpit.getInfo());
- * ```
- */
-class MailpitClient {
-    /**
-     * Creates an instance of {@link MailpitClient}.
-     * @param baseURL - The base URL of the Mailpit API.
-     * @param auth - Optional authentication credentials.
-     * @param auth.username - The username for basic authentication.
-     * @param auth.password - The password for basic authentication.
-     * @example No Auth
-     * ```typescript
-     * const mailpit = new MailpitClient("http://localhost:8025");
-     * ```
-     * @example Basic Auth
-     * ```typescript
-     * const mailpit = new MailpitClient("http://localhost:8025", {
-     *  username: "admin",
-     *  password: "supersecret",
-     * });
-     * ```
-     */
-    constructor(baseURL, auth) {
-        this.axiosInstance = axios_1.default.create({
-            baseURL,
-            auth,
-            validateStatus: function (status) {
-                return status === 200;
-            },
-        });
-    }
-    handleRequest(request_1) {
-        return __awaiter(this, arguments, void 0, function* (request, options = { fullResponse: false }) {
-            var _a, _b, _c;
-            try {
-                const response = yield request();
-                return options.fullResponse ? response : response.data;
-            }
-            catch (error) {
-                if ((0, axios_1.isAxiosError)(error)) {
-                    const url = ((_a = error.config) === null || _a === void 0 ? void 0 : _a.url) || "UNKNOWN URL";
-                    const method = ((_c = (_b = error.config) === null || _b === void 0 ? void 0 : _b.method) === null || _c === void 0 ? void 0 : _c.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}`);
-                }
-            }
-        });
-    }
-    /**
-     * Retrieves information about the Mailpit instance.
-     *
-     * @returns Basic runtime information, message totals and latest release version.
-     * @example
-     * ```typescript
-     * const info = await mailpit.getInfo();
-     * ```
-     */
-    getInfo() {
-        return __awaiter(this, void 0, void 0, function* () {
-            return yield this.handleRequest(() => this.axiosInstance.get("/api/v1/info"));
-        });
-    }
-    /**
-     * Retrieves the configuration of the Mailpit web UI.
-     * @remarks Intended for web UI only!
-     * @returns Configuration settings
-     * @example
-     * ```typescript
-     * const config = await mailpit.getConfiguration();
-     * ```
-     */
-    getConfiguration() {
-        return __awaiter(this, void 0, void 0, function* () {
-            return yield this.handleRequest(() => this.axiosInstance.get("/api/v1/webui"));
-        });
-    }
-    /**
-     * Retrieves a summary of a specific message and marks it as read.
-     * @param id - The message database ID. Defaults to `latest` to return the latest message.
-     * @returns Message summary
-     * @example
-     * ```typescript
-     * const message = await mailpit.getMessageSummary();
-     * ```
-     */
-    getMessageSummary() {
-        return __awaiter(this, arguments, void 0, function* (id = "latest") {
-            return yield this.handleRequest(() => this.axiosInstance.get(`/api/v1/message/${id}`));
-        });
-    }
-    /**
-     * Retrieves the headers of a specific message.
-     * @remarks Header keys are returned alphabetically.
-     * @param id - The message database ID. Defaults to `latest` to return the latest message.
-     * @returns Message headers
-     * @example
-     * ```typescript
-     * const headers = await mailpit.getMessageHeaders();
-     * ```
-     */
-    getMessageHeaders() {
-        return __awaiter(this, arguments, void 0, function* (id = "latest") {
-            return yield this.handleRequest(() => this.axiosInstance.get(`/api/v1/message/${id}/headers`));
-        });
-    }
-    /**
-     * Retrieves a specific attachment from a message.
-     * @param id - Message database ID or "latest"
-     * @param partID - The attachment part ID
-     * @returns Attachment as binary data and the content type
-     * @example
-     * ```typescript
-     * const message = await mailpit.getMessageSummary();
-     * if (message.Attachments.length) {
-     *  const attachment = await mailpit.getMessageAttachment(message.ID, message.Attachments[0].PartID);
-     *  // Do something with the attachment data
-     * }
-     * ```
-     */
-    getMessageAttachment(id, partID) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const response = yield this.handleRequest(() => this.axiosInstance.get(`/api/v1/message/${id}/part/${partID}`, { responseType: "arraybuffer" }), { fullResponse: true });
-            return {
-                data: response.data,
-                contentType: response.headers["content-type"],
-            };
-        });
-    }
-    /**
-     * Generates a cropped 180x120 JPEG thumbnail of an image attachment from a message.
-     * Only image attachments are supported.
-     * @remarks
-     * If the image is smaller than 180x120 then the image is padded.
-     * If the attachment is not an image then a blank image is returned.
-     * @param id - Message database ID or "latest"
-     * @param partID - The attachment part ID
-     * @returns Image attachment thumbnail as binary data and the content type
-     * @example
-     * ```typescript
-     * const message = await mailpit.getMessageSummary();
-     * if (message.Attachments.length) {
-     *  const thumbnail = await mailpit.getAttachmentThumbnail(message.ID, message.Attachments[0].PartID);
-     *  // Do something with the thumbnail data
-     * }
-     * ```
-     */
-    getAttachmentThumbnail(id, partID) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const response = yield 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"],
-            };
-        });
-    }
-    /**
-     * Retrieves the full email message source as plain text.
-     * @param id - The message database ID. Defaults to `latest` to return the latest message.
-     * @returns Plain text message source
-     * @example
-     * ```typescript
-     * const messageSource = await mailpit.getMessageSource();
-     * ```
-     */
-    getMessageSource() {
-        return __awaiter(this, arguments, void 0, function* (id = "latest") {
-            return yield this.handleRequest(() => this.axiosInstance.get(`/api/v1/message/${id}/raw`));
-        });
-    }
-    /**
-     * Release a message via a pre-configured external SMTP server.
-     * @remarks This is only enabled if message relaying has been configured.
-     * @param id - The message database ID. Use `latest` to return the latest message.
-     * @param relayTo - Array of email addresses to relay the message to
-     * @returns Plain text "ok" response
-     * @example
-     * ```typescript
-     * const message = await mailpit.releaseMessage("latest", ["user1@example.test", "user2@example.test"]);
-     * ```
-     */
-    releaseMessage(id, relayTo) {
-        return __awaiter(this, void 0, void 0, function* () {
-            return yield this.handleRequest(() => this.axiosInstance.post(`/api/v1/message/${id}/release`, relayTo));
-        });
-    }
-    /**
-     * Sends a message
-     * @param sendReqest - The request containing the message details.
-     * @returns Response containing database messsage ID
-     * @example
-     * ```typescript
-     * await mailpit.sendMessage(
-     *  From: { Email: "user@example.test", Name: "First LastName" },
-     *  To: [{ Email: "rec@example.test", Name: "Recipient Name"}, {Email: "another@example.test"}],
-     *  Subject: "Test Email",
-     * );
-     * ```
-     */
-    sendMessage(sendReqest) {
-        return __awaiter(this, void 0, void 0, function* () {
-            return yield this.handleRequest(() => this.axiosInstance.post(`/api/v1/send`, sendReqest));
-        });
-    }
-    /**
-     * Retrieves a list of message summaries ordered from newest to oldest.
-     * @remarks Only contains the number of attachments and a snippet of the message body.
-     * @see {@link MailpitClient.getMessageSummary | getMessageSummary()} for more attachment and body details for a specific message.
-     * @param start - The pagination offset. Defaults to `0`.
-     * @param limit - The number of messages to retrieve. Defaults to `50`.
-     * @returns A list of message summaries
-     * @example
-     * ```typescript
-     * const messages = await.listMessages();
-     * ```
-     */
-    listMessages() {
-        return __awaiter(this, arguments, void 0, function* (start = 0, limit = 50) {
-            return yield this.handleRequest(() => this.axiosInstance.get(`/api/v1/messages`, { params: { start, limit } }));
-        });
-    }
-    /**
-     * Set the read status of messages.
-     * @remarks You can optionally provide an array of `IDs` **OR** a `Search` filter. If neither is  set then all messages are updated.
-     * @param readStatus - The request containing the message database IDs/search string and the read status.
-     * @param readStatus.Read - The read status to set. Defaults to `false`.
-     * @param readStatus.IDs - The optional IDs of the messages to update.
-     * @param readStatus.Search - The optional search string to filter messages.
-     * @param params - Optional parameters for defining the time zone when using the `before:` and `after:` search filters.
-     * @see {@link https://mailpit.axllent.org/docs/usage/search-filters/ | Search filters}
-     * @returns Plain text "ok" response
-     * @example
-     * ```typescript
-     * // Set all messages as unread
-     * await mailpit.setReadStatus();
-     *
-     * // Set all messages as read
-     * await mailpit.setReadStatus({ Read: true });
-     *
-     * // Set specific messages as read using IDs
-     * await mailpit.setReadStatus({ IDs: ["1", "2", "3"], Read: true });
-     *
-     * // Set specific messages as read using search
-     * await mailpit.setReadStatus({ Search: "from:example.test", Read: true });
-     *
-     * // Set specific messages as read using after: search with time zone
-     * await mailpit.setReadStatus({ Search: "after:2025-04-30", Read: true }, { tz: "America/Chicago" });
-     * ```
-     */
-    setReadStatus(readStatus, params) {
-        return __awaiter(this, void 0, void 0, function* () {
-            return yield this.handleRequest(() => this.axiosInstance.put(`/api/v1/messages`, readStatus, {
-                params,
-            }));
-        });
-    }
-    /**
-     * Delete individual or all messages.
-     * @remarks If no `IDs` are provided then all messages are deleted.
-     * @param deleteRequest - The request containing the message database IDs to delete.
-     * @returns Plain text "ok" response
-     * @example
-     * ```typescript
-     * // Delete all messages
-     * await mailpit.deleteMessages();
-     *
-     * // Delete specific messages
-     * await mailpit.deleteMessages({ IDs: ["1", "2", "3"] });
-     * ```
-     */
-    deleteMessages(deleteRequest) {
-        return __awaiter(this, void 0, void 0, function* () {
-            return yield this.handleRequest(() => this.axiosInstance.delete(`/api/v1/messages`, {
-                data: deleteRequest,
-            }));
-        });
-    }
-    /**
-     * Retrieve messages matching a search, sorted by received date (descending).
-     * @see {@link https://mailpit.axllent.org/docs/usage/search-filters/ | Search filters}
-     * @remarks Only contains the number of attachments and a snippet of the message body.
-     * @see {@link MailpitClient.getMessageSummary | getMessageSummary()} for more attachment and body details for a specific message.
-     * @param search - The search request containing the query and optional parameters.
-     * @returns A list of message summaries matching the search criteria.
-     * @example
-     * ```typescript
-     * // Search for messages from a the domain example.test
-     * const messages = await mailpit.searchMessages({query: "from:example.test"});
-     * ```
-     */
-    searchMessages(search) {
-        return __awaiter(this, void 0, void 0, function* () {
-            return yield this.handleRequest(() => this.axiosInstance.get(`/api/v1/search`, {
-                params: search,
-            }));
-        });
-    }
-    /**
-     * Delete all messages matching a search.
-     * @see {@link https://mailpit.axllent.org/docs/usage/search-filters/ | Search filters}
-     * @param search - The search request containing the query.
-     * @returns Plain text "ok" response
-     * @example
-     * ```typescript
-     * // Delete all messages from the domain example.test
-     * await mailpit.deleteMessagesBySearch({query: "from:example.test"});
-     * ```
-     */
-    deleteMessagesBySearch(search) {
-        return __awaiter(this, void 0, void 0, function* () {
-            return yield this.handleRequest(() => this.axiosInstance.delete(`/api/v1/search`, { params: search }));
-        });
-    }
-    /**
-     * Performs an HTML check on a specific message.
-     * @param id - The message database ID. Defaults to `latest` to return the latest message.
-     * @returns The summary of the message HTML checker
-     * @example
-     * ```typescript
-     * const htmlCheck = await mailpit.htmlCheck();
-     * ```
-     */
-    htmlCheck() {
-        return __awaiter(this, arguments, void 0, function* (id = "latest") {
-            return yield this.handleRequest(() => this.axiosInstance.get(`/api/v1/message/${id}/html-check`));
-        });
-    }
-    /**
-     * Performs a link check on a specific message.
-     * @param id - The message database ID. Defaults to `latest` to return the latest message.
-     * @param follow - Whether to follow links. Defaults to `false`.
-     * @returns The summary of the message Link checker.
-     * @example
-     * ```typescript
-     * const linkCheck = await mailpit.linkCheck();
-     * ```
-     */
-    linkCheck() {
-        return __awaiter(this, arguments, void 0, function* (id = "latest", follow = "false") {
-            return yield this.handleRequest(() => this.axiosInstance.get(`/api/v1/message/${id}/link-check`, { params: { follow } }));
-        });
-    }
-    /**
-     * Performs a SpamAssassin check (if enabled) on a specific message.
-     * @param id - The message database ID. Defaults to `latest` to return the latest message.
-     * @returns The SpamAssassin summary (if enabled)
-     * @example
-     * ```typescript
-     * const spamAssassinCheck = await mailpit.spamAssassinCheck();
-     * ```
-     */
-    spamAssassinCheck() {
-        return __awaiter(this, arguments, void 0, function* (id = "latest") {
-            return yield this.handleRequest(() => this.axiosInstance.get(`/api/v1/message/${id}/sa-check`));
-        });
-    }
-    /**
-     * Retrieves a list of all the unique tags.
-     * @returns All unique message tags
-     * @example
-     * ```typescript
-     * const tags = await mailpit.getTags();
-     * ```
-     */
-    getTags() {
-        return __awaiter(this, void 0, void 0, function* () {
-            return yield this.handleRequest(() => this.axiosInstance.get(`/api/v1/tags`));
-        });
-    }
-    /**
-     * Sets and removes tag(s) on message(s). This will overwrite any existing tags for selected message database IDs.
-     * @param request - The request containing the message IDs and tags. To remove all tags from a message, pass an empty `Tags` array or exclude `Tags` entirely.
-     * @remarks
-     * Tags are limited to the following characters: `a-z`, `A-Z`, `0-9`, `-`, `.`, `spaces`, and `_`, and must be a minimum of 1 character.
-     * Other characters are silently stripped from the tag.
-     * @returns Plain text "ok" response
-     * @example
-     * ```typescript
-     * // Set tags on message(s)
-     * await mailpit.setTags({ IDs: ["1", "2", "3"], Tags: ["tag1", "tag2"] });
-     * // Remove tags from message(s)
-     * await mailpit.setTags({ IDs: ["1", "2", "3"]});
-     * ```
-     */
-    setTags(request) {
-        return __awaiter(this, void 0, void 0, function* () {
-            return yield this.handleRequest(() => this.axiosInstance.put(`/api/v1/tags`, request));
-        });
-    }
-    /**
-     * Renames an existing tag.
-     * @param tag - The current name of the tag.
-     * @param newTagName - A new name for the tag.
-     * @remarks
-     * Tags are limited to the following characters: `a-z`, `A-Z`, `0-9`, `-`, `.`, `spaces`, and `_`, and must be a minimum of 1 character.
-     * Other characters are silently stripped from the tag.
-     * @returns Plain text "ok" response
-     * @example
-     * ```typescript
-     * await mailpit.renameTag("Old Tag Name", "New Tag Name");
-     * ```
-     */
-    renameTag(tag, newTagName) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const encodedTag = encodeURIComponent(tag);
-            return yield this.handleRequest(() => this.axiosInstance.put(`/api/v1/tags/${encodedTag}`, {
-                Name: newTagName,
-            }));
-        });
-    }
-    /**
-     * Deletes a tag from all messages.
-     * @param tag - The name of the tag to delete.
-     * @remarks This does NOT delete any messages
-     * @returns Plain text "ok" response
-     * ```typescript
-     * await mailpit.deleteTag("Tag 1");
-     * ```
-     */
-    deleteTag(tag) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const encodedTag = encodeURIComponent(tag);
-            return yield this.handleRequest(() => this.axiosInstance.delete(`/api/v1/tags/${encodedTag}`));
-        });
-    }
-    /**
-     * Retrieves the current Chaos triggers configuration (if enabled).
-     * @remarks This will return an error if Chaos is not enabled at runtime.
-     * @returns The Chaos triggers configuration
-     * @example
-     * ```typescript
-     * const triggers = await mailpit.getChaosTriggers();
-     * ```
-     */
-    getChaosTriggers() {
-        return __awaiter(this, void 0, void 0, function* () {
-            return yield this.handleRequest(() => this.axiosInstance.get("/api/v1/chaos"));
-        });
-    }
-    /**
-     * Sets and/or resets the Chaos triggers configuration (if enabled).
-     * @param triggers - The request containing the chaos triggers. Omitted triggers will reset to the default `0%` probabibility.
-     * @remarks This will return an error if Chaos is not enabled at runtime.
-     * @returns The updated Chaos triggers configuration
-     *  @example
-     * ```typescript
-     * // Reset all triggers to `0%` probability
-     * const triggers = await mailpit.setChaosTriggers();
-     * // Set `Sender` and reset `Authentication` and `Recipient` triggers
-     * const triggers = await mailpit.setChaosTriggers({ Sender: { ErrorCode: 451, Probability: 5 } });
-     * ```
-     */
-    setChaosTriggers() {
-        return __awaiter(this, arguments, void 0, function* (triggers = {}) {
-            return yield this.handleRequest(() => this.axiosInstance.put("/api/v1/chaos", triggers));
-        });
-    }
-    /**
-     * Renders the HTML part of a specific message which can be used for UI integration testing.
-     * @remarks
-     * Attached inline images are modified to link to the API provided they exist.
-     * If the message does not contain an HTML part then a 404 error is returned.
-     *
-     *
-     * @param id - The message database ID. Defaults to `latest` to return the latest message.
-     * @param embed - Whether this route is to be embedded in an iframe. Defaults to `undefined`. Set to `1` to embed.
-     * The `embed` parameter will add `target="_blank"` and `rel="noreferrer noopener"` to all links.
-     * In addition, a small script will be added to the end of the document to post (postMessage()) the height of the document back to the parent window for optional iframe height resizing.
-     * Note that this will also transform the message into a full HTML document (if it isn't already), so this option is useful for viewing but not programmatic testing.
-     * @returns Rendered HTML
-     * @example
-     * ```typescript
-     * const html = await mailpit.renderMessageHTML();
-     * ```
-     */
-    renderMessageHTML() {
-        return __awaiter(this, arguments, void 0, function* (id = "latest", embed) {
-            return yield this.handleRequest(() => this.axiosInstance.get(`/view/${id}.html`, { params: { embed } }));
-        });
-    }
-    /**
-     * Renders just the message's text part which can be used for UI integration testing.
-     * @param id - The message database ID. Defaults to `latest` to return the latest message.
-     * @returns Plain text
-     * @example
-     * ```typescript
-     * const html = await mailpit.renderMessageText();
-     * ```
-     */
-    renderMessageText() {
-        return __awaiter(this, arguments, void 0, function* (id = "latest") {
-            return yield this.handleRequest(() => this.axiosInstance.get(`/view/${id}.txt`));
-        });
-    }
-}
-exports.MailpitClient = MailpitClient;

package/dist/cjs/package.json

@@ -1,3 +0,0 @@
-{
-    "type": "commonjs"
-}