@zintrust/core 2.4.0 → 2.4.1

package/src/tools/mail/MailMessage.js

@@ -1,89 +0,0 @@
-import { generateUuid } from '../../common/utility.js';
-import { isNonEmptyString } from '../../helper/index.js';
-const normalizeRecipients = (to) => (Array.isArray(to) ? to : [to]);
-const trimMessageIdDomainDecorators = (value) => {
-    let start = 0;
-    let end = value.length;
-    while (start < end && value[start] === '<') {
-        start += 1;
-    }
-    while (end > start && value[end - 1] === '>') {
-        end -= 1;
-    }
-    while (end > start && value[end - 1] === '.') {
-        end -= 1;
-    }
-    return value.slice(start, end);
-};
-const resolveMessageIdDomain = (senderEmail) => {
-    const domainCandidate = senderEmail.split('@')[1]?.trim().toLowerCase() ?? '';
-    if (!isNonEmptyString(domainCandidate))
-        return 'localhost';
-    const normalizedDomain = trimMessageIdDomainDecorators(domainCandidate);
-    if (!isNonEmptyString(normalizedDomain) || !normalizedDomain.includes('.')) {
-        return normalizedDomain === '' ? 'localhost' : normalizedDomain;
-    }
-    return normalizedDomain;
-};
-export const buildRfc2822Message = (msg) => {
-    const toList = normalizeRecipients(msg.to);
-    const fromNameRaw = msg.from.name;
-    const fromName = typeof fromNameRaw === 'string' ? fromNameRaw.trim() : '';
-    const fromHeader = fromName === '' ? msg.from.email : `${fromName} <${msg.from.email}>`;
-    const toHeader = toList.join(', ');
-    const subject = msg.subject;
-    const messageId = `<${generateUuid().replaceAll('-', '')}@${resolveMessageIdDomain(msg.from.email)}>`;
-    const headers = [
-        `From: ${fromHeader}`,
-        `To: ${toHeader}`,
-        `Subject: ${subject}`,
-        `Date: ${new Date().toUTCString()}`,
-        `Message-ID: ${messageId}`,
-        'MIME-Version: 1.0',
-    ];
-    const attachParts = (attachments, innerBody) => {
-        const mixedBoundary = `mixed_${generateUuid().replaceAll('-', '')}`;
-        const lines = [];
-        lines.push(`Content-Type: multipart/mixed; boundary="${mixedBoundary}"`, '', `--${mixedBoundary}`, innerBody);
-        for (const attachment of attachments) {
-            const b64 = attachment.content.toString('base64');
-            lines.push(`--${mixedBoundary}`, `Content-Type: application/octet-stream; name="${attachment.filename}"`, 'Content-Transfer-Encoding: base64', `Content-Disposition: attachment; filename="${attachment.filename}"`, '');
-            for (let index = 0; index < b64.length; index += 76) {
-                lines.push(b64.slice(index, index + 76));
-            }
-        }
-        lines.push(`--${mixedBoundary}--`, '');
-        return lines.join('\r\n');
-    };
-    if (typeof msg.html === 'string' && msg.html !== '') {
-        const boundary = `zintrust_${generateUuid().replaceAll('-', '')}`;
-        headers.push(`Content-Type: multipart/alternative; boundary="${boundary}"`);
-        const parts = [
-            `--${boundary}`,
-            'Content-Type: text/plain; charset=utf-8',
-            'Content-Transfer-Encoding: 7bit',
-            '',
-            msg.text,
-            `--${boundary}`,
-            'Content-Type: text/html; charset=utf-8',
-            'Content-Transfer-Encoding: 7bit',
-            '',
-            msg.html,
-            `--${boundary}--`,
-            '',
-        ];
-        const inner = `${parts.join('\r\n')}`;
-        if (msg.attachments && msg.attachments.length > 0) {
-            const mixed = attachParts(msg.attachments, inner);
-            return `${headers.join('\r\n')}\r\n\r\n${mixed}`;
-        }
-        return `${headers.join('\r\n')}\r\n\r\n${inner}`;
-    }
-    if (msg.attachments && msg.attachments.length > 0) {
-        const inner = ['Content-Type: text/plain; charset=utf-8', '', msg.text, ''].join('\r\n');
-        const mixed = attachParts(msg.attachments, inner);
-        return `${headers.join('\r\n')}\r\n\r\n${mixed}`;
-    }
-    headers.push('Content-Type: text/plain; charset=utf-8');
-    return `${headers.join('\r\n')}\r\n\r\n${msg.text}\r\n`;
-};

