react-native-acoustic-connect-beta 19.0.20 → 19.0.22

package/CHANGELOG.md

@@ -1,3 +1,13 @@
+## 19.0.22 (2026-09-10)
+
+### Reverts
+
+* Revert "Beta ReactNativeConnect build: 18.0.36" ([609ad7d](https://github.com/aipoweredmarketer/react-native-acoustic-connect-beta/commit/609ad7d3244ec06f27dced5864d40585c5b3c9cf))
+## 19.0.21 (2026-09-09)
+
+### Reverts
+
+* Revert "Beta ReactNativeConnect build: 18.0.36" ([609ad7d](https://github.com/aipoweredmarketer/react-native-acoustic-connect-beta/commit/609ad7d3244ec06f27dced5864d40585c5b3c9cf))
 ## 19.0.20 (2026-09-09)
 
 ### Reverts

package/README.md

@@ -569,13 +569,22 @@ one. To turn screenshot capture off on both platforms:
   "Connect": {
     "layoutConfig": {
       "AutoLayout": {
-        "GlobalScreenSettings": { "ScreenShot": false, "CaptureScreenshotOn": 0 }
+        "GlobalScreenSettings": { "ScreenShot": false }
       }
     }
   }
 }
 ```
 
+`ScreenShot` is the cross-platform switch — set it in `layoutConfig` (or per
+platform) and both native SDKs honour it. `CaptureScreenshotOn` is a related
+but **iOS-only** key: iOS's native auto-instrumentation reads it, but on
+Android the equivalent reader has no callers, so `CaptureScreenshotOn` is
+accepted wherever you put it and does nothing there. Set it only under
+`layoutConfigIos` if you want it; leaving it out of `layoutConfigAndroid` (or
+the shared `layoutConfig`) costs nothing on Android and avoids implying it
+does something it doesn't.
+
 Put anything common in `layoutConfig` and use `layoutConfigIos` /
 `layoutConfigAndroid` only for what differs. The platform block is **deep-merged**
 over the shared one, so it refines the baseline rather than replacing it: an
@@ -584,6 +593,32 @@ rules, and every other shared value. Arrays are replaced outright rather than
 concatenated, so a platform block can shorten or clear a shared list such as
 `MaskIdList`.
 
+#### Masking is selection, then redaction — an unmatched pattern leaves data unmasked
+
+A screen rule's `Masking` block works in two independent steps: a control is
+first **selected** by a matching `MaskIdList` (control id), `MaskValueList`
+(control value), `MaskAccessibilityIdList` (accessibility id), or
+`MaskAccessibilityLabelList` (accessibility label) pattern, and only a
+*selected* control is redacted — its value, and (Connect iOS 2.1.22+ / Android
+11.0.23-beta+ only — older SDKs serialised the accessibility object verbatim
+regardless of masking) its accessibility label and hint. A control whose value
+never matches any pattern in any of the four lists is not masked in any field.
+That's by design, not a bug — but it means a client whose patterns don't
+happen to match a given value can believe that value is masked when it never
+was.
+
+Email addresses are an easy miss: they rarely match a card-number or
+`SECRET-`-style pattern, and free-text fields (bios, support messages,
+usernames) routinely contain one. For any screen that collects email
+addresses, add a pattern to `MaskValueList`:
+
+```json
+{ "MaskValueList": ["[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\\.[A-Za-z]{2,}"] }
+```
+
+(The `bare-workflow` and `expo` sample `ConnectConfig.example.json` already
+ship this pattern on `GlobalScreenSettings`.)
+
 When no block applies, each native SDK keeps the defaults from its own bundled
 layout config:
 
@@ -636,6 +671,54 @@ every shipped template uses. To stand layout capture down deliberately, set
 `CaptureLayoutOn: 0` on the rule instead — it is the key that means that, and it
 leaves `NumberOfWebViews` free to describe the screen.
 
+#### WebView capture on Android: prerequisites and two open limitations
+
+A screen that hosts a `react-native-webview` `WebView` has capture behaviour
+beyond the config above:
+
+- **The WebView must be scrolled on screen.** A capture only records what is
+  currently visible — the native tree-walk skips subtrees outside the
+  viewport by design. A `WebView` sitting below the fold at the default
+  scroll position yields a layout with no WebView nodes at all, which looks
+  exactly like WebView capture never engaged. Scroll it fully into view
+  before triggering (or waiting on) a capture.
+- **`GoogleWebViewEnabled`** is a top-level `Connect` key (Android only,
+  default `true`) that gates whether the SDK instruments WebViews at all:
+
+  ```json
+  { "Connect": { "GoogleWebViewEnabled": false } }
+  ```
+
+  Set to `false`, the SDK does not discover or walk into any `WebView` on the
+  screen — the rest of that screen still captures normally. It does not gate
+  anything else on this list: screen views, clicks, and non-WebView layout
+  content are unaffected either way.
+- **A discovered WebView currently drops that screen's whole layout
+  message.** Once the SDK finds a `WebView`, it waits for a DOM-capture
+  correlation id from the page before it can finish and post the layout — and
+  a React Native-hosted `WebView` never supplies one, so the wait never
+  resolves and the *entire* screen's layout message is dropped, not just the
+  WebView's portion. Confirmed present in Android Connect **11.0.23-beta**, the
+  newest published artifact at the time of writing, and in every earlier version
+  in the supported range — measured on an emulator, where a capture on a screen
+  with a visible `WebView` posted **no messages at all** for that session, since
+  the layout's queue placeholder blocks the batch it sits in. There is no
+  client-side fix; `GoogleWebViewEnabled: false` (below) avoids it by not
+  instrumenting the `WebView` in the first place. A fix exists in the native SDK
+  but is not in any published artifact yet — check the Android Connect release
+  notes for a version above 11.0.23-beta before assuming this still applies.
+- **Enabling WebView capture replaces the app's `WebViewClient`.** The native
+  SDK installs its own `WebViewClient` on that `WebView` to instrument it, in
+  place of the one `react-native-webview` had set — so callbacks such as
+  `onHttpError` and `onNavigationStateChange` on that `WebView` stop firing
+  while capture is active. Same status as the item above: present through Android
+  Connect **11.0.23-beta**, fixed in the native SDK but not yet published, and
+  the rest of the screen is unaffected either way.
+
+Both of the limitations above only occur once the SDK is instrumenting a
+`WebView`, so `GoogleWebViewEnabled: false` avoids both — at the cost of
+getting no WebView capture on that screen at all.
+
 #### Capture timing (`CaptureLayoutDelay`)
 
 `AutoLayout.GlobalScreenSettings.CaptureLayoutDelay` is how long, in

package/android/src/main/assets/ConnectBasicConfig.properties

@@ -1,4 +1,4 @@
-#Wed Sep 09 11:26:30 GMT 2026
+#Thu Sep 10 10:55:20 GMT 2026
 UseWhiteList=true
 PrintScreen=3
 UseRandomSample=false

package/package.json

@@ -92,12 +92,15 @@
         "plugin/swift",
         "plugin/src",
         "cli",
+        "!cli/__tests__/**",
         "ConnectConfig.example.json",
         "*.podspec",
         "README.md",
         "CHANGELOG.md",
         "scripts",
         "Examples/SampleUI/**/*",
+        "!Examples/SampleUI/**/__tests__/**",
+        "!Examples/SampleUI/**/*.test.*",
         "!Examples/SampleUI/node_modules/**",
         "!Examples/SampleUI/temp/**",
         "!Examples/SampleUI/logs/**",
@@ -230,7 +233,7 @@
     "source": "src/index",
     "summary": "react-native ios android tealeaf connect cxa wxca er enhanced-replay",
     "types": "./lib/typescript/src/index.d.ts",
-    "version": "19.0.20",
+    "version": "19.0.22",
     "workspaces": [
         "example",
         "Examples/bare-workflow"

package/Examples/SampleUI/__tests__/App.test.tsx

@@ -1,17 +0,0 @@
-/**
- * @format
- */
-
-import 'react-native';
-import React from 'react';
-import App from '../App';
-
-// Note: import explicitly to use the types shipped with jest.
-import {it} from '@jest/globals';
-
-// Note: test renderer must be required after react-native.
-import renderer from 'react-test-renderer';
-
-it('renders correctly', () => {
-  renderer.create(<App />);
-});

package/Examples/SampleUI/src/styles/__tests__/fonts.test.js

@@ -1,290 +0,0 @@
-import configureFonts, { fontConfig } from '../fonts';
-import { typescale } from '../themes/v3/tokens';
-
-const mockPlatform = (OS) => {
-  jest.resetModules();
-  jest.doMock('react-native/Libraries/Utilities/Platform', () => ({
-    OS,
-    select: (objs) => objs[OS],
-  }));
-};
-
-const customFont = {
-  custom: {
-    fontFamily: 'sans-serif',
-    fontWeight: 'bold',
-  },
-};
-
-const customFontV3 = {
-  displayLarge: {
-    fontFamily: 'NotoSans',
-    letterSpacing: 0,
-    fontWeight: '400',
-    lineHeight: 64,
-    fontSize: 57,
-  },
-  displayMedium: {
-    fontFamily: 'NotoSans',
-    letterSpacing: 0,
-    fontWeight: '400',
-    lineHeight: 52,
-    fontSize: 45,
-  },
-  displaySmall: {
-    fontFamily: 'NotoSans',
-    letterSpacing: 0,
-    fontWeight: '400',
-    lineHeight: 44,
-    fontSize: 36,
-  },
-
-  headlineLarge: {
-    fontFamily: 'NotoSans',
-    letterSpacing: 0,
-    fontWeight: '400',
-    lineHeight: 40,
-    fontSize: 32,
-  },
-  headlineMedium: {
-    fontFamily: 'NotoSans',
-    letterSpacing: 0,
-    fontWeight: '400',
-    lineHeight: 36,
-    fontSize: 28,
-  },
-  headlineSmall: {
-    fontFamily: 'NotoSans',
-    letterSpacing: 0,
-    fontWeight: '400',
-    lineHeight: 32,
-    fontSize: 24,
-  },
-
-  titleLarge: {
-    fontFamily: 'NotoSans',
-    letterSpacing: 0,
-    fontWeight: '400',
-    lineHeight: 28,
-    fontSize: 22,
-  },
-  titleMedium: {
-    fontFamily: 'NotoSans',
-    letterSpacing: 0,
-    fontWeight: '500',
-    lineHeight: 24,
-    fontSize: 16,
-  },
-  titleSmall: {
-    fontFamily: 'NotoSans',
-    fontWeight: '500',
-    letterSpacing: 0,
-    lineHeight: 20,
-    fontSize: 14,
-  },
-
-  labelLarge: {
-    fontFamily: 'NotoSans',
-    fontWeight: '500',
-    letterSpacing: 0,
-    lineHeight: 20,
-    fontSize: 14,
-  },
-  labelMedium: {
-    fontFamily: 'NotoSans',
-    fontWeight: '500',
-    letterSpacing: 0,
-    lineHeight: 16,
-    fontSize: 12,
-  },
-  labelSmall: {
-    fontFamily: 'NotoSans',
-    fontWeight: '500',
-    letterSpacing: 0,
-    lineHeight: 16,
-    fontSize: 11,
-  },
-
-  bodyLarge: {
-    fontFamily: 'NotoSans',
-    letterSpacing: 0,
-    fontWeight: '400',
-    lineHeight: 24,
-    fontSize: 16,
-  },
-  bodyMedium: {
-    fontFamily: 'NotoSans',
-    fontWeight: '400',
-    letterSpacing: 0,
-    lineHeight: 20,
-    fontSize: 14,
-  },
-  bodySmall: {
-    fontFamily: 'NotoSans',
-    fontWeight: '400',
-    letterSpacing: 0,
-    lineHeight: 16,
-    fontSize: 12,
-  },
-
-  default: {
-    fontFamily: 'NotoSans',
-    letterSpacing: 0,
-    fontWeight: '400',
-  },
-};
-
-describe('configureFonts', () => {
-  it('adds custom fonts to the iOS config', () => {
-    mockPlatform('ios');
-    expect(
-      configureFonts({
-        config: {
-          ios: {
-            ...fontConfig.ios,
-            customFont,
-          },
-        },
-        isV3: false,
-      })
-    ).toEqual({
-      ...fontConfig.ios,
-      customFont,
-    });
-  });
-
-  it('adds custom fonts to the Android config', () => {
-    mockPlatform('android');
-    expect(
-      configureFonts({
-        config: {
-          android: {
-            ...fontConfig.android,
-            customFont,
-          },
-        },
-        isV3: false,
-      })
-    ).toEqual({
-      ...fontConfig.android,
-      customFont,
-    });
-  });
-
-  it('adds custom fonts to the Web config', () => {
-    mockPlatform('web');
-    expect(
-      configureFonts({
-        config: {
-          web: {
-            ...fontConfig.web,
-            customFont,
-          },
-        },
-        isV3: false,
-      })
-    ).toEqual({
-      ...fontConfig.web,
-      customFont,
-    });
-  });
-
-  it('overrides properties passed in config for all variants', () => {
-    expect(
-      configureFonts({
-        config: {
-          fontFamily: 'NotoSans',
-          letterSpacing: 0,
-        },
-      })
-    ).toEqual(customFontV3);
-  });
-
-  it('overrides properties passed in config for several variants', () => {
-    expect(
-      configureFonts({
-        config: {
-          bodyLarge: {
-            fontFamily: 'NotoSans',
-            fontSize: 18,
-            fontStyle: 'italic',
-          },
-          headlineMedium: {
-            fontSize: 30,
-          },
-          bodySmall: {
-            fontStyle: 'italic',
-          },
-        },
-      })
-    ).toEqual({
-      ...typescale,
-      bodyLarge: {
-        fontFamily: 'NotoSans',
-        letterSpacing: 0.15,
-        fontWeight: '400',
-        fontStyle: 'italic',
-        lineHeight: 24,
-        fontSize: 18,
-      },
-      headlineMedium: {
-        fontFamily: 'System',
-        letterSpacing: 0,
-        fontWeight: '400',
-        lineHeight: 36,
-        fontSize: 30,
-      },
-      bodySmall: {
-        fontFamily: 'System',
-        fontWeight: '400',
-        fontStyle: 'italic',
-        letterSpacing: 0.4,
-        lineHeight: 16,
-        fontSize: 12,
-      },
-    });
-  });
-
-  it('adds custom variant to theme fonts', () => {
-    expect(
-      configureFonts({
-        config: {
-          customVariant: {
-            fontFamily: 'NotoSans',
-            letterSpacing: 0,
-            fontWeight: '400',
-            fontStyle: 'italic',
-            lineHeight: 64,
-            fontSize: 57,
-          },
-        },
-      })
-    ).toEqual({
-      ...typescale,
-      customVariant: {
-        fontFamily: 'NotoSans',
-        letterSpacing: 0,
-        fontWeight: '400',
-        fontStyle: 'italic',
-        lineHeight: 64,
-        fontSize: 57,
-      },
-    });
-  });
-
-  it('should be deterministic', () => {
-    // first call that should not mutate the original config
-    configureFonts({
-      config: {
-        labelMedium: {
-          color: 'coral',
-        },
-      },
-    });
-
-    // second call that should return the original config without modification
-    const fontsB = configureFonts({ config: {} });
-
-    expect(fontsB.labelMedium.color).toBeUndefined();
-  });
-});

package/cli/__tests__/doctor.test.mjs

@@ -1,88 +0,0 @@
-// Copyright (C) 2026 Acoustic, L.P. All rights reserved.
-//
-// Unit tests for ensureConnectConfig's local→bundled→missing fallback in
-// cli/doctor.mjs. Uses Node's built-in test runner (node:test) — no build
-// step needed, cli/ is plain ESM.
-//
-//   npm run test:cli
-
-import { test } from 'node:test'
-import assert from 'node:assert/strict'
-import * as fs from 'node:fs'
-import * as os from 'node:os'
-import * as path from 'node:path'
-
-import { ensureConnectConfig } from '../doctor.mjs'
-import { Reporter } from '../lib.mjs'
-
-function tmpDir() {
-  return fs.mkdtempSync(path.join(os.tmpdir(), 'connect-doctor-test-'))
-}
-
-// ensureConnectConfig's 'exists' branch reports as `pass('ConnectConfig.json present')`
-// (label includes the detail) while the other branches use a plain
-// 'ConnectConfig.json' label with a separate detail string — match by prefix
-// so the assertion doesn't depend on that formatting quirk.
-function statusFor(reporter, labelPrefix) {
-  return reporter.results.find((r) => r.label.startsWith(labelPrefix))?.status
-}
-
-test('ensureConnectConfig: prefers a project-local ConnectConfig.example.json over the bundled one', () => {
-  const dir = tmpDir()
-  fs.writeFileSync(
-    path.join(dir, 'ConnectConfig.example.json'),
-    JSON.stringify({ Connect: { AppKey: 'from-local-example' } }),
-  )
-  const reporter = new Reporter()
-
-  ensureConnectConfig(reporter, dir, {
-    bundledExample: path.join(dir, 'never-read.json'),
-  })
-
-  const written = JSON.parse(fs.readFileSync(path.join(dir, 'ConnectConfig.json'), 'utf8'))
-  assert.equal(written.Connect.AppKey, 'from-local-example')
-  assert.equal(statusFor(reporter, 'ConnectConfig.json'), 'warn')
-})
-
-test('ensureConnectConfig: falls back to the bundled example when no project-local one exists', () => {
-  const dir = tmpDir()
-  const bundledDir = tmpDir()
-  const bundledExample = path.join(bundledDir, 'ConnectConfig.example.json')
-  fs.writeFileSync(bundledExample, JSON.stringify({ Connect: { AppKey: 'from-bundled-example' } }))
-  const reporter = new Reporter()
-
-  ensureConnectConfig(reporter, dir, { bundledExample })
-
-  const written = JSON.parse(fs.readFileSync(path.join(dir, 'ConnectConfig.json'), 'utf8'))
-  assert.equal(written.Connect.AppKey, 'from-bundled-example')
-  assert.equal(statusFor(reporter, 'ConnectConfig.json'), 'warn')
-})
-
-test('ensureConnectConfig: fails cleanly (no crash, no file written) when both are missing', () => {
-  const dir = tmpDir()
-  const reporter = new Reporter()
-
-  ensureConnectConfig(reporter, dir, {
-    bundledExample: path.join(dir, 'does-not-exist.json'),
-  })
-
-  assert.equal(fs.existsSync(path.join(dir, 'ConnectConfig.json')), false)
-  assert.equal(statusFor(reporter, 'ConnectConfig.json'), 'fail')
-})
-
-test('ensureConnectConfig: never overwrites an existing ConnectConfig.json', () => {
-  const dir = tmpDir()
-  fs.writeFileSync(
-    path.join(dir, 'ConnectConfig.json'),
-    JSON.stringify({ Connect: { AppKey: 'already-configured' } }),
-  )
-  const reporter = new Reporter()
-
-  ensureConnectConfig(reporter, dir, {
-    bundledExample: path.join(dir, 'never-read.json'),
-  })
-
-  const written = JSON.parse(fs.readFileSync(path.join(dir, 'ConnectConfig.json'), 'utf8'))
-  assert.equal(written.Connect.AppKey, 'already-configured')
-  assert.equal(statusFor(reporter, 'ConnectConfig.json'), 'pass')
-})