podverse-notifications 1.0.0 → 5.1.19-alpha.0

package/README.md

@@ -1,2 +1,258 @@
 # podverse-notifications
-Push notification helper module for Podverse use cases
+
+Push notification module for Podverse. Handles notification orchestration for multiple services.
+
+## Features
+
+- **Web Push** - Native browser push notifications using the W3C Push API (no third-party dependency)
+- **Firebase FCM** - Firebase Cloud Messaging for mobile apps (via podverse-external-services)
+- **i18n Support** - Localized notification prefixes
+- **Service Orchestration** - Unified API for sending notifications across multiple services
+
+## Services
+
+### Web Push (Native)
+
+Web Push uses the W3C Push API standard. It's built into modern browsers and doesn't require any third-party service. The browser's built-in push service handles message delivery:
+
+- **Chrome/Edge**: Google's push service
+- **Firefox**: Mozilla's push service  
+- **Safari**: Apple's push service
+
+### Firebase FCM (Third-Party)
+
+Firebase Cloud Messaging is used for mobile app notifications (iOS/Android). This is handled by `podverse-external-services` since it's a third-party dependency.
+
+## Installation
+
+```bash
+npm install podverse-notifications
+```
+
+## Configuration
+
+### Environment Variables
+
+```env
+# Web Push Configuration
+WEBPUSH_ENABLED=true
+WEBPUSH_VAPID_PUBLIC_KEY=your-vapid-public-key
+WEBPUSH_VAPID_PRIVATE_KEY=your-vapid-private-key
+WEBPUSH_VAPID_SUBJECT=mailto:contact@podverse.fm
+
+# Web URL Configuration (for notification links)
+WEB_PROTOCOL=https
+WEB_DOMAIN=podverse.fm
+WEB_ICON_IMAGE_PATH=https://podverse.fm/favicon/web-app-manifest-192x192.png
+```
+
+### Environment-Specific Configuration
+
+#### Local Development
+
+For local development, set environment variables in your `.env` file or shell:
+
+```env
+WEBPUSH_ENABLED=true
+WEBPUSH_VAPID_PUBLIC_KEY=your-dev-vapid-public-key
+WEBPUSH_VAPID_PRIVATE_KEY=your-dev-vapid-private-key
+WEBPUSH_VAPID_SUBJECT=mailto:dev@example.com
+
+WEB_PROTOCOL=http
+WEB_DOMAIN=localhost:3000
+```
+
+#### Alpha/Staging
+
+For alpha/staging environments, configure via Docker environment or secrets:
+
+```env
+WEBPUSH_ENABLED=true
+WEBPUSH_VAPID_PUBLIC_KEY=your-alpha-vapid-public-key
+WEBPUSH_VAPID_PRIVATE_KEY=your-alpha-vapid-private-key
+WEBPUSH_VAPID_SUBJECT=mailto:contact@podverse.fm
+
+WEB_PROTOCOL=https
+WEB_DOMAIN=alpha.podverse.fm
+```
+
+#### Production
+
+For production, use secrets management (Kubernetes secrets, Docker secrets, etc.):
+
+```env
+WEBPUSH_ENABLED=true
+WEBPUSH_VAPID_PUBLIC_KEY=your-production-vapid-public-key
+WEBPUSH_VAPID_PRIVATE_KEY=your-production-vapid-private-key  # Keep secret!
+WEBPUSH_VAPID_SUBJECT=mailto:contact@podverse.fm
+
+WEB_PROTOCOL=https
+WEB_DOMAIN=podverse.fm
+```
+
+### Key Matching Requirement
+
+**Important:** The VAPID public key in `podverse-notifications` (backend) must match the key in `podverse-web` (frontend):
+
+| Service | Environment Variable | Key Type |
+|---------|---------------------|----------|
+| podverse-web | `NEXT_PUBLIC_WEBPUSH_VAPID_PUBLIC_KEY` | Public only |
+| podverse-notifications | `WEBPUSH_VAPID_PUBLIC_KEY` | Public |
+| podverse-notifications | `WEBPUSH_VAPID_PRIVATE_KEY` | Private (secret) |
+
+If keys don't match, push notifications will fail with authentication errors.
+
+## Generating VAPID Keys
+
+VAPID (Voluntary Application Server Identification) keys are required for Web Push notifications.
+
+### Method 1: Using web-push CLI (Recommended)
+
+```bash
+# Install web-push globally
+npm install -g web-push
+
+# Generate VAPID keys
+web-push generate-vapid-keys
+```
+
+Output:
+```
+=======================================
+
+Public Key:
+BNxIq7...your-public-key...
+
+Private Key:
+AkT3Xy...your-private-key...
+
+=======================================
+```
+
+### Method 2: Using npx (No Install)
+
+```bash
+npx web-push generate-vapid-keys
+```
+
+### Method 3: Using Node.js Script
+
+```javascript
+const webpush = require('web-push');
+const keys = webpush.generateVAPIDKeys();
+console.log('Public Key:', keys.publicKey);
+console.log('Private Key:', keys.privateKey);
+```
+
+### Important Notes
+
+- **Keep the private key secret** - Only the backend needs it
+- **Use the same key pair everywhere** - Frontend (public only) and backend (public + private) must use the same key pair
+- **Don't regenerate unnecessarily** - Changing keys invalidates all existing push subscriptions
+- **VAPID subject** - Should be a `mailto:` or `https://` URL identifying your service
+
+## Usage
+
+### Notification Orchestrator
+
+The main entry point for sending notifications:
+
+```typescript
+import { notificationOrchestrator } from 'podverse-notifications';
+
+// Send Web Push notifications (native, no third-party)
+// The endpoint URL is provided by the browser when the user subscribes
+await notificationOrchestrator({
+  service: 'webpush',
+  subscriptions: [
+    {
+      endpoint: 'https://push.example.com/...', // Browser-provided endpoint
+      keys: {
+        p256dh: 'public-key-from-subscription',
+        auth: 'auth-secret-from-subscription'
+      }
+    }
+  ],
+  messageText: 'New Episode: My Podcast',
+  messageType: 'new-episode',
+  locale: 'en',
+  linkIdText: 'episode-id-text'
+});
+
+// Send Firebase FCM notifications (for mobile apps)
+await notificationOrchestrator({
+  service: 'firebase',
+  tokens: ['fcm-token-1', 'fcm-token-2'],
+  platform: 'android', // or 'ios'
+  messageText: 'New Episode: My Podcast',
+  messageType: 'new-episode',
+  locale: 'en',
+  linkIdText: 'episode-id-text'
+});
+```
+
+### Message Types
+
+Supported notification message types:
+
+| Type | Description |
+|------|-------------|
+| `new` | Generic new content |
+| `new-episode` | New podcast episode |
+| `new-podcast` | New podcast added |
+| `new-video` | New video |
+| `new-video-channel` | New video channel |
+| `new-track` | New music track |
+| `new-album` | New music album |
+| `livestream-started` | Livestream is now live |
+| `livestream-scheduled` | Livestream scheduled |
+
+### Direct Web Push API
+
+For lower-level access:
+
+```typescript
+import { 
+  sendWebPushNotificationBatch,
+  WebPushSubscription 
+} from 'podverse-notifications';
+
+const subscriptions: WebPushSubscription[] = [
+  {
+    endpoint: 'https://...',
+    keys: { p256dh: '...', auth: '...' }
+  }
+];
+
+const results = await sendWebPushNotificationBatch(subscriptions, {
+  title: 'Notification Title',
+  body: 'Notification body text',
+  icon: 'https://example.com/icon.png',
+  link: '/episode/abc123'
+});
+```
+
+## Architecture
+
+```
+podverse-notifications/
+├── src/
+│   ├── config/
+│   │   └── index.ts              # Configuration and URL helpers
+│   ├── services/
+│   │   ├── notifications/
+│   │   │   ├── i18nNotifications.ts    # Localized message prefixes
+│   │   │   ├── notificationOrchestrator.ts  # Main orchestrator
+│   │   │   └── index.ts
+│   │   └── webpush/
+│   │       ├── webpushAdmin.ts         # web-push initialization
+│   │       ├── webpushHelpers.ts       # Types and utilities
+│   │       ├── webpushNotification.ts  # Send notifications
+│   │       ├── webpushNotificationOrchestrator.ts
+│   │       └── index.ts
+│   └── index.ts
+```
+
+## License
+
+AGPLv3

