@12-apps/notifications 4.10.3 → 4.12.0

package/dist/{create-api-notifications-CcPYrM3p.d.ts → create-api-notifications-BTudlaSC.d.ts}

@@ -1,7 +1,7 @@
-import { N as NotificationGeneratorRegistry } from './generators-qAD4fNPq.js';
-import { b as NotificationRow, C as ChannelMatrix, a as ChannelRow, L as ListNotificationsResult, h as NotificationsCopySource, c as NotificationWireMessages } from './wire-BG1kuoXX.js';
-import { c as NotificationChannel, D as DeliveryStatus, g as NotificationLogger, j as NotificationTransport, d as NotificationContent, b as NotificationCategory, e as NotificationEvent, N as NotificationGenerator } from './types-BlqZkCWZ.js';
-import { e as WebPushSubscriptionSource, D as DriverDeclarationBase, a as WebPushDriverDeclaration, c as WebPushSender } from './web-push-Dnyaha2z.js';
+import { N as NotificationGeneratorRegistry } from './generators-CQYdJfB5.js';
+import { b as NotificationRow, C as ChannelMatrix, a as ChannelRow, T as TypeChannelRules, L as ListNotificationsResult, k as NotificationsCopySource, c as NotificationWireMessages } from './wire-Bn6aA2nL.js';
+import { c as NotificationChannel, D as DeliveryStatus, g as NotificationLogger, j as NotificationTransport, d as NotificationContent, b as NotificationCategory, e as NotificationEvent, N as NotificationGenerator } from './types-H_aFzLA0.js';
+import { e as WebPushSubscriptionSource, D as DriverDeclarationBase, a as WebPushDriverDeclaration, c as WebPushSender } from './web-push-C6U-5JCV.js';
 import { d as EmailChromeCopy, f as EmailTheme } from './template-Dlt5S54z.js';
 
 /**
@@ -600,8 +600,17 @@ interface NotificationPreferenceStore {
     get(userId: string): Promise<ChannelMatrix>;
     /** Persist explicit choices for any subset of categories/toggles. */
     save(userId: string, input: Partial<Record<NotificationCategory, Partial<ChannelRow>>>): Promise<void>;
-    /** The channels enabled for one (user, category) — the router's gate. */
-    enabledChannels(userId: string, category: NotificationCategory): Promise<NotificationChannel[]>;
+    /**
+     * The channels enabled for one (user, category) — the router's gate.
+     *
+     * `rules` carries the emitting TYPE's own declarations (availability and
+     * per-type defaults). It is OPTIONAL, and that is what keeps a host store
+     * written before it working: a two-parameter implementation is assignable to
+     * this signature unchanged, and omitting the argument asks the same question
+     * the store has always answered. The router does not rely on a store
+     * honouring it — it caps the result by availability itself.
+     */
+    enabledChannels(userId: string, category: NotificationCategory, rules?: TypeChannelRules): Promise<NotificationChannel[]>;
 }
 
 /**

package/dist/{create-web-notifications-DV3Y8k7e.d.ts → create-web-notifications-2xxbKnrW.d.ts}

@@ -1,6 +1,6 @@
 import { ReactNode, JSX, ComponentType } from 'react';
-import { L as ListNotificationsResult, a as ChannelRow, I as InboxNotification, N as NotificationMessages } from './wire-BG1kuoXX.js';
-import { c as NotificationChannel } from './types-BlqZkCWZ.js';
+import { L as ListNotificationsResult, a as ChannelRow, I as InboxNotification, N as NotificationMessages } from './wire-Bn6aA2nL.js';
+import { c as NotificationChannel } from './types-H_aFzLA0.js';
 import { b as LiveActivity } from './live-DYxEFO49.js';
 
 /**
@@ -196,17 +196,20 @@ type NotificationsSubscribe = (onHint: () => void) => () => void;
  */
 type NotificationsSignalHook = (onHint: () => void) => void;
 declare function useInboxState(store: InboxStore): InboxState;
-/**
- * The bell badge number: pushed while a subscription is live, polled otherwise.
- *
- * `enabled` gates the poll AND the subscription. A signed-out header still
- * mounts the bell, and there is nothing for it to hear.
- */
-declare function useUnreadCount(store: InboxStore, options?: {
+/** What both badge hooks below take, and what the bell passes them. */
+interface BadgeSyncOptions {
     enabled?: boolean;
     subscribe?: NotificationsSubscribe;
     useSignal?: NotificationsSignalHook;
-}): number;
+}
+/**
+ * The bell badge number, for a host with its own trigger chrome.
+ *
+ * A host that also publishes live activities wants `useBellBadge` from the
+ * factory instead — this one counts inbox rows and knows nothing about what is
+ * happening right now.
+ */
+declare function useUnreadCount(store: InboxStore, options?: BadgeSyncOptions): number;
 /** The panel's list — only fetches while the panel is open. */
 declare function useInboxList(store: InboxStore, open: boolean): InboxState;
 
@@ -285,10 +288,29 @@ interface LiveActivitiesConfig {
     renderIcon?: (activity: LiveActivity) => ReactNode;
 }
 
