firebase-ios-sdk/FirebaseMessaging/Tests/UnitTests/FIRMessagingAuthServiceTest.m

/*
 * Copyright 2021 Google LLC
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

#import <OCMock/OCMock.h>
#import <XCTest/XCTest.h>
#import "FirebaseMessaging/Sources/NSError+FIRMessaging.h"
#import "FirebaseMessaging/Sources/Token/FIRMessagingAuthService.h"
#import "FirebaseMessaging/Sources/Token/FIRMessagingCheckinPreferences.h"
#import "FirebaseMessaging/Sources/Token/FIRMessagingCheckinService.h"
#import "FirebaseMessaging/Sources/Token/FIRMessagingCheckinStore.h"

static NSString *const kDeviceAuthId = @"device-id";
static NSString *const kSecretToken = @"secret-token";
static NSString *const kVersionInfo = @"1.0";

@interface FIRMessagingCheckinService (ExposedForTest)
@property(nonatomic, readwrite, strong) FIRMessagingCheckinPreferences *checkinPreferences;
@end

@interface FIRMessagingAuthService (ExposedForTest)
@property(atomic, readwrite, assign) int64_t lastCheckinTimestampSeconds;
@property(atomic, readwrite, assign) int64_t nextScheduledCheckinIntervalSeconds;
@property(atomic, readwrite, assign) int checkinRetryCount;
@property(nonatomic, readonly, strong)
    NSMutableArray<FIRMessagingDeviceCheckinCompletion> *checkinHandlers;
@property(nonatomic, readwrite, strong) FIRMessagingCheckinService *checkinService;
@end

@interface FIRMessagingAuthServiceTest : XCTestCase

@property(nonatomic, readwrite, strong) FIRMessagingAuthService *authService;
@property(nonatomic, readwrite, strong) FIRMessagingCheckinService *checkinService;
@property(nonatomic, readwrite, strong) id mockCheckinService;
@property(nonatomic, readwrite, strong) id mockStore;
@property(nonatomic, readwrite, copy) FIRMessagingDeviceCheckinCompletion checkinCompletion;

@end

@implementation FIRMessagingAuthServiceTest

- (void)setUp {
  [super setUp];
  _mockStore = OCMClassMock([FIRMessagingCheckinStore class]);
  _authService = [[FIRMessagingAuthService alloc] initWithCheckinStore:_mockStore];
  _mockCheckinService = OCMPartialMock(_authService.checkinService);
  // The tests here are to focus on checkin interval not locale change, so always set locale as
  // non-changed.
  [[NSUserDefaults standardUserDefaults] setObject:FIRMessagingCurrentLocale()
                                            forKey:kFIRMessagingInstanceIDUserDefaultsKeyLocale];
}

- (void)tearDown {
  [_mockStore stopMocking];
  [_mockCheckinService stopMocking];
  _checkinCompletion = nil;
  [super tearDown];
}

/**
 *  Test scheduling a checkin which completes successfully. Once the checkin is complete
 *  we should have the valid checkin preferences in memory.
 */
- (void)testScheduleCheckin_initialSuccess {
  XCTestExpectation *checkinExpectation =
      [self expectationWithDescription:@"Did call checkin service"];
  FIRMessagingCheckinPreferences *checkinPreferences = [self validCheckinPreferences];

  OCMStub([self.mockCheckinService
              checkinWithExistingCheckin:self.checkinService.checkinPreferences
                              completion:([OCMArg checkWithBlock:^BOOL(id obj) {
                                [checkinExpectation fulfill];
                                self.checkinCompletion = obj;
                                return obj != nil;
                              }])])
      .andDo(^(NSInvocation *invocation) {
        self.checkinCompletion(checkinPreferences, nil);
      });
  // Always return YES for whether we succeeded in persisting the checkin
  OCMStub([self.mockStore
      saveCheckinPreferences:checkinPreferences
                     handler:([OCMArg invokeBlockWithArgs:[NSNull null], nil])]);
  [self.authService scheduleCheckin:YES];

  XCTAssertTrue([self.authService hasValidCheckinInfo]);
  XCTAssertEqual([self.authService checkinRetryCount], 1);
  [self waitForExpectationsWithTimeout:2.0 handler:NULL];
}

/**
 *  Test scheduling a checkin which completes successfully, but fails to save, due to Keychain
 *  errors.
 */