package/dist/config/index.d.ts

@@ -0,0 +1,17 @@
+export declare const config: {
+    web: {
+        protocol: string;
+        host: string;
+        icon_image_path: string;
+    };
+    webpush: {
+        enabled: boolean;
+        vapid_public_key: string;
+        vapid_private_key: string;
+        vapid_subject: string;
+    };
+};
+export declare function getWebBaseUrl(): string;
+export declare function getWebBaseUrlWithPath(path: string): string;
+export declare function getWebIconImageUrl(): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM;;;;;;;;;;;;CAYlB,CAAA;AAED,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI1D;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C"}

package/dist/config/index.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.config = void 0;
+exports.getWebBaseUrl = getWebBaseUrl;
+exports.getWebBaseUrlWithPath = getWebBaseUrlWithPath;
+exports.getWebIconImageUrl = getWebIconImageUrl;
+exports.config = {
+    web: {
+        protocol: process.env.WEB_PROTOCOL || "http",
+        host: process.env.WEB_DOMAIN || "localhost",
+        icon_image_path: process.env.WEB_ICON_IMAGE_PATH || ""
+    },
+    webpush: {
+        enabled: process.env.WEBPUSH_ENABLED === "true",
+        vapid_public_key: process.env.WEBPUSH_VAPID_PUBLIC_KEY || "",
+        vapid_private_key: process.env.WEBPUSH_VAPID_PRIVATE_KEY || "",
+        vapid_subject: process.env.WEBPUSH_VAPID_SUBJECT || "mailto:contact@podverse.fm"
+    }
+};
+function getWebBaseUrl() {
+    return `${exports.config.web.protocol}://${exports.config.web.host}`;
+}
+function getWebBaseUrlWithPath(path) {
+    const base = getWebBaseUrl();
+    const cleanPath = path.startsWith('/') ? path : `/${path}`;
+    return `${base}${cleanPath}`;
+}
+function getWebIconImageUrl() {
+    return `${getWebBaseUrl()}${exports.config.web.icon_image_path}`;
+}

