@react-native-firebase/auth 26.3.3 → 27.0.0

package/ios/RNFBAuth/RNFBAuthListenerRegistry.m

@@ -0,0 +1,83 @@
+/**
+ * Copyright (c) 2016-present Invertase Limited & Contributors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this library 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 "RNFBAuthListenerRegistry.h"
+
+#if __has_include("RNFBHandleMap.h")
+#import "RNFBHandleMap.h"
+#else
+#import "RNFBApp/RNFBHandleMap.h"
+#endif
+
+#if __has_include(<RNFBAuth/RNFBAuth-Swift.h>)
+#import <RNFBAuth/RNFBAuth-Swift.h>
+#elif __has_include("RNFBAuth-Swift.h")
+#import "RNFBAuth-Swift.h"
+#elif __has_include("RNFBHandleMapStorage-Swift.inc")
+#import "RNFBHandleMapStorage-Swift.inc"
+#else
+#error "RNFBAuthListenerRegistryStorage Swift interface not found"
+#endif
+
+@interface RNFBAuthListenerRegistry ()
+@property(nonatomic, strong) RNFBAuthListenerRegistryStorage *storage;
+@end
+
+@implementation RNFBAuthListenerRegistry
+
+- (instancetype)init {
+  self = [super init];
+  if (self) {
+    _storage = [[RNFBAuthListenerRegistryStorage alloc] init];
+  }
+  return self;
+}
+
+- (BOOL)put:(id)key value:(id)value error:(NSError **)error {
+  if (![self.storage putIfAbsent:key value:value]) {
+    if (error != nil) {
+      NSString *message = [NSString stringWithFormat:@"Handle id already registered: %@", key];
+      *error = [NSError errorWithDomain:RNFBHandleMapErrorDomain
+                                   code:RNFBHandleMapErrorCollision
+                               userInfo:@{NSLocalizedDescriptionKey : message}];
+    }
+    return NO;
+  }
+  return YES;
+}
+
+- (BOOL)putOrDiscard:(id)key value:(id)value {
+  return [self.storage putOrDiscard:key value:value];
+}
+
+- (id)get:(id)key {
+  return [self.storage get:key];
+}
+
+- (id)take:(id)key {
+  return [self.storage take:key];
+}
+
+- (void)takeAndRemove:(id)key {
+  [self.storage takeAndRemove:key];
+}
+
+- (void)removeAll {
+  [self.storage removeAll];
+}
+
+@end

package/ios/RNFBAuth/RNFBAuthListenerRegistryStorage.swift

@@ -0,0 +1,76 @@
+/**
+ * Copyright (c) 2016-present Invertase Limited & Contributors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this library 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
+
+#if canImport(RNFBApp)
+import RNFBApp
+#endif
+
+/// Auth-state / id-token listener map storage. Composes `RNFBHandleMapStorage`.
+/// `putOrDiscard` is first-wins and calls `remove` on the incoming value on collision.
+/// Unique `put` collision errors stay on the ObjC façade.
+@objc(RNFBAuthListenerRegistryStorage)
+public final class RNFBAuthListenerRegistryStorage: NSObject {
+  private static let removeSelector = Selector(("remove"))
+
+  private let storage = RNFBHandleMapStorage()
+
+  private func removeHandle(_ handle: AnyObject?) {
+    guard let handle = handle, handle.responds(to: Self.removeSelector) else {
+      return
+    }
+    _ = handle.perform(Self.removeSelector)
+  }
+
+  /// First-wins store without discarding the incoming value. Used by façade `put`.
+  @objc(putIfAbsent:value:)
+  public func putIfAbsent(_ key: AnyObject, value: AnyObject) -> Bool {
+    storage.putIfAbsent(key, value: value)
+  }
+
+  /// Unique put. On collision, `remove`s the incoming value and leaves the existing mapping.
+  @objc(putOrDiscard:value:)
+  public func putOrDiscard(_ key: AnyObject, value: AnyObject) -> Bool {
+    if storage.putIfAbsent(key, value: value) {
+      return true
+    }
+    removeHandle(value)
+    return false
+  }
+
+  @objc(get:)
+  public func get(_ key: AnyObject) -> AnyObject? {
+    storage.get(key)
+  }
+
+  @objc(take:)
+  public func take(_ key: AnyObject) -> AnyObject? {
+    storage.take(key)
+  }
+
+  @objc(takeAndRemove:)
+  public func takeAndRemove(_ key: AnyObject) {
+    removeHandle(storage.take(key))
+  }
+
+  @objc
+  public func removeAll() {
+    for handle in storage.takeAll() {
+      removeHandle(handle)
+    }
+  }
+}

package/ios/RNFBAuth/RNFBAuthNullSentinelDecoder.h

@@ -0,0 +1,40 @@
+/**
+ * Copyright (c) 2016-present Invertase Limited & Contributors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this library 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>
+
+/**
+ * Decodes New Architecture null sentinels for updateProfile. Foundation only so unit tests can
+ * compile it without the Firebase SDK.
+ */
+@interface RNFBAuthNullSentinelDecoder : NSObject
+
+/**
+ * Decode sentinels and turn NSNull into nil before profileChangeRequest writes.
+ * FIRUserProfileChangeRequest clears a field when the property is set to nil (not the same as
+ * leaving it unassigned). NSDictionary cannot store nil, so cleared keys are omitted and
+ * subscript returns nil, the same value updateProfile reads.
+ * displayName/photoURL null arrive as { __rnfbNull: true } and/or NSNull after decode.
+ */
++ (NSDictionary *)decodedProfileProps:(NSDictionary *)props;
+
+/**
+ * photoURL clear arm: omitted/nil decoded value must become nil (not @""), not URLWithString:.
+ */
++ (NSURL *)photoURLFromDecodedValue:(id)value;
+
+@end

