@bugsee/react-native 0.0.0-stage → 7.0.0-beta1

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 (250) hide show
  1. package/BugseeReactNative.podspec +95 -0
  2. package/LICENSE +21 -0
  3. package/README.md +552 -2
  4. package/android/build.gradle +162 -0
  5. package/android/consumer-rules.pro +2 -0
  6. package/android/src/main/AndroidManifest.xml +33 -0
  7. package/android/src/main/java/com/bugsee/reactnative/AppearanceBridge.java +82 -0
  8. package/android/src/main/java/com/bugsee/reactnative/AttributeBridge.java +209 -0
  9. package/android/src/main/java/com/bugsee/reactnative/BreadcrumbFilterBridge.java +443 -0
  10. package/android/src/main/java/com/bugsee/reactnative/BridgeJson.java +168 -0
  11. package/android/src/main/java/com/bugsee/reactnative/BugseeModule.java +1869 -0
  12. package/android/src/main/java/com/bugsee/reactnative/BugseeOptionEnums.java +136 -0
  13. package/android/src/main/java/com/bugsee/reactnative/BugseePackage.java +42 -0
  14. package/android/src/main/java/com/bugsee/reactnative/BugseeReactNativeWrapper.java +200 -0
  15. package/android/src/main/java/com/bugsee/reactnative/BugseeStatusMapper.java +66 -0
  16. package/android/src/main/java/com/bugsee/reactnative/BugseeTokens.java +22 -0
  17. package/android/src/main/java/com/bugsee/reactnative/ConsoleEchoDedup.java +202 -0
  18. package/android/src/main/java/com/bugsee/reactnative/CreatedReports.java +127 -0
  19. package/android/src/main/java/com/bugsee/reactnative/DataRequestBridge.java +375 -0
  20. package/android/src/main/java/com/bugsee/reactnative/ExceptionBridge.java +88 -0
  21. package/android/src/main/java/com/bugsee/reactnative/ExceptionExecutors.java +33 -0
  22. package/android/src/main/java/com/bugsee/reactnative/LogFilterBridge.java +375 -0
  23. package/android/src/main/java/com/bugsee/reactnative/NetworkEvents.java +227 -0
  24. package/android/src/main/java/com/bugsee/reactnative/NetworkFilterBridge.java +498 -0
  25. package/android/src/main/java/com/bugsee/reactnative/PluginEndpoint.java +48 -0
  26. package/android/src/main/java/com/bugsee/reactnative/ReactNativeWebException.java +19 -0
  27. package/android/src/main/java/com/bugsee/reactnative/ReactNativeWrapperInitProvider.java +61 -0
  28. package/android/src/main/java/com/bugsee/reactnative/ReactRootOriginTracker.java +867 -0
  29. package/android/src/main/java/com/bugsee/reactnative/ReportArgs.java +58 -0
  30. package/android/src/main/java/com/bugsee/reactnative/ReportHandlerBridge.java +336 -0
  31. package/android/src/main/java/com/bugsee/reactnative/ReportHandlerDeadlines.java +57 -0
  32. package/android/src/main/java/com/bugsee/reactnative/ReportOps.java +287 -0
  33. package/android/src/main/java/com/bugsee/reactnative/SecureRectanglePulls.java +113 -0
  34. package/android/src/main/java/com/bugsee/reactnative/SecureRectangleStore.java +692 -0
  35. package/android/src/main/java/com/bugsee/reactnative/SpanHandles.java +143 -0
  36. package/android/src/main/java/com/bugsee/reactnative/WrapperChannelHolder.java +137 -0
  37. package/android/src/main/java/com/bugsee/reactnative/WrapperEventBus.java +110 -0
  38. package/android/src/main/java/com/bugsee/reactnative/WrapperRegistrar.java +54 -0
  39. package/app.plugin.js +4 -0
  40. package/ios/BGSRNConsoleCapture.h +52 -0
  41. package/ios/BGSRNConsoleCapture.mm +344 -0
  42. package/ios/BugseeModule.h +25 -0
  43. package/ios/BugseeModule.mm +2728 -0
  44. package/ios/Package.swift +71 -0
  45. package/ios/Support/Package.resolved +14 -0
  46. package/ios/Support/Package.swift +44 -0
  47. package/ios/Support/Sources/BugseeRNSupport/BGSRNAttributes.m +52 -0
  48. package/ios/Support/Sources/BugseeRNSupport/BGSRNCreatedReportOps.m +236 -0
  49. package/ios/Support/Sources/BugseeRNSupport/BGSRNCreatedReports.m +184 -0
  50. package/ios/Support/Sources/BugseeRNSupport/BGSRNDataRequestBridge.m +431 -0
  51. package/ios/Support/Sources/BugseeRNSupport/BGSRNErrorMessage.m +40 -0
  52. package/ios/Support/Sources/BugseeRNSupport/BGSRNEventBus.m +70 -0
  53. package/ios/Support/Sources/BugseeRNSupport/BGSRNExceptions.m +63 -0
  54. package/ios/Support/Sources/BugseeRNSupport/BGSRNGuardedEmit.mm +32 -0
  55. package/ios/Support/Sources/BugseeRNSupport/BGSRNJSON.m +40 -0
  56. package/ios/Support/Sources/BugseeRNSupport/BGSRNLaunchHold.m +147 -0
  57. package/ios/Support/Sources/BugseeRNSupport/BGSRNMainThread.m +23 -0
  58. package/ios/Support/Sources/BugseeRNSupport/BGSRNNetworkEvents.m +159 -0
  59. package/ios/Support/Sources/BugseeRNSupport/BGSRNNetworkFilter.m +155 -0
  60. package/ios/Support/Sources/BugseeRNSupport/BGSRNPluginEndpoint.m +21 -0
  61. package/ios/Support/Sources/BugseeRNSupport/BGSRNReactRootOriginTracker.m +63 -0
  62. package/ios/Support/Sources/BugseeRNSupport/BGSRNReactWindow.m +251 -0
  63. package/ios/Support/Sources/BugseeRNSupport/BGSRNReportArgs.m +47 -0
  64. package/ios/Support/Sources/BugseeRNSupport/BGSRNReportDeadlines.m +8 -0
  65. package/ios/Support/Sources/BugseeRNSupport/BGSRNReportHandlerBridge.m +308 -0
  66. package/ios/Support/Sources/BugseeRNSupport/BGSRNReportOps.m +345 -0
  67. package/ios/Support/Sources/BugseeRNSupport/BGSRNSecureRectangles.m +508 -0
  68. package/ios/Support/Sources/BugseeRNSupport/BGSRNSettleOnce.m +62 -0
  69. package/ios/Support/Sources/BugseeRNSupport/BGSRNSpanHandles.m +136 -0
  70. package/ios/Support/Sources/BugseeRNSupport/BGSRNStatusMapper.m +18 -0
  71. package/ios/Support/Sources/BugseeRNSupport/BGSRNTokens.m +9 -0
  72. package/ios/Support/Sources/BugseeRNSupport/BGSRNValues.m +5 -0
  73. package/ios/Support/Sources/BugseeRNSupport/BGSRNWrapper.m +54 -0
  74. package/ios/Support/Sources/BugseeRNSupport/BGSRNWrapperChannelHolder.m +59 -0
  75. package/ios/Support/Sources/BugseeRNSupport/include/BGSRNAttributes.h +63 -0
  76. package/ios/Support/Sources/BugseeRNSupport/include/BGSRNCreatedReportOps.h +51 -0
  77. package/ios/Support/Sources/BugseeRNSupport/include/BGSRNCreatedReports.h +81 -0
  78. package/ios/Support/Sources/BugseeRNSupport/include/BGSRNDataRequestBridge.h +118 -0
  79. package/ios/Support/Sources/BugseeRNSupport/include/BGSRNErrorMessage.h +30 -0
  80. package/ios/Support/Sources/BugseeRNSupport/include/BGSRNEventBus.h +45 -0
  81. package/ios/Support/Sources/BugseeRNSupport/include/BGSRNExceptions.h +31 -0
  82. package/ios/Support/Sources/BugseeRNSupport/include/BGSRNGuardedEmit.h +31 -0
  83. package/ios/Support/Sources/BugseeRNSupport/include/BGSRNJSON.h +25 -0
  84. package/ios/Support/Sources/BugseeRNSupport/include/BGSRNLaunchHold.h +86 -0
  85. package/ios/Support/Sources/BugseeRNSupport/include/BGSRNMainThread.h +32 -0
  86. package/ios/Support/Sources/BugseeRNSupport/include/BGSRNNetworkEvents.h +28 -0
  87. package/ios/Support/Sources/BugseeRNSupport/include/BGSRNNetworkFilter.h +28 -0
  88. package/ios/Support/Sources/BugseeRNSupport/include/BGSRNPluginEndpoint.h +17 -0
  89. package/ios/Support/Sources/BugseeRNSupport/include/BGSRNReactRootOriginTracker.h +48 -0
  90. package/ios/Support/Sources/BugseeRNSupport/include/BGSRNReactWindow.h +135 -0
  91. package/ios/Support/Sources/BugseeRNSupport/include/BGSRNReportArgs.h +17 -0
  92. package/ios/Support/Sources/BugseeRNSupport/include/BGSRNReportDeadlines.h +37 -0
  93. package/ios/Support/Sources/BugseeRNSupport/include/BGSRNReportHandlerBridge.h +94 -0
  94. package/ios/Support/Sources/BugseeRNSupport/include/BGSRNReportOps.h +86 -0
  95. package/ios/Support/Sources/BugseeRNSupport/include/BGSRNSecureRectangles.h +198 -0
  96. package/ios/Support/Sources/BugseeRNSupport/include/BGSRNSettleOnce.h +25 -0
  97. package/ios/Support/Sources/BugseeRNSupport/include/BGSRNSpanHandles.h +49 -0
  98. package/ios/Support/Sources/BugseeRNSupport/include/BGSRNStatusMapper.h +26 -0
  99. package/ios/Support/Sources/BugseeRNSupport/include/BGSRNTokens.h +14 -0
  100. package/ios/Support/Sources/BugseeRNSupport/include/BGSRNValues.h +18 -0
  101. package/ios/Support/Sources/BugseeRNSupport/include/BGSRNWrapper.h +40 -0
  102. package/ios/Support/Sources/BugseeRNSupport/include/BGSRNWrapperChannelHolder.h +74 -0
  103. package/ios/Support/Tests/BugseeRNSupportTests/BGSRNAttributesTests.m +194 -0
  104. package/ios/Support/Tests/BugseeRNSupportTests/BGSRNCreatedReportOpsTests.m +274 -0
  105. package/ios/Support/Tests/BugseeRNSupportTests/BGSRNCreatedReportsTests.m +240 -0
  106. package/ios/Support/Tests/BugseeRNSupportTests/BGSRNDataRequestBridgeTests.m +685 -0
  107. package/ios/Support/Tests/BugseeRNSupportTests/BGSRNErrorMessageTests.m +102 -0
  108. package/ios/Support/Tests/BugseeRNSupportTests/BGSRNEventBusTests.m +136 -0
  109. package/ios/Support/Tests/BugseeRNSupportTests/BGSRNExceptionsTests.m +68 -0
  110. package/ios/Support/Tests/BugseeRNSupportTests/BGSRNFakeReport.h +41 -0
  111. package/ios/Support/Tests/BugseeRNSupportTests/BGSRNFakeReport.m +166 -0
  112. package/ios/Support/Tests/BugseeRNSupportTests/BGSRNGuardedEmitTests.mm +85 -0
  113. package/ios/Support/Tests/BugseeRNSupportTests/BGSRNJSONTests.m +281 -0
  114. package/ios/Support/Tests/BugseeRNSupportTests/BGSRNLaunchHoldTests.m +230 -0
  115. package/ios/Support/Tests/BugseeRNSupportTests/BGSRNMainThreadTests.m +97 -0
  116. package/ios/Support/Tests/BugseeRNSupportTests/BGSRNNetworkEventsTests.m +99 -0
  117. package/ios/Support/Tests/BugseeRNSupportTests/BGSRNNetworkFilterTests.m +134 -0
  118. package/ios/Support/Tests/BugseeRNSupportTests/BGSRNPluginEndpointTests.m +38 -0
  119. package/ios/Support/Tests/BugseeRNSupportTests/BGSRNReactRootOriginTrackerTests.m +210 -0
  120. package/ios/Support/Tests/BugseeRNSupportTests/BGSRNReactWindowTests.m +548 -0
  121. package/ios/Support/Tests/BugseeRNSupportTests/BGSRNReportArgsTests.m +51 -0
  122. package/ios/Support/Tests/BugseeRNSupportTests/BGSRNReportDeadlinesTests.m +22 -0
  123. package/ios/Support/Tests/BugseeRNSupportTests/BGSRNReportHandlerBridgeTests.m +382 -0
  124. package/ios/Support/Tests/BugseeRNSupportTests/BGSRNReportOpsTests.m +295 -0
  125. package/ios/Support/Tests/BugseeRNSupportTests/BGSRNSecureRectanglesTests.m +568 -0
  126. package/ios/Support/Tests/BugseeRNSupportTests/BGSRNSettleOnceTests.m +134 -0
  127. package/ios/Support/Tests/BugseeRNSupportTests/BGSRNSpanHandlesTests.m +153 -0
  128. package/ios/Support/Tests/BugseeRNSupportTests/BGSRNStatusMapperTests.m +81 -0
  129. package/ios/Support/Tests/BugseeRNSupportTests/BGSRNValuesTests.m +32 -0
  130. package/ios/Support/Tests/BugseeRNSupportTests/BGSRNWrapperChannelHolderTests.m +205 -0
  131. package/ios/Support/Tests/BugseeRNSupportTests/BGSRNWrapperTests.m +66 -0
  132. package/ios/react-native-spm-prefix.h +10 -0
  133. package/native-versions.json +10 -0
  134. package/package.json +62 -3
  135. package/plugin/build/bundle-phase.d.ts +41 -0
  136. package/plugin/build/bundle-phase.js +116 -0
  137. package/plugin/build/bundle-phase.js.map +1 -0
  138. package/plugin/build/dsym-script.d.ts +32 -0
  139. package/plugin/build/dsym-script.js +159 -0
  140. package/plugin/build/dsym-script.js.map +1 -0
  141. package/plugin/build/endpoint.d.ts +30 -0
  142. package/plugin/build/endpoint.js +69 -0
  143. package/plugin/build/endpoint.js.map +1 -0
  144. package/plugin/build/gradle.d.ts +65 -0
  145. package/plugin/build/gradle.js +1066 -0
  146. package/plugin/build/gradle.js.map +1 -0
  147. package/plugin/build/index.d.ts +85 -0
  148. package/plugin/build/index.js +217 -0
  149. package/plugin/build/index.js.map +1 -0
  150. package/plugin/build/manifest.d.ts +48 -0
  151. package/plugin/build/manifest.js +69 -0
  152. package/plugin/build/manifest.js.map +1 -0
  153. package/plugin/build/native-versions.baked.json +4 -0
  154. package/plugin/build/native-versions.d.ts +10 -0
  155. package/plugin/build/native-versions.js +27 -0
  156. package/plugin/build/native-versions.js.map +1 -0
  157. package/plugin/build/pbx-string.d.ts +8 -0
  158. package/plugin/build/pbx-string.js +31 -0
  159. package/plugin/build/pbx-string.js.map +1 -0
  160. package/plugin/build/podfile.d.ts +3 -0
  161. package/plugin/build/podfile.js +28 -0
  162. package/plugin/build/podfile.js.map +1 -0
  163. package/plugin/build/properties.d.ts +19 -0
  164. package/plugin/build/properties.js +41 -0
  165. package/plugin/build/properties.js.map +1 -0
  166. package/plugin/build/scheme.d.ts +20 -0
  167. package/plugin/build/scheme.js +107 -0
  168. package/plugin/build/scheme.js.map +1 -0
  169. package/react-native.config.js +26 -0
  170. package/scripts/bugsee-sourcemaps.gradle +201 -0
  171. package/scripts/bugsee-xcode.sh +83 -0
  172. package/scripts/compose-then-inject.js +113 -0
  173. package/scripts/hermes-sourcemaps.js +634 -0
  174. package/scripts/hermesc-preserve-js.cmd +6 -0
  175. package/scripts/hermesc-preserve-js.js +200 -0
  176. package/scripts/hermesc-preserve-js.sh +7 -0
  177. package/src/NativeBugsee.ts +622 -0
  178. package/src/apm/notify.ts +58 -0
  179. package/src/apm/span.ts +403 -0
  180. package/src/apm/types.ts +57 -0
  181. package/src/appearance/report.ts +171 -0
  182. package/src/architecture.ts +48 -0
  183. package/src/attributes/errors.ts +39 -0
  184. package/src/attributes/validate.ts +150 -0
  185. package/src/breadcrumbs/add.ts +58 -0
  186. package/src/breadcrumbs/data.ts +33 -0
  187. package/src/breadcrumbs/filter.ts +215 -0
  188. package/src/breadcrumbs/types.ts +64 -0
  189. package/src/bridge/json.ts +110 -0
  190. package/src/console/capture.ts +180 -0
  191. package/src/console/dedup.ts +175 -0
  192. package/src/data/validate.ts +259 -0
  193. package/src/errorName.ts +32 -0
  194. package/src/exceptions/ErrorBoundary.tsx +92 -0
  195. package/src/exceptions/RootErrorReporter.tsx +61 -0
  196. package/src/exceptions/debugIds.ts +118 -0
  197. package/src/exceptions/handlers.ts +236 -0
  198. package/src/exceptions/options.ts +85 -0
  199. package/src/exceptions/payload.ts +456 -0
  200. package/src/exceptions/report.ts +170 -0
  201. package/src/exceptions/sha1.ts +148 -0
  202. package/src/exceptions/stack.ts +355 -0
  203. package/src/index.ts +944 -0
  204. package/src/logs/filter.ts +90 -0
  205. package/src/logs/log.ts +36 -0
  206. package/src/network/add.ts +165 -0
  207. package/src/network/filter.ts +198 -0
  208. package/src/options/AndroidLaunchOptions.ts +78 -0
  209. package/src/options/BugseeLaunchOptions.ts +190 -0
  210. package/src/options/IOSLaunchOptions.ts +57 -0
  211. package/src/options/android-options-manifest.json +646 -0
  212. package/src/options/createDefaultLaunchOptions.ts +29 -0
  213. package/src/options/endpoint.ts +58 -0
  214. package/src/options/enums.ts +104 -0
  215. package/src/options/ios-enums.json +19 -0
  216. package/src/options/keys.ts +39 -0
  217. package/src/options/option-enums.json +34 -0
  218. package/src/options/option-keys.json +107 -0
  219. package/src/report/BugseeReport.ts +264 -0
  220. package/src/report/CreatedReport.ts +127 -0
  221. package/src/report/dispatcher.ts +95 -0
  222. package/src/report/errors.ts +48 -0
  223. package/src/report/fields.ts +40 -0
  224. package/src/report/types.ts +157 -0
  225. package/src/report/validate.ts +197 -0
  226. package/src/secure/BugseeSecure.tsx +202 -0
  227. package/src/secure/ancestry.ts +622 -0
  228. package/src/secure/drivers.ts +342 -0
  229. package/src/secure/followEvents.ts +57 -0
  230. package/src/secure/hold.ts +99 -0
  231. package/src/secure/measureLoop.ts +323 -0
  232. package/src/secure/nativeAnimation.ts +1005 -0
  233. package/src/secure/rectangles.ts +93 -0
  234. package/src/secure/registry.ts +237 -0
  235. package/src/secure/surface.ts +83 -0
  236. package/src/secure/tracker.ts +723 -0
  237. package/src/secure/transition.ts +488 -0
  238. package/src/secure/unit.ts +22 -0
  239. package/src/status.ts +16 -0
  240. package/src/version.ts +9 -0
  241. package/src/viewtree/anchor.tsx +105 -0
  242. package/src/viewtree/constants.ts +20 -0
  243. package/src/viewtree/fiber.ts +251 -0
  244. package/src/viewtree/requests.ts +347 -0
  245. package/src/viewtree/walk.ts +902 -0
  246. package/src/wrapper/channel.ts +33 -0
  247. package/src/wrapper/collect.ts +52 -0
  248. package/src/wrapper/events.ts +45 -0
  249. package/src/wrapper/identity.ts +54 -0
  250. package/src/wrapper/lifecycle-events.ts +89 -0
