@testerpaykit/expo 2.2.0 → 2.3.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.
package/CHANGELOG.md CHANGED
@@ -2,6 +2,89 @@
2
2
 
3
3
  All notable changes to `@testerpaykit/expo` are documented here.
4
4
 
5
+ ## 2.3.0 — 2026-11-18
6
+
7
+ - Exported `buildSheetMore` (+ types `SheetMore`, `SheetMoreInput`) for apps that compose `FloatingFeedbackButton` and `VoiceBugInputSheet` themselves.
8
+
9
+ ### Changed (one tap, one sheet — issue #5)
10
+ - A tap on the floating button always opens the report sheet
11
+ (`VoiceBugInputSheet`); the popup menu and the long press are gone (the
12
+ menu ran off the screen depending on where the button sat). The first tour
13
+ still comes with the very first tap, the daily briefing before the sheet
14
+ when due; where they opened the menu they now open the sheet.
15
+ - The sheet starts with speaking the bug, or, with `reportMode: 'form'`, with
16
+ a write button instead of the mic ("Lieber tippen" is hidden then).
17
+ - A bar at the bottom of the sheet (only while idle): equal tiles "Was
18
+ testen?" / "What to test" with the open count (only when the checklist has
19
+ tasks; otherwise "Nachtests" / "Retests" with the pending count), "Meine
20
+ Bugs" / "My Bugs", "Nachrichten" / "Messages" with the unread count, and
21
+ "Alles" / "All" (badge: the retest count while the checklist tile is
22
+ shown). Tiles: icon over label, red badge top right, test IDs
23
+ `tpk-sheet-checklist|retests|bugs|messages|all`.
24
+ - "Alles" shows a page with "Zurück zum Melden" / "Back to report" and every
25
+ former menu entry as a scrollable list (handle, role line, confirmed
26
+ earnings, then the entries in the old order). A tile or list entry closes
27
+ the sheet first and runs its action after the close (400 ms).
28
+ - Layout: the sheet is solid (host text no longer shows through the title)
29
+ except while recording; the category chips scroll sideways instead of
30
+ being cut off ("Probl…"); the four one-tap buttons are equal in a 2×2
31
+ grid. `sheetOpacity` now only sets the scrim.
32
+ - Accessibility: label "TesterPayKit", hint "Tippen, um einen Bug zu melden
33
+ oder mehr zu sehen." / "Tap to report a bug or see more."; no named
34
+ actions. Tour: "Die Leiste unten im Fenster hat alles Weitere." / "The bar
35
+ at the bottom of the sheet has everything else."
36
+
37
+ ### Added (Login with TPK: tester identity and test persona)
38
+ - Connect dialog reworked: "Wer testet hier?" / "Who is testing?" with three
39
+ reassurances (your sign-in stays, nothing to type, works for every app you
40
+ test through TesterPayKit), primary "Mit TPK verbinden" / "Connect with
41
+ TPK", secondary "Nicht jetzt" / "Not now". The link, app opening and
42
+ polling are unchanged. TPK is only the tester identity; the host app's own
43
+ sign-in stays as it is.
44
+ - Role picker right after a successful connect (`PersonaFlow`): "Verbunden
45
+ als <name>", "Aus wessen Sicht testest du?"; "Ich selbst" / "Myself"
46
+ first and the default, the developer's suggestions next with a
47
+ "vorgeschlagen" / "suggested" badge, then the rest. `PUT
48
+ /v1/testers/me/personas` only when the choice changed. Briefing card
49
+ ("Deine Rolle für diesen Test", "Achte besonders auf", privacy line,
50
+ "Los geht's") for a made-up role; skipped for "Myself". `GET` 404 or
51
+ offline skips the picker silently.
52
+ - Entry "Rolle wählen" / "Choose role" in the sheet's "Alles" list (once the
53
+ roles loaded) and the hint "Du testest als <Titel> (gespielt)" / "Testing
54
+ as <title> (played)" in that list and next to the button while a role is
55
+ chosen. `FloatingFeedbackButton`: new `personaTitle`.
56
+ - Host-app API, test builds only: `tpk.persona` (`{ id, title, attributes }`,
57
+ title in the device language, `null` for "Myself" and always in a `store`
58
+ build), `tpk.onPersonaChange(listener)`, `useTpkPersona(client)`,
59
+ `tpk.loadPersonas()`, `tpk.choosePersona(id | null)`. In a `store` build
60
+ no persona request is sent. Types `TpkPersona`, `PersonaCatalog`,
61
+ `PersonaOption`, `PersonaText`; component `PersonaFlow`.
62
+
63
+ ### Removed
64
+ - The connect dialog's "Noch keine TPK-App?" / "No TPK app yet?" link and
65
+ its ✕: the primary button already falls back to the web page when no app
66
+ takes the scheme, and "Nicht jetzt" closes.
67
+
68
+ ### Breaking
69
+ - `FloatingFeedbackButton` is now only the button: props `onOpen` (replaces
70
+ `onReportBug`), `onDailyBriefing(openSheet)`, `onTourShown`,
71
+ `unreadMessageCount`, `notificationCount`, `personaTitle`, `position`,
72
+ `style`, `testID`, `enableFirstTapTour`, `tourStorage`. All menu props
73
+ (`onGeneralFeedback`, `onDetailedReport`, `onViewDashboard`,
74
+ `onShowMyMoney`, `testerHandle`, `onMenuOpened`, `onEndSession`,
75
+ `onShowRetests`, `retestCount`, `onShowDebugLogs`, `onShowMyBugs`,
76
+ `onShowSessionDetails`, `onShowMessages`, `onAutoTest`, `onShowChecklist`,
77
+ `checklistCount`, `onShowPersona`, `onSendToClaude`, `onToggleLiveLink`,
78
+ `liveLinkConnected`, `voiceFirst`, `onFlushCachedCrashes`,
79
+ `confirmedEarnings`) are gone; the wrapper feeds the sheet instead.
80
+ `onLongPressVoiceBug` is gone too.
81
+ - `VoiceBugInputSheet`: new optional `more` (bar and list, built by the
82
+ wrapper) and `formFirst`.
83
+ - Removed: the first-time menu hint and its storage key
84
+ `tpk-fab-menu-hint-seen` (`hasSeenFabMenuHint`, `markFabMenuHintSeen`,
85
+ `FAB_MENU_HINT_MS`), the strings `menuOpen`, `menuClose`, `fabTapAction`,
86
+ `fabLongPressAction`, `fabMenuHint`; `fabA11yHint` is a plain string.
87
+
5
88
  ## 2.2.0 — 2026-11-15
