@8ms/helpers 2.3.5 → 2.3.6

package/aws/ses/server/SimpleEmail.d.ts

@@ -1,81 +0,0 @@
-import { BaseClass } from "../../../_class";
-type AttachmentSource = {
-    filename: string;
-    contentType?: string;
-    data?: string;
-    url?: string;
-};
-type ConstructorProps = {
-    bcc?: string[];
-    cc?: string[];
-    from?: string;
-    html?: string;
-    subject?: string;
-    to?: string | string[];
-    attachments?: AttachmentSource[];
-};
-/**
- * Class to build and send an AWS SES email.
- */
-export declare class SimpleEmail extends BaseClass {
-    from?: string;
-    to: string[];
-    cc: string[];
-    bcc: string[];
-    html?: string;
-    subject?: string;
-    attachments: AttachmentSource[];
-    constructor({ bcc, cc, from, html, subject, to, attachments }: ConstructorProps);
-    setFrom: (from: string) => this;
-    setHtml: (html: string) => this;
-    setSubject: (subject: string) => this;
-    setAttachments: (attachments: AttachmentSource[]) => this;
-    addAttachment: (attachment: AttachmentSource) => this;
-    addAttachmentFromdata: (filename: string, data: string, contentType?: string) => this;
-    addAttachmentFromUrl: (filename: string, url: string, contentType?: string) => this;
-    clearAttachments: () => this;
-    pushBcc: (recipient: string | string[]) => this;
-    pushCc: (recipient: string | string[]) => this;
-    pushTo: (recipient: string | string[]) => this;
-    setBcc: (recipient: string | string[]) => this;
-    setCc: (recipient: string | string[]) => this;
-    setTo: (recipient: string | string[]) => this;
-    getSendParam: () => Promise<{
-        Destinations: string[];
-        RawMessage: {
-            Data: string;
-        };
-        Source: string;
-    } | {
-        Destination: {
-            BccAddresses: string[];
-            CcAddresses: string[];
-            ToAddresses: string[];
-        };
-        Message: {
-            Body: {
-                Html: {
-                    Charset: string;
-                    Data: string;
-                };
-                Text: {
-                    Charset: string;
-                    Data: string;
-                };
-            };
-            Subject: {
-                Charset: string;
-                Data: string;
-            };
-        };
-        Source: string;
-    }>;
-    private _getRawEmailParams;
-    private _isTextFile;
-    private _getAttachmentTextData;
-    private _getAttachmentData;
-    private _isBase64;
-    private _getContentTypeFromFilename;
-    private _filterRecipients;
-}
-export {};

package/aws/ses/server/SimpleEmail.js

