@memberjunction/communication-types 2.123.1 → 2.125.0

package/dist/BaseProvider.d.ts

@@ -1,5 +1,7 @@
+/// <reference types="node" />
 import { UserInfo } from "@memberjunction/core";
 import { CommunicationProviderEntity, CommunicationProviderMessageTypeEntity, CommunicationRunEntity, TemplateEntityExtended } from "@memberjunction/core-entities";
+import { ProviderCredentialsBase } from "./CredentialUtils";
 /**
  * Information about a single recipient
  */
@@ -229,34 +231,516 @@ export type CreateDraftResult<T = Record<string, any>> = BaseMessageResult & {
      */
     Result?: T;
 };
+/**
+ * Parameters for getting a single message by ID
+ */
+export type GetSingleMessageParams<T = Record<string, any>> = {
+    /**
+     * The ID of the message to retrieve
+     */
+    MessageID: string;
+    /**
+     * Optional, include the headers in the response (defaults to false)
+     */
+    IncludeHeaders?: boolean;
+    /**
+     * Optional, include attachments metadata in the response (defaults to false)
+     */
+    IncludeAttachments?: boolean;
+    /**
+     * Optional, provider-specific context data
+     */
+    ContextData?: T;
+};
+/**
+ * Result of getting a single message
+ */
+export type GetSingleMessageResult<T = Record<string, any>> = BaseMessageResult & {
+    /**
+     * The retrieved message in standardized format
+     */
+    Message?: GetMessageMessage;
+    /**
+     * If populated, holds provider-specific data that is returned from the provider
+     */
+    SourceData?: T;
+};
+/**
+ * Parameters for deleting a message
+ */
+export type DeleteMessageParams<T = Record<string, any>> = {
+    /**
+     * The ID of the message to delete
+     */
+    MessageID: string;
+    /**
+     * If true, permanently delete the message. If false, move to trash (if supported).
+     * Defaults to false.
+     */
+    PermanentDelete?: boolean;
+    /**
+     * Optional, provider-specific context data
+     */
+    ContextData?: T;
+};
+/**
+ * Result of deleting a message
+ */
+export type DeleteMessageResult<T = Record<string, any>> = BaseMessageResult & {
+    /**
+     * If populated, holds provider-specific result data
+     */
+    Result?: T;
+};
+/**
+ * Parameters for moving a message to a different folder
+ */
+export type MoveMessageParams<T = Record<string, any>> = {
+    /**
+     * The ID of the message to move
+     */
+    MessageID: string;
+    /**
+     * The ID of the destination folder
+     */
+    DestinationFolderID: string;
+    /**
+     * Optional, provider-specific context data
+     */
+    ContextData?: T;
+};
+/**
+ * Result of moving a message
+ */
+export type MoveMessageResult<T = Record<string, any>> = BaseMessageResult & {
+    /**
+     * The new message ID after moving (some providers assign new IDs)
+     */
+    NewMessageID?: string;
+    /**
+     * If populated, holds provider-specific result data
+     */
+    Result?: T;
+};
+/**
+ * Represents a folder/mailbox in the provider's system
+ */
+export type MessageFolder = {
+    /**
+     * The unique ID of the folder
+     */
+    ID: string;
+    /**
+     * The display name of the folder
+     */
+    Name: string;
+    /**
+     * The ID of the parent folder, if any
+     */
+    ParentFolderID?: string;
+    /**
+     * The number of messages in the folder (if available)
+     */
+    MessageCount?: number;
+    /**
+     * The number of unread messages in the folder (if available)
+     */
+    UnreadCount?: number;
+    /**
+     * Whether this is a system folder (Inbox, Sent, Drafts, etc.)
+     */
+    IsSystemFolder?: boolean;
+    /**
+     * The type of system folder if IsSystemFolder is true
+     */
+    SystemFolderType?: 'inbox' | 'sent' | 'drafts' | 'trash' | 'spam' | 'archive' | 'other';
+};
+/**
+ * Parameters for listing folders
+ */
+export type ListFoldersParams<T = Record<string, any>> = {
+    /**
+     * Optional, the ID of the parent folder to list children of.
+     * If not provided, lists root-level folders.
+     */
+    ParentFolderID?: string;
+    /**
+     * Optional, include message counts in the response (defaults to false)
+     */
+    IncludeCounts?: boolean;
+    /**
+     * Optional, provider-specific context data
+     */
+    ContextData?: T;
+};
+/**
+ * Result of listing folders
+ */
+export type ListFoldersResult<T = Record<string, any>> = BaseMessageResult & {
+    /**
+     * The list of folders
+     */
+    Folders?: MessageFolder[];
+    /**
+     * If populated, holds provider-specific result data
+     */
+    Result?: T;
+};
+/**
+ * Parameters for marking message(s) as read or unread
+ */
+export type MarkAsReadParams<T = Record<string, any>> = {
+    /**
+     * The ID(s) of the message(s) to mark
+     */
+    MessageIDs: string[];
+    /**
+     * Whether to mark as read (true) or unread (false)
+     */
+    IsRead: boolean;
+    /**
+     * Optional, provider-specific context data
+     */
+    ContextData?: T;
+};
+/**
+ * Result of marking message(s) as read/unread
+ */
+export type MarkAsReadResult<T = Record<string, any>> = BaseMessageResult & {
+    /**
+     * If populated, holds provider-specific result data
+     */
+    Result?: T;
+};
+/**
+ * Parameters for archiving a message
+ */
+export type ArchiveMessageParams<T = Record<string, any>> = {
+    /**
+     * The ID of the message to archive
+     */
+    MessageID: string;
+    /**
+     * Optional, provider-specific context data
+     */
+    ContextData?: T;
+};
+/**
+ * Result of archiving a message
+ */
+export type ArchiveMessageResult<T = Record<string, any>> = BaseMessageResult & {
+    /**
+     * If populated, holds provider-specific result data
+     */
+    Result?: T;
+};
+/**
+ * Parameters for searching messages
+ */
+export type SearchMessagesParams<T = Record<string, any>> = {
+    /**
+     * The search query string
+     */
+    Query: string;
+    /**
+     * Maximum number of results to return
+     */
+    MaxResults?: number;
+    /**
+     * Optional folder ID to limit search scope
+     */
+    FolderID?: string;
+    /**
+     * Optional date range start
+     */
+    FromDate?: Date;
+    /**
+     * Optional date range end
+     */
+    ToDate?: Date;
+    /**
+     * Optional, search only in specific fields
+     */
+    SearchIn?: ('subject' | 'body' | 'from' | 'to' | 'all')[];
+    /**
+     * Optional, provider-specific context data
+     */
+    ContextData?: T;
+};
+/**
+ * Result of searching messages
+ */
+export type SearchMessagesResult<T = Record<string, any>> = BaseMessageResult & {
+    /**
+     * Messages matching the search criteria
+     */
+    Messages?: GetMessageMessage[];
+    /**
+     * Total number of matches (may be greater than returned results)
+     */
+    TotalCount?: number;
+    /**
+     * If populated, holds provider-specific result data
+     */
+    SourceData?: T[];
+};
+/**
+ * Represents an attachment on a message
+ */
+export type MessageAttachment = {
+    /**
+     * The unique ID of the attachment
+     */
+    ID: string;
+    /**
+     * The filename of the attachment
+     */
+    Filename: string;
+    /**
+     * The MIME type of the attachment
+     */
+    ContentType: string;
+    /**
+     * The size of the attachment in bytes
+     */
+    Size: number;
+    /**
+     * Whether this is an inline attachment (embedded in message body)
+     */
+    IsInline?: boolean;
+    /**
+     * Content ID for inline attachments
+     */
+    ContentID?: string;
+};
+/**
+ * Parameters for listing attachments on a message
+ */
+export type ListAttachmentsParams<T = Record<string, any>> = {
+    /**
+     * The ID of the message to list attachments for
+     */
+    MessageID: string;
+    /**
+     * Optional, provider-specific context data
+     */
+    ContextData?: T;
+};
+/**
+ * Result of listing attachments
+ */
+export type ListAttachmentsResult<T = Record<string, any>> = BaseMessageResult & {
+    /**
+     * The list of attachments
+     */
+    Attachments?: MessageAttachment[];
+    /**
+     * If populated, holds provider-specific result data
+     */
+    Result?: T;
+};
+/**
+ * Parameters for downloading an attachment
+ */
+export type DownloadAttachmentParams<T = Record<string, any>> = {
+    /**
+     * The ID of the message containing the attachment
+     */
+    MessageID: string;
+    /**
+     * The ID of the attachment to download
+     */
+    AttachmentID: string;
+    /**
+     * Optional, provider-specific context data
+     */
+    ContextData?: T;
+};
+/**
+ * Result of downloading an attachment
+ */
+export type DownloadAttachmentResult<T = Record<string, any>> = BaseMessageResult & {
+    /**
+     * The attachment content as a Buffer
+     */
+    Content?: Buffer;
+    /**
+     * The attachment content as a base64-encoded string
+     */
+    ContentBase64?: string;
+    /**
+     * The filename of the attachment
+     */
+    Filename?: string;
+    /**
+     * The MIME type of the attachment
+     */
+    ContentType?: string;
+    /**
+     * If populated, holds provider-specific result data
+     */
+    Result?: T;
+};
+/**
+ * Enumeration of all supported provider operations.
+ * Use with getSupportedOperations() to discover provider capabilities.
+ */
+export type ProviderOperation = 'SendSingleMessage' | 'GetMessages' | 'GetSingleMessage' | 'ForwardMessage' | 'ReplyToMessage' | 'CreateDraft' | 'DeleteMessage' | 'MoveMessage' | 'ListFolders' | 'MarkAsRead' | 'ArchiveMessage' | 'SearchMessages' | 'ListAttachments' | 'DownloadAttachment';
 /**
  * Base class for all communication providers. Each provider sub-classes this base class and implements functionality specific to the provider.
+ *
+ * @remarks
+ * All methods accept an optional `credentials` parameter that allows per-request credential overrides.
+ * When credentials are provided, they take precedence over environment variables.
+ * Set `credentials.disableEnvironmentFallback = true` to disable environment variable fallback.
+ *
+ * Each provider defines its own credential interface that extends `ProviderCredentialsBase`.
+ * For example, `SendGridCredentials`, `MSGraphCredentials`, etc.
+ *
+ * @example
+ * ```typescript
+ * // Use environment credentials (default behavior)
+ * await provider.SendSingleMessage(message);
+ *
+ * // Override with request credentials
+ * await provider.SendSingleMessage(message, { apiKey: 'SG.xxx' });
+ *
+ * // Require explicit credentials (no env fallback)
+ * await provider.SendSingleMessage(message, {
+ *     apiKey: 'SG.xxx',
+ *     disableEnvironmentFallback: true
+ * });
+ * ```
  */
 export declare abstract class BaseCommunicationProvider {
     /**
-     *
+     * Sends a single message using the provider
+     * @param message - The processed message to send
+     * @param credentials - Optional credentials override for this request.
+     *                      Provider-specific credential interface (e.g., SendGridCredentials).
+     *                      If not provided, uses environment variables.
+     * @returns Promise<MessageResult> - Result of the send operation
      */
-    abstract SendSingleMessage(message: ProcessedMessage): Promise<MessageResult>;
+    abstract SendSingleMessage(message: ProcessedMessage, credentials?: ProviderCredentialsBase): Promise<MessageResult>;
     /**
      * Fetches messages using the provider
+     * @param params - Parameters for fetching messages
+     * @param credentials - Optional credentials override for this request
+     * @returns Promise<GetMessagesResult> - Retrieved messages
      */
-    abstract GetMessages(params: GetMessagesParams): Promise<GetMessagesResult>;
+    abstract GetMessages(params: GetMessagesParams, credentials?: ProviderCredentialsBase): Promise<GetMessagesResult>;
     /**
      * Forwards a message to another client using the provider
+     * @param params - Parameters for forwarding the message
+     * @param credentials - Optional credentials override for this request
+     * @returns Promise<ForwardMessageResult> - Result of the forward operation
      */
-    abstract ForwardMessage(params: ForwardMessageParams): Promise<ForwardMessageResult>;
+    abstract ForwardMessage(params: ForwardMessageParams, credentials?: ProviderCredentialsBase): Promise<ForwardMessageResult>;
     /**
      * Replies to a message using the provider
+     * @param params - Parameters for replying to the message
+     * @param credentials - Optional credentials override for this request
+     * @returns Promise<ReplyToMessageResult> - Result of the reply operation
      */
-    abstract ReplyToMessage(params: ReplyToMessageParams): Promise<ReplyToMessageResult>;
+    abstract ReplyToMessage(params: ReplyToMessageParams, credentials?: ProviderCredentialsBase): Promise<ReplyToMessageResult>;
     /**
      * Creates a draft message using the provider.
      * Providers that don't support drafts should return Success: false
      * with an appropriate error message.
      * @param params - Parameters for creating the draft
+     * @param credentials - Optional credentials override for this request
      * @returns Promise<CreateDraftResult> - Result containing draft ID if successful
      */
-    abstract CreateDraft(params: CreateDraftParams): Promise<CreateDraftResult>;
+    abstract CreateDraft(params: CreateDraftParams, credentials?: ProviderCredentialsBase): Promise<CreateDraftResult>;
+    /**
+     * Returns the name of this provider for use in error messages.
+     * Override in subclasses to provide a more descriptive name.
+     */
+    protected get ProviderName(): string;
+    /**
+     * Returns the list of operations supported by this provider.
+     * Override in subclasses to accurately reflect capabilities.
+     * Default implementation returns only the core abstract methods.
+     */
+    getSupportedOperations(): ProviderOperation[];
+    /**
+     * Checks if this provider supports a specific operation.
+     * @param operation - The operation to check
+     * @returns true if the operation is supported
+     */
+    supportsOperation(operation: ProviderOperation): boolean;
+    /**
+     * Gets a single message by ID.
+     * Override in subclasses that support this operation.
+     * @param params - Parameters for retrieving the message
+     * @param credentials - Optional credentials override for this request
+     * @returns Promise<GetSingleMessageResult> - The retrieved message
+     */
+    GetSingleMessage(params: GetSingleMessageParams, credentials?: ProviderCredentialsBase): Promise<GetSingleMessageResult>;
+    /**
+     * Deletes a message.
+     * Override in subclasses that support this operation.
+     * @param params - Parameters for deleting the message
+     * @param credentials - Optional credentials override for this request
+     * @returns Promise<DeleteMessageResult> - Result of the delete operation
+     */
+    DeleteMessage(params: DeleteMessageParams, credentials?: ProviderCredentialsBase): Promise<DeleteMessageResult>;
+    /**
+     * Moves a message to a different folder.
+     * Override in subclasses that support this operation.
+     * @param params - Parameters for moving the message
+     * @param credentials - Optional credentials override for this request
+     * @returns Promise<MoveMessageResult> - Result of the move operation
+     */
+    MoveMessage(params: MoveMessageParams, credentials?: ProviderCredentialsBase): Promise<MoveMessageResult>;
+    /**
+     * Lists folders/mailboxes available in the provider.
+     * Override in subclasses that support this operation.
+     * @param params - Parameters for listing folders
+     * @param credentials - Optional credentials override for this request
+     * @returns Promise<ListFoldersResult> - The list of folders
+     */
+    ListFolders(params: ListFoldersParams, credentials?: ProviderCredentialsBase): Promise<ListFoldersResult>;
+    /**
+     * Marks message(s) as read or unread.
+     * Override in subclasses that support this operation.
+     * @param params - Parameters for marking messages
+     * @param credentials - Optional credentials override for this request
+     * @returns Promise<MarkAsReadResult> - Result of the operation
+     */
+    MarkAsRead(params: MarkAsReadParams, credentials?: ProviderCredentialsBase): Promise<MarkAsReadResult>;
+    /**
+     * Archives a message.
+     * Override in subclasses that support this operation.
+     * @param params - Parameters for archiving the message
+     * @param credentials - Optional credentials override for this request
+     * @returns Promise<ArchiveMessageResult> - Result of the archive operation
+     */
+    ArchiveMessage(params: ArchiveMessageParams, credentials?: ProviderCredentialsBase): Promise<ArchiveMessageResult>;
+    /**
+     * Searches messages using a query string.
+     * Override in subclasses that support this operation.
+     * @param params - Parameters for searching messages
+     * @param credentials - Optional credentials override for this request
+     * @returns Promise<SearchMessagesResult> - Messages matching the search criteria
+     */
+    SearchMessages(params: SearchMessagesParams, credentials?: ProviderCredentialsBase): Promise<SearchMessagesResult>;
+    /**
+     * Lists attachments on a message.
+     * Override in subclasses that support this operation.
+     * @param params - Parameters for listing attachments
+     * @param credentials - Optional credentials override for this request
+     * @returns Promise<ListAttachmentsResult> - The list of attachments
+     */
+    ListAttachments(params: ListAttachmentsParams, credentials?: ProviderCredentialsBase): Promise<ListAttachmentsResult>;
+    /**
+     * Downloads an attachment from a message.
+     * Override in subclasses that support this operation.
+     * @param params - Parameters for downloading the attachment
+     * @param credentials - Optional credentials override for this request
+     * @returns Promise<DownloadAttachmentResult> - The attachment content
+     */
+    DownloadAttachment(params: DownloadAttachmentParams, credentials?: ProviderCredentialsBase): Promise<DownloadAttachmentResult>;
 }
 export declare class CommunicationProviderEntityExtended extends CommunicationProviderEntity {
     private _ProviderMessageTypes;

package/dist/BaseProvider.d.ts.map

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

package/dist/BaseProvider.js

@@ -43,8 +43,175 @@ exports.MessageResult = MessageResult;
 ;
 /**
  * Base class for all communication providers. Each provider sub-classes this base class and implements functionality specific to the provider.
+ *
+ * @remarks
+ * All methods accept an optional `credentials` parameter that allows per-request credential overrides.
+ * When credentials are provided, they take precedence over environment variables.
+ * Set `credentials.disableEnvironmentFallback = true` to disable environment variable fallback.
+ *
+ * Each provider defines its own credential interface that extends `ProviderCredentialsBase`.
+ * For example, `SendGridCredentials`, `MSGraphCredentials`, etc.
+ *
+ * @example
+ * ```typescript
+ * // Use environment credentials (default behavior)
+ * await provider.SendSingleMessage(message);
+ *
+ * // Override with request credentials
+ * await provider.SendSingleMessage(message, { apiKey: 'SG.xxx' });
+ *
+ * // Require explicit credentials (no env fallback)
+ * await provider.SendSingleMessage(message, {
+ *     apiKey: 'SG.xxx',
+ *     disableEnvironmentFallback: true
+ * });
+ * ```
  */
 class BaseCommunicationProvider {
+    // ========================================================================
+    // OPTIONAL OPERATIONS - Override in subclasses to provide implementation
+    // Default implementations return "not supported" error
+    // ========================================================================
+    /**
+     * Returns the name of this provider for use in error messages.
+     * Override in subclasses to provide a more descriptive name.
+     */
+    get ProviderName() {
+        return this.constructor.name;
+    }
+    /**
+     * Returns the list of operations supported by this provider.
+     * Override in subclasses to accurately reflect capabilities.
+     * Default implementation returns only the core abstract methods.
+     */
+    getSupportedOperations() {
+        return ['SendSingleMessage', 'GetMessages', 'ForwardMessage', 'ReplyToMessage', 'CreateDraft'];
+    }
+    /**
+     * Checks if this provider supports a specific operation.
+     * @param operation - The operation to check
+     * @returns true if the operation is supported
+     */
+    supportsOperation(operation) {
+        return this.getSupportedOperations().includes(operation);
+    }
+    /**
+     * Gets a single message by ID.
+     * Override in subclasses that support this operation.
+     * @param params - Parameters for retrieving the message
+     * @param credentials - Optional credentials override for this request
+     * @returns Promise<GetSingleMessageResult> - The retrieved message
+     */
+    async GetSingleMessage(params, credentials) {
+        return {
+            Success: false,
+            ErrorMessage: `${this.ProviderName} does not support GetSingleMessage (MessageID: ${params.MessageID}, credentials provided: ${!!credentials})`
+        };
+    }
+    /**
+     * Deletes a message.
+     * Override in subclasses that support this operation.
+     * @param params - Parameters for deleting the message
+     * @param credentials - Optional credentials override for this request
+     * @returns Promise<DeleteMessageResult> - Result of the delete operation
+     */
+    async DeleteMessage(params, credentials) {
+        return {
+            Success: false,
+            ErrorMessage: `${this.ProviderName} does not support DeleteMessage (MessageID: ${params.MessageID}, credentials provided: ${!!credentials})`
+        };
+    }
+    /**
+     * Moves a message to a different folder.
+     * Override in subclasses that support this operation.
+     * @param params - Parameters for moving the message
+     * @param credentials - Optional credentials override for this request
+     * @returns Promise<MoveMessageResult> - Result of the move operation
+     */
+    async MoveMessage(params, credentials) {
+        return {
+            Success: false,
+            ErrorMessage: `${this.ProviderName} does not support MoveMessage (MessageID: ${params.MessageID}, DestinationFolderID: ${params.DestinationFolderID}, credentials provided: ${!!credentials})`
+        };
+    }
+    /**
+     * Lists folders/mailboxes available in the provider.
+     * Override in subclasses that support this operation.
+     * @param params - Parameters for listing folders
+     * @param credentials - Optional credentials override for this request
+     * @returns Promise<ListFoldersResult> - The list of folders
+     */
+    async ListFolders(params, credentials) {
+        return {
+            Success: false,
+            ErrorMessage: `${this.ProviderName} does not support ListFolders (ParentFolderID: ${params.ParentFolderID || 'root'}, credentials provided: ${!!credentials})`
+        };
+    }
+    /**
+     * Marks message(s) as read or unread.
+     * Override in subclasses that support this operation.
+     * @param params - Parameters for marking messages
+     * @param credentials - Optional credentials override for this request
+     * @returns Promise<MarkAsReadResult> - Result of the operation
+     */
+    async MarkAsRead(params, credentials) {
+        return {
+            Success: false,
+            ErrorMessage: `${this.ProviderName} does not support MarkAsRead (MessageIDs: ${params.MessageIDs.length} message(s), IsRead: ${params.IsRead}, credentials provided: ${!!credentials})`
+        };
+    }
+    /**
+     * Archives a message.
+     * Override in subclasses that support this operation.
+     * @param params - Parameters for archiving the message
+     * @param credentials - Optional credentials override for this request
+     * @returns Promise<ArchiveMessageResult> - Result of the archive operation
+     */
+    async ArchiveMessage(params, credentials) {
+        return {
+            Success: false,
+            ErrorMessage: `${this.ProviderName} does not support ArchiveMessage (MessageID: ${params.MessageID}, credentials provided: ${!!credentials})`
+        };
+    }
+    /**
+     * Searches messages using a query string.
+     * Override in subclasses that support this operation.
+     * @param params - Parameters for searching messages
+     * @param credentials - Optional credentials override for this request
+     * @returns Promise<SearchMessagesResult> - Messages matching the search criteria
+     */
+    async SearchMessages(params, credentials) {
+        return {
+            Success: false,
+            ErrorMessage: `${this.ProviderName} does not support SearchMessages (Query: ${params.Query}, credentials provided: ${!!credentials})`
+        };
+    }
+    /**
+     * Lists attachments on a message.
+     * Override in subclasses that support this operation.
+     * @param params - Parameters for listing attachments
+     * @param credentials - Optional credentials override for this request
+     * @returns Promise<ListAttachmentsResult> - The list of attachments
+     */
+    async ListAttachments(params, credentials) {
+        return {
+            Success: false,
+            ErrorMessage: `${this.ProviderName} does not support ListAttachments (MessageID: ${params.MessageID}, credentials provided: ${!!credentials})`
+        };
+    }
+    /**
+     * Downloads an attachment from a message.
+     * Override in subclasses that support this operation.
+     * @param params - Parameters for downloading the attachment
+     * @param credentials - Optional credentials override for this request
+     * @returns Promise<DownloadAttachmentResult> - The attachment content
+     */
+    async DownloadAttachment(params, credentials) {
+        return {
+            Success: false,
+            ErrorMessage: `${this.ProviderName} does not support DownloadAttachment (MessageID: ${params.MessageID}, AttachmentID: ${params.AttachmentID}, credentials provided: ${!!credentials})`
+        };
+    }
 }
 exports.BaseCommunicationProvider = BaseCommunicationProvider;
 let CommunicationProviderEntityExtended = class CommunicationProviderEntityExtended extends core_entities_1.CommunicationProviderEntity {

package/dist/BaseProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"BaseProvider.js","sourceRoot":"","sources":["../src/BaseProvider.ts"],"names":[],"mappings":";;;;;;;;;AAAA,+CAA4D;AAC5D,mDAAuD;AACvD,iEAAoK;AAEpK;;GAEG;AACH,MAAa,gBAAgB;CAe5B;AAfD,4CAeC;AAGD;;GAEG;AACH,MAAa,OAAO;IAgFhB,YAAY,QAAkB;QAC1B,yEAAyE;QACzE,IAAI,QAAQ,EAAC,CAAC;YACV,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAClC,CAAC;IACL,CAAC;CACJ;AAtFD,0BAsFC;AAED;;GAEG;AACH,MAAsB,gBAAiB,SAAQ,OAAO;CAkBrD;AAlBD,4CAkBC;AAED;;GAEG;AACH,MAAa,aAAa;CAKzB;AALD,sCAKC;AAAA,CAAC;AA2IF;;GAEG;AACH,MAAsB,yBAAyB;CA8B9C;AA9BD,8DA8BC;AAGM,IAAM,mCAAmC,GAAzC,MAAM,mCAAoC,SAAQ,2CAA2B;IAEhF,IAAW,YAAY;QACnB,OAAO,IAAI,CAAC,qBAAqB,CAAC;IACtC,CAAC;IACD,IAAW,YAAY,CAAC,KAA+C;QACnE,IAAI,CAAC,qBAAqB,GAAG,KAAK,CAAC;IACvC,CAAC;CACJ,CAAA;AARY,kFAAmC;8CAAnC,mCAAmC;IAD/C,IAAA,sBAAa,EAAC,iBAAU,EAAE,yBAAyB,CAAC,CAAC,wDAAwD;GACjG,mCAAmC,CAQ/C"}
+{"version":3,"file":"BaseProvider.js","sourceRoot":"","sources":["../src/BaseProvider.ts"],"names":[],"mappings":";;;;;;;;;AAAA,+CAA4D;AAC5D,mDAAuD;AACvD,iEAAoK;AAGpK;;GAEG;AACH,MAAa,gBAAgB;CAe5B;AAfD,4CAeC;AAGD;;GAEG;AACH,MAAa,OAAO;IAgFhB,YAAY,QAAkB;QAC1B,yEAAyE;QACzE,IAAI,QAAQ,EAAC,CAAC;YACV,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAClC,CAAC;IACL,CAAC;CACJ;AAtFD,0BAsFC;AAED;;GAEG;AACH,MAAsB,gBAAiB,SAAQ,OAAO;CAkBrD;AAlBD,4CAkBC;AAED;;GAEG;AACH,MAAa,aAAa;CAKzB;AALD,sCAKC;AAAA,CAAC;AAshBF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAsB,yBAAyB;IA4D3C,2EAA2E;IAC3E,yEAAyE;IACzE,uDAAuD;IACvD,2EAA2E;IAE3E;;;OAGG;IACH,IAAc,YAAY;QACtB,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;IACjC,CAAC;IAED;;;;OAIG;IACI,sBAAsB;QACzB,OAAO,CAAC,mBAAmB,EAAE,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,aAAa,CAAC,CAAC;IACnG,CAAC;IAED;;;;OAIG;IACI,iBAAiB,CAAC,SAA4B;QACjD,OAAO,IAAI,CAAC,sBAAsB,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,gBAAgB,CACzB,MAA8B,EAC9B,WAAqC;QAErC,OAAO;YACH,OAAO,EAAE,KAAK;YACd,YAAY,EAAE,GAAG,IAAI,CAAC,YAAY,kDAAkD,MAAM,CAAC,SAAS,2BAA2B,CAAC,CAAC,WAAW,GAAG;SAClJ,CAAC;IACN,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,aAAa,CACtB,MAA2B,EAC3B,WAAqC;QAErC,OAAO;YACH,OAAO,EAAE,KAAK;YACd,YAAY,EAAE,GAAG,IAAI,CAAC,YAAY,+CAA+C,MAAM,CAAC,SAAS,2BAA2B,CAAC,CAAC,WAAW,GAAG;SAC/I,CAAC;IACN,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,WAAW,CACpB,MAAyB,EACzB,WAAqC;QAErC,OAAO;YACH,OAAO,EAAE,KAAK;YACd,YAAY,EAAE,GAAG,IAAI,CAAC,YAAY,6CAA6C,MAAM,CAAC,SAAS,0BAA0B,MAAM,CAAC,mBAAmB,2BAA2B,CAAC,CAAC,WAAW,GAAG;SACjM,CAAC;IACN,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,WAAW,CACpB,MAAyB,EACzB,WAAqC;QAErC,OAAO;YACH,OAAO,EAAE,KAAK;YACd,YAAY,EAAE,GAAG,IAAI,CAAC,YAAY,kDAAkD,MAAM,CAAC,cAAc,IAAI,MAAM,2BAA2B,CAAC,CAAC,WAAW,GAAG;SACjK,CAAC;IACN,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,UAAU,CACnB,MAAwB,EACxB,WAAqC;QAErC,OAAO;YACH,OAAO,EAAE,KAAK;YACd,YAAY,EAAE,GAAG,IAAI,CAAC,YAAY,6CAA6C,MAAM,CAAC,UAAU,CAAC,MAAM,wBAAwB,MAAM,CAAC,MAAM,2BAA2B,CAAC,CAAC,WAAW,GAAG;SAC1L,CAAC;IACN,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,cAAc,CACvB,MAA4B,EAC5B,WAAqC;QAErC,OAAO;YACH,OAAO,EAAE,KAAK;YACd,YAAY,EAAE,GAAG,IAAI,CAAC,YAAY,gDAAgD,MAAM,CAAC,SAAS,2BAA2B,CAAC,CAAC,WAAW,GAAG;SAChJ,CAAC;IACN,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,cAAc,CACvB,MAA4B,EAC5B,WAAqC;QAErC,OAAO;YACH,OAAO,EAAE,KAAK;YACd,YAAY,EAAE,GAAG,IAAI,CAAC,YAAY,4CAA4C,MAAM,CAAC,KAAK,2BAA2B,CAAC,CAAC,WAAW,GAAG;SACxI,CAAC;IACN,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,eAAe,CACxB,MAA6B,EAC7B,WAAqC;QAErC,OAAO;YACH,OAAO,EAAE,KAAK;YACd,YAAY,EAAE,GAAG,IAAI,CAAC,YAAY,iDAAiD,MAAM,CAAC,SAAS,2BAA2B,CAAC,CAAC,WAAW,GAAG;SACjJ,CAAC;IACN,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,kBAAkB,CAC3B,MAAgC,EAChC,WAAqC;QAErC,OAAO;YACH,OAAO,EAAE,KAAK;YACd,YAAY,EAAE,GAAG,IAAI,CAAC,YAAY,oDAAoD,MAAM,CAAC,SAAS,mBAAmB,MAAM,CAAC,YAAY,2BAA2B,CAAC,CAAC,WAAW,GAAG;SAC1L,CAAC;IACN,CAAC;CAEJ;AApPD,8DAoPC;AAGM,IAAM,mCAAmC,GAAzC,MAAM,mCAAoC,SAAQ,2CAA2B;IAEhF,IAAW,YAAY;QACnB,OAAO,IAAI,CAAC,qBAAqB,CAAC;IACtC,CAAC;IACD,IAAW,YAAY,CAAC,KAA+C;QACnE,IAAI,CAAC,qBAAqB,GAAG,KAAK,CAAC;IACvC,CAAC;CACJ,CAAA;AARY,kFAAmC;8CAAnC,mCAAmC;IAD/C,IAAA,sBAAa,EAAC,iBAAU,EAAE,yBAAyB,CAAC,CAAC,wDAAwD;GACjG,mCAAmC,CAQ/C"}

package/dist/CredentialUtils.d.ts

@@ -0,0 +1,148 @@
+/**
+ * Credential utilities for MemberJunction Communication providers.
+ *
+ * This module provides interim credential management functionality that allows
+ * per-request credential overrides while maintaining backward compatibility
+ * with environment variable-based configuration.
+ *
+ * @module CredentialUtils
+ */
+/**
+ * Base interface for provider credentials.
+ * Each provider extends this with their specific credential fields.
+ *
+ * @remarks
+ * **TEMPORARY INTERFACE**: This interface is an interim solution for the 2.x patch release.
+ * In MemberJunction 3.0, this will be replaced by a more comprehensive credential management
+ * system with database storage, encryption, and multi-tenancy support. The replacement
+ * interface will be located in `@memberjunction/credentials` or `@memberjunction/core`.
+ *
+ * This interface is designed to be forward-compatible with the 3.0 `CredentialResolutionOptions`
+ * system. When migrating to 3.0, credential objects passed using this interface will work
+ * with the new system's `directValues` parameter.
+ *
+ * @see plans/3_0_credentials_design.md for the full 3.0 credential system design
+ *
+ * @example
+ * ```typescript
+ * // Provider-specific credentials extend this base
+ * interface SendGridCredentials extends ProviderCredentialsBase {
+ *     apiKey?: string;
+ * }
+ *
+ * // Usage with fallback enabled (default)
+ * await provider.SendSingleMessage(message, { apiKey: 'SG.xxx' });
+ *
+ * // Usage with fallback disabled
+ * await provider.SendSingleMessage(message, {
+ *     apiKey: 'SG.xxx',
+ *     disableEnvironmentFallback: true
+ * });
+ * ```
+ */
+export interface ProviderCredentialsBase {
+    /**
+     * When true, environment variable fallback is DISABLED for this request.
+     * If credentials are incomplete and this is true, the request will fail
+     * rather than falling back to environment variables.
+     *
+     * @default false (fallback enabled for backward compatibility)
+     *
+     * @example
+     * ```typescript
+     * // With fallback (default) - uses env var if apiKey not provided
+     * await provider.SendSingleMessage(message, {});
+     *
+     * // Without fallback - fails if apiKey not provided
+     * await provider.SendSingleMessage(message, {
+     *     disableEnvironmentFallback: true
+     * });
+     * ```
+     */
+    disableEnvironmentFallback?: boolean;
+}
+/**
+ * Resolves a single credential value by checking the request value first,
+ * then falling back to the environment value if allowed.
+ *
+ * @param requestValue - Value provided in the request (takes precedence)
+ * @param envValue - Value from environment variable (fallback)
+ * @param disableFallback - If true, don't use the environment value
+ * @returns The resolved value, or undefined if not available
+ *
+ * @example
+ * ```typescript
+ * const apiKey = resolveCredentialValue(
+ *     credentials?.apiKey,           // From request
+ *     process.env.SENDGRID_API_KEY,  // From environment
+ *     credentials?.disableEnvironmentFallback ?? false
+ * );
+ * ```
+ */
+export declare function resolveCredentialValue<T>(requestValue: T | undefined, envValue: T | undefined, disableFallback: boolean): T | undefined;
+/**
+ * Validates that all required credential fields are present in the resolved credentials.
+ * Throws an error if any required fields are missing.
+ *
+ * @param resolved - Object containing resolved credential values
+ * @param requiredFields - Array of field names that must be present
+ * @param providerName - Name of the provider (for error messages)
+ * @throws Error if any required fields are missing
+ *
+ * @example
+ * ```typescript
+ * const resolved = {
+ *     apiKey: resolveCredentialValue(creds?.apiKey, envApiKey, disableFallback)
+ * };
+ *
+ * validateRequiredCredentials(resolved, ['apiKey'], 'SendGrid');
+ * // Throws: "Missing required credentials for SendGrid: apiKey. Provide in request or set environment variables."
+ * ```
+ */
+export declare function validateRequiredCredentials(resolved: Record<string, unknown>, requiredFields: string[], providerName: string): void;
+/**
+ * Result of credential resolution, tracking where each value came from.
+ * Useful for debugging and audit logging.
+ *
+ * @remarks
+ * This interface is designed to be forward-compatible with the 3.0 credential
+ * system's `ResolvedCredential` interface.
+ */
+export interface CredentialResolutionResult<T extends Record<string, unknown>> {
+    /**
+     * The resolved credential values
+     */
+    values: T;
+    /**
+     * Source of the credentials: 'request', 'environment', or 'mixed'
+     */
+    source: 'request' | 'environment' | 'mixed';
+    /**
+     * Which fields came from request vs environment (for debugging)
+     */
+    fieldSources: Record<keyof T, 'request' | 'environment'>;
+}
+/**
+ * Resolves multiple credential fields at once, tracking the source of each value.
+ *
+ * @param requestCredentials - Credentials provided in the request
+ * @param envCredentials - Credentials from environment variables
+ * @param fieldNames - Array of field names to resolve
+ * @param disableFallback - If true, don't use environment values
+ * @returns Resolution result with values and source tracking
+ *
+ * @example
+ * ```typescript
+ * const result = resolveCredentials(
+ *     credentials,
+ *     { tenantId: process.env.AZURE_TENANT_ID, clientId: process.env.AZURE_CLIENT_ID },
+ *     ['tenantId', 'clientId', 'clientSecret'],
+ *     credentials?.disableEnvironmentFallback ?? false
+ * );
+ *
+ * console.log(result.source); // 'mixed' if some from request, some from env
+ * console.log(result.fieldSources); // { tenantId: 'request', clientId: 'environment', ... }
+ * ```
+ */
+export declare function resolveCredentials<T extends Record<string, unknown>>(requestCredentials: Partial<T> | undefined, envCredentials: Partial<T>, fieldNames: (keyof T)[], disableFallback: boolean): CredentialResolutionResult<Partial<T>>;
+//# sourceMappingURL=CredentialUtils.d.ts.map

package/dist/CredentialUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CredentialUtils.d.ts","sourceRoot":"","sources":["../src/CredentialUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,WAAW,uBAAuB;IACpC;;;;;;;;;;;;;;;;;OAiBG;IACH,0BAA0B,CAAC,EAAE,OAAO,CAAC;CACxC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EACpC,YAAY,EAAE,CAAC,GAAG,SAAS,EAC3B,QAAQ,EAAE,CAAC,GAAG,SAAS,EACvB,eAAe,EAAE,OAAO,GACzB,CAAC,GAAG,SAAS,CAYf;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,2BAA2B,CACvC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,cAAc,EAAE,MAAM,EAAE,EACxB,YAAY,EAAE,MAAM,GACrB,IAAI,CAWN;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,0BAA0B,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACzE;;OAEG;IACH,MAAM,EAAE,CAAC,CAAC;IAEV;;OAEG;IACH,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,OAAO,CAAC;IAE5C;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,aAAa,CAAC,CAAC;CAC5D;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChE,kBAAkB,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,EAC1C,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC,EAC1B,UAAU,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,EACvB,eAAe,EAAE,OAAO,GACzB,0BAA0B,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAkCxC"}

package/dist/CredentialUtils.js

@@ -0,0 +1,123 @@
+"use strict";
+/**
+ * Credential utilities for MemberJunction Communication providers.
+ *
+ * This module provides interim credential management functionality that allows
+ * per-request credential overrides while maintaining backward compatibility
+ * with environment variable-based configuration.
+ *
+ * @module CredentialUtils
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveCredentials = exports.validateRequiredCredentials = exports.resolveCredentialValue = void 0;
+/**
+ * Resolves a single credential value by checking the request value first,
+ * then falling back to the environment value if allowed.
+ *
+ * @param requestValue - Value provided in the request (takes precedence)
+ * @param envValue - Value from environment variable (fallback)
+ * @param disableFallback - If true, don't use the environment value
+ * @returns The resolved value, or undefined if not available
+ *
+ * @example
+ * ```typescript
+ * const apiKey = resolveCredentialValue(
+ *     credentials?.apiKey,           // From request
+ *     process.env.SENDGRID_API_KEY,  // From environment
+ *     credentials?.disableEnvironmentFallback ?? false
+ * );
+ * ```
+ */
+function resolveCredentialValue(requestValue, envValue, disableFallback) {
+    // Request value takes precedence if it's a non-empty value
+    if (requestValue !== undefined && requestValue !== null && requestValue !== '') {
+        return requestValue;
+    }
+    // Fall back to environment value if allowed
+    if (!disableFallback) {
+        return envValue;
+    }
+    return undefined;
+}
+exports.resolveCredentialValue = resolveCredentialValue;
+/**
+ * Validates that all required credential fields are present in the resolved credentials.
+ * Throws an error if any required fields are missing.
+ *
+ * @param resolved - Object containing resolved credential values
+ * @param requiredFields - Array of field names that must be present
+ * @param providerName - Name of the provider (for error messages)
+ * @throws Error if any required fields are missing
+ *
+ * @example
+ * ```typescript
+ * const resolved = {
+ *     apiKey: resolveCredentialValue(creds?.apiKey, envApiKey, disableFallback)
+ * };
+ *
+ * validateRequiredCredentials(resolved, ['apiKey'], 'SendGrid');
+ * // Throws: "Missing required credentials for SendGrid: apiKey. Provide in request or set environment variables."
+ * ```
+ */
+function validateRequiredCredentials(resolved, requiredFields, providerName) {
+    const missing = requiredFields.filter(field => resolved[field] === undefined || resolved[field] === null || resolved[field] === '');
+    if (missing.length > 0) {
+        throw new Error(`Missing required credentials for ${providerName}: ${missing.join(', ')}. ` +
+            `Provide in request or set environment variables.`);
+    }
+}
+exports.validateRequiredCredentials = validateRequiredCredentials;
+/**
+ * Resolves multiple credential fields at once, tracking the source of each value.
+ *
+ * @param requestCredentials - Credentials provided in the request
+ * @param envCredentials - Credentials from environment variables
+ * @param fieldNames - Array of field names to resolve
+ * @param disableFallback - If true, don't use environment values
+ * @returns Resolution result with values and source tracking
+ *
+ * @example
+ * ```typescript
+ * const result = resolveCredentials(
+ *     credentials,
+ *     { tenantId: process.env.AZURE_TENANT_ID, clientId: process.env.AZURE_CLIENT_ID },
+ *     ['tenantId', 'clientId', 'clientSecret'],
+ *     credentials?.disableEnvironmentFallback ?? false
+ * );
+ *
+ * console.log(result.source); // 'mixed' if some from request, some from env
+ * console.log(result.fieldSources); // { tenantId: 'request', clientId: 'environment', ... }
+ * ```
+ */
+function resolveCredentials(requestCredentials, envCredentials, fieldNames, disableFallback) {
+    const values = {};
+    const fieldSources = {};
+    let hasRequest = false;
+    let hasEnv = false;
+    for (const field of fieldNames) {
+        const requestValue = requestCredentials?.[field];
+        const envValue = envCredentials[field];
+        // Check if request has a valid value
+        const requestHasValue = requestValue !== undefined && requestValue !== null && requestValue !== '';
+        const envHasValue = envValue !== undefined && envValue !== null && envValue !== '';
+        if (requestHasValue) {
+            values[field] = requestValue;
+            fieldSources[field] = 'request';
+            hasRequest = true;
+        }
+        else if (envHasValue && !disableFallback) {
+            values[field] = envValue;
+            fieldSources[field] = 'environment';
+            hasEnv = true;
+        }
+    }
+    const source = hasRequest && hasEnv ? 'mixed' :
+        hasRequest ? 'request' : 'environment';
+    return {
+        values,
+        source,
+        fieldSources: fieldSources
+    };
+}
+exports.resolveCredentials = resolveCredentials;
+//# sourceMappingURL=CredentialUtils.js.map

package/dist/CredentialUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CredentialUtils.js","sourceRoot":"","sources":["../src/CredentialUtils.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAyDH;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAgB,sBAAsB,CAClC,YAA2B,EAC3B,QAAuB,EACvB,eAAwB;IAExB,2DAA2D;IAC3D,IAAI,YAAY,KAAK,SAAS,IAAI,YAAY,KAAK,IAAI,IAAI,YAAY,KAAK,EAAE,EAAE,CAAC;QAC7E,OAAO,YAAY,CAAC;IACxB,CAAC;IAED,4CAA4C;IAC5C,IAAI,CAAC,eAAe,EAAE,CAAC;QACnB,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED,OAAO,SAAS,CAAC;AACrB,CAAC;AAhBD,wDAgBC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,2BAA2B,CACvC,QAAiC,EACjC,cAAwB,EACxB,YAAoB;IAEpB,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,CACjC,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,SAAS,IAAI,QAAQ,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,CAC/F,CAAC;IAEF,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACX,oCAAoC,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YAC3E,kDAAkD,CACrD,CAAC;IACN,CAAC;AACL,CAAC;AAfD,kEAeC;AA2BD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,SAAgB,kBAAkB,CAC9B,kBAA0C,EAC1C,cAA0B,EAC1B,UAAuB,EACvB,eAAwB;IAExB,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,MAAM,YAAY,GAA8C,EAAE,CAAC;IAEnE,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,IAAI,MAAM,GAAG,KAAK,CAAC;IAEnB,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;QAC7B,MAAM,YAAY,GAAG,kBAAkB,EAAE,CAAC,KAAK,CAAC,CAAC;QACjD,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QAEvC,qCAAqC;QACrC,MAAM,eAAe,GAAG,YAAY,KAAK,SAAS,IAAI,YAAY,KAAK,IAAI,IAAI,YAAY,KAAK,EAAE,CAAC;QACnG,MAAM,WAAW,GAAG,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,EAAE,CAAC;QAEnF,IAAI,eAAe,EAAE,CAAC;YAClB,MAAM,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC;YAC7B,YAAY,CAAC,KAAe,CAAC,GAAG,SAAS,CAAC;YAC1C,UAAU,GAAG,IAAI,CAAC;QACtB,CAAC;aAAM,IAAI,WAAW,IAAI,CAAC,eAAe,EAAE,CAAC;YACzC,MAAM,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC;YACzB,YAAY,CAAC,KAAe,CAAC,GAAG,aAAa,CAAC;YAC9C,MAAM,GAAG,IAAI,CAAC;QAClB,CAAC;IACL,CAAC;IAED,MAAM,MAAM,GAAG,UAAU,IAAI,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAChC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC;IAEtD,OAAO;QACH,MAAM;QACN,MAAM;QACN,YAAY,EAAE,YAA0D;KAC3E,CAAC;AACN,CAAC;AAvCD,gDAuCC"}

package/dist/index.d.ts

@@ -1,3 +1,4 @@
 export * from './BaseEngine';
 export * from './BaseProvider';
+export * from './CredentialUtils';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC"}

package/dist/index.js

@@ -17,4 +17,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
 // PUBLIC API SURFACE AREA
 __exportStar(require("./BaseEngine"), exports);
 __exportStar(require("./BaseProvider"), exports);
+__exportStar(require("./CredentialUtils"), exports);
 //# 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,+CAA6B;AAC7B,iDAA+B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0BAA0B;AAC1B,+CAA6B;AAC7B,iDAA+B;AAC/B,oDAAkC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memberjunction/communication-types",
-  "version": "2.123.1",
+  "version": "2.125.0",
   "description": "MemberJunction: Communication Framework Library Generic Types",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -19,10 +19,10 @@
     "typescript": "^5.4.5"
   },
   "dependencies": {
-    "@memberjunction/global": "2.123.1",
-    "@memberjunction/core": "2.123.1",
-    "@memberjunction/templates-base-types": "2.123.1",
-    "@memberjunction/core-entities": "2.123.1",
+    "@memberjunction/global": "2.125.0",
+    "@memberjunction/core": "2.125.0",
+    "@memberjunction/templates-base-types": "2.125.0",
+    "@memberjunction/core-entities": "2.125.0",
     "rxjs": "^7.8.1"
   },
   "repository": {