package/src/tools/mail/attachments.d.ts

@@ -1,23 +0,0 @@
-export type DiskAttachment = {
-    disk: string;
-    path: string;
-    filename?: string;
-};
-export type InlineAttachment = {
-    content: Buffer | string;
-    filename: string;
-};
-export type AttachmentInput = DiskAttachment | InlineAttachment;
-export type ResolvedAttachment = {
-    filename: string;
-    content: Buffer;
-};
-export type StorageLike = {
-    get: (disk: string, path: string) => Promise<Buffer> | Buffer;
-    exists?: (disk: string, path: string) => Promise<boolean> | boolean;
-    url?: (disk: string, path: string) => string;
-};
-export declare function resolveAttachments(attachments: Array<AttachmentInput> | undefined, options?: {
-    storage?: StorageLike;
-}): Promise<ResolvedAttachment[]>;
-//# sourceMappingURL=attachments.d.ts.map

package/src/tools/mail/attachments.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"attachments.d.ts","sourceRoot":"","sources":["../../../../src/tools/mail/attachments.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,cAAc,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAC/E,MAAM,MAAM,gBAAgB,GAAG;IAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAC9E,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG,gBAAgB,CAAC;AAEhE,MAAM,MAAM,kBAAkB,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvE,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;IAC9D,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IACpE,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CAC9C,CAAC;AAEF,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,KAAK,CAAC,eAAe,CAAC,GAAG,SAAS,EAC/C,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,WAAW,CAAA;CAAO,GACtC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CA6B/B"}

package/src/tools/mail/attachments.js

@@ -1,26 +0,0 @@
-import { ErrorFactory } from '../../exceptions/ZintrustError.js';
-export async function resolveAttachments(attachments, options = {}) {
-    if (!attachments || attachments.length === 0)
-        return [];
-    const storage = options.storage;
-    const resolveOne = async (att) => {
-        if ('content' in att) {
-            const a = att;
-            const content = typeof a.content === 'string' ? Buffer.from(a.content) : a.content;
-            return { filename: a.filename, content };
-        }
-        // Disk-based attachment
-        const d = att;
-        if (!storage) {
-            throw ErrorFactory.createValidationError('Storage is required to resolve disk attachments');
-        }
-        const exists = storage.exists ? await Promise.resolve(storage.exists(d.disk, d.path)) : true;
-        if (!exists) {
-            throw ErrorFactory.createNotFoundError(`Attachment not found: ${d.disk}:${d.path}`);
-        }
-        const content = await Promise.resolve(storage.get(d.disk, d.path));
-        const filename = d.filename ?? d.path.split('/').pop() ?? 'attachment';
-        return { filename, content };
-    };
-    return Promise.all(attachments.map(resolveOne));
-}

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

@@ -1,5 +0,0 @@
-export declare const BaseDriver: Readonly<{
-    send(): Promise<unknown>;
-}>;
-export default BaseDriver;
-//# sourceMappingURL=BaseDriver.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"BaseDriver.d.ts","sourceRoot":"","sources":["../../../../../src/tools/mail/drivers/BaseDriver.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,UAAU;YACP,OAAO,CAAC,OAAO,CAAC;EAI9B,CAAC;AAEH,eAAe,UAAU,CAAC"}

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

@@ -1,8 +0,0 @@
-import { ErrorFactory } from '../../../exceptions/ZintrustError.js';
-export const BaseDriver = Object.freeze({
-    async send() {
-        await Promise.resolve();
-        throw ErrorFactory.createConfigError('Mail driver must implement send()');
-    },
-});
-export default BaseDriver;

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

@@ -1,13 +0,0 @@
-import { type MailMessage } from '../../mail/MailMessage';
-export type CloudflareMailConfig = {
-    driver: 'cl';
-    binding: string;
-};
-export declare const CloudflareDriver: Readonly<{
-    send(config: CloudflareMailConfig, message: MailMessage): Promise<{
-        ok: boolean;
-        messageId?: string;
-    }>;
-}>;
-export default CloudflareDriver;
-//# sourceMappingURL=Cloudflare.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Cloudflare.d.ts","sourceRoot":"","sources":["../../../../../src/tools/mail/drivers/Cloudflare.ts"],"names":[],"mappings":"AAKA,OAAO,EAAyC,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAElG,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,IAAI,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AA+IF,eAAO,MAAM,gBAAgB;iBAEjB,oBAAoB,WACnB,WAAW,GACnB,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;EA8B/C,CAAC;AAEH,eAAe,gBAAgB,CAAC"}

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

