@visulima/email 1.0.0-alpha.39 → 1.0.0-alpha.40

package/CHANGELOG.md

@@ -1,3 +1,13 @@
+## @visulima/email [1.0.0-alpha.40](https://github.com/visulima/visulima/compare/@visulima/email@1.0.0-alpha.39...@visulima/email@1.0.0-alpha.40) (2026-06-20)
+
+### Features
+
+* **email:** add sparkpost, netcore and outlook365 providers ([b8efc45](https://github.com/visulima/visulima/commit/b8efc45e273dffa246a4badc1711f01682ea7af5))
+
+### Tests
+
+* **email:** fix ical file-url path assertion on windows ([3673d90](https://github.com/visulima/visulima/commit/3673d901f522430bea634f6c93bd286577fa144f))
+
 ## @visulima/email [1.0.0-alpha.39](https://github.com/visulima/visulima/compare/@visulima/email@1.0.0-alpha.38...@visulima/email@1.0.0-alpha.39) (2026-06-19)
 
 ## @visulima/email [1.0.0-alpha.38](https://github.com/visulima/visulima/compare/@visulima/email@1.0.0-alpha.37...@visulima/email@1.0.0-alpha.38) (2026-06-19)

package/README.md

@@ -912,6 +912,70 @@ const sendGridOptions: SendGridEmailOptions = {
 await mail.send(sendGridOptions);
 ```
 
+### SparkPost Provider
+
+SparkPost is a high-volume email delivery service. Universal runtime (Fetch API).
+
+```typescript
+import { createMail, sparkpostProvider } from "@visulima/email/providers/sparkpost";
+
+const mail = createMail(
+    sparkpostProvider({
+        apiKey: "your-sparkpost-api-key",
+        endpoint: "https://api.sparkpost.com/api/v1", // or https://api.eu.sparkpost.com/api/v1 (EU)
+    }),
+);
+
+await mail.send({
+    from: { email: "sender@example.com" },
+    to: { email: "user@example.com" },
+    subject: "Welcome",
+    html: "<h1>Welcome!</h1>",
+    // SparkPost-specific: campaignId, templateId, trackOpens, trackClicks
+});
+```
+
+### Netcore Provider
+
+Netcore (formerly Pepipost) transactional email via the Email API v5.1. Universal runtime (Fetch API).
+
+```typescript
+import { createMail, netcoreProvider } from "@visulima/email/providers/netcore";
+
+const mail = createMail(netcoreProvider({ apiKey: "your-netcore-api-key" }));
+
+await mail.send({
+    from: { email: "sender@example.com" },
+    to: { email: "user@example.com" },
+    subject: "Welcome",
+    html: "<h1>Welcome!</h1>",
+    // Netcore-specific: templateId, templateData
+});
+```
+
+### Outlook365 Provider
+
+Sends through Microsoft Graph `sendMail`. Universal runtime (Fetch API). Bring your own OAuth2 token (`Mail.Send` scope)
+via `accessToken` or `getAccessToken` — no auth SDK is bundled.
+
+```typescript
+import { createMail, outlook365Provider } from "@visulima/email/providers/outlook365";
+
+const mail = createMail(
+    outlook365Provider({
+        getAccessToken: async () => getGraphAccessToken(),
+        userId: "sender@contoso.com", // or "me" (default)
+    }),
+);
+
+await mail.send({
+    from: { email: "sender@contoso.com" },
+    to: { email: "user@example.com" },
+    subject: "Welcome",
+    html: "<h1>Welcome!</h1>",
+});
+```
+
 ### Plunk Provider
 
 Plunk is a modern email platform built on top of AWS SES, offering transactional emails, automations, and broadcasts.
@@ -1069,6 +1133,9 @@ const result = await mail.send(message);
 - **Round Robin** - Load balancing across multiple providers
 - **OpenTelemetry** - OpenTelemetry instrumentation wrapper for observability
 - **SendGrid** - Cloud-based email service for transactional and marketing emails
+- **SparkPost** - SparkPost Transmissions API
+- **Netcore** - Netcore (Pepipost) Email API
+- **Outlook365** - Microsoft Graph (Outlook365) `sendMail`
 - **SMTP** - Standard SMTP protocol
 - **Zeptomail** - Zeptomail email service
 
@@ -1099,6 +1166,9 @@ These providers work in **Node.js**, **Deno**, **Bun**, and **Cloudflare Workers
 - ✅ **Mailomat** - Uses Fetch API
 - ✅ **Sweego** - Uses Fetch API
 - ✅ **SendGrid** - Uses Fetch API
+- ✅ **SparkPost** - Uses Fetch API
+- ✅ **Netcore** - Uses Fetch API
+- ✅ **Outlook365** - Uses Fetch API (Microsoft Graph; bring your own OAuth2 token)
 - ✅ **Plunk** - Uses Fetch API
 - ✅ **Mock** - In-memory provider, works everywhere
 - ✅ **Failover** - Runtime depends on wrapped providers (works if all wrapped providers support the runtime)

package/dist/packem_shared/netcoreProvider-XMWO_Aoa.js

@@ -0,0 +1 @@
+import p from"./EmailError-B-sEf3bp.js";import g from"./RequiredOptionError-DuNNY_a5.js";import{e as y}from"./generate-message-id-gXAuMz4g.js";import{m as v}from"./make-request-BlK_B72c.js";import{u as b}from"./retry-3pnxTuNs.js";import{f as w}from"./validate-email-options-mCM9dVug.js";import{defineProvider as P}from"./defineProvider-C9q-7iwt.js";import{P as I,h as A,c as z}from"./provider-base-gIoUu9so.js";import{a as l}from"./address-formatter-BWR2Dddx.js";import{c as K}from"./attachment-processor-BjTNoMyb.js";const a="netcore",S="https://emailapi.netcorecloud.net/v5.1",T=3e4,_=3,m=r=>[r].flat(),F=P((r={})=>{if(!r.apiKey)throw new g(a,"apiKey");const i={apiKey:r.apiKey,debug:r.debug??!1,endpoint:r.endpoint??S,logger:r.logger,retries:r.retries??_,timeout:r.timeout??T},d=new I,u=z(a,r.logger);return{features:{attachments:!0,batchSending:!0,customHeaders:!0,html:!0,replyTo:!0,scheduling:!1,tagging:!0,templates:!0,tracking:!0},async initialize(){await d.ensureInitialized(async()=>{if(!await this.isAvailable())throw new p(a,"Netcore API not available or invalid API key");u.debug("Provider initialized successfully")},a)},async isAvailable(){return i.apiKey.length>0},name:a,options:i,async sendEmail(t){try{const n=w(t);if(n.length>0)return{error:new p(a,`Invalid email options: ${n.join(", ")}`),success:!1};await d.ensureInitialized(()=>this.initialize(),a);const o={to:m(t.to).map(e=>l(e))};t.cc&&(o.cc=m(t.cc).map(e=>l(e))),t.bcc&&(o.bcc=m(t.bcc).map(e=>l(e)));const s={from:l(t.from),personalizations:[o],subject:t.subject};if(t.templateId)s.template_id=t.templateId,t.templateData&&(o.attributes=t.templateData);else{const e=[];t.html&&e.push({type:"html",value:t.html}),t.text&&e.push({type:"plain",value:t.text}),e.length>0&&(s.content=e)}if(t.replyTo){const e=m(t.replyTo)[0];e&&(s.reply_to=e.email)}t.attachments&&t.attachments.length>0&&(s.attachments=await Promise.all(t.attachments.map(async e=>{const h=await K(e,a);return{content:h.content,name:h.filename}})));const c=await b(async()=>v(`${i.endpoint}/mail/send`,{headers:{api_key:i.apiKey,"Content-Type":"application/json"},method:"POST",timeout:i.timeout},JSON.stringify(s)),i.retries);if(!c.success)return{error:c.error??new p(a,"Failed to send email"),success:!1};const{body:f}=c.data;return{data:{messageId:f?.data?.message_id??f?.message_id??y(),provider:a,response:c.data,sent:!0,timestamp:new Date},success:!0}}catch(n){return{error:A(a,"send email",n,u),success:!1}}},async validateCredentials(){return this.isAvailable()}}});export{F as default};

package/dist/packem_shared/outlook365Provider-BoNtxqIx.js

@@ -0,0 +1 @@
+import u from"./EmailError-B-sEf3bp.js";import h from"./RequiredOptionError-DuNNY_a5.js";import{e as y}from"./generate-message-id-gXAuMz4g.js";import{m as k}from"./make-request-BlK_B72c.js";import{u as v}from"./retry-3pnxTuNs.js";import{f as A}from"./validate-email-options-mCM9dVug.js";import{defineProvider as b}from"./defineProvider-C9q-7iwt.js";import{c as w}from"./attachment-processor-BjTNoMyb.js";import{h as I,P as S,c as P}from"./provider-base-gIoUu9so.js";const a="outlook365",j="https://graph.microsoft.com/v1.0",R=3e4,x=3,o=t=>[t].flat(),c=t=>t.map(s=>({emailAddress:{address:s.email,...s.name?{name:s.name}:{}}})),q=b((t={})=>{if(!t.accessToken&&!t.getAccessToken)throw new h(a,["accessToken","getAccessToken"]);const s={accessToken:t.accessToken,debug:t.debug??!1,endpoint:t.endpoint??j,getAccessToken:t.getAccessToken,logger:t.logger,retries:t.retries??x,saveToSentItems:t.saveToSentItems??!0,timeout:t.timeout??R,userId:t.userId??"me"},p=new S,f=P(a,t.logger),g=async()=>s.getAccessToken?s.getAccessToken():s.accessToken;return{features:{attachments:!0,batchSending:!1,customHeaders:!0,html:!0,replyTo:!0,scheduling:!1,tagging:!1,templates:!1,tracking:!1},async initialize(){p.setInitialized()},async isAvailable(){return!!(s.accessToken??s.getAccessToken)},name:a,options:s,async sendEmail(e){try{const n=A(e);if(n.length>0)return{error:new u(a,`Invalid email options: ${n.join(", ")}`),success:!1};let d;try{d=await g()}catch(m){return{error:new u(a,"Failed to obtain access token",{cause:m}),success:!1}}const r={body:{content:e.html??e.text??"",contentType:e.html?"HTML":"Text"},subject:e.subject,toRecipients:c(o(e.to))};e.cc&&(r.ccRecipients=c(o(e.cc))),e.bcc&&(r.bccRecipients=c(o(e.bcc))),e.replyTo&&(r.replyTo=c(o(e.replyTo))),e.importance&&(r.importance=e.importance),e.attachments&&e.attachments.length>0&&(r.attachments=await Promise.all(e.attachments.map(async m=>{const l=await w(m,a);return{"@odata.type":"#microsoft.graph.fileAttachment",contentBytes:l.content,contentType:l.contentType,name:l.filename}})));const T=s.userId==="me"?"me":`users/${s.userId}`,i=await v(async()=>k(`${s.endpoint}/${T}/sendMail`,{headers:{Authorization:`Bearer ${d}`,"Content-Type":"application/json"},method:"POST",timeout:s.timeout},JSON.stringify({message:r,saveToSentItems:s.saveToSentItems})),s.retries);return i.success?{data:{messageId:y(),provider:a,response:i.data,sent:!0,timestamp:new Date},success:!0}:{error:i.error??new u(a,"Failed to send email"),success:!1}}catch(n){return{error:I(a,"send email",n,f),success:!1}}},async validateCredentials(){return this.isAvailable()}}});export{q as default};

package/dist/packem_shared/sparkpostProvider-BytvwqjP.js

@@ -0,0 +1 @@
+import h from"./EmailError-B-sEf3bp.js";import w from"./RequiredOptionError-DuNNY_a5.js";import{e as P}from"./generate-message-id-gXAuMz4g.js";import{m as j}from"./make-request-BlK_B72c.js";import{u as I}from"./retry-3pnxTuNs.js";import{f as A}from"./validate-email-options-mCM9dVug.js";import{defineProvider as S}from"./defineProvider-C9q-7iwt.js";import{P as z,h as _,c as C}from"./provider-base-gIoUu9so.js";import{a as l}from"./address-formatter-BWR2Dddx.js";import{c as K}from"./attachment-processor-BjTNoMyb.js";const a="sparkpost",O="https://api.sparkpost.com/api/v1",T=3e4,x=3,d=r=>[r].flat(),B=S((r={})=>{if(!r.apiKey)throw new w(a,"apiKey");const n={apiKey:r.apiKey,debug:r.debug??!1,endpoint:r.endpoint??O,logger:r.logger,retries:r.retries??x,timeout:r.timeout??T},g=new z,y=C(a,r.logger);return{features:{attachments:!0,batchSending:!0,customHeaders:!0,html:!0,replyTo:!0,scheduling:!1,tagging:!0,templates:!0,tracking:!0},async initialize(){await g.ensureInitialized(async()=>{if(!await this.isAvailable())throw new h(a,"SparkPost API not available or invalid API key");y.debug("Provider initialized successfully")},a)},async isAvailable(){return n.apiKey.length>0},name:a,options:n,async sendEmail(t){try{const o=A(t);if(o.length>0)return{error:new h(a,`Invalid email options: ${o.join(", ")}`),success:!1};await g.ensureInitialized(()=>this.initialize(),a);const p=d(t.to),u=t.cc?d(t.cc):[],k=t.bcc?d(t.bcc):[],v=[...p.map(e=>({address:l(e)})),...u.map(e=>({address:{...l(e),header_to:p.map(i=>i.email).join(", ")}})),...k.map(e=>({address:{...l(e),header_to:p.map(i=>i.email).join(", ")}}))],s={from:l(t.from),subject:t.subject};if(t.html&&(s.html=t.html),t.text&&(s.text=t.text),t.replyTo){const e=d(t.replyTo)[0];e&&(s.reply_to=e.email)}const c={};if(u.length>0&&(c.CC=u.map(e=>e.email).join(", ")),t.headers)for(const[e,i]of Object.entries(t.headers))c[e]=String(i);Object.keys(c).length>0&&(s.headers=c),t.templateId&&(s.template_id=t.templateId),t.attachments&&t.attachments.length>0&&(s.attachments=await Promise.all(t.attachments.map(async e=>{const i=await K(e,a);return{data:i.content,name:i.filename,type:i.contentType}})));const f={content:s,recipients:v};t.campaignId&&(f.campaign_id=t.campaignId),(t.trackOpens!==void 0||t.trackClicks!==void 0)&&(f.options={click_tracking:t.trackClicks??!0,open_tracking:t.trackOpens??!0});const m=await I(async()=>j(`${n.endpoint}/transmissions`,{headers:{Authorization:n.apiKey,"Content-Type":"application/json"},method:"POST",timeout:n.timeout},JSON.stringify(f)),n.retries);if(!m.success)return{error:m.error??new h(a,"Failed to send email"),success:!1};const{body:b}=m.data;return{data:{messageId:b?.results?.id??P(),provider:a,response:m.data,sent:!0,timestamp:new Date},success:!0}}catch(o){return{error:_(a,"send email",o,y),success:!1}}},async validateCredentials(){return this.isAvailable()}}});export{B as default};

package/dist/providers/netcore/index.d.ts

@@ -0,0 +1,35 @@
+import { P as ProviderFactory } from "../../packem_shared/provider.d-J-y6iogK.js";
+export type { a as Provider } from "../../packem_shared/provider.d-J-y6iogK.js";
+import { B as BaseConfig, E as EmailOptions } from "../../packem_shared/types.d-ejzh-xBP.js";
+import 'node:buffer';
+/**
+* Netcore (Pepipost) configuration.
+*/
+interface NetcoreConfig extends BaseConfig {
+  /**
+  * Netcore Email API key (sent as the `api_key` header).
+  */
+  apiKey: string;
+  /**
+  * API endpoint override.
+  */
+  endpoint?: string;
+}
+/**
+* Netcore-specific email options.
+*/
+interface NetcoreEmailOptions extends EmailOptions {
+  /**
+  * Variables substituted into the Netcore template.
+  */
+  templateData?: Record<string, unknown>;
+  /**
+  * Stored template id to send instead of inline content.
+  */
+  templateId?: string;
+}
+/**
+* Netcore (Pepipost) provider — sends email through the Netcore Email API (v5.1).
+*/
+declare const netcoreProvider: ProviderFactory<NetcoreConfig>;
+export { type NetcoreConfig, type NetcoreEmailOptions, type ProviderFactory, netcoreProvider };

package/dist/providers/netcore/index.js

@@ -0,0 +1 @@
+import{default as o}from"../../packem_shared/netcoreProvider-XMWO_Aoa.js";export{o as netcoreProvider};

package/dist/providers/outlook365/index.d.ts

@@ -0,0 +1,48 @@
+import { P as ProviderFactory } from "../../packem_shared/provider.d-J-y6iogK.js";
+export type { a as Provider } from "../../packem_shared/provider.d-J-y6iogK.js";
+import { M as MaybePromise, B as BaseConfig, E as EmailOptions } from "../../packem_shared/types.d-ejzh-xBP.js";
+import 'node:buffer';
+/**
+* Outlook365 / Microsoft Graph configuration.
+*
+* Authentication is delegated: supply a static `accessToken` or an async
+* `getAccessToken` (e.g. backed by `@azure/msal-node`). The provider never bundles an
+* auth SDK, so it stays dependency-light and runtime-agnostic.
+*/
+interface Outlook365Config extends BaseConfig {
+  /**
+  * A static OAuth2 access token with the `Mail.Send` scope. Prefer
+  * {@link Outlook365Config.getAccessToken} for tokens that expire.
+  */
+  accessToken?: string;
+  /**
+  * API endpoint override (default `https://graph.microsoft.com/v1.0`).
+  */
+  endpoint?: string;
+  /**
+  * Returns a fresh OAuth2 access token with the `Mail.Send` scope.
+  */
+  getAccessToken?: () => MaybePromise<string>;
+  /**
+  * Whether to keep a copy in the Sent Items folder (default true).
+  */
+  saveToSentItems?: boolean;
+  /**
+  * The mailbox to send as: a user id/UPN. Defaults to `me` (the token's own mailbox).
+  */
+  userId?: string;
+}
+/**
+* Outlook365-specific email options.
+*/
+interface Outlook365EmailOptions extends EmailOptions {
+  /**
+  * Message importance.
+  */
+  importance?: "high" | "low" | "normal";
+}
+/**
+* Outlook365 provider — sends email through the Microsoft Graph `sendMail` endpoint.
+*/
+declare const outlook365Provider: ProviderFactory<Outlook365Config>;
+export { type Outlook365Config, type Outlook365EmailOptions, type ProviderFactory, outlook365Provider };

package/dist/providers/outlook365/index.js

@@ -0,0 +1 @@
+import{default as e}from"../../packem_shared/outlook365Provider-BoNtxqIx.js";export{e as outlook365Provider};

package/dist/providers/sparkpost/index.d.ts

@@ -0,0 +1,43 @@
+import { P as ProviderFactory } from "../../packem_shared/provider.d-J-y6iogK.js";
+export type { a as Provider } from "../../packem_shared/provider.d-J-y6iogK.js";
+import { B as BaseConfig, E as EmailOptions } from "../../packem_shared/types.d-ejzh-xBP.js";
+import 'node:buffer';
+/**
+* SparkPost configuration.
+*/
+interface SparkPostConfig extends BaseConfig {
+  /**
+  * SparkPost API key (sent as the `Authorization` header).
+  */
+  apiKey: string;
+  /**
+  * API endpoint override. Use `https://api.eu.sparkpost.com/api/v1` for the EU region.
+  */
+  endpoint?: string;
+}
+/**
+* SparkPost-specific email options.
+*/
+interface SparkPostEmailOptions extends EmailOptions {
+  /**
+  * Campaign id applied to the transmission.
+  */
+  campaignId?: string;
+  /**
+  * Stored template id to send instead of inline content.
+  */
+  templateId?: string;
+  /**
+  * Whether click tracking is enabled.
+  */
+  trackClicks?: boolean;
+  /**
+  * Whether engagement tracking (opens/clicks) is enabled.
+  */
+  trackOpens?: boolean;
+}
+/**
+* SparkPost provider — sends email through the SparkPost Transmissions API.
+*/
+declare const sparkpostProvider: ProviderFactory<SparkPostConfig>;
+export { type ProviderFactory, type SparkPostConfig, type SparkPostEmailOptions, sparkpostProvider };

package/dist/providers/sparkpost/index.js

@@ -0,0 +1 @@
+import{default as a}from"../../packem_shared/sparkpostProvider-BytvwqjP.js";export{a as sparkpostProvider};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@visulima/email",
-  "version": "1.0.0-alpha.39",
+  "version": "1.0.0-alpha.40",
   "description": "A comprehensive email library with multi-provider support, crypto utilities, and template engines",
   "keywords": [
     "ahasend",
@@ -42,11 +42,14 @@
     "mandrill",
     "mjml",
     "mock",
+    "netcore",
     "nodemailer",
     "opentelemetry",
+    "outlook365",
     "plunk",
     "postal",
     "postmark",
+    "sparkpost",
     "react-email",
     "resend",
     "roundrobin",
@@ -301,6 +304,18 @@
       "types": "./dist/providers/loops/index.d.ts",
       "default": "./dist/providers/loops/index.js"
     },
+    "./providers/sparkpost": {
+      "types": "./dist/providers/sparkpost/index.d.ts",
+      "default": "./dist/providers/sparkpost/index.js"
+    },
+    "./providers/netcore": {
+      "types": "./dist/providers/netcore/index.d.ts",
+      "default": "./dist/providers/netcore/index.js"
+    },
+    "./providers/outlook365": {
+      "types": "./dist/providers/outlook365/index.d.ts",
+      "default": "./dist/providers/outlook365/index.js"
+    },
     "./utils/parse-address": {
       "types": "./dist/utils/parse-address.d.ts",
       "default": "./dist/utils/parse-address.js"