@@ -1,296 +0,0 @@
-import uniq from "lodash/uniq";
-import { BaseClass } from "../../../_class";
-/**
- * Class to build and send an AWS SES email.
- */
-export class SimpleEmail extends BaseClass {
-    from;
-    to = [];
-    cc = [];
-    bcc = [];
-    html;
-    subject;
-    attachments = [];
-    constructor({ bcc, cc, from, html, subject, to, attachments }) {
-        super();
-        if (bcc) {
-            this.setBcc(bcc);
-        }
-        if (cc) {
-            this.setCc(cc);
-        }
-        if (from) {
-            this.setFrom(from);
-        }
-        if (html) {
-            this.setHtml(html);
-        }
-        if (subject) {
-            this.setSubject(subject);
-        }
-        if (to) {
-            this.setTo(to);
-        }
-        if (attachments) {
-            this.setAttachments(attachments);
-        }
-        return this;
-    }
-    setFrom = (from) => {
-        return this._setValue("from", from);
-    };
-    setHtml = (html) => {
-        return this._setValue("html", html);
-    };
-    setSubject = (subject) => {
-        return this._setValue("subject", subject);
-    };
-    setAttachments = (attachments) => {
-        return this._setValue("attachments", attachments);
-    };
-    addAttachment = (attachment) => {
-        this.attachments.push(attachment);
-        return this;
-    };
-    addAttachmentFromdata = (filename, data, contentType) => {
-        return this.addAttachment({
-            filename,
-            data,
-            contentType: contentType || this._getContentTypeFromFilename(filename)
-        });
-    };
-    addAttachmentFromUrl = (filename, url, contentType) => {
-        return this.addAttachment({
-            filename,
-            url,
-            contentType: contentType || this._getContentTypeFromFilename(filename)
-        });
-    };
-    clearAttachments = () => {
-        this.attachments = [];
-        return this;
-    };
-    pushBcc = (recipient) => {
-        return this._push("bcc", recipient);
-    };
-    pushCc = (recipient) => {
-        return this._push("cc", recipient);
-    };
-    pushTo = (recipient) => {
-        return this._push("to", recipient);
-    };
-    setBcc = (recipient) => {
-        return this._setArray("bcc", recipient);
-    };
-    setCc = (recipient) => {
-        return this._setArray("cc", recipient);
-    };
-    setTo = (recipient) => {
-        return this._setArray("to", recipient);
-    };
-    getSendParam = async () => {
-        // For emails with attachments, we need to use SendRawEmail instead of SendEmail
-        if (this.attachments.length > 0) {
-            return await this._getRawEmailParams();
-        }
-        // https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/ses-examples-sending-email.html
-        const params = {
-            Destination: {
-                BccAddresses: this._filterRecipients("bcc"),
-                CcAddresses: this._filterRecipients("cc"),
-                ToAddresses: this._filterRecipients("to"),
-            },
-            Message: {
-                Body: {
-                    Html: {
-                        Charset: "UTF-8",
-                        Data: this.html,
-                    },
-                    Text: {
-                        Charset: "UTF-8",
-                        Data: this.html,
-                    },
-                },
-                Subject: {
-                    Charset: "UTF-8",
-                    Data: this.subject,
-                },
-            },
-            Source: this.from,
-        };
-        return params;
-    };
-    _getRawEmailParams = async () => {
-        const boundary = `----=_NextPart_${Date.now()}_${Math.random()
-            .toString(36)
-            .substr(2, 9)}`;
-        // Build recipients list
-        const allRecipients = [
-            ...this._filterRecipients("to"),
-            ...this._filterRecipients("cc"),
-            ...this._filterRecipients("bcc")
-        ];
-        // Build email headers
-        let rawMessage = "";
-        rawMessage += `From: ${this.from}\r\n`;
-        if (this._filterRecipients("to").length > 0) {
-            rawMessage += `To: ${this._filterRecipients("to")
-                .join(", ")}\r\n`;
-        }
-        if (this._filterRecipients("cc").length > 0) {
-            rawMessage += `Cc: ${this._filterRecipients("cc")
-                .join(", ")}\r\n`;
-        }
-        rawMessage += `Subject: ${this.subject}\r\n`;
-        rawMessage += `MIME-Version: 1.0\r\n`;
-        rawMessage += `Content-Type: multipart/mixed; boundary="${boundary}"\r\n\r\n`;
-        // Add HTML body
-        rawMessage += `--${boundary}\r\n`;
-        rawMessage += `Content-Type: text/html; charset=UTF-8\r\n`;
-        rawMessage += `Content-Transfer-Encoding: 7bit\r\n\r\n`;
-        rawMessage += `${this.html}\r\n\r\n`;
-        // Add attachments
-        for (const attachment of this.attachments) {
-            const isTextFile = this._isTextFile(attachment.contentType || this._getContentTypeFromFilename(attachment.filename));
-            rawMessage += `--${boundary}\r\n`;
-            rawMessage += `Content-Type: ${attachment.contentType || "application/octet-stream"}\r\n`;
-            rawMessage += `Content-Disposition: attachment; filename="${attachment.filename}"\r\n`;
-            if (isTextFile) {
-                rawMessage += `Content-Transfer-Encoding: 7bit\r\n\r\n`;
-                const textData = await this._getAttachmentTextData(attachment);
-                rawMessage += `${textData}\r\n\r\n`;
-            }
-            else {
-                rawMessage += `Content-Transfer-Encoding: base64\r\n\r\n`;
-                const attachmentData = await this._getAttachmentData(attachment);
-                rawMessage += `${attachmentData}\r\n\r\n`;
-            }
-        }
-        rawMessage += `--${boundary}--\r\n`;
-        return {
-            Destinations: allRecipients,
-            RawMessage: {
-                Data: rawMessage
-            },
-            Source: this.from
-        };
-    };
-    _isTextFile = (contentType) => {
-        const textTypes = [
-            "text/csv",
-            "text/plain",
-            "text/html",
-            "application/json",
-            "application/xml",
-            "text/xml"
-        ];
-        return textTypes.some(type => contentType.startsWith(type));
-    };
-    _getAttachmentTextData = async (attachment) => {
-        // If data is already provided as base64, decode it first
-        if (attachment.data) {
-            // Remove data URL prefix if present (e.g., "data:text/csv;base64,")
-            const base64Data = attachment.data.replace(/^data:[^;]+;base64,/, "");
-            // Check if it's actually base64 encoded
-            if (this._isBase64(base64Data)) {
-                return Buffer.from(base64Data, "base64")
-                    .toString("utf-8");
-            }
-            // If not base64, assume it's already plain text
-            return attachment.data;
-        }
-        // If URL is provided, fetch the data as text
-        if (attachment.url) {
-            const fetch = await import("node-fetch").then(mod => mod.default);
-            const response = await fetch(attachment.url);
-            return await response.text();
-        }
-        throw new Error(`No valid data source provided for attachment: ${attachment.filename}`);
-    };
-    _getAttachmentData = async (attachment) => {
-        // If data is already provided as base64
-        if (attachment.data) {
-            // Remove data URL prefix if present (e.g., "data:image/png;base64,")
-            const cleanData = attachment.data.replace(/^data:[^;]+;base64,/, "");
-            // Check if it's actually base64 encoded
-            if (this._isBase64(cleanData)) {
-                return cleanData;
-            }
-            // If not base64, encode it
-            return Buffer.from(attachment.data, "utf-8")
-                .toString("base64");
-        }
-        // If URL is provided, fetch the data
-        if (attachment.url) {
-            const fetch = await import("node-fetch").then(mod => mod.default);
-            const response = await fetch(attachment.url);
-            const buffer = await response.buffer();
-            return buffer.toString("base64");
-        }
-        throw new Error(`No valid data source provided for attachment: ${attachment.filename}`);
-    };
-    _isBase64 = (str) => {
-        try {
-            return Buffer.from(str, "base64")
-                .toString("base64") === str;
-        }
-        catch {
-            return false;
-        }
-    };
-    _getContentTypeFromFilename = (filename) => {
-        const extension = filename.split(".")
-            .pop()
-            ?.toLowerCase();
-        const mimeTypes = {
-            // Images
-            "jpg": "image/jpeg",
-            "jpeg": "image/jpeg",
-            "png": "image/png",
-            "gif": "image/gif",
-            "svg": "image/svg+xml",
-            "webp": "image/webp",
-            "bmp": "image/bmp",
-            "ico": "image/x-icon",
-            // Documents
-            "pdf": "application/pdf",
-            "doc": "application/msword",
-            "docx": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
-            "xls": "application/vnd.ms-excel",
-            "xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
-            "ppt": "application/vnd.ms-powerpoint",
-            "pptx": "application/vnd.openxmlformats-officedocument.presentationml.presentation",
-            // Data
-            "csv": "text/csv",
-            "tsv": "text/tab-separated-values",
-            "json": "application/json",
-            "xml": "application/xml",
-            "txt": "text/plain",
-            // Archives
-            "zip": "application/zip",
-            "rar": "application/x-rar-compressed",
-            "7z": "application/x-7z-compressed",
-            "tar": "application/x-tar",
-            "gz": "application/gzip",
-            // Audio/Video
-            "mp3": "audio/mpeg",
-            "wav": "audio/wav",
-            "mp4": "video/mp4",
-            "avi": "video/x-msvideo",
-            "mov": "video/quicktime",
-        };
-        return mimeTypes[extension || ""] || "application/octet-stream";
-    };
-    _filterRecipients = (field) => {
-        // Remove all undefined and null values
-        let response = this[field].filter(recipient => recipient && null !== recipient);
-        // Clean all the values
-        response = response.map(recipient => recipient.toLowerCase()
-            .trim());
-        // Remove all empty values
-        response = response.filter(recipient => "" !== recipient);
-        // Return only unique values
-        response = uniq(response);
-        return response;
-    };
-}

