@upyo/core 0.5.0-dev.164 → 0.5.0-dev.170

package/dist/abort-signal.cjs

@@ -0,0 +1,53 @@
+
+//#region src/abort-signal.ts
+/**
+* Combines a primary abort signal with an optional external signal.
+*
+* The returned signal aborts as soon as either input signal aborts.  Runtimes
+* with `AbortSignal.any()` use the platform implementation; older runtimes use
+* a listener-based fallback that preserves the original abort reason.
+*
+* @param primarySignal The signal owned by the current operation.
+* @param externalSignal Optional caller-supplied signal to compose.
+* @returns A combined signal and cleanup callback.
+* @since 0.5.0
+*/
+function combineSignals(primarySignal, externalSignal) {
+	if (externalSignal == null) return {
+		signal: primarySignal,
+		cleanup: () => {}
+	};
+	if (typeof AbortSignal.any === "function") return {
+		signal: AbortSignal.any([primarySignal, externalSignal]),
+		cleanup: () => {}
+	};
+	const controller = new AbortController();
+	const cleanup = () => {
+		primarySignal.removeEventListener("abort", abortFromPrimary);
+		externalSignal.removeEventListener("abort", abortFromExternal);
+	};
+	const abortFromPrimary = () => {
+		cleanup();
+		controller.abort(getAbortReason(primarySignal));
+	};
+	const abortFromExternal = () => {
+		cleanup();
+		controller.abort(getAbortReason(externalSignal));
+	};
+	if (primarySignal.aborted) controller.abort(getAbortReason(primarySignal));
+	else if (externalSignal.aborted) controller.abort(getAbortReason(externalSignal));
+	else {
+		primarySignal.addEventListener("abort", abortFromPrimary, { once: true });
+		externalSignal.addEventListener("abort", abortFromExternal, { once: true });
+	}
+	return {
+		signal: controller.signal,
+		cleanup
+	};
+}
+function getAbortReason(signal) {
+	return signal.reason ?? new DOMException("The operation was aborted.", "AbortError");
+}
+
+//#endregion
+exports.combineSignals = combineSignals;

package/dist/abort-signal.d.cts

@@ -0,0 +1,32 @@
+//#region src/abort-signal.d.ts
+/**
+ * Result of combining abort signals.
+ *
+ * @since 0.5.0
+ */
+interface CombinedSignal {
+  /**
+   * The signal that aborts when any input signal aborts.
+   */
+  readonly signal: AbortSignal;
+  /**
+   * Removes fallback abort listeners when signal composition no longer needs
+   * them.
+   */
+  cleanup(): void;
+}
+/**
+ * Combines a primary abort signal with an optional external signal.
+ *
+ * The returned signal aborts as soon as either input signal aborts.  Runtimes
+ * with `AbortSignal.any()` use the platform implementation; older runtimes use
+ * a listener-based fallback that preserves the original abort reason.
+ *
+ * @param primarySignal The signal owned by the current operation.
+ * @param externalSignal Optional caller-supplied signal to compose.
+ * @returns A combined signal and cleanup callback.
+ * @since 0.5.0
+ */
+declare function combineSignals(primarySignal: AbortSignal, externalSignal?: AbortSignal | null): CombinedSignal;
+//#endregion
+export { CombinedSignal, combineSignals };

package/dist/abort-signal.d.ts

@@ -0,0 +1,32 @@
+//#region src/abort-signal.d.ts
+/**
+ * Result of combining abort signals.
+ *
+ * @since 0.5.0
+ */
+interface CombinedSignal {
+  /**
+   * The signal that aborts when any input signal aborts.
+   */
+  readonly signal: AbortSignal;
+  /**
+   * Removes fallback abort listeners when signal composition no longer needs
+   * them.
+   */
+  cleanup(): void;
+}
+/**
+ * Combines a primary abort signal with an optional external signal.
+ *
+ * The returned signal aborts as soon as either input signal aborts.  Runtimes
+ * with `AbortSignal.any()` use the platform implementation; older runtimes use
+ * a listener-based fallback that preserves the original abort reason.
+ *
+ * @param primarySignal The signal owned by the current operation.
+ * @param externalSignal Optional caller-supplied signal to compose.
+ * @returns A combined signal and cleanup callback.
+ * @since 0.5.0
+ */
+declare function combineSignals(primarySignal: AbortSignal, externalSignal?: AbortSignal | null): CombinedSignal;
+//#endregion
+export { CombinedSignal, combineSignals };

