release: 9.2.0

FirebaseFirestore.podspec

@@ -1,4 +1,4 @@
-firebase_firestore_version = '9.1.0'
+firebase_firestore_version = '9.2.0'
 
 Pod::Spec.new do |s|
   s.name                   = 'FirebaseFirestore'

FirebaseFirestore/BoringSSL-GRPC.xcframework/Info.plist

@@ -18,7 +18,7 @@
 		</dict>
 		<dict>
 			<key>LibraryIdentifier</key>
-			<string>ios-arm64_x86_64-maccatalyst</string>
+			<string>macos-arm64_x86_64</string>
 			<key>LibraryPath</key>
 			<string>BoringSSL-GRPC.framework</string>
 			<key>SupportedArchitectures</key>
@@ -27,22 +27,19 @@
 				<string>x86_64</string>
 			</array>
 			<key>SupportedPlatform</key>
-			<string>ios</string>
-			<key>SupportedPlatformVariant</key>
-			<string>maccatalyst</string>
+			<string>macos</string>
 		</dict>
 		<dict>
 			<key>LibraryIdentifier</key>
-			<string>macos-arm64_x86_64</string>
+			<string>tvos-arm64</string>
 			<key>LibraryPath</key>
 			<string>BoringSSL-GRPC.framework</string>
 			<key>SupportedArchitectures</key>
 			<array>
 				<string>arm64</string>
-				<string>x86_64</string>
 			</array>
 			<key>SupportedPlatform</key>
-			<string>macos</string>
+			<string>tvos</string>
 		</dict>
 		<dict>
 			<key>LibraryIdentifier</key>
@@ -61,15 +58,18 @@
 		</dict>
 		<dict>
 			<key>LibraryIdentifier</key>
-			<string>tvos-arm64</string>
+			<string>ios-arm64_x86_64-maccatalyst</string>
 			<key>LibraryPath</key>
 			<string>BoringSSL-GRPC.framework</string>
 			<key>SupportedArchitectures</key>
 			<array>
 				<string>arm64</string>
+				<string>x86_64</string>
 			</array>
 			<key>SupportedPlatform</key>
-			<string>tvos</string>
+			<string>ios</string>
+			<key>SupportedPlatformVariant</key>
+			<string>maccatalyst</string>
 		</dict>
 		<dict>
 			<key>LibraryIdentifier</key>

FirebaseFirestore/FirebaseFirestore.xcframework/Info.plist

@@ -21,61 +21,59 @@
 		</dict>
 		<dict>
 			<key>LibraryIdentifier</key>
-			<string>ios-arm64</string>
+			<string>ios-arm64_x86_64-maccatalyst</string>
 			<key>LibraryPath</key>
 			<string>FirebaseFirestore.framework</string>
 			<key>SupportedArchitectures</key>
 			<array>
 				<string>arm64</string>
+				<string>x86_64</string>
 			</array>
 			<key>SupportedPlatform</key>
 			<string>ios</string>
+			<key>SupportedPlatformVariant</key>
+			<string>maccatalyst</string>
 		</dict>
 		<dict>
 			<key>LibraryIdentifier</key>
-			<string>tvos-arm64</string>
+			<string>macos-arm64_x86_64</string>
 			<key>LibraryPath</key>
 			<string>FirebaseFirestore.framework</string>
 			<key>SupportedArchitectures</key>
 			<array>
 				<string>arm64</string>
+				<string>x86_64</string>
 			</array>
 			<key>SupportedPlatform</key>
-			<string>tvos</string>
+			<string>macos</string>
 		</dict>
 		<dict>
 			<key>LibraryIdentifier</key>
-			<string>tvos-arm64_x86_64-simulator</string>
+			<string>tvos-arm64</string>
 			<key>LibraryPath</key>
 			<string>FirebaseFirestore.framework</string>
 			<key>SupportedArchitectures</key>
 			<array>
 				<string>arm64</string>
-				<string>x86_64</string>
 			</array>
 			<key>SupportedPlatform</key>
 			<string>tvos</string>
-			<key>SupportedPlatformVariant</key>
-			<string>simulator</string>
 		</dict>
 		<dict>
 			<key>LibraryIdentifier</key>
