@memberjunction/communication-sendgrid 3.4.0 → 4.1.0

package/README.md

@@ -0,0 +1,180 @@
+# @memberjunction/communication-sendgrid
+
+SendGrid provider for the MemberJunction Communication Framework. This provider enables transactional email sending through the SendGrid API, with support for HTML and plain text content, CC/BCC recipients, scheduled delivery, and per-request credential overrides.
+
+## Architecture
+
+```mermaid
+graph TD
+    subgraph sendgrid["@memberjunction/communication-sendgrid"]
+        SGP["SendGridProvider"]
+        CFG["Config Module\n(Environment Variable)"]
+        CRED["SendGridCredentials"]
+    end
+
+    subgraph sg["SendGrid Service"]
+        API["SendGrid Web API v3"]
+        DELIVERY["Email Delivery"]
+    end
+
+    subgraph base["@memberjunction/communication-types"]
+        BCP["BaseCommunicationProvider"]
+    end
+
+    BCP --> SGP
+    SGP --> CFG
+    SGP --> CRED
+    SGP --> API
+    API --> DELIVERY
+
+    style sendgrid fill:#2d6a9f,stroke:#1a4971,color:#fff
+    style sg fill:#7c5295,stroke:#563a6b,color:#fff
+    style base fill:#2d8659,stroke:#1a5c3a,color:#fff
+```
+
+## Installation
+
+```bash
+npm install @memberjunction/communication-sendgrid
+```
+
+## Configuration
+
+Set the following environment variable:
+
+```env
+COMMUNICATION_VENDOR_API_KEY__SENDGRID=SG.your-api-key-here
+```
+
+## Supported Operations
+
+SendGrid is a send-only transactional email service. It does not provide mailbox access.
+
+| Operation | Supported | Notes |
+|-----------|-----------|-------|
+| `SendSingleMessage` | Yes | Full email sending with HTML, text, CC/BCC, scheduling |
+| `GetMessages` | No | No inbox access (throws error) |
+| `ForwardMessage` | No | No mailbox operations (throws error) |
+| `ReplyToMessage` | No | No mailbox operations (throws error) |
+| `CreateDraft` | No | No mailbox access (returns error result) |
+| Extended operations | No | No folder, search, or attachment operations |
+
+## Usage
+
+### Sending Email via CommunicationEngine
+
+```typescript
+import { CommunicationEngine } from '@memberjunction/communication-engine';
+import { Message } from '@memberjunction/communication-types';
+
+const engine = CommunicationEngine.Instance;
+await engine.Config(false, contextUser);
+
+const message = new Message();
+message.From = 'noreply@example.com';
+message.FromName = 'My Application';
+message.To = 'recipient@example.com';
+message.Subject = 'Order Confirmation';
+message.HTMLBody = '<h1>Thank you for your order</h1>';
+message.Body = 'Thank you for your order';
+message.CCRecipients = ['accounting@example.com'];
+
+const result = await engine.SendSingleMessage('SendGrid', 'Email', message);
+if (result.Success) {
+    console.log('Email sent successfully');
+}
+```
+
+### Scheduled Sending
+
+```typescript
+const message = new Message();
+message.From = 'noreply@example.com';
+message.To = 'recipient@example.com';
+message.Subject = 'Scheduled Report';
+message.Body = 'Your weekly report is attached.';
+message.SendAt = new Date('2025-12-01T09:00:00Z');
+
+const result = await engine.SendSingleMessage('SendGrid', 'Email', message);
+```
+
+### Per-Request Credentials
+
+Override the API key for multi-tenant or customer-specific sending:
+
+```typescript
+import { SendGridCredentials } from '@memberjunction/communication-sendgrid';
+
+// Override API key
+const result = await engine.SendSingleMessage(
+    'SendGrid',
+    'Email',
+    message,
+    undefined,
+    false,
+    { apiKey: 'SG.customer-specific-api-key' } as SendGridCredentials
+);
+
+// Disable environment fallback (require explicit key)
+const result2 = await engine.SendSingleMessage(
+    'SendGrid',
+    'Email',
+    message,
+    undefined,
+    false,
+    {
+        apiKey: 'SG.required-key',
+        disableEnvironmentFallback: true
+    } as SendGridCredentials
+);
+```
+
+### Direct Provider Usage
+
+```typescript
+import { SendGridProvider } from '@memberjunction/communication-sendgrid';
+
+const provider = new SendGridProvider();
+const result = await provider.SendSingleMessage(processedMessage);
+```
+
+## Message Features
+
+| Feature | Support |
+|---------|---------|
+| HTML body | Yes |
+| Plain text body | Yes |
+| CC recipients | Yes |
+| BCC recipients | Yes |
+| From name | Yes |
+| Scheduled send (`SendAt`) | Yes (converted to Unix timestamp) |
+| Subscription tracking | Disabled by default |
+
+## SendGridCredentials
+
+```typescript
+interface SendGridCredentials extends ProviderCredentialsBase {
+    /** SendGrid API key (typically starts with 'SG.') */
+    apiKey?: string;
+    /** If true, do not fall back to environment variables */
+    disableEnvironmentFallback?: boolean;
+}
+```
+
+## Dependencies
+
+| Package | Purpose |
+|---------|---------|
+| `@memberjunction/communication-types` | Base provider class and type definitions |
+| `@memberjunction/core` | Logging utilities (LogError, LogStatus) |
+| `@memberjunction/global` | RegisterClass decorator |
+| `@sendgrid/mail` | Official SendGrid Node.js client |
+| `dotenv` | Environment variable loading |
+| `env-var` | Environment variable validation |
+
+## Development
+
+```bash
+npm run build    # Compile TypeScript
+npm run clean    # Remove dist directory
+```