@@ -0,0 +1,202 @@
1
+ import { useLayoutEffect, useRef } from 'react';
2
+ import type { ComponentRef, ReactElement, ReactNode } from 'react';
3
+ import { View } from 'react-native';
4
+ import type { LayoutChangeEvent, ViewProps } from 'react-native';
5
+ import { SecureTracker } from './tracker';
6
+
7
+ export interface BugseeSecureProps extends ViewProps {
8
+ /** While false, nothing is redacted and nothing is measured. Default true. */
9
+ enabled?: boolean;
10
+ children?: ReactNode;
11
+ }
12
+
13
+ /**
14
+ * Keeps Bugsee from recording whatever it wraps, for as long as it is mounted
15
+ * and enabled.
16
+ *
17
+ * It measures its own view in the window on mount, on every layout and every
18
+ * `SECURE_REMEASURE_MS` (an ancestor scrolling moves it without a layout
19
+ * event), and publishes that rectangle through the shared registry, so it
20
+ * never disturbs what `Bugsee.setSecureRectangles` set or another instance
21
+ * holds.
22
+ *
23
+ * Only the part that is on screen is published: the rectangle is cut to every
24
+ * ancestor that clips it, up to its surface's root (a ScrollView's viewport,
25
+ * or a view styled `overflow: 'hidden'`). A view scrolled fully out of sight
26
+ * publishes nothing, so it does not mask, or drop the taps on, whatever is
27
+ * shown there instead (a bottom tab bar, say).
28
+ *
29
+ * Nothing is measured, and in the end nothing published, while a
30
+ * react-native-screens screen above it is inactive in the committed tree
31
+ * (`activityState` 0 under a screens container, such as an inactive tab that
32
+ * stays mounted): that hides a view without changing its layout. A view
33
+ * hidden by `display: 'none'` or a hidden `<Activity>` measures 0x0, which
34
+ * publishes nothing anyway.
35
+ *
36
+ * Coverage is added at once and removed late. What it measures describes the
37
+ * shadow tree, which native draws a frame or more later (a LayoutAnimation
38
+ * only at its end), so what it stopped covering, by shrinking, moving or
39
+ * being hidden, stays published for `SECURE_SHRINK_HOLD_MS`. Growth is never
40
+ * delayed.
41
+ *
42
+ * Kept up to date within a frame where it matters, at a cost bounded by what
43
+ * moves: a view that moves, was just shown or is clipped re-measures every
44
+ * frame until it has stayed put for `STEADY_FRAMES` frames; a clipped view
45
+ * that is still is woken the frame its ScrollView's content (watched once a
46
+ * frame for every view under it) moves; a withdrawn view asks every frame,
47
+ * once per screen, whether its screens still hide it, and is back the frame
48
+ * they do not.
49
+ *
50
+ * Unmounting removes it late too: native draws the view until it mounts the
51
+ * commit that removed it, so what it covered stays published for
52
+ * `SECURE_SHRINK_HOLD_MS`.
53
+ *
54
+ * Native transitions draw it where no measurement can follow, so for
55
+ * `SECURE_TRANSITION_HOLD_MS` from the commit that starts one it also covers
56
+ * where they can. While a react-native-screens stack pushes or pops a
57
+ * screen, a view on that screen, or on the screen it uncovers or covers,
58
+ * covers by the screen's `stackAnimation`: its band across the screen for a
59
+ * sideways slide, the column below it for a slide from the bottom, itself
60
+ * for a fade, and the whole screen for the platform default or anything
61
+ * else. A view in a `<Modal animationType="slide">` covers the band below
62
+ * it while the Modal slides in or out (also when `visible` turns false on a
63
+ * Modal that stays mounted). A screen replaced on its stack (`replace`) is
64
+ * animated out by the incoming screen's animation, and covered by it. A view
65
+ * that mounts, or is shown, in a screen or Modal still within the hold from
66
+ * its push or opening is covered too (content that arrives after a spinner),
67
+ * and re-measured every frame until it settles, so a Modal laid out again
68
+ * once its dialog is up is followed within a frame; so is a view first shown
69
+ * on the screen a pop uncovers (mounted while that screen was hidden, or
70
+ * during the pop), for the rest of the pop's hold. Each stack keeps what any
71
+ * view saw of its recent pushes and pops. When a screen or Modal came or
72
+ * went is known only if a `<BugseeSecure>` saw it (one on it, or on another
73
+ * screen of its stack); otherwise the first view to look takes it as
74
+ * happening then, once per change (a stack read for the first time is
75
+ * compared with its render before).
76
+ *
77
+ * A native-driven `Animated` transform above it (`useNativeDriver: true`)
78
+ * never reaches the shadow tree, so it also covers every place that
79
+ * transform can draw it, joined with where it is measured: translations and
80
+ * scales (about `transformOrigin`) bounded from the animated value, its
81
+ * running timing animation, interpolations, `diffClamp` and arithmetic
82
+ * nodes. A value a native event is attached to (an `Animated.event` in an
83
+ * `Animated` component's props, such as an `Animated.ScrollView`'s
84
+ * `onScroll` or a gesture handler's `onGestureEvent`, or one attached with
85
+ * `Animated.attachNativeEvent`, as React Native's ScrollView does for its
86
+ * sticky headers) moves wherever the scroll or the gesture takes it, for as
87
+ * long as it is attached, idle or not, whatever animated it before. It is
88
+ * bounded only where that is provable: through an interpolation that clamps,
89
+ * or extends a flat last segment, at both ends (within its outputs, eased);
90
+ * through `diffClamp`; and, on Android, as a ScrollView's `contentOffset`
91
+ * (vertical or horizontal), within the offsets the ScrollView can reach
92
+ * (from its measured content and viewport, and a fling's overrun past either
93
+ * end, `SCROLL_OVERRUN`), unless it is under a scale other than 1, or inside
94
+ * that ScrollView's own content (a sticky header: its content moves by the
95
+ * same offset, natively ahead of the shadow tree). What cannot
96
+ * be bounded (any other event's value, an iOS ScrollView's offset, a rotation, a
97
+ * spring, a node React Native renamed) covers the whole surface, cut by the
98
+ * clipping ancestors above it, for as long as it cannot be. A view under a
99
+ * running native animation is re-measured every frame. When JS moves a value
100
+ * above it (starts an animation on it, the first with the native driver
101
+ * included, which makes it native and commits nothing; sets, resets or
102
+ * offsets it), the view is measured and published in that same JS task,
103
+ * before React Native hands the change to the UI thread; what native does to
104
+ * a still native value on its own (an animation ending) is seen by the next
105
+ * JS frame. A transform animated from JS (`useNativeDriver: false`) moves the
106
+ * view every frame through Fabric with no wrapped call: the view is
107
+ * re-measured every frame while the animation runs, and an idle value driven
108
+ * from JS keeps no frame loop running. Other styles a JS animation moves
109
+ * (`top`, `left`, a size) are followed by the 100 ms re-measure only.
110
+ *
111
+ * What drives a native value is followed from when the package is first
112
+ * evaluated (its entry imports `secure/followEvents` for that, so Metro's
113
+ * `inlineRequires` does not defer it to the first `<BugseeSecure>`; it does
114
+ * defer the entry to its first use: import the package, or call
115
+ * `Bugsee.launch`, at the top of `index.js`): the
116
+ * events attached to it, and its being made native. A native value made
117
+ * native before that, or left wherever its last event took it, is unbounded
118
+ * until it next animates. Where React Native's internals cannot be followed
119
+ * (React Native moved them), no still native value is trusted: every one is
120
+ * unbounded.
121
+ *
122
+ * Known limits: Reanimated runs its animations on the UI thread, out of
123
+ * JS's sight; a Reanimated component whose style sets a transform through
124
+ * an animated style, sets a shared value inline, or uses a CSS animation or
125
+ * transition covers the whole surface, cut by the clipping ancestors above
126
+ * it; anything else Reanimated moves (an animated style that adds a
127
+ * transform only later, layout animations, `entering`/`exiting`, shared
128
+ * transitions) is not seen. An interactive back gesture moves a mounted
129
+ * screen with nothing JS sees. The cover published as JS starts a native
130
+ * animation and the animation itself reach native separately; under heavy
131
+ * load the UI thread could still draw its first frame before the cover lands.
132
+ * A native event attached without `Animated` (code that calls React
133
+ * Native's native Animated module itself) is not seen, and its value is
134
+ * taken where JS last had it.
135
+ *
136
+ * Fails closed: a measurement that throws or is rejected leaves the last
137
+ * rectangle published, and an ancestor that cannot be read or measured cuts
138
+ * nothing off it. Only `enabled={false}` removes it at once.
139
+ *
140
+ * Known limit: how an ancestor clips is read from its committed React props.
141
+ * An `overflow` changed natively, through `setNativeProps` or a native-driven
142
+ * style, is not seen: a view still believed clipped by an ancestor that no
143
+ * longer clips publishes only the part inside the old clip.
144
+ *
145
+ * Fabric `measureInWindow` is relative to the measured node's nearest
146
+ * `RootNodeKind` ancestor: the app's root, or the content of the `<Modal>`
147
+ * it is in. The rectangle is published under that surface's key (the Modal
148
+ * host's tag, read off the fiber tree once per mount), so native translates
149
+ * it by that surface's origin at pull time. No native call is made to find
150
+ * the surface. On iOS that origin includes the window's place on its screen
151
+ * (Stage Manager, Split View, iPhone Duo side by side), where the SDK draws.
152
+ *
153
+ * A plain function component on purpose (no `memo`, no `forwardRef`): the view
154
+ * tree walk recognises it by identity.
155
+ */
156
+ /** No dependencies: an effect that runs once per mount. */
157
+ // Stryker disable next-line ArrayDeclaration -- any constant list runs it once per mount alike
158
+ const ONCE_PER_MOUNT: readonly unknown[] = [];
159
+
160
+ export function BugseeSecure(props: BugseeSecureProps): ReactElement {
161
+ const { enabled = true, onLayout, ...rest } = props;
162
+ const ref = useRef<ComponentRef<typeof View>>(null);
163
+ // This instance's registry key. An object, so it can never collide with a
164
+ // manual owner or with another instance.
165
+ const token = useRef<object>({}).current;
166
+ // Measures and publishes for this instance while it is mounted and
167
+ // enabled. It reads the view through the ref, so one is as good as any.
168
+ const tracker = useRef<SecureTracker | null>(null);
169
+ tracker.current ??= new SecureTracker(() => ref.current, token);
170
+
171
+ // Set while the instance unmounts. Declared before the effect below, so on
172
+ // unmount its cleanup runs first; a change of `enabled` alone never runs it.
173
+ // Stryker disable next-line BooleanLiteral -- the effect below sets it before any cleanup can read it
174
+ const unmounting = useRef(false);
175
+ useLayoutEffect(() => {
176
+ unmounting.current = false;
177
+ return () => {
178
+ unmounting.current = true;
179
+ };
180
+ }, ONCE_PER_MOUNT);
181
+
182
+ // A layout effect, not a passive one: it runs in the commit, so on Fabric
183
+ // the first rectangle is registered before the first frame is painted
184
+ // rather than after it, and the cleanup of an unmount can still read which
185
+ // fibers that commit deletes.
186
+ useLayoutEffect(() => {
187
+ if (!enabled) {
188
+ return undefined;
189
+ }
190
+ const current = tracker.current as SecureTracker;
191
+ current.start();
192
+ return () => (unmounting.current ? current.depart() : current.stop());
193
+ // Only `enabled`: the tracker is created once per instance.
194
+ }, [enabled]);
195
+
196
+ const handleLayout = (event: LayoutChangeEvent): void => {
197
+ onLayout?.(event);
198
+ (tracker.current as SecureTracker).measure();
199
+ };
200
+
201
+ return <View {...rest} ref={ref} collapsable={false} onLayout={handleLayout} />;
202
+ }