@tapthrough/expo 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tapthrough contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,106 @@
-# Temporary Holding Version
+# @tapthrough/expo
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The [Tapthrough](https://github.com/tapthrough/tapthrough) SDK for Expo Router apps. When a reviewer opens
+a pull request's preview link, the app:
+
+1. sends the link token to your [seed hook](../seed), which creates a fresh test user in staging
+2. clears local state: query caches, persisted keys, stores
+3. logs in as that user
+4. applies the scenario's feature flags
+5. opens the screen the PR changed
+
+When the app opens any other way, the SDK does nothing.
+
+```sh
+npx expo install @tapthrough/expo
+```
+
+## Setup
+
+### 1. Config plugin
+
+```ts
+// app.config.ts
+export default {
+  scheme: 'acmenotes',
+  plugins: [
+    [
+      '@tapthrough/expo',
+      {
+        enabled: process.env.APP_VARIANT === 'preview',
+        seedHookUrl: 'https://<ref>.supabase.co/functions/v1/tapthrough-seed',
+      },
+    ],
+  ],
+}
+```
+
+The SDK ignores launch links unless `enabled` is true, so keep it off for store builds. The plugin
+requires a `scheme`, because links open `<scheme>://tapthrough/launch?t=<token>`.
+
+### 2. Wrap the root layout
+
+```tsx
+// app/_layout.tsx
+import { resetQueryClient, resetStorage, Tapthrough } from '@tapthrough/expo'
+import { supabaseAuth } from '@tapthrough/expo/supabase'
+import AsyncStorage from '@react-native-async-storage/async-storage'
+import { Stack } from 'expo-router'
+
+const auth = supabaseAuth(supabase)
+const reset = [resetQueryClient(queryClient), resetStorage(AsyncStorage, ['notes-store'])]
+
+export default function RootLayout() {
+  return (
+    <QueryClientProvider client={queryClient}>
+      <Tapthrough auth={auth} reset={reset}>
+        <Stack />
+      </Tapthrough>
+    </QueryClientProvider>
+  )
+}
+```
+
+Define `auth` and `reset` outside the component, or memoize them, so they don't change on every render.
+
+`reset` runs **before** sign-in, so a listed key can't wipe the new session. List only your app's own
+keys, not the auth client's.
+
+### 3. Hand launch links to the SDK
+
+```ts
+// app/+native-intent.ts
+export { redirectSystemPath } from '@tapthrough/expo'
+```
+
+Without this file, Expo Router tries to open `/tapthrough/launch` as a screen and shows its "not found"
+page. If you already have a `redirectSystemPath`, call `handleLaunchPath(path)` first and return `'/'`
+(or `null` when the app was already open) when it returns true.
+
+### 4. Read flag overrides
+
+```ts
+import { useFlagOverride } from '@tapthrough/expo'
+
+const newEditor = useFlagOverride('newEditor') ?? flags.newEditor
+```
+
+Outside React, use `getFlagOverride(name)`.
+
+## API
+
+| Export | Does |
+| --- | --- |
+| `<Tapthrough auth reset? seedHookUrl? enabled?>` | Runs the launch sequence and shows a loading screen, or an error card the reviewer can dismiss. `seedHookUrl` and `enabled` override the plugin. |
+| `redirectSystemPath`, `handleLaunchPath(path)` | For `+native-intent`, as above. |
+| `supabaseAuth(client)` from `@tapthrough/expo/supabase` | Logs in with the `{ access_token, refresh_token }` that `createTestUser` returns. |
+| `resetQueryClient(client)`, `resetStorage(storage, keys)`, `resetStores(stores)` | Reset targets for TanStack Query, AsyncStorage or MMKV, and Zustand. A reset target is any `() => void \| Promise<void>`. |
+| `useFlagOverride(name)`, `getFlagOverride(name)`, `getFlagOverrides()` | The scenario's flag values. `undefined` means the scenario leaves that flag alone. |
+| `useLaunchState()` | `idle`, `launching`, `done` (with `path`) or `error` (with `error.code` and `error.message`). |
+
+Any other auth provider works through `auth={{ signIn: async (session) => { … } }}`, where `session` is
+whatever your seed hook returns.
+
+## License
+
+MIT

package/app.plugin.d.ts

@@ -0,0 +1,37 @@
+export interface TapthroughPluginProps {
+  /** Turns the SDK on for this build. Defaults to true; set false for store builds. */
+  enabled?: boolean
+  /** Your seed hook, e.g. `https://<ref>.supabase.co/functions/v1/tapthrough-seed`. */
+  seedHookUrl?: string
+  /** Tapthrough's base URL, where in-app reports go. Defaults to `https://tapthrough.dev`. */
+  apiUrl?: string
+  /**
+   * Staging and TestFlight builds: shows a feedback button outside PR previews,
+   * to report issues and share ideas. Never turn it on for store builds.
+   */
+  staff?: boolean
+  /** The repo's app key from `npx @tapthrough/cli app-key`; required with `staff`. */
+  appKey?: string
+}
+
+type ExpoConfig = { scheme?: string | string[]; extra?: Record<string, unknown> } & Record<
+  string,
+  unknown
+>
+
+declare function withTapthrough<T extends ExpoConfig>(
+  config: T,
+  props?: TapthroughPluginProps,
+): T & {
+  extra: NonNullable<T['extra']> & {
+    tapthrough: {
+      enabled: boolean
+      seedHookUrl: string | undefined
+      apiUrl?: string
+      staff?: boolean
+      appKey?: string
+    }
+  }
+}
+
+export = withTapthrough

package/app.plugin.js

@@ -0,0 +1,79 @@
+// @ts-check
+/**
+ * Expo config plugin. Writes the SDK's build-time settings into `extra.tapthrough`.
+ *
+ *   plugins: [['@tapthrough/expo', {
+ *     // PR previews: launch links, test data, the checklist.
+ *     enabled: process.env.APP_VARIANT === 'development',
+ *     seedHookUrl: 'https://<ref>.supabase.co/functions/v1/tapthrough-seed',
+ *     // Staging and TestFlight builds: report issues and share ideas.
+ *     staff: process.env.APP_VARIANT === 'staging',
+ *     appKey: process.env.TAPTHROUGH_APP_KEY,
+ *   }]]
+ *
+ * Keep both off for store builds. With `enabled` off the SDK ignores launch
+ * links; with `staff` off there's no feedback button outside PR previews.
+ *
+ * @param {{ expo?: unknown } & Record<string, any>} config
+ * @param {{ enabled?: boolean, seedHookUrl?: string, apiUrl?: string, staff?: boolean, appKey?: string }} [props]
+ */
+function withTapthrough(config, props = {}) {
+  const enabled = props.enabled ?? true
+  const staff = props.staff === true
+  const seedHookUrl = props.seedHookUrl
+  const apiUrl = props.apiUrl ?? 'https://tapthrough.dev'
+
+  if (enabled || staff) {
+    if (!isAllowedUrl(apiUrl)) {
+      throw new Error(
+        `[@tapthrough/expo] \`apiUrl\` must be https (http is allowed only for localhost): ${apiUrl}`,
+      )
+    }
+  }
+  if (enabled) {
+    // Optional: without it, links open the right screen but can't add test data.
+    if (seedHookUrl && !isAllowedUrl(seedHookUrl)) {
+      throw new Error(
+        `[@tapthrough/expo] \`seedHookUrl\` must be https (http is allowed only for localhost): ${seedHookUrl}`,
+      )
+    }
+    if (!config.scheme) {
+      throw new Error(
+        '[@tapthrough/expo] Set `scheme` in your app config; launch links open `<scheme>://tapthrough/launch`.',
+      )
+    }
+  }
+  if (staff && !props.appKey) {
+    throw new Error(
+      '[@tapthrough/expo] `staff` needs an `appKey`. Make one with `npx @tapthrough/cli app-key` and pass it from an environment variable.',
+    )
+  }
+
+  return {
+    ...config,
+    extra: {
+      ...config.extra,
+      tapthrough: {
+        enabled,
+        seedHookUrl: enabled ? seedHookUrl : undefined,
+        ...(enabled || staff ? { apiUrl } : {}),
+        // The key only goes into builds that use it.
+        ...(staff ? { staff, appKey: props.appKey } : {}),
+      },
+    },
+  }
+}
+
+/** @param {string} url */
+function isAllowedUrl(url) {
+  try {
+    const { protocol, hostname } = new URL(url)
+    if (protocol === 'https:') return true
+    // 10.0.2.2 is the host machine from the Android emulator.
+    return protocol === 'http:' && ['localhost', '127.0.0.1', '10.0.2.2'].includes(hostname)
+  } catch {
+    return false
+  }
+}
+
+module.exports = withTapthrough

package/dist/Annotator.d.ts

@@ -0,0 +1,14 @@
+import { type Annotation } from './core/annotations.js';
+import type { Screenshot } from './screenshot.js';
+/**
+ * Full-screen markup for a report's screenshot: Draw to circle or point at
+ * something freehand, Box to outline it, Blur to hide personal data. The
+ * server applies the marks before storing the image.
+ */
+export declare function Annotator({ screenshot, initial, onDone, onCancel, }: {
+    screenshot: Screenshot;
+    initial: Annotation[];
+    onDone: (marks: Annotation[]) => void;
+    onCancel: () => void;
+}): import("react").JSX.Element;
+//# sourceMappingURL=Annotator.d.ts.map

package/dist/Annotator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Annotator.d.ts","sourceRoot":"","sources":["../src/Annotator.tsx"],"names":[],"mappings":"AAWA,OAAO,EACL,KAAK,UAAU,EAOhB,MAAM,uBAAuB,CAAA;AAE9B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAUjD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,EACxB,UAAU,EACV,OAAO,EACP,MAAM,EACN,QAAQ,GACT,EAAE;IACD,UAAU,EAAE,UAAU,CAAA;IACtB,OAAO,EAAE,UAAU,EAAE,CAAA;IACrB,MAAM,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,IAAI,CAAA;IACrC,QAAQ,EAAE,MAAM,IAAI,CAAA;CACrB,+BA0JA"}

package/dist/Annotator.js

@@ -0,0 +1,160 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useEffect, useMemo, useRef, useState } from 'react';
+import { Animated, Image, PanResponder, Pressable, StyleSheet, Text, useWindowDimensions, View, } from 'react-native';
+import { addStrokePoint, boxFromDrag, finishStroke, MAX_ANNOTATIONS, strokeSegments, } from './core/annotations.js';
+import { useBackPress } from './Overlay.js';
+const MODES = [
+    { mode: 'draw', title: 'Draw', hint: 'Draw on the screenshot to circle or point at something.' },
+    { mode: 'highlight', title: 'Box', hint: 'Drag on the screenshot to draw a box.' },
+    { mode: 'blur', title: 'Blur', hint: 'Drag over anything private to blur it.' },
+];
+/**
+ * Full-screen markup for a report's screenshot: Draw to circle or point at
+ * something freehand, Box to outline it, Blur to hide personal data. The
+ * server applies the marks before storing the image.
+ */
+export function Annotator({ screenshot, initial, onDone, onCancel, }) {
+    const window = useWindowDimensions();
+    const [boxes, setBoxes] = useState(initial);
+    const [kind, setKind] = useState('draw');
+    const [draft, setDraft] = useState(null);
+    const [aspect, setAspect] = useState(window.width / window.height);
+    const uri = `data:${screenshot.contentType};base64,${screenshot.base64}`;
+    const shown = useRef(new Animated.Value(0)).current;
+    useBackPress(onCancel);
+    useEffect(() => {
+        Animated.timing(shown, { toValue: 1, duration: 180, useNativeDriver: true }).start();
+    }, [shown]);
+    // The image is shown at the screenshot's aspect ratio, so fractions map 1:1.
+    const maxWidth = window.width - 32;
+    const maxHeight = window.height - 200;
+    const width = Math.min(maxWidth, maxHeight * aspect);
+    const height = width / aspect;
+    const state = useRef({
+        start: { x: 0, y: 0 },
+        draft: null,
+        points: [],
+        kind,
+        boxes,
+    });
+    state.current.kind = kind;
+    state.current.boxes = boxes;
+    const responder = useMemo(() => PanResponder.create({
+        onStartShouldSetPanResponder: () => true,
+        onMoveShouldSetPanResponder: () => true,
+        onPanResponderGrant: (event) => {
+            const start = { x: event.nativeEvent.locationX, y: event.nativeEvent.locationY };
+            state.current.start = start;
+            state.current.draft = null;
+            state.current.points =
+                state.current.kind === 'draw' ? addStrokePoint([], start, { width, height }) : [];
+        },
+        onPanResponderMove: (_event, gesture) => {
+            const { start, kind: mode } = state.current;
+            const at = { x: start.x + gesture.dx, y: start.y + gesture.dy };
+            if (mode === 'draw') {
+                const points = addStrokePoint(state.current.points, at, { width, height });
+                if (points === state.current.points)
+                    return;
+                state.current.points = points;
+                const stroke = { kind: 'draw', points };
+                state.current.draft = stroke;
+                setDraft(stroke);
+                return;
+            }
+            const next = boxFromDrag(mode, start, at, { width, height });
+            state.current.draft = next;
+            setDraft(next);
+        },
+        onPanResponderRelease: () => {
+            const { draft: current } = state.current;
+            const finished = current?.kind === 'draw' ? finishStroke(current.points) : current;
+            if (finished && state.current.boxes.length < MAX_ANNOTATIONS) {
+                setBoxes([...state.current.boxes, finished]);
+            }
+            state.current.draft = null;
+            setDraft(null);
+        },
+    }), [width, height]);
+    return (_jsx(Animated.View, { style: [StyleSheet.absoluteFill, { opacity: shown }], accessibilityViewIsModal: true, children: _jsxs(View, { style: styles.screen, children: [_jsxs(View, { style: styles.toolbar, children: [_jsx(Pressable, { onPress: onCancel, accessibilityRole: "button", hitSlop: 8, children: _jsx(Text, { style: styles.toolbarText, children: "Cancel" }) }), _jsx(View, { style: styles.modes, children: MODES.map(({ mode, title }) => (_jsx(Pressable, { onPress: () => setKind(mode), style: [styles.mode, kind === mode && styles.modeActive], accessibilityRole: "radio", accessibilityState: { selected: kind === mode }, children: _jsx(Text, { style: [styles.modeText, kind === mode && styles.modeTextActive], children: title }) }, mode))) }), _jsx(Pressable, { onPress: () => onDone(boxes), accessibilityRole: "button", hitSlop: 8, children: _jsx(Text, { style: [styles.toolbarText, styles.done], children: "Done" }) })] }), _jsxs(View, { style: { width, height }, ...responder.panHandlers, children: [_jsx(Image, { source: { uri }, style: { width, height }, onLoad: (event) => {
+                                const { width: w, height: h } = event.nativeEvent.source;
+                                if (w && h)
+                                    setAspect(w / h);
+                            }, accessibilityLabel: "Screenshot to mark up" }), [...boxes, ...(draft ? [draft] : [])].map((box, index) => box.kind === 'draw' ? (
+                        // biome-ignore lint/suspicious/noArrayIndexKey: marks have no identity beyond their order
+                        _jsx(Stroke, { points: box.points, width: width, height: height }, index)) : (_jsx(View
+                        // biome-ignore lint/suspicious/noArrayIndexKey: boxes have no identity beyond their order
+                        , { pointerEvents: "none", style: [
+                                styles.box,
+                                box.kind === 'blur' ? styles.blurBox : styles.highlightBox,
+                                {
+                                    left: box.x * width,
+                                    top: box.y * height,
+                                    width: box.w * width,
+                                    height: box.h * height,
+                                },
+                            ], children: box.kind === 'blur' ? _jsx(Text, { style: styles.blurLabel, children: "Blurred" }) : null }, index)))] }), _jsxs(View, { style: styles.footer, children: [_jsx(Text, { style: styles.hint, children: boxes.length === 0
+                                ? MODES.find((m) => m.mode === kind)?.hint
+                                : boxes.length >= MAX_ANNOTATIONS
+                                    ? `${MAX_ANNOTATIONS} marks is the most. Undo one to add another.`
+                                    : `${boxes.length} mark${boxes.length === 1 ? '' : 's'}` }), boxes.length > 0 ? (_jsx(Pressable, { onPress: () => setBoxes(boxes.slice(0, -1)), accessibilityRole: "button", hitSlop: 8, children: _jsx(Text, { style: styles.toolbarText, children: "Undo" }) })) : null] })] }) }));
+}
+const STROKE_WIDTH = 4;
+/** A freehand mark, drawn as short rotated bars so it needs no SVG library. */
+function Stroke({ points, width, height, }) {
+    return (_jsx(_Fragment, { children: strokeSegments(points, { width, height }).map((segment, i) => (_jsx(View
+        // biome-ignore lint/suspicious/noArrayIndexKey: segments are positional
+        , { pointerEvents: "none", style: [
+                styles.segment,
+                {
+                    left: segment.left,
+                    top: segment.top - STROKE_WIDTH / 2,
+                    // A little longer than the gap, so joints don't show.
+                    width: segment.length + STROKE_WIDTH / 2,
+                    transform: [{ rotate: `${segment.angle}rad` }],
+                },
+            ] }, i))) }));
+}
+const styles = StyleSheet.create({
+    segment: {
+        position: 'absolute',
+        height: STROKE_WIDTH,
+        borderRadius: STROKE_WIDTH / 2,
+        backgroundColor: '#e5484d',
+    },
+    screen: {
+        flex: 1,
+        alignItems: 'center',
+        justifyContent: 'center',
+        gap: 16,
+        backgroundColor: '#111114',
+        paddingVertical: 48,
+    },
+    toolbar: {
+        width: '100%',
+        paddingHorizontal: 16,
+        flexDirection: 'row',
+        alignItems: 'center',
+        justifyContent: 'space-between',
+    },
+    toolbarText: { color: '#ffffff', fontSize: 16 },
+    done: { fontWeight: '700', color: '#8ab4f8' },
+    modes: { flexDirection: 'row', borderRadius: 999, backgroundColor: '#2a2b31', padding: 3 },
+    mode: { paddingVertical: 6, paddingHorizontal: 14, borderRadius: 999 },
+    modeActive: { backgroundColor: '#ffffff' },
+    modeText: { color: '#d4d4d8', fontSize: 14, fontWeight: '600' },
+    modeTextActive: { color: '#111114' },
+    box: { position: 'absolute', borderRadius: 6, alignItems: 'center', justifyContent: 'center' },
+    highlightBox: { borderWidth: 3, borderColor: '#e5484d' },
+    blurBox: { backgroundColor: 'rgba(40, 40, 46, 0.85)' },
+    blurLabel: { color: '#ffffff', fontSize: 12, fontWeight: '600' },
+    footer: {
+        width: '100%',
+        paddingHorizontal: 16,
+        flexDirection: 'row',
+        alignItems: 'center',
+        justifyContent: 'space-between',
+    },
+    hint: { color: '#a1a1aa', fontSize: 14 },
+});
+//# sourceMappingURL=Annotator.js.map

