@zintrust/core 0.1.1 → 0.1.3

package/src/tools/mail/drivers/Mailgun.d.ts

@@ -0,0 +1,31 @@
+export type MailgunConfig = {
+    apiKey: string;
+    domain: string;
+    baseUrl?: string;
+};
+export type MailAddress = {
+    email: string;
+    name?: string;
+};
+export type MailAttachment = {
+    filename: string;
+    content: Buffer;
+};
+export type MailMessage = {
+    to: string | string[];
+    from: MailAddress;
+    subject: string;
+    text: string;
+    html?: string;
+    attachments?: MailAttachment[];
+};
+export type SendResult = {
+    ok: boolean;
+    provider: 'mailgun';
+    messageId?: string;
+};
+export declare const MailgunDriver: Readonly<{
+    send(config: MailgunConfig, message: MailMessage): Promise<SendResult>;
+}>;
+export default MailgunDriver;
+//# sourceMappingURL=Mailgun.d.ts.map

package/src/tools/mail/drivers/Mailgun.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Mailgun.d.ts","sourceRoot":"","sources":["../../../../../src/tools/mail/drivers/Mailgun.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnE,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACtB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,cAAc,EAAE,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,SAAS,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AA2CF,eAAO,MAAM,aAAa;iBACL,aAAa,WAAW,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;EAuD5E,CAAC;AAEH,eAAe,aAAa,CAAC"}

package/src/tools/mail/drivers/Mailgun.js

@@ -0,0 +1,81 @@
+import { ErrorFactory } from '../../../exceptions/ZintrustError';
+const normalizeRecipients = (to) => (Array.isArray(to) ? to : [to]);
+const base64 = (value) => Buffer.from(value, 'utf8').toString('base64');
+const toArrayBuffer = (buf) => {
+    const ab = new ArrayBuffer(buf.byteLength);
+    new Uint8Array(ab).set(buf);
+    return ab;
+};
+const normalizeBaseUrl = (value) => {
+    let v = (value ?? '').trim();
+    if (v === '')
+        return 'https://api.mailgun.net';
+    // Avoid regex backtracking (Sonar S5852) by trimming trailing slashes in linear time.
+    while (v.endsWith('/'))
+        v = v.slice(0, -1);
+    return v;
+};
+const ensureConfig = (config) => {
+    const apiKey = (config.apiKey ?? '').trim();
+    const domain = (config.domain ?? '').trim();
+    const baseUrl = normalizeBaseUrl(config.baseUrl);
+    if (apiKey === '')
+        throw ErrorFactory.createConfigError('Mailgun: missing MAILGUN_API_KEY');
+    if (domain === '')
+        throw ErrorFactory.createConfigError('Mailgun: missing MAILGUN_DOMAIN');
+    return { apiKey, domain, baseUrl };
+};
+const ensureMessage = (message) => {
+    if (message.from.email.trim() === '') {
+        throw ErrorFactory.createConfigError('Mail: missing from.email');
+    }
+};
+export const MailgunDriver = Object.freeze({
+    async send(config, message) {
+        const { apiKey, domain, baseUrl } = ensureConfig(config);
+        ensureMessage(message);
+        const url = `${baseUrl}/v3/${encodeURIComponent(domain)}/messages`;
+        const form = new FormData();
+        const fromName = (message.from.name ?? '').trim();
+        const from = fromName === '' ? message.from.email : `${fromName} <${message.from.email}>`;
+        form.set('from', from);
+        form.set('to', normalizeRecipients(message.to).join(','));
+        form.set('subject', message.subject);
+        form.set('text', message.text);
+        if (typeof message.html === 'string' && message.html !== '') {
+            form.set('html', message.html);
+        }
+        if (message.attachments && message.attachments.length > 0) {
+            for (const a of message.attachments) {
+                // In Node.js, Buffer is a Uint8Array, which works as a BlobPart.
+                // In other runtimes, callers typically won't supply Buffer attachments.
+                const blob = new Blob([toArrayBuffer(a.content)]);
+                form.append('attachment', blob, a.filename);
+            }
+        }
+        const auth = `Basic ${base64('api:' + apiKey)}`;
+        const res = await fetch(url, {
+            method: 'POST',
+            headers: {
+                Authorization: auth,
+            },
+            body: form,
+        });
+        if (res.ok) {
+            try {
+                const json = (await res.json());
+                const id = typeof json?.['id'] === 'string' ? json['id'] : undefined;
+                return { ok: true, provider: 'mailgun', messageId: id };
+            }
+            catch {
+                return { ok: true, provider: 'mailgun' };
+            }
+        }
+        const text = await res.text();
+        throw ErrorFactory.createConnectionError(`Mailgun send failed (${res.status})`, {
+            status: res.status,
+            body: text,
+        });
+    },
+});
+export default MailgunDriver;

package/src/tools/mail/drivers/SendGrid.d.ts

