@strav/notification 1.0.0-alpha.29 → 1.0.0-alpha.31

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@strav/notification",
-  "version": "1.0.0-alpha.29",
+  "version": "1.0.0-alpha.31",
   "description": "Strav multi-channel notifications — NotificationManager fan-out across channel drivers (mail / database / log / webhook / broadcast / discord / sse). Manager+drivers shape; new channels register via `manager.extend(name, factory)`.",
   "type": "module",
   "main": "./src/index.ts",
@@ -27,19 +27,19 @@
     "access": "public"
   },
   "dependencies": {
-    "@strav/kernel": "1.0.0-alpha.29"
+    "@strav/kernel": "1.0.0-alpha.31"
   },
   "devDependencies": {
-    "@strav/broadcast": "1.0.0-alpha.29",
-    "@strav/database": "1.0.0-alpha.29",
-    "@strav/http": "1.0.0-alpha.29",
-    "@strav/mail": "1.0.0-alpha.29"
+    "@strav/broadcast": "1.0.0-alpha.31",
+    "@strav/database": "1.0.0-alpha.31",
+    "@strav/http": "1.0.0-alpha.31",
+    "@strav/mail": "1.0.0-alpha.31"
   },
   "peerDependencies": {
-    "@strav/broadcast": "1.0.0-alpha.29",
-    "@strav/database": "1.0.0-alpha.29",
-    "@strav/http": "1.0.0-alpha.29",
-    "@strav/mail": "1.0.0-alpha.29",
+    "@strav/broadcast": "1.0.0-alpha.31",
+    "@strav/database": "1.0.0-alpha.31",
+    "@strav/http": "1.0.0-alpha.31",
+    "@strav/mail": "1.0.0-alpha.31",
     "@types/bun": ">=1.3.14"
   },
   "peerDependenciesMeta": {

package/src/drivers/broadcast/broadcast_notification_provider.ts

@@ -1,3 +1,12 @@
+/**
+ * ServiceProvider that registers the broadcast-channel factory on the
+ * `NotificationManager`. Each instance fans out via the resolved
+ * `Broadcaster` — routing per-notification is decided by
+ * `toBroadcast(notifiable)`'s returned `channel` field.
+ *
+ * Include AFTER `NotificationProvider` + `BroadcastProvider`.
+ */
+
 import { Broadcaster } from '@strav/broadcast'
 import { type Application, ServiceProvider } from '@strav/kernel'
 import { NotificationManager } from '../../notification_manager.ts'

package/src/drivers/database/database_config.ts

@@ -1,3 +1,8 @@
+/**
+ * Vendor-specific config shape for the database channel.
+ * Discriminator `driver: 'database'` selects this factory.
+ */
+
 import type { ChannelConfig } from '../../notification_config.ts'
 
 export interface DatabaseChannelConfig extends ChannelConfig {

package/src/drivers/database/tenanted/apply_tenanted_notification_migration.ts

@@ -1,3 +1,12 @@
+/**
+ * `applyTenantedNotificationMigration` — emit DDL for the per-tenant
+ * `notification` table plus a `(tenant_id, notifiable_id, read_at)`
+ * lookup index used by the tenanted `NotificationRepository.unread(...)`.
+ *
+ * Apps that don't need per-tenant scoping use the non-tenanted
+ * `applyNotificationMigration` from `@strav/notification` instead.
+ */
+
 import { type DatabaseExecutor, emitCreateTable, type SchemaRegistry } from '@strav/database'
 import { tenantedNotificationSchema } from './schemas/tenanted_notification_schema.ts'
 

package/src/drivers/database/tenanted/tenanted_notification_record.ts

@@ -1,3 +1,10 @@
+/**
+ * `TenantedNotificationRecord` — typed row of the per-tenant
+ * `notification` ledger. Mirrors `NotificationRecord` with a
+ * `tenant_id` column; apps subclass when they want a per-notifiable
+ * model.
+ */
+
 import { Model } from '@strav/database'
 import { tenantedNotificationSchema } from './schemas/tenanted_notification_schema.ts'
 

package/src/drivers/mail/mail_config.ts

@@ -1,3 +1,8 @@
+/**
+ * Vendor-specific config shape for the mail channel.
+ * Discriminator `driver: 'mail'` selects this factory.
+ */
+
 import type { ChannelConfig } from '../../notification_config.ts'
 
 export interface MailChannelConfig extends ChannelConfig {

package/src/drivers/mail/mail_notification_provider.ts

@@ -1,3 +1,11 @@
+/**
+ * ServiceProvider that registers the mail-channel factory on the
+ * `NotificationManager`. Each instance delegates to `MailManager.via(transport)`
+ * — apps select the transport via the channel's `transport` config field.
+ *
+ * Include AFTER `NotificationProvider` + `MailProvider`.
+ */
+
 import { type Application, ServiceProvider } from '@strav/kernel'
 import { MailManager } from '@strav/mail'
 import { NotificationManager } from '../../notification_manager.ts'