@strapi/email 5.37.0 → 5.38.0

package/dist/shared/email-address-parser.d.ts

@@ -0,0 +1,81 @@
+/**
+ * RFC-compliant Email Address Parser
+ *
+ * Supports:
+ * - RFC 5322: Internet Message Format (basic name <email> format)
+ * - RFC 2047: MIME encoded-words for non-ASCII characters
+ * - RFC 5322: Comments in parentheses
+ * - RFC 5322: Quoted strings with special characters
+ * - RFC 6531: Internationalized email addresses (UTF-8)
+ */
+export interface ParsedEmailAddress {
+    /** Display name (decoded if RFC 2047 encoded) */
+    name: string | null;
+    /** Email address */
+    email: string;
+    /** Original unparsed string */
+    original: string;
+}
+/**
+ * Parses an email address string according to RFC 5322 and related RFCs
+ *
+ * Supported formats:
+ * 1. Simple email: "email@example.com"
+ * 2. Name with angle brackets: "Name <email@example.com>"
+ * 3. Quoted name: "\"Doe, John\" <email@example.com>"
+ * 4. RFC 2047 encoded: "=?UTF-8?B?...?= <email@example.com>"
+ * 5. With comment: "email@example.com (Display Name)"
+ * 6. Mixed: "\"Name\" <email@example.com> (comment)"
+ *
+ * @param emailString - The email address string to parse
+ * @returns Parsed email address with name, email, and original string
+ *
+ * @example
+ * parseEmailAddress('Strapi <no-reply@strapi.io>')
+ * // { name: 'Strapi', email: 'no-reply@strapi.io', original: '...' }
+ *
+ * @example
+ * parseEmailAddress('=?UTF-8?B?U3RyYXBp?= <no-reply@strapi.io>')
+ * // { name: 'Strapi', email: 'no-reply@strapi.io', original: '...' }
+ *
+ * @example
+ * parseEmailAddress('no-reply@strapi.io (Strapi Support)')
+ * // { name: 'Strapi Support', email: 'no-reply@strapi.io', original: '...' }
+ */
+export declare const parseEmailAddress: (emailString: string | undefined | null) => ParsedEmailAddress;
+/**
+ * Formats an email address according to RFC 5322
+ *
+ * @param name - Display name (will be quoted if contains special chars)
+ * @param email - Email address
+ * @returns Formatted email address string
+ *
+ * @example
+ * formatEmailAddress('Strapi', 'no-reply@strapi.io')
+ * // 'Strapi <no-reply@strapi.io>'
+ *
+ * @example
+ * formatEmailAddress('Doe, John', 'john@example.com')
+ * // '"Doe, John" <john@example.com>'
+ */
+export declare const formatEmailAddress: (name: string | null, email: string) => string;
+/**
+ * Validates an email address according to RFC 5322
+ * This is a simplified validation that covers most common cases
+ *
+ * @param email - Email address to validate
+ * @returns true if the email appears valid
+ */
+export declare const isValidEmail: (email: string) => boolean;
+/**
+ * Parses multiple email addresses separated by commas
+ * Handles quoted strings that may contain commas
+ *
+ * @param emailsString - Comma-separated email addresses
+ * @returns Array of parsed email addresses
+ *
+ * @example
+ * parseMultipleEmailAddresses('a@example.com, "Doe, John" <b@example.com>')
+ * // [{ name: null, email: 'a@example.com', ... }, { name: 'Doe, John', email: 'b@example.com', ... }]
+ */
+export declare const parseMultipleEmailAddresses: (emailsString: string | undefined | null) => ParsedEmailAddress[];

package/dist/shared/email-address-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-address-parser.d.ts","sourceRoot":"","sources":["../../shared/email-address-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,kBAAkB;IACjC,iDAAiD;IACjD,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;CAClB;AA4KD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,iBAAiB,gBAAiB,MAAM,GAAG,SAAS,GAAG,IAAI,KAAG,kBA4D1E,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,kBAAkB,SAAU,MAAM,GAAG,IAAI,SAAS,MAAM,KAAG,MAgBvE,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,UAAW,MAAM,KAAG,OAW5C,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,2BAA2B,iBACxB,MAAM,GAAG,SAAS,GAAG,IAAI,KACtC,kBAAkB,EAgDpB,CAAC"}

package/dist/shared/types.d.ts

@@ -1,5 +1,22 @@
+export interface ProviderCapabilities {
+    transport?: {
+        host?: string;
+        port?: number;
+        secure?: boolean;
+        pool?: boolean;
+        maxConnections?: number;
+    };
+    auth?: {
+        type?: string;
+        user?: string;
+    };
+    features?: string[];
+}
 export interface EmailSettings {
     config: ConfigSettings;
+    supportsVerify: boolean;
+    capabilities?: ProviderCapabilities;
+    isIdle?: boolean;
 }
 export interface ConfigSettings {
     provider: string;

package/dist/shared/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../shared/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE;QACR,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;CACH"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../shared/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE;QACV,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,IAAI,CAAC,EAAE;QACL,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,cAAc,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,CAAC,EAAE,oBAAoB,CAAC;IACpC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE;QACR,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;CACH"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@strapi/email",
-  "version": "5.37.0",
+  "version": "5.38.0",
   "description": "Easily configure your Strapi application to send emails.",
   "repository": {
     "type": "git",
@@ -56,10 +56,10 @@
     "watch": "run -T rollup -c -w"
   },
   "dependencies": {
-    "@strapi/design-system": "2.1.2",
-    "@strapi/icons": "2.1.2",
-    "@strapi/provider-email-sendmail": "5.37.0",
-    "@strapi/utils": "5.37.0",
+    "@strapi/design-system": "2.2.0",
+    "@strapi/icons": "2.2.0",
+    "@strapi/provider-email-sendmail": "5.38.0",
+    "@strapi/utils": "5.38.0",
     "koa2-ratelimit": "^1.1.3",
     "lodash": "4.17.23",
     "react-intl": "6.6.2",
@@ -68,8 +68,8 @@
     "zod": "3.25.67"
   },
   "devDependencies": {
-    "@strapi/admin": "5.37.0",
-    "@strapi/types": "5.37.0",
+    "@strapi/admin": "5.38.0",
+    "@strapi/types": "5.38.0",
     "@testing-library/react": "16.3.0",
     "@types/koa": "2.13.4",
     "@types/lodash": "^4.14.191",