@wtfalch/email 0.4.1 → 0.6.0

package/dist/mailbox/react/save.js

@@ -0,0 +1,42 @@
+/**
+ * Handing a blob to the browser as a file.
+ *
+ * Its own module, and in the react folder rather than beside `download.ts`,
+ * because this half is pure DOM: `download.ts` fetches bytes and runs
+ * anywhere, this needs a `document`. Splitting them keeps the fetch testable
+ * in Node and keeps an application that wants to do its own saving — write to
+ * a directory handle, open in a viewer, upload somewhere else — able to take
+ * the bytes and skip this.
+ */
+/**
+ * Save a blob under a filename.
+ *
+ * **The object URL is revoked on a timer, not immediately.** Revoking in the
+ * same tick as the click cancels the download in Chrome and Safari: the
+ * anchor's activation is queued, and by the time the browser reads the URL it
+ * has already been released. A tick is the usual fix and is still a race; a
+ * minute is not, and an object URL is a pointer to memory the page already
+ * holds, so holding it a little longer costs nothing.
+ *
+ * **The anchor is not appended in Firefox's case only.** A detached anchor's
+ * click is ignored there, so it goes into the document and comes straight
+ * back out, which is invisible and works everywhere.
+ */
+export function saveBlob(blob, name) {
+    if (typeof document === 'undefined') {
+        throw new Error('saveBlob needs a document; call it from the browser');
+    }
+    const url = URL.createObjectURL(blob);
+    const anchor = document.createElement('a');
+    anchor.href = url;
+    /* A filename with a path separator in it is a filename a server chose, and
+       browsers vary in how much of it they honour. Only the last segment is
+       ever a name. */
+    anchor.download = name.split(/[\\/]/).pop() || 'attachment';
+    anchor.rel = 'noopener';
+    anchor.style.display = 'none';
+    document.body.appendChild(anchor);
+    anchor.click();
+    anchor.remove();
+    window.setTimeout(() => URL.revokeObjectURL(url), 60_000);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wtfalch/email",
-  "version": "0.4.1",
+  "version": "0.6.0",
   "description": "The wtfalch estate: reading a mailbox over JMAP, and administering the Stalwart server it lives on. Two entries with no code in common.",
   "license": "MIT",
   "type": "module",
@@ -42,7 +42,7 @@
     "record-fixtures": "node scripts/record-fixtures.mjs"
   },
   "peerDependencies": {
-    "@wtfalch/design": ">=0.4.0",
+    "@wtfalch/design": ">=0.5.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
@@ -61,7 +61,7 @@
     "@types/node": "^22",
     "@types/react": "^19",
     "@types/react-dom": "^19",
-    "@wtfalch/design": "^0.4.0",
+    "@wtfalch/design": "^0.7.0",
     "jsdom": "^30.0.1",
     "react": "^19",
     "react-dom": "^19",