@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 +83 -0
- package/README.md +51 -10
- package/dist/index.d.mts +356 -249
- package/dist/index.d.ts +356 -249
- package/dist/index.js +2261 -1760
- package/dist/index.mjs +2198 -1694
- package/package.json +2 -2
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
|
-
|
|
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
|
|
243
|
-
|
|
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
|
|
246
|
-
approval is pending.
|
|
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
|
-
|
|
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
|
-
|
|
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
|
|
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>
|