+/** The bell's whole state — see the file docblock for what each half means. */
+interface BellBadge {
+    /** What the badge shows. `0` renders no badge at all. */
+    count: number;
+    /**
+     * Whether any of it has arrived or moved since the reader last looked.
+     *
+     * The trigger paints this as its accent colour; a host with its own chrome
+     * decides how to say it, but it should be a difference somebody notices.
+     */
+    hasNew: boolean;
+}
+
 /**
  * Bare bell trigger with the live unread badge — for hosts that do not already
- * have a styled icon-button slot. A host with its own trigger chrome uses
- * `useUnreadCount` + `Panel` directly.
+ * have a styled icon-button slot.
+ *
+ * A host with its own trigger chrome uses `useBellBadge` + `Panel` directly,
+ * and NOT `useUnreadCount`, which is what this sentence used to say. That
+ * advice was taken, verbatim and by name, by a storefront whose header needed
+ * its own trigger — and it gave that storefront a bell showing nothing at all
+ * while a live pedido sat in the panel it opens, because `useUnreadCount`
+ * counts inbox rows and knows nothing about what is happening right now.
  */
 
 interface BellButtonProps {
@@ -434,10 +456,35 @@ interface WebNotifications {
         enabled?: boolean;
         onNavigate?: (link: string) => void;
     }>;
-    /** The badge number, for a host with its own trigger chrome. */
+    /**
+     * The unread INBOX count.
+     *
+     * For a host with its own trigger chrome only when that host configured no
+     * live activities — otherwise it is a bell that ignores everything happening
+     * right now, and `useBellBadge` below is the door. Still the right hook for
+     * anything that genuinely wants "how many unread rows".
+     */
     useUnreadCount: (options?: {
         enabled?: boolean;
     }) => number;
+    /**
+     * The badge's NUMBER AND TONE, for a host with its own trigger chrome.
+     *
+     * What `useUnreadCount` should have been for a host that also configured live
+     * activities, and the reason it is a second door rather than a change to that
+     * one: a count alone cannot express a bell, because a live entry is present
+     * without being news (see `./bell-badge`). A host that renders
+     * `useUnreadCount` in its own chrome gets a badge that ignores everything
+     * happening right now — which is not a subtle wrongness, it is the pinned
+     * pedido on screen going uncounted.
+     *
+     * Identical to what this package's own `BellButton` draws, because it is the
+     * hook that bell uses. Without live activities configured it is
+     * `useUnreadCount` plus `hasNew: count > 0`.
+     */
+    useBellBadge: (options?: {
+        enabled?: boolean;
+    }) => BellBadge;
     /** The shared client state, for host glue. */
     store: InboxStore;
     /** The bound wire client. */
@@ -447,4 +494,4 @@ interface WebNotifications {
 }
 declare function createWebNotifications(config: NotificationsWebConfig): WebNotifications;
 
-export { BADGE_POLL_MS as B, type InboxListStatus as I, type LiveActivitiesConfig as L, type NotificationsApiClient as N, PAGE_SIZE as P, type WebNotifications as W, BADGE_RECONCILE_MS as a, type BellButtonProps as b, createWebNotifications as c, type InboxState as d, type InboxStore as e, type LiveActivitiesHook as f, type LiveActivityMessages as g, NotificationsHttpError as h, type NotificationsPanelProps as i, type NotificationsResult as j, type NotificationsSignalHook as k, type NotificationsSubscribe as l, type NotificationsTransport as m, type NotificationsWebConfig as n, type PreferencesPayload as o, type PreferencesScreenProps as p, type PushRegistrationPayload as q, type WebPushPlatformHint as r, type WebPushSetupConfig as s, createInboxStore as t, createNotificationsApiClient as u, httpNotificationsTransport as v, useInboxList as w, useInboxState as x, useUnreadCount as y };
+export { useUnreadCount as A, BADGE_POLL_MS as B, type InboxListStatus as I, type LiveActivitiesConfig as L, type NotificationsApiClient as N, PAGE_SIZE as P, type WebNotifications as W, BADGE_RECONCILE_MS as a, type BadgeSyncOptions as b, createWebNotifications as c, type BellBadge as d, type BellButtonProps as e, type InboxState as f, type InboxStore as g, type LiveActivitiesHook as h, type LiveActivityMessages as i, NotificationsHttpError as j, type NotificationsPanelProps as k, type NotificationsResult as l, type NotificationsSignalHook as m, type NotificationsSubscribe as n, type NotificationsTransport as o, type NotificationsWebConfig as p, type PreferencesPayload as q, type PreferencesScreenProps as r, type PushRegistrationPayload as s, type WebPushPlatformHint as t, type WebPushSetupConfig as u, createInboxStore as v, createNotificationsApiClient as w, httpNotificationsTransport as x, useInboxList as y, useInboxState as z };

package/dist/{generators-qAD4fNPq.d.ts → generators-CQYdJfB5.d.ts}

@@ -1,4 +1,4 @@
-import { N as NotificationGenerator } from './types-BlqZkCWZ.js';
+import { N as NotificationGenerator } from './types-H_aFzLA0.js';
 
 /**
  * Generator registry: one {@link NotificationGenerator} per event `type`.

package/dist/hono/index.d.ts

@@ -1,9 +1,9 @@
 import { Hono, Context } from 'hono';
-import { A as ApiNotifications, N as NotificationsServerConfig, a as NotificationsActor } from '../create-api-notifications-CcPYrM3p.js';
-import '../generators-qAD4fNPq.js';
-import '../types-BlqZkCWZ.js';
-import '../wire-BG1kuoXX.js';
-import '../web-push-Dnyaha2z.js';
+import { A as ApiNotifications, N as NotificationsServerConfig, a as NotificationsActor } from '../create-api-notifications-BTudlaSC.js';
+import '../generators-CQYdJfB5.js';
+import '../types-H_aFzLA0.js';
+import '../wire-Bn6aA2nL.js';
+import '../web-push-C6U-5JCV.js';
 import '../template-Dlt5S54z.js';
 
 /**

package/dist/hono/index.js

@@ -1,12 +1,12 @@
 import {
   createApiNotifications
-} from "../chunk-WVRODNXQ.js";
-import "../chunk-SWOWHIFE.js";
+} from "../chunk-WZBX7YCE.js";
+import "../chunk-GK6GSC2J.js";
 import {
   messagesOf
 } from "../chunk-M2TVBVH2.js";
 import "../chunk-RTURLH5U.js";
-import "../chunk-6W7INOYQ.js";
+import "../chunk-CPQKKLPS.js";
 import "../chunk-EKUSNUBT.js";
 import {
   __name

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-export { D as DeliveryStatus, a as NOTIFICATION_CHANNELS, b as NotificationCategory, c as NotificationChannel, d as NotificationContent, e as NotificationEvent, f as NotificationGenerateContext, N as NotificationGenerator, g as NotificationLogger, h as NotificationRecipient, i as NotificationTaxonomy, j as NotificationTransport, T as TransportRecipient, t as taxonomyOf } from './types-BlqZkCWZ.js';
-export { N as NotificationGeneratorRegistry, c as createGeneratorRegistry } from './generators-qAD4fNPq.js';
-export { C as ChannelMatrix, a as ChannelRow, D as DEFAULT_CHANNEL_ROW, I as InboxNotification, L as ListNotificationsResult, N as NotificationMessages, b as NotificationRow, c as NotificationWireMessages, d as defaultChannelMatrix, e as enabledChannelsOf, i as inboxWire, m as mergeChoices, f as mergeStoredRow, g as messagesOf } from './wire-BG1kuoXX.js';
+export { D as DeliveryStatus, a as NOTIFICATION_CHANNELS, b as NotificationCategory, c as NotificationChannel, d as NotificationContent, e as NotificationEvent, f as NotificationGenerateContext, N as NotificationGenerator, g as NotificationLogger, h as NotificationRecipient, i as NotificationTaxonomy, j as NotificationTransport, T as TransportRecipient, t as taxonomyOf } from './types-H_aFzLA0.js';
+export { N as NotificationGeneratorRegistry, c as createGeneratorRegistry } from './generators-CQYdJfB5.js';
+export { C as ChannelMatrix, a as ChannelRow, D as DEFAULT_CHANNEL_ROW, I as InboxNotification, L as ListNotificationsResult, N as NotificationMessages, b as NotificationRow, c as NotificationWireMessages, T as TypeChannelRules, d as availableChannelsOf, e as capToAvailable, f as defaultChannelMatrix, g as enabledChannelsOf, i as inboxWire, m as mergeChoices, h as mergeStoredRow, j as messagesOf, r as resolveTypeChannels } from './wire-Bn6aA2nL.js';
 export { L as LIVE_PUSH_TAG_PREFIX, a as LIVE_SUBJECT_KEY, b as LiveActivity, c as LiveActivityLane, d as LiveActivityStep, l as liveActivityLane, e as livePushTag } from './live-DYxEFO49.js';
 
 /** Thrown by `notify` when no generator is registered for the event type. */

package/dist/index.js

@@ -2,14 +2,17 @@ import {
   DEFAULT_CHANNEL_ROW,
   UnknownNotificationRecipientError,
   UnknownNotificationTypeError,
+  availableChannelsOf,
+  capToAvailable,
   createGeneratorRegistry,
   defaultChannelMatrix,
   enabledChannelsOf,
   inboxWire,
   mergeChoices,
   mergeStoredRow,
-  normalizePhoneE164
-} from "./chunk-SWOWHIFE.js";
+  normalizePhoneE164,
+  resolveTypeChannels
+} from "./chunk-GK6GSC2J.js";
 import {
   messagesOf
 } from "./chunk-M2TVBVH2.js";