6
89
 
7
90
  ### Changed (voice first)
package/README.md CHANGED
@@ -193,8 +193,7 @@ function FeedbackControls() {
193
193
  return (
194
194
  <>
195
195
  <FloatingFeedbackButton
196
- disabled={!ready}
197
- onPress={() => setOpen(true)}
196
+ onOpen={() => ready && setOpen(true)}
198
197
  />
199
198
  <BugReportSheet
200
199
  currentScreen="Home"
@@ -239,17 +238,52 @@ await tpk.refreshAccess(); // re-asks the server (offline keeps the cache)
239
238
  await tpk.openVerification(); // your own "Become a tester" entry
240
239
  ```
241
240
 
242
- `openVerification()` opens the wrapper's sheet "Confirm once with the TPK
243
- app" when the number is not confirmed yet: it opens the TPK app
241
+ `openVerification()` opens the wrapper's connect dialog "Wer testet hier?" /
242
+ "Who is testing?" when the number is not confirmed yet. Its button "Mit TPK
243
+ verbinden" / "Connect with TPK" opens the TPK app
244
244
  (`testerpaykit://link/…`, else the web page with an install hint), waits for
245
- the person to allow it there and then closes on its own. It says so when the
246
- approval is pending. Access is
245
+ the person to allow it there and then closes on its own; "Nicht jetzt" /
246
+ "Not now" closes it. It says so when the approval is pending. TPK is only
247
+ the tester's identity here: your app's own sign-in stays as it is, and
248
+ nothing is typed into your app. Access is
247
249
  re-checked whenever the app comes to the front; any 403
248
250
  `phone_required` / `approval_required` hides the widget at once. If you
249
251
  render `<TpkOnboarding>` or `<TpkWelcomeSheet>` yourself, render them only
250
252
  while `tpk.access === 'ready'`.
251
253
 
252
- Wrapper options for the menu: `enableTesterDashboard` (default true),
254
+ ### Login with TPK: test persona
255
+
256
+ Right after a successful connect, the wrapper shows a picker "Aus wessen
257
+ Sicht testest du?" / "Whose eyes are you testing with?". "Ich selbst" /
258
+ "Myself" is always the first row and the default; the roles the developer
259
+ suggested come next with a "vorgeschlagen" / "suggested" badge, then the
260
+ rest of the catalog. The tester decides; the developer can only suggest.
261
+ A made-up role opens a briefing card (the role, what to watch for, and the
262
+ note that the app sees only this role and that reports are marked
263
+ "gespielt"); "Ich selbst" skips it. Later the entry "Rolle wählen" /
264
+ "Choose role" in the sheet's "Alles" list opens the picker again, and while a role is chosen the overlay
265
+ says "Du testest als <Titel> (gespielt)" / "Testing as <title> (played)".
266
+ Reports and sessions carry the role on the server; the payloads need no
267
+ change. Not in the project yet (404) or offline: the picker is skipped
268
+ silently.
269
+
270
+ Your app may read the chosen role **in test builds only** (channel `beta`)
271
+ to prepare matching test data. It is made-up data, never anything real
272
+ about the tester. In a `store` build it is always `null` and the SDK sends
273
+ no persona request at all.
274
+
275
+ ```ts
276
+ tpk.persona; // { id, title, attributes } | null
277
+ // title: German on German devices, else English
278
+ // null = "Myself", not known yet, or a store build
279
+ tpk.onPersonaChange(() => …); // returns the unsubscribe
280
+ const persona = useTpkPersona(client); // hook, re-renders on change; client may be null
281
+
282
+ await tpk.loadPersonas(); // { current, persona, personas } | null (never throws)
283
+ await tpk.choosePersona(id); // PUT; id = null for "Myself"; throws when offline
284
+ ```
285
+
286
+ Wrapper options for the sheet's "Alles" list: `enableTesterDashboard` (default true),
253
287
  `showCompensation` (default true — false hides every amount, the money
254
288
  block of the daily briefing and the bug-bonus hint), `showDebugLogs`
255
289
  (default `__DEV__`).
@@ -260,6 +294,13 @@ tasks). Unread messages show as a yellow number on the FAB, new bug news
260
294
  as a banner for six seconds, and every submit ends with a thank-you that
261
295
  names the tester.
262
296
 
297
+ A tap on the button always opens one report sheet (no long press, no popup
298
+ menu). It starts with speaking the bug, or with a write button when
299
+ `reportMode="form"`. A bar at the bottom holds "Was testen?" (or "Nachtests"
300
+ while the checklist is empty), "Meine Bugs", "Nachrichten" and "Alles", which
301
+ switches the sheet to the list of everything else (feedback, money, session,
302
+ roles, live link, "Zurück zum Melden" to go back).
303
+
263
304
  ## What `TpkExpo.init()` does
264
305
 
265
306
  0. In a `store` build: nothing. It resolves to `null` (see
@@ -420,7 +461,7 @@ if (note) {
420
461
 
421
462
  ## Language
422
463
 
423
- Menu, bug report and voice sheet speak German on German devices and
464
+ Report sheet, bug report and voice sheet speak German on German devices and
424
465
  English everywhere else (device language via `expo-localization`). To
425
466
  pin one language for all testers:
426
467
 
@@ -540,8 +581,8 @@ The project's organisation must have AI features enabled.
540
581
 
541
582
  ## Live link to Claude Code
542
583
 
543
- For the developer's own device (dev build, TestFlight): two menu items
544
- connect the running app to the developer's Claude Code session.
584
+ For the developer's own device (dev build, TestFlight): two entries in the
585
+ sheet's "Alles" list connect the running app to the developer's Claude Code session.
545
586
 
546
587
  ```tsx
547
588
  <TesterPayKitWrapper tpk={tpk} enableLiveLink>