@zintrust/core 0.4.17 → 0.4.18

package/src/tools/http/HttpResponse.ts

@@ -1,118 +0,0 @@
-/**
- * HttpResponse - Response wrapper with utility methods
- * Provides convenient access to response status, headers, body, and parsed JSON
- */
-
-import { ErrorFactory } from '@exceptions/ZintrustError';
-
-/**
- * HTTP Response interface for convenience methods
- */
-export interface IHttpResponse {
-  status: number;
-  headers: Record<string, string>;
-  body: string;
-  json<T = unknown>(): T;
-  text(): string;
-  ok: boolean;
-  successful: boolean;
-  failed: boolean;
-  serverError: boolean;
-  clientError: boolean;
-  header(name: string): string | undefined;
-  hasHeader(name: string): boolean;
-  throwIfServerError(): IHttpResponse;
-  throwIfClientError(): IHttpResponse;
-}
-
-/**
- * Create HTTP response from fetch Response
- */
-export const createHttpResponse = (response: Response, body: string): IHttpResponse => {
-  const statusCode = response.status;
-  const headers = Object.fromEntries(response.headers.entries());
-  const lowerHeaders = Object.fromEntries(
-    Object.entries(headers).map(([key, value]) => [key.toLowerCase(), value])
-  );
-
-  return {
-    get status(): number {
-      return statusCode;
-    },
-
-    get headers(): Record<string, string> {
-      return headers;
-    },
-
-    get body(): string {
-      return body;
-    },
-
-    json<T = unknown>(): T {
-      try {
-        return JSON.parse(body) as T;
-      } catch (error) {
-        throw ErrorFactory.createValidationError('Failed to parse JSON response', {
-          body: body.substring(0, 200), // Truncate for logging
-          error: error instanceof Error ? error.message : String(error),
-        });
-      }
-    },
-
-    text(): string {
-      return body;
-    },
-
-    get ok(): boolean {
-      return response.ok;
-    },
-
-    get successful(): boolean {
-      return statusCode >= 200 && statusCode < 300;
-    },
-
-    get failed(): boolean {
-      return !this.successful;
-    },
-
-    get serverError(): boolean {
-      return statusCode >= 500;
-    },
-
-    get clientError(): boolean {
-      return statusCode >= 400 && statusCode < 500;
-    },
-
-    header(name: string): string | undefined {
-      return lowerHeaders[name.toLowerCase()];
-    },
-
-    hasHeader(name: string): boolean {
-      return name.toLowerCase() in lowerHeaders;
-    },
-
-    throwIfServerError(): IHttpResponse {
-      if (this.serverError) {
-        throw ErrorFactory.createTryCatchError(`HTTP server error: ${this.status}`, {
-          status: this.status,
-          body: this.body.substring(0, 200),
-        });
-      }
-      return this;
-    },
-
-    throwIfClientError(): IHttpResponse {
-      if (this.clientError) {
-        throw ErrorFactory.createTryCatchError(`HTTP client error: ${this.status}`, {
-          status: this.status,
-          body: this.body.substring(0, 200),
-        });
-      }
-      return this;
-    },
-  };
-};
-
-export default {
-  createHttpResponse,
-};

package/src/tools/http/index.ts

@@ -1,11 +0,0 @@
-/**
- * HTTP Client Tools - Export all HTTP utilities
- */
-
-import { HttpClient } from '@httpClient/Http';
-import { createHttpResponse } from '@httpClient/HttpResponse';
-
-export default Object.freeze({
-  HttpClient,
-  createHttpResponse,
-});

package/src/tools/mail/Mail.ts

@@ -1 +0,0 @@
-export { default, Mail } from '@mail/index';

package/src/tools/mail/MailDriverRegistry.ts

@@ -1,34 +0,0 @@
-export type MailSendHandler = (
-  config: unknown,
-  message: unknown
-) => Promise<{ ok: boolean; messageId?: string }>;
-
-const registry = new Map<string, MailSendHandler>();
-
-function register(driver: string, handler: MailSendHandler): void {
-  registry.set(driver, handler);
-}
-
-function get(driver: string): MailSendHandler | undefined {
-  return registry.get(driver);
-}
-
-function has(driver: string): boolean {
-  return registry.has(driver);
-}
-
-function list(): string[] {
-  return Array.from(registry.keys());
-}
-
-function reset(): void {
-  registry.clear();
-}
-
-export const MailDriverRegistry = Object.freeze({
-  register,
-  get,
-  has,
-  list,
-  reset,
-});

package/src/tools/mail/attachments.ts