package/ios/RNFBAuth/RNFBAuthNullSentinelDecoder.m

@@ -0,0 +1,49 @@
+/**
+ * Copyright (c) 2016-present Invertase Limited & Contributors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this library 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 "RNFBAuthNullSentinelDecoder.h"
+
+#if __has_include(<RNFBApp/RNFBApp-Swift.h>)
+#import <RNFBApp/RNFBApp-Swift.h>
+#elif __has_include("RNFBApp-Swift.h")
+#import "RNFBApp-Swift.h"
+#elif __has_include("RNFBHandleMapStorage-Swift.inc")
+#import "RNFBHandleMapStorage-Swift.inc"
+#else
+#error "RNFBApp Swift interface not found"
+#endif
+
+@implementation RNFBAuthNullSentinelDecoder
+
++ (NSDictionary *)decodedProfileProps:(NSDictionary *)props {
+  NSDictionary *decoded = [RNFBNullSentinelDecoder decodeNullSentinels:props];
+  NSMutableDictionary *normalized = [NSMutableDictionary dictionaryWithCapacity:decoded.count];
+  for (NSString *key in decoded) {
+    id value = decoded[key];
+    if (value == [NSNull null]) {
+      continue;
+    }
+    normalized[key] = value;
+  }
+  return normalized;
+}
+
++ (NSURL *)photoURLFromDecodedValue:(id)value {
+  return value == nil ? nil : [NSURL URLWithString:value];
+}
+
+@end

package/ios/RNFBAuth.xcodeproj/project.pbxproj

@@ -8,6 +8,10 @@
 
 /* Begin PBXBuildFile section */
 		2744B98621F45429004F8E3F /* RNFBAuthModule.mm in Sources */ = {isa = PBXBuildFile; fileRef = 2744B98521F45429004F8E3F /* RNFBAuthModule.mm */; };
+		RNFBAUTH0000000000000001 /* RNFBAuthCacheRegistry.m in Sources */ = {isa = PBXBuildFile; fileRef = RNFBAUTH0000000000000002 /* RNFBAuthCacheRegistry.m */; };
+		RNFBAUTH0000000000000003 /* RNFBAuthCacheRegistryStorage.swift in Sources */ = {isa = PBXBuildFile; fileRef = RNFBAUTH0000000000000004 /* RNFBAuthCacheRegistryStorage.swift */; };
+		RNFBAUTH0000000000000008 /* RNFBAuthListenerRegistryStorage.swift in Sources */ = {isa = PBXBuildFile; fileRef = RNFBAUTH0000000000000009 /* RNFBAuthListenerRegistryStorage.swift */; };
+		RNFBAUTH000000000000000A /* RNFBAuthErrorCodeMapper.swift in Sources */ = {isa = PBXBuildFile; fileRef = RNFBAUTH000000000000000B /* RNFBAuthErrorCodeMapper.swift */; };
 /* End PBXBuildFile section */
 
 /* Begin PBXCopyFilesBuildPhase section */