package/aws/ses/server/awsSes.d.ts

@@ -1,4 +0,0 @@
-import { AwsSesNamespace } from "./AwsSesNamespace";
-import { AwsConfig } from "../../server";
-export declare const awsSesClient: (key?: string, config?: AwsConfig, vaultId?: string, itemId?: string) => Promise<AwsSesNamespace>;
-export { SimpleEmail } from "./SimpleEmail";

package/aws/ses/server/awsSes.js

@@ -1,13 +0,0 @@
-import { AwsSesNamespace } from "./AwsSesNamespace";
-import { getConfig } from "../../server";
-const awsSesNamespaces = new Map();
-export const awsSesClient = async (key = "default", config, vaultId, itemId) => {
-    if (awsSesNamespaces.has(key)) {
-        return awsSesNamespaces.get(key);
-    }
-    const instanceConfig = await getConfig(key, config, vaultId, itemId);
-    const namespace = new AwsSesNamespace(key, instanceConfig);
-    awsSesNamespaces.set(key, namespace);
-    return namespace;
-};
-export { SimpleEmail } from "./SimpleEmail";

package/aws/ses/server/index.d.ts

@@ -1,3 +0,0 @@
-export * from "./awsSes";
-export * from "./AwsSesNamespace";
-export * from "./SimpleEmail";