@@ -0,0 +1,29 @@
+export type SendGridConfig = {
+    apiKey: string;
+};
+export type MailAddress = {
+    email: string;
+    name?: string;
+};
+export type MailAttachment = {
+    filename: string;
+    content: Buffer;
+};
+export type MailMessage = {
+    to: string | string[];
+    from: MailAddress;
+    subject: string;
+    text: string;
+    html?: string;
+    attachments?: MailAttachment[];
+};
+export type SendResult = {
+    ok: boolean;
+    provider: 'sendgrid';
+    messageId?: string;
+};
+export declare const SendGridDriver: Readonly<{
+    send(config: SendGridConfig, message: MailMessage): Promise<SendResult>;
+}>;
+export default SendGridDriver;
+//# sourceMappingURL=SendGrid.d.ts.map

package/src/tools/mail/drivers/SendGrid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SendGrid.d.ts","sourceRoot":"","sources":["../../../../../src/tools/mail/drivers/SendGrid.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnE,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACtB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,cAAc,EAAE,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,UAAU,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAIF,eAAO,MAAM,cAAc;iBACN,cAAc,WAAW,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;EAoE7E,CAAC;AAEH,eAAe,cAAc,CAAC"}

package/src/tools/mail/drivers/SendGrid.js

@@ -0,0 +1,57 @@
+import { ErrorFactory } from '../../../exceptions/ZintrustError';
+const normalizeRecipients = (to) => (Array.isArray(to) ? to : [to]);
+export const SendGridDriver = Object.freeze({
+    async send(config, message) {
+        if (config.apiKey.trim() === '') {
+            throw ErrorFactory.createConfigError('SendGrid: missing SENDGRID_API_KEY');
+        }
+        if (message.from.email.trim() === '') {
+            throw ErrorFactory.createConfigError('Mail: missing from.email');
+        }
+        const personalizations = [
+            {
+                to: normalizeRecipients(message.to).map((email) => ({ email })),
+            },
+        ];
+        const content = [
+            { type: 'text/plain', value: message.text },
+        ];
+        if (typeof message.html === 'string' && message.html !== '') {
+            content.push({ type: 'text/html', value: message.html });
+        }
+        const body = {
+            personalizations,
+            from: {
+                email: message.from.email,
+                name: message.from.name?.trim() === '' ? undefined : message.from.name,
+            },
+            subject: message.subject,
+            content,
+        };
+        if (message.attachments && message.attachments.length > 0) {
+            body.attachments = message.attachments.map((a) => ({
+                content: a.content.toString('base64'),
+                filename: a.filename,
+            }));
+        }
+        const res = await fetch('https://api.sendgrid.com/v3/mail/send', {
+            method: 'POST',
+            headers: {
+                Authorization: `Bearer ${config.apiKey}`,
+                'content-type': 'application/json',
+            },
+            body: JSON.stringify(body),
+        });
+        // SendGrid typically returns 202 for success.
+        if (res.status === 202) {
+            const messageId = res.headers.get('x-message-id') ?? undefined;
+            return { ok: true, provider: 'sendgrid', messageId };
+        }
+        const text = await res.text();
+        throw ErrorFactory.createConnectionError(`SendGrid send failed (${res.status})`, {
+            status: res.status,
+            body: text,
+        });
+    },
+});
+export default SendGridDriver;

package/src/tools/mail/drivers/Ses.d.ts

@@ -0,0 +1,24 @@
+export type SesConfig = {
+    region: string;
+};
+export type MailAddress = {
+    email: string;
+    name?: string;
+};
+export type MailMessage = {
+    to: string | string[];
+    from: MailAddress;
+    subject: string;
+    text: string;
+    html?: string;
+};
+export type SendResult = {
+    ok: boolean;
+    provider: 'ses';
+    messageId?: string;
+};
+export declare const SesDriver: Readonly<{
+    send(config: SesConfig, message: MailMessage): Promise<SendResult>;
+}>;
+export default SesDriver;
+//# sourceMappingURL=Ses.d.ts.map

package/src/tools/mail/drivers/Ses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Ses.d.ts","sourceRoot":"","sources":["../../../../../src/tools/mail/drivers/Ses.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,SAAS,GAAG;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACtB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,KAAK,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAsGF,eAAO,MAAM,SAAS;iBACD,SAAS,WAAW,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;EAgDxE,CAAC;AAEH,eAAe,SAAS,CAAC"}

package/src/tools/mail/drivers/Ses.js

