@file-viewer/renderer-email 2.4.0 → 3.0.1

package/dist/email.d.ts

@@ -1,2 +1,29 @@
 import type { FileRenderContext, FileViewerRenderedInstance } from '@file-viewer/core';
+type EmailKind = 'eml' | 'msg' | 'mbox';
+interface EmailAddress {
+    name?: string;
+    address?: string;
+}
+interface EmailAttachmentView {
+    id: string;
+    name: string;
+    mimeType?: string;
+    size: number;
+    contentId?: string;
+    load(): Promise<ArrayBuffer>;
+}
+export interface ParsedEmailView {
+    kind: EmailKind;
+    subject: string;
+    from: EmailAddress[];
+    to: EmailAddress[];
+    cc: EmailAddress[];
+    date?: string;
+    text?: string;
+    html?: string;
+    headers?: string;
+    attachments: EmailAttachmentView[];
+}
+export declare const parseEml: (buffer: ArrayBuffer, filename: string, objectUrls: string[], cidUrls: Map<string, string>) => Promise<ParsedEmailView>;
 export default function renderEmail(buffer: ArrayBuffer, target: HTMLDivElement, type?: string, context?: FileRenderContext): Promise<FileViewerRenderedInstance>;
+export {};

package/dist/email.js

@@ -123,7 +123,9 @@ const createPostalAttachments = (email, objectUrls, cidUrls) => {
         cidUrls.set(normalizeContentId(attachment.contentId), url);
     })).then(() => attachments);
 };
-const parseEml = async (buffer, filename, objectUrls, cidUrls) => {
+// Exported for the package-local #232 regression gate (verify-github-232.mjs); it
+// stays out of the public exports map, so the shipped API surface is unchanged.
+export const parseEml = async (buffer, filename, objectUrls, cidUrls) => {
     var _a, _b;
     const PostalMime = (await import('postal-mime')).default;
     const email = await PostalMime.parse(buffer, {
@@ -265,6 +267,9 @@ export default async function renderEmail(buffer, target, type = 'eml', context)
     const darkMode = resolveFileViewerColorScheme((_d = context === null || context === void 0 ? void 0 : context.options) === null || _d === void 0 ? void 0 : _d.theme, systemDark) === 'dark';
     const cleanups = [];
     let nestedRendered;
+    let attachmentPreviewVersion = 0;
+    let attachmentAbortController;
+    let disposed = false;
     let overlay = null;
     let errorElement = null;
     const root = createElement('section', 'email-viewer');
@@ -395,6 +400,18 @@ export default async function renderEmail(buffer, target, type = 'eml', context)
             });
         };
         const previewAttachment = async (attachment) => {
+            var _a, _b, _c;
+            const previewVersion = ++attachmentPreviewVersion;
+            attachmentAbortController === null || attachmentAbortController === void 0 ? void 0 : attachmentAbortController.abort();
+            const previewAbortController = new AbortController();
+            attachmentAbortController = previewAbortController;
+            const abortFromParent = () => { var _a; return previewAbortController.abort((_a = context === null || context === void 0 ? void 0 : context.signal) === null || _a === void 0 ? void 0 : _a.reason); };
+            if ((_a = context === null || context === void 0 ? void 0 : context.signal) === null || _a === void 0 ? void 0 : _a.aborted) {
+                abortFromParent();
+            }
+            else {
+                (_b = context === null || context === void 0 ? void 0 : context.signal) === null || _b === void 0 ? void 0 : _b.addEventListener('abort', abortFromParent, { once: true });
+            }
             activeAttachment = attachment;
             syncAttachmentState();
             attachmentPreview.hidden = false;
@@ -408,22 +425,37 @@ export default async function renderEmail(buffer, target, type = 'eml', context)
                 attachmentTarget.append(child);
                 const extension = getAttachmentExtension(attachment.name);
                 if (context === null || context === void 0 ? void 0 : context.renderNestedBuffer) {
-                    nestedRendered = await context.renderNestedBuffer(attachmentBuffer, extension, child, {
+                    const nextRendered = await context.renderNestedBuffer(attachmentBuffer, extension, child, {
                         ...context,
                         filename: attachment.name,
                         options: context.options,
+                        signal: previewAbortController.signal,
                     });
+                    if (disposed || previewVersion !== attachmentPreviewVersion || previewAbortController.signal.aborted) {
+                        await disposeFileViewerRendered(nextRendered);
+                        return;
+                    }
+                    nestedRendered = nextRendered;
                 }
                 else {
                     child.append(createElement('div', undefined, t('email.attachments.nestedUnavailable', { name: attachment.name })));
                 }
             }
             catch (nextError) {
+                if (disposed || previewVersion !== attachmentPreviewVersion || previewAbortController.signal.aborted) {
+                    return;
+                }
                 console.error(nextError);
                 showError(nextError instanceof Error ? nextError.message : String(nextError));
             }
             finally {
-                hideLoading();
+                (_c = context === null || context === void 0 ? void 0 : context.signal) === null || _c === void 0 ? void 0 : _c.removeEventListener('abort', abortFromParent);
+                if (attachmentAbortController === previewAbortController) {
+                    attachmentAbortController = undefined;
+                }
+                if (!disposed && previewVersion === attachmentPreviewVersion) {
+                    hideLoading();
+                }
             }
         };
         parsed.attachments.forEach(attachment => {
@@ -466,6 +498,10 @@ export default async function renderEmail(buffer, target, type = 'eml', context)
     return {
         $el: root,
         async unmount() {
+            disposed = true;
+            attachmentPreviewVersion += 1;
+            attachmentAbortController === null || attachmentAbortController === void 0 ? void 0 : attachmentAbortController.abort();
+            attachmentAbortController = undefined;
             await clearAttachmentPreview();
             cleanups.splice(0).forEach(cleanup => cleanup());
             objectUrls.forEach(url => URL.revokeObjectURL(url));

package/file-viewer.capability.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "../../../ecosystem/capability-manifest.schema.json",
+  "schemaVersion": 1,
+  "id": "email",
+  "packageName": "@file-viewer/renderer-email",
+  "rendererIds": ["email"],
+  "formats": ["eml", "msg", "mbox"],
+  "assets": { "rendererIds": [] },
+  "license": { "spdx": "Apache-2.0", "policy": "permissive" },
+  "weight": "light",
+  "profiles": ["standard", "all"]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@file-viewer/renderer-email",
-  "version": "2.4.0",
+  "version": "3.0.1",
   "private": false,
   "type": "module",
   "description": "Standalone email renderer plugin for File Viewer with EML, MSG, MBOX, attachments, and nested previews.",
@@ -50,21 +50,27 @@
   },
   "files": [
     "dist",
+    "file-viewer.capability.json",
     "README.md",
     "README.en.md",
     "LICENSE"
   ],
   "dependencies": {
-    "@file-viewer/core": "2.4.0",
+    "@file-viewer/core": "3.0.1",
     "@kenjiuno/msgreader": "^1.28.0",
-    "postal-mime": "^2.7.4"
+    "buffer": "^6.0.3",
+    "postal-mime": "^3.0.0"
   },
   "devDependencies": {
     "typescript": "^6.0.3"
   },
+  "fileViewer": {
+    "capabilityManifest": "./file-viewer.capability.json"
+  },
   "license": "Apache-2.0",
   "scripts": {
     "build": "tsc -b tsconfig.json",
-    "type-check": "tsc -b tsconfig.json"
+    "type-check": "tsc -b tsconfig.json",
+    "verify:github-232": "pnpm --filter @file-viewer/core build && pnpm build && node scripts/verify-github-232.mjs"
   }
 }