@react-native-firebase/database 26.3.3 → 27.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (77) hide show
  1. package/CHANGELOG.md +27 -0
  2. package/RNFBDatabase.podspec +10 -2
  3. package/android/build.gradle +7 -0
  4. package/android/src/main/java/io/invertase/firebase/database/DatabaseAbortable.java +22 -0
  5. package/android/src/main/java/io/invertase/firebase/database/DatabaseQueryHandle.java +24 -0
  6. package/android/src/main/java/io/invertase/firebase/database/RNFBDatabaseKeepSyncedRegistry.java +106 -0
  7. package/android/src/main/java/io/invertase/firebase/database/RNFBDatabaseListenerRegistry.kt +133 -0
  8. package/android/src/main/java/io/invertase/firebase/database/RNFBDatabaseQueryRegistry.kt +76 -0
  9. package/android/src/main/java/io/invertase/firebase/database/RNFBDatabaseTransactionRegistry.kt +67 -0
  10. package/android/src/main/java/io/invertase/firebase/database/UniversalFirebaseDatabaseOnDisconnectModule.java +102 -9
  11. package/android/src/reactnative/java/io/invertase/firebase/database/NativeRNFBTurboDatabaseOnDisconnect.java +6 -11
  12. package/android/src/reactnative/java/io/invertase/firebase/database/NativeRNFBTurboDatabaseQuery.java +111 -24
  13. package/android/src/reactnative/java/io/invertase/firebase/database/NativeRNFBTurboDatabaseTransaction.java +12 -25
  14. package/android/src/reactnative/java/io/invertase/firebase/database/ReactNativeFirebaseDatabaseQuery.java +30 -33
  15. package/android/src/reactnative/java/io/invertase/firebase/database/ReactNativeFirebaseDatabaseTransactionHandler.java +3 -3
  16. package/android/src/reactnative/java/io/invertase/firebase/database/generated/java/com/facebook/fbreact/specs/NativeRNFBTurboDatabaseQuerySpec.java +4 -0
  17. package/android/src/reactnative/java/io/invertase/firebase/database/generated/jni/RNFBDatabaseTurboModules-generated.cpp +6 -0
  18. package/android/src/reactnative/java/io/invertase/firebase/database/generated/jni/react/renderer/components/RNFBDatabaseTurboModules/RNFBDatabaseTurboModulesJSI.h +12 -0
  19. package/android/src/test/java/io/invertase/firebase/database/RNFBDatabaseKeepSyncedRegistryTest.java +174 -0
  20. package/android/src/test/java/io/invertase/firebase/database/RNFBDatabaseListenerRegistryTest.java +191 -0
  21. package/android/src/test/java/io/invertase/firebase/database/RNFBDatabaseQueryRegistryTest.java +489 -0
  22. package/android/src/test/java/io/invertase/firebase/database/RNFBDatabaseTransactionRegistryTest.java +199 -0
  23. package/android/src/test/java/io/invertase/firebase/database/UniversalFirebaseDatabaseOnDisconnectCancelErrorTest.java +137 -0
  24. package/dist/module/DatabaseQuery.js +52 -1
  25. package/dist/module/DatabaseQuery.js.map +1 -1
  26. package/dist/module/DatabaseSyncTree.js +1 -1
  27. package/dist/module/DatabaseSyncTree.js.map +1 -1
  28. package/dist/module/index.js +1 -2
  29. package/dist/module/index.js.map +1 -1
  30. package/dist/module/modular/query.js +1 -1
  31. package/dist/module/modular/query.js.map +1 -1
  32. package/dist/module/version.js +1 -1
  33. package/dist/module/web/RNFBDatabaseModule.js +7 -0
  34. package/dist/module/web/RNFBDatabaseModule.js.map +1 -1
  35. package/dist/typescript/lib/DatabaseQuery.d.ts +25 -0
  36. package/dist/typescript/lib/DatabaseQuery.d.ts.map +1 -1
  37. package/dist/typescript/lib/index.d.ts +1 -1
  38. package/dist/typescript/lib/types/internal.d.ts +2 -0
  39. package/dist/typescript/lib/types/internal.d.ts.map +1 -1
  40. package/dist/typescript/lib/version.d.ts +1 -1
  41. package/dist/typescript/lib/web/RNFBDatabaseModule.d.ts.map +1 -1
  42. package/ios/RNFBDatabase/RNFBDatabaseListenerRegistry.h +37 -0
  43. package/ios/RNFBDatabase/RNFBDatabaseListenerRegistry.m +91 -0
  44. package/ios/RNFBDatabase/RNFBDatabaseListenerRegistryStorage.swift +81 -0
  45. package/ios/RNFBDatabase/RNFBDatabaseNullSentinelDecoder.h +36 -0
  46. package/ios/RNFBDatabase/RNFBDatabaseNullSentinelDecoder.m +48 -0
  47. package/ios/RNFBDatabase/RNFBDatabaseOnDisconnectHelper.m +29 -26
  48. package/ios/RNFBDatabase/RNFBDatabaseQuery.h +3 -2
  49. package/ios/RNFBDatabase/RNFBDatabaseQuery.m +14 -13
  50. package/ios/RNFBDatabase/RNFBDatabaseQueryHelper.h +7 -0
  51. package/ios/RNFBDatabase/RNFBDatabaseQueryHelper.m +44 -21
  52. package/ios/RNFBDatabase/RNFBDatabaseQueryModule.mm +14 -0
  53. package/ios/RNFBDatabase/RNFBDatabaseQueryRegistry.h +37 -0
  54. package/ios/RNFBDatabase/RNFBDatabaseQueryRegistry.m +79 -0
  55. package/ios/RNFBDatabase/RNFBDatabaseQueryRegistryStorage.swift +104 -0
  56. package/ios/RNFBDatabase/RNFBDatabaseReferenceHelper.m +14 -12
  57. package/ios/RNFBDatabase/RNFBDatabaseTransactionHelper.m +3 -1
  58. package/ios/RNFBDatabase.xcodeproj/project.pbxproj +12 -0
  59. package/ios/RNFBDatabaseUnitTests/RNFBDatabaseListenerRegistryStorageTests.swift +86 -0
  60. package/ios/RNFBDatabaseUnitTests/RNFBDatabaseListenerRegistryTests.m +90 -0
  61. package/ios/RNFBDatabaseUnitTests/RNFBDatabaseNullSentinelDecodeTests.m +118 -0
  62. package/ios/RNFBDatabaseUnitTests/RNFBDatabaseQueryRegistryStorageTests.swift +181 -0
  63. package/ios/RNFBDatabaseUnitTests/RNFBDatabaseQueryRegistryTests.m +390 -0
  64. package/ios/RNFBDatabaseUnitTests/RNFBDatabaseUnitTests.xcodeproj/project.pbxproj +303 -0
  65. package/ios/RNFBDatabaseUnitTests/RNFBDatabaseUnitTests.xcodeproj/xcshareddata/xcschemes/RNFBDatabaseUnitTests.xcscheme +69 -0
  66. package/ios/generated/RNFBDatabaseTurboModules/RNFBDatabaseTurboModules-generated.mm +7 -0
  67. package/ios/generated/RNFBDatabaseTurboModules/RNFBDatabaseTurboModules.h +6 -0
  68. package/ios/generated/RNFBDatabaseTurboModulesJSI.h +12 -0
  69. package/lib/DatabaseQuery.ts +56 -0
  70. package/lib/DatabaseSyncTree.ts +1 -1
  71. package/lib/index.ts +1 -1
  72. package/lib/modular/query.ts +1 -1
  73. package/lib/types/internal.ts +2 -0
  74. package/lib/version.ts +1 -1
  75. package/lib/web/RNFBDatabaseModule.ts +13 -0
  76. package/package.json +5 -4
  77. package/specs/NativeRNFBTurboDatabaseQuery.ts +1 -0