package/dist/index.d.ts

@@ -1 +1,5 @@
+export * from './config';
+export * from './services/notifications';
+export * from './services/webpush';
+export * from './services/unifiedpush';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC"}

package/dist/index.js

@@ -1,2 +1,20 @@
 "use strict";
-console.log('Starting notification service...');
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./config"), exports);
+__exportStar(require("./services/notifications"), exports);
+__exportStar(require("./services/webpush"), exports);
+__exportStar(require("./services/unifiedpush"), exports);

package/dist/services/notifications/i18nNotifications.d.ts

@@ -0,0 +1,4 @@
+export type NotificationMessageType = 'new' | 'new-episode' | 'new-podcast' | 'new-video' | 'new-video-channel' | 'new-track' | 'new-album' | 'livestream-started' | 'livestream-scheduled';
+export type NotificationLocaleMap = Record<NotificationMessageType, string>;
+export declare const i18nNotifications: Record<string, NotificationLocaleMap>;
+//# sourceMappingURL=i18nNotifications.d.ts.map

package/dist/services/notifications/i18nNotifications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18nNotifications.d.ts","sourceRoot":"","sources":["../../../src/services/notifications/i18nNotifications.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,uBAAuB,GAAG,KAAK,GACvC,aAAa,GAAG,aAAa,GAC7B,WAAW,GAAG,mBAAmB,GACjC,WAAW,GAAG,WAAW,GACzB,oBAAoB,GAAG,sBAAsB,CAAC;AAElD,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,uBAAuB,EAAE,MAAM,CAAC,CAAC;AAE5E,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CA6CnE,CAAC"}

package/dist/services/notifications/i18nNotifications.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.i18nNotifications = void 0;
+exports.i18nNotifications = {
+    "en": {
+        "new": "",
+        "new-episode": "",
+        "new-podcast": "",
+        "new-video": "",
+        "new-video-channel": "",
+        "new-track": "",
+        "new-album": "",
+        "livestream-started": "Live: ",
+        "livestream-scheduled": "Live Scheduled: "
+    },
+    "es": {
+        "new": "",
+        "new-episode": "",
+        "new-podcast": "",
+        "new-video": "",
+        "new-video-channel": "",
+        "new-track": "",
+        "new-album": "",
+        "livestream-started": "En vivo: ",
+        "livestream-scheduled": "En vivo programado: "
+    },
+    "fr": {
+        "new": "",
+        "new-episode": "",
+        "new-podcast": "",
+        "new-video": "",
+        "new-video-channel": "",
+        "new-track": "",
+        "new-album": "",
+        "livestream-started": "En direct: ",
+        "livestream-scheduled": "En direct programmé: "
+    },
+    "el-GR": {
+        "new": "",
+        "new-episode": "",
+        "new-podcast": "",
+        "new-video": "",
+        "new-video-channel": "",
+        "new-track": "",
+        "new-album": "",
+        "livestream-started": "Ζωντανά: ",
+        "livestream-scheduled": "Προγραμματισμένα ζωντανά: "
+    }
+};

package/dist/services/notifications/index.d.ts

@@ -0,0 +1,3 @@
+export * from './i18nNotifications';
+export * from './notificationOrchestrator';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/notifications/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/notifications/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC"}

package/dist/services/notifications/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./i18nNotifications"), exports);
+__exportStar(require("./notificationOrchestrator"), exports);

package/dist/services/notifications/notificationOrchestrator.d.ts

