@zambon-dev/shared 1.0.2 → 1.1.0

package/lib/models/notification.d.ts

@@ -0,0 +1,12 @@
+export interface INotification {
+    /** Short heading for the notification. */
+    title: string;
+    /** Longer descriptive text. */
+    description: string;
+    /** Icon class shown next to the notification (e.g. a Font Awesome class like `fa-solid fa-envelope`). */
+    icon: string;
+    /** Optional call-to-action URL. When present, clicking the notification navigates to it. */
+    callToActionUrl?: string;
+    /** Whether the notification has been read. */
+    isRead: boolean;
+}

package/lib/services/index.d.ts

@@ -1,3 +1,4 @@
 export { AuthenticationService } from './authentication.service';
+export { NotificationsService } from './notifications.service';
 export { OperationsHistoryService } from './operations-history.service';
 export { ServicesHistoryService } from './services-history.service';

package/lib/services/notifications.service.d.ts

@@ -0,0 +1,33 @@
+import { Observable } from 'rxjs';
+import { INotification } from '../models';
+import * as i0 from "@angular/core";
+/**
+ * Streams top-bar notifications from a SignalR hub.
+ *
+ * The hub is configured via `AppConfig.notificationsEnabled` and `AppConfig.notificationsUrl`.
+ * When enabled, {@link start} opens a connection (authenticated with the current JWT) and
+ * listens for the server to push the notification list via the `ReceiveNotifications` client
+ * method. Consuming apps do not interact with this service directly — the top bar drives it.
+ */
+export declare class NotificationsService {
+    private authService;
+    private config;
+    private connection?;
+    private notifications$;
+    /** Whether the notifications feature is enabled (toggled on and given a hub URL). */
+    get isEnabled(): boolean;
+    /** Emits the current list of notifications. */
+    getNotifications(): Observable<INotification[]>;
+    /** Emits the number of unread notifications. */
+    getUnreadCount(): Observable<number>;
+    /** Marks every notification as read and notifies the hub. */
+    markAllAsRead(): void;
+    /** Marks a single notification as read (optimistically; the server reconciles on the next push). */
+    markAsRead(notification: INotification): void;
+    /** Opens the SignalR connection and starts receiving notifications. Idempotent and a no-op when disabled. */
+    start(): void;
+    /** Closes the SignalR connection. */
+    stop(): Promise<void>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NotificationsService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<NotificationsService>;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zambon-dev/shared",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "description": "Shared Angular services, utilities, and styles for Zambon applications.",
   "keywords": [
     "angular",
@@ -27,6 +27,7 @@
     "@angular/forms": "^19.1.0",
     "@angular/router": "^19.1.0",
     "@auth0/angular-jwt": "^5.2.0",
+    "@microsoft/signalr": "^10.0.0",
     "@zambon-dev/framework": "^1.0.0",
     "@zambon-dev/library": "^1.0.0",
     "@ngx-translate/core": "^16.0.4",