package/dist/Annotator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Annotator.js","sourceRoot":"","sources":["../src/Annotator.tsx"],"names":[],"mappings":"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"}

package/dist/Bubble.d.ts

@@ -0,0 +1,27 @@
+import { type Bounds, type Point } from './core/bubble.js';
+import type { Badge } from './core/feedback.js';
+/** The screen, less conservative insets for the status bar and home indicator. */
+export declare function screenBounds(width: number, height: number): Bounds;
+/**
+ * A small, draggable Review button. Drag it anywhere; it snaps to the nearer
+ * side. It fades while idle so it stays out of the way of the app under test.
+ */
+export declare function Bubble({ onPress, badge, busy, active, onRest, }: {
+    onPress: () => void;
+    badge: Badge | null;
+    busy: boolean;
+    /** The popover is open: show ✕, stay fully visible and hide the badge. */
+    active?: boolean;
+    /** Where the button settles, so the popover can open beside it. */
+    onRest?: (at: Point) => void;
+}): import("react").JSX.Element;
+export declare const COLORS: {
+    ink: string;
+    tape: string;
+    tapeInk: string;
+    /** Steps left: the iOS system blue, the SDK's one tint. */
+    count: string;
+    pass: string;
+    fail: string;
+};
+//# sourceMappingURL=Bubble.d.ts.map

package/dist/Bubble.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Bubble.d.ts","sourceRoot":"","sources":["../src/Bubble.tsx"],"names":[],"mappings":"AAWA,OAAO,EACL,KAAK,MAAM,EAIX,KAAK,KAAK,EAEX,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAW/C,kFAAkF;AAClF,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAQlE;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,EACrB,OAAO,EACP,KAAK,EACL,IAAI,EACJ,MAAc,EACd,MAAM,GACP,EAAE;IACD,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB,IAAI,EAAE,OAAO,CAAA;IACb,0EAA0E;IAC1E,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,mEAAmE;IACnE,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,KAAK,KAAK,IAAI,CAAA;CAC7B,+BA0JA;AAuDD,eAAO,MAAM,MAAM;;;;IAIjB,2DAA2D;;;;CAI5D,CAAA"}