-			<string>ios-arm64_x86_64-maccatalyst</string>
+			<string>ios-arm64</string>
 			<key>LibraryPath</key>
 			<string>FirebaseFirestore.framework</string>
 			<key>SupportedArchitectures</key>
 			<array>
 				<string>arm64</string>
-				<string>x86_64</string>
 			</array>
 			<key>SupportedPlatform</key>
 			<string>ios</string>
-			<key>SupportedPlatformVariant</key>
-			<string>maccatalyst</string>
 		</dict>
 		<dict>
 			<key>LibraryIdentifier</key>
-			<string>macos-arm64_x86_64</string>
+			<string>tvos-arm64_x86_64-simulator</string>
 			<key>LibraryPath</key>
 			<string>FirebaseFirestore.framework</string>
 			<key>SupportedArchitectures</key>
@@ -84,7 +82,9 @@
 				<string>x86_64</string>
 			</array>
 			<key>SupportedPlatform</key>
-			<string>macos</string>
+			<string>tvos</string>
+			<key>SupportedPlatformVariant</key>
+			<string>simulator</string>
 		</dict>
 	</array>
 	<key>CFBundlePackageType</key>

FirebaseFirestore/FirebaseFirestore.xcframework/ios-arm64/FirebaseFirestore.framework/Headers/FIRFirestore.h

@@ -26,6 +26,7 @@
 @class FIRLoadBundleTaskProgress;
 @class FIRQuery;
 @class FIRTransaction;
+@class FIRTransactionOptions;
 @class FIRWriteBatch;
 
 NS_ASSUME_NONNULL_BEGIN
@@ -146,6 +147,48 @@ NS_SWIFT_NAME(Firestore)
                      completion:(void (^)(id _Nullable result, NSError *_Nullable error))completion
     __attribute__((swift_async(none)));  // Disable async import due to #9426.
 
+/**
+ * Executes the given updateBlock and then attempts to commit the changes applied within an atomic
+ * transaction.
+ *
+ * The maximum number of writes allowed in a single transaction is 500, but note that each usage of
+ * `FieldValue.serverTimestamp()`, `FieldValue.arrayUnion()`, `FieldValue.arrayRemove()`, or
+ * `FieldValue.increment()` inside a transaction counts as an additional write.
+ *
+ * In the updateBlock, a set of reads and writes can be performed atomically using the
+ * `Transaction` object passed to the block. After the updateBlock is run, Firestore will attempt
+ * to apply the changes to the server. If any of the data read has been modified outside of this
+ * transaction since being read, then the transaction will be retried by executing the updateBlock
+ * again. If the transaction still fails after the attempting the number of times specified by the
+ * `max_attempts` property of the given `TransactionOptions` object, then the transaction will fail.
+ * If the given `TransactionOptions` is `nil`, then the default `max_attempts` of 5 will be used.
+ *
+ * Since the updateBlock may be executed multiple times, it should avoiding doing anything that
+ * would cause side effects.
+ *
+ * Any value maybe be returned from the updateBlock. If the transaction is successfully committed,
+ * then the completion block will be passed that value. The updateBlock also has an `NSErrorPointer`
+ * out parameter. If this is set, then the transaction will not attempt to commit, and the given
+ * error will be passed to the completion block.
+ *
+ * The `Transaction` object passed to the updateBlock contains methods for accessing documents
+ * and collections. Unlike other firestore access, data accessed with the transaction will not
+ * reflect local changes that have not been committed. For this reason, it is required that all
+ * reads are performed before any writes. Transactions must be performed while online. Otherwise,
+ * reads will fail, the final commit will fail, and the completion block will return an error.
+ *
+ * @param options The transaction options for controlling execution, or `nil` to use the default
+ *     transaction options.
+ * @param updateBlock The block to execute within the transaction context.
+ * @param completion The block to call with the result or error of the transaction. This
+ *     block will run even if the client is offline, unless the process is killed.
+ */
+- (void)runTransactionWithOptions:(FIRTransactionOptions *_Nullable)options
+                            block:(id _Nullable (^)(FIRTransaction *, NSError **))updateBlock
+                       completion:
+                           (void (^)(id _Nullable result, NSError *_Nullable error))completion
+    __attribute__((swift_async(none)));  // Disable async import due to #9426.
+
 /**
  * Creates a write batch, used for performing multiple writes as a single
  * atomic operation.

FirebaseFirestore/FirebaseFirestore.xcframework/ios-arm64/FirebaseFirestore.framework/Headers/FIRTransactionOptions.h

@@ -0,0 +1,40 @@
+/*
+ * Copyright 2022 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 <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ * Options to customize the behavior of `Firestore.runTransactionWithOptions()`.
+ */
+NS_SWIFT_NAME(TransactionOptions)
+@interface FIRTransactionOptions : NSObject <NSCopying>
+
+/**
+ * Creates and returns a new `TransactionOptions` object with all properties initialized to their
+ * default values.
+ *
+ * @return The created `TransactionOptions` object.
+ */
+- (instancetype)init NS_DESIGNATED_INITIALIZER;
+
+/** The maximum number of attempts to commit, after which transaction fails. Default is 5. */
+@property(nonatomic, assign) NSInteger maxAttempts;
+
+@end
+
+NS_ASSUME_NONNULL_END

