@visulima/notification 1.0.9 → 1.0.11

package/CHANGELOG.md

@@ -1,3 +1,19 @@
+## @visulima/notification [1.0.11](https://github.com/visulima/visulima/compare/%40visulima%2Fnotification%401.0.10...%40visulima%2Fnotification%401.0.11) (2026-08-02)
+
+
+### Dependencies
+
+* **@visulima/email:** upgraded to 2.1.8
+* **@visulima/error:** upgraded to 6.1.0
+* **@visulima/workflow:** upgraded to 2.0.0
+
+## @visulima/notification [1.0.10](https://github.com/visulima/visulima/compare/%40visulima%2Fnotification%401.0.9...%40visulima%2Fnotification%401.0.10) (2026-07-27)
+
+
+### Dependencies
+
+* **@visulima/email:** upgraded to 2.1.7
+
 ## @visulima/notification [1.0.9](https://github.com/visulima/visulima/compare/%40visulima%2Fnotification%401.0.8...%40visulima%2Fnotification%401.0.9) (2026-07-27)
 
 

package/dist/channels/email/index.d.ts

@@ -1,8 +1,8 @@
-import { P as Provider } from "../../packem_shared/provider.d-BQAGriz6.js";
-import { E as EmailChannelPayload } from "../../packem_shared/types.d-GUzX1jTk.js";
+import { P as Provider } from "../../packem_shared/provider.d-Dh32nRm9.js";
+import { E as EmailChannelPayload } from "../../packem_shared/types.d-C7l7qdMG.js";
 /**
-* The result shape returned by `@visulima/email`'s `Mail.send`.
-*/
+ * The result shape returned by `@visulima/email`'s `Mail.send`.
+ */
 interface EmailSendResult {
   data?: {
     messageId: string;
@@ -15,9 +15,9 @@ interface EmailSendResult {
   success: boolean;
 }
 /**
-* Structural type for a `@visulima/email` `Mail` instance. Kept structural so the email
-* peer stays optional — pass a configured `createMail(...)` result.
-*/
+ * Structural type for a `@visulima/email` `Mail` instance. Kept structural so the email
+ * peer stays optional — pass a configured `createMail(...)` result.
+ */
 interface EmailLike {
   send: (message: unknown) => Promise<EmailSendResult>;
 }
@@ -26,21 +26,21 @@ interface EmailChannelConfig {
   id?: string;
 }
 /**
-* Adapts a configured `@visulima/email` `Mail` instance into a notification channel
-* provider, so email can participate in multi-channel sends and routing.
-* @param mail A `Mail` instance from `createMail(...)`.
-* @param config Optional config.
-* @returns An email-channel provider.
-* @example
-* ```ts
-* import { createMail } from "@visulima/email";
-* import { resendProvider } from "@visulima/email/providers/resend";
-* import { createNotification } from "@visulima/notification";
-* import { emailChannel } from "@visulima/notification/channels/email";
-*
-* const mail = createMail(resendProvider({ apiKey }));
-* const notify = createNotification({ email: emailChannel(mail) });
-* ```
-*/
+ * Adapts a configured `@visulima/email` `Mail` instance into a notification channel
+ * provider, so email can participate in multi-channel sends and routing.
+ * @param mail A `Mail` instance from `createMail(...)`.
+ * @param config Optional config.
+ * @returns An email-channel provider.
+ * @example
+ * ```ts
+ * import { createMail } from "@visulima/email";
+ * import { resendProvider } from "@visulima/email/providers/resend";
+ * import { createNotification } from "@visulima/notification";
+ * import { emailChannel } from "@visulima/notification/channels/email";
+ *
+ * const mail = createMail(resendProvider({ apiKey }));
+ * const notify = createNotification({ email: emailChannel(mail) });
+ * ```
+ */
 declare const emailChannel: (mail: EmailLike, config?: EmailChannelConfig) => Provider<unknown, EmailChannelPayload>;
 export { type EmailChannelConfig, type EmailLike, emailChannel };

package/dist/channels/email/index.js

@@ -1 +1 @@
-import{emailChannel as l}from"../../packem_shared/emailChannel-CNDlX96Q.js";export{l as emailChannel};
+import{emailChannel as l}from"../../packem_shared/emailChannel-BoLLbyrn.js";export{l as emailChannel};

package/dist/channels/inapp/index.d.ts

@@ -1,9 +1,9 @@
-import { P as Provider } from "../../packem_shared/provider.d-BQAGriz6.js";
-import { I as InAppPayload } from "../../packem_shared/types.d-GUzX1jTk.js";
+import { P as Provider } from "../../packem_shared/provider.d-Dh32nRm9.js";
+import { I as InAppPayload } from "../../packem_shared/types.d-C7l7qdMG.js";
 import { S as Storage } from "../../packem_shared/unstorage.DqlWKU2I.d-CogP3Etw.js";
 /**
-* A persisted in-app notification.
-*/
+ * A persisted in-app notification.
+ */
 interface StoredNotification {
   actions?: {
     label: string;
@@ -24,9 +24,9 @@ interface ListOptions {
   unreadOnly?: boolean;
 }
 /**
-* Backing store for the in-app channel. The default {@link MemoryInAppStore} is
-* in-process; back it with a persistent store for production feeds.
-*/
+ * Backing store for the in-app channel. The default {@link MemoryInAppStore} is
+ * in-process; back it with a persistent store for production feeds.
+ */
 interface InAppStore {
   add: (notification: Omit<StoredNotification, "createdAt" | "id" | "read"> & {
     id?: string;
@@ -38,8 +38,8 @@ interface InAppStore {
   unreadCount: (subscriberId: string) => Promise<number>;
 }
 /**
-* In-memory {@link InAppStore}.
-*/
+ * In-memory {@link InAppStore}.
+ */
 declare class MemoryInAppStore implements InAppStore {
   #private;
   add(notification: Omit<StoredNotification, "createdAt" | "id" | "read"> & {
@@ -58,25 +58,25 @@ interface InAppProviderConfig {
   store?: InAppStore;
 }
 /**
-* In-app channel provider. Persists notifications to an {@link InAppStore} for a feed/inbox
-* UI to query. Expose the store via `getInstance()` to read/markRead.
-* @param config Provider `id` and the backing {@link InAppStore} (defaults to in-memory).
-* @returns A provider that writes notifications into the configured store.
-*/
+ * In-app channel provider. Persists notifications to an {@link InAppStore} for a feed/inbox
+ * UI to query. Expose the store via `getInstance()` to read/markRead.
+ * @param config Provider `id` and the backing {@link InAppStore} (defaults to in-memory).
+ * @returns A provider that writes notifications into the configured store.
+ */
 declare const inAppProvider: (config?: InAppProviderConfig) => Provider<InAppProviderConfig, InAppPayload, InAppStore>;
 /**
-* An {@link InAppStore} backed by an [unstorage](https://unstorage.unjs.io) driver, giving durable,
-* multi-backend persistence (Redis, filesystem, Cloudflare KV, ...). `unstorage` is an optional peer
-* dependency — pass a configured `Storage` instance.
-*
-* Each notification is stored under `prefix:item:id`, and a per-subscriber index list is kept under
-* `prefix:index:subscriberId` so `list`/`unreadCount`/`markAllRead` avoid scanning every key.
-*
-* The per-subscriber index is eventually-consistent: the item and index keys are written
-* non-atomically, so a concurrent reader may briefly observe one without the other.
-*
-* Edge-safe: works on Cloudflare KV (and other edge runtimes) via the matching unstorage driver.
-*/
+ * An {@link InAppStore} backed by an [unstorage](https://unstorage.unjs.io) driver, giving durable,
+ * multi-backend persistence (Redis, filesystem, Cloudflare KV, ...). `unstorage` is an optional peer
+ * dependency — pass a configured `Storage` instance.
+ *
+ * Each notification is stored under `prefix:item:id`, and a per-subscriber index list is kept under
+ * `prefix:index:subscriberId` so `list`/`unreadCount`/`markAllRead` avoid scanning every key.
+ *
+ * The per-subscriber index is eventually-consistent: the item and index keys are written
+ * non-atomically, so a concurrent reader may briefly observe one without the other.
+ *
+ * Edge-safe: works on Cloudflare KV (and other edge runtimes) via the matching unstorage driver.
+ */
 declare class UnstorageInAppStore implements InAppStore {
   #private;
   constructor(storage: Storage, prefix?: string);
@@ -90,10 +90,10 @@ declare class UnstorageInAppStore implements InAppStore {
   remove(id: string): Promise<void>;
 }
 /**
-* Convenience factory for {@link UnstorageInAppStore}.
-* @param storage A configured unstorage `Storage` instance (optional peer).
-* @param prefix Key prefix under which notifications are stored.
-* @returns A new {@link UnstorageInAppStore}.
-*/
+ * Convenience factory for {@link UnstorageInAppStore}.
+ * @param storage A configured unstorage `Storage` instance (optional peer).
+ * @param prefix Key prefix under which notifications are stored.
+ * @returns A new {@link UnstorageInAppStore}.
+ */
 declare const createUnstorageInAppStore: (storage: Storage, prefix?: string) => UnstorageInAppStore;
 export { type InAppProviderConfig, type InAppStore, type ListOptions, MemoryInAppStore, type StoredNotification, UnstorageInAppStore, createUnstorageInAppStore, inAppProvider };

package/dist/digest/index.d.ts

@@ -1,4 +1,4 @@
-import { M as MaybePromise, D as Duration } from "../packem_shared/types.d-C1GoEAlI.d-Bv3grfyD.js";
+import { M as MaybePromise, D as Duration } from "../packem_shared/types.d-CcjfiGpo.d-DuZME7ry.js";
 import '@standard-schema/spec';
 /** A single event buffered inside a digest window. */
 interface DigestEvent<PayloadT> {
@@ -17,19 +17,19 @@ interface DigestWindow<PayloadT> {
   wakeAt: number;
 }
 /**
-* Durability contract for `createDigester`. Implementations own the buffered
-* windows and the "what is due" query; the digester stays storage-agnostic.
-*
-* `read` and `remove` are separate (rather than a single destructive `drain`) so
-* the digester can flush a window's events *before* removing it — a failed flush
-* leaves the window in place to be retried (at-least-once).
-*/
+ * Durability contract for `createDigester`. Implementations own the buffered
+ * windows and the "what is due" query; the digester stays storage-agnostic.
+ *
+ * `read` and `remove` are separate (rather than a single destructive `drain`) so
+ * the digester can flush a window's events *before* removing it — a failed flush
+ * leaves the window in place to be retried (at-least-once).
+ */
 interface DigestStore<PayloadT> {
   /**
-  * Append an event to the window for `key`, opening it (with `wakeAt`) if absent.
-  * The window's `wakeAt` is fixed when it opens — later events do not extend it.
-  * @returns `true` if this call opened a new window.
-  */
+   * Append an event to the window for `key`, opening it (with `wakeAt`) if absent.
+   * The window's `wakeAt` is fixed when it opens — later events do not extend it.
+   * @returns `true` if this call opened a new window.
+   */
   append: (key: string, event: DigestEvent<PayloadT>, wakeAt: number) => Promise<boolean>;
   /** Keys whose window `wakeAt` is at or before `now`, up to `limit`. */
   due: (now: number, limit: number) => Promise<string[]>;
@@ -43,11 +43,11 @@ interface DigesterOptions<PayloadT> {
   /** Group events into windows by this key (e.g. `subscriberId` or `subscriberId:postId`). */
   key: (event: PayloadT) => string;
   /**
-  * Called once per window when it closes, with every event collected. Delivery is
-  * **at-least-once**: the window is removed only after `onFlush` resolves, so a
-  * throwing `onFlush` is retried on the next sweep (and may run again if removal
-  * later fails). Make it idempotent.
-  */
+   * Called once per window when it closes, with every event collected. Delivery is
+   * **at-least-once**: the window is removed only after `onFlush` resolves, so a
+   * throwing `onFlush` is retried on the next sweep (and may run again if removal
+   * later fails). Make it idempotent.
+   */
   onFlush: (events: DigestEvent<PayloadT>[], key: string) => MaybePromise<void>;
   /** The durable store; defaults to an in-memory store. */
   store?: DigestStore<PayloadT>;
@@ -62,32 +62,32 @@ interface Digester<PayloadT> {
   sweep: (now?: number, limit?: number) => Promise<number>;
 }
 /**
-* Create a {@link Digester} that batches events into time/cron windows keyed by
-* `options.key`, flushing each closed window once via `options.onFlush` — turning
-* a burst of N events into a single notification.
-*
-* Windows close on a poll: call {@link Digester.sweep} from a cron job, a
-* Cloudflare alarm, or any timer (alongside a workflow runtime's `sweep`).
-* @param options Key function, window duration, flush handler and optional store.
-* @returns A {@link Digester}.
-* @example
-* ```ts
-* const digester = createDigester<{ subscriberId: string; postId: string }>({
-*     key: (event) => `${event.subscriberId}:${event.postId}`,
-*     window: { amount: 10, unit: "minutes" },
-*     onFlush: (events) => runtime.trigger(summaryWorkflow, { count: events.length, events }),
-* });
-*
-* await digester.add({ subscriberId: "u1", postId: "p1" }); // opens a 10-minute window
-* // …later, on a timer:
-* await digester.sweep();
-* ```
-*/
+ * Create a {@link Digester} that batches events into time/cron windows keyed by
+ * `options.key`, flushing each closed window once via `options.onFlush` — turning
+ * a burst of N events into a single notification.
+ *
+ * Windows close on a poll: call {@link Digester.sweep} from a cron job, a
+ * Cloudflare alarm, or any timer (alongside a workflow runtime's `sweep`).
+ * @param options Key function, window duration, flush handler and optional store.
+ * @returns A {@link Digester}.
+ * @example
+ * ```ts
+ * const digester = createDigester<{ subscriberId: string; postId: string }>({
+ *     key: (event) => `${event.subscriberId}:${event.postId}`,
+ *     window: { amount: 10, unit: "minutes" },
+ *     onFlush: (events) => runtime.trigger(summaryWorkflow, { count: events.length, events }),
+ * });
+ *
+ * await digester.add({ subscriberId: "u1", postId: "p1" }); // opens a 10-minute window
+ * // …later, on a timer:
+ * await digester.sweep();
+ * ```
+ */
 declare const createDigester: <PayloadT>(options: DigesterOptions<PayloadT>) => Digester<PayloadT>;
 /**
-* In-process {@link DigestStore}. Ideal for tests and single-instance apps; swap
-* for the unstorage adapter for durability across restarts and instances.
-*/
+ * In-process {@link DigestStore}. Ideal for tests and single-instance apps; swap
+ * for the unstorage adapter for durability across restarts and instances.
+ */
 declare class MemoryDigestStore<PayloadT> implements DigestStore<PayloadT> {
   #private;
   append(key: string, event: DigestEvent<PayloadT>, wakeAt: number): Promise<boolean>;
@@ -96,9 +96,9 @@ declare class MemoryDigestStore<PayloadT> implements DigestStore<PayloadT> {
   due(now: number, limit: number): Promise<string[]>;
 }
 /**
-* Minimal structural view of an [unstorage](https://unstorage.unjs.io) instance,
-* declared locally so the package needs no hard `unstorage` dependency.
-*/
+ * Minimal structural view of an [unstorage](https://unstorage.unjs.io) instance,
+ * declared locally so the package needs no hard `unstorage` dependency.
+ */
 interface UnstorageLike {
   getItem: <T = unknown>(key: string) => Promise<T | null>;
   getKeys: (base?: string) => Promise<string[]>;
@@ -106,17 +106,17 @@ interface UnstorageLike {
   setItem: (key: string, value: unknown) => Promise<void>;
 }
 /**
-* {@link DigestStore} backed by [unstorage](https://unstorage.unjs.io), for durable,
-* edge-friendly digest windows over any unstorage driver.
-*
-* Each window is a single self-contained document keyed by `digest:w:` plus the
-* digest key; there is no shared index, so concurrent `add`s for different keys cannot
-* lose-update each other. `due` scans the window documents under the prefix — fine for the
-* transient, bounded set of open windows. Individual reads/writes are still not
-* transactional, so concurrent writers on the *same* key (or a sweep racing an
-* `add` for that key) can drop an event or double-flush; for that level of
-* contention prefer a store with atomic guarantees, or sweep from one instance.
-*/
+ * {@link DigestStore} backed by [unstorage](https://unstorage.unjs.io), for durable,
+ * edge-friendly digest windows over any unstorage driver.
+ *
+ * Each window is a single self-contained document keyed by `digest:w:` plus the
+ * digest key; there is no shared index, so concurrent `add`s for different keys cannot
+ * lose-update each other. `due` scans the window documents under the prefix — fine for the
+ * transient, bounded set of open windows. Individual reads/writes are still not
+ * transactional, so concurrent writers on the *same* key (or a sweep racing an
+ * `add` for that key) can drop an event or double-flush; for that level of
+ * contention prefer a store with atomic guarantees, or sweep from one instance.
+ */
 declare class UnstorageDigestStore<PayloadT> implements DigestStore<PayloadT> {
   #private;
   constructor(storage: UnstorageLike);

package/dist/digest/index.js

@@ -1 +1 @@
-import{default as r}from"../packem_shared/createDigester-vMNPejGF.js";import{default as a}from"../packem_shared/MemoryDigestStore-Bw-sE5MI.js";import{default as f}from"../packem_shared/UnstorageDigestStore-QAcO3Vb_.js";export{a as MemoryDigestStore,f as UnstorageDigestStore,r as createDigester};
+import{default as r}from"../packem_shared/createDigester-DCwWhmpi.js";import{default as a}from"../packem_shared/MemoryDigestStore-Bw-sE5MI.js";import{default as f}from"../packem_shared/UnstorageDigestStore-QAcO3Vb_.js";export{a as MemoryDigestStore,f as UnstorageDigestStore,r as createDigester};

package/dist/events/index.d.ts

@@ -1,14 +1,14 @@
-import { N as NotificationEvent, e as NotificationEventType } from "../packem_shared/types.d-GUzX1jTk.js";
+import { N as NotificationEvent, e as NotificationEventType } from "../packem_shared/types.d-C7l7qdMG.js";
 /**
-* An append-only timeline store for notification events.
-*/
+ * An append-only timeline store for notification events.
+ */
 interface EventStore {
   append: (event: NotificationEvent) => void | Promise<void>;
   timeline: (messageId: string) => NotificationEvent[] | Promise<NotificationEvent[]>;
 }
 /**
-* In-memory {@link EventStore} keyed by message id.
-*/
+ * In-memory {@link EventStore} keyed by message id.
+ */
 declare class MemoryEventStore implements EventStore {
   #private;
   append(event: NotificationEvent): void;
@@ -16,22 +16,22 @@ declare class MemoryEventStore implements EventStore {
 }
 type NotificationEventListener = (event: NotificationEvent) => void;
 /**
-* A tiny synchronous event bus for notification lifecycle events. Listeners can subscribe
-* to a specific {@link NotificationEventType} or to all events with `"*"`.
-*/
+ * A tiny synchronous event bus for notification lifecycle events. Listeners can subscribe
+ * to a specific {@link NotificationEventType} or to all events with `"*"`.
+ */
 declare class NotificationEventBus {
   #private;
   /**
-  * Subscribes to an event type (or `"*"` for all).
-  * @param type A specific {@link NotificationEventType} to listen for, or `"*"` for every event.
-  * @param listener The callback invoked with each matching event.
-  * @returns An unsubscribe function.
-  */
+   * Subscribes to an event type (or `"*"` for all).
+   * @param type A specific {@link NotificationEventType} to listen for, or `"*"` for every event.
+   * @param listener The callback invoked with each matching event.
+   * @returns An unsubscribe function.
+   */
   on(type: "*" | NotificationEventType, listener: NotificationEventListener): () => void;
   /**
-  * Emits an event to matching listeners.
-  * @param event The event to emit.
-  */
+   * Emits an event to matching listeners.
+   * @param event The event to emit.
+   */
   emit(event: NotificationEvent): void;
 }
 export { type EventStore, MemoryEventStore, NotificationEventBus, NotificationEventListener };

package/dist/i18n/index.d.ts

@@ -17,26 +17,26 @@ interface Translator {
   translate: (locale: string, key: string, values?: Record<string, unknown>) => string;
 }
 /**
-* Create a {@link Translator} over a set of locale message tables, using
-* [ICU MessageFormat](https://formatjs.io/docs/core-concepts/icu-syntax/) (plurals,
-* select, number/date) via `intl-messageformat`, with region → language → fallback
-* resolution driven by the subscriber's locale. Edge-safe and dependency-light
-* (requires the `intl-messageformat` peer).
-* @param options Message tables, fallback locale, and an optional missing-key handler.
-* @returns A {@link Translator}.
-* @example
-* ```ts
-* const t = createTranslator({
-*     fallbackLocale: "en",
-*     messages: {
-*         en: { likes: "{count, plural, one {# like} other {# likes}}" },
-*         de_DE: { likes: "{count, plural, one {# Like} other {# Likes}}" },
-*     },
-* });
-*
-* t.translate("de_DE", "likes", { count: 3 }); // "3 Likes"
-* t.translate("fr", "likes", { count: 1 });    // falls back to en → "1 like"
-* ```
-*/
+ * Create a {@link Translator} over a set of locale message tables, using
+ * [ICU MessageFormat](https://formatjs.io/docs/core-concepts/icu-syntax/) (plurals,
+ * select, number/date) via `intl-messageformat`, with region → language → fallback
+ * resolution driven by the subscriber's locale. Edge-safe and dependency-light
+ * (requires the `intl-messageformat` peer).
+ * @param options Message tables, fallback locale, and an optional missing-key handler.
+ * @returns A {@link Translator}.
+ * @example
+ * ```ts
+ * const t = createTranslator({
+ *     fallbackLocale: "en",
+ *     messages: {
+ *         en: { likes: "{count, plural, one {# like} other {# likes}}" },
+ *         de_DE: { likes: "{count, plural, one {# Like} other {# Likes}}" },
+ *     },
+ * });
+ *
+ * t.translate("de_DE", "likes", { count: 3 }); // "3 Likes"
+ * t.translate("fr", "likes", { count: 1 });    // falls back to en → "1 like"
+ * ```
+ */
 declare const createTranslator: (options: TranslatorOptions) => Translator;
 export { type Translator, type TranslatorOptions, createTranslator };

package/dist/i18n/index.js

@@ -1 +1 @@
-import{default as e}from"../packem_shared/createTranslator-CY91C2eS.js";export{e as createTranslator};
+import{default as e}from"../packem_shared/createTranslator-BL2M8eeD.js";export{e as createTranslator};