@upyo/core 0.4.0-dev.64 → 0.4.0-dev.67

package/dist/message.cjs

@@ -48,7 +48,8 @@ function createMessage(constructor) {
 		content: constructor.content,
 		priority: constructor.priority ?? "normal",
 		tags: ensureArray(constructor.tags),
-		headers: new Headers(constructor.headers ?? {})
+		headers: new Headers(constructor.headers ?? {}),
+		idempotencyKey: constructor.idempotencyKey
 	};
 }
 function throwTypeError(message) {

package/dist/message.d.cts

@@ -77,6 +77,24 @@ interface Message {
    * the headers, such as `append`, `delete`, or `set`.
    */
   readonly headers: ImmutableHeaders;
+  /**
+   * An idempotency key to ensure that the same message is not sent multiple
+   * times.  This is useful for retrying failed send operations without
+   * risking duplicate delivery.
+   *
+   * If provided, the transport will use this key to deduplicate requests.
+   * If not provided, the transport may generate its own key internally
+   * (behavior varies by transport implementation).
+   *
+   * The key should be unique for each distinct message you want to send.
+   * When retrying the same message, use the same idempotency key.
+   *
+   * Note: Not all transports support idempotency keys.  Check the specific
+   * transport documentation for details.
+   *
+   * @since 0.4.0
+   */
+  readonly idempotencyKey?: string;
 }
 /**
  * Represents the content of an email message, which can be either HTML
@@ -182,6 +200,24 @@ interface MessageConstructor {
    * @default `{}`
    */
   readonly headers?: ImmutableHeaders | Record<string, string>;
+  /**
+   * An idempotency key to ensure that the same message is not sent multiple
+   * times.  This is useful for retrying failed send operations without
+   * risking duplicate delivery.
+   *
+   * If provided, the transport will use this key to deduplicate requests.
+   * If not provided, the transport may generate its own key internally
+   * (behavior varies by transport implementation).
+   *
+   * The key should be unique for each distinct message you want to send.
+   * When retrying the same message, use the same idempotency key.
+   *
+   * Note: Not all transports support idempotency keys.  Check the specific
+   * transport documentation for details.
+   *
+   * @since 0.4.0
+   */
+  readonly idempotencyKey?: string;
 }
 /**
  * Creates a new email {@link Message} based on the provided constructor

package/dist/message.d.ts

@@ -77,6 +77,24 @@ interface Message {
    * the headers, such as `append`, `delete`, or `set`.
    */
   readonly headers: ImmutableHeaders;
+  /**
+   * An idempotency key to ensure that the same message is not sent multiple
+   * times.  This is useful for retrying failed send operations without
+   * risking duplicate delivery.
+   *
+   * If provided, the transport will use this key to deduplicate requests.
+   * If not provided, the transport may generate its own key internally
+   * (behavior varies by transport implementation).
+   *
+   * The key should be unique for each distinct message you want to send.
+   * When retrying the same message, use the same idempotency key.
+   *
+   * Note: Not all transports support idempotency keys.  Check the specific
+   * transport documentation for details.
+   *
+   * @since 0.4.0
+   */
+  readonly idempotencyKey?: string;
 }
 /**
  * Represents the content of an email message, which can be either HTML
@@ -182,6 +200,24 @@ interface MessageConstructor {
    * @default `{}`
    */
   readonly headers?: ImmutableHeaders | Record<string, string>;
+  /**
+   * An idempotency key to ensure that the same message is not sent multiple
+   * times.  This is useful for retrying failed send operations without
+   * risking duplicate delivery.
+   *
+   * If provided, the transport will use this key to deduplicate requests.
+   * If not provided, the transport may generate its own key internally
+   * (behavior varies by transport implementation).
+   *
+   * The key should be unique for each distinct message you want to send.
+   * When retrying the same message, use the same idempotency key.
+   *
+   * Note: Not all transports support idempotency keys.  Check the specific
+   * transport documentation for details.
+   *
+   * @since 0.4.0
+   */
+  readonly idempotencyKey?: string;
 }
 /**
  * Creates a new email {@link Message} based on the provided constructor

package/dist/message.js

@@ -48,7 +48,8 @@ function createMessage(constructor) {
 		content: constructor.content,
 		priority: constructor.priority ?? "normal",
 		tags: ensureArray(constructor.tags),
-		headers: new Headers(constructor.headers ?? {})
+		headers: new Headers(constructor.headers ?? {}),
+		idempotencyKey: constructor.idempotencyKey
 	};
 }
 function throwTypeError(message) {

package/dist/transport.d.cts

@@ -37,7 +37,7 @@ interface TransportOptions {
   /**
    * The abort signal to cancel the send operation if needed.
    */
-  signal?: AbortSignal;
+  readonly signal?: AbortSignal;
 }
 //#endregion
 export { Transport, TransportOptions };

package/dist/transport.d.ts

@@ -37,7 +37,7 @@ interface TransportOptions {
   /**
    * The abort signal to cancel the send operation if needed.
    */
-  signal?: AbortSignal;
+  readonly signal?: AbortSignal;
 }
 //#endregion
 export { Transport, TransportOptions };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@upyo/core",
-  "version": "0.4.0-dev.64+aaa2833b",
+  "version": "0.4.0-dev.67+0f0eb30e",
   "description": "Simple email sending library for Node.js, Deno, Bun, and edge functions",
   "keywords": [
     "email",