@@ -26,6 +30,11 @@
 		2744B98221F45429004F8E3F /* libRNFBAuth.a */ = {isa = PBXFileReference; explicitFileType = archive.ar; includeInIndex = 0; path = libRNFBAuth.a; sourceTree = BUILT_PRODUCTS_DIR; };
 		2744B98421F45429004F8E3F /* RNFBAuthModule.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; name = RNFBAuthModule.h; path = RNFBAuth/RNFBAuthModule.h; sourceTree = SOURCE_ROOT; };
 		2744B98521F45429004F8E3F /* RNFBAuthModule.mm */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.cpp.objcpp; name = RNFBAuthModule.mm; path = RNFBAuth/RNFBAuthModule.mm; sourceTree = SOURCE_ROOT; };
+		RNFBAUTH0000000000000005 /* RNFBAuthCacheRegistry.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; name = RNFBAuthCacheRegistry.h; path = RNFBAuth/RNFBAuthCacheRegistry.h; sourceTree = SOURCE_ROOT; };
+		RNFBAUTH0000000000000002 /* RNFBAuthCacheRegistry.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; name = RNFBAuthCacheRegistry.m; path = RNFBAuth/RNFBAuthCacheRegistry.m; sourceTree = SOURCE_ROOT; };
+		RNFBAUTH0000000000000004 /* RNFBAuthCacheRegistryStorage.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; name = RNFBAuthCacheRegistryStorage.swift; path = RNFBAuth/RNFBAuthCacheRegistryStorage.swift; sourceTree = SOURCE_ROOT; };
+		RNFBAUTH0000000000000009 /* RNFBAuthListenerRegistryStorage.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; name = RNFBAuthListenerRegistryStorage.swift; path = RNFBAuth/RNFBAuthListenerRegistryStorage.swift; sourceTree = SOURCE_ROOT; };
+		RNFBAUTH000000000000000B /* RNFBAuthErrorCodeMapper.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; name = RNFBAuthErrorCodeMapper.swift; path = RNFBAuth/RNFBAuthErrorCodeMapper.swift; sourceTree = SOURCE_ROOT; };
 /* End PBXFileReference section */
 
 /* Begin PBXFrameworksBuildPhase section */
@@ -52,6 +61,11 @@
 			children = (
 				2744B9A121F48736004F8E3F /* converters */,
 				2744B98C21F45C64004F8E3F /* common */,
+				RNFBAUTH0000000000000005 /* RNFBAuthCacheRegistry.h */,
+				RNFBAUTH0000000000000002 /* RNFBAuthCacheRegistry.m */,
+				RNFBAUTH0000000000000004 /* RNFBAuthCacheRegistryStorage.swift */,
+				RNFBAUTH0000000000000009 /* RNFBAuthListenerRegistryStorage.swift */,
+				RNFBAUTH000000000000000B /* RNFBAuthErrorCodeMapper.swift */,
 				2744B98421F45429004F8E3F /* RNFBAuthModule.h */,
 				2744B98521F45429004F8E3F /* RNFBAuthModule.mm */,
 			);
@@ -124,6 +138,10 @@
 			isa = PBXSourcesBuildPhase;
 			buildActionMask = 2147483647;
 			files = (
+				RNFBAUTH0000000000000003 /* RNFBAuthCacheRegistryStorage.swift in Sources */,
+				RNFBAUTH0000000000000001 /* RNFBAuthCacheRegistry.m in Sources */,
+				RNFBAUTH0000000000000008 /* RNFBAuthListenerRegistryStorage.swift in Sources */,
+				RNFBAUTH000000000000000A /* RNFBAuthErrorCodeMapper.swift in Sources */,
 				2744B98621F45429004F8E3F /* RNFBAuthModule.mm in Sources */,
 			);
 			runOnlyForDeploymentPostprocessing = 0;
@@ -150,6 +168,7 @@
 				CODE_SIGN_STYLE = Automatic;
 				COPY_PHASE_STRIP = NO;
 				DEBUG_INFORMATION_FORMAT = dwarf;
+				DEFINES_MODULE = YES;
 				GCC_C_LANGUAGE_STANDARD = gnu11;
 				GCC_DYNAMIC_NO_PIC = NO;
 				GCC_OPTIMIZATION_LEVEL = 0;
@@ -166,6 +185,7 @@
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				SDKROOT = iphoneos;
 				SKIP_INSTALL = YES;
+				SWIFT_VERSION = 5.10;
 				TARGETED_DEVICE_FAMILY = "1,2";
 			};
 			name = Debug;
@@ -189,6 +209,7 @@
 				CODE_SIGN_STYLE = Automatic;
 				COPY_PHASE_STRIP = NO;
 				DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym";
