@12-apps/notifications 4.11.0 → 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-CnaXx6km.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';
 
 /**

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-CnaXx6km.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,6 +1,6 @@
 import {
   createWebNotifications
-} from "../chunk-2TJ4D2KE.js";
+} from "../chunk-PNY6S6WH.js";
 import "../chunk-2IAHFIXS.js";
 import {
   createEmailPreviewScreen

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-CnaXx6km.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-CnaXx6km.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-2TJ4D2KE.js";
+} from "../chunk-PNY6S6WH.js";
 import {
   LiveSection,
   relativeTime

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.11.0",
+  "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.22.0"
+    "@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';

package/src/preferences-core.ts

@@ -70,11 +70,118 @@ export function mergeStoredRow(stored: unknown, base: ChannelRow): ChannelRow {
   return row;
 }
 
+/**
+ * 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.
+ */
+export 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.
+ */
+export function availableChannelsOf(
+  declared: readonly NotificationChannel[] | undefined,
+): NotificationChannel[] {
+  if (!declared) return [...NOTIFICATION_CHANNELS];
+  const offered = new Set<string>(declared);
+  return NOTIFICATION_CHANNELS.filter((channel) => offered.has(channel));
+}
+
+/**
+ * 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.
+ */
+export function capToAvailable(
+  channels: readonly NotificationChannel[],
+  declared: readonly NotificationChannel[] | undefined,
+): NotificationChannel[] {
+  if (!declared) return [...channels];
+  const offered = new Set(availableChannelsOf(declared));
+  return channels.filter((channel) => offered.has(channel));
+}
+
+/**
+ * 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.
+ */
+export 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[] {
+  const { stored, categoryDefaults, rules } = input;
+  const base: ChannelRow = { ...categoryDefaults, ...rules?.channelDefaults };
+  const row = stored === undefined || stored === null ? base : mergeStoredRow(stored, base);
+  return capToAvailable(enabledChannelsOf(row), rules?.channels);
+}
+
 /** The channels enabled by one effective row — the router's gate. */
 export function enabledChannelsOf(row: ChannelRow): NotificationChannel[] {
   return NOTIFICATION_CHANNELS.filter((channel) => row[channel]);
 }
 
+/**
+ * The channels a stored row states an EXPLICIT choice for, dropping everything
+ * else — the inverse of {@link mergeStoredRow}, which fills the gaps in.
+ *
+ * The package's storage model is "only explicit choices are stored; a missing
+ * key falls back to the default", and this is what lets a writer keep that
+ * promise. Merging a save onto the user's EFFECTIVE row instead turns every
+ * defaulted channel into an explicit one the moment they touch any switch, and
+ * the row can never say "no opinion" about a channel again.
+ */
+export function explicitChoicesOf(stored: unknown): Partial<ChannelRow> {
+  const choices: Partial<ChannelRow> = {};
+  if (stored && typeof stored === 'object') {
+    const record = stored as Record<string, unknown>;
+    for (const channel of NOTIFICATION_CHANNELS) {
+      const value = record[channel];
+      if (typeof value === 'boolean') choices[channel] = value;
+    }
+  }
+  return choices;
+}
+
 /**
  * What a PUT writes for one category: the caller's toggles merged over the
  * user's CURRENT effective row. A single-toggle save (how the settings UI