@@ -0,0 +1,181 @@
1
+ /**
2
+ * Copyright (c) 2016-present Invertase Limited & Contributors
3
+ *
4
+ * Licensed under the Apache License, Version 2.0 (the "License");
5
+ * you may not use this library except in compliance with the License.
6
+ * You may obtain a copy of the License at
7
+ *
8
+ * http://www.apache.org/licenses/LICENSE-2.0
9
+ *
10
+ * Unless required by applicable law or agreed to in writing, software
11
+ * distributed under the License is distributed on an "AS IS" BASIS,
12
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
+ * See the License for the specific language governing permissions and
14
+ * limitations under the License.
15
+ */
16
+
17
+ import XCTest
18
+
19
+ private final class FakeQueryHandle: NSObject {
20
+ private(set) var removeCount = 0
21
+ var listeners = false
22
+
23
+ @objc func removeAllEventListeners() {
24
+ removeCount += 1
25
+ listeners = false
26
+ }
27
+
28
+ @objc func hasListeners() -> Bool {
29
+ listeners
30
+ }
31
+ }
32
+
33
+ final class RNFBDatabaseQueryRegistryStorageTests: XCTestCase {
34
+ private var storage: RNFBDatabaseQueryRegistryStorage!
35
+
36
+ override func setUp() {
37
+ super.setUp()
38
+ storage = RNFBDatabaseQueryRegistryStorage()
39
+ }
40
+
41
+ func testPutIfAbsent_storesWhenFree() {
42
+ let handle = FakeQueryHandle()
43
+ XCTAssertTrue(storage.putIfAbsent("q1" as NSString, value: handle))
44
+ XCTAssertTrue(storage.get("q1" as NSString) === handle)
45
+ }
46
+
47
+ func testPutIfAbsent_collision_keepsExisting() {
48
+ let first = FakeQueryHandle()
49
+ let second = FakeQueryHandle()
50
+ XCTAssertTrue(storage.putIfAbsent("q1" as NSString, value: first))
51
+ XCTAssertFalse(storage.putIfAbsent("q1" as NSString, value: second))
52
+ XCTAssertTrue(storage.get("q1" as NSString) === first)
53
+ }
54
+
55
+ func testGet_whenFree_isNil() {
56
+ XCTAssertNil(storage.get("missing" as NSString))
57
+ }
58
+
59
+ func testTake_removesWithoutCallingRemove() {
60
+ let handle = FakeQueryHandle()
61
+ XCTAssertTrue(storage.putIfAbsent("q1" as NSString, value: handle))
62
+ XCTAssertTrue(storage.take("q1" as NSString) === handle)
63
+ XCTAssertNil(storage.get("q1" as NSString))
64
+ XCTAssertEqual(handle.removeCount, 0)
65
+ }
66
+
67
+ func testTake_whenFree_isNil() {
68
+ XCTAssertNil(storage.take("missing" as NSString))
69
+ }
70
+
71
+ func testTakeIfIdle_whenNoListeners_takes() {
72
+ let handle = FakeQueryHandle()
73
+ handle.listeners = false
74
+ XCTAssertTrue(storage.putIfAbsent("q" as NSString, value: handle))
75
+ XCTAssertTrue(storage.takeIfIdle("q" as NSString) === handle)
76
+ XCTAssertNil(storage.get("q" as NSString))
77
+ XCTAssertEqual(handle.removeCount, 0)
78
+ }
79
+
80
+ func testTakeIfIdle_whenHasListeners_leavesMapping() {
81
+ let handle = FakeQueryHandle()
82
+ handle.listeners = true
83
+ XCTAssertTrue(storage.putIfAbsent("q" as NSString, value: handle))
84
+ XCTAssertNil(storage.takeIfIdle("q" as NSString))
85
+ XCTAssertTrue(storage.get("q" as NSString) === handle)
86
+ }
87
+
88
+ func testTakeIfIdle_whenMissing_isNil() {
89
+ XCTAssertNil(storage.takeIfIdle("missing" as NSString))
90
+ }
91
+
92
+ func testTakeIfIdle_objectWithoutHasListeners_leavesMapping() {
93
+ let plain = NSObject()
94
+ XCTAssertTrue(storage.putIfAbsent("p" as NSString, value: plain))
95
+ XCTAssertNil(storage.takeIfIdle("p" as NSString))
96
+ XCTAssertTrue(storage.get("p" as NSString) === plain)
97
+ }
98
+
99
+ func testTakeIfIdle_putBackWhenListenersAppearAfterTake() {
100
+ let gated = PutBackGatedQueryHandle()
101
+ gated.listeners = false
102
+ gated.onSecondHasListenersEnter = {
103
+ gated.listeners = true
104
+ }
105
+ XCTAssertTrue(storage.putIfAbsent("g" as NSString, value: gated))
106
+ XCTAssertNil(storage.takeIfIdle("g" as NSString))
107
+ XCTAssertTrue(storage.get("g" as NSString) === gated)
108
+ XCTAssertEqual(gated.callCount, 2)
109
+ XCTAssertEqual(gated.removeCount, 0)
110
+ }
111
+
112
+ func testTakeIfIdle_putBackFails_clearsOrphanListeners() {
113
+ let orphan = PutBackGatedQueryHandle()
114
+ orphan.listeners = false
115
+ XCTAssertTrue(storage.putIfAbsent("q" as NSString, value: orphan))
116
+
117
+ let replacement = FakeQueryHandle()
118
+ replacement.listeners = true
119
+ orphan.onSecondHasListenersEnter = { [weak self] in
120
+ guard let self = self else { return }
121
+ XCTAssertTrue(self.storage.putIfAbsent("q" as NSString, value: replacement))
122
+ orphan.listeners = true
123
+ }
124
+
125
+ XCTAssertNil(storage.takeIfIdle("q" as NSString))
126
+ XCTAssertTrue(storage.get("q" as NSString) === replacement)
127
+ XCTAssertEqual(orphan.removeCount, 1)
128
+ XCTAssertFalse(orphan.listeners)
129
+ XCTAssertEqual(replacement.removeCount, 0)
130
+ }
131
+
132
+ func testRemoveAll_removesSnapshotAndLeavesEmpty() {
133
+ let a = FakeQueryHandle()
134
+ let b = FakeQueryHandle()
135
+ XCTAssertTrue(storage.putIfAbsent("a" as NSString, value: a))
136
+ XCTAssertTrue(storage.putIfAbsent("b" as NSString, value: b))
137
+ storage.removeAll()
138
+ XCTAssertEqual(a.removeCount, 1)
139
+ XCTAssertEqual(b.removeCount, 1)
140
+ XCTAssertNil(storage.get("a" as NSString))
141
+ XCTAssertNil(storage.get("b" as NSString))
142
+ }
143
+
144
+ func testRemoveAll_objectWithoutRemove_doesNotCrash() {
145
+ let plain = NSObject()
146
+ XCTAssertTrue(storage.putIfAbsent("p" as NSString, value: plain))
147
+ storage.removeAll()
148
+ XCTAssertNil(storage.get("p" as NSString))
149
+ }
150
+
151
+ func testPut_afterTake_allowsReuse() {
152
+ let first = FakeQueryHandle()
153
+ let second = FakeQueryHandle()
154
+ XCTAssertTrue(storage.putIfAbsent("q1" as NSString, value: first))
155
+ XCTAssertTrue(storage.take("q1" as NSString) === first)
156
+ XCTAssertTrue(storage.putIfAbsent("q1" as NSString, value: second))
157
+ XCTAssertTrue(storage.get("q1" as NSString) === second)
158
+ }
159
+ }
160
+
161
+ /// First `hasListeners` returns idle; second returns `listeners` (settable between calls).
162
+ private final class PutBackGatedQueryHandle: NSObject {
163
+ private(set) var removeCount = 0
164
+ private(set) var callCount = 0
165
+ var listeners = false
166
+ var onSecondHasListenersEnter: (() -> Void)?
167
+
168
+ @objc func removeAllEventListeners() {
169
+ removeCount += 1
170
+ listeners = false
171
+ }
172
+
173
+ @objc func hasListeners() -> Bool {
174
+ callCount += 1
175
+ if callCount == 1 {
176
+ return false
177
+ }
178
+ onSecondHasListenersEnter?()
179
+ return listeners
180
+ }
181
+ }
@@ -0,0 +1,390 @@
1
+ /**
2
+ * Copyright (c) 2016-present Invertase Limited & Contributors
3
+ *
4
+ * Licensed under the Apache License, Version 2.0 (the "License");
5
+ * you may not use this library except in compliance with the License.
6
+ * You may obtain a copy of the License at
7
+ *
8
+ * http://www.apache.org/licenses/LICENSE-2.0
9
+ *
10
+ * Unless required by applicable law or agreed to in writing, software
11
+ * distributed under the License is distributed on an "AS IS" BASIS,
12
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
+ * See the License for the specific language governing permissions and
14
+ * limitations under the License.
15
+ *
16
+ */
17
+
18
+ #import <XCTest/XCTest.h>
19
+
20
+ #import "RNFBDatabaseQueryRegistry.h"
21
+ #import "RNFBHandleMap.h"
22
+
23
+ @interface GatedFakeDatabaseQuery : NSObject
24
+ @property(nonatomic, assign) BOOL listeners;
25
+ @property(nonatomic, strong) dispatch_semaphore_t hasListenersEntered;
26
+ @property(nonatomic, strong) dispatch_semaphore_t allowHasListenersReturn;
27
+ - (void)removeAllEventListeners;
28
+ - (BOOL)hasListeners;
29
+ @end
30
+
31
+ @implementation GatedFakeDatabaseQuery
32
+ - (instancetype)init {
33
+ self = [super init];
34
+ if (self) {
35
+ _hasListenersEntered = dispatch_semaphore_create(0);
36
+ _allowHasListenersReturn = dispatch_semaphore_create(0);
37
+ }
38
+ return self;
39
+ }
40
+ - (void)removeAllEventListeners {
41
+ self.listeners = NO;
42
+ }
43
+ - (BOOL)hasListeners {
44
+ dispatch_semaphore_signal(self.hasListenersEntered);
45
+ XCTAssertEqual(dispatch_semaphore_wait(self.allowHasListenersReturn,
46
+ dispatch_time(DISPATCH_TIME_NOW, 5 * NSEC_PER_SEC)),
47
+ 0);
48
+ return self.listeners;
49
+ }
50
+ @end
51
+
52
+ @interface PutBackGatedDatabaseQuery : NSObject
53
+ @property(nonatomic, assign) BOOL listeners;
54
+ @property(nonatomic, assign) NSInteger callCount;
55
+ @property(nonatomic, assign) NSInteger removeCount;
56
+ @property(nonatomic, strong) dispatch_semaphore_t firstEntered;
57
+ @property(nonatomic, strong) dispatch_semaphore_t allowFirstReturn;
58
+ @property(nonatomic, strong) dispatch_semaphore_t secondEntered;
59
+ @property(nonatomic, strong) dispatch_semaphore_t allowSecondReturn;
60
+ - (void)removeAllEventListeners;
61
+ - (BOOL)hasListeners;
62
+ @end
63
+
64
+ @implementation PutBackGatedDatabaseQuery
65
+ - (instancetype)init {
66
+ self = [super init];
67
+ if (self) {
68
+ _firstEntered = dispatch_semaphore_create(0);
69
+ _allowFirstReturn = dispatch_semaphore_create(0);
70
+ _secondEntered = dispatch_semaphore_create(0);
71
+ _allowSecondReturn = dispatch_semaphore_create(0);
72
+ }
73
+ return self;
74
+ }
75
+ - (void)removeAllEventListeners {
76
+ self.removeCount += 1;
77
+ self.listeners = NO;
78
+ }
79
+ - (BOOL)hasListeners {
80
+ self.callCount += 1;
81
+ if (self.callCount == 1) {
82
+ dispatch_semaphore_signal(self.firstEntered);
83
+ XCTAssertEqual(dispatch_semaphore_wait(self.allowFirstReturn,
84
+ dispatch_time(DISPATCH_TIME_NOW, 5 * NSEC_PER_SEC)),
85
+ 0);
86
+ return NO;
87
+ }
88
+ dispatch_semaphore_signal(self.secondEntered);
89
+ XCTAssertEqual(dispatch_semaphore_wait(self.allowSecondReturn,
90
+ dispatch_time(DISPATCH_TIME_NOW, 5 * NSEC_PER_SEC)),
91
+ 0);
92
+ return self.listeners;
93
+ }
94
+ @end
95
+
96
+ @interface FakeDatabaseQuery : NSObject
97
+ @property(nonatomic, assign) NSInteger removeCount;
98
+ @property(nonatomic, assign) BOOL listeners;
99
+ - (void)removeAllEventListeners;
100
+ - (BOOL)hasListeners;
101
+ @end
102
+
103
+ @implementation FakeDatabaseQuery
104
+ - (void)removeAllEventListeners {
105
+ self.removeCount += 1;
106
+ self.listeners = NO;
107
+ }
108
+ - (BOOL)hasListeners {
109
+ return self.listeners;
110
+ }
111
+ @end
112
+
113
+ @interface RNFBDatabaseQueryRegistryTests : XCTestCase
114
+ @property(nonatomic, strong) RNFBDatabaseQueryRegistry *registry;
115
+ @end
116
+
117
+ @implementation RNFBDatabaseQueryRegistryTests
118
+
119
+ - (void)setUp {
120
+ [super setUp];
121
+ self.registry = [[RNFBDatabaseQueryRegistry alloc] init];
122
+ }
123
+
124
+ - (void)testPutGetTake_happyPath {
125
+ FakeDatabaseQuery *query = [[FakeDatabaseQuery alloc] init];
126
+ NSError *error = nil;
127
+ XCTAssertTrue([self.registry put:@"q1" value:query error:&error]);
128
+ XCTAssertNil(error);
129
+ XCTAssertEqual(query, [self.registry get:@"q1"]);
130
+ XCTAssertEqual(query, [self.registry take:@"q1"]);
131
+ XCTAssertNil([self.registry get:@"q1"]);
132
+ XCTAssertEqual(query.removeCount, 0);
133
+ }
134
+
135
+ - (void)testPut_occupiedId_returnsCollision {
136
+ FakeDatabaseQuery *first = [[FakeDatabaseQuery alloc] init];
137
+ XCTAssertTrue([self.registry put:@"q1" value:first error:nil]);
138
+ NSError *error = nil;
139
+ XCTAssertFalse([self.registry put:@"q1" value:[[FakeDatabaseQuery alloc] init] error:&error]);
140
+ XCTAssertNotNil(error);
141
+ XCTAssertEqualObjects(error.domain, RNFBHandleMapErrorDomain);
142
+ XCTAssertEqual(error.code, RNFBHandleMapErrorCollision);
143
+ XCTAssertEqual(first, [self.registry get:@"q1"]);
144
+ }
145
+
146
+ - (void)testPut_occupiedId_nilErrorOut_returnsNo {
147
+ FakeDatabaseQuery *first = [[FakeDatabaseQuery alloc] init];
148
+ XCTAssertTrue([self.registry put:@"q1" value:first error:nil]);
149
+ XCTAssertFalse([self.registry put:@"q1" value:[[FakeDatabaseQuery alloc] init] error:nil]);
150
+ XCTAssertEqual(first, [self.registry get:@"q1"]);
151
+ }
152
+
153
+ - (void)testRemoveAll_removesSnapshotAndLeavesEmpty {
154
+ FakeDatabaseQuery *a = [[FakeDatabaseQuery alloc] init];
155
+ FakeDatabaseQuery *b = [[FakeDatabaseQuery alloc] init];
156
+ XCTAssertTrue([self.registry put:@"a" value:a error:nil]);
157
+ XCTAssertTrue([self.registry put:@"b" value:b error:nil]);
158
+ [self.registry removeAll];
159
+ XCTAssertEqual(a.removeCount, 1);
160
+ XCTAssertEqual(b.removeCount, 1);
161
+ XCTAssertNil([self.registry get:@"a"]);
162
+ XCTAssertNil([self.registry get:@"b"]);
163
+ }
164
+
165
+ - (void)testRemoveAll_objectWithoutRemove_doesNotCrash {
166
+ NSObject *plain = [[NSObject alloc] init];
167
+ XCTAssertTrue([self.registry put:@"p" value:plain error:nil]);
168
+ [self.registry removeAll];
169
+ XCTAssertNil([self.registry get:@"p"]);
170
+ }
171
+
172
+ - (void)testPut_afterTake_allowsReuse {
173
+ FakeDatabaseQuery *first = [[FakeDatabaseQuery alloc] init];
174
+ FakeDatabaseQuery *second = [[FakeDatabaseQuery alloc] init];
175
+ XCTAssertTrue([self.registry put:@"q1" value:first error:nil]);
176
+ XCTAssertEqual(first, [self.registry take:@"q1"]);
177
+ XCTAssertTrue([self.registry put:@"q1" value:second error:nil]);
178
+ XCTAssertEqual(second, [self.registry get:@"q1"]);
179
+ }
180
+
181
+ - (void)testTakeIfIdle_whenNoListeners_takes {
182
+ FakeDatabaseQuery *query = [[FakeDatabaseQuery alloc] init];
183
+ query.listeners = NO;
184
+ XCTAssertTrue([self.registry put:@"q" value:query error:nil]);
185
+ XCTAssertEqual(query, [self.registry takeIfIdle:@"q"]);
186
+ XCTAssertNil([self.registry get:@"q"]);
187
+ XCTAssertEqual(query.removeCount, 0);
188
+ }
189
+
190
+ - (void)testTakeIfIdle_whenHasListeners_leavesMapping {
191
+ FakeDatabaseQuery *query = [[FakeDatabaseQuery alloc] init];
192
+ query.listeners = YES;
193
+ XCTAssertTrue([self.registry put:@"q" value:query error:nil]);
194
+ XCTAssertNil([self.registry takeIfIdle:@"q"]);
195
+ XCTAssertEqual(query, [self.registry get:@"q"]);
196
+ }
197
+
198
+ - (void)testTakeIfIdle_whenMissing_isNoOp {
199
+ XCTAssertNil([self.registry takeIfIdle:@"missing"]);
200
+ }
201
+
202
+ - (void)testTakeIfIdle_objectWithoutHasListeners_leavesMapping {
203
+ NSObject *plain = [[NSObject alloc] init];
204
+ XCTAssertTrue([self.registry put:@"p" value:plain error:nil]);
205
+ XCTAssertNil([self.registry takeIfIdle:@"p"]);
206
+ XCTAssertEqual(plain, [self.registry get:@"p"]);
207
+ }
208
+
209
+ - (void)testTakeIfIdle_concurrentOffOnRace_retainsMappingWhenListenersAddedDuringCheck {
210
+ GatedFakeDatabaseQuery *query = [[GatedFakeDatabaseQuery alloc] init];
211
+ query.listeners = NO;
212
+ RNFBDatabaseQueryRegistry *registry = [[RNFBDatabaseQueryRegistry alloc] init];
213
+ XCTAssertTrue([registry put:@"q" value:query error:nil]);
214
+
215
+ dispatch_semaphore_t offDone = dispatch_semaphore_create(0);
216
+ dispatch_async(dispatch_get_global_queue(QOS_CLASS_USER_INITIATED, 0), ^{
217
+ [registry takeIfIdle:@"q"];
218
+ dispatch_semaphore_signal(offDone);
219
+ });
220
+
221
+ XCTAssertEqual(dispatch_semaphore_wait(query.hasListenersEntered,
222
+ dispatch_time(DISPATCH_TIME_NOW, 5 * NSEC_PER_SEC)),
223
+ 0);
224
+ query.listeners = YES;
225
+ dispatch_semaphore_signal(query.allowHasListenersReturn);
226
+ XCTAssertEqual(
227
+ dispatch_semaphore_wait(offDone, dispatch_time(DISPATCH_TIME_NOW, 5 * NSEC_PER_SEC)), 0);
228
+
229
+ XCTAssertEqual(query, [registry get:@"q"]);
230
+ }
231
+
232
+ - (void)testTakeIfIdle_doesNotHoldMapLockDuringHasListeners {
233
+ GatedFakeDatabaseQuery *query = [[GatedFakeDatabaseQuery alloc] init];
234
+ query.listeners = NO;
235
+ RNFBDatabaseQueryRegistry *registry = [[RNFBDatabaseQueryRegistry alloc] init];
236
+ XCTAssertTrue([registry put:@"q" value:query error:nil]);
237
+
238
+ dispatch_semaphore_t putDone = dispatch_semaphore_create(0);
239
+ dispatch_async(dispatch_get_global_queue(QOS_CLASS_USER_INITIATED, 0), ^{
240
+ [registry takeIfIdle:@"q"];
241
+ });
242
+
243
+ XCTAssertEqual(dispatch_semaphore_wait(query.hasListenersEntered,
244
+ dispatch_time(DISPATCH_TIME_NOW, 5 * NSEC_PER_SEC)),
245
+ 0);
246
+
247
+ dispatch_async(dispatch_get_global_queue(QOS_CLASS_USER_INITIATED, 0), ^{
248
+ FakeDatabaseQuery *other = [[FakeDatabaseQuery alloc] init];
249
+ XCTAssertTrue([registry put:@"other" value:other error:nil]);
250
+ dispatch_semaphore_signal(putDone);
251
+ });
252
+
253
+ XCTAssertEqual(
254
+ dispatch_semaphore_wait(putDone, dispatch_time(DISPATCH_TIME_NOW, 2 * NSEC_PER_SEC)), 0);
255
+
256
+ // Keep the mapping after unlock; this test only asserts lock nesting.
257
+ query.listeners = YES;
258
+ dispatch_semaphore_signal(query.allowHasListenersReturn);
259
+ XCTAssertEqual(query, [registry get:@"q"]);
260
+ XCTAssertNotNil([registry get:@"other"]);
261
+ }
262
+
263
+ - (void)testTakeIfIdle_putBackWhenListenersAppearAfterOutsideIdleCheck {
264
+ PutBackGatedDatabaseQuery *query = [[PutBackGatedDatabaseQuery alloc] init];
265
+ query.listeners = NO;
266
+ RNFBDatabaseQueryRegistry *registry = [[RNFBDatabaseQueryRegistry alloc] init];
267
+ XCTAssertTrue([registry put:@"q" value:query error:nil]);
268
+
269
+ dispatch_semaphore_t takeDone = dispatch_semaphore_create(0);
270
+ dispatch_async(dispatch_get_global_queue(QOS_CLASS_USER_INITIATED, 0), ^{
271
+ [registry takeIfIdle:@"q"];
272
+ dispatch_semaphore_signal(takeDone);
273
+ });
274
+
275
+ XCTAssertEqual(dispatch_semaphore_wait(query.firstEntered,
276
+ dispatch_time(DISPATCH_TIME_NOW, 5 * NSEC_PER_SEC)),
277
+ 0);
278
+ dispatch_semaphore_signal(query.allowFirstReturn);
279
+ XCTAssertEqual(dispatch_semaphore_wait(query.secondEntered,
280
+ dispatch_time(DISPATCH_TIME_NOW, 5 * NSEC_PER_SEC)),
281
+ 0);
282
+ query.listeners = YES;
283
+ dispatch_semaphore_signal(query.allowSecondReturn);
284
+ XCTAssertEqual(
285
+ dispatch_semaphore_wait(takeDone, dispatch_time(DISPATCH_TIME_NOW, 5 * NSEC_PER_SEC)), 0);
286
+
287
+ XCTAssertEqual(query, [registry get:@"q"]);
288
+ XCTAssertEqual(query.callCount, 2);
289
+ }
290
+
291
+ /**
292
+ * After identity-take, listeners appear but a concurrent put claimed the slot — put-back fails;
293
+ * orphan must clear listeners so SDK callbacks are not left outside the registry.
294
+ */
295
+ - (void)testTakeIfIdle_putBackFails_clearsOrphanListeners {
296
+ PutBackGatedDatabaseQuery *orphan = [[PutBackGatedDatabaseQuery alloc] init];
297
+ orphan.listeners = NO;
298
+ RNFBDatabaseQueryRegistry *registry = [[RNFBDatabaseQueryRegistry alloc] init];
299
+ XCTAssertTrue([registry put:@"q" value:orphan error:nil]);
300
+
301
+ FakeDatabaseQuery *replacement = [[FakeDatabaseQuery alloc] init];
302
+ replacement.listeners = YES;
303
+
304
+ dispatch_semaphore_t takeDone = dispatch_semaphore_create(0);
305
+ dispatch_async(dispatch_get_global_queue(QOS_CLASS_USER_INITIATED, 0), ^{
306
+ [registry takeIfIdle:@"q"];
307
+ dispatch_semaphore_signal(takeDone);
308
+ });
309
+
310
+ XCTAssertEqual(dispatch_semaphore_wait(orphan.firstEntered,
311
+ dispatch_time(DISPATCH_TIME_NOW, 5 * NSEC_PER_SEC)),
312
+ 0);
313
+ dispatch_semaphore_signal(orphan.allowFirstReturn);
314
+ XCTAssertEqual(dispatch_semaphore_wait(orphan.secondEntered,
315
+ dispatch_time(DISPATCH_TIME_NOW, 5 * NSEC_PER_SEC)),
316
+ 0);
317
+ XCTAssertTrue([registry put:@"q" value:replacement error:nil]);
318
+ orphan.listeners = YES;
319
+ dispatch_semaphore_signal(orphan.allowSecondReturn);
320
+ XCTAssertEqual(
321
+ dispatch_semaphore_wait(takeDone, dispatch_time(DISPATCH_TIME_NOW, 5 * NSEC_PER_SEC)), 0);
322
+
323
+ XCTAssertEqual(replacement, [registry get:@"q"]);
324
+ XCTAssertEqual(orphan.removeCount, 1);
325
+ XCTAssertFalse(orphan.listeners);
326
+ XCTAssertEqual(replacement.removeCount, 0);
327
+ }
328
+
329
+ - (void)testTakeIfIdle_concurrentOffOnRace_stressRetainsWhenListenersAlreadyActive {
330
+ for (NSInteger attempt = 0; attempt < 200; attempt++) {
331
+ RNFBDatabaseQueryRegistry *registry = [[RNFBDatabaseQueryRegistry alloc] init];
332
+ FakeDatabaseQuery *query = [[FakeDatabaseQuery alloc] init];
333
+ query.listeners = YES;
334
+ XCTAssertTrue([registry put:@"q" value:query error:nil]);
335
+
336
+ dispatch_semaphore_t start = dispatch_semaphore_create(0);
337
+ dispatch_semaphore_t done = dispatch_semaphore_create(0);
338
+
339
+ dispatch_async(dispatch_get_global_queue(QOS_CLASS_USER_INITIATED, 0), ^{
340
+ dispatch_semaphore_wait(start, DISPATCH_TIME_FOREVER);
341
+ [registry takeIfIdle:@"q"];
342
+ dispatch_semaphore_signal(done);
343
+ });
344
+ dispatch_async(dispatch_get_global_queue(QOS_CLASS_USER_INITIATED, 0), ^{
345
+ dispatch_semaphore_wait(start, DISPATCH_TIME_FOREVER);
346
+ query.listeners = YES;
347
+ dispatch_semaphore_signal(done);
348
+ });
349
+
350
+ dispatch_semaphore_signal(start);
351
+ dispatch_semaphore_signal(start);
352
+ XCTAssertEqual(
353
+ dispatch_semaphore_wait(done, dispatch_time(DISPATCH_TIME_NOW, 5 * NSEC_PER_SEC)), 0);
354
+ XCTAssertEqual(
355
+ dispatch_semaphore_wait(done, dispatch_time(DISPATCH_TIME_NOW, 5 * NSEC_PER_SEC)), 0);
356
+ XCTAssertEqual(query, [registry get:@"q"]);
357
+ }
358
+ }
359
+
360
+ - (void)testTakeIfIdle_concurrentTakeIfIdle_onIdleQuery_leavesMapEmpty {
361
+ FakeDatabaseQuery *query = [[FakeDatabaseQuery alloc] init];
362
+ query.listeners = NO;
363
+ XCTAssertTrue([self.registry put:@"q" value:query error:nil]);
364
+
365
+ dispatch_semaphore_t start = dispatch_semaphore_create(0);
366
+ dispatch_semaphore_t done = dispatch_semaphore_create(0);
367
+
368
+ dispatch_async(dispatch_get_global_queue(QOS_CLASS_USER_INITIATED, 0), ^{
369
+ dispatch_semaphore_wait(start, DISPATCH_TIME_FOREVER);
370
+ [self.registry takeIfIdle:@"q"];
371
+ dispatch_semaphore_signal(done);
372
+ });
373
+ dispatch_async(dispatch_get_global_queue(QOS_CLASS_USER_INITIATED, 0), ^{
374
+ dispatch_semaphore_wait(start, DISPATCH_TIME_FOREVER);
375
+ [self.registry takeIfIdle:@"q"];
376
+ dispatch_semaphore_signal(done);
377
+ });
378
+
379
+ dispatch_semaphore_signal(start);
380
+ dispatch_semaphore_signal(start);
381
+ XCTAssertEqual(dispatch_semaphore_wait(done, dispatch_time(DISPATCH_TIME_NOW, 5 * NSEC_PER_SEC)),
382
+ 0);
383
+ XCTAssertEqual(dispatch_semaphore_wait(done, dispatch_time(DISPATCH_TIME_NOW, 5 * NSEC_PER_SEC)),
384
+ 0);
385
+
386
+ XCTAssertNil([self.registry get:@"q"]);
387
+ XCTAssertEqual(query.removeCount, 0);
388
+ }
389
+
390
+ @end