@blackcode_sa/metaestetics-api 1.5.51 → 1.6.0

package/dist/admin/index.d.mts

@@ -1,7 +1,6 @@
 import { Timestamp } from 'firebase/firestore';
 import * as admin from 'firebase-admin';
 import { Timestamp as Timestamp$1 } from 'firebase-admin/firestore';
-import * as mailgun from 'mailgun-js';
 
 /**
  * Enum for element types in documentation templates
@@ -1507,50 +1506,37 @@ declare class PatientAggregationService {
 }
 
 /**
- * Mailgun client type for compatibility with new mailgun.js library
- * This allows us to accept both older mailgun-js and newer mailgun.js clients
+ * Minimal interface for the new mailgun.js client's messages API
+ * This helps avoid a direct dependency on mailgun.js in the API package if not desired,
+ * or provides clearer typing if it is.
  */
-interface MailgunClientCompat {
-    messages: {
-        create?: (domain: string, data: any) => Promise<any>;
-        send?: (data: any, callback: (error: any, body: any) => void) => void;
-    };
+interface NewMailgunMessagesAPI$1 {
+    create(domain: string, data: any): Promise<any>;
+}
+interface NewMailgunClient$1 {
+    messages: NewMailgunMessagesAPI$1;
 }
 /**
  * Base mailing service class that provides common functionality for all mailing services
+ * This version is updated to expect a mailgun.js v10+ client.
  */
 declare class BaseMailingService {
     protected db: FirebaseFirestore.Firestore;
-    protected mailgunClient: mailgun.Mailgun | MailgunClientCompat;
-    protected isNewMailgunClient: boolean;
+    protected mailgunClient: NewMailgunClient$1;
     /**
      * Constructor for BaseMailingService
      * @param firestore Firestore instance provided by the caller
-     * @param mailgunClient Mailgun client instance provided by the caller
-     */
-    constructor(firestore: FirebaseFirestore.Firestore, mailgunClient: mailgun.Mailgun | MailgunClientCompat);
-    /**
-     * Validates that the Mailgun client is configured correctly
-     * Particularly checks for EU region configuration
+     * @param mailgunClient Mailgun client instance (mailgun.js v10+) provided by the caller
      */
-    private validateMailgunClient;
+    constructor(firestore: FirebaseFirestore.Firestore, mailgunClient: NewMailgunClient$1);
     /**
-     * Sends an email using Mailgun
-     * @param data Email data to send, including the 'from' address
+     * Sends an email using the new Mailgun client API.
+     * @param domain The Mailgun domain to send from (e.g., mg.metaesthetics.net)
+     * @param data Email data to send, compatible with mailgun.js messages.create API
      * @returns Promise with the sending result
      */
-    protected sendEmail(data: mailgun.messages.SendData): Promise<any>;
-    /**
-     * Tries to get domain from mailgun client options
-     * @returns Domain string or undefined
-     */
-    private getDomainFromOptions;
-    /**
-     * Extracts domain from an email address
-     * @param email Email address
-     * @returns Domain part or undefined
-     */
-    private getDomainFromEmail;
+    protected sendEmail(domain: string, // The new API requires the domain as the first argument to messages.create
+    data: any): Promise<any>;
     /**
      * Logs email sending attempt to Firestore for tracking
      * @param emailData Email data that was sent
@@ -1571,6 +1557,12 @@ declare class BaseMailingService {
     protected renderTemplate(template: string, variables: Record<string, string>): string;
 }
 
+interface NewMailgunMessagesAPI {
+    create(domain: string, data: any): Promise<any>;
+}
+interface NewMailgunClient {
+    messages: NewMailgunMessagesAPI;
+}
 /**
  * Interface for the data required to send a practitioner invitation email
  */
@@ -1600,36 +1592,42 @@ interface PractitionerInviteEmailData {
         registrationUrl?: string;
         customSubject?: string;
         fromAddress?: string;
+        mailgunDomain?: string;
     };
 }
 /**
- * Service for sending practitioner invitation emails
+ * Service for sending practitioner invitation emails, updated for mailgun.js v10+
  */
 declare class PractitionerInviteMailingService extends BaseMailingService {
     private readonly DEFAULT_REGISTRATION_URL;
     private readonly DEFAULT_SUBJECT;
-    private readonly DEFAULT_FROM_ADDRESS;
+    private readonly DEFAULT_MAILGUN_DOMAIN;
     /**
      * Constructor for PractitionerInviteMailingService
      * @param firestore Firestore instance provided by the caller
-     * @param mailgunClient Mailgun client instance provided by the caller
+     * @param mailgunClient Mailgun client instance (mailgun.js v10+) provided by the caller
      */
-    constructor(firestore: FirebaseFirestore.Firestore, mailgunClient: mailgun.Mailgun);
+    constructor(firestore: FirebaseFirestore.Firestore, mailgunClient: NewMailgunClient);
     /**
      * Sends a practitioner invitation email
      * @param data The practitioner invitation data
      * @returns Promise resolved when email is sent
      */
-    sendInvitationEmail(data: PractitionerInviteEmailData): Promise<mailgun.messages.SendResponse>;
+    sendInvitationEmail(data: PractitionerInviteEmailData): Promise<any>;
     /**
      * Handles the practitioner token creation event from Cloud Functions
      * Fetches necessary data using defined types and collection constants,
      * and sends the invitation email.
      * @param tokenData The fully typed token object including its id
      * @param fromAddress The 'from' email address to use, obtained from config
+     * @param mailgunDomain The mailgun domain to use for sending
      * @returns Promise resolved when the email is sent
      */
-    handleTokenCreationEvent(tokenData: PractitionerToken, fromAddress: string): Promise<void>;
+    handleTokenCreationEvent(tokenData: PractitionerToken, mailgunConfig: {
+        fromAddress: string;
+        domain: string;
+        registrationUrl?: string;
+    }): Promise<void>;
 }
 
 /**

package/dist/admin/index.d.ts

@@ -1,7 +1,6 @@
 import { Timestamp } from 'firebase/firestore';
 import * as admin from 'firebase-admin';
 import { Timestamp as Timestamp$1 } from 'firebase-admin/firestore';
-import * as mailgun from 'mailgun-js';
 
 /**
  * Enum for element types in documentation templates
@@ -1507,50 +1506,37 @@ declare class PatientAggregationService {
 }
 
 /**
- * Mailgun client type for compatibility with new mailgun.js library
- * This allows us to accept both older mailgun-js and newer mailgun.js clients
+ * Minimal interface for the new mailgun.js client's messages API
+ * This helps avoid a direct dependency on mailgun.js in the API package if not desired,
+ * or provides clearer typing if it is.
  */
-interface MailgunClientCompat {
-    messages: {
-        create?: (domain: string, data: any) => Promise<any>;
-        send?: (data: any, callback: (error: any, body: any) => void) => void;
-    };
+interface NewMailgunMessagesAPI$1 {
+    create(domain: string, data: any): Promise<any>;
+}
+interface NewMailgunClient$1 {
+    messages: NewMailgunMessagesAPI$1;
 }
 /**
  * Base mailing service class that provides common functionality for all mailing services
+ * This version is updated to expect a mailgun.js v10+ client.
  */
 declare class BaseMailingService {
     protected db: FirebaseFirestore.Firestore;
-    protected mailgunClient: mailgun.Mailgun | MailgunClientCompat;
-    protected isNewMailgunClient: boolean;
+    protected mailgunClient: NewMailgunClient$1;
     /**
      * Constructor for BaseMailingService
      * @param firestore Firestore instance provided by the caller
-     * @param mailgunClient Mailgun client instance provided by the caller
-     */
-    constructor(firestore: FirebaseFirestore.Firestore, mailgunClient: mailgun.Mailgun | MailgunClientCompat);
-    /**
-     * Validates that the Mailgun client is configured correctly
-     * Particularly checks for EU region configuration
+     * @param mailgunClient Mailgun client instance (mailgun.js v10+) provided by the caller
      */
-    private validateMailgunClient;
+    constructor(firestore: FirebaseFirestore.Firestore, mailgunClient: NewMailgunClient$1);
     /**
-     * Sends an email using Mailgun
-     * @param data Email data to send, including the 'from' address
+     * Sends an email using the new Mailgun client API.
+     * @param domain The Mailgun domain to send from (e.g., mg.metaesthetics.net)
+     * @param data Email data to send, compatible with mailgun.js messages.create API
      * @returns Promise with the sending result
      */
-    protected sendEmail(data: mailgun.messages.SendData): Promise<any>;
-    /**
-     * Tries to get domain from mailgun client options
-     * @returns Domain string or undefined
-     */
-    private getDomainFromOptions;
-    /**
-     * Extracts domain from an email address
-     * @param email Email address
-     * @returns Domain part or undefined
-     */
-    private getDomainFromEmail;
+    protected sendEmail(domain: string, // The new API requires the domain as the first argument to messages.create
+    data: any): Promise<any>;
     /**
      * Logs email sending attempt to Firestore for tracking
      * @param emailData Email data that was sent
@@ -1571,6 +1557,12 @@ declare class BaseMailingService {
     protected renderTemplate(template: string, variables: Record<string, string>): string;
 }
 
+interface NewMailgunMessagesAPI {
+    create(domain: string, data: any): Promise<any>;
+}
+interface NewMailgunClient {
+    messages: NewMailgunMessagesAPI;
+}
 /**
  * Interface for the data required to send a practitioner invitation email
  */
@@ -1600,36 +1592,42 @@ interface PractitionerInviteEmailData {
         registrationUrl?: string;
         customSubject?: string;
         fromAddress?: string;
+        mailgunDomain?: string;
     };
 }
 /**
- * Service for sending practitioner invitation emails
+ * Service for sending practitioner invitation emails, updated for mailgun.js v10+
  */
 declare class PractitionerInviteMailingService extends BaseMailingService {
     private readonly DEFAULT_REGISTRATION_URL;
     private readonly DEFAULT_SUBJECT;
-    private readonly DEFAULT_FROM_ADDRESS;
+    private readonly DEFAULT_MAILGUN_DOMAIN;
     /**
      * Constructor for PractitionerInviteMailingService
      * @param firestore Firestore instance provided by the caller
-     * @param mailgunClient Mailgun client instance provided by the caller
+     * @param mailgunClient Mailgun client instance (mailgun.js v10+) provided by the caller
      */
-    constructor(firestore: FirebaseFirestore.Firestore, mailgunClient: mailgun.Mailgun);
+    constructor(firestore: FirebaseFirestore.Firestore, mailgunClient: NewMailgunClient);
     /**
      * Sends a practitioner invitation email
      * @param data The practitioner invitation data
      * @returns Promise resolved when email is sent
      */
-    sendInvitationEmail(data: PractitionerInviteEmailData): Promise<mailgun.messages.SendResponse>;
+    sendInvitationEmail(data: PractitionerInviteEmailData): Promise<any>;
     /**
      * Handles the practitioner token creation event from Cloud Functions
      * Fetches necessary data using defined types and collection constants,
      * and sends the invitation email.
      * @param tokenData The fully typed token object including its id
      * @param fromAddress The 'from' email address to use, obtained from config
+     * @param mailgunDomain The mailgun domain to use for sending
      * @returns Promise resolved when the email is sent
      */
-    handleTokenCreationEvent(tokenData: PractitionerToken, fromAddress: string): Promise<void>;
+    handleTokenCreationEvent(tokenData: PractitionerToken, mailgunConfig: {
+        fromAddress: string;
+        domain: string;
+        registrationUrl?: string;
+    }): Promise<void>;
 }
 
 /**