@@ -22,7 +25,7 @@ import {
 import {
   NOTIFICATION_CHANNELS,
   taxonomyOf
-} from "./chunk-6W7INOYQ.js";
+} from "./chunk-CPQKKLPS.js";
 import "./chunk-7QVYU63E.js";
 export {
   DEFAULT_CHANNEL_ROW,
@@ -31,6 +34,8 @@ export {
   NOTIFICATION_CHANNELS,
   UnknownNotificationRecipientError,
   UnknownNotificationTypeError,
+  availableChannelsOf,
+  capToAvailable,
   createGeneratorRegistry,
   defaultChannelMatrix,
   enabledChannelsOf,
@@ -41,6 +46,7 @@ export {
   mergeStoredRow,
   messagesOf,
   normalizePhoneE164,
+  resolveTypeChannels,
   taxonomyOf
 };
 //# sourceMappingURL=index.js.map

package/dist/{jobs--fex87-q.d.ts → jobs-CaovU4GM.d.ts}

@@ -1,5 +1,5 @@
 import { WireJobBlueprint } from '@12-apps/wiring';
-import { A as ApiNotifications } from './create-api-notifications-CcPYrM3p.js';
+import { A as ApiNotifications } from './create-api-notifications-BTudlaSC.js';
 
 /**
  * The two background jobs getting a message out actually needs.

package/dist/manifest/server.d.ts

@@ -1,13 +1,13 @@
 import { EmailPreviewRoute } from '../email/previews/index.js';
 import * as _12_apps_wiring from '@12-apps/wiring';
 import { WireRequest } from '@12-apps/wiring';
-import { N as NotificationsServerConfig, A as ApiNotifications, b as NotificationsRoute } from '../create-api-notifications-CcPYrM3p.js';
-import { N as NotificationsJobDeps } from '../jobs--fex87-q.js';
+import { N as NotificationsServerConfig, A as ApiNotifications, b as NotificationsRoute } from '../create-api-notifications-BTudlaSC.js';
+import { N as NotificationsJobDeps } from '../jobs-CaovU4GM.js';
 import { E as EmailPreviewsConfig } from '../catalog-BOVZ2b-b.js';
-import '../generators-qAD4fNPq.js';
-import '../types-BlqZkCWZ.js';
-import '../wire-BG1kuoXX.js';
-import '../web-push-Dnyaha2z.js';
+import '../generators-CQYdJfB5.js';
+import '../types-H_aFzLA0.js';
+import '../wire-Bn6aA2nL.js';
+import '../web-push-C6U-5JCV.js';
 import '../template-Dlt5S54z.js';
 
 /** One `NotificationsRoute` as the wiring contract reads it. */

package/dist/manifest/server.js

@@ -3,14 +3,14 @@ import {
 } from "../chunk-FTFLU6KH.js";
 import {
   NOTIFICATIONS_JOBS
-} from "../chunk-ZIR3ILFH.js";
+} from "../chunk-FBBPS2LT.js";
 import {
   createApiNotifications
-} from "../chunk-WVRODNXQ.js";
-import "../chunk-SWOWHIFE.js";
+} from "../chunk-WZBX7YCE.js";
+import "../chunk-GK6GSC2J.js";
 import "../chunk-M2TVBVH2.js";
 import "../chunk-RTURLH5U.js";