@@ -1,47 +0,0 @@
-import { ErrorFactory } from '@exceptions/ZintrustError';
-
-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 async function resolveAttachments(
-  attachments: Array<AttachmentInput> | undefined,
-  options: { storage?: StorageLike } = {}
-): Promise<ResolvedAttachment[]> {
-  if (!attachments || attachments.length === 0) return [];
-
-  const storage = options.storage;
-
-  const resolveOne = async (att: AttachmentInput): Promise<ResolvedAttachment> => {
-    if ('content' in (att as InlineAttachment)) {
-      const a = att as InlineAttachment;
-      const content = typeof a.content === 'string' ? Buffer.from(a.content) : a.content;
-      return { filename: a.filename, content };
-    }
-
-    // Disk-based attachment
-    const d = att as DiskAttachment;
-    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.ts

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

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

@@ -1,130 +0,0 @@
-import { ErrorFactory } from '@exceptions/ZintrustError';
-
-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;
-};
-
-const normalizeRecipients = (to: string | string[]): string[] => (Array.isArray(to) ? to : [to]);
-
-const base64 = (value: string): string => Buffer.from(value, 'utf8').toString('base64');
-
-const toArrayBuffer = (buf: Buffer): ArrayBuffer => {
-  const ab = new ArrayBuffer(buf.byteLength);
-  new Uint8Array(ab).set(buf);
-  return ab;
-};
-
-const normalizeBaseUrl = (value?: string): string => {
-  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: MailgunConfig
-): Required<Pick<MailgunConfig, 'apiKey' | 'domain'>> & {
-  baseUrl: string;
-} => {
-  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: MailMessage): void => {
-  if (message.from.email.trim() === '') {
-    throw ErrorFactory.createConfigError('Mail: missing from.email');
-  }
-};
-
-export const MailgunDriver = Object.freeze({
-  async send(config: MailgunConfig, message: MailMessage): Promise<SendResult> {
-    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()) as Record<string, unknown>;
-        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.ts

@@ -1,103 +0,0 @@
-import { MIME_TYPES } from '@/config/constants';
-import { ErrorFactory } from '@exceptions/ZintrustError';
-
-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;
-};
-
-const normalizeRecipients = (to: string | string[]): string[] => (Array.isArray(to) ? to : [to]);
-
-export const SendGridDriver = Object.freeze({
-  async send(config: SendGridConfig, message: MailMessage): Promise<SendResult> {
-    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: Array<{ type: string; value: string }> = [
-      { type: MIME_TYPES.TEXT, value: message.text },
-    ];
-    if (typeof message.html === 'string' && message.html !== '') {
-      content.push({ type: MIME_TYPES.HTML, value: message.html });
-    }
-
-    type SendGridAttachment = { content: string; filename: string };
-
-    const body: {
-      personalizations: Array<Record<string, unknown>>;
-      from: { email: string; name?: string };
-      subject: string;
-      content: Array<{ type: string; value: string }>;
-      attachments?: SendGridAttachment[];
-    } = {
-      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': MIME_TYPES.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.ts

@@ -1,179 +0,0 @@
-import { readEnvString } from '@common/ExternalServiceUtils';
-import { AwsSigV4 } from '@common/index';
-import { ErrorFactory } from '@exceptions/ZintrustError';
-
-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;
-};
-
-const sha256Hex = (data: string | Uint8Array): string => AwsSigV4.sha256Hex(data);
-
-const buildAuthorization = (params: {
-  method: string;
-  host: string;
-  region: string;
-  amzDate: string;
-  dateStamp: string;
-  credentials: { accessKeyId: string; secretAccessKey: string; sessionToken?: string };
-  body: string;
-  path: string;
-}): { authorization: string; signedHeaders: string } => {
-  const canonicalUri = params.path;
-  const canonicalQueryString = '';
-
-  const headers: Record<string, string> = {
-    '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: SesConfig): string => {
-  const region = typeof config.region === 'string' ? config.region.trim() : '';
-  if (region === '') throw ErrorFactory.createConfigError('SES: missing region in config');
-  return region;
-};
-
-const ensureCredentials = (): {
-  accessKeyId: string;
-  secretAccessKey: string;
-  sessionToken?: string;
-} => {
-  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: MailMessage): string => {
-  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: string,
-  authorization: string,
-  sessionToken?: string
-): Record<string, string> => {
-  const headers: Record<string, string> = {
-    '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: SesConfig, message: MailMessage): Promise<SendResult> {
-    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()) as Record<string, unknown>;
-        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;