FirebaseFirestore/FirebaseFirestore.xcframework/ios-arm64/FirebaseFirestore.framework/Headers/FirebaseFirestore-umbrella.h

@@ -29,6 +29,7 @@
 #import "FIRSnapshotMetadata.h"
 #import "FIRTimestamp.h"
 #import "FIRTransaction.h"
+#import "FIRTransactionOptions.h"
 #import "FIRWriteBatch.h"
 
 FOUNDATION_EXPORT double FirebaseFirestoreVersionNumber;

FirebaseFirestore/FirebaseFirestore.xcframework/ios-arm64/FirebaseFirestore.framework/Headers/FirebaseFirestore.h

@@ -31,4 +31,5 @@
 #import "FIRSnapshotMetadata.h"
 #import "FIRTimestamp.h"
 #import "FIRTransaction.h"
+#import "FIRTransactionOptions.h"
 #import "FIRWriteBatch.h"

FirebaseFirestore/FirebaseFirestore.xcframework/ios-arm64/FirebaseFirestore.framework/Info.plist

@@ -13,7 +13,7 @@
 	<key>CFBundlePackageType</key>
 	<string>FMWK</string>
 	<key>CFBundleVersion</key>
-	<string>9.1.0</string>
+	<string>9.2.0</string>
 	<key>DTSDKName</key>
 	<string>iphonesimulator11.2</string>
 </dict>

FirebaseFirestore/FirebaseFirestore.xcframework/ios-arm64_x86_64-maccatalyst/FirebaseFirestore.framework/Headers/FIRFirestore.h

@@ -26,6 +26,7 @@
 @class FIRLoadBundleTaskProgress;
 @class FIRQuery;
 @class FIRTransaction;
+@class FIRTransactionOptions;
 @class FIRWriteBatch;
 
 NS_ASSUME_NONNULL_BEGIN
@@ -146,6 +147,48 @@ NS_SWIFT_NAME(Firestore)
                      completion:(void (^)(id _Nullable result, NSError *_Nullable error))completion
     __attribute__((swift_async(none)));  // Disable async import due to #9426.
 