@@ -1,112 +0,0 @@
-import { RemoteSignedJson } from '../../../common/RemoteSignedJson.js';
-import { Cloudflare } from '../../../config/cloudflare.js';
-import { Env } from '../../../config/env.js';
-import { ErrorFactory } from '../../../exceptions/ZintrustError.js';
-import { buildRfc2822Message } from '../../mail/MailMessage.js';
-const MAIL_PROXY_KEY_ID_ENV = 'MAIL_CLOUDFLARE_PROXY_KEY_ID';
-const MAIL_PROXY_SECRET_ENV = ['MAIL_CLOUDFLARE_PROXY', 'SECRET'].join('_');
-const APP_KEY_ID_ENV = 'APP_NAME';
-const APP_SECRET_ENV = ['APP', 'KEY'].join('_');
-const createMissingMailProxyCredentialsMessage = () => {
-    return `Cloudflare mail proxy signing credentials are missing (${MAIL_PROXY_KEY_ID_ENV} / ${MAIL_PROXY_SECRET_ENV}). Fallbacks: ${APP_KEY_ID_ENV} and ${APP_SECRET_ENV}.`;
-};
-const resolveSigningPrefix = (baseUrl) => {
-    try {
-        const parsed = new URL(baseUrl);
-        const path = parsed.pathname.endsWith('/') ? parsed.pathname.slice(0, -1) : parsed.pathname;
-        if (path === '' || path === '/')
-            return undefined;
-        return path;
-    }
-    catch {
-        return undefined;
-    }
-};
-const normalizeRecipients = (to) => (Array.isArray(to) ? to : [to]);
-const shouldUseProxy = () => Env.get('MAIL_CLOUDFLARE_PROXY_URL', '').trim() !== '';
-const createRemoteConfig = () => {
-    const baseUrl = Env.get('MAIL_CLOUDFLARE_PROXY_URL', '');
-    const timeoutMs = Env.getInt('MAIL_CLOUDFLARE_PROXY_TIMEOUT_MS', Env.getInt('ZT_PROXY_TIMEOUT_MS', Env.REQUEST_TIMEOUT));
-    return {
-        baseUrl,
-        keyId: Env.get('MAIL_CLOUDFLARE_PROXY_KEY_ID', ''),
-        secret: Env.get('MAIL_CLOUDFLARE_PROXY_SECRET', ''),
-        timeoutMs,
-        signaturePathPrefixToStrip: resolveSigningPrefix(baseUrl),
-        missingUrlMessage: 'Cloudflare mail proxy URL is missing (MAIL_CLOUDFLARE_PROXY_URL)',
-        missingCredentialsMessage: createMissingMailProxyCredentialsMessage(),
-        messages: {
-            unauthorized: 'Cloudflare mail proxy unauthorized',
-            forbidden: 'Cloudflare mail proxy forbidden',
-            rateLimited: 'Cloudflare mail proxy rate limited',
-            rejected: 'Cloudflare mail proxy rejected request',
-            error: 'Cloudflare mail proxy error',
-            timedOut: 'Cloudflare mail proxy request timed out',
-        },
-    };
-};
-const serializeMessage = (message) => ({
-    to: message.to,
-    from: message.from,
-    subject: message.subject,
-    text: message.text,
-    html: message.html,
-    attachments: message.attachments?.map((attachment) => ({
-        filename: attachment.filename,
-        contentBase64: attachment.content.toString('base64'),
-    })),
-});
-const sendViaProxy = async (config, message) => {
-    const response = await RemoteSignedJson.request(createRemoteConfig(), '/zin/mail/cloudflare/send', {
-        binding: config.binding,
-        message: serializeMessage(message),
-    });
-    return {
-        ok: response.ok === true,
-        messageId: response.messageId,
-    };
-};
-const resolveBinding = (config) => {
-    const env = Cloudflare.getWorkersEnv();
-    if (env === null) {
-        throw ErrorFactory.createConfigError('Cloudflare mail driver requires a Cloudflare Workers runtime with a send_email binding');
-    }
-    const candidateNames = [config.binding, 'SEND_EMAIL', 'SEB'].filter((name, index, all) => name.trim() !== '' && all.indexOf(name) === index);
-    for (const name of candidateNames) {
-        const binding = env[name];
-        if (binding !== undefined && typeof binding.send === 'function')
-            return binding;
-    }
-    throw ErrorFactory.createConfigError(`Cloudflare mail binding not found. Set MAIL_CLOUDFLARE_BINDING to a Wrangler send_email binding name (tried: ${candidateNames.join(', ')})`);
-};
-const importCloudflareEmail = async () => {
-    try {
-        return (await import('cloudflare:email'));
-    }
-    catch {
-        throw ErrorFactory.createConfigError('Cloudflare mail driver could not load the cloudflare:email runtime API');
-    }
-};
-export const CloudflareDriver = Object.freeze({
-    async send(config, message) {
-        const from = message.from.email.trim();
-        if (from === '') {
-            throw ErrorFactory.createConfigError('Cloudflare mail driver requires from.email');
-        }
-        const recipients = normalizeRecipients(message.to)
-            .map((recipient) => recipient.trim())
-            .filter((recipient) => recipient !== '');
-        if (recipients.length === 0) {
-            throw ErrorFactory.createConfigError('Cloudflare mail driver requires at least one recipient');
-        }
-        if (shouldUseProxy()) {
-            return sendViaProxy(config, message);
-        }
-        const binding = resolveBinding(config);
-        const { EmailMessage } = await importCloudflareEmail();
-        const raw = buildRfc2822Message(message);
-        await Promise.all(recipients.map(async (recipient) => binding.send(new EmailMessage(from, recipient, raw))));
-        return { ok: true };
-    },
-});
-export default CloudflareDriver;

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