package/aws/ses/server/index.js

@@ -1,3 +0,0 @@
-export * from "./awsSes";
-export * from "./AwsSesNamespace";
-export * from "./SimpleEmail";

package/aws/sqs/server/AwsSqsNamespace.d.ts

@@ -1,34 +0,0 @@
-import { BaseNamespace } from "../../../_class";
-import { AwsConfig } from "../../server";
-import type { SQSClient } from "@aws-sdk/client-sqs";
-type SqsEventRecord = {
-    messageId: string;
-    receiptHandle: string;
-    body: any;
-    attributes: object;
-    messageAttributes: object;
-    md5OfMessageAttributes: string;
-    md5OfBody: string;
-    eventSource: string;
-    eventSourceARN: string;
-    awsRegion: string;
-};
-type SqsEvent = {
-    Records: SqsEventRecord[];
-};
-type AddToQueue = {
-    data: any;
-    dedupeId: string;
-    groupId?: string;
-    queueId?: string;
-    queueUrl: string;
-};
-export declare class AwsSqsNamespace extends BaseNamespace {
-    client: SQSClient;
-    config: AwsConfig;
-    ensureInit: () => Promise<void>;
-    addToQueue: (props: AddToQueue) => Promise<import("@aws-sdk/client-sqs").SendMessageCommandOutput>;
-    deleteFromQueue: (queueUrl: string, recipientHandle: string) => Promise<import("@aws-sdk/client-sqs").DeleteMessageCommandOutput>;
-    isEventSqs: (event: SqsEvent) => Promise<boolean>;
-}
-export {};

package/aws/sqs/server/AwsSqsNamespace.js

