@serve.zone/coremail 1.0.0

package/ts/coremail.log.ts

@@ -0,0 +1,21 @@
+import * as plugins from './plugins.js';
+
+export const coreMailLogger = plugins.smartlog.Smartlog.createForCommitinfo({
+  name: '@serve.zone/coremail',
+  version: '1.0.0',
+  description:
+    'Authenticated mail persistence and delivery orchestration for serve.zone workloads.',
+});
+
+coreMailLogger.enableConsole();
+
+export const logCoreMailFailure = async (
+  componentArg: 'desired-state' | 'gateway' | 'retention' | 'transfer' | 'worker',
+  codeArg: string,
+): Promise<void> => {
+  await coreMailLogger.log(
+    'warn',
+    'CoreMail background operation failed.',
+    { component: componentArg, code: codeArg },
+  );
+};

package/ts/coremail.mime.ts

@@ -0,0 +1,94 @@
+import * as plugins from './plugins.js';
+import type { ISubmissionPartRecord } from './interfaces.js';
+
+type TMessage = plugins.serveZoneInterfaces.data.ICoreMailOutboundMessageDescriptor;
+
+const encodeHeaderText = (valueArg: string): string =>
+  /^[\x20-\x7e]*$/.test(valueArg)
+    ? valueArg
+    : `=?UTF-8?B?${Buffer.from(valueArg, 'utf8').toString('base64')}?=`;
+
+const formatMailbox = (
+  mailboxArg: plugins.serveZoneInterfaces.data.ICoreMailMailbox,
+): string => {
+  if (!mailboxArg.displayName) {
+    return `<${mailboxArg.address}>`;
+  }
+  const displayName = encodeHeaderText(mailboxArg.displayName);
+  const rendered = /^[A-Za-z0-9 ._-]+$/.test(displayName)
+    ? displayName
+    : `"${displayName.replaceAll('\\', '\\\\').replaceAll('"', '\\"')}"`;
+  return `${rendered} <${mailboxArg.address}>`;
+};
+
+const foldBase64 = (bytesArg: Uint8Array): string =>
+  Buffer.from(bytesArg)
+    .toString('base64')
+    .match(/.{1,76}/g)
+    ?.join('\r\n') ?? '';
+
+const contentDisposition = (partArg: ISubmissionPartRecord): string => {
+  if (partArg.kind !== 'attachment') {
+    return 'inline';
+  }
+  if (!partArg.filename) {
+    return 'attachment';
+  }
+  const fallback = partArg.filename
+    .replace(/[^\x20-\x7e]/g, '_')
+    .replaceAll('\\', '\\\\')
+    .replaceAll('"', '\\"');
+  return `attachment; filename="${fallback}"; filename*=UTF-8''${
+    encodeURIComponent(partArg.filename)
+  }`;
+};
+
+export const createCoreMailMime = (
+  submissionIdArg: string,
+  submissionDigestArg: plugins.serveZoneInterfaces.data.TCoreMailSha256,
+  createdAtArg: number,
+  messageArg: TMessage,
+  partsArg: Array<{ descriptor: ISubmissionPartRecord; bytes: Uint8Array }>,
+): Uint8Array => {
+  const boundary = `coremail_${submissionDigestArg.slice('sha256:'.length, 48)}`;
+  const to = messageArg.recipients.to.map(formatMailbox).join(', ');
+  const cc = messageArg.recipients.cc?.map(formatMailbox).join(', ');
+  const headers = [
+    `Date: ${new Date(createdAtArg).toUTCString()}`,
+    `Message-ID: <${submissionIdArg}@coremail.serve.zone>`,
+    `From: ${formatMailbox(messageArg.sender)}`,
+    `To: ${to}`,
+    ...(cc ? [`Cc: ${cc}`] : []),
+    ...(messageArg.replyTo ? [`Reply-To: ${formatMailbox(messageArg.replyTo)}`] : []),
+    `Subject: ${encodeHeaderText(messageArg.subject)}`,
+    ...(messageArg.headers ?? []).map((headerArg) =>
+      `${headerArg.name}: ${encodeHeaderText(headerArg.value)}`
+    ),
+    'MIME-Version: 1.0',
+    `Content-Type: multipart/mixed; boundary="${boundary}"`,
+    '',
+    'This is a multipart message in MIME format.',
+  ];
+  for (const part of partsArg) {
+    headers.push(
+      `--${boundary}`,
+      `Content-Type: ${part.descriptor.contentType}`,
+      'Content-Transfer-Encoding: base64',
+      `Content-Disposition: ${contentDisposition(part.descriptor)}`,
+      ...(part.descriptor.contentId
+        ? [`Content-ID: <${part.descriptor.contentId}>`]
+        : []),
+      '',
+      foldBase64(part.bytes),
+    );
+  }
+  headers.push(`--${boundary}--`, '');
+  const encoded = new TextEncoder().encode(headers.join('\r\n'));
+  if (
+    encoded.byteLength >
+    plugins.serveZoneInterfaces.data.coreMailLimits.serializedMimeBytes
+  ) {
+    throw new Error('CoreMail serialized MIME exceeds its byte budget.');
+  }
+  return encoded;
+};