@upyo/mailgun 0.1.0-dev.13 → 0.1.0-dev.17

package/README.md

@@ -56,7 +56,11 @@ const transport = new MailgunTransport({
 });
 
 const receipt = await transport.send(message);
-console.log("Email sent:", receipt.successful);
+if (receipt.successful) {
+  console.log("Message sent with ID:", receipt.messageId);
+} else {
+  console.error("Send failed:", receipt.errorMessages.join(", "));
+}
 ~~~~
 
 

package/dist/index.cjs

@@ -5,21 +5,11 @@
 *
 * This function takes a partial Mailgun configuration and returns a complete
 * configuration with all optional fields filled with sensible defaults.
+* It is used internally by the Mailgun transport.
 *
 * @param config - The Mailgun configuration with optional fields
 * @returns A resolved configuration with all defaults applied
-*
-* @example
-* ```typescript
-* const resolved = createMailgunConfig({
-*   apiKey: 'your-api-key',
-*   domain: 'your-domain.com'
-* });
-*
-* // resolved.region will be 'us' (default)
-* // resolved.timeout will be 30000 (default)
-* // resolved.retries will be 3 (default)
-* ```
+* @internal
 */
 function createMailgunConfig(config) {
 	const region = config.region ?? "us";
@@ -263,10 +253,17 @@ function isStandardHeader(headerName) {
 * });
 *
 * const receipt = await transport.send(message);
