@upyo/opentelemetry 0.5.0-dev.128 → 0.5.0-dev.154

package/README.md

@@ -264,11 +264,11 @@ The transport automatically classifies errors into standard categories:
 | Category              | Description             | Example Errors                          |
 | --------------------- | ----------------------- | --------------------------------------- |
 | `auth`                | Authentication failures | Invalid API key, unauthorized           |
-| `rate_limit`          | Rate limiting           | Quota exceeded, too many requests       |
+| `rate-limit`          | Rate limiting           | Quota exceeded, too many requests       |
 | `network`             | Network connectivity    | Timeout, DNS resolution, abort          |
 | `validation`          | Input validation        | Invalid email format, malformed request |
-| `service_unavailable` | Service outages         | HTTP 503, temporarily unavailable       |
-| `server_error`        | Server errors           | HTTP 500, internal server error         |
+| `service-unavailable` | Service outages         | HTTP 503, temporarily unavailable       |
+| `server-error`        | Server errors           | HTTP 500, internal server error         |
 | `unknown`             | Unclassified errors     | Any other errors                        |
 
 ### Custom Error Classification

package/dist/index.cjs

@@ -87,16 +87,17 @@ function createOpenTelemetryConfig(config = {}) {
 * import { defaultErrorClassifier } from "@upyo/opentelemetry";
 *
 * console.log(defaultErrorClassifier(new Error("401 Unauthorized"))); // "auth"
-* console.log(defaultErrorClassifier(new Error("Rate limit exceeded"))); // "rate_limit"
+* console.log(defaultErrorClassifier(new Error("Rate limit exceeded"))); // "rate-limit"
 * console.log(defaultErrorClassifier(new Error("Connection timeout"))); // "network"
 * console.log(defaultErrorClassifier(new Error("Invalid email format"))); // "validation"
-* console.log(defaultErrorClassifier(new Error("500 Internal Server Error"))); // "server_error"
+* console.log(defaultErrorClassifier(new Error("500 Internal Server Error"))); // "server-error"
 * console.log(defaultErrorClassifier(new Error("Something else"))); // "unknown"
 * ```
 *
 * @param error The error to classify.
-* @returns A string category such as `"auth"`, `"rate_limit"`, `"network"`,
-*          `"validation"`, `"server_error"`, or `"unknown"`.
+* @returns A string category such as `"auth"`, `"rate-limit"`, `"network"`,
+*          `"validation"`, `"service-unavailable"`, `"server-error"`, or
+*          `"unknown"`.
 * @since 0.2.0
 */
 function defaultErrorClassifier(error) {
@@ -104,11 +105,11 @@ function defaultErrorClassifier(error) {
 		const message = error.message.toLowerCase();
 		const name$1 = error.name.toLowerCase();
 		if (message.includes("auth") || message.includes("unauthorized") || message.includes("invalid api key") || message.includes("403")) return "auth";
-		if (message.includes("rate limit") || message.includes("429") || message.includes("quota exceeded") || message.includes("throttle")) return "rate_limit";
-		if (message.includes("500") || message.includes("502") || message.includes("504") || message.includes("internal server error")) return "server_error";
+		if (message.includes("rate limit") || message.includes("429") || message.includes("quota exceeded") || message.includes("throttle")) return "rate-limit";
+		if (message.includes("500") || message.includes("502") || message.includes("504") || message.includes("internal server error")) return "server-error";
 		if (name$1.includes("network") || message.includes("connect") || message.includes("timeout") || message.includes("dns") || name$1 === "aborterror") return "network";
 		if (message.includes("invalid") || message.includes("malformed") || message.includes("validation") || message.includes("400")) return "validation";
-		if (message.includes("503") || message.includes("service unavailable") || message.includes("temporarily unavailable")) return "service_unavailable";
+		if (message.includes("503") || message.includes("service unavailable") || message.includes("temporarily unavailable")) return "service-unavailable";
 	}
 	return "unknown";
 }
@@ -116,7 +117,7 @@ function defaultErrorClassifier(error) {
 //#endregion
 //#region package.json
 var name = "@upyo/opentelemetry";
-var version = "0.5.0-dev.128+6e126027";
+var version = "0.5.0-dev.154+2f72d353";
 var description = "OpenTelemetry observability transport for Upyo email library";
 var keywords = [
 	"email",
@@ -173,7 +174,6 @@ var peerDependencies = {
 	"@upyo/core": "workspace:*"
 };
 var devDependencies = {
-	"@dotenvx/dotenvx": "catalog:",
 	"@opentelemetry/api": "catalog:",
 	"@opentelemetry/context-async-hooks": "^1.25.1",
 	"@opentelemetry/resources": "catalog:",
@@ -184,12 +184,8 @@ var devDependencies = {
 	"typescript": "catalog:"
 };
 var scripts = {
-	"build": "tsdown",
-	"prepack": "tsdown",
-	"prepublish": "tsdown",
-	"test": "tsdown && dotenvx run --ignore=MISSING_ENV_FILE -- node --experimental-transform-types --test",
-	"test:bun": "tsdown && bun test --timeout=30000 --env-file=.env",
-	"test:deno": "deno test --allow-env --allow-net --env-file=.env"
+	"prepack": "mise run --no-deps :build",
+	"prepublish": "mise run --no-deps :build"
 };
 var package_default = {
 	name,
@@ -673,6 +669,7 @@ var NoOpEmailSpan = class {
 * @since 0.2.0
 */
 var OpenTelemetryTransport = class {
+	id;
 	/**
 	* The resolved OpenTelemetry configuration.
 	*/
@@ -690,6 +687,7 @@ var OpenTelemetryTransport = class {
 	*/
 	constructor(transport, config = {}) {
 		this.wrappedTransport = transport;
+		this.id = transport.id;
 		this.config = createOpenTelemetryConfig(config);
 		this.transportName = this.extractTransportName(transport);
 		this.transportVersion = this.extractTransportVersion(transport);
@@ -719,7 +717,7 @@ var OpenTelemetryTransport = class {
 				span?.recordSuccess(receipt.messageId);
 				this.metricsCollector?.recordSendComplete(this.transportName, duration, true);
 			} else {
-				const errorCategory = this.classifyErrors(receipt.errorMessages);
+				const errorCategory = this.classifyReceipt(receipt);
 				span?.recordFailure(receipt.errorMessages);
 				this.metricsCollector?.recordSendComplete(this.transportName, duration, false, errorCategory);
 			}
@@ -796,6 +794,7 @@ var OpenTelemetryTransport = class {
 		if (typeof this.wrappedTransport[Symbol.dispose] === "function") this.wrappedTransport[Symbol.dispose]();
 	}
 	extractTransportName(transport) {
+		if (transport.id !== "") return transport.id;
 		const constructorName = transport.constructor.name;
 		if (constructorName && constructorName !== "Object") return constructorName.toLowerCase().replace("transport", "");
 		if ("config" in transport && transport.config && typeof transport.config === "object") {
@@ -839,6 +838,11 @@ var OpenTelemetryTransport = class {
 		const classifier = this.config.errorClassifier || defaultErrorClassifier;
 		return classifier(error);
 	}
+	classifyReceipt(receipt) {
+		const structuredCategory = receipt.errors?.[0]?.category;
+		if (structuredCategory != null) return structuredCategory;
+		return this.classifyErrors(receipt.errorMessages);
+	}
 	classifyErrors(errorMessages) {
 		if (errorMessages.length === 0) return "unknown";
 		const syntheticError = new Error(errorMessages[0]);

package/dist/index.d.cts

@@ -162,16 +162,17 @@ interface ResolvedOpenTelemetryConfig {
  * import { defaultErrorClassifier } from "@upyo/opentelemetry";
  *
  * console.log(defaultErrorClassifier(new Error("401 Unauthorized"))); // "auth"
- * console.log(defaultErrorClassifier(new Error("Rate limit exceeded"))); // "rate_limit"
+ * console.log(defaultErrorClassifier(new Error("Rate limit exceeded"))); // "rate-limit"
  * console.log(defaultErrorClassifier(new Error("Connection timeout"))); // "network"
  * console.log(defaultErrorClassifier(new Error("Invalid email format"))); // "validation"
- * console.log(defaultErrorClassifier(new Error("500 Internal Server Error"))); // "server_error"
+ * console.log(defaultErrorClassifier(new Error("500 Internal Server Error"))); // "server-error"
  * console.log(defaultErrorClassifier(new Error("Something else"))); // "unknown"
  * ```
  *
  * @param error The error to classify.
- * @returns A string category such as `"auth"`, `"rate_limit"`, `"network"`,
- *          `"validation"`, `"server_error"`, or `"unknown"`.
+ * @returns A string category such as `"auth"`, `"rate-limit"`, `"network"`,
+ *          `"validation"`, `"service-unavailable"`, `"server-error"`, or
+ *          `"unknown"`.
  * @since 0.2.0
  */
 declare function defaultErrorClassifier(error: unknown): string;
@@ -237,7 +238,8 @@ declare function defaultErrorClassifier(error: unknown): string;
  *
  * @since 0.2.0
  */
-declare class OpenTelemetryTransport implements Transport, AsyncDisposable {
+declare class OpenTelemetryTransport<TProviderId extends string = string> implements Transport<TProviderId>, AsyncDisposable {
+  readonly id: TProviderId;
   /**
    * The resolved OpenTelemetry configuration.
    */
@@ -253,7 +255,7 @@ declare class OpenTelemetryTransport implements Transport, AsyncDisposable {
    * @param transport The base transport to wrap with observability.
    * @param config OpenTelemetry configuration options.
    */
-  constructor(transport: Transport, config?: OpenTelemetryConfig);
+  constructor(transport: Transport<TProviderId>, config?: OpenTelemetryConfig);
   /**
    * Sends a single email message with OpenTelemetry observability.
    *
@@ -261,7 +263,7 @@ declare class OpenTelemetryTransport implements Transport, AsyncDisposable {
    * @param options Optional transport options including abort signal.
    * @returns A promise that resolves to a receipt indicating success or failure.
    */
-  send(message: Message, options?: TransportOptions): Promise<Receipt>;
+  send(message: Message, options?: TransportOptions): Promise<Receipt<TProviderId>>;
   /**
    * Sends multiple email messages with OpenTelemetry observability.
    *
@@ -269,7 +271,7 @@ declare class OpenTelemetryTransport implements Transport, AsyncDisposable {
    * @param options Optional transport options including abort signal.
    * @returns An async iterable that yields receipts for each sent message.
    */
-  sendMany(messages: Iterable<Message> | AsyncIterable<Message>, options?: TransportOptions): AsyncIterable<Receipt>;
+  sendMany(messages: Iterable<Message> | AsyncIterable<Message>, options?: TransportOptions): AsyncIterable<Receipt<TProviderId>>;
   /**
    * Cleanup resources if the wrapped transport supports Disposable or AsyncDisposable.
    */
@@ -278,6 +280,7 @@ declare class OpenTelemetryTransport implements Transport, AsyncDisposable {
   private extractTransportVersion;
   private extractNetworkAttributes;
   private classifyError;
+  private classifyReceipt;
   private classifyErrors;
   private estimateMessageSize;
 }
@@ -424,7 +427,7 @@ interface CreateOpenTelemetryTransportConfig extends Omit<OpenTelemetryConfig, "
  *
  * @since 0.2.0
  */
-declare function createOpenTelemetryTransport(baseTransport: Transport, config?: CreateOpenTelemetryTransportConfig): OpenTelemetryTransport;
+declare function createOpenTelemetryTransport<TProviderId extends string = string>(baseTransport: Transport<TProviderId>, config?: CreateOpenTelemetryTransportConfig): OpenTelemetryTransport<TProviderId>;
 /**
  * Creates a custom email attribute extractor function for OpenTelemetry
  * spans and metrics.

package/dist/index.d.ts

@@ -162,16 +162,17 @@ interface ResolvedOpenTelemetryConfig {
  * import { defaultErrorClassifier } from "@upyo/opentelemetry";
  *
  * console.log(defaultErrorClassifier(new Error("401 Unauthorized"))); // "auth"
- * console.log(defaultErrorClassifier(new Error("Rate limit exceeded"))); // "rate_limit"
+ * console.log(defaultErrorClassifier(new Error("Rate limit exceeded"))); // "rate-limit"
  * console.log(defaultErrorClassifier(new Error("Connection timeout"))); // "network"
  * console.log(defaultErrorClassifier(new Error("Invalid email format"))); // "validation"
- * console.log(defaultErrorClassifier(new Error("500 Internal Server Error"))); // "server_error"
+ * console.log(defaultErrorClassifier(new Error("500 Internal Server Error"))); // "server-error"
  * console.log(defaultErrorClassifier(new Error("Something else"))); // "unknown"
  * ```
  *
  * @param error The error to classify.
- * @returns A string category such as `"auth"`, `"rate_limit"`, `"network"`,
- *          `"validation"`, `"server_error"`, or `"unknown"`.
+ * @returns A string category such as `"auth"`, `"rate-limit"`, `"network"`,
+ *          `"validation"`, `"service-unavailable"`, `"server-error"`, or
+ *          `"unknown"`.
  * @since 0.2.0
  */
 declare function defaultErrorClassifier(error: unknown): string;
@@ -237,7 +238,8 @@ declare function defaultErrorClassifier(error: unknown): string;
  *
  * @since 0.2.0
  */
-declare class OpenTelemetryTransport implements Transport, AsyncDisposable {
+declare class OpenTelemetryTransport<TProviderId extends string = string> implements Transport<TProviderId>, AsyncDisposable {
+  readonly id: TProviderId;
   /**
    * The resolved OpenTelemetry configuration.
    */
@@ -253,7 +255,7 @@ declare class OpenTelemetryTransport implements Transport, AsyncDisposable {
    * @param transport The base transport to wrap with observability.
    * @param config OpenTelemetry configuration options.
    */
-  constructor(transport: Transport, config?: OpenTelemetryConfig);
+  constructor(transport: Transport<TProviderId>, config?: OpenTelemetryConfig);
   /**
    * Sends a single email message with OpenTelemetry observability.
    *
@@ -261,7 +263,7 @@ declare class OpenTelemetryTransport implements Transport, AsyncDisposable {
    * @param options Optional transport options including abort signal.
    * @returns A promise that resolves to a receipt indicating success or failure.
    */
-  send(message: Message, options?: TransportOptions): Promise<Receipt>;
+  send(message: Message, options?: TransportOptions): Promise<Receipt<TProviderId>>;
   /**
    * Sends multiple email messages with OpenTelemetry observability.
    *
@@ -269,7 +271,7 @@ declare class OpenTelemetryTransport implements Transport, AsyncDisposable {
    * @param options Optional transport options including abort signal.
    * @returns An async iterable that yields receipts for each sent message.
    */
-  sendMany(messages: Iterable<Message> | AsyncIterable<Message>, options?: TransportOptions): AsyncIterable<Receipt>;
+  sendMany(messages: Iterable<Message> | AsyncIterable<Message>, options?: TransportOptions): AsyncIterable<Receipt<TProviderId>>;
   /**
    * Cleanup resources if the wrapped transport supports Disposable or AsyncDisposable.
    */
@@ -278,6 +280,7 @@ declare class OpenTelemetryTransport implements Transport, AsyncDisposable {
   private extractTransportVersion;
   private extractNetworkAttributes;
   private classifyError;
+  private classifyReceipt;
   private classifyErrors;
   private estimateMessageSize;
 }
@@ -424,7 +427,7 @@ interface CreateOpenTelemetryTransportConfig extends Omit<OpenTelemetryConfig, "
  *
  * @since 0.2.0
  */
-declare function createOpenTelemetryTransport(baseTransport: Transport, config?: CreateOpenTelemetryTransportConfig): OpenTelemetryTransport;
+declare function createOpenTelemetryTransport<TProviderId extends string = string>(baseTransport: Transport<TProviderId>, config?: CreateOpenTelemetryTransportConfig): OpenTelemetryTransport<TProviderId>;
 /**
  * Creates a custom email attribute extractor function for OpenTelemetry
  * spans and metrics.

package/dist/index.js

@@ -64,16 +64,17 @@ function createOpenTelemetryConfig(config = {}) {
 * import { defaultErrorClassifier } from "@upyo/opentelemetry";
 *
 * console.log(defaultErrorClassifier(new Error("401 Unauthorized"))); // "auth"
-* console.log(defaultErrorClassifier(new Error("Rate limit exceeded"))); // "rate_limit"
+* console.log(defaultErrorClassifier(new Error("Rate limit exceeded"))); // "rate-limit"
 * console.log(defaultErrorClassifier(new Error("Connection timeout"))); // "network"
 * console.log(defaultErrorClassifier(new Error("Invalid email format"))); // "validation"
-* console.log(defaultErrorClassifier(new Error("500 Internal Server Error"))); // "server_error"
+* console.log(defaultErrorClassifier(new Error("500 Internal Server Error"))); // "server-error"
 * console.log(defaultErrorClassifier(new Error("Something else"))); // "unknown"
 * ```
 *
 * @param error The error to classify.
-* @returns A string category such as `"auth"`, `"rate_limit"`, `"network"`,
-*          `"validation"`, `"server_error"`, or `"unknown"`.
+* @returns A string category such as `"auth"`, `"rate-limit"`, `"network"`,
+*          `"validation"`, `"service-unavailable"`, `"server-error"`, or
+*          `"unknown"`.
 * @since 0.2.0
 */
 function defaultErrorClassifier(error) {
@@ -81,11 +82,11 @@ function defaultErrorClassifier(error) {
 		const message = error.message.toLowerCase();
 		const name$1 = error.name.toLowerCase();
 		if (message.includes("auth") || message.includes("unauthorized") || message.includes("invalid api key") || message.includes("403")) return "auth";
-		if (message.includes("rate limit") || message.includes("429") || message.includes("quota exceeded") || message.includes("throttle")) return "rate_limit";
-		if (message.includes("500") || message.includes("502") || message.includes("504") || message.includes("internal server error")) return "server_error";
+		if (message.includes("rate limit") || message.includes("429") || message.includes("quota exceeded") || message.includes("throttle")) return "rate-limit";
+		if (message.includes("500") || message.includes("502") || message.includes("504") || message.includes("internal server error")) return "server-error";
 		if (name$1.includes("network") || message.includes("connect") || message.includes("timeout") || message.includes("dns") || name$1 === "aborterror") return "network";
 		if (message.includes("invalid") || message.includes("malformed") || message.includes("validation") || message.includes("400")) return "validation";
-		if (message.includes("503") || message.includes("service unavailable") || message.includes("temporarily unavailable")) return "service_unavailable";
+		if (message.includes("503") || message.includes("service unavailable") || message.includes("temporarily unavailable")) return "service-unavailable";
 	}
 	return "unknown";
 }
@@ -93,7 +94,7 @@ function defaultErrorClassifier(error) {
 //#endregion
 //#region package.json
 var name = "@upyo/opentelemetry";
-var version = "0.5.0-dev.128+6e126027";
+var version = "0.5.0-dev.154+2f72d353";
 var description = "OpenTelemetry observability transport for Upyo email library";
 var keywords = [
 	"email",
@@ -150,7 +151,6 @@ var peerDependencies = {
 	"@upyo/core": "workspace:*"
 };
 var devDependencies = {
-	"@dotenvx/dotenvx": "catalog:",
 	"@opentelemetry/api": "catalog:",
 	"@opentelemetry/context-async-hooks": "^1.25.1",
 	"@opentelemetry/resources": "catalog:",
@@ -161,12 +161,8 @@ var devDependencies = {
 	"typescript": "catalog:"
 };
 var scripts = {
-	"build": "tsdown",
-	"prepack": "tsdown",
-	"prepublish": "tsdown",
-	"test": "tsdown && dotenvx run --ignore=MISSING_ENV_FILE -- node --experimental-transform-types --test",
-	"test:bun": "tsdown && bun test --timeout=30000 --env-file=.env",
-	"test:deno": "deno test --allow-env --allow-net --env-file=.env"
+	"prepack": "mise run --no-deps :build",
+	"prepublish": "mise run --no-deps :build"
 };
 var package_default = {
 	name,
@@ -650,6 +646,7 @@ var NoOpEmailSpan = class {
 * @since 0.2.0
 */
 var OpenTelemetryTransport = class {
+	id;
 	/**
 	* The resolved OpenTelemetry configuration.
 	*/
@@ -667,6 +664,7 @@ var OpenTelemetryTransport = class {
 	*/
 	constructor(transport, config = {}) {
 		this.wrappedTransport = transport;
+		this.id = transport.id;
 		this.config = createOpenTelemetryConfig(config);
 		this.transportName = this.extractTransportName(transport);
 		this.transportVersion = this.extractTransportVersion(transport);
@@ -696,7 +694,7 @@ var OpenTelemetryTransport = class {
 				span?.recordSuccess(receipt.messageId);
 				this.metricsCollector?.recordSendComplete(this.transportName, duration, true);
 			} else {
-				const errorCategory = this.classifyErrors(receipt.errorMessages);
+				const errorCategory = this.classifyReceipt(receipt);
 				span?.recordFailure(receipt.errorMessages);
 				this.metricsCollector?.recordSendComplete(this.transportName, duration, false, errorCategory);
 			}
@@ -773,6 +771,7 @@ var OpenTelemetryTransport = class {
 		if (typeof this.wrappedTransport[Symbol.dispose] === "function") this.wrappedTransport[Symbol.dispose]();
 	}
 	extractTransportName(transport) {
+		if (transport.id !== "") return transport.id;
 		const constructorName = transport.constructor.name;
 		if (constructorName && constructorName !== "Object") return constructorName.toLowerCase().replace("transport", "");
 		if ("config" in transport && transport.config && typeof transport.config === "object") {
@@ -816,6 +815,11 @@ var OpenTelemetryTransport = class {
 		const classifier = this.config.errorClassifier || defaultErrorClassifier;
 		return classifier(error);
 	}
+	classifyReceipt(receipt) {
+		const structuredCategory = receipt.errors?.[0]?.category;
+		if (structuredCategory != null) return structuredCategory;
+		return this.classifyErrors(receipt.errorMessages);
+	}
 	classifyErrors(errorMessages) {
 		if (errorMessages.length === 0) return "unknown";
 		const syntheticError = new Error(errorMessages[0]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@upyo/opentelemetry",
-  "version": "0.5.0-dev.128",
+  "version": "0.5.0-dev.154",
   "description": "OpenTelemetry observability transport for Upyo email library",
   "keywords": [
     "email",
@@ -58,10 +58,9 @@
   "sideEffects": false,
   "peerDependencies": {
     "@opentelemetry/api": "^1.9.0",
-    "@upyo/core": "0.5.0-dev.128+6e126027"
+    "@upyo/core": "0.5.0-dev.154+2f72d353"
   },
   "devDependencies": {
-    "@dotenvx/dotenvx": "^1.47.3",
     "@opentelemetry/api": "^1.9.0",
     "@opentelemetry/context-async-hooks": "^1.25.1",
     "@opentelemetry/resources": "^1.25.1",
@@ -72,10 +71,6 @@
     "typescript": "5.8.3"
   },
   "scripts": {
-    "build": "tsdown",
-    "prepublish": "tsdown",
-    "test": "tsdown && dotenvx run --ignore=MISSING_ENV_FILE -- node --experimental-transform-types --test",
-    "test:bun": "tsdown && bun test --timeout=30000 --env-file=.env",
-    "test:deno": "deno test --allow-env --allow-net --env-file=.env"
+    "prepublish": "mise run --no-deps :build"
   }
 }