+/**
+ * Executes the given updateBlock and then attempts to commit the changes applied within an atomic
+ * transaction.
+ *
+ * The maximum number of writes allowed in a single transaction is 500, but note that each usage of
+ * `FieldValue.serverTimestamp()`, `FieldValue.arrayUnion()`, `FieldValue.arrayRemove()`, or
+ * `FieldValue.increment()` inside a transaction counts as an additional write.
+ *
+ * In the updateBlock, a set of reads and writes can be performed atomically using the
+ * `Transaction` object passed to the block. After the updateBlock is run, Firestore will attempt
+ * to apply the changes to the server. If any of the data read has been modified outside of this
+ * transaction since being read, then the transaction will be retried by executing the updateBlock
+ * again. If the transaction still fails after the attempting the number of times specified by the
+ * `max_attempts` property of the given `TransactionOptions` object, then the transaction will fail.
+ * If the given `TransactionOptions` is `nil`, then the default `max_attempts` of 5 will be used.
+ *
+ * Since the updateBlock may be executed multiple times, it should avoiding doing anything that
+ * would cause side effects.
+ *
+ * Any value maybe be returned from the updateBlock. If the transaction is successfully committed,
+ * then the completion block will be passed that value. The updateBlock also has an `NSErrorPointer`
+ * out parameter. If this is set, then the transaction will not attempt to commit, and the given
+ * error will be passed to the completion block.
+ *
+ * The `Transaction` object passed to the updateBlock contains methods for accessing documents
+ * and collections. Unlike other firestore access, data accessed with the transaction will not
+ * reflect local changes that have not been committed. For this reason, it is required that all
+ * reads are performed before any writes. Transactions must be performed while online. Otherwise,
+ * reads will fail, the final commit will fail, and the completion block will return an error.
+ *
+ * @param options The transaction options for controlling execution, or `nil` to use the default
+ *     transaction options.
+ * @param updateBlock The block to execute within the transaction context.
+ * @param completion The block to call with the result or error of the transaction. This
+ *     block will run even if the client is offline, unless the process is killed.
+ */
+- (void)runTransactionWithOptions:(FIRTransactionOptions *_Nullable)options
+                            block:(id _Nullable (^)(FIRTransaction *, NSError **))updateBlock
+                       completion:
+                           (void (^)(id _Nullable result, NSError *_Nullable error))completion
+    __attribute__((swift_async(none)));  // Disable async import due to #9426.
+
 /**
  * Creates a write batch, used for performing multiple writes as a single
  * atomic operation.

FirebaseFirestore/FirebaseFirestore.xcframework/ios-arm64_x86_64-maccatalyst/FirebaseFirestore.framework/Headers/FIRTransactionOptions.h

@@ -0,0 +1,40 @@
+/*
+ * Copyright 2022 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 <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ * Options to customize the behavior of `Firestore.runTransactionWithOptions()`.
+ */
+NS_SWIFT_NAME(TransactionOptions)
+@interface FIRTransactionOptions : NSObject <NSCopying>
+
+/**
+ * Creates and returns a new `TransactionOptions` object with all properties initialized to their
+ * default values.
+ *
+ * @return The created `TransactionOptions` object.
+ */
+- (instancetype)init NS_DESIGNATED_INITIALIZER;
+
+/** The maximum number of attempts to commit, after which transaction fails. Default is 5. */
+@property(nonatomic, assign) NSInteger maxAttempts;
+
+@end
+
+NS_ASSUME_NONNULL_END

FirebaseFirestore/FirebaseFirestore.xcframework/ios-arm64_x86_64-maccatalyst/FirebaseFirestore.framework/Headers/FirebaseFirestore-umbrella.h

@@ -29,6 +29,7 @@
 #import "FIRSnapshotMetadata.h"
 #import "FIRTimestamp.h"
 #import "FIRTransaction.h"
+#import "FIRTransactionOptions.h"
 #import "FIRWriteBatch.h"
 
 FOUNDATION_EXPORT double FirebaseFirestoreVersionNumber;

FirebaseFirestore/FirebaseFirestore.xcframework/ios-arm64_x86_64-maccatalyst/FirebaseFirestore.framework/Headers/FirebaseFirestore.h

@@ -31,4 +31,5 @@
 #import "FIRSnapshotMetadata.h"
 #import "FIRTimestamp.h"
 #import "FIRTransaction.h"
+#import "FIRTransactionOptions.h"
 #import "FIRWriteBatch.h"

FirebaseFirestore/FirebaseFirestore.xcframework/ios-arm64_x86_64-maccatalyst/FirebaseFirestore.framework/Info.plist

@@ -13,7 +13,7 @@
 	<key>CFBundlePackageType</key>
 	<string>FMWK</string>
 	<key>CFBundleVersion</key>
-	<string>9.1.0</string>
+	<string>9.2.0</string>
 	<key>DTSDKName</key>
 	<string>iphonesimulator11.2</string>
 </dict>