feat: add redirection for notifications + API integrations

__mocks__/@capacitor/app.ts

@@ -0,0 +1,33 @@
+
+/* eslint-disable */
+export interface AppState {
+  isActive: boolean;
+}
+
+// Minimal shape of AppInfo used by the app.
+export interface AppInfo {
+  version: string;
+}
+
+// Use a loose event shape so this mock is compatible with both
+// 'appStateChange' (which has isActive) and 'appUrlOpen' (which has url),
+// avoiding type errors in application code during tests.
+export type AppListener = (event: { [key: string]: any }) => void | Promise<void>;
+
+export const App = {
+  addListener(_eventName: string, _listener: AppListener): Promise<{ remove: () => void }> {
+    // In tests we don't actually hook into any real app lifecycle,
+    // so just return a no-op remover.
+    return Promise.resolve({ remove: () => {} });
+  },
+
+  // Simple stub for App.getInfo used by DeviceService.
+  getInfo(): Promise<AppInfo> {
+    return Promise.resolve({ version: '1.2.3' });
+  },
+
+  exitApp(): Promise<void> {
+    return Promise.resolve();
+  },
+};
+

__mocks__/@capacitor/push-notifications.ts

@@ -0,0 +1,38 @@
+/* eslint-disable */
+export interface PermissionStatus {
+  receive: string;
+}
+
+export interface Token {
+  value?: string;
+}
+
+export interface PushNotificationEvent {
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  [key: string]: any;
+}
+
+export type PushNotificationListener = (event: PushNotificationEvent) => void;
+
+export const PushNotifications = {
+  requestPermissions(): Promise<PermissionStatus> {
+    return Promise.resolve({ receive: 'denied' });
+  },
+
+  checkPermissions(): Promise<PermissionStatus> {
+    return Promise.resolve({ receive: 'denied' });
+  },
+
+  register(): Promise<void> {
+    return Promise.resolve();
+  },
+
+  unregister(): Promise<void> {
+    return Promise.resolve();
+  },
+
+  addListener(_eventName: string, _listener: any): Promise<{ remove: () => void }> {
+    return Promise.resolve({ remove: () => {} });
+  },
+};
+

src/app/app.component.spec.ts

@@ -21,6 +21,7 @@ import { NavController } from '@ionic/angular/standalone';
 import { UserEventService } from './core/services/user-event.service';
 import { DeviceService } from './core/services/device.service';
 import { GmapsService } from './core/services/gmaps.service';
+import { PushNotificationService } from './core/services/push-notification.service';
 
 import { SplashScreen } from '@capacitor/splash-screen';
 import { StatusBar } from '@capacitor/status-bar';