@@ -1,55 +0,0 @@
-import { BaseNamespace } from "../../../_class";
-export class AwsSqsNamespace extends BaseNamespace {
-    ensureInit = async () => {
-        if (!this.client) {
-            try {
-                const { SQSClient } = await import("@aws-sdk/client-sqs");
-                this.client = new SQSClient(this.config);
-            }
-            catch (e) {
-                throw new Error("AWS SQS Client not installed");
-            }
-        }
-    };
-    addToQueue = async (props) => {
-        await this.ensureInit();
-        const { SendMessageCommand } = await import("@aws-sdk/client-sqs");
-        let params = {
-            MessageBody: JSON.stringify({
-                queueId: props.queueId,
-                data: props.data,
-            }),
-            QueueUrl: props.queueUrl,
-        };
-        // Required for FIFO
-        if (undefined !== props?.dedupeId) {
-            params["MessageDeduplicationId"] = props.dedupeId;
-        }
-        // Required for FIFO
-        if (undefined !== props?.groupId) {
-            params["MessageGroupId"] = props.dedupeId;
-        }
-        const sendData = await this.client.send(new SendMessageCommand(params));
-        return sendData;
-    };
-    deleteFromQueue = async (queueUrl, recipientHandle) => {
-        await this.ensureInit();
-        const { DeleteMessageCommand } = await import("@aws-sdk/client-sqs");
-        const params = {
-            QueueUrl: queueUrl,
-            ReceiptHandle: recipientHandle,
-        };
-        const sendData = await this.client.send(new DeleteMessageCommand(params));
-        return sendData;
-    };
-    isEventSqs = async (event) => {
-        await this.ensureInit();
-        let response = false;
-        if (undefined !== event["Records"]) {
-            for (let i = 0; i < event['Records'].length; i++) {
-                // todo: Complete
-            }
-        }
-        return response;
-    };
-}

package/aws/sqs/server/awsSqs.d.ts

@@ -1,3 +0,0 @@
-import { AwsSqsNamespace } from "./AwsSqsNamespace";
-import { AwsConfig } from "../../server";
-export declare const awsSqsClient: (key?: string, config?: AwsConfig, vaultId?: string, itemId?: string) => Promise<AwsSqsNamespace>;

package/aws/sqs/server/awsSqs.js

@@ -1,12 +0,0 @@
-import { AwsSqsNamespace } from "./AwsSqsNamespace";
-import { getConfig } from "../../server";
-const awsSqsNamespaces = new Map();
-export const awsSqsClient = async (key = "default", config, vaultId, itemId) => {
-    if (awsSqsNamespaces.has(key)) {
-        return awsSqsNamespaces.get(key);
-    }
-    const instanceConfig = await getConfig(key, config, vaultId, itemId);
-    const namespace = new AwsSqsNamespace(key, instanceConfig);
-    awsSqsNamespaces.set(key, namespace);
-    return namespace;
-};

package/aws/sqs/server/index.d.ts

@@ -1,2 +0,0 @@
-export * from "./awsSqs";
-export * from "./AwsSqsNamespace";

package/aws/sqs/server/index.js

@@ -1,2 +0,0 @@
-export * from "./awsSqs";
-export * from "./AwsSqsNamespace";

package/aws/ssm/server/AwsSsmNamespace.d.ts

@@ -1,11 +0,0 @@
-import { BaseNamespace } from "../../../_class";
-import { AwsConfig } from "../../server";
-import type { SSMClient } from "@aws-sdk/client-ssm";
-export declare class AwsSsmNamespace extends BaseNamespace {
-    client: SSMClient;
-    config: AwsConfig;
-    parameters: Map<string, any>;
-    constructor(key: string, config: any);
-    ensureInit: () => Promise<void>;
-    getParameter: (name: string, withDecryption?: boolean, isJson?: boolean) => Promise<any>;
-}

package/aws/ssm/server/AwsSsmNamespace.js

