Fix internal and better cancellation.

SebastianStehle · SebastianStehle · commit eff22a845a13 · 2023-01-12T12:12:42.000+01:00
diff --git a/sample/Sample.Android/NotificationHandler.cs b/sample/Sample.Android/NotificationHandler.cs
@@ -5,6 +5,8 @@
 //  All rights reserved. Licensed under the MIT license.
 // ==========================================================================
 
+using System.Threading;
+using System.Threading.Tasks;
 using Android.App;
 using Android.Content;
 using Android.OS;
@@ -15,16 +17,18 @@ namespace Sample.Droid
 {
     public class NotificationHandler : INotificationHandler
     {
-        public void OnBuildNotification(NotificationCompat.Builder notificationBuilder, UserNotificationDto notification)
+        public Task OnBuildNotificationAsync(NotificationCompat.Builder notificationBuilder, UserNotificationDto notification,
+            CancellationToken ct)
         {
             if (Build.VERSION.SdkInt >= BuildVersionCodes.O)
             {
-                return;
+                return Task.CompletedTask;
             }
 
             var soundUri = Android.Net.Uri.Parse($"{ContentResolver.SchemeAndroidResource}://{Application.Context.PackageName}/raw/announcement");
 
             notificationBuilder.SetSound(soundUri);
+            return Task.CompletedTask;
         }
     }
 }
diff --git a/sample/Sample.iOS.Shared/NotificationHandler.cs b/sample/Sample.iOS.Shared/NotificationHandler.cs
@@ -6,15 +6,20 @@
 // ==========================================================================
 
 using Notifo.SDK;
+using System.Threading;
+using System.Threading.Tasks;
 using UserNotifications;
 
 namespace Sample.iOS.Shared
 {
     public class NotificationHandler : INotificationHandler
     {
-        public void OnBuildNotification(UNMutableNotificationContent content, UserNotificationDto notification)
+        public Task OnBuildNotificationAsync(UNMutableNotificationContent content, UserNotificationDto notification,
+            CancellationToken ct)
         {
             content.Sound = UNNotificationSound.GetSound("announcement.caf");
+
+            return Task.CompletedTask;
         }
     }
 }
diff --git a/sample/SampleNotificationServiceExtension/NotificationService.cs b/sample/SampleNotificationServiceExtension/NotificationService.cs
@@ -37,7 +37,7 @@ public override async void DidReceiveNotificationRequest(UNNotificationRequest r
 				.SetSharedName("group.io.notifo.xamarin.sample")
 				.SetNotificationHandler(new NotificationHandler());
 
-			await NotifoIO.Current.DidReceiveNotificationRequestAsync(request, BestAttemptContent);
+            await NotifoIO.Current.DidReceiveNotificationRequestAsync(request, BestAttemptContent);
 
 			// Display the notification.
 			ContentHandler(BestAttemptContent);
diff --git a/sdk/Notifo.SDK.FirebasePlugin/NotifoMobilePushExtensions.ios.cs b/sdk/Notifo.SDK.FirebasePlugin/NotifoMobilePushExtensions.ios.cs
@@ -62,9 +62,9 @@ static bool ContainsPullRefreshRequest(NSDictionary data)
             return aps?.ContainsKey(new NSString(Constants.ContentAvailableKey)) == true;
         }
 
-        if (ContainsPullRefreshRequest(data))
+        if (ContainsPullRefreshRequest(data) && notifo is InternalIOSPushAdapter adapter)
         {
-            await notifo.DidReceivePullRefreshRequestAsync();
+            await adapter.DidReceivePullRefreshRequestAsync();
         }
 
         FirebasePushNotificationManager.DidReceiveMessage(data);
