@techextensor/tab-sdk 0.0.58 → 0.0.59

package/lib/notification/notification.service.d.ts

@@ -0,0 +1,82 @@
+import { NotificationConnectParams, UiNotification } from '@techextensor/tab-core-utility';
+import { Observable } from 'rxjs';
+import * as i0 from "@angular/core";
+/**
+ * SDK facade over the core notification inbox service.
+ *
+ * The app passes the auth identifiers at connect time — the core services don't
+ * read them from storage. This facade is the single place that knows how to
+ * compose the BE's `workspaceKey` from the four IDs.
+ *
+ * Exposes only the surface that app/extension code needs:
+ *  - lifecycle (connect / disconnect)
+ *  - inbox actions (loadMore, markAsRead, markAllAsRead, clearOne, clearAll)
+ *  - state streams for UI (latestNotifications$, unreadCount$, etc.)
+ *
+ * @example
+ * ```ts
+ * // In a route resolver
+ * await TabSdk.notification.connect({
+ *   userId: TabSdk.store.userId,
+ *   appId: TabSdk.store.appId,
+ *   tenantId: TabSdk.store.tenantId,
+ *   environmentId: TabSdk.store.environmentId,
+ * });
+ *
+ * // In header for the badge
+ * TabSdk.notification.unreadCount$.subscribe(count => this.badge = count);
+ *
+ * // In notification list
+ * TabSdk.notification.loadMore(1);
+ * TabSdk.notification.markAsRead(id);
+ *
+ * // In auth signOut
+ * await TabSdk.notification.disconnect();
+ * ```
+ */
+export declare class NotificationSdkService {
+    private readonly inbox;
+    /**
+     * Connect to the notification WebSocket. Awaitable, idempotent.
+     *
+     * The app supplies the auth identifiers — the core services stay pure
+     * (no storage / auth coupling). This facade composes the BE's workspaceKey
+     * from the four IDs and passes everything down.
+     */
+    connect(params: NotificationConnectParams): Promise<void>;
+    /**
+     * Tear down the connection (call from auth signOut / cross-tab logout).
+     */
+    disconnect(): Promise<void>;
+    /** Fetch a page of notifications from the inbox. */
+    loadMore(pageNumber: number, pageSize?: number): void;
+    /** Re-request unread count (header badge auto-refreshes via the stream). */
+    requestUnreadCount(): void;
+    /** Mark a single notification as read. */
+    markAsRead(notificationId: string): void;
+    /** Mark all notifications as read. */
+    markAllAsRead(): void;
+    /** Clear a single notification from the inbox. */
+    clearOne(notificationId: string): void;
+    /** Clear all notifications from the inbox. */
+    clearAll(): void;
+    /**
+     * Emits notifications as they arrive.
+     * - Inbox page fetch → emits an array.
+     * - Live push → emits a single notification (component should prepend it).
+     * Component logic should branch on Array.isArray(value).
+     */
+    readonly latestNotifications$: Observable<UiNotification | UiNotification[]>;
+    /** Current unread count. Header subscribes for the badge. */
+    readonly unreadCount$: Observable<number>;
+    /** Emits notificationId when a notification is marked read; null when all are. */
+    readonly markAsReadEvents$: Observable<string | null>;
+    /** Emits cleared notification IDs; null when all are cleared. */
+    readonly clearEvents$: Observable<string[] | null>;
+    /** Loading state — true while a page fetch is in flight. */
+    readonly loading$: Observable<boolean>;
+    /** Total pages (page-based pagination per BE). */
+    readonly totalPages$: Observable<number>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NotificationSdkService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<NotificationSdkService>;
+}

package/lib/signalr/signalr.service.d.ts

@@ -0,0 +1,63 @@
+import { NotificationCallback } from '@techextensor/tab-core-utility';
+import * as i0 from "@angular/core";
+/**
+ * SDK facade over the core SignalR service.
+ *
+ * Exposes only the surface that app/extension code needs:
+ *  - lifecycle (connect / disconnect)
+ *  - per-component subscription (register / unregister) for live CRUD push
+ *
+ * Async correlation-id tracking (`waitForOperation`) is intentionally NOT exposed —
+ * that's an internal concern of the core CRUD services in tab-core-utility.
+ *
+ * @example
+ * ```ts
+ * // In a route resolver (route waits until the first connection attempt settles)
+ * await TabSdk.signalR.connect();
+ *
+ * // In a component
+ * ngOnInit() {
+ *   TabSdk.signalR.register(this.componentId, this.appObjectId, n => this.handle(n));
+ * }
+ * ngOnDestroy() {
+ *   TabSdk.signalR.unregister(this.componentId, this.appObjectId);
+ * }
+ *
+ * // In auth signOut
+ * await TabSdk.signalR.disconnect();
+ * ```
+ */
+export declare class SignalRSdkService {
+    private readonly signalR;
+    /**
+     * Establish a connection to the SignalR hub.
+     *
+     * Awaitable — resolves when the first connection attempt settles (success or
+     * failure). Idempotent: repeated calls are de-duplicated; if already
+     * CONNECTED, resolves immediately. Any stale (non-Connected) connection is
+     * torn down before rebuild.
+     *
+     * Use in route resolvers to gate navigation until the hub is ready.
+     */
+    connect(): Promise<void>;
+    /**
+     * Tear down the connection (call from auth signOut / cross-tab logout).
+     *
+     * Stops the hub, clears component registrations, and errors any in-flight
+     * waitForOperation observers so CRUD UIs resolve immediately instead of
+     * stranding until the 120s timeout.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Subscribe a component to real-time CRUD notifications for an AppObject.
+     * Refcounted — the first registrant for an `appObjectId` joins the hub group;
+     * the last `unregister` leaves it.
+     */
+    register(componentId: string, appObjectId: string, callback: NotificationCallback): void;
+    /**
+     * Unsubscribe a component (call from `ngOnDestroy`).
+     */
+    unregister(componentId: string, appObjectId: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SignalRSdkService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SignalRSdkService>;
+}

package/lib/tab-sdk.service.d.ts

@@ -15,6 +15,8 @@ import { HttpService } from './http/http.service';
 import { StoreService } from './store/store.service';
 import { StateSdkService } from './state/state.service';
 import { WorkflowService } from './workflow/workflow.service';
+import { SignalRSdkService } from './signalr/signalr.service';
+import { NotificationSdkService } from './notification/notification.service';
 import * as i0 from "@angular/core";
 export declare class TabSdk {
     static app: AppService;
@@ -34,6 +36,8 @@ export declare class TabSdk {
     static workflow: WorkflowService;
     static util: any;
     static state: StateSdkService;
+    static signalR: SignalRSdkService;
+    static notification: NotificationSdkService;
     /**
      * Initialize the SDK with necessary services
      */

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@techextensor/tab-sdk",
-  "version": "0.0.58",
+  "version": "0.0.59",
   "peerDependencies": {
     "@angular/common": "^19.2.15",
     "@angular/core": "^19.2.15",
-    "@techextensor/tab-core-utility": "2.2.199"
+    "@techextensor/tab-core-utility": "2.2.200"
   },
   "dependencies": {
     "tslib": "^2.8.1"