- (void)testScheduleCheckin_successButFailureInSaving {
  XCTestExpectation *checkinFailureExpectation =
      [self expectationWithDescription:@"Did receive error after checkin"];

  FIRMessagingCheckinPreferences *checkinPreferences = [self validCheckinPreferences];
  OCMStub([self.mockCheckinService checkinWithExistingCheckin:self.checkinService.checkinPreferences
                                                   completion:[OCMArg checkWithBlock:^BOOL(id obj) {
                                                     [checkinFailureExpectation fulfill];
                                                     self.checkinCompletion = obj;
                                                     return obj != nil;
                                                   }]]);

  // Always return NO for whether we succeeded in persisting the checkin, to simulate Keychain error
  OCMStub([self.mockStore saveCheckinPreferences:checkinPreferences
                                         handler:([OCMArg invokeBlockWithArgs:[OCMArg any], nil])]);

  [self.authService
      fetchCheckinInfoWithHandler:^(FIRMessagingCheckinPreferences *checkin, NSError *error) {
        [checkinFailureExpectation fulfill];
      }];

  [self waitForExpectationsWithTimeout:2.0 handler:NULL];
  XCTAssertFalse([self.authService hasValidCheckinInfo]);
}

/**
 *  Test scheduling multiple checkins to complete immediately. Each successive checkin should
 *  be triggered immediately.
 */
- (void)testMultipleScheduleCheckin_immediately {
  XCTestExpectation *checkinExpectation =
      [self expectationWithDescription:@"Did call checkin service"];
  __block int checkinHandlerInvocationCount = 0;

  FIRMessagingCheckinPreferences *checkinPreferences = [self validCheckinPreferences];
  OCMStub([self.mockCheckinService checkinWithExistingCheckin:self.checkinService.checkinPreferences
                                                   completion:[OCMArg checkWithBlock:^BOOL(id obj) {
                                                     self.checkinCompletion = obj;
                                                     return obj != nil;
                                                   }]])
      .andDo(^(NSInvocation *invocation) {
        checkinHandlerInvocationCount++;
        // Mock successful Checkin after delay.
        dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(0.5 * NSEC_PER_SEC)),
                       dispatch_get_main_queue(), ^{
                         [checkinExpectation fulfill];
                         self.checkinCompletion(checkinPreferences, nil);
                       });
      });

  // Always return YES for whether we succeeded in persisting the checkin
  OCMStub([self.mockStore
      saveCheckinPreferences:checkinPreferences
                     handler:([OCMArg invokeBlockWithArgs:[NSNull null], nil])]);
  [self.authService scheduleCheckin:YES];

  // Schedule an immediate checkin again.
  // This should just return because the previous checkin isn't over yet.
  [self.authService scheduleCheckin:YES];

  [self waitForExpectationsWithTimeout:5.0 handler:NULL];
  XCTAssertTrue([self.authService hasValidCheckinInfo]);
  XCTAssertEqual([self.authService checkinRetryCount], 2);

  // Checkin handler should only be invoked once since the second checkin request should
  // return immediately.
  XCTAssertEqual(checkinHandlerInvocationCount, 1);
}

/**
 *  Test multiple checkins scheduled. The second checkin should be scheduled after some
 *  delay before the first checkin has returned. Since the latter checkin is not immediate
 *  we should not run it since the first checkin is already scheduled to be executed later.
 */
- (void)testMultipleScheduleCheckin_notImmediately {
  XCTestExpectation *checkinExpectation =
      [self expectationWithDescription:@"Did call checkin service"];

  FIRMessagingCheckinPreferences *checkinPreferences = [self validCheckinPreferences];
  OCMStub([self.mockCheckinService checkinWithExistingCheckin:self.checkinService.checkinPreferences
                                                   completion:[OCMArg checkWithBlock:^BOOL(id obj) {
                                                     self.checkinCompletion = obj;
                                                     return obj != nil;
                                                   }]])
      .andDo(^(NSInvocation *invocation) {
        // Mock successful Checkin after delay.
        dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(0.5 * NSEC_PER_SEC)),
                       dispatch_get_main_queue(), ^{
                         [checkinExpectation fulfill];
                         self.checkinCompletion(checkinPreferences, nil);
                       });
      });

  // Always return YES for whether we succeeded in persisting the checkin
  OCMStub([self.mockStore
      saveCheckinPreferences:checkinPreferences
                     handler:([OCMArg invokeBlockWithArgs:[NSNull null], nil])]);

  [self.authService scheduleCheckin:YES];

  // Schedule another checkin after some delay while the first checkin has not yet returned
  dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(0.1 * NSEC_PER_SEC)),
                 dispatch_get_main_queue(), ^{
                   [self.authService scheduleCheckin:NO];
                 });

  [self waitForExpectationsWithTimeout:5.0 handler:NULL];
  XCTAssertTrue([self.authService hasValidCheckinInfo]);
  XCTAssertEqual([self.authService checkinRetryCount], 1);
}