@@ -73,6 +74,7 @@ describe('AppComponent', () => {
   let gmapsService: jasmine.SpyObj<GmapsService>;
   let menuController: jasmine.SpyObj<MenuController>;
   let backButtonService: jasmine.SpyObj<BackButtonService>;
+  let pushNotificationService: jasmine.SpyObj<PushNotificationService>;
   beforeEach(waitForAsync(() => {
     // Mock Capacitor plugins before component creation
     // Create spies that return resolved promises
@@ -155,6 +157,7 @@ describe('AppComponent', () => {
     const gmapsServiceSpy = jasmine.createSpyObj('GmapsService', ['loadLibrary']);
     const menuControllerSpy = jasmine.createSpyObj('MenuController', ['swipeGesture']);
     const backButtonServiceSpy = jasmine.createSpyObj('BackButtonService', ['showAppCloseAlert']);
+    const pushNotificationServiceSpy = jasmine.createSpyObj('PushNotificationService', ['unregister']);
 
     // Configure tracking service with missing methods
     trackingServiceSpy.updateIdentityIfNotPresent = jasmine.createSpy('updateIdentityIfNotPresent').and.resolveTo();
@@ -190,6 +193,7 @@ describe('AppComponent', () => {
         { provide: GmapsService, useValue: gmapsServiceSpy },
         { provide: MenuController, useValue: menuControllerSpy },
         { provide: BackButtonService, useValue: backButtonServiceSpy },
+        { provide: PushNotificationService, useValue: pushNotificationServiceSpy },
       ],
     })
       .overrideComponent(AppComponent, {
@@ -220,6 +224,7 @@ describe('AppComponent', () => {
     gmapsService = TestBed.inject(GmapsService) as jasmine.SpyObj<GmapsService>;
     menuController = TestBed.inject(MenuController) as jasmine.SpyObj<MenuController>;
     backButtonService = TestBed.inject(BackButtonService) as jasmine.SpyObj<BackButtonService>;
+    pushNotificationService = TestBed.inject(PushNotificationService) as jasmine.SpyObj<PushNotificationService>;
   }));
 
   describe('ngAfterViewInit', () => {

src/app/app.component.ts

@@ -32,6 +32,7 @@ import { NgClass } from '@angular/common';
 import { FyConnectionComponent } from './shared/components/fy-connection/fy-connection.component';
 import { Capacitor } from '@capacitor/core';
 import { AppShortcuts } from '@capawesome/capacitor-app-shortcuts';
+import { PushNotificationService } from './core/services/push-notification.service';
 
 @Component({
   selector: 'app-root',
@@ -53,6 +54,8 @@ export class AppComponent implements OnInit, AfterViewInit {
 
   private router = inject(Router);
 
+  private pushNotificationService = inject(PushNotificationService);
+
   private activatedRoute = inject(ActivatedRoute);
 
   private userEventService = inject(UserEventService);
@@ -164,6 +167,12 @@ export class AppComponent implements OnInit, AfterViewInit {
       });
     });
 
+    // Initialize push notification click listener early to catch notifications
+    // that launched the app from a killed state
+    if (Capacitor.isNativePlatform()) {
+      this.pushNotificationService.initializeNotificationClickListener();
+    }
+
     // Handle app shortcuts (Home Screen Quick Actions)
     if (Capacitor.isNativePlatform()) {
       AppShortcuts.addListener('click', (event) => {
@@ -242,7 +251,6 @@ export class AppComponent implements OnInit, AfterViewInit {
     this.footerService.selectionMode$.subscribe((isEnabled) => {
       this.showFooter = !isEnabled;
     });
-
     // This was done as a security fix for appknox
     // eslint-disable-next-line
     if ((window as any) && (window as any).localStorage) {
@@ -293,6 +301,7 @@ export class AppComponent implements OnInit, AfterViewInit {
     this.userEventService.onLogout(() => {
       this.trackingService.onSignOut();
       this.freshChatService.destroy();
+      this.pushNotificationService.unregister();
       this.isSwitchedToDelegator = false;
       this.router.navigate(['/', 'auth', 'sign_in']);
     });

src/app/core/mock-data/org-settings.data.ts

@@ -415,6 +415,11 @@ export const orgSettingsRes: OrgSettings = deepFreeze({
     enabled: true,
     virtual_card_settings_enabled: true,
   },
+  mobile_notification_settings: {
+    allowed: true,
+    enabled: true,
+    unsubscribed_events: [],
+  },
   regional_settings: {
     allowed: true,
     enabled: true,

src/app/core/models/mobile-push-notification-settings.model.ts

@@ -0,0 +1,5 @@
+export interface MobilePushNotificationSettings {
+  enabled: boolean;
+  allowed: boolean;
+  unsubscribed_events: string[];
+}

src/app/core/models/org-settings.model.ts

@@ -9,6 +9,7 @@ import { TaxGroup } from './tax-group.model';
 import { TransactionMandatoryFields } from './transaction-mandatory-fields.model';
 import { User } from './user.model';
 import { OrgUserMandatoryFields } from './org-user-mandatory-fields.model';
+import { MobilePushNotificationSettings } from './mobile-push-notification-settings.model';
 
 export enum EmailEvents {
   DELEGATOR_SUBSCRIPTION = 'DELEGATOR_SUBSCRIPTION',
@@ -479,6 +480,7 @@ export interface OrgSettingsResponse {
   regional_settings?: RegionalSettings;
   auto_report_approval_settings?: AutoReportApprovalSettings;
   auto_report_submission_settings?: AutoReportSubmissionSettings;
+  mobile_notification_settings?: MobilePushNotificationSettings;
 }
 
 export interface UiPolicySettings {
@@ -606,4 +608,5 @@ export interface OrgSettings {
   regional_settings?: RegionalSettings;
   auto_report_approval_settings?: AutoReportApprovalSettings;
   auto_report_submission_settings?: AutoReportSubmissionSettings;
+  mobile_notification_settings?: MobilePushNotificationSettings;
 }

src/app/core/services/org-user.service.spec.ts

@@ -185,6 +185,24 @@ describe('OrgUserService', () => {
     });
   });
 
+  it('sendDeviceToken(): should fetch existing tokens and append new token when sending to backend', (done) => {
+    const token = 'test-device-token';
+    const existingTokens: string[] = ['existing-token-1'];
+    const expectedTokens = [...existingTokens, token];
+
+    spenderPlatformV1ApiService.get.and.returnValue(of({ data: { tokens: existingTokens } } as any));
+    spenderPlatformV1ApiService.post.and.returnValue(of({}));
+
+    orgUserService.sendDeviceToken(token).subscribe((res) => {
+      expect(spenderPlatformV1ApiService.get).toHaveBeenCalledWith('/device_token');
+      expect(spenderPlatformV1ApiService.post).toHaveBeenCalledWith('/device_token', {
+        data: { tokens: expectedTokens },
+      });
+      expect(res).toEqual({});
+      done();
+    });
+  });
+
   it('should return false if the user is not switched to a delegator', (done) => {
     jwtHelperService.decodeToken.and.returnValue(accessTokenData);
     // This token contains the user details such as user id, org id, org user id, roles, scopes, etc.

src/app/core/services/org-user.service.ts

@@ -101,6 +101,34 @@ export class OrgUserService {
     );
   }
 
+  getDeviceTokens(): Observable<string[]> {
+    return this.spenderPlatformV1ApiService
+      .get<PlatformApiResponse<{ tokens: string[] }>>('/device_token')
+      .pipe(map((response) => response.data?.tokens ?? []));
+  }
+
+  sendDeviceToken(token: string): Observable<unknown> {
+    const payload = {
+      data: {
+        tokens: [token],
+      },
+    };
+
+    return this.spenderPlatformV1ApiService.post('/device_token', payload);
+    // return this.getDeviceTokens().pipe(
+    //   map((existingTokens) => {
+    //     const tokens = existingTokens ?? [];
+    //     tokens.push(token);
+    //     return tokens;
+    //   }),
+    //   switchMap((tokens) =>
+    //     this.spenderPlatformV1ApiService.post('/device_token', {
+    //       data: { tokens },
+    //     }),
+    //   ),
+    // );
+  }
+
   getUserById(userId: string): Observable<EouApiResponse> {
     return this.apiService.get('/eous/' + userId);
   }

src/app/core/services/platform/v1/spender/org-settings.service.ts

@@ -421,6 +421,11 @@ export class PlatformOrgSettingsService {
       auto_report_submission_settings: {
         expense_grouping_dimensions: incoming.auto_report_submission_settings?.expense_grouping_dimensions || [],
       },
+      mobile_notification_settings: {
+        allowed: incoming.mobile_notification_settings && incoming.mobile_notification_settings.allowed,
+        enabled: incoming.mobile_notification_settings && incoming.mobile_notification_settings.enabled,
+        unsubscribed_events: incoming.mobile_notification_settings && incoming.mobile_notification_settings.unsubscribed_events,
+      },
     };
 
     Object.keys(orgSettings).forEach((settingsType) => {