@@ -0,0 +1,33 @@
+import { WebPushSubscription } from '../webpush';
+import { UPSubscription } from '../unifiedpush';
+import { NotificationMessageType } from './i18nNotifications';
+export type NotificationPlatform = 'web' | 'android' | 'ios';
+export type NotificationService = 'firebase' | 'webpush' | 'unifiedpush';
+type BaseNotificationOrchestratorParams = {
+    messageText: string;
+    messageType: NotificationMessageType;
+    locale: string;
+    icon?: string;
+    linkIdText?: string;
+    data?: Record<string, unknown>;
+};
+type FirebaseNotificationOrchestratorParams = BaseNotificationOrchestratorParams & {
+    service: 'firebase';
+    tokens: string[];
+    platform: NotificationPlatform;
+    channelId?: string;
+    badge?: number;
+    sound?: string;
+};
+type WebPushNotificationOrchestratorParams = BaseNotificationOrchestratorParams & {
+    service: 'webpush';
+    subscriptions: WebPushSubscription[];
+};
+type UnifiedPushNotificationOrchestratorParams = BaseNotificationOrchestratorParams & {
+    service: 'unifiedpush';
+    subscriptions: UPSubscription[];
+};
+export type NotificationOrchestratorParams = FirebaseNotificationOrchestratorParams | WebPushNotificationOrchestratorParams | UnifiedPushNotificationOrchestratorParams;
+export declare function notificationOrchestrator(params: NotificationOrchestratorParams): Promise<any[]>;
+export {};
+//# sourceMappingURL=notificationOrchestrator.d.ts.map

package/dist/services/notifications/notificationOrchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notificationOrchestrator.d.ts","sourceRoot":"","sources":["../../../src/services/notifications/notificationOrchestrator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAqB,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAEjF,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,SAAS,GAAG,KAAK,CAAC;AAC7D,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,SAAS,GAAG,aAAa,CAAC;AA6BzE,KAAK,kCAAkC,GAAG;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,uBAAuB,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AAGF,KAAK,sCAAsC,GAAG,kCAAkC,GAAG;IACjF,OAAO,EAAE,UAAU,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAGF,KAAK,qCAAqC,GAAG,kCAAkC,GAAG;IAChF,OAAO,EAAE,SAAS,CAAC;IACnB,aAAa,EAAE,mBAAmB,EAAE,CAAC;CACtC,CAAC;AAGF,KAAK,yCAAyC,GAAG,kCAAkC,GAAG;IACpF,OAAO,EAAE,aAAa,CAAC;IACvB,aAAa,EAAE,cAAc,EAAE,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,8BAA8B,GACtC,sCAAsC,GACtC,qCAAqC,GACrC,yCAAyC,CAAC;AAS9C,wBAAsB,wBAAwB,CAAC,MAAM,EAAE,8BAA8B,kBAoDpF"}

package/dist/services/notifications/notificationOrchestrator.js

@@ -0,0 +1,97 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.notificationOrchestrator = notificationOrchestrator;
+const podverse_external_services_1 = require("podverse-external-services");
+const webpush_1 = require("../webpush");
+const unifiedpush_1 = require("../unifiedpush");
+const i18nNotifications_1 = require("./i18nNotifications");
+/**
+ * Gets the URL path prefix for a given notification message type
+ */
+function getLinkPathFromMessageType(messageType) {
+    switch (messageType) {
+        case 'new-episode':
+            return '/episode';
+        case 'new-podcast':
+            return '/podcast';
+        case 'new-video':
+            return '/video';
+        case 'new-video-channel':
+            return '/channel';
+        case 'new-track':
+            return '/track';
+        case 'new-album':
+            return '/album';
+        case 'livestream-started':
+        case 'livestream-scheduled':
+            return '/livestream';
+        case 'new':
+        default:
+            return '';
+    }
+}
+function getFinalText(messageText, messageType, locale) {
+    const baseLocale = locale.includes('-') ? locale.split('-')[0] : locale;
+    const localeMap = i18nNotifications_1.i18nNotifications[locale] || i18nNotifications_1.i18nNotifications[baseLocale] || i18nNotifications_1.i18nNotifications.en;
+    const prefix = localeMap[messageType] || i18nNotifications_1.i18nNotifications.en[messageType];
+    return `${prefix}${messageText}`;
+}
+function notificationOrchestrator(params) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const { service, messageText, messageType, locale, linkIdText, icon, data } = params;
+        const finalText = getFinalText(messageText, messageType, locale);
+        // Construct the link from messageType and linkIdText
+        let link;
+        if (linkIdText) {
+            const pathPrefix = getLinkPathFromMessageType(messageType);
+            link = pathPrefix ? `${pathPrefix}/${linkIdText}` : undefined;
+        }
+        switch (service) {
+            case 'firebase': {
+                const firebaseParams = params;
+                return yield (0, podverse_external_services_1.firebaseNotificationBatchOrchestrator)({
+                    tokens: firebaseParams.tokens,
+                    platform: firebaseParams.platform,
+                    finalText,
+                    link,
+                    icon,
+                    channelId: firebaseParams.channelId,
+                    badge: firebaseParams.badge,
+                    sound: firebaseParams.sound,
+                    data,
+                });
+            }
+            case 'webpush': {
+                const webpushParams = params;
+                return yield (0, webpush_1.webpushNotificationBatchOrchestrator)({
+                    subscriptions: webpushParams.subscriptions,
+                    finalText,
+                    link,
+                    icon,
+                    data,
+                });
+            }
+            case 'unifiedpush': {
+                const upParams = params;
+                return yield (0, unifiedpush_1.unifiedpushNotificationBatchOrchestrator)({
+                    subscriptions: upParams.subscriptions,
+                    finalText,
+                    link,
+                    icon,
+                    data,
+                });
+            }
+            default:
+                throw new Error(`Unsupported notification service: ${service}`);
+        }
+    });
+}