/**
 *  Test initial checkin failure which schedules another checkin which should succeed.
 */
- (void)testInitialCheckinFailure_retrySuccess {
  XCTestExpectation *checkinExpectation =
      [self expectationWithDescription:@"Did call checkin service"];
  __block int checkinHandlerInvocationCount = 0;

  OCMStub([self.mockCheckinService checkinWithExistingCheckin:[OCMArg any]
                                                   completion:[OCMArg checkWithBlock:^BOOL(id obj) {
                                                     self.checkinCompletion = obj;
                                                     return obj != nil;
                                                   }]])
      .andDo(^(NSInvocation *invocation) {
        checkinHandlerInvocationCount++;

        if (checkinHandlerInvocationCount == 1) {
          // Mock failure on first try
          NSError *error = [NSError messagingErrorWithCode:kFIRMessagingErrorCodeUnknown
                                             failureReason:@"Timeout"];
          self.checkinCompletion(nil, error);
        } else if (checkinHandlerInvocationCount == 2) {
          // Mock success on second try
          [checkinExpectation fulfill];
          self.checkinCompletion([self validCheckinPreferences], nil);
        } else {
          // We should not retry for a third time again.
          XCTFail(@"Invoking checkin handler invalid number of times.");
        }
      });

  // Always return YES for whether we succeeded in persisting the checkin
  OCMStub([self.mockStore
      saveCheckinPreferences:[OCMArg any]
                     handler:([OCMArg invokeBlockWithArgs:[NSNull null], nil])]);

  [self.authService scheduleCheckin:YES];
  // Schedule another checkin after some delay while the first checkin has not yet returned
  dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(0.5 * NSEC_PER_SEC)),
                 dispatch_get_main_queue(), ^{
                   [self.authService scheduleCheckin:YES];
                   XCTAssertTrue([self.authService hasValidCheckinInfo]);
                   XCTAssertEqual([self.authService checkinRetryCount], 2);
                   XCTAssertEqual(checkinHandlerInvocationCount, 2);
                 });

  [self waitForExpectationsWithTimeout:5.0 handler:NULL];
}

/**
 *  Test initial checkin failure which schedules another checkin which should succeed. If
 *  a new checkin request comes after that we should not schedule a checkin as we have
 *  already have valid checkin credentials.
 */
- (void)testInitialCheckinFailure_multipleRetrySuccess {
  XCTestExpectation *checkinExpectation =
      [self expectationWithDescription:@"Did call checkin service"];
  __block int checkinHandlerInvocationCount = 0;

  OCMStub([self.mockCheckinService checkinWithExistingCheckin:[OCMArg any]
                                                   completion:[OCMArg checkWithBlock:^BOOL(id obj) {
                                                     self.checkinCompletion = obj;
                                                     return obj != nil;
                                                   }]])
      .andDo(^(NSInvocation *invocation) {
        checkinHandlerInvocationCount++;

        if (checkinHandlerInvocationCount <= 2) {
          // Mock failure on first try
          NSError *error = [NSError messagingErrorWithCode:kFIRMessagingErrorCodeUnknown
                                             failureReason:@"Timeout"];
          self.checkinCompletion(nil, error);
        } else if (checkinHandlerInvocationCount == 3) {
          // Mock success on second try
          [checkinExpectation fulfill];
          self.checkinCompletion([self validCheckinPreferences], nil);
        } else {
          // We should not retry for a third time again.
          XCTFail(@"Invoking checkin handler invalid number of times.");
        }
      });

  // Always return YES for whether we succeeded in persisting the checkin
  OCMStub([self.mockStore
      saveCheckinPreferences:[OCMArg any]
                     handler:([OCMArg invokeBlockWithArgs:[NSNull null], nil])]);

  [self.authService scheduleCheckin:YES];

  [self waitForExpectationsWithTimeout:10.0 handler:NULL];
  XCTAssertTrue([self.authService hasValidCheckinInfo]);
  XCTAssertEqual([self.authService checkinRetryCount], 3);
}

/**
 * Performing multiple checkin requests should result in multiple handlers being
 * called back, but with only a single actual checkin fetch.
 */
