feat: Add synchronous storeCrashReport method to RaygunClient

- Expose a public storeCrashReport: method that writes a RaygunMessage
  to disk synchronously
- Applies groupingKeyProvider and beforeSendMessage before storing
- Stored reports are sent on next launch via sendAllStoredCrashReports
- Intended for use in unhandled exception hooks where async sends
  would not complete before process termination

Amp-Thread-ID: https://ampcode.com/threads/T-019c9e51-098e-704c-b1bb-7cd5b9576955
Co-authored-by: Amp <amp@ampcode.com>

Author: miquelbeltran

Sources/Raygun/RaygunClient.m

@@ -353,6 +353,42 @@ - (void)sendMessage:(RaygunMessage *)message {
     }
 }
 
+- (BOOL)storeCrashReport:(RaygunMessage *)message {
+    if (message == nil) {
+        [RaygunLogger logWarning:@"Failed to store crash report - Message object cannot be nil"];
+        return NO;
+    }
+
+    // Call groupingKeyProvider if it's set
+    if (self.groupingKeyProvider != nil && message.details != nil) {
+        NSString *groupingKey = self.groupingKeyProvider(message.details);
+
+        if (groupingKey != nil && ![groupingKey isEqualToString:@""]) {
+            message.details.groupingKey = groupingKey;
+            [RaygunLogger logDebug:@"Applied custom grouping key from provider: %@", groupingKey];
+        }
+    }
+
+    BOOL send = YES;
+    if (_beforeSendMessage != nil) {
+        send = _beforeSendMessage(message);
+    }
+
+    if (!send) {
+        [RaygunLogger logDebug:@"Crash report was discarded by beforeSendMessage"];
+        return NO;
+    }
+
+    NSString *path = [_fileManager storeCrashReport:message withMaxReportsStored:self.maxReportsStoredOnDevice];
+    if (path) {
+        [RaygunLogger logDebug:@"Stored crash report to %@", path];
+        return YES;
+    }
+
+    [RaygunLogger logError:@"Failed to store crash report to disk"];
+    return NO;
+}
+
 - (NSError *)getInnerError:(NSError *)error {
     NSError *innerErrror = error.userInfo[NSUnderlyingErrorKey];
     if (innerErrror) {

Sources/public/RaygunClient.h

@@ -181,6 +181,19 @@ NS_SWIFT_NAME(send(error:tags:customData:));
 - (void)sendMessage:(RaygunMessage *)message
 NS_SWIFT_NAME(send(message:));
 
+/*
+ * Synchronously store a crash report to disk.
+ * The report will be sent to Raygun on the next app launch when enableCrashReporting is called.
+ * This is intended for use in contexts where the process is about to terminate (e.g. unhandled exception hooks)
+ * and asynchronous network requests would not complete.
+ *
+ * @param message The crash report to be stored
+ *
+ * @return YES if the report was successfully stored, NO otherwise.
+ */
+- (BOOL)storeCrashReport:(RaygunMessage *)message
+NS_SWIFT_NAME(store(crashReport:));
+
 /*
  * Manually record a breadcrumb that will be included in the next crash report.
  *