package/dist/services/unifiedpush/index.d.ts

@@ -0,0 +1,4 @@
+export { UPSubscription } from './unifiedpushHelpers';
+export { sendUPNotificationBatch } from './unifiedpushNotification';
+export { unifiedpushNotificationBatchOrchestrator } from './unifiedpushNotificationOrchestrator';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/unifiedpush/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/unifiedpush/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,wCAAwC,EAAE,MAAM,uCAAuC,CAAC"}

package/dist/services/unifiedpush/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unifiedpushNotificationBatchOrchestrator = exports.sendUPNotificationBatch = void 0;
+var unifiedpushNotification_1 = require("./unifiedpushNotification");
+Object.defineProperty(exports, "sendUPNotificationBatch", { enumerable: true, get: function () { return unifiedpushNotification_1.sendUPNotificationBatch; } });
+var unifiedpushNotificationOrchestrator_1 = require("./unifiedpushNotificationOrchestrator");
+Object.defineProperty(exports, "unifiedpushNotificationBatchOrchestrator", { enumerable: true, get: function () { return unifiedpushNotificationOrchestrator_1.unifiedpushNotificationBatchOrchestrator; } });

package/dist/services/unifiedpush/unifiedpushHelpers.d.ts

@@ -0,0 +1,5 @@
+export type UPSubscription = {
+    up_endpoint: string;
+    up_auth_key: string | null;
+};
+//# sourceMappingURL=unifiedpushHelpers.d.ts.map

package/dist/services/unifiedpush/unifiedpushHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unifiedpushHelpers.d.ts","sourceRoot":"","sources":["../../../src/services/unifiedpush/unifiedpushHelpers.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC"}

package/dist/services/unifiedpush/unifiedpushHelpers.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/services/unifiedpush/unifiedpushNotification.d.ts

@@ -0,0 +1,25 @@
+import { UPSubscription } from './unifiedpushHelpers';
+type UPPayload = {
+    title: string;
+    body?: string;
+    icon?: string;
+    image?: string;
+    link?: string;
+    data?: Record<string, unknown>;
+};
+type UPResult = {
+    success: boolean;
+    endpoint: string;
+    error?: string;
+};
+/**
+ * Sends a notification to a Unified Push endpoint.
+ *
+ * Unified Push is a simple protocol - just POST the notification data to the endpoint.
+ * The endpoint is typically a service like ntfy.sh that the user has configured.
+ *
+ * @see https://unifiedpush.org/spec/android/
+ */
+export declare function sendUPNotificationBatch(subscriptions: UPSubscription[], payload: UPPayload): Promise<UPResult[]>;
+export {};
+//# sourceMappingURL=unifiedpushNotification.d.ts.map

package/dist/services/unifiedpush/unifiedpushNotification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unifiedpushNotification.d.ts","sourceRoot":"","sources":["../../../src/services/unifiedpush/unifiedpushNotification.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,KAAK,SAAS,GAAG;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AAEF,KAAK,QAAQ,GAAG;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAC3C,aAAa,EAAE,cAAc,EAAE,EAC/B,OAAO,EAAE,SAAS,GACjB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAyErB"}

package/dist/services/unifiedpush/unifiedpushNotification.js