-import "../chunk-6W7INOYQ.js";
+import "../chunk-CPQKKLPS.js";
 import "../chunk-EKUSNUBT.js";
 import {
   __name

package/dist/manifest/web.d.ts

@@ -1,8 +1,8 @@
 import { c as createEmailPreviewScreen } from '../preview-screen-DYJRAnAY.js';
-import { c as createWebNotifications } from '../create-web-notifications-DV3Y8k7e.js';
+import { c as createWebNotifications } from '../create-web-notifications-2xxbKnrW.js';
 import 'react';
-import '../wire-BG1kuoXX.js';
-import '../types-BlqZkCWZ.js';
+import '../wire-Bn6aA2nL.js';
+import '../types-H_aFzLA0.js';
 import '../live-DYxEFO49.js';
 
 /**

package/dist/manifest/web.js

@@ -1,7 +1,7 @@
 import {
   createWebNotifications
-} from "../chunk-H55A4LHG.js";
-import "../chunk-BW723CX2.js";
+} from "../chunk-PNY6S6WH.js";
+import "../chunk-2IAHFIXS.js";
 import {
   createEmailPreviewScreen
 } from "../chunk-KEYRE245.js";

package/dist/{panel-V2ULFC4Y.js → panel-MKI4PTNZ.js}

@@ -5,7 +5,7 @@ import {
 import {
   BellIcon,
   useInboxList
-} from "./chunk-BW723CX2.js";
+} from "./chunk-2IAHFIXS.js";
 import "./chunk-RTURLH5U.js";
 import {
   __name
@@ -295,4 +295,4 @@ __name(NotificationsPanel, "NotificationsPanel");
 export {
   NotificationsPanel
 };
-//# sourceMappingURL=panel-V2ULFC4Y.js.map
+//# sourceMappingURL=panel-MKI4PTNZ.js.map

package/dist/{preferences-screen-SXUIGECY.js → preferences-screen-S3ZHX5LB.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-CQZMTFPY.js";
 import {
   NOTIFICATION_CHANNELS
-} from "./chunk-6W7INOYQ.js";
+} from "./chunk-CPQKKLPS.js";
 import {
   __name
 } from "./chunk-7QVYU63E.js";
@@ -291,4 +291,4 @@ __name(PreferencesScreen, "PreferencesScreen");
 export {
   PreferencesScreen
 };
-//# sourceMappingURL=preferences-screen-SXUIGECY.js.map
+//# sourceMappingURL=preferences-screen-S3ZHX5LB.js.map

package/dist/react/index.d.ts

@@ -1,10 +1,10 @@
-import { L as LiveActivitiesConfig, N as NotificationsApiClient } from '../create-web-notifications-DV3Y8k7e.js';
-export { B as BADGE_POLL_MS, a as BADGE_RECONCILE_MS, b as BellButtonProps, I as InboxListStatus, d as InboxState, e as InboxStore, f as LiveActivitiesHook, g as LiveActivityMessages, h as NotificationsHttpError, i as NotificationsPanelProps, j as NotificationsResult, k as NotificationsSignalHook, l as NotificationsSubscribe, m as NotificationsTransport, n as NotificationsWebConfig, P as PAGE_SIZE, o as PreferencesPayload, p as PreferencesScreenProps, q as PushRegistrationPayload, W as WebNotifications, r as WebPushPlatformHint, s as WebPushSetupConfig, t as createInboxStore, u as createNotificationsApiClient, c as createWebNotifications, v as httpNotificationsTransport, w as useInboxList, x as useInboxState, y as useUnreadCount } from '../create-web-notifications-DV3Y8k7e.js';
+import { L as LiveActivitiesConfig, N as NotificationsApiClient } from '../create-web-notifications-2xxbKnrW.js';
+export { B as BADGE_POLL_MS, a as BADGE_RECONCILE_MS, b as BadgeSyncOptions, d as BellBadge, e as BellButtonProps, I as InboxListStatus, f as InboxState, g as InboxStore, h as LiveActivitiesHook, i as LiveActivityMessages, j as NotificationsHttpError, k as NotificationsPanelProps, l as NotificationsResult, m as NotificationsSignalHook, n as NotificationsSubscribe, o as NotificationsTransport, p as NotificationsWebConfig, P as PAGE_SIZE, q as PreferencesPayload, r as PreferencesScreenProps, s as PushRegistrationPayload, W as WebNotifications, t as WebPushPlatformHint, u as WebPushSetupConfig, v as createInboxStore, w as createNotificationsApiClient, c as createWebNotifications, x as httpNotificationsTransport, y as useInboxList, z as useInboxState, A as useUnreadCount } from '../create-web-notifications-2xxbKnrW.js';
 import { JSX, ReactNode } from 'react';
 import { b as LiveActivity } from '../live-DYxEFO49.js';
 export { c as LiveActivityLane, d as LiveActivityStep, l as liveActivityLane } from '../live-DYxEFO49.js';
-import { N as NotificationMessages } from '../wire-BG1kuoXX.js';
-import '../types-BlqZkCWZ.js';
+import { N as NotificationMessages } from '../wire-Bn6aA2nL.js';
+import '../types-H_aFzLA0.js';
 
 /**
  * What the reader has already been shown, so the bell can say NEW rather than

package/dist/react/index.js

@@ -3,7 +3,7 @@ import {
   createNotificationsApiClient,
   createWebNotifications,
   httpNotificationsTransport
-} from "../chunk-H55A4LHG.js";
+} from "../chunk-PNY6S6WH.js";
 import {
   LiveSection,
   relativeTime
@@ -17,7 +17,7 @@ import {
   useInboxList,
   useInboxState,
   useUnreadCount
-} from "../chunk-BW723CX2.js";
+} from "../chunk-2IAHFIXS.js";
 import {
   disableWebPush,
   enableWebPush,

package/dist/server/index.d.ts

@@ -1,11 +1,11 @@
-import { A as ApiNotifications } from '../create-api-notifications-CcPYrM3p.js';
-export { C as CommittedNotification, E as EMAIL_DRIVERS, c as EmailDriver, d as EmailDriverDeclaration, e as EmailMessage, f as ExtraDrivers, L as ListNotificationsInput, g as NotificationAudienceDirectory, h as NotificationChannelPolicy, i as NotificationCommittedListener, j as NotificationContactDirectory, k as NotificationCreateData, l as NotificationDelegate, m as NotificationDeliveryDelegate, n as NotificationDeliveryRow, o as NotificationDeliveryWhere, p as NotificationDispatchScheduler, q as NotificationInboxStore, r as NotificationPageAfter, s as NotificationPreferenceDelegate, t as NotificationPreferenceRow, u as NotificationPreferenceStore, v as NotificationRouter, w as NotificationWhere, a as NotificationsActor, x as NotificationsApiError, y as NotificationsDb, z as NotificationsDbClient, B as NotificationsDbProvider, D as NotificationsRequest, F as NotificationsResponse, b as NotificationsRoute, N as NotificationsServerConfig, G as NotifyByPermission, H as NotifyOptions, I as NotifyResult, P as PermissionNotificationResult, J as PermissionNotificationSkip, K as PushSubscriptionDelegate, M as PushSubscriptionInput, O as PushSubscriptionRow, Q as PushSubscriptionStore, S as SMS_DRIVERS, R as SmsDriver, T as SmsDriverDeclaration, U as SmsMessage, V as TransportDeclaration, W as TransportRegistry, X as WHATSAPP_DRIVERS, Y as WhatsAppDriver, Z as WhatsAppDriverDeclaration, _ as WhatsAppMessage, $ as createApiNotifications, a0 as createTransportRegistry, a1 as emailTransport, a2 as foldApiError, a3 as formatEmail, a4 as formatSms, a5 as formatWhatsApp, a6 as ok, a7 as smsTransport, a8 as whatsAppTransport } from '../create-api-notifications-CcPYrM3p.js';
-export { D as DriverDeclarationBase, F as FetchImpl, N as NotificationProviderError, W as WEB_PUSH_DRIVERS, a as WebPushDriverDeclaration, b as WebPushMessage, c as WebPushSender, d as WebPushSubscription, e as WebPushSubscriptionSource, f as absoluteLink, g as formatWebPush, w as webPushTransport } from '../web-push-Dnyaha2z.js';
+import { A as ApiNotifications } from '../create-api-notifications-BTudlaSC.js';
+export { C as CommittedNotification, E as EMAIL_DRIVERS, c as EmailDriver, d as EmailDriverDeclaration, e as EmailMessage, f as ExtraDrivers, L as ListNotificationsInput, g as NotificationAudienceDirectory, h as NotificationChannelPolicy, i as NotificationCommittedListener, j as NotificationContactDirectory, k as NotificationCreateData, l as NotificationDelegate, m as NotificationDeliveryDelegate, n as NotificationDeliveryRow, o as NotificationDeliveryWhere, p as NotificationDispatchScheduler, q as NotificationInboxStore, r as NotificationPageAfter, s as NotificationPreferenceDelegate, t as NotificationPreferenceRow, u as NotificationPreferenceStore, v as NotificationRouter, w as NotificationWhere, a as NotificationsActor, x as NotificationsApiError, y as NotificationsDb, z as NotificationsDbClient, B as NotificationsDbProvider, D as NotificationsRequest, F as NotificationsResponse, b as NotificationsRoute, N as NotificationsServerConfig, G as NotifyByPermission, H as NotifyOptions, I as NotifyResult, P as PermissionNotificationResult, J as PermissionNotificationSkip, K as PushSubscriptionDelegate, M as PushSubscriptionInput, O as PushSubscriptionRow, Q as PushSubscriptionStore, S as SMS_DRIVERS, R as SmsDriver, T as SmsDriverDeclaration, U as SmsMessage, V as TransportDeclaration, W as TransportRegistry, X as WHATSAPP_DRIVERS, Y as WhatsAppDriver, Z as WhatsAppDriverDeclaration, _ as WhatsAppMessage, $ as createApiNotifications, a0 as createTransportRegistry, a1 as emailTransport, a2 as foldApiError, a3 as formatEmail, a4 as formatSms, a5 as formatWhatsApp, a6 as ok, a7 as smsTransport, a8 as whatsAppTransport } from '../create-api-notifications-BTudlaSC.js';
+export { D as DriverDeclarationBase, F as FetchImpl, N as NotificationProviderError, W as WEB_PUSH_DRIVERS, a as WebPushDriverDeclaration, b as WebPushMessage, c as WebPushSender, d as WebPushSubscription, e as WebPushSubscriptionSource, f as absoluteLink, g as formatWebPush, w as webPushTransport } from '../web-push-C6U-5JCV.js';
 import { NotifyPort } from '@12-apps/wiring/ports';
-export { a as NOTIFICATIONS_DRAIN_CRON, b as NOTIFICATIONS_DRAIN_LEASE_MS, c as NOTIFICATIONS_JOBS, d as NOTIFICATIONS_SWEEP_QUEUE, N as NotificationsJobDeps } from '../jobs--fex87-q.js';
-import '../generators-qAD4fNPq.js';
-import '../types-BlqZkCWZ.js';
-import '../wire-BG1kuoXX.js';
+export { a as NOTIFICATIONS_DRAIN_CRON, b as NOTIFICATIONS_DRAIN_LEASE_MS, c as NOTIFICATIONS_JOBS, d as NOTIFICATIONS_SWEEP_QUEUE, N as NotificationsJobDeps } from '../jobs-CaovU4GM.js';
+import '../generators-CQYdJfB5.js';
+import '../types-H_aFzLA0.js';
+import '../wire-Bn6aA2nL.js';
 import '../template-Dlt5S54z.js';
 import '@12-apps/wiring';
 

package/dist/server/index.js

@@ -4,7 +4,7 @@ import {
   NOTIFICATIONS_JOBS,
   NOTIFICATIONS_SWEEP_QUEUE,
   wireNotifyPort
-} from "../chunk-ZIR3ILFH.js";
+} from "../chunk-FBBPS2LT.js";
 import {
   EMAIL_DRIVERS,
   NotificationProviderError,
@@ -25,11 +25,11 @@ import {
   smsTransport,
   webPushTransport,
   whatsAppTransport
-} from "../chunk-WVRODNXQ.js";
-import "../chunk-SWOWHIFE.js";
+} from "../chunk-WZBX7YCE.js";
+import "../chunk-GK6GSC2J.js";
 import "../chunk-M2TVBVH2.js";
 import "../chunk-RTURLH5U.js";
-import "../chunk-6W7INOYQ.js";
+import "../chunk-CPQKKLPS.js";
 import "../chunk-EKUSNUBT.js";
 import "../chunk-7QVYU63E.js";
 export {

package/dist/{types-BlqZkCWZ.d.ts → types-H_aFzLA0.d.ts}

@@ -122,6 +122,39 @@ interface NotificationGenerator<TPayload = unknown> {
     type: string;
     /** The preference category the router gates this type's fan-out on. */
     category: NotificationCategory;
+    /**
+     * The channels this type may EVER use — AVAILABILITY, not preference.
+     *
+     * Absent (the default) means every channel, which is what every generator
+     * written before this field keeps doing. A declared list is a hard cap the
+     * router applies AFTER preferences: a user whose stored row explicitly
+     * enables a channel this type does not offer still does not get it, because
+     * the channel was never on offer for this message. That is the difference
+     * from {@link channelDefaults} — a default is a starting point a user can
+     * move, availability is the set of starting points that exist.
+     *
+     * It is per TYPE because the category is too coarse to say it: the three
+     * comanda kitchen messages sit in `orders` next to `order.paid`, and a diner
+     * three metres from the food wants a push, not correspondence, while the
+     * buyer of a delivery order still wants the e-mail. Declaring `["WEB_PUSH"]`
+     * on the mesa messages says that without splitting the category or taking
+     * `order.paid`'s e-mail away with it.
+     *
+     * Unknown entries are ignored and order is irrelevant — the list is coerced
+     * onto {@link NOTIFICATION_CHANNELS}. An EMPTY list is legal and means no
+     * transport channel at all; the inbox record is written regardless, because
+     * the inbox is not a channel a user opts out of.
+     */
+    channels?: readonly NotificationChannel[];
+    /**
+     * This type's starting toggles, overriding the category's defaults for the
+     * channels it names and only where the user has made NO explicit choice.
+     *
+     * Stored preferences still win over it — that is what makes it a default.
+     * To take a channel away from a user who asked for it, declare
+     * {@link channels} instead.
+     */
+    channelDefaults?: Partial<Record<NotificationChannel, boolean>>;
     /**
      * Render this event's content for ONE recipient.
      *

package/dist/web-push/index.d.ts

@@ -1,5 +1,5 @@
-import { c as WebPushSender } from '../web-push-Dnyaha2z.js';
-import '../types-BlqZkCWZ.js';
+import { c as WebPushSender } from '../web-push-C6U-5JCV.js';
+import '../types-H_aFzLA0.js';
 
 /**
  * `@12-apps/notifications/web-push` — the VAPID sender, behind its own subpath.

package/dist/{web-push-Dnyaha2z.d.ts → web-push-C6U-5JCV.d.ts}

@@ -1,4 +1,4 @@
-import { g as NotificationLogger, d as NotificationContent, j as NotificationTransport } from './types-BlqZkCWZ.js';
+import { g as NotificationLogger, d as NotificationContent, j as NotificationTransport } from './types-H_aFzLA0.js';
 
 /**
  * The DRIVER port — the reason a host adds a vendor with a config entry and no

package/dist/{wire-BG1kuoXX.d.ts → wire-Bn6aA2nL.d.ts}

@@ -1,4 +1,4 @@
-import { b as NotificationCategory, c as NotificationChannel } from './types-BlqZkCWZ.js';
+import { b as NotificationCategory, c as NotificationChannel } from './types-H_aFzLA0.js';
 
 /**
  * Every sentence this package can say to a USER, stated by the HOST.
@@ -163,6 +163,69 @@ declare function defaultChannelMatrix(categories: readonly NotificationCategory[
  * a data migration for every existing row on every channel that ever ships.
  */
 declare function mergeStoredRow(stored: unknown, base: ChannelRow): ChannelRow;
+/**
+ * What ONE notification type says about its own channels, independent of the
+ * user's category preferences: {@link NotificationGenerator.channels} (the hard
+ * availability cap) and {@link NotificationGenerator.channelDefaults} (a
+ * starting point the user can still move).
+ *
+ * Structurally what a generator already is, rather than the generator itself,
+ * so the policy here stays free of the registry and the router.
+ */
+interface TypeChannelRules {
+    channels?: readonly NotificationChannel[];
+    channelDefaults?: Partial<ChannelRow>;
+}
+/**
+ * The channels a type may EVER use, coerced onto the closed channel set.
+ *
+ * `undefined` — a generator that never declared a list — means every channel,
+ * which is what keeps every generator written before the field working. An
+ * EMPTY list means no transport channel at all and is legal: the inbox record
+ * is written by the router regardless, and the inbox is not a channel a user
+ * opts out of.
+ *
+ * Filtering through {@link NOTIFICATION_CHANNELS} rather than returning the
+ * declaration is deliberate: it drops a value that is not a channel (a typo, a
+ * channel removed from the set since) instead of carrying it into an
+ * intersection where it would silently match nothing anyway, and it fixes the
+ * order so two declarations of the same set compare equal.
+ */
+declare function availableChannelsOf(declared: readonly NotificationChannel[] | undefined): NotificationChannel[];
+/**
+ * Drop the channels a type does not offer. Applied by the router AFTER every
+ * other gate, so no later stage can hand back a channel the type never offered
+ * — including the plan gate's own error fallback, which degrades to the free
+ * channels and would otherwise restore an e-mail this type had just refused.
+ */
+declare function capToAvailable(channels: readonly NotificationChannel[], declared: readonly NotificationChannel[] | undefined): NotificationChannel[];
+/**
+ * The channels one (user, category, TYPE) actually enables — the whole policy
+ * in one pure function, so the router's gate can be argued about without a
+ * database.
+ *
+ * The order is the meaning:
+ *   1. the category's defaults, with the TYPE's defaults over them — a type
+ *      moves the starting point;
+ *   2. the user's stored row over that — an explicit choice beats any default,
+ *      which is what makes step 1 a default rather than a rule;
+ *   3. the type's AVAILABILITY over everything — a channel this type does not
+ *      offer is gone even when the user's stored row explicitly asked for it,
+ *      because it was never on offer for this message.
+ *
+ * Step 3 overriding a stored `true` is the one place a user's saved choice is
+ * discarded, and it is the point of the field: the answer they gave was about
+ * the CATEGORY, and a category can hold messages this channel was never right
+ * for. Step 2 beating step 1 is what keeps the other field a default.
+ */
+declare function resolveTypeChannels(input: {
+    /** The stored `channels` JSON for this (user, category), if any. */
+    stored?: unknown;
+    /** The category's effective default row (host defaults already merged). */
+    categoryDefaults: ChannelRow;
+    /** The type's own declarations. */
+    rules?: TypeChannelRules;
+}): NotificationChannel[];
 /** The channels enabled by one effective row — the router's gate. */
 declare function enabledChannelsOf(row: ChannelRow): NotificationChannel[];
 /**
@@ -220,4 +283,4 @@ interface NotificationRow {
 /** Row → wire. Dates become ISO strings; a null `data` becomes `{}`. */
 declare function inboxWire(row: NotificationRow): InboxNotification;
 
-export { type ChannelMatrix as C, DEFAULT_CHANNEL_ROW as D, type InboxNotification as I, type ListNotificationsResult as L, type NotificationMessages as N, type ChannelRow as a, type NotificationRow as b, type NotificationWireMessages as c, defaultChannelMatrix as d, enabledChannelsOf as e, mergeStoredRow as f, messagesOf as g, type NotificationsCopySource as h, inboxWire as i, mergeChoices as m };
+export { type ChannelMatrix as C, DEFAULT_CHANNEL_ROW as D, type InboxNotification as I, type ListNotificationsResult as L, type NotificationMessages as N, type TypeChannelRules as T, type ChannelRow as a, type NotificationRow as b, type NotificationWireMessages as c, availableChannelsOf as d, capToAvailable as e, defaultChannelMatrix as f, enabledChannelsOf as g, mergeStoredRow as h, inboxWire as i, messagesOf as j, type NotificationsCopySource as k, mergeChoices as m, resolveTypeChannels as r };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@12-apps/notifications",
-  "version": "4.10.3",
+  "version": "4.12.0",
   "type": "module",
   "sideEffects": false,
   "description": "Plug-and-play notification system (12-15): an always-on in-app inbox, per-user × per-category channel preferences, and email / SMS / WhatsApp / web-push transports behind vendor DRIVERS so a second provider is a config entry. Framework-free core (.), host-mounted backend surface (./server: inbox / preferences / push-subscription endpoints, the channel router with delivery records + retry sweep, the permission fan-out, duck-typed Prisma seam), Hono adapter (./hono), React surface (./react: bell + badge, inbox drawer, preferences screen), VAPID sender (./web-push) and the package-owned Prisma partial + migrations. Standardized adoption contract in ADOPTING.md.",
@@ -71,7 +71,7 @@
     "prisma:sync:check": "node scripts/sync-notifications-schema.mjs --check"
   },
   "dependencies": {
-    "@12-apps/ui": "^6.19.1"
+    "@12-apps/ui": "^6.25.0"
   },
   "peerDependencies": {
     "@12-apps/wiring": ">=1.3.0",

package/src/index.ts

@@ -48,13 +48,17 @@ export {
 } from './generators';
 
 export {
+  availableChannelsOf,
+  capToAvailable,
   DEFAULT_CHANNEL_ROW,
   defaultChannelMatrix,
   enabledChannelsOf,
   mergeChoices,
   mergeStoredRow,
+  resolveTypeChannels,
   type ChannelMatrix,
   type ChannelRow,
+  type TypeChannelRules,
 } from './preferences-core';
 
 export { normalizePhoneE164, type PhoneNormalizeOptions } from './phone';