package/dist/SendGridProvider.d.ts

@@ -82,5 +82,4 @@ export declare class SendGridProvider extends BaseCommunicationProvider {
      */
     CreateDraft(params: CreateDraftParams, credentials?: SendGridCredentials): Promise<CreateDraftResult>;
 }
-export declare function LoadProvider(): void;
 //# sourceMappingURL=SendGridProvider.d.ts.map

package/dist/SendGridProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SendGridProvider.d.ts","sourceRoot":"","sources":["../src/SendGridProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,yBAAyB,EACzB,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EAGpB,iBAAiB,EACpB,MAAM,qCAAqC,CAAC;AAM7C;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,mBAAoB,SAAQ,uBAAuB;IAChE;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBACa,gBAAiB,SAAQ,yBAAyB;IAC3D;;;;OAIG;IACa,sBAAsB,IAAI,iBAAiB,EAAE;IAS7D;;;;OAIG;IACU,iBAAiB,CAC1B,OAAO,EAAE,gBAAgB,EACzB,WAAW,CAAC,EAAE,mBAAmB,GAClC,OAAO,CAAC,aAAa,CAAC;IAkFzB;;;OAGG;IACU,WAAW,CACpB,MAAM,EAAE,iBAAiB,EACzB,WAAW,CAAC,EAAE,mBAAmB,GAClC,OAAO,CAAC,iBAAiB,CAAC;IAI7B;;;OAGG;IACI,cAAc,CACjB,MAAM,EAAE,oBAAoB,EAC5B,WAAW,CAAC,EAAE,mBAAmB,GAClC,OAAO,CAAC,oBAAoB,CAAC;IAIhC;;;OAGG;IACI,cAAc,CACjB,MAAM,EAAE,oBAAoB,EAC5B,WAAW,CAAC,EAAE,mBAAmB,GAClC,OAAO,CAAC,oBAAoB,CAAC;IAIhC;;;OAGG;IACU,WAAW,CACpB,MAAM,EAAE,iBAAiB,EACzB,WAAW,CAAC,EAAE,mBAAmB,GAClC,OAAO,CAAC,iBAAiB,CAAC;CAMhC;AAED,wBAAgB,YAAY,SAE3B"}
+{"version":3,"file":"SendGridProvider.d.ts","sourceRoot":"","sources":["../src/SendGridProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,yBAAyB,EACzB,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EAGpB,iBAAiB,EACpB,MAAM,qCAAqC,CAAC;AAM7C;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,mBAAoB,SAAQ,uBAAuB;IAChE;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBACa,gBAAiB,SAAQ,yBAAyB;IAC3D;;;;OAIG;IACa,sBAAsB,IAAI,iBAAiB,EAAE;IAS7D;;;;OAIG;IACU,iBAAiB,CAC1B,OAAO,EAAE,gBAAgB,EACzB,WAAW,CAAC,EAAE,mBAAmB,GAClC,OAAO,CAAC,aAAa,CAAC;IAkFzB;;;OAGG;IACU,WAAW,CACpB,MAAM,EAAE,iBAAiB,EACzB,WAAW,CAAC,EAAE,mBAAmB,GAClC,OAAO,CAAC,iBAAiB,CAAC;IAI7B;;;OAGG;IACI,cAAc,CACjB,MAAM,EAAE,oBAAoB,EAC5B,WAAW,CAAC,EAAE,mBAAmB,GAClC,OAAO,CAAC,oBAAoB,CAAC;IAIhC;;;OAGG;IACI,cAAc,CACjB,MAAM,EAAE,oBAAoB,EAC5B,WAAW,CAAC,EAAE,mBAAmB,GAClC,OAAO,CAAC,oBAAoB,CAAC;IAIhC;;;OAGG;IACU,WAAW,CACpB,MAAM,EAAE,iBAAiB,EACzB,WAAW,CAAC,EAAE,mBAAmB,GAClC,OAAO,CAAC,iBAAiB,CAAC;CAMhC"}

package/dist/SendGridProvider.js

@@ -1,20 +1,14 @@
-"use strict";
 var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
     var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
     if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.LoadProvider = exports.SendGridProvider = void 0;
-const communication_types_1 = require("@memberjunction/communication-types");
-const global_1 = require("@memberjunction/global");
-const mail_1 = __importDefault(require("@sendgrid/mail"));
-const config_1 = require("./config");
-const core_1 = require("@memberjunction/core");
+import { BaseCommunicationProvider, resolveCredentialValue, validateRequiredCredentials } from "@memberjunction/communication-types";
+import { RegisterClass } from "@memberjunction/global";
+import sgMail from '@sendgrid/mail';
+import { __API_KEY } from "./config.js";
+import { LogError, LogStatus } from "@memberjunction/core";
 /**
  * Implementation of the SendGrid provider for sending and receiving messages.
  *
@@ -40,7 +34,7 @@ const core_1 = require("@memberjunction/core");
  * });
  * ```
  */
-let SendGridProvider = class SendGridProvider extends communication_types_1.BaseCommunicationProvider {
+let SendGridProvider = class SendGridProvider extends BaseCommunicationProvider {
     /**
      * Returns the list of operations supported by the SendGrid provider.
      * SendGrid is a transactional email service (send-only) and does not support
@@ -62,12 +56,12 @@ let SendGridProvider = class SendGridProvider extends communication_types_1.Base
     async SendSingleMessage(message, credentials) {
         // Resolve credentials: request values override env vars
         const disableFallback = credentials?.disableEnvironmentFallback ?? false;
-        const apiKey = (0, communication_types_1.resolveCredentialValue)(credentials?.apiKey, config_1.__API_KEY, disableFallback);
+        const apiKey = resolveCredentialValue(credentials?.apiKey, __API_KEY, disableFallback);
         // Validate required credentials
-        (0, communication_types_1.validateRequiredCredentials)({ apiKey }, ['apiKey'], 'SendGrid');
+        validateRequiredCredentials({ apiKey }, ['apiKey'], 'SendGrid');
         const from = message.From;
         // Set API key for this request
-        mail_1.default.setApiKey(apiKey);
+        sgMail.setApiKey(apiKey);
         const msg = {
             to: message.To,
             from: {
@@ -97,9 +91,9 @@ let SendGridProvider = class SendGridProvider extends communication_types_1.Base
             msg.sendAt = unitTime;
         }
         try {
-            const result = await mail_1.default.send(msg);
+            const result = await sgMail.send(msg);
             if (result && result.length > 0 && result[0].statusCode >= 200 && result[0].statusCode < 300) {
-                (0, core_1.LogStatus)(`Email sent to ${msg.to}: ${result[0].statusCode}`);
+                LogStatus(`Email sent to ${msg.to}: ${result[0].statusCode}`);
                 return {
                     Message: message,
                     Success: true,
@@ -107,8 +101,8 @@ let SendGridProvider = class SendGridProvider extends communication_types_1.Base
                 };
             }
             else {
-                (0, core_1.LogError)(`Error sending email to ${msg.to}:`, undefined, result);
-                (0, core_1.LogError)(result[0].body);
+                LogError(`Error sending email to ${msg.to}:`, undefined, result);
+                LogError(result[0].body);
                 return {
                     Message: message,
                     Success: false,
@@ -119,9 +113,9 @@ let SendGridProvider = class SendGridProvider extends communication_types_1.Base
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : 'Unknown error';
             const errorResponse = error?.response?.body;
-            (0, core_1.LogError)(`Error sending email to ${msg.to}:`, undefined, error);
+            LogError(`Error sending email to ${msg.to}:`, undefined, error);
             if (errorResponse) {
-                (0, core_1.LogError)(errorResponse);
+                LogError(errorResponse);
             }
             return {
                 Message: message,
@@ -162,12 +156,8 @@ let SendGridProvider = class SendGridProvider extends communication_types_1.Base
         };
     }
 };
-exports.SendGridProvider = SendGridProvider;
-exports.SendGridProvider = SendGridProvider = __decorate([
-    (0, global_1.RegisterClass)(communication_types_1.BaseCommunicationProvider, 'SendGrid')
+SendGridProvider = __decorate([
+    RegisterClass(BaseCommunicationProvider, 'SendGrid')
 ], SendGridProvider);
-function LoadProvider() {
-    // do nothing, this prevents tree shaking from removing this class
-}
-exports.LoadProvider = LoadProvider;
+export { SendGridProvider };
 //# sourceMappingURL=SendGridProvider.js.map

package/dist/SendGridProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"SendGridProvider.js","sourceRoot":"","sources":["../src/SendGridProvider.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"SendGridProvider.js","sourceRoot":"","sources":["../src/SendGridProvider.ts"],"names":[],"mappings":"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"}

package/dist/config.js

@@ -1,12 +1,6 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.__API_KEY = void 0;
 // TEMPORARY
-const dotenv_1 = __importDefault(require("dotenv"));
+import dotenv from 'dotenv';
 // Load environment variables from .env file
-dotenv_1.default.config();
-exports.__API_KEY = process.env.COMMUNICATION_VENDOR_API_KEY__SENDGRID;
+dotenv.config({ quiet: true });
+export const __API_KEY = process.env.COMMUNICATION_VENDOR_API_KEY__SENDGRID;
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;;;;;AAAA,YAAY;AACZ,oDAA4B;AAE5B,4CAA4C;AAC5C,gBAAM,CAAC,MAAM,EAAE,CAAC;AAEH,QAAA,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,YAAY;AACZ,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,4CAA4C;AAC5C,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAE/B,MAAM,CAAC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC"}

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-export * from './SendGridProvider';
-export type { SendGridCredentials } from './SendGridProvider';
+export * from './SendGridProvider.js';
+export type { SendGridCredentials } from './SendGridProvider.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,19 +1,3 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
 // PUBLIC API SURFACE AREA
-__exportStar(require("./SendGridProvider"), exports);
+export * from './SendGridProvider.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0BAA0B;AAC1B,qDAAmC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,0BAA0B;AAC1B,cAAc,oBAAoB,CAAC"}

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@memberjunction/communication-sendgrid",
-  "version": "3.4.0",
+  "type": "module",
+  "version": "4.1.0",
   "description": "MemberJunction: SendGrid Provider for the MJ Communication Framework",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -9,22 +10,22 @@
   ],
   "scripts": {
     "start": "ts-node-dev src/index.ts",
-    "build": "tsc",
+    "build": "tsc && tsc-alias -f",
     "test": "echo \"Error: no test specified\" && exit 1"
   },
   "author": "MemberJunction.com",
   "license": "ISC",
   "devDependencies": {
     "ts-node-dev": "^2.0.0",
-    "typescript": "^5.4.5"
+    "typescript": "^5.9.3"
   },
   "dependencies": {
-    "@memberjunction/communication-types": "3.4.0",
-    "@memberjunction/core": "3.4.0",
-    "@memberjunction/core-entities": "3.4.0",
-    "@memberjunction/global": "3.4.0",
-    "@sendgrid/mail": "^8.1.3",
-    "dotenv": "^16.4.1"
+    "@memberjunction/communication-types": "4.1.0",
+    "@memberjunction/core": "4.1.0",
+    "@memberjunction/core-entities": "4.1.0",
+    "@memberjunction/global": "4.1.0",
+    "@sendgrid/mail": "^8.1.6",
+    "dotenv": "^17.2.4"
   },
   "repository": {
     "type": "git",