-* console.log('Message sent:', receipt.messageId);
+* if (receipt.successful) {
+*   console.log('Message sent with ID:', receipt.messageId);
+* } else {
+*   console.error('Send failed:', receipt.errorMessages.join(', '));
+* }
 * ```
 */
 var MailgunTransport = class {
+	/**
+	* The resolved Mailgun configuration used by this transport.
+	*/
 	config;
 	httpClient;
 	/**
@@ -318,16 +315,14 @@ var MailgunTransport = class {
 			options?.signal?.throwIfAborted();
 			const response = await this.httpClient.sendMessage(formData, options?.signal);
 			return {
-				messageId: response.id,
-				errorMessages: [],
-				successful: true
+				successful: true,
+				messageId: response.id
 			};
 		} catch (error) {
 			const errorMessage = error instanceof Error ? error.message : String(error);
 			return {
-				messageId: "",
-				errorMessages: [errorMessage],
-				successful: false
+				successful: false,
+				errorMessages: [errorMessage]
 			};
 		}
 	}
@@ -399,5 +394,4 @@ var MailgunTransport = class {
 
 //#endregion
 exports.MailgunApiError = MailgunApiError;
-exports.MailgunTransport = MailgunTransport;
-exports.createMailgunConfig = createMailgunConfig;
+exports.MailgunTransport = MailgunTransport;

package/dist/index.d.cts

@@ -100,83 +100,12 @@ type ResolvedMailgunConfig = Required<MailgunConfig>;
  *
  * This function takes a partial Mailgun configuration and returns a complete
  * configuration with all optional fields filled with sensible defaults.
+ * It is used internally by the Mailgun transport.
  *
  * @param config - The Mailgun configuration with optional fields
  * @returns A resolved configuration with all defaults applied
- *
- * @example
- * ```typescript
- * const resolved = createMailgunConfig({
- *   apiKey: 'your-api-key',
- *   domain: 'your-domain.com'
- * });
- *
- * // resolved.region will be 'us' (default)
- * // resolved.timeout will be 30000 (default)
- * // resolved.retries will be 3 (default)
- * ```
+ * @internal
  */
-declare function createMailgunConfig(config: MailgunConfig): ResolvedMailgunConfig;
-//#endregion
-//#region src/http-client.d.ts
-/**
- * Response from Mailgun API for sending messages.
- */
-interface MailgunResponse {
-  /**
-   * The message ID returned by Mailgun.
-   */
-  id: string;
-  /**
-   * Success message from Mailgun.
-   */
-  message: string;
-}
-/**
- * Error response from Mailgun API.
- */
-
-/**
- * HTTP client wrapper for Mailgun API requests.
- *
- * This class handles authentication, request formatting, error handling,
- * and retry logic for Mailgun API calls.
- */
-declare class MailgunHttpClient {
-  private config;
-  constructor(config: ResolvedMailgunConfig);
-  /**
-   * Sends a message via Mailgun API.
-   *
-   * @param formData The form data to send to Mailgun.
-   * @param signal Optional AbortSignal for cancellation.
-   * @returns Promise that resolves to the Mailgun response.
-   */
-  sendMessage(formData: FormData, signal?: AbortSignal): Promise<MailgunResponse>;
-  /**
-   * Makes an HTTP request to Mailgun API with retry logic.
-   *
-   * @param url The URL to make the request to.
-   * @param options Fetch options.
-   * @returns Promise that resolves to the parsed response.
-   */
-  private makeRequest;
-  /**
-   * Makes a fetch request with Mailgun authentication.
-   *
-   * @param url The URL to make the request to.
-   * @param options Fetch options.
-   * @returns Promise that resolves to the fetch response.
-   */
-  private fetchWithAuth;
-}
-/**
- * Custom error class for Mailgun API errors.
- */
-declare class MailgunApiError extends Error {
-  statusCode?: number;
-  constructor(message: string, statusCode?: number);
-}
 //#endregion
 //#region src/mailgun-transport.d.ts
 /**
@@ -196,12 +125,19 @@ declare class MailgunApiError extends Error {
  * });
  *
  * const receipt = await transport.send(message);
- * console.log('Message sent:', receipt.messageId);
+ * if (receipt.successful) {
+ *   console.log('Message sent with ID:', receipt.messageId);
+ * } else {
+ *   console.error('Send failed:', receipt.errorMessages.join(', '));
+ * }
  * ```
  */
 declare class MailgunTransport implements Transport {
-  config: ReturnType<typeof createMailgunConfig>;
-  httpClient: MailgunHttpClient;
+  /**
+   * The resolved Mailgun configuration used by this transport.
+   */
+  config: ResolvedMailgunConfig;
+  private httpClient;
   /**
    * Creates a new Mailgun transport instance.
    *
@@ -297,4 +233,14 @@ declare class MailgunTransport implements Transport {
   sendMany(messages: Iterable<Message> | AsyncIterable<Message>, options?: TransportOptions): AsyncIterable<Receipt>;
 }
 //#endregion
-export { MailgunApiError, MailgunConfig, MailgunTransport, createMailgunConfig };
+//#region src/http-client.d.ts
+
+/**
+ * Custom error class for Mailgun API errors.
+ */
+declare class MailgunApiError extends Error {
+  statusCode?: number;
+  constructor(message: string, statusCode?: number);
+}
+//#endregion
+export { MailgunApiError, MailgunConfig, MailgunTransport };

package/dist/index.d.ts

@@ -100,83 +100,12 @@ type ResolvedMailgunConfig = Required<MailgunConfig>;
  *
  * This function takes a partial Mailgun configuration and returns a complete
  * configuration with all optional fields filled with sensible defaults.
+ * It is used internally by the Mailgun transport.
  *
  * @param config - The Mailgun configuration with optional fields
  * @returns A resolved configuration with all defaults applied
- *
- * @example
- * ```typescript
- * const resolved = createMailgunConfig({
- *   apiKey: 'your-api-key',
- *   domain: 'your-domain.com'
- * });
- *
- * // resolved.region will be 'us' (default)
- * // resolved.timeout will be 30000 (default)
- * // resolved.retries will be 3 (default)
- * ```
+ * @internal
  */
-declare function createMailgunConfig(config: MailgunConfig): ResolvedMailgunConfig;
-//#endregion
-//#region src/http-client.d.ts
-/**
- * Response from Mailgun API for sending messages.
- */
-interface MailgunResponse {
-  /**
-   * The message ID returned by Mailgun.
-   */
-  id: string;
-  /**
-   * Success message from Mailgun.
-   */
-  message: string;
-}
-/**
- * Error response from Mailgun API.
- */
-
-/**
- * HTTP client wrapper for Mailgun API requests.
- *
- * This class handles authentication, request formatting, error handling,
- * and retry logic for Mailgun API calls.
- */
-declare class MailgunHttpClient {
-  private config;
-  constructor(config: ResolvedMailgunConfig);
-  /**
-   * Sends a message via Mailgun API.
-   *
-   * @param formData The form data to send to Mailgun.
-   * @param signal Optional AbortSignal for cancellation.
-   * @returns Promise that resolves to the Mailgun response.
-   */
-  sendMessage(formData: FormData, signal?: AbortSignal): Promise<MailgunResponse>;
-  /**
-   * Makes an HTTP request to Mailgun API with retry logic.
-   *
-   * @param url The URL to make the request to.
-   * @param options Fetch options.
-   * @returns Promise that resolves to the parsed response.
-   */
-  private makeRequest;
-  /**
-   * Makes a fetch request with Mailgun authentication.
-   *
-   * @param url The URL to make the request to.
-   * @param options Fetch options.
-   * @returns Promise that resolves to the fetch response.
-   */
-  private fetchWithAuth;
-}
-/**
- * Custom error class for Mailgun API errors.
- */
-declare class MailgunApiError extends Error {
-  statusCode?: number;
-  constructor(message: string, statusCode?: number);
-}
 //#endregion
 //#region src/mailgun-transport.d.ts
 /**
@@ -196,12 +125,19 @@ declare class MailgunApiError extends Error {
  * });
  *
  * const receipt = await transport.send(message);
- * console.log('Message sent:', receipt.messageId);
+ * if (receipt.successful) {
+ *   console.log('Message sent with ID:', receipt.messageId);
+ * } else {
+ *   console.error('Send failed:', receipt.errorMessages.join(', '));
+ * }
  * ```
  */
 declare class MailgunTransport implements Transport {
-  config: ReturnType<typeof createMailgunConfig>;
-  httpClient: MailgunHttpClient;
+  /**
+   * The resolved Mailgun configuration used by this transport.
+   */
+  config: ResolvedMailgunConfig;
+  private httpClient;
   /**
    * Creates a new Mailgun transport instance.
    *
@@ -297,4 +233,14 @@ declare class MailgunTransport implements Transport {
   sendMany(messages: Iterable<Message> | AsyncIterable<Message>, options?: TransportOptions): AsyncIterable<Receipt>;
 }
 //#endregion
-export { MailgunApiError, MailgunConfig, MailgunTransport, createMailgunConfig };
+//#region src/http-client.d.ts
+
+/**
+ * Custom error class for Mailgun API errors.
+ */
+declare class MailgunApiError extends Error {
+  statusCode?: number;
+  constructor(message: string, statusCode?: number);
+}
+//#endregion
+export { MailgunApiError, MailgunConfig, MailgunTransport };

package/dist/index.js

@@ -4,21 +4,11 @@
 *
 * This function takes a partial Mailgun configuration and returns a complete
 * configuration with all optional fields filled with sensible defaults.
+* It is used internally by the Mailgun transport.
 *
 * @param config - The Mailgun configuration with optional fields
 * @returns A resolved configuration with all defaults applied
-*
-* @example
-* ```typescript
-* const resolved = createMailgunConfig({
-*   apiKey: 'your-api-key',
-*   domain: 'your-domain.com'
-* });
-*
-* // resolved.region will be 'us' (default)
-* // resolved.timeout will be 30000 (default)
-* // resolved.retries will be 3 (default)
-* ```
+* @internal
 */
 function createMailgunConfig(config) {
 	const region = config.region ?? "us";
@@ -262,10 +252,17 @@ function isStandardHeader(headerName) {
 * });
 *
 * const receipt = await transport.send(message);
-* console.log('Message sent:', receipt.messageId);
+* if (receipt.successful) {
+*   console.log('Message sent with ID:', receipt.messageId);
+* } else {
+*   console.error('Send failed:', receipt.errorMessages.join(', '));
+* }
 * ```
 */
 var MailgunTransport = class {
+	/**
+	* The resolved Mailgun configuration used by this transport.
+	*/
 	config;
 	httpClient;
 	/**
@@ -317,16 +314,14 @@ var MailgunTransport = class {
 			options?.signal?.throwIfAborted();
 			const response = await this.httpClient.sendMessage(formData, options?.signal);
 			return {
-				messageId: response.id,
-				errorMessages: [],
-				successful: true
+				successful: true,
+				messageId: response.id
 			};
 		} catch (error) {
 			const errorMessage = error instanceof Error ? error.message : String(error);
 			return {
-				messageId: "",
-				errorMessages: [errorMessage],
-				successful: false
+				successful: false,
+				errorMessages: [errorMessage]
 			};
 		}
 	}
@@ -397,4 +392,4 @@ var MailgunTransport = class {
 };
 
 //#endregion
-export { MailgunApiError, MailgunTransport, createMailgunConfig };
+export { MailgunApiError, MailgunTransport };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@upyo/mailgun",
-  "version": "0.1.0-dev.13+aad44636",
+  "version": "0.1.0-dev.17+3ffd074a",
   "description": "Mailgun transport for Upyo email library",
   "keywords": [
     "email",
@@ -53,7 +53,7 @@
   },
   "sideEffects": false,
   "peerDependencies": {
-    "@upyo/core": "0.1.0-dev.13+aad44636"
+    "@upyo/core": "0.1.0-dev.17+3ffd074a"
   },
   "devDependencies": {
     "@dotenvx/dotenvx": "^1.47.3",