feat: support for lambda authorizer (#1334)

* feat: lambda authorizer, update AuthRule and AuthRuleProvider

* feat: add AWSLambdaAuth

* feat: update AWSAuthorizationType docs

* feat: update interceptors, renamed shared types

* feat: update AWSAuthorizationConfiguration, fix warnings

* chore: lambda auth unit tests

* chore: update comments, remove unused associated value

* chore: add tests

* chore: add more interceptors tests

* feat: update SyncEngine requirements

* remove region from Lambda auth configuration

* sync requirements, explicit provider switch case

* style change

* integration tests

* integration tests

* throw PluginError if token provider not available

* resolve lint errors

* AuthToken interceptor

* update integ tests instructions

* update integ tests instructions

* update documentation

* test paginated query

* address PR comments

* return public/custom if user not logged in

Author: diegocstn

Amplify.xcodeproj/project.pbxproj

@@ -248,6 +248,7 @@
 		762C978526210F6400798FA3 /* RecordCover.swift in Sources */ = {isa = PBXBuildFile; fileRef = 762C978426210F6400798FA3 /* RecordCover.swift */; };
 		762C978E26210FF100798FA3 /* RecordCover+Schema.swift in Sources */ = {isa = PBXBuildFile; fileRef = 762C978D26210FF100798FA3 /* RecordCover+Schema.swift */; };
 		762F70A426683EE2001F8252 /* AuthRuleExtensionTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 762F70A326683EE2001F8252 /* AuthRuleExtensionTests.swift */; };
+		7638895326A7A9AC0061AF0B /* AWSLambdaAuthConfiguration.swift in Sources */ = {isa = PBXBuildFile; fileRef = 7638895226A7A9AC0061AF0B /* AWSLambdaAuthConfiguration.swift */; };
 		7678B38426017D5300B4917F /* AppSyncErrorTypeTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 7678B38326017D5300B4917F /* AppSyncErrorTypeTests.swift */; };
 		7678B38526017D5300B4917F /* AppSyncErrorTypeTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 7678B38326017D5300B4917F /* AppSyncErrorTypeTests.swift */; };
 		767F85FC2649FF540076D633 /* CustomerOrder.swift in Sources */ = {isa = PBXBuildFile; fileRef = 767F85FB2649FF540076D633 /* CustomerOrder.swift */; };
@@ -1141,6 +1142,7 @@
 		762C978426210F6400798FA3 /* RecordCover.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = RecordCover.swift; sourceTree = "<group>"; };
 		762C978D26210FF100798FA3 /* RecordCover+Schema.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = "RecordCover+Schema.swift"; sourceTree = "<group>"; };
 		762F70A326683EE2001F8252 /* AuthRuleExtensionTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AuthRuleExtensionTests.swift; sourceTree = "<group>"; };
+		7638895226A7A9AC0061AF0B /* AWSLambdaAuthConfiguration.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AWSLambdaAuthConfiguration.swift; sourceTree = "<group>"; };
 		7678B38326017D5300B4917F /* AppSyncErrorTypeTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AppSyncErrorTypeTests.swift; sourceTree = "<group>"; };
 		767F85FB2649FF540076D633 /* CustomerOrder.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = CustomerOrder.swift; sourceTree = "<group>"; };
 		767F85FD2649FFCC0076D633 /* CustomerOrder+Schema.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = "CustomerOrder+Schema.swift"; sourceTree = "<group>"; };
@@ -1993,6 +1995,7 @@
 				21420A7C237222A700FA140C /* APIKeyConfiguration.swift */,
 				21420A7D237222A700FA140C /* AWSAuthorizationConfiguration.swift */,
 				21420A7B237222A700FA140C /* AWSIAMConfiguration.swift */,
+				7638895226A7A9AC0061AF0B /* AWSLambdaAuthConfiguration.swift */,
 				21420A7F237222A700FA140C /* CognitoUserPoolsConfiguration.swift */,
 				21420A7E237222A700FA140C /* OIDCConfiguration.swift */,
 			);
@@ -2972,8 +2975,6 @@
 				762167D42615435C0033FCD2 /* Record+Schema.swift */,
 				762C978426210F6400798FA3 /* RecordCover.swift */,
 				762C978D26210FF100798FA3 /* RecordCover+Schema.swift */,
-				6B7743D625906F7E001469F5 /* Restaurant */,
-				21A9051E2616442000EC141D /* Scalar */,
 				6B9F7C542526864800F1F71C /* ScenarioATest6Post.swift */,
 				6B9F7C532526864800F1F71C /* ScenarioATest6Post+Schema.swift */,
 				214F49742486D8A200DA616C /* User.swift */,
@@ -4748,6 +4749,7 @@
 				2129BE1E2394806B006363A1 /* QueryPredicate+GraphQL.swift in Sources */,
 				21420A8F237222A900FA140C /* AWSIAMConfiguration.swift in Sources */,
 				219A888523EB897700BBC5F2 /* GraphQLRequest+AnyModelWithSync.swift in Sources */,
+				7638895326A7A9AC0061AF0B /* AWSLambdaAuthConfiguration.swift in Sources */,
 				219A88F123F3379900BBC5F2 /* GraphQLDocumentInput.swift in Sources */,
 				21AD424E249BF0E90016FE95 /* AnyModel+Subscript.swift in Sources */,
 				21420AA0237222A900FA140C /* AWSAuthorizationType.swift in Sources */,

Amplify/Categories/API/AuthProvider/APIAuthProviderFactory.swift

@@ -18,11 +18,19 @@ open class APIAuthProviderFactory {
     open func oidcAuthProvider() -> AmplifyOIDCAuthProvider? {
         return nil
     }
+
+    open func functionAuthProvider() -> AmplifyFunctionAuthProvider? {
+        return nil
+    }
+}
+
+public protocol AmplifyAuthTokenProvider {
+    typealias AuthToken = String
+    func getLatestAuthToken() -> Result<AuthToken, Error>
 }
 
 /// Amplify OIDC Auth Provider
-public protocol AmplifyOIDCAuthProvider {
+public protocol AmplifyOIDCAuthProvider: AmplifyAuthTokenProvider {}
 
-    /// Retrieve the latest auth token
-    func getLatestAuthToken() -> Result<String, Error>
-}
+/// Amplify Function Auth Provider
+public protocol AmplifyFunctionAuthProvider: AmplifyAuthTokenProvider {}

Amplify/Categories/DataStore/Model/Internal/Schema/AuthRule.swift

@@ -12,6 +12,7 @@ public enum AuthStrategy {
     case groups
     case `private`
     case `public`
+    case custom
 }
 
 /// - Warning: Although this has `public` access, it is intended for internal use and should not be used directly
@@ -30,6 +31,7 @@ public enum AuthRuleProvider {
     case oidc
     case iam
     case userPools
+    case function
 }
 
 /// - Warning: Although this has `public` access, it is intended for internal use and should not be used directly

Amplify/Categories/DataStore/Subscribe/MutationEvent+Model.swift

@@ -20,7 +20,7 @@ extension MutationEvent {
                       mutationType: mutationType,
                       version: version)
     }
-  
+
     public init(untypedModel model: Model,
                 modelName: ModelName,
                 mutationType: MutationType,