@visulima/notification 2.0.2 → 2.0.3

package/CHANGELOG.md

@@ -1,3 +1,11 @@
+## @visulima/notification [2.0.3](https://github.com/visulima/visulima/compare/@visulima/notification@2.0.2...@visulima/notification@2.0.3) (2026-11-11)
+
+
+### Dependencies
+
+* **@visulima/email:** upgraded to 4.2.1
+* **@visulima/error:** upgraded to 6.1.1
+
 ## @visulima/notification [2.0.2](https://github.com/visulima/visulima/compare/@visulima/notification@2.0.1...@visulima/notification@2.0.2) (2026-10-23)
 
 

package/dist/middleware/index.d.ts

@@ -1,7 +1,7 @@
 import { M as Middleware, S as SendContext } from "../packem_shared/types.d-YJ8U7pag.js";
 export { type a as SendFunction, c as composeMiddleware } from "../packem_shared/types.d-YJ8U7pag.js";
 import { C as ChannelType, B as BaseNotificationPayload } from "../packem_shared/types.d-COwyORBZ.js";
-import { A as Attributes, C as Context, T as Tracer } from "../packem_shared/tracer.d-BPznIQx9.js";
+import { A as Attributes, C as Context, T as Tracer } from "../packem_shared/tracer.d-BklP4tun.js";
 interface CircuitBreakerMiddlewareOptions {
   /** Time in ms the circuit stays open before a trial request (default 30000). */
   resetTimeout?: number;
@@ -83,6 +83,7 @@ interface SuppressionMiddlewareOptions {
  * @returns A middleware.
  */
 declare const suppressionMiddleware: (options: SuppressionMiddlewareOptions) => Middleware;
+//#region src/metrics/Metric.d.ts
 /**
  * Advisory options influencing aggregation configuration parameters.
  *
@@ -206,6 +207,8 @@ interface ObservableResult<AttributesTypes extends MetricAttributes = MetricAttr
 }
 /**
  * Interface that is being used in batch observable callback function.
+ *
+ * @since 1.3.0
  */
 interface BatchObservableResult<AttributesTypes extends MetricAttributes = MetricAttributes> {
   /**
@@ -272,6 +275,8 @@ interface Meter {
    * Creates and returns a new `Gauge`.
    * @param name the name of the metric.
    * @param [options] the metric options.
+   *
+   * @since 1.9.0
    */
   createGauge<AttributesTypes extends MetricAttributes = MetricAttributes>(name: string, options?: MetricOptions): Gauge<AttributesTypes>;
   /**

package/dist/packem_shared/{tracer.d-BPznIQx9.d.ts → tracer.d-BklP4tun.d.ts}

@@ -1,3 +1,4 @@
+//#region src/context/types.d.ts
 /**
  * @since 1.0.0
  */
@@ -24,24 +25,76 @@ interface Context {
    */
   deleteValue(key: symbol): Context;
 }
+//#region src/common/AnyValue.d.ts
 /**
- * Attributes is a map from string to attribute values.
+ * AnyValue can be:
+ * - a string, number, boolean value
+ * - a byte array (Uint8Array)
+ * - array of any value
+ * - map from string to any value (a plain Object)
+ * - null (an empty value)
  *
- * Note: only the own enumerable keys are counted as valid attribute keys.
+ * https://opentelemetry.io/docs/specs/otel/common/#anyvalue
  *
- * @since 1.3.0
+ * Notable JavaScript types that are excluded:
+ * - `undefined` - Excluding this means the common practice in instrumentations,
+ *   using `undefined` to mean "no value for this optional attribute", can
+ *   remain supported.
+ * - `BigInt`
+ * - TypedArrays other than `Uint8Array`
+ * - subclasses of Object, e.g. Date, Error
+ *
+ * The TypeScript type `unknown` is used for `AnyValue`. This has some
+ * implications:
+ * - Callers of `@opentelemetry/api` APIs using `AnyValue` can pass in
+ *   whatever type. This was always the case for (untyped) JavaScript usage.
+ * - SDK implementations of `@opentelemetry/api` need to document if/when they
+ *   support a subset of AnyValue types.
+ * - Using `unknown` allows future changes to support more types (e.g. BigInt).
+ *
+ * @since 1.10.0
+ */
+type AnyValue = unknown;
+//#region src/common/Attributes.d.ts
+/**
+ * Attributes is a mapping from string to attribute values.
+ * https://opentelemetry.io/docs/specs/otel/common/#attribute-collections
+ *
+ * @since 1.1.0
  */
 interface Attributes {
-  [attributeKey: string]: AttributeValue | undefined;
+  [attributeKey: string]: AnyValue;
 }
 /**
- * Attribute values may be any non-nullish primitive value except an object.
+ * @since 1.1.0
+ * @deprecated use AnyValue
+ */
+type AttributeValue = AnyValue;
+//#region src/common/Time.d.ts
+/**
+ * Defines High-Resolution Time.
+ *
+ * The first number, HrTime[0], is UNIX Epoch time in seconds since 00:00:00 UTC on 1 January 1970.
+ * The second number, HrTime[1], represents the partial second elapsed since Unix Epoch time represented by first number in nanoseconds.
+ * For example, 2021-01-01T12:30:10.150Z in UNIX Epoch time in milliseconds is represented as 1609504210150.
+ * The first number is calculated by converting and truncating the Epoch time in milliseconds to seconds:
+ * HrTime[0] = Math.trunc(1609504210150 / 1000) = 1609504210.
+ * The second number is calculated by converting the digits after the decimal point of the subtraction, (1609504210150 / 1000) - HrTime[0], to nanoseconds:
+ * HrTime[1] = Number((1609504210.150 - HrTime[0]).toFixed(9)) * 1e9 = 150000000.
+ * This is represented in HrTime format as [1609504210, 150000000].
+ *
+ * @since 1.0.0
+ */
+type HrTime = [number, number];
+/**
+ * Defines TimeInput.
  *
- * null or undefined attribute values are invalid and will result in undefined behavior.
+ * hrtime, epoch milliseconds, performance.now() or Date
  *
- * @since 1.3.0
+ * @since 1.0.0
  */
-type AttributeValue = string | number | boolean | Array<null | undefined | string> | Array<null | undefined | number> | Array<null | undefined | boolean>;
+type TimeInput = HrTime | number | Date;
+//#region src/common/Exception.d.ts
 interface ExceptionWithCode {
   code: string | number;
   name?: string;
@@ -68,29 +121,7 @@ interface ExceptionWithName {
  * @since 1.0.0
  */
 type Exception = ExceptionWithCode | ExceptionWithMessage | ExceptionWithName | string;
-/**
- * Defines High-Resolution Time.
- *
- * The first number, HrTime[0], is UNIX Epoch time in seconds since 00:00:00 UTC on 1 January 1970.
- * The second number, HrTime[1], represents the partial second elapsed since Unix Epoch time represented by first number in nanoseconds.
- * For example, 2021-01-01T12:30:10.150Z in UNIX Epoch time in milliseconds is represented as 1609504210150.
- * The first number is calculated by converting and truncating the Epoch time in milliseconds to seconds:
- * HrTime[0] = Math.trunc(1609504210150 / 1000) = 1609504210.
- * The second number is calculated by converting the digits after the decimal point of the subtraction, (1609504210150 / 1000) - HrTime[0], to nanoseconds:
- * HrTime[1] = Number((1609504210.150 - HrTime[0]).toFixed(9)) * 1e9 = 150000000.
- * This is represented in HrTime format as [1609504210, 150000000].
- *
- * @since 1.0.0
- */
-type HrTime = [number, number];
-/**
- * Defines TimeInput.
- *
- * hrtime, epoch milliseconds, performance.now() or Date
- *
- * @since 1.0.0
- */
-type TimeInput = HrTime | number | Date;
+//#region src/trace/attributes.d.ts
 /**
  * @deprecated please use {@link Attributes}
  * @since 1.0.0
@@ -101,6 +132,7 @@ type SpanAttributes = Attributes;
  * @since 1.0.0
  */
 type SpanAttributeValue = AttributeValue;
+//#region src/trace/trace_state.d.ts
 /**
  * @since 1.0.0
  */
@@ -141,6 +173,7 @@ interface TraceState {
    */
   serialize(): string;
 }
+//#region src/trace/span_context.d.ts
 /**
  * A SpanContext represents the portion of a {@link Span} which must be
  * serialized and propagated along side of a {@link Baggage}.
@@ -194,6 +227,7 @@ interface SpanContext {
    */
   traceState?: TraceState;
 }
+//#region src/trace/status.d.ts
 /**
  * @since 1.0.0
  */
@@ -223,6 +257,7 @@ declare enum SpanStatusCode {
    */
   ERROR = 2
 }
+//#region src/trace/link.d.ts
 /**
  * A pointer from the current {@link Span} to another span in the same trace or
  * in a different trace.
@@ -245,9 +280,14 @@ interface Link {
   context: SpanContext;
   /** A set of {@link SpanAttributes} on the link. */
   attributes?: SpanAttributes;
-  /** Count of attributes of the link that were dropped due to collection limits */
+  /**
+   * Count of attributes of the link that were dropped due to collection limits
+   *
+   * @since 1.4.1
+   */
   droppedAttributesCount?: number;
 }
+//#region src/trace/span.d.ts
 /**
  * An interface that represents a span. A span represents a single operation
  * within a trace. Examples of span might include remote procedure calls or a
@@ -305,6 +345,8 @@ interface Span {
    * It is preferred span links be added at span creation.
    *
    * @param link the link to add.
+   *
+   * @since 1.9.0
    */
   addLink(link: Link): this;
   /**
@@ -314,6 +356,8 @@ interface Span {
    * It is preferred span links be added at span creation.
    *
    * @param links the links to add.
+   *
+   * @since 1.9.0
    */
   addLinks(links: Link[]): this;
   /**
@@ -373,6 +417,7 @@ interface Span {
    */
   recordException(exception: Exception, time?: TimeInput): void;
 }
+//#region src/trace/span_kind.d.ts
 /**
  * @since 1.0.0
  */
@@ -402,6 +447,7 @@ declare enum SpanKind {
    */
   CONSUMER = 4
 }
+//#region src/trace/SpanOptions.d.ts
 /**
  * Options needed for span creation
  *
@@ -422,6 +468,7 @@ interface SpanOptions {
   /** The new span should be a root span. (Ignore parent from context). */
   root?: boolean;
 }
+//#region src/trace/tracer.d.ts
 /**
  * Tracer provides an interface for creating {@link Span}s.
  *
@@ -449,6 +496,11 @@ interface Tracer {
    * Additionally the new span gets set in context and this context is activated
    * for the duration of the function call.
    *
+   * **Important**: The callback function is responsible for calling `span.end()`
+   * to finish the span. Unlike some other OpenTelemetry implementations, the span
+   * is NOT automatically ended when the callback returns. If `span.end()` is not
+   * called, the span will never be exported and will be silently lost.
+   *
    * @param name The name of the span
    * @param [options] SpanOptions used for span creation
    * @param [context] Context to use to extract parent

package/dist/providers/opentelemetry/index.d.ts

@@ -1,6 +1,6 @@
+import { T as Tracer } from "../../packem_shared/tracer.d-BklP4tun.js";
 import { B as BaseNotificationPayload } from "../../packem_shared/types.d-COwyORBZ.js";
 import { P as Provider } from "../../packem_shared/provider.d-D5HGHu5g.js";
-import { T as Tracer } from "../../packem_shared/tracer.d-BPznIQx9.js";
 interface OtelProviderConfig {
   /**
    * The OpenTelemetry {@link Tracer} used to create spans. When omitted, a no-op tracer is

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@visulima/notification",
-  "version": "2.0.2",
+  "version": "2.0.3",
   "description": "A reusable, ESM-only, edge-ready multi-channel notification library with SMS, push, chat, in-app and webhook providers",
   "keywords": [
     "agent",
@@ -238,7 +238,7 @@
   "peerDependencies": {
     "@aws-sdk/client-sqs": "^3.0.0",
     "@opentelemetry/api": "^1.0.0 || ^2.0.0",
-    "@visulima/email": "4.2.0",
+    "@visulima/email": "4.2.1",
     "@visulima/workflow": "4.0.0",
     "bullmq": "^5.0.0",
     "croner": "^10.0.1",