package/dist/abort-signal.js

@@ -0,0 +1,52 @@
+//#region src/abort-signal.ts
+/**
+* Combines a primary abort signal with an optional external signal.
+*
+* The returned signal aborts as soon as either input signal aborts.  Runtimes
+* with `AbortSignal.any()` use the platform implementation; older runtimes use
+* a listener-based fallback that preserves the original abort reason.
+*
+* @param primarySignal The signal owned by the current operation.
+* @param externalSignal Optional caller-supplied signal to compose.
+* @returns A combined signal and cleanup callback.
+* @since 0.5.0
+*/
+function combineSignals(primarySignal, externalSignal) {
+	if (externalSignal == null) return {
+		signal: primarySignal,
+		cleanup: () => {}
+	};
+	if (typeof AbortSignal.any === "function") return {
+		signal: AbortSignal.any([primarySignal, externalSignal]),
+		cleanup: () => {}
+	};
+	const controller = new AbortController();
+	const cleanup = () => {
+		primarySignal.removeEventListener("abort", abortFromPrimary);
+		externalSignal.removeEventListener("abort", abortFromExternal);
+	};
+	const abortFromPrimary = () => {
+		cleanup();
+		controller.abort(getAbortReason(primarySignal));
+	};
+	const abortFromExternal = () => {
+		cleanup();
+		controller.abort(getAbortReason(externalSignal));
+	};
+	if (primarySignal.aborted) controller.abort(getAbortReason(primarySignal));
+	else if (externalSignal.aborted) controller.abort(getAbortReason(externalSignal));
+	else {
+		primarySignal.addEventListener("abort", abortFromPrimary, { once: true });
+		externalSignal.addEventListener("abort", abortFromExternal, { once: true });
+	}
+	return {
+		signal: controller.signal,
+		cleanup
+	};
+}
+function getAbortReason(signal) {
+	return signal.reason ?? new DOMException("The operation was aborted.", "AbortError");
+}
+
+//#endregion
+export { combineSignals };

package/dist/index.cjs

@@ -1,11 +1,13 @@
 const require_address = require('./address.cjs');
 const require_attachment = require('./attachment.cjs');
+const require_abort_signal = require('./abort-signal.cjs');
 const require_message = require('./message.cjs');
 const require_priority = require('./priority.cjs');
 const require_receipt = require('./receipt.cjs');
 
 exports.classifyHttpStatus = require_receipt.classifyHttpStatus;
 exports.classifyReceiptError = require_receipt.classifyReceiptError;
+exports.combineSignals = require_abort_signal.combineSignals;
 exports.comparePriority = require_priority.comparePriority;
 exports.createFailedReceipt = require_receipt.createFailedReceipt;
 exports.createMessage = require_message.createMessage;

package/dist/index.d.cts

@@ -1,7 +1,8 @@
 import { Address, EmailAddress, formatAddress, isEmailAddress, parseAddress } from "./address.cjs";
 import { Attachment, isAttachment } from "./attachment.cjs";
+import { CombinedSignal, combineSignals } from "./abort-signal.cjs";
 import { Priority, comparePriority } from "./priority.cjs";
 import { ImmutableHeaders, Message, MessageConstructor, MessageContent, createMessage } from "./message.cjs";
 import { CreateFailedReceiptOptions, CreateReceiptErrorOptions, Receipt, ReceiptError, ReceiptErrorCategory, ReceiptErrorClassification, classifyHttpStatus, classifyReceiptError, createFailedReceipt, createReceiptError, parseRetryAfter } from "./receipt.cjs";
 import { Transport, TransportOptions } from "./transport.cjs";
-export { Address, Attachment, CreateFailedReceiptOptions, CreateReceiptErrorOptions, EmailAddress, ImmutableHeaders, Message, MessageConstructor, MessageContent, Priority, Receipt, ReceiptError, ReceiptErrorCategory, ReceiptErrorClassification, Transport, TransportOptions, classifyHttpStatus, classifyReceiptError, comparePriority, createFailedReceipt, createMessage, createReceiptError, formatAddress, isAttachment, isEmailAddress, parseAddress, parseRetryAfter };
+export { Address, Attachment, CombinedSignal, CreateFailedReceiptOptions, CreateReceiptErrorOptions, EmailAddress, ImmutableHeaders, Message, MessageConstructor, MessageContent, Priority, Receipt, ReceiptError, ReceiptErrorCategory, ReceiptErrorClassification, Transport, TransportOptions, classifyHttpStatus, classifyReceiptError, combineSignals, comparePriority, createFailedReceipt, createMessage, createReceiptError, formatAddress, isAttachment, isEmailAddress, parseAddress, parseRetryAfter };