@@ -0,0 +1,90 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sendUPNotificationBatch = sendUPNotificationBatch;
+const podverse_helpers_1 = require("podverse-helpers");
+const config_1 = require("../../config");
+/**
+ * Sends a notification to a Unified Push endpoint.
+ *
+ * Unified Push is a simple protocol - just POST the notification data to the endpoint.
+ * The endpoint is typically a service like ntfy.sh that the user has configured.
+ *
+ * @see https://unifiedpush.org/spec/android/
+ */
+function sendUPNotificationBatch(subscriptions, payload) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const chunks = (0, podverse_helpers_1.chunkArray)(subscriptions, 100);
+        const allResults = [];
+        for (const chunk of chunks) {
+            const chunkResults = yield Promise.allSettled(chunk.map((subscription) => __awaiter(this, void 0, void 0, function* () {
+                try {
+                    // Use ntfy header-based format for proper notification display
+                    // @see https://docs.ntfy.sh/publish/#publish-as-json
+                    const headers = {
+                        'Content-Type': 'text/plain',
+                        'X-Title': payload.title,
+                        'X-Click': payload.link ? (0, config_1.getWebBaseUrlWithPath)(payload.link) : (0, config_1.getWebBaseUrl)(),
+                        'X-Icon': payload.icon || (0, config_1.getWebIconImageUrl)(),
+                    };
+                    // Add image as attachment for preview
+                    if (payload.image) {
+                        headers['X-Attach'] = payload.image;
+                    }
+                    // Add authorization if auth key is provided
+                    if (subscription.up_auth_key) {
+                        headers['Authorization'] = `Bearer ${subscription.up_auth_key}`;
+                    }
+                    // Message body is sent as plain text
+                    const messageBody = payload.body || '';
+                    const response = yield fetch(subscription.up_endpoint, {
+                        method: 'POST',
+                        headers,
+                        body: messageBody,
+                    });
+                    if (!response.ok) {
+                        const errorText = yield response.text().catch(() => 'Unknown error');
+                        console.error(`UP send failed for ${subscription.up_endpoint}: ${response.status} - ${errorText}`);
+                        return {
+                            success: false,
+                            endpoint: subscription.up_endpoint,
+                            error: `HTTP ${response.status}: ${errorText}`
+                        };
+                    }
+                    return { success: true, endpoint: subscription.up_endpoint };
+                }
+                catch (error) {
+                    const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+                    console.error(`UP send failed for ${subscription.up_endpoint}:`, errorMessage);
+                    return {
+                        success: false,
+                        endpoint: subscription.up_endpoint,
+                        error: errorMessage
+                    };
+                }
+            })));
+            for (const result of chunkResults) {
+                if (result.status === 'fulfilled') {
+                    allResults.push(result.value);
+                }
+                else {
+                    allResults.push({
+                        success: false,
+                        endpoint: 'unknown',
+                        error: ((_a = result.reason) === null || _a === void 0 ? void 0 : _a.message) || 'Promise rejected'
+                    });
+                }
+            }
+        }
+        return allResults;
+    });
+}

package/dist/services/unifiedpush/unifiedpushNotificationOrchestrator.d.ts

@@ -0,0 +1,15 @@
+import { UPSubscription } from './unifiedpushHelpers';
+type UPOrchestratorParams = {
+    subscriptions: UPSubscription[];
+    finalText: string;
+    icon?: string;
+    link?: string;
+    data?: Record<string, unknown>;
+};
+export declare function unifiedpushNotificationBatchOrchestrator(params: UPOrchestratorParams): Promise<{
+    success: boolean;
+    endpoint: string;
+    error?: string;
+}[]>;
+export {};
+//# sourceMappingURL=unifiedpushNotificationOrchestrator.d.ts.map

package/dist/services/unifiedpush/unifiedpushNotificationOrchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unifiedpushNotificationOrchestrator.d.ts","sourceRoot":"","sources":["../../../src/services/unifiedpush/unifiedpushNotificationOrchestrator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,KAAK,oBAAoB,GAAG;IAC1B,aAAa,EAAE,cAAc,EAAE,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AAEF,wBAAsB,wCAAwC,CAAC,MAAM,EAAE,oBAAoB;;;;KAc1F"}

package/dist/services/unifiedpush/unifiedpushNotificationOrchestrator.js

@@ -0,0 +1,27 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unifiedpushNotificationBatchOrchestrator = unifiedpushNotificationBatchOrchestrator;
+const unifiedpushNotification_1 = require("./unifiedpushNotification");
+function unifiedpushNotificationBatchOrchestrator(params) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const { subscriptions, finalText, icon, link, data } = params;
+        const payload = {
+            title: finalText,
+            body: '',
+            icon,
+            link,
+            data,
+        };
+        console.log(`[unifiedpushNotificationBatchOrchestrator] Sending to ${subscriptions.length} subscriptions`);
+        return yield (0, unifiedpushNotification_1.sendUPNotificationBatch)(subscriptions, payload);
+    });
+}

package/dist/services/webpush/index.d.ts

