@numoteq/emdash-plugin-jetemail 0.2.0 → 0.3.0

package/dist/client.d.mts

@@ -4,6 +4,11 @@ interface JetEmailSender {
   fromName: string;
   fromEmail: string;
 }
+interface JetEmailAttachment {
+  filename: string;
+  /** Raw bytes (Uint8Array or Node Buffer) or a base64 string. */
+  content: Uint8Array | string;
+}
 interface JetEmailMessage {
   to: string | string[];
   cc?: string[];
@@ -11,6 +16,7 @@ interface JetEmailMessage {
   subject: string;
   text?: string;
   html?: string;
+  attachments?: JetEmailAttachment[];
 }
 type FetchFn = (url: string, init?: RequestInit) => Promise<Response>;
 declare function formatSender(name: string, email: string): string;
@@ -18,4 +24,4 @@ declare function deliverWithJetEmail(fetchFn: FetchFn, sender: JetEmailSender, m
   id?: string;
 }>;
 //#endregion
-export { FetchFn, JetEmailMessage, JetEmailSender, deliverWithJetEmail, formatSender };
+export { FetchFn, JetEmailAttachment, JetEmailMessage, JetEmailSender, deliverWithJetEmail, formatSender };

package/dist/client.mjs

@@ -3,6 +3,12 @@ const API_URL = "https://api.jetemail.com/email";
 function formatSender(name, email) {
 	return `${name.replace(/[<>"\r\n]/g, "").trim()} <${email}>`;
 }
+function toBase64(content) {
+	if (typeof content === "string") return content;
+	let binary = "";
+	for (let i = 0; i < content.length; i += 32768) binary += String.fromCharCode(...content.subarray(i, i + 32768));
+	return btoa(binary);
+}
 async function deliverWithJetEmail(fetchFn, sender, message) {
 	const body = {
 		from: formatSender(sender.fromName, sender.fromEmail),
@@ -13,6 +19,10 @@ async function deliverWithJetEmail(fetchFn, sender, message) {
 	if (message.html) body.html = message.html;
 	if (message.cc?.length) body.cc = message.cc;
 	if (message.replyTo) body.reply_to = message.replyTo;
+	if (message.attachments?.length) body.attachments = message.attachments.map((file) => ({
+		filename: file.filename,
+		data: toBase64(file.content)
+	}));
 	const response = await fetchFn(API_URL, {
 		method: "POST",
 		headers: {

package/dist/index.mjs

@@ -7,7 +7,7 @@
 /** @type {import("emdash").PluginDescriptor} */
 const descriptor = Object.freeze({
 	"id": "jetemail",
-	"version": "0.2.0",
+	"version": "0.3.0",
 	"format": "standard",
 	"entrypoint": "@numoteq/emdash-plugin-jetemail/sandbox",
 	"capabilities": [

package/dist/manifest.json

@@ -1,6 +1,6 @@
 {
   "id": "jetemail",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "declaredAccess": {
     "network": {
       "request": {

package/dist/plugin.d.mts

@@ -6,6 +6,11 @@ interface JetEmailSender {
   fromName: string;
   fromEmail: string;
 }
+interface JetEmailAttachment {
+  filename: string;
+  /** Raw bytes (Uint8Array or Node Buffer) or a base64 string. */
+  content: Uint8Array | string;
+}
 interface JetEmailMessage {
   to: string | string[];
   cc?: string[];
@@ -13,6 +18,7 @@ interface JetEmailMessage {
   subject: string;
   text?: string;
   html?: string;
+  attachments?: JetEmailAttachment[];
 }
 type FetchFn = (url: string, init?: RequestInit) => Promise<Response>;
 declare function formatSender(name: string, email: string): string;

package/dist/plugin.mjs

@@ -1 +1 @@
-function e(e,t){return`${e.replace(/[<>"\r\n]/g,``).trim()} <${t}>`}async function t(t,n,r){let i={from:e(n.fromName,n.fromEmail),to:r.to,subject:r.subject};r.text&&(i.text=r.text),r.html&&(i.html=r.html),r.cc?.length&&(i.cc=r.cc),r.replyTo&&(i.reply_to=r.replyTo);let a=await t(`https://api.jetemail.com/email`,{method:`POST`,headers:{Authorization:`Bearer ${n.apiToken}`,"Content-Type":`application/json`},body:JSON.stringify(i)});if(!a.ok){let e=(await a.text()).slice(0,500);throw Error(`JetEmail rejected the message with HTTP ${a.status}${e?`: ${e}`:``}`)}let o=await a.json().catch(()=>({}));return typeof o.id==`string`?{id:o.id}:{}}async function n(e){let t=await e.kv.get(`settings:apiToken`),n=await e.kv.get(`settings:fromName`),r=await e.kv.get(`settings:fromEmail`);if(!t||!n||!r)throw Error(`JetEmail is not configured. Set the API key, sender name and sender email.`);return{apiToken:t,fromName:n,fromEmail:r}}async function r(e){let t=await e.kv.get(`settings:fromName`)??``,n=await e.kv.get(`settings:fromEmail`)??``,r=!!await e.kv.get(`settings:apiToken`);return{blocks:[{type:`header`,text:`JetEmail`},{type:`section`,text:`Deliver EmDash transactional email through the JetEmail API. The sender domain must be verified in JetEmail and allowed for the API key.`},{type:`form`,block_id:`jetemail-settings`,fields:[{type:`text_input`,action_id:`fromName`,label:`Sender name`,initial_value:t},{type:`text_input`,action_id:`fromEmail`,label:`Sender email`,initial_value:n},{type:`secret_input`,action_id:`apiToken`,label:r?`Transactional API key (leave blank to keep current)`:`Transactional API key`}],submit:{label:`Save settings`,action_id:`save_settings`}}]}}function i(e){return{blocks:[{type:`banner`,style:`error`,text:e}],toast:{message:e,type:`error`}}}async function a(e,t){let n=typeof t.fromName==`string`?t.fromName.trim():``,a=typeof t.fromEmail==`string`?t.fromEmail.trim():``,o=typeof t.apiToken==`string`?t.apiToken.trim():``;return n.replace(/[<>"\r\n]/g,``).trim()?/^[^\s@<>]+@[^\s@<>]+$/.test(a)?o&&!o.startsWith(`transactional_`)?i(`Use a JetEmail transactional API key (transactional_…).`):(await e.kv.set(`settings:fromName`,n),await e.kv.set(`settings:fromEmail`,a),o&&await e.kv.set(`settings:apiToken`,o),{...await r(e),toast:{message:`JetEmail settings saved`,type:`success`}}):i(`Enter a valid sender email.`):i(`Enter a sender name.`)}const o={hooks:{"email:deliver":{exclusive:!0,timeout:3e4,handler:async(e,r)=>{if(!r.http)throw Error(`JetEmail requires network access.`);let i=await n(r);await t(r.http.fetch.bind(r.http),i,e.message),r.log.info(`Email delivered via JetEmail`,{to:e.message.to,subject:e.message.subject})}}},routes:{admin:{handler:async(e,t)=>{let n=e.input;return n.type===`page_load`&&n.page===`/settings`?r(t):n.type===`form_submit`&&n.action_id===`save_settings`?a(t,n.values??{}):{blocks:[]}}}}};export{o as default,t as deliverWithJetEmail,e as formatSender};
+function e(e,t){return`${e.replace(/[<>"\r\n]/g,``).trim()} <${t}>`}function t(e){if(typeof e==`string`)return e;let t=``;for(let n=0;n<e.length;n+=32768)t+=String.fromCharCode(...e.subarray(n,n+32768));return btoa(t)}async function n(n,r,i){let a={from:e(r.fromName,r.fromEmail),to:i.to,subject:i.subject};i.text&&(a.text=i.text),i.html&&(a.html=i.html),i.cc?.length&&(a.cc=i.cc),i.replyTo&&(a.reply_to=i.replyTo),i.attachments?.length&&(a.attachments=i.attachments.map(e=>({filename:e.filename,data:t(e.content)})));let o=await n(`https://api.jetemail.com/email`,{method:`POST`,headers:{Authorization:`Bearer ${r.apiToken}`,"Content-Type":`application/json`},body:JSON.stringify(a)});if(!o.ok){let e=(await o.text()).slice(0,500);throw Error(`JetEmail rejected the message with HTTP ${o.status}${e?`: ${e}`:``}`)}let s=await o.json().catch(()=>({}));return typeof s.id==`string`?{id:s.id}:{}}async function r(e){let t=await e.kv.get(`settings:apiToken`),n=await e.kv.get(`settings:fromName`),r=await e.kv.get(`settings:fromEmail`);if(!t||!n||!r)throw Error(`JetEmail is not configured. Set the API key, sender name and sender email.`);return{apiToken:t,fromName:n,fromEmail:r}}async function i(e){let t=await e.kv.get(`settings:fromName`)??``,n=await e.kv.get(`settings:fromEmail`)??``,r=!!await e.kv.get(`settings:apiToken`);return{blocks:[{type:`header`,text:`JetEmail`},{type:`section`,text:`Deliver EmDash transactional email through the JetEmail API. The sender domain must be verified in JetEmail and allowed for the API key.`},{type:`form`,block_id:`jetemail-settings`,fields:[{type:`text_input`,action_id:`fromName`,label:`Sender name`,initial_value:t},{type:`text_input`,action_id:`fromEmail`,label:`Sender email`,initial_value:n},{type:`secret_input`,action_id:`apiToken`,label:r?`Transactional API key (leave blank to keep current)`:`Transactional API key`}],submit:{label:`Save settings`,action_id:`save_settings`}}]}}function a(e){return{blocks:[{type:`banner`,style:`error`,text:e}],toast:{message:e,type:`error`}}}async function o(e,t){let n=typeof t.fromName==`string`?t.fromName.trim():``,r=typeof t.fromEmail==`string`?t.fromEmail.trim():``,o=typeof t.apiToken==`string`?t.apiToken.trim():``;return n.replace(/[<>"\r\n]/g,``).trim()?/^[^\s@<>]+@[^\s@<>]+$/.test(r)?o&&!o.startsWith(`transactional_`)?a(`Use a JetEmail transactional API key (transactional_…).`):(await e.kv.set(`settings:fromName`,n),await e.kv.set(`settings:fromEmail`,r),o&&await e.kv.set(`settings:apiToken`,o),{...await i(e),toast:{message:`JetEmail settings saved`,type:`success`}}):a(`Enter a valid sender email.`):a(`Enter a sender name.`)}const s={hooks:{"email:deliver":{exclusive:!0,timeout:3e4,handler:async(e,t)=>{if(!t.http)throw Error(`JetEmail requires network access.`);let i=await r(t);await n(t.http.fetch.bind(t.http),i,e.message),t.log.info(`Email delivered via JetEmail`,{to:e.message.to,subject:e.message.subject})}}},routes:{admin:{handler:async(e,t)=>{let n=e.input;return n.type===`page_load`&&n.page===`/settings`?i(t):n.type===`form_submit`&&n.action_id===`save_settings`?o(t,n.values??{}):{blocks:[]}}}}};export{s as default,n as deliverWithJetEmail,e as formatSender};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@numoteq/emdash-plugin-jetemail",
-	"version": "0.2.0",
+	"version": "0.3.0",
 	"description": "JetEmail transport provider for EmDash",
 	"keywords": [
 		"email",