@@ -1,52 +0,0 @@
-import { BaseNamespace } from "../../../_class";
-export class AwsSsmNamespace extends BaseNamespace {
-    parameters;
-    constructor(key, config) {
-        super(key, config);
-        this.parameters = new Map();
-    }
-    ensureInit = async () => {
-        if (!this.client) {
-            try {
-                const { SSMClient } = await import("@aws-sdk/client-ssm");
-                this.client = new SSMClient(this.config);
-            }
-            catch (e) {
-                throw new Error("AWS SSM Client not installed");
-            }
-        }
-    };
-    getParameter = async (name, withDecryption = false, isJson = true) => {
-        await this.ensureInit();
-        if (!this.parameters.has(name)) {
-            const { GetParameterCommand } = await import("@aws-sdk/client-ssm");
-            const apiResponse = await this.client.send(new GetParameterCommand({
-                Name: name,
-                WithDecryption: undefined === withDecryption ? true : withDecryption,
-            }));
-            if (apiResponse.Parameter.Value) {
-                // Value is undefined
-                if (undefined === apiResponse.Parameter.Value) {
-                    this.parameters.set(name, null);
-                }
-                // Value is defined
-                else {
-                    // isJson is default - decode
-                    if (undefined === isJson || true === isJson) {
-                        this.parameters.set(name, JSON.parse(apiResponse.Parameter.Value) || null);
-                    }
-                    // Not JSON don't decode
-                    else {
-                        this.parameters.set(name, apiResponse.Parameter.Value);
-                    }
-                }
-            }
-            // Value not found (null so it can be sent from server to front end)
-            else {
-                this.parameters.set(name, null);
-            }
-        }
-        // Return the loaded result
-        return this.parameters.get(name);
-    };
-}

package/aws/ssm/server/awsSsm.d.ts

@@ -1,3 +0,0 @@
-import { AwsSsmNamespace } from "./AwsSsmNamespace";
-import { AwsConfig } from "../../server";
-export declare const awsSsmClient: (key?: string, config?: AwsConfig, vaultId?: string, itemId?: string) => Promise<AwsSsmNamespace>;

package/aws/ssm/server/awsSsm.js

@@ -1,12 +0,0 @@
-import { AwsSsmNamespace } from "./AwsSsmNamespace";
-import { getConfig } from "../../server";
-const awsSsmNamespaces = new Map();
-export const awsSsmClient = async (key = "default", config, vaultId, itemId) => {
-    if (awsSsmNamespaces.has(key)) {
-        return awsSsmNamespaces.get(key);
-    }
-    const instanceConfig = await getConfig(key, config, vaultId, itemId);
-    const namespace = new AwsSsmNamespace(key, instanceConfig);
-    awsSsmNamespaces.set(key, namespace);
-    return namespace;
-};

package/aws/ssm/server/index.d.ts

@@ -1,2 +0,0 @@
-export * from "./awsSsm";
-export * from "./AwsSsmNamespace";

package/aws/ssm/server/index.js

@@ -1,2 +0,0 @@
-export * from "./awsSsm";
-export * from "./AwsSsmNamespace";

package/axios/deleteRequest.d.ts

@@ -1,6 +0,0 @@
-import { ApiResponseClass } from "../api";
-/**
- * Make a DELETE request.
- * Can't use the function name delete as it's reserved
- */
-export declare const deleteRequest: (url: string, config?: {}) => Promise<ApiResponseClass>;

package/axios/deleteRequest.js

@@ -1,26 +0,0 @@
-import axios from "axios";
-import { ApiResponseClass } from "../api";
-/**
- * Make a DELETE request.
- * Can't use the function name delete as it's reserved
- */
-export const deleteRequest = async (url, config = {}) => {
-    const response = await axios.delete(url, config)
-        .then(async (response) => {
-        // Is API response
-        if (undefined !== response.data.body && undefined !== response.data.error && undefined !== response.data.state) {
-            return new ApiResponseClass(response.data);
-        }
-        // General success - some APIs report 201
-        else if (response.status >= 200 && response.status <= 299) {
-            return (new ApiResponseClass()).setToSuccess(response.data);
-        }
-        // Error
-        return (new ApiResponseClass()).setToError(response.data, response.statusText);
-    })
-        .catch(error => {
-        // Error
-        return (new ApiResponseClass()).setToError(null, error.message);
-    });
-    return response;
-};

package/axios/get.d.ts

@@ -1,5 +0,0 @@
-import { ApiResponseClass } from "../api";
-/**
- * Make a GET request.
- */
-export declare const get: (url: string, config?: {}) => Promise<ApiResponseClass>;