@@ -0,0 +1,116 @@
+import { AwsSigV4 } from '../../../common/index';
+import { ErrorFactory } from '../../../exceptions/ZintrustError';
+const sha256Hex = (data) => AwsSigV4.sha256Hex(data);
+const buildAuthorization = (params) => {
+    const canonicalUri = params.path;
+    const canonicalQueryString = '';
+    const headers = {
+        'content-type': 'application/json',
+        host: params.host,
+        'x-amz-date': params.amzDate,
+    };
+    if (params.credentials.sessionToken !== null && params.credentials.sessionToken !== undefined) {
+        headers['x-amz-security-token'] = params.credentials.sessionToken;
+    }
+    const payloadHash = sha256Hex(params.body);
+    return AwsSigV4.buildAuthorization({
+        method: params.method,
+        canonicalUri,
+        canonicalQueryString,
+        headers,
+        payloadHash,
+        region: params.region,
+        service: 'ses',
+        amzDate: params.amzDate,
+        dateStamp: params.dateStamp,
+        credentials: params.credentials,
+    });
+};
+const ensureRegion = (config) => {
+    const region = typeof config.region === 'string' ? config.region.trim() : '';
+    if (region === '')
+        throw ErrorFactory.createConfigError('SES: missing region in config');
+    return region;
+};
+const ensureCredentials = () => {
+    const accessKeyId = process.env['AWS_ACCESS_KEY_ID'] ?? '';
+    const secretAccessKey = process.env['AWS_SECRET_ACCESS_KEY'] ?? '';
+    const sessionToken = process.env['AWS_SESSION_TOKEN'] ?? undefined;
+    if (accessKeyId.trim() === '' || secretAccessKey.trim() === '') {
+        throw ErrorFactory.createConfigError('SES: missing AWS credentials (set AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY)');
+    }
+    return { accessKeyId, secretAccessKey, sessionToken };
+};
+const buildBody = (message) => {
+    const toAddresses = Array.isArray(message.to) ? message.to : [message.to];
+    const body = {
+        FromEmailAddress: message.from.email,
+        Destination: { ToAddresses: toAddresses },
+        Content: {
+            Simple: {
+                Subject: { Data: message.subject },
+                Body: {
+                    Text: { Data: message.text },
+                    ...(typeof message.html === 'string' && message.html !== ''
+                        ? { Html: { Data: message.html } }
+                        : {}),
+                },
+            },
+        },
+    };
+    return JSON.stringify(body);
+};
+const buildHeaders = (amzDate, authorization, sessionToken) => {
+    const headers = {
+        'content-type': 'application/json',
+        'x-amz-date': amzDate,
+        Authorization: authorization,
+    };
+    if (typeof sessionToken === 'string' && sessionToken !== '')
+        headers['x-amz-security-token'] = sessionToken;
+    return headers;
+};
+export const SesDriver = Object.freeze({
+    async send(config, message) {
+        const region = ensureRegion(config);
+        const { accessKeyId, secretAccessKey, sessionToken } = ensureCredentials();
+        const bodyJson = buildBody(message);
+        const host = `email.${region}.amazonaws.com`;
+        const path = '/v2/email/outbound-emails';
+        const url = `https://${host}${path}`;
+        const now = new Date();
+        const { amzDate, dateStamp } = AwsSigV4.toAmzDate(now);
+        const { authorization } = buildAuthorization({
+            method: 'POST',
+            host: host,
+            region,
+            amzDate,
+            dateStamp,
+            credentials: { accessKeyId, secretAccessKey, sessionToken },
+            body: bodyJson,
+            path,
+        });
+        const headers = buildHeaders(amzDate, authorization, sessionToken);
+        const res = await fetch(url, {
+            method: 'POST',
+            headers,
+            body: bodyJson,
+        });
+        if (res.ok) {
+            try {
+                const json = (await res.json());
+                const messageId = typeof json?.['MessageId'] === 'string' ? json['MessageId'] : undefined;
+                return { ok: true, provider: 'ses', messageId };
+            }
+            catch {
+                return { ok: true, provider: 'ses' };
+            }
+        }
+        const text = await res.text();
+        throw ErrorFactory.createConnectionError(`SES send failed (${res.status})`, {
+            status: res.status,
+            body: text,
+        });
+    },
+});
+export default SesDriver;

package/src/tools/mail/drivers/Smtp.d.ts

@@ -0,0 +1,38 @@
+export type SmtpConfig = {
+    host: string;
+    port: number;
+    username?: string;
+    password?: string;
+    secure?: boolean | 'starttls';
+};
+export type MailAddress = {
+    email: string;
+    name?: string;
+};
+export type MailAttachment = {
+    filename: string;
+    content: Buffer;
+};
+export type MailMessage = {
+    to: string | string[];
+    from: MailAddress;
+    subject: string;
+    text: string;
+    html?: string;
+    attachments?: MailAttachment[];
+};
+export type SendResult = {
+    ok: boolean;
+    provider: 'smtp';
+    messageId?: string;
+};
+export declare const SmtpDriver: Readonly<{
+    /**
+     * NOTE: This is a minimal SMTP implementation intended for Node.js runtimes.
+     * - `secure=true` means TLS from the start (SMTPS).
+     * - `secure='starttls'` performs STARTTLS after EHLO.
+     */
+    send(config: SmtpConfig, message: MailMessage): Promise<SendResult>;
+}>;
+export default SmtpDriver;
+//# sourceMappingURL=Smtp.d.ts.map

package/src/tools/mail/drivers/Smtp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Smtp.d.ts","sourceRoot":"","sources":["../../../../../src/tools/mail/drivers/Smtp.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnE,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACtB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,cAAc,EAAE,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AA0XF,eAAO,MAAM,UAAU;IACrB;;;;OAIG;iBACgB,UAAU,WAAW,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;EAgDzE,CAAC;AAEH,eAAe,UAAU,CAAC"}