- (void)testMultipleCheckinHandlersWithSuccessfulCheckin {
  XCTestExpectation *allHandlersCalledExpectation =
      [self expectationWithDescription:@"All checkin handlers were called"];
  __block NSInteger checkinHandlerCallbackCount = 0;
  __block NSInteger checkinServiceInvocationCount = 0;

  // Always return a successful checkin, and count the number of times CheckinService is called
  OCMStub([self.mockCheckinService checkinWithExistingCheckin:[OCMArg any]
                                                   completion:[OCMArg checkWithBlock:^BOOL(id obj) {
                                                     self.checkinCompletion = obj;
                                                     return obj != nil;
                                                   }]])
      .andDo(^(NSInvocation *invocation) {
        checkinServiceInvocationCount++;
        self.checkinCompletion([self validCheckinPreferences], nil);
      });

  // Always return YES for whether we succeeded in persisting the checkin
  OCMStub([self.mockStore
      saveCheckinPreferences:[OCMArg any]
                     handler:([OCMArg invokeBlockWithArgs:[NSNull null], nil])]);

  NSInteger numHandlers = 10;
  for (NSInteger i = 0; i < numHandlers; i++) {
    [self.authService
        fetchCheckinInfoWithHandler:^(FIRMessagingCheckinPreferences *checkin, NSError *error) {
          checkinHandlerCallbackCount++;
          if (checkinHandlerCallbackCount == numHandlers) {
            [allHandlersCalledExpectation fulfill];
          }
        }];
  }

  [self waitForExpectationsWithTimeout:1.0 handler:nil];
  XCTAssertEqual(checkinServiceInvocationCount, 1);
  XCTAssertEqual(checkinHandlerCallbackCount, numHandlers);
}

/**
 * Performing a scheduled checkin *and* simultaneous checkin request should result in
 * the number of pending checkin handlers to be 2 (one for the scheduled checkin, one for
 * the direct fetch).
 */
- (void)testScheduledAndImmediateCheckinsWithMultipleHandler {
  XCTestExpectation *fetchHandlerCalledExpectation =
      [self expectationWithDescription:@"Direct checkin handler was called"];
  __block NSInteger checkinServiceInvocationCount = 0;

  // Always return a successful checkin, and count the number of times CheckinService is called
  OCMStub([self.mockCheckinService checkinWithExistingCheckin:[OCMArg any]
                                                   completion:[OCMArg checkWithBlock:^BOOL(id obj) {
                                                     self.checkinCompletion = obj;
                                                     return obj != nil;
                                                   }]])
      .andDo(^(NSInvocation *invocation) {
        checkinServiceInvocationCount++;
        // Give the checkin service some time to complete the request
        dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(0.25 * NSEC_PER_SEC)),
                       dispatch_get_main_queue(), ^{
                         self.checkinCompletion([self validCheckinPreferences], nil);
                       });
      });

  // Always return YES for whether we succeeded in persisting the checkin
  OCMStub([self.mockStore
      saveCheckinPreferences:[OCMArg any]
                     handler:([OCMArg invokeBlockWithArgs:[NSNull null], nil])]);

  // Start a scheduled (though immediate) checkin
  [self.authService scheduleCheckin:YES];

  // Request a direct checkin fetch
  [self.authService
      fetchCheckinInfoWithHandler:^(FIRMessagingCheckinPreferences *checkin, NSError *error) {
        [fetchHandlerCalledExpectation fulfill];
      }];
  // At this point we should have checkinHandlers, one for scheduled, one for the direct fetch
  XCTAssertEqual(self.authService.checkinHandlers.count, 2);

  [self waitForExpectationsWithTimeout:0.5 handler:nil];
  // Make sure only one checkin fetch was performed
  XCTAssertEqual(checkinServiceInvocationCount, 1);
}

#pragma mark - Helper Methods

- (FIRMessagingCheckinPreferences *)validCheckinPreferences {
  NSDictionary *gservicesData = @{
    kFIRMessagingVersionInfoStringKey : kVersionInfo,
    kFIRMessagingLastCheckinTimeKey : @(FIRMessagingCurrentTimestampInMilliseconds())
  };
  FIRMessagingCheckinPreferences *checkinPreferences =
      [[FIRMessagingCheckinPreferences alloc] initWithDeviceID:kDeviceAuthId
                                                   secretToken:kSecretToken];
  [checkinPreferences updateWithCheckinPlistContents:gservicesData];
  return checkinPreferences;
}

@end