@@ -0,0 +1,5 @@
+export { webpushAdmin, isWebPushEnabled } from './webpushAdmin';
+export { WebPushSubscription } from './webpushHelpers';
+export { sendWebPushNotificationBatch } from './webpushNotification';
+export { webpushNotificationBatchOrchestrator } from './webpushNotificationOrchestrator';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/webpush/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/webpush/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAE,oCAAoC,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/services/webpush/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.webpushNotificationBatchOrchestrator = exports.sendWebPushNotificationBatch = exports.isWebPushEnabled = exports.webpushAdmin = void 0;
+var webpushAdmin_1 = require("./webpushAdmin");
+Object.defineProperty(exports, "webpushAdmin", { enumerable: true, get: function () { return webpushAdmin_1.webpushAdmin; } });
+Object.defineProperty(exports, "isWebPushEnabled", { enumerable: true, get: function () { return webpushAdmin_1.isWebPushEnabled; } });
+var webpushNotification_1 = require("./webpushNotification");
+Object.defineProperty(exports, "sendWebPushNotificationBatch", { enumerable: true, get: function () { return webpushNotification_1.sendWebPushNotificationBatch; } });
+var webpushNotificationOrchestrator_1 = require("./webpushNotificationOrchestrator");
+Object.defineProperty(exports, "webpushNotificationBatchOrchestrator", { enumerable: true, get: function () { return webpushNotificationOrchestrator_1.webpushNotificationBatchOrchestrator; } });

package/dist/services/webpush/webpushAdmin.d.ts

@@ -0,0 +1,4 @@
+import webpush from 'web-push';
+export declare const webpushAdmin: typeof webpush | null;
+export declare const isWebPushEnabled: boolean;
+//# sourceMappingURL=webpushAdmin.d.ts.map

package/dist/services/webpush/webpushAdmin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webpushAdmin.d.ts","sourceRoot":"","sources":["../../../src/services/webpush/webpushAdmin.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,UAAU,CAAC;AAyB/B,eAAO,MAAM,YAAY,uBAAsC,CAAC;AAChE,eAAO,MAAM,gBAAgB,SAAqB,CAAC"}

package/dist/services/webpush/webpushAdmin.js

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isWebPushEnabled = exports.webpushAdmin = void 0;
+const web_push_1 = __importDefault(require("web-push"));
+const config_1 = require("../../config");
+let webpushInitialized = false;
+if (!config_1.config.webpush.enabled) {
+    console.warn("Web Push notifications are disabled in the configuration.");
+}
+else if (!config_1.config.webpush.vapid_public_key || !config_1.config.webpush.vapid_private_key) {
+    console.warn("Web Push VAPID keys are not configured.");
+}
+else {
+    console.log("Web Push notifications are enabled in the configuration.");
+    try {
+        web_push_1.default.setVapidDetails(config_1.config.webpush.vapid_subject, config_1.config.webpush.vapid_public_key, config_1.config.webpush.vapid_private_key);
+        webpushInitialized = true;
+        console.log("Web Push Admin Initialized Successfully");
+    }
+    catch (error) {
+        console.error("Web Push Admin Initialization Failed:", error);
+    }
+}
+exports.webpushAdmin = webpushInitialized ? web_push_1.default : null;
+exports.isWebPushEnabled = webpushInitialized;

package/dist/services/webpush/webpushHelpers.d.ts

@@ -0,0 +1,8 @@
+export type WebPushSubscription = {
+    endpoint: string;
+    keys: {
+        p256dh: string;
+        auth: string;
+    };
+};
+//# sourceMappingURL=webpushHelpers.d.ts.map

package/dist/services/webpush/webpushHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webpushHelpers.d.ts","sourceRoot":"","sources":["../../../src/services/webpush/webpushHelpers.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE;QACJ,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH,CAAC"}

package/dist/services/webpush/webpushHelpers.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/services/webpush/webpushNotification.d.ts

@@ -0,0 +1,17 @@
+import { WebPushSubscription } from './webpushHelpers';
+type WebPushPayload = {
+    title: string;
+    body?: string;
+    icon?: string;
+    image?: string;
+    link?: string;
+    data?: Record<string, unknown>;
+};
+type WebPushResult = {
+    success: boolean;
+    endpoint: string;
+    error?: string;
+};
+export declare function sendWebPushNotificationBatch(subscriptions: WebPushSubscription[], payload: WebPushPayload): Promise<WebPushResult[]>;
+export {};
+//# sourceMappingURL=webpushNotification.d.ts.map

package/dist/services/webpush/webpushNotification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webpushNotification.d.ts","sourceRoot":"","sources":["../../../src/services/webpush/webpushNotification.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAGvD,KAAK,cAAc,GAAG;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AAEF,KAAK,aAAa,GAAG;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAsB,4BAA4B,CAChD,aAAa,EAAE,mBAAmB,EAAE,EACpC,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,EAAE,CAAC,CA2D1B"}

package/dist/services/webpush/webpushNotification.js