@@ -99,7 +99,10 @@ public static void RemoteNotificationRegistrationFailed(this INotifoMobilePush n
     /// <param name="completionHandler">The action to execute when you have finished processing the user's response.</param>
     public static void DidReceiveNotificationResponse(this INotifoMobilePush notifo, UNUserNotificationCenter center, UNNotificationResponse response, Action completionHandler)
     {
-        notifo.DidReceiveNotificationResponse(center, response, completionHandler);
+        if (notifo is InternalIOSPushAdapter adapter)
+        {
+            adapter.DidReceiveNotificationResponse(response);
+        }
 
         if (CrossFirebasePushNotification.Current is IUNUserNotificationCenterDelegate notificationDelegate)
         {
diff --git a/sdk/Notifo.SDK.FirebasePlugin/NotifoPushNotificationHandler.android.cs b/sdk/Notifo.SDK.FirebasePlugin/NotifoPushNotificationHandler.android.cs
@@ -17,19 +17,11 @@ namespace Notifo.SDK.FirebasePlugin;
 
 internal class NotifoPushNotificationHandler : DefaultPushNotificationHandler
 {
-    private NotifoMobilePushImplementation notifoMobilePush;
-
-    public NotifoPushNotificationHandler()
-    {
-        notifoMobilePush = (NotifoMobilePushImplementation)NotifoIO.Current;
-    }
-
     public override void OnReceived(IDictionary<string, object> parameters)
     {
         NotifoIO.Current.RaiseDebug(Strings.ReceivedNotification, this, parameters);
 
-        var notification = new UserNotificationDto()
-            .FromDictionary(new Dictionary<string, object>(parameters));
+        var notification = new UserNotificationDto().FromDictionary(parameters);
 
         if (notification.Silent)
         {
@@ -48,9 +40,11 @@ public override void OnReceived(IDictionary<string, object> parameters)
 
     public override void OnBuildNotification(NotificationCompat.Builder notificationBuilder, IDictionary<string, object> parameters)
     {
-        var notification = new UserNotificationDto()
-            .FromDictionary(new Dictionary<string, object>(parameters));
+        var notification = new UserNotificationDto().FromDictionary(parameters);
 
-        notifoMobilePush.OnBuildNotification(notificationBuilder, notification);
+        if (NotifoIO.Current is InternalAndroidPushAdapter adapter)
+        {
+            _ = adapter.OnBuildNotificationAsync(notificationBuilder, notification);
+        }
     }
 }
diff --git a/sdk/Notifo.SDK/Constants.cs b/sdk/Notifo.SDK/Constants.cs
@@ -5,9 +5,11 @@
 //  All rights reserved. Licensed under the MIT license.
 // ==========================================================================
 
+#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member
+
 namespace Notifo.SDK;
 
-internal static class Constants
+public static class Constants
 {
     public const string ApsAlertBodyKey = "aps.alert.body";
 
diff --git a/sdk/Notifo.SDK/Extensions/UserNotificationDtoExtensions.cs b/sdk/Notifo.SDK/Extensions/UserNotificationDtoExtensions.cs
@@ -8,9 +8,11 @@
 using System;
 using System.Collections.Generic;
 
+#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member
+
 namespace Notifo.SDK.Extensions;
 
-internal static class UserNotificationDtoExtensions
+public static class UserNotificationDtoExtensions
 {
     public static Dictionary<string, string> ToDictionary(this UserNotificationDto notification)
     {
@@ -81,7 +83,7 @@ public static Dictionary<string, string> ToDictionary(this UserNotificationDto n
         return data;
     }
 
-    public static UserNotificationDto FromDictionary(this UserNotificationDto notification, Dictionary<string, object> data)
+    public static UserNotificationDto FromDictionary(this UserNotificationDto notification, IDictionary<string, object> data)
     {
         if (data.TryGetValue(Constants.IdKey, out var id) && Guid.TryParse(id.ToString(), out var guid))
         {
diff --git a/sdk/Notifo.SDK/INotificationHandler.android.cs b/sdk/Notifo.SDK/INotificationHandler.android.cs
@@ -5,6 +5,8 @@
 //  All rights reserved. Licensed under the MIT license.
 // ==========================================================================
 
+using System.Threading;
+using System.Threading.Tasks;
 using AndroidX.Core.App;
 
 namespace Notifo.SDK;
@@ -19,5 +21,8 @@ public interface INotificationHandler
     /// </summary>
     /// <param name="notificationBuilder">The notification builder.</param>
     /// <param name="notification">The notification.</param>
-    void OnBuildNotification(NotificationCompat.Builder notificationBuilder, UserNotificationDto notification);
+    /// <param name="ct">The cancellation token to abort waiting.</param>
+    /// <returns>The tasks.</returns>
+    Task OnBuildNotificationAsync(NotificationCompat.Builder notificationBuilder, UserNotificationDto notification,
+        CancellationToken ct);
 }
diff --git a/sdk/Notifo.SDK/INotificationHandler.ios.cs b/sdk/Notifo.SDK/INotificationHandler.ios.cs
@@ -5,6 +5,8 @@
 //  All rights reserved. Licensed under the MIT license.
 // ==========================================================================
 
+using System.Threading;
+using System.Threading.Tasks;
 using UserNotifications;
 
 namespace Notifo.SDK;
@@ -19,5 +21,8 @@ public interface INotificationHandler
     /// </summary>
     /// <param name="content">The notification content.</param>
     /// <param name="notification">The notification.</param>
-    void OnBuildNotification(UNMutableNotificationContent content, UserNotificationDto notification);
+    /// <param name="ct">The cancellation token to abort waiting.</param>
+    /// <returns>The tasks.</returns>
+    Task OnBuildNotificationAsync(UNMutableNotificationContent content, UserNotificationDto notification,
+        CancellationToken ct);
 }
diff --git a/sdk/Notifo.SDK/INotifoMobilePush.android.cs b/sdk/Notifo.SDK/INotifoMobilePush.android.cs
@@ -5,6 +5,9 @@
 //  All rights reserved. Licensed under the MIT license.
 // ==========================================================================
 
+using System.Threading.Tasks;
+using AndroidX.Core.App;
+
 namespace Notifo.SDK;
 
 /// <summary>
@@ -26,3 +29,19 @@ public partial interface INotifoMobilePush
     /// <returns>The current instance.</returns>
     INotifoMobilePush SetImageCacheCapacity(int capacity);
 }
+
+/// <summary>
+/// Provides methods that should not be triggered from user code.
+/// </summary>
+#pragma warning disable IDE1006 // Naming Styles
+public interface InternalAndroidPushAdapter
+#pragma warning restore IDE1006 // Naming Styles
+{
+    /// <summary>
+    /// Called when a notification has been received.
+    /// </summary>
+    /// <param name="notificationBuilder">The android notification.</param>
+    /// <param name="notification">The notifo notification.</param>
+    /// <returns>The tasks.</returns>
+    Task OnBuildNotificationAsync(NotificationCompat.Builder notificationBuilder, UserNotificationDto notification);
+}
diff --git a/sdk/Notifo.SDK/INotifoMobilePush.ios.cs b/sdk/Notifo.SDK/INotifoMobilePush.ios.cs
@@ -19,14 +19,29 @@ public partial interface INotifoMobilePush
     /// <returns>The current instance.</returns>
     INotifoMobilePush SetNotificationHandler(INotificationHandler? notificationHandler);
 
+    /// <summary>
+    /// Sets the options that are used when new notifications are pulled.
+    /// </summary>
+    /// <param name="refreshOptions">The options.</param>
+    /// <returns>The current instance.</returns>
+    INotifoMobilePush SetRefreshOptions(PullRefreshOptions refreshOptions);
+
     /// <summary>
     /// Method for processing notification before delivery.
     /// </summary>
     /// <param name="request">The request that was received.</param>
     /// <param name="content">The notification content to enrich.</param>
     /// <returns>A <see cref="Task"/> representing the result of the asynchronous operation.</returns>
     Task DidReceiveNotificationRequestAsync(UNNotificationRequest request, UNMutableNotificationContent content);
+}
 
+/// <summary>
+/// Provides methods that should not be triggered from user code.
+/// </summary>
+#pragma warning disable IDE1006 // Naming Styles
+public interface InternalIOSPushAdapter
+#pragma warning restore IDE1006 // Naming Styles
+{
     /// <summary>
     /// Method for pulling pending notifications.
     /// </summary>
@@ -38,11 +53,4 @@ public partial interface INotifoMobilePush
     /// </summary>
     /// <param name="response">The user's response to the notification.</param>
     void DidReceiveNotificationResponse(UNNotificationResponse response);
-
-    /// <summary>
-    /// Sets the options that are used when new notifications are pulled.
-    /// </summary>
-    /// <param name="refreshOptions">The options.</param>
-    /// <returns>The current instance.</returns>
-    INotifoMobilePush SetRefreshOptions(PullRefreshOptions refreshOptions);
 }
diff --git a/sdk/Notifo.SDK/Notifo.SDK.Core.csproj b/sdk/Notifo.SDK/Notifo.SDK.Core.csproj
@@ -1,5 +1,6 @@
 ﻿<Project Sdk="MSBuild.Sdk.Extras/3.0.22">
   <PropertyGroup>
+    <AssemblyName>Notifo.Xamarin.Core</AssemblyName>
     <GenerateDocumentationFile>true</GenerateDocumentationFile>
     <GeneratePackageOnBuild>true</GeneratePackageOnBuild>
     <LangVersion>latest</LangVersion>
@@ -14,7 +15,6 @@
 
   <PropertyGroup>
     <CodeAnalysisRuleSet>..\..\Notifo.ruleset</CodeAnalysisRuleSet>
-    <AssemblyName>Notifo.Xamarin.Core</AssemblyName>
   </PropertyGroup>
 
   <ItemGroup>
@@ -66,4 +66,10 @@
       <DesignTime>True</DesignTime>
     </Compile>
   </ItemGroup>
+
+  <ItemGroup>
+    <EmbeddedResource Update="Resources\Strings.resx">
+      <Generator>PublicResXFileCodeGenerator</Generator>
+    </EmbeddedResource>
+  </ItemGroup>
 </Project>
diff --git a/sdk/Notifo.SDK/NotifoMobilePush/NotifoMobilePushImplementation.android.cs b/sdk/Notifo.SDK/NotifoMobilePush/NotifoMobilePushImplementation.android.cs
@@ -6,6 +6,7 @@
 // ==========================================================================
 
 using System;
+using System.Threading.Tasks;
 using Android.App;
 using Android.Content;
 using Android.Graphics;
@@ -17,7 +18,7 @@
 
 namespace Notifo.SDK.NotifoMobilePush;
 
-internal partial class NotifoMobilePushImplementation
+internal partial class NotifoMobilePushImplementation : InternalAndroidPushAdapter
 {
     private readonly LRUCache<string, Bitmap> bitmapCache = new LRUCache<string, Bitmap>(10_000_000);
     private INotificationHandler? notificationHandler;
@@ -27,6 +28,14 @@ partial void SetupPlatform()
         OnNotificationReceived += PushEventsProvider_OnNotificationReceivedAndroid;
     }
 
+    private void PushEventsProvider_OnNotificationReceivedAndroid(object sender, NotificationEventArgs e)
+    {
+        if (!string.IsNullOrWhiteSpace(e.Notification.TrackSeenUrl))
+        {
+            _ = TrackNotificationsAsync(e.Notification);
+        }
+    }
+
     /// <inheritdoc />
     public INotifoMobilePush SetNotificationHandler(INotificationHandler? notificationHandler)
     {
@@ -41,15 +50,8 @@ public INotifoMobilePush SetImageCacheCapacity(int capacity)
         return this;
     }
 
-    private void PushEventsProvider_OnNotificationReceivedAndroid(object sender, NotificationEventArgs e)
-    {
-        if (!string.IsNullOrWhiteSpace(e.Notification.TrackSeenUrl))
-        {
-            _ = TrackNotificationsAsync(e.Notification);
-        }
-    }
-
-    internal void OnBuildNotification(NotificationCompat.Builder notificationBuilder, UserNotificationDto notification)
+    /// <inheritdoc />
+    public async Task OnBuildNotificationAsync(NotificationCompat.Builder notificationBuilder, UserNotificationDto notification)
     {
         if (!string.IsNullOrWhiteSpace(notification.Subject))
         {
@@ -96,7 +98,10 @@ internal void OnBuildNotification(NotificationCompat.Builder notificationBuilder
             AddAction(notificationBuilder, notification.LinkText, notification.LinkUrl);
         }
 
-        notificationHandler?.OnBuildNotification(notificationBuilder, notification);
+        if (notificationHandler != null)
+        {
+            await notificationHandler.OnBuildNotificationAsync(notificationBuilder, notification, default);
+        }
     }
 
     private Bitmap? GetBitmap(string bitmapUrl, int? width = null, int? height = null)
diff --git a/sdk/Notifo.SDK/NotifoMobilePush/NotifoMobilePushImplementation.ios.cs b/sdk/Notifo.SDK/NotifoMobilePush/NotifoMobilePushImplementation.ios.cs
diff --git a/sdk/Notifo.SDK/Properties/AssemblyInfo.cs b/sdk/Notifo.SDK/Properties/AssemblyInfo.cs
diff --git a/sdk/Notifo.SDK/Resources/Strings.Designer.cs b/sdk/Notifo.SDK/Resources/Strings.Designer.cs
diff --git a/sdk/Notifo.SDK/Resources/Strings.resx b/sdk/Notifo.SDK/Resources/Strings.resx

Original file line number	Diff line number	Diff line change
`@@ -5,6 +5,8 @@`
`5`	`5`	`// All rights reserved. Licensed under the MIT license.`
`6`	`6`	`// ==========================================================================`
`7`	`7`
	`8`	`+using System.Threading;`
	`9`	`+using System.Threading.Tasks;`
`8`	`10`	`using Android.App;`
`9`	`11`	`using Android.Content;`
`10`	`12`	`using Android.OS;`
`@@ -15,16 +17,18 @@ namespace Sample.Droid`
`15`	`17`	`{`
`16`	`18`	`public class NotificationHandler : INotificationHandler`
`17`	`19`	`{`
`18`		`- public void OnBuildNotification(NotificationCompat.Builder notificationBuilder, UserNotificationDto notification)`
	`20`	`+ public Task OnBuildNotificationAsync(NotificationCompat.Builder notificationBuilder, UserNotificationDto notification,`
	`21`	`+ CancellationToken ct)`
`19`	`22`	`{`
`20`	`23`	`if (Build.VERSION.SdkInt >= BuildVersionCodes.O)`
`21`	`24`	`{`
`22`		`- return;`
	`25`	`+ return Task.CompletedTask;`
`23`	`26`	`}`
`24`	`27`
`25`	`28`	`var soundUri = Android.Net.Uri.Parse($"{ContentResolver.SchemeAndroidResource}://{Application.Context.PackageName}/raw/announcement");`
`26`	`29`
`27`	`30`	`notificationBuilder.SetSound(soundUri);`
	`31`	`+ return Task.CompletedTask;`
`28`	`32`	`}`
`29`	`33`	`}`
`30`	`34`	`}`
Original file line number	Diff line number	Diff line change
`@@ -6,15 +6,20 @@`
`6`	`6`	`// ==========================================================================`
`7`	`7`
`8`	`8`	`using Notifo.SDK;`
	`9`	`+using System.Threading;`
	`10`	`+using System.Threading.Tasks;`
`9`	`11`	`using UserNotifications;`
`10`	`12`
`11`	`13`	`namespace Sample.iOS.Shared`
`12`	`14`	`{`
`13`	`15`	`public class NotificationHandler : INotificationHandler`
`14`	`16`	`{`
`15`		`- public void OnBuildNotification(UNMutableNotificationContent content, UserNotificationDto notification)`
	`17`	`+ public Task OnBuildNotificationAsync(UNMutableNotificationContent content, UserNotificationDto notification,`
	`18`	`+ CancellationToken ct)`
`16`	`19`	`{`
`17`	`20`	`content.Sound = UNNotificationSound.GetSound("announcement.caf");`
	`21`	`+`
	`22`	`+ return Task.CompletedTask;`
`18`	`23`	`}`
`19`	`24`	`}`
`20`	`25`	`}`
Original file line number	Diff line number	Diff line change
`@@ -62,9 +62,9 @@ static bool ContainsPullRefreshRequest(NSDictionary data)`
`62`	`62`	`return aps?.ContainsKey(new NSString(Constants.ContentAvailableKey)) == true;`
`63`	`63`	`}`
`64`	`64`
`65`		`- if (ContainsPullRefreshRequest(data))`
	`65`	`+ if (ContainsPullRefreshRequest(data) && notifo is InternalIOSPushAdapter adapter)`
`66`	`66`	`{`
`67`		`- await notifo.DidReceivePullRefreshRequestAsync();`
	`67`	`+ await adapter.DidReceivePullRefreshRequestAsync();`
`68`	`68`	`}`
`69`	`69`
`70`	`70`	`FirebasePushNotificationManager.DidReceiveMessage(data);`
`@@ -99,7 +99,10 @@ public static void RemoteNotificationRegistrationFailed(this INotifoMobilePush n`
`99`	`99`	`/// <param name="completionHandler">The action to execute when you have finished processing the user's response.</param>`
`100`	`100`	`public static void DidReceiveNotificationResponse(this INotifoMobilePush notifo, UNUserNotificationCenter center, UNNotificationResponse response, Action completionHandler)`
`101`	`101`	`{`
`102`		`- notifo.DidReceiveNotificationResponse(center, response, completionHandler);`
	`102`	`+ if (notifo is InternalIOSPushAdapter adapter)`
	`103`	`+ {`
	`104`	`+ adapter.DidReceiveNotificationResponse(response);`
	`105`	`+ }`
`103`	`106`
`104`	`107`	`if (CrossFirebasePushNotification.Current is IUNUserNotificationCenterDelegate notificationDelegate)`
`105`	`108`	`{`
Original file line number	Diff line number	Diff line change
`@@ -17,19 +17,11 @@ namespace Notifo.SDK.FirebasePlugin;`
`17`	`17`
`18`	`18`	`internal class NotifoPushNotificationHandler : DefaultPushNotificationHandler`
`19`	`19`	`{`
`20`		`- private NotifoMobilePushImplementation notifoMobilePush;`
`21`		`-`
`22`		`- public NotifoPushNotificationHandler()`
`23`		`- {`
`24`		`- notifoMobilePush = (NotifoMobilePushImplementation)NotifoIO.Current;`
`25`		`- }`
`26`		`-`
`27`	`20`	`public override void OnReceived(IDictionary<string, object> parameters)`
`28`	`21`	`{`
`29`	`22`	`NotifoIO.Current.RaiseDebug(Strings.ReceivedNotification, this, parameters);`
`30`	`23`
`31`		`- var notification = new UserNotificationDto()`
`32`		`- .FromDictionary(new Dictionary<string, object>(parameters));`
	`24`	`+ var notification = new UserNotificationDto().FromDictionary(parameters);`
`33`	`25`
`34`	`26`	`if (notification.Silent)`
`35`	`27`	`{`
`@@ -48,9 +40,11 @@ public override void OnReceived(IDictionary<string, object> parameters)`
`48`	`40`
`49`	`41`	`public override void OnBuildNotification(NotificationCompat.Builder notificationBuilder, IDictionary<string, object> parameters)`
`50`	`42`	`{`
`51`		`- var notification = new UserNotificationDto()`
`52`		`- .FromDictionary(new Dictionary<string, object>(parameters));`
	`43`	`+ var notification = new UserNotificationDto().FromDictionary(parameters);`
`53`	`44`
`54`		`- notifoMobilePush.OnBuildNotification(notificationBuilder, notification);`
	`45`	`+ if (NotifoIO.Current is InternalAndroidPushAdapter adapter)`
	`46`	`+ {`
	`47`	`+ _ = adapter.OnBuildNotificationAsync(notificationBuilder, notification);`
	`48`	`+ }`
`55`	`49`	`}`
`56`	`50`	`}`
Original file line number	Diff line number	Diff line change
`@@ -8,9 +8,11 @@`
`8`	`8`	`using System;`
`9`	`9`	`using System.Collections.Generic;`
`10`	`10`
	`11`	`+#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member`
	`12`	`+`
`11`	`13`	`namespace Notifo.SDK.Extensions;`
`12`	`14`
`13`		`-internal static class UserNotificationDtoExtensions`
	`15`	`+public static class UserNotificationDtoExtensions`
`14`	`16`	`{`
`15`	`17`	`public static Dictionary<string, string> ToDictionary(this UserNotificationDto notification)`
`16`	`18`	`{`
`@@ -81,7 +83,7 @@ public static Dictionary<string, string> ToDictionary(this UserNotificationDto n`
`81`	`83`	`return data;`
`82`	`84`	`}`
`83`	`85`
`84`		`- public static UserNotificationDto FromDictionary(this UserNotificationDto notification, Dictionary<string, object> data)`
	`86`	`+ public static UserNotificationDto FromDictionary(this UserNotificationDto notification, IDictionary<string, object> data)`
`85`	`87`	`{`
`86`	`88`	`if (data.TryGetValue(Constants.IdKey, out var id) && Guid.TryParse(id.ToString(), out var guid))`
`87`	`89`	`{`