@@ -1,31 +0,0 @@
-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

@@ -1 +0,0 @@
-{"version":3,"file":"Mailgun.d.ts","sourceRoot":"","sources":["../../../../../src/tools/mail/drivers/Mailgun.ts"],"names":[],"mappings":"AAGA,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;EA2D5E,CAAC;AAEH,eAAe,aAAa,CAAC"}

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

@@ -1,82 +0,0 @@
-import { tracedFetch } from '../../../common/ExternalServiceUtils.js';
-import { ErrorFactory } from '../../../exceptions/ZintrustError.js';
-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 tracedFetch(url, {
-            method: 'POST',
-            headers: {
-                Authorization: auth,
-            },
-            body: form,
-        }, { source: 'mailgun' });
-        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

@@ -1,29 +0,0 @@
-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

@@ -1 +0,0 @@
-{"version":3,"file":"SendGrid.d.ts","sourceRoot":"","sources":["../../../../../src/tools/mail/drivers/SendGrid.ts"],"names":[],"mappings":"AAIA,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;EAwE7E,CAAC;AAEH,eAAe,cAAc,CAAC"}

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

@@ -1,59 +0,0 @@
-import { MIME_TYPES } from '../../../config/constants.js';
-import { tracedFetch } from '../../../common/ExternalServiceUtils.js';
-import { ErrorFactory } from '../../../exceptions/ZintrustError.js';
-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: MIME_TYPES.TEXT, value: message.text },
-        ];
-        if (typeof message.html === 'string' && message.html !== '') {
-            content.push({ type: MIME_TYPES.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 tracedFetch('https://api.sendgrid.com/v3/mail/send', {
-            method: 'POST',
-            headers: {
-                Authorization: `Bearer ${config.apiKey}`,
-                'content-type': MIME_TYPES.JSON,
-            },
-            body: JSON.stringify(body),
-        }, { source: 'sendgrid' });
-        // 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

@@ -1,24 +0,0 @@
-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

@@ -1 +0,0 @@
-{"version":3,"file":"Ses.d.ts","sourceRoot":"","sources":["../../../../../src/tools/mail/drivers/Ses.ts"],"names":[],"mappings":"AAIA,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;EAoDxE,CAAC;AAEH,eAAe,SAAS,CAAC"}

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

@@ -1,117 +0,0 @@
-import { readEnvString, tracedFetch } from '../../../common/ExternalServiceUtils.js';
-import { AwsSigV4 } from '../../../common/index.js';
-import { ErrorFactory } from '../../../exceptions/ZintrustError.js';
-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 = readEnvString('AWS_ACCESS_KEY_ID');
-    const secretAccessKey = readEnvString('AWS_SECRET_ACCESS_KEY');
-    const sessionToken = readEnvString('AWS_SESSION_TOKEN') ?? undefined;
-    if (accessKeyId.length === 0 || secretAccessKey.length === 0) {
-        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 tracedFetch(url, {
-            method: 'POST',
-            headers,
-            body: bodyJson,
-        }, { source: 'ses' });
-        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;