@@ -0,0 +1,69 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sendWebPushNotificationBatch = sendWebPushNotificationBatch;
+const podverse_helpers_1 = require("podverse-helpers");
+const webpushAdmin_1 = require("./webpushAdmin");
+const config_1 = require("../../config");
+function sendWebPushNotificationBatch(subscriptions, payload) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        if (!webpushAdmin_1.webpushAdmin) {
+            throw new Error("Web Push Admin is not initialized");
+        }
+        const webpush = webpushAdmin_1.webpushAdmin;
+        const chunks = (0, podverse_helpers_1.chunkArray)(subscriptions, 100);
+        const allResults = [];
+        for (const chunk of chunks) {
+            const notificationPayload = JSON.stringify({
+                title: payload.title,
+                body: payload.body || "",
+                icon: payload.icon || (0, config_1.getWebIconImageUrl)(),
+                image: payload.image,
+                link: payload.link ? (0, config_1.getWebBaseUrlWithPath)(payload.link) : (0, config_1.getWebBaseUrl)(),
+                data: payload.data,
+            });
+            const chunkResults = yield Promise.allSettled(chunk.map((subscription) => __awaiter(this, void 0, void 0, function* () {
+                try {
+                    yield webpush.sendNotification({
+                        endpoint: subscription.endpoint,
+                        keys: subscription.keys,
+                    }, notificationPayload, {
+                        TTL: 86400, // 24 hours
+                        urgency: 'normal',
+                    });
+                    return { success: true, endpoint: subscription.endpoint };
+                }
+                catch (error) {
+                    console.error(`Web Push send failed for ${subscription.endpoint}:`, error.message);
+                    return {
+                        success: false,
+                        endpoint: subscription.endpoint,
+                        error: error.message || 'Unknown error'
+                    };
+                }
+            })));
+            for (const result of chunkResults) {
+                if (result.status === 'fulfilled') {
+                    allResults.push(result.value);
+                }
+                else {
+                    allResults.push({
+                        success: false,
+                        endpoint: 'unknown',
+                        error: ((_a = result.reason) === null || _a === void 0 ? void 0 : _a.message) || 'Promise rejected'
+                    });
+                }
+            }
+        }
+        return allResults;
+    });
+}

package/dist/services/webpush/webpushNotificationOrchestrator.d.ts

@@ -0,0 +1,15 @@
+import { WebPushSubscription } from './webpushHelpers';
+type WebPushOrchestratorParams = {
+    subscriptions: WebPushSubscription[];
+    finalText: string;
+    icon?: string;
+    link?: string;
+    data?: Record<string, unknown>;
+};
+export declare function webpushNotificationBatchOrchestrator(params: WebPushOrchestratorParams): Promise<{
+    success: boolean;
+    endpoint: string;
+    error?: string;
+}[]>;
+export {};
+//# sourceMappingURL=webpushNotificationOrchestrator.d.ts.map

package/dist/services/webpush/webpushNotificationOrchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webpushNotificationOrchestrator.d.ts","sourceRoot":"","sources":["../../../src/services/webpush/webpushNotificationOrchestrator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,KAAK,yBAAyB,GAAG;IAC/B,aAAa,EAAE,mBAAmB,EAAE,CAAC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AAEF,wBAAsB,oCAAoC,CAAC,MAAM,EAAE,yBAAyB;;;;KAc3F"}

package/dist/services/webpush/webpushNotificationOrchestrator.js

@@ -0,0 +1,27 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.webpushNotificationBatchOrchestrator = webpushNotificationBatchOrchestrator;
+const webpushNotification_1 = require("./webpushNotification");
+function webpushNotificationBatchOrchestrator(params) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const { subscriptions, finalText, icon, link, data } = params;
+        const payload = {
+            title: finalText,
+            body: '',
+            icon,
+            link,
+            data,
+        };
+        console.log(`[webpushNotificationBatchOrchestrator] Sending to ${subscriptions.length} subscriptions`);
+        return yield (0, webpushNotification_1.sendWebPushNotificationBatch)(subscriptions, payload);
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "podverse-notifications",
-  "version": "1.0.0",
+  "version": "5.1.19-alpha.0",
   "description": "Push notification helper module for Podverse use cases",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -17,14 +17,16 @@
   "license": "AGPLv3",
   "dependencies": {
     "module-alias": "^2.2.3",
-    "podverse-external-services": "^5.1.12",
-    "podverse-helpers": "^5.1.12"
+    "podverse-external-services": "^5.1.19-alpha.0",
+    "podverse-helpers": "^5.1.19-alpha.0",
+    "web-push": "^3.6.7"
   },
   "devDependencies": {
     "@eslint/config-array": "^0.21.0",
     "@eslint/eslintrc": "^3.3.1",
     "@eslint/js": "^9.35.0",
     "@types/node": "^24.4.0",
+    "@types/web-push": "^3.6.4",
     "eslint": "^9.35.0",
     "nodemon": "^3.1.10",
     "ts-node": "^10.9.2",