package/dist/index.d.ts

@@ -1,7 +1,8 @@
 import { Address, EmailAddress, formatAddress, isEmailAddress, parseAddress } from "./address.js";
 import { Attachment, isAttachment } from "./attachment.js";
+import { CombinedSignal, combineSignals } from "./abort-signal.js";
 import { Priority, comparePriority } from "./priority.js";
 import { ImmutableHeaders, Message, MessageConstructor, MessageContent, createMessage } from "./message.js";
 import { CreateFailedReceiptOptions, CreateReceiptErrorOptions, Receipt, ReceiptError, ReceiptErrorCategory, ReceiptErrorClassification, classifyHttpStatus, classifyReceiptError, createFailedReceipt, createReceiptError, parseRetryAfter } from "./receipt.js";
 import { Transport, TransportOptions } from "./transport.js";
-export { Address, Attachment, CreateFailedReceiptOptions, CreateReceiptErrorOptions, EmailAddress, ImmutableHeaders, Message, MessageConstructor, MessageContent, Priority, Receipt, ReceiptError, ReceiptErrorCategory, ReceiptErrorClassification, Transport, TransportOptions, classifyHttpStatus, classifyReceiptError, comparePriority, createFailedReceipt, createMessage, createReceiptError, formatAddress, isAttachment, isEmailAddress, parseAddress, parseRetryAfter };
+export { Address, Attachment, CombinedSignal, CreateFailedReceiptOptions, CreateReceiptErrorOptions, EmailAddress, ImmutableHeaders, Message, MessageConstructor, MessageContent, Priority, Receipt, ReceiptError, ReceiptErrorCategory, ReceiptErrorClassification, Transport, TransportOptions, classifyHttpStatus, classifyReceiptError, combineSignals, comparePriority, createFailedReceipt, createMessage, createReceiptError, formatAddress, isAttachment, isEmailAddress, parseAddress, parseRetryAfter };

package/dist/index.js

@@ -1,7 +1,8 @@
 import { formatAddress, isEmailAddress, parseAddress } from "./address.js";
 import { isAttachment } from "./attachment.js";
+import { combineSignals } from "./abort-signal.js";
 import { createMessage } from "./message.js";
 import { comparePriority } from "./priority.js";
 import { classifyHttpStatus, classifyReceiptError, createFailedReceipt, createReceiptError, parseRetryAfter } from "./receipt.js";
 
-export { classifyHttpStatus, classifyReceiptError, comparePriority, createFailedReceipt, createMessage, createReceiptError, formatAddress, isAttachment, isEmailAddress, parseAddress, parseRetryAfter };
+export { classifyHttpStatus, classifyReceiptError, combineSignals, comparePriority, createFailedReceipt, createMessage, createReceiptError, formatAddress, isAttachment, isEmailAddress, parseAddress, parseRetryAfter };

package/dist/receipt.cjs

@@ -159,7 +159,7 @@ function parseRetryAfter(value, now = /* @__PURE__ */ new Date()) {
 	const trimmed = value.trim();
 	if (/^\d+$/.test(trimmed)) {
 		const delay$1 = Number(trimmed) * 1e3;
-		return delay$1 > 0 ? delay$1 : void 0;
+		return delay$1;
 	}
 	const timestamp = Date.parse(trimmed);
 	if (Number.isNaN(timestamp)) return void 0;

package/dist/receipt.js

@@ -158,7 +158,7 @@ function parseRetryAfter(value, now = /* @__PURE__ */ new Date()) {
 	const trimmed = value.trim();
 	if (/^\d+$/.test(trimmed)) {
 		const delay$1 = Number(trimmed) * 1e3;
-		return delay$1 > 0 ? delay$1 : void 0;
+		return delay$1;
 	}
 	const timestamp = Date.parse(trimmed);
 	if (Number.isNaN(timestamp)) return void 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@upyo/core",
-  "version": "0.5.0-dev.164",
+  "version": "0.5.0-dev.170",
   "description": "Simple email sending library for Node.js, Deno, Bun, and edge functions",
   "keywords": [
     "email",