+				DEFINES_MODULE = YES;
 				ENABLE_NS_ASSERTIONS = NO;
 				GCC_C_LANGUAGE_STANDARD = gnu11;
 				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
@@ -200,6 +221,7 @@
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				SDKROOT = iphoneos;
 				SKIP_INSTALL = YES;
+				SWIFT_VERSION = 5.10;
 				TARGETED_DEVICE_FAMILY = "1,2";
 				VALIDATE_PRODUCT = YES;
 			};

package/ios/RNFBAuthUnitTests/RNFBAuthCacheRegistryStorageTests.swift

@@ -0,0 +1,72 @@
+/**
+ * Copyright (c) 2016-present Invertase Limited & Contributors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this library 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 XCTest
+
+final class RNFBAuthCacheRegistryStorageTests: XCTestCase {
+  private var storage: RNFBAuthCacheRegistryStorage!
+
+  override func setUp() {
+    super.setUp()
+    storage = RNFBAuthCacheRegistryStorage()
+  }
+
+  func testPutOrDiscard_storesWhenFree() {
+    XCTAssertTrue(storage.putOrDiscard("k1" as NSString, value: "payload" as NSString))
+    XCTAssertEqual(storage.get("k1" as NSString) as? NSString, "payload")
+  }
+
+  func testPutOrDiscard_collision_keepsExisting() {
+    XCTAssertTrue(storage.putOrDiscard("k1" as NSString, value: "first" as NSString))
+    XCTAssertFalse(storage.putOrDiscard("k1" as NSString, value: "second" as NSString))
+    XCTAssertEqual(storage.get("k1" as NSString) as? NSString, "first")
+  }
+
+  func testPutReplacing_whenFree_returnsNil() {
+    XCTAssertNil(storage.putReplacing("k1" as NSString, value: "payload" as NSString))
+    XCTAssertEqual(storage.get("k1" as NSString) as? NSString, "payload")
+  }
+
+  func testPutReplacing_whenOccupied_returnsDisplaced() {
+    XCTAssertTrue(storage.putOrDiscard("k1" as NSString, value: "first" as NSString))
+    let displaced = storage.putReplacing("k1" as NSString, value: "second" as NSString)
+    XCTAssertEqual(displaced as? NSString, "first")
+    XCTAssertEqual(storage.get("k1" as NSString) as? NSString, "second")
+  }
+
+  func testGet_whenFree_isNil() {
+    XCTAssertNil(storage.get("missing" as NSString))
+  }
+
+  func testTake_removesAndReturns() {
+    XCTAssertTrue(storage.putOrDiscard("k1" as NSString, value: "payload" as NSString))
+    XCTAssertEqual(storage.take("k1" as NSString) as? NSString, "payload")
+    XCTAssertNil(storage.get("k1" as NSString))
+  }
+
+  func testTake_whenFree_isNil() {
+    XCTAssertNil(storage.take("missing" as NSString))
+  }
+
+  func testTakeAll_returnsSnapshotAndLeavesEmpty() {
+    XCTAssertTrue(storage.putOrDiscard("a" as NSString, value: "1" as NSString))
+    XCTAssertTrue(storage.putOrDiscard("b" as NSString, value: "2" as NSString))
+    let remaining = storage.takeAll()
+    XCTAssertEqual(remaining.count, 2)
+    XCTAssertNil(storage.get("a" as NSString))
+    XCTAssertNil(storage.get("b" as NSString))
+  }
+}

package/ios/RNFBAuthUnitTests/RNFBAuthCacheRegistryTests.m

@@ -0,0 +1,131 @@
+/**
+ * Copyright (c) 2016-present Invertase Limited & Contributors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this library 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 <XCTest/XCTest.h>
+
+#import "RNFBAuthCacheRegistry.h"
+#import "RNFBHandleMap.h"
+
+@interface RNFBAuthCacheRegistryTests : XCTestCase
+@property(nonatomic, strong) RNFBAuthCacheRegistry *registry;
+@end
+
+@implementation RNFBAuthCacheRegistryTests
+
+- (void)setUp {
+  [super setUp];
+  self.registry = [[RNFBAuthCacheRegistry alloc] init];
+}
+
+- (void)testPutGetTake_happyPath {
+  NSError *error = nil;
+  XCTAssertTrue([self.registry put:@"k1" value:@"payload" error:&error]);
+  XCTAssertNil(error);
+  XCTAssertEqualObjects(@"payload", [self.registry get:@"k1"]);
+  XCTAssertEqualObjects(@"payload", [self.registry take:@"k1"]);
+  XCTAssertNil([self.registry get:@"k1"]);
+}
+
+- (void)testPut_occupiedId_returnsCollision {
+  XCTAssertTrue([self.registry put:@"k1" value:@"first" error:nil]);
+
+  NSError *error = nil;
+  XCTAssertFalse([self.registry put:@"k1" value:@"second" error:&error]);
+  XCTAssertNotNil(error);
+  XCTAssertEqualObjects(error.domain, RNFBHandleMapErrorDomain);
+  XCTAssertEqual(error.code, RNFBHandleMapErrorCollision);
+  XCTAssertEqualObjects(@"first", [self.registry get:@"k1"]);
+}
+
+- (void)testPut_occupiedId_nilErrorOut_returnsNo {
+  XCTAssertTrue([self.registry put:@"k1" value:@"first" error:nil]);
+  XCTAssertFalse([self.registry put:@"k1" value:@"second" error:nil]);
+  XCTAssertEqualObjects(@"first", [self.registry get:@"k1"]);
+}
+
+- (void)testGet_whenFree_isNil {
+  XCTAssertNil([self.registry get:@"missing"]);
+}
+
+- (void)testTake_whenFree_isNil {
+  XCTAssertNil([self.registry take:@"missing"]);
+}
+
+- (void)testPutOrDiscard_storesWhenFree {
+  XCTAssertTrue([self.registry putOrDiscard:@"k1" value:@"payload"]);
+  XCTAssertEqualObjects(@"payload", [self.registry get:@"k1"]);
+}
+
+- (void)testPutOrDiscard_collision_keepsExisting {
+  XCTAssertTrue([self.registry put:@"k1" value:@"first" error:nil]);
+  XCTAssertFalse([self.registry putOrDiscard:@"k1" value:@"second"]);
+  XCTAssertEqualObjects(@"first", [self.registry get:@"k1"]);
+}
+
+- (void)testPutReplacing_whenFree_stores {
+  XCTAssertTrue([self.registry putReplacing:@"k1" value:@"payload"]);
+  XCTAssertEqualObjects(@"payload", [self.registry get:@"k1"]);
+}
+
+- (void)testPutReplacing_whenOccupied_replacesLastWins {
+  XCTAssertTrue([self.registry put:@"k1" value:@"first" error:nil]);
+  XCTAssertTrue([self.registry putReplacing:@"k1" value:@"second"]);
+  XCTAssertEqualObjects(@"second", [self.registry get:@"k1"]);
+}
+
+- (void)testPutReplacing_sameIdFromTwoThreads_lastWins {
+  XCTAssertTrue([self.registry put:@"k1" value:@"first" error:nil]);
+
+  dispatch_group_t group = dispatch_group_create();
+  dispatch_group_enter(group);
+  dispatch_group_enter(group);
+
+  dispatch_async(dispatch_get_global_queue(QOS_CLASS_USER_INITIATED, 0), ^{
+    [self.registry putReplacing:@"k1" value:@"second"];
+    dispatch_group_leave(group);
+  });
+  dispatch_async(dispatch_get_global_queue(QOS_CLASS_USER_INITIATED, 0), ^{
+    [self.registry putReplacing:@"k1" value:@"third"];
+    dispatch_group_leave(group);
+  });
+
+  dispatch_group_wait(group, dispatch_time(DISPATCH_TIME_NOW, 5 * NSEC_PER_SEC));
+  id stored = [self.registry get:@"k1"];
+  XCTAssertTrue([stored isEqual:@"second"] || [stored isEqual:@"third"]);
+}
+
+- (void)testPut_afterTake_allowsReuse {
+  XCTAssertTrue([self.registry put:@"k1" value:@"first" error:nil]);
+  XCTAssertEqualObjects(@"first", [self.registry take:@"k1"]);
+  XCTAssertTrue([self.registry put:@"k1" value:@"second" error:nil]);
+  XCTAssertEqualObjects(@"second", [self.registry get:@"k1"]);
+}
+
+- (void)testClear_removesAll {
+  XCTAssertTrue([self.registry put:@"a" value:@"1" error:nil]);
+  XCTAssertTrue([self.registry put:@"b" value:@"2" error:nil]);
+  [self.registry clear];
+  XCTAssertNil([self.registry get:@"a"]);
+  XCTAssertNil([self.registry get:@"b"]);
+}
+
+- (void)testClear_empty_isNoOp {
+  [self.registry clear];
+  XCTAssertNil([self.registry get:@"k1"]);
+}
+
+@end