@goliapkg/sentori-react-native 3.1.0 → 5.0.0

package/src/feedback-widget.tsx

@@ -1,316 +0,0 @@
-// v0.9.1 #9 — Feedback Widget.
-//
-// `<FeedbackButton trigger="shake|manual|fab" />` — drop into the
-// app root, opens a modal prompt that submits via the existing
-// `sentori.sendUserFeedback` API. Shake detection is opt-in and
-// requires `expo-sensors` (Accelerometer) — falls back to manual
-// trigger if not installed. The button can also be controlled
-// programmatically via a ref: `feedbackRef.current.open()`.
-//
-// Aesthetic: very plain Modal + Text + TextInput so it adopts the
-// host app's color scheme without forcing a sentori theme on it.
-
-import React, {
-  forwardRef,
-  useCallback,
-  useEffect,
-  useImperativeHandle,
-  useRef,
-  useState,
-} from 'react';
-import {
-  Modal,
-  Pressable,
-  StyleSheet,
-  Text,
-  TextInput,
-  View,
-} from 'react-native';
-
-import { sendUserFeedback } from './capture';
-import { isAnyNativeModuleLinked } from './native-loader';
-
-type Trigger = 'fab' | 'manual' | 'shake';
-
-export type FeedbackButtonHandle = {
-  /** Open the feedback modal. Returns immediately. */
-  open: (defaults?: { body?: string; eventId?: string; title?: string }) => void;
-  /** Close the modal if open. */
-  close: () => void;
-};
-
-export type FeedbackButtonProps = {
-  /** When to surface the prompt. Default `'fab'`. */
-  trigger?: Trigger;
-  /** Pass the eventId from the last `captureException` to tie the
-   *  report to that crash. Optional. */
-  eventId?: string;
-  /** Localized strings. Defaults are English. */
-  labels?: {
-    title?: string;
-    bodyPlaceholder?: string;
-    emailPlaceholder?: string;
-    submit?: string;
-    cancel?: string;
-    sent?: string;
-  };
-  /** Shake sensitivity in m/s² above gravity. Default 18 (≈ a normal
-   *  intentional shake; lower triggers more easily). Only used when
-   *  `trigger="shake"`. */
-  shakeThreshold?: number;
-};
-
-export const FeedbackButton = forwardRef<FeedbackButtonHandle, FeedbackButtonProps>(
-  function FeedbackButton(props, ref) {
-    const trigger: Trigger = props.trigger ?? 'fab';
-    const [open, setOpen] = useState(false);
-    const [title, setTitle] = useState('');
-    const [body, setBody] = useState('');
-    const [email, setEmail] = useState('');
-    const [submitting, setSubmitting] = useState(false);
-    const [sent, setSent] = useState(false);
-    const eventIdRef = useRef<string | undefined>(props.eventId);
-
-    useImperativeHandle(
-      ref,
-      () => ({
-        open: (defaults) => {
-          setTitle(defaults?.title ?? '');
-          setBody(defaults?.body ?? '');
-          eventIdRef.current = defaults?.eventId ?? props.eventId;
-          setSent(false);
-          setOpen(true);
-        },
-        close: () => setOpen(false),
-      }),
-      [props.eventId],
-    );
-
-    // Shake detection — opt-in. We load expo-sensors lazily so apps
-    // that don't install it never pay the bundle cost. Same native
-    // module guard as netinfo: if the JS package is in node_modules
-    // but native bridge isn't linked we'd otherwise crash inside the
-    // sensor emitter.
-    useEffect(() => {
-      if (trigger !== 'shake') return;
-      if (!isAnyNativeModuleLinked(['ExponentAccelerometer', 'EXAccelerometer', 'ExpoAccelerometer'])) {
-        return;
-      }
-      let sub: { remove: () => void } | null = null;
-      try {
-        // eslint-disable-next-line @typescript-eslint/no-require-imports
-        const mod = require('expo-sensors') as {
-          Accelerometer?: {
-            addListener: (cb: (d: { x: number; y: number; z: number }) => void) => {
-              remove: () => void;
-            };
-            setUpdateInterval: (ms: number) => void;
-          };
-        };
-        const A = mod.Accelerometer;
-        if (!A) return;
-        A.setUpdateInterval(100);
-        const thr = props.shakeThreshold ?? 18;
-        let lastTriggerAt = 0;
-        sub = A.addListener(({ x, y, z }) => {
-          const mag = Math.sqrt(x * x + y * y + z * z) * 9.81; // g → m/s²
-          const now = Date.now();
-          if (mag > thr && now - lastTriggerAt > 1500) {
-            lastTriggerAt = now;
-            setSent(false);
-            setOpen(true);
-          }
-        });
-      } catch {
-        // expo-sensors not installed → silently fall back to manual
-      }
-      return () => {
-        if (sub) sub.remove();
-      };
-    }, [trigger, props.shakeThreshold]);
-
-    const onSubmit = useCallback(async () => {
-      if (!title.trim() || !body.trim()) return;
-      setSubmitting(true);
-      try {
-        await sendUserFeedback({
-          title: title.trim().slice(0, 200),
-          body: body.trim().slice(0, 8000),
-          email: email.trim() || undefined,
-          eventId: eventIdRef.current,
-        });
-        setSent(true);
-        setTimeout(() => setOpen(false), 1200);
-      } finally {
-        setSubmitting(false);
-      }
-    }, [title, body, email]);
-
-    const L = {
-      bodyPlaceholder: 'What happened?',
-      cancel: 'Cancel',
-      emailPlaceholder: 'email (optional)',
-      sent: 'Thanks — report sent.',
-      submit: 'Send',
-      title: 'Report a problem',
-      ...props.labels,
-    };
-
-    return (
-      <>
-        {trigger === 'fab' && (
-          <Pressable
-            accessibilityLabel="Open feedback"
-            onPress={() => {
-              setSent(false);
-              setOpen(true);
-            }}
-            style={styles.fab}
-          >
-            <Text style={styles.fabText}>?</Text>
-          </Pressable>
-        )}
-        <Modal animationType="fade" transparent visible={open} onRequestClose={() => setOpen(false)}>
-          <View style={styles.backdrop}>
-            <View style={styles.card}>
-              {sent ? (
-                <Text style={styles.sentMessage}>{L.sent}</Text>
-              ) : (
-                <>
-                  <Text style={styles.heading}>{L.title}</Text>
-                  <TextInput
-                    autoCapitalize="sentences"
-                    onChangeText={setTitle}
-                    placeholder="Subject"
-                    placeholderTextColor="#888"
-                    style={styles.titleInput}
-                    value={title}
-                  />
-                  <TextInput
-                    multiline
-                    onChangeText={setBody}
-                    placeholder={L.bodyPlaceholder}
-                    placeholderTextColor="#888"
-                    style={styles.bodyInput}
-                    textAlignVertical="top"
-                    value={body}
-                  />
-                  <TextInput
-                    autoCapitalize="none"
-                    keyboardType="email-address"
-                    onChangeText={setEmail}
-                    placeholder={L.emailPlaceholder}
-                    placeholderTextColor="#888"
-                    style={styles.emailInput}
-                    value={email}
-                  />
-                  <View style={styles.actions}>
-                    <Pressable onPress={() => setOpen(false)} style={styles.cancelBtn}>
-                      <Text style={styles.cancelText}>{L.cancel}</Text>
-                    </Pressable>
-                    <Pressable
-                      disabled={submitting || !title.trim() || !body.trim()}
-                      onPress={onSubmit}
-                      style={[styles.submitBtn, submitting && styles.submitBtnDisabled]}
-                    >
-                      <Text style={styles.submitText}>
-                        {submitting ? '…' : L.submit}
-                      </Text>
-                    </Pressable>
-                  </View>
-                </>
-              )}
-            </View>
-          </View>
-        </Modal>
-      </>
-    );
-  },
-);
-
-const styles = StyleSheet.create({
-  actions: {
-    flexDirection: 'row',
-    gap: 8,
-    justifyContent: 'flex-end',
-  },
-  backdrop: {
-    alignItems: 'center',
-    backgroundColor: 'rgba(0,0,0,0.5)',
-    flex: 1,
-    justifyContent: 'center',
-    paddingHorizontal: 24,
-  },
-  bodyInput: {
-    backgroundColor: '#f7f7f8',
-    borderColor: '#e5e5e8',
-    borderRadius: 6,
-    borderWidth: 1,
-    color: '#111',
-    fontSize: 14,
-    marginBottom: 8,
-    minHeight: 100,
-    paddingHorizontal: 12,
-    paddingVertical: 10,
-  },
-  cancelBtn: {
-    paddingHorizontal: 14,
-    paddingVertical: 8,
-  },
-  cancelText: { color: '#666', fontSize: 14 },
-  card: {
-    backgroundColor: '#fff',
-    borderRadius: 10,
-    padding: 16,
-    width: '100%',
-  },
-  emailInput: {
-    backgroundColor: '#f7f7f8',
-    borderColor: '#e5e5e8',
-    borderRadius: 6,
-    borderWidth: 1,
-    color: '#111',
-    fontSize: 14,
-    marginBottom: 14,
-    paddingHorizontal: 12,
-    paddingVertical: 8,
-  },
-  fab: {
-    alignItems: 'center',
-    backgroundColor: '#111',
-    borderRadius: 24,
-    bottom: 28,
-    elevation: 4,
-    height: 48,
-    justifyContent: 'center',
-    position: 'absolute',
-    right: 18,
-    shadowColor: '#000',
-    shadowOffset: { height: 2, width: 0 },
-    shadowOpacity: 0.18,
-    shadowRadius: 4,
-    width: 48,
-  },
-  fabText: { color: '#fff', fontSize: 22, fontWeight: '500' },
-  heading: { color: '#111', fontSize: 18, fontWeight: '500', marginBottom: 12 },
-  sentMessage: { color: '#111', fontSize: 14, paddingVertical: 18, textAlign: 'center' },
-  submitBtn: {
-    backgroundColor: '#111',
-    borderRadius: 6,
-    paddingHorizontal: 16,
-    paddingVertical: 8,
-  },
-  submitBtnDisabled: { opacity: 0.5 },
-  submitText: { color: '#fff', fontSize: 14, fontWeight: '500' },
-  titleInput: {
-    backgroundColor: '#f7f7f8',
-    borderColor: '#e5e5e8',
-    borderRadius: 6,
-    borderWidth: 1,
-    color: '#111',
-    fontSize: 14,
-    marginBottom: 8,
-    paddingHorizontal: 12,
-    paddingVertical: 8,
-  },
-});

package/src/feedback.ts

@@ -1,21 +0,0 @@
-// v2.0 W3 — `feedback` subpath. The feedback widget pulls in a
-// component tree (react + tsx) and an internal viewer route, so
-// importing it eagerly from the SDK's top-level barrel pays a
-// bundle cost every consumer pays — even ones that never render
-// the widget.
-//
-// Subpath import `@goliapkg/sentori-react-native/feedback`
-// resolves to just the widget surface. Hosts that don't render
-// the feedback button pay zero bundle delta; hosts that do reach
-// for it import via this module and get exactly what they need.
-//
-// Top-level (`index.ts`) still re-exports `FeedbackButton` for one
-// more release cycle so v1 callsites don't break on upgrade. v3
-// will drop the top-level re-export — see
-// `docs/recipes/v1-to-v2-migration.md` for the deprecation timeline.
-
-export {
-  FeedbackButton,
-  type FeedbackButtonHandle,
-  type FeedbackButtonProps,
-} from './feedback-widget'

package/src/heartbeat.ts

@@ -1,157 +0,0 @@
-// Analytics v1 — concurrent-user heartbeat.
-//
-// Once per minute, while the app is in the foreground, POST a tiny
-// `{ sessionId, userId?, release, route?, os?, ts }` body to
-// `/v1/heartbeat`. The server keeps a per-project Valkey ZSET keyed
-// by member (user.id when set, sessionId otherwise) and the
-// dashboard's `Live` page reads the set to render concurrent-user
-// count + per-dim breakdowns.
-//
-// Iron-rule budget (CLAUDE.md):
-// - 1 POST / min foreground only — never fires when backgrounded
-// - ~200 B body
-// - fire-and-forget; never blocks the JS thread, no retries
-// - bounce suppression: if AppState flaps active → inactive → active
-//   inside 30 s, we still fire at most one heartbeat per 30 s
-//
-// The heartbeat is independent of the session ping in
-// `session-tracker.ts`. Session pings fire only at session close
-// (transport-batched); the heartbeat exists *during* the session to
-// signal presence.
-
-import { logger } from '@goliapkg/sentori-core';
-
-import { getConfig } from './config';
-import { getUser } from './capture';
-import { getLastRoute } from './navigation';
-import { uuidV7 } from './uuid';
-
-declare const __DEV__: boolean | undefined;
-
-const DEFAULT_INTERVAL_MS = 60_000;
-const MIN_GAP_MS = 30_000;
-
-type AppStateLike = {
-  addEventListener: (
-    event: 'change',
-    handler: (state: string) => void
-  ) => { remove: () => void };
-  currentState?: string;
-};
-
-let _running = false;
-let _timer: ReturnType<typeof setInterval> | null = null;
-let _appStateSub: null | { remove: () => void } = null;
-let _sessionId: null | string = null;
-let _lastBeatTs = 0;
-let _intervalMs = DEFAULT_INTERVAL_MS;
-
-export type HeartbeatOptions = {
-  /** Override the default 60 s interval. Floor 10 s — anything below
-   *  trips the perf rule and the server's rate-limit anyway. */
-  intervalMs?: number;
-};
-
-export function startHeartbeat(opts: HeartbeatOptions = {}): void {
-  if (_running) return;
-  _running = true;
-  _intervalMs = Math.max(10_000, opts.intervalMs ?? DEFAULT_INTERVAL_MS);
-  _sessionId = uuidV7();
-
-  // AppState gate — only beat while app is in the foreground.
-  let AppState: AppStateLike | undefined;
-  try {
-    // eslint-disable-next-line @typescript-eslint/no-require-imports
-    AppState = (require('react-native') as { AppState?: AppStateLike }).AppState;
-  } catch {
-    // Not in RN runtime (tests). The interval still runs; the gate
-    // is just permissive. Suppression below still applies.
-    AppState = undefined;
-  }
-
-  const isForeground = (): boolean => {
-    if (!AppState) return true;
-    return (AppState.currentState ?? 'active') === 'active';
-  };
-
-  const beat = () => {
-    if (!_running) return;
-    if (!isForeground()) return;
-    const now = Date.now();
-    if (now - _lastBeatTs < MIN_GAP_MS) return;
-    _lastBeatTs = now;
-    void send();
-  };
-
-  // First beat as soon as we start (so the dashboard sees the user
-  // immediately, not 60 s after launch). Subsequent fires on the
-  // interval. AppState transitions can poke an immediate beat too —
-  // an active resume is a meaningful presence event.
-  beat();
-  _timer = setInterval(beat, _intervalMs);
-
-  if (AppState && typeof AppState.addEventListener === 'function') {
-    _appStateSub = AppState.addEventListener('change', (state) => {
-      if (state === 'active') beat();
-    });
-  }
-}
-
-export function stopHeartbeat(): void {
-  _running = false;
-  if (_timer !== null) {
-    clearInterval(_timer);
-    _timer = null;
-  }
-  if (_appStateSub) {
-    _appStateSub.remove();
-    _appStateSub = null;
-  }
-  _sessionId = null;
-  _lastBeatTs = 0;
-}
-
-async function send(): Promise<void> {
-  const config = getConfig();
-  if (!config) return;
-  const user = getUser();
-  const body: Record<string, unknown> = {
-    sessionId: _sessionId ?? '',
-    release: config.release,
-    ts: Date.now(),
-  };
-  if (user?.id) body.userId = user.id;
-  const route = getLastRoute();
-  if (route) body.route = route;
-  const os = readOsString();
-  if (os) body.os = os;
-
-  try {
-    await fetch(`${config.ingestUrl}/v1/heartbeat`, {
-      body: JSON.stringify(body),
-      headers: {
-        Authorization: `Bearer ${config.token}`,
-        'Content-Type': 'application/json',
-      },
-      method: 'POST',
-    });
-  } catch (e) {
-    logger.debug('heartbeat', 'failed (best-effort, normal on offline)', e);
-  }
-}
-
-function readOsString(): null | string {
-  try {
-    // eslint-disable-next-line @typescript-eslint/no-require-imports
-    const RN = require('react-native') as {
-      Platform: { OS: string; Version: string | number };
-    };
-    return `${RN.Platform.OS} ${RN.Platform.Version}`;
-  } catch {
-    return null;
-  }
-}
-
-export function __resetHeartbeatForTests(): void {
-  stopHeartbeat();
-}

package/src/install-id.ts

@@ -1,146 +0,0 @@
-// v1.1 chunk S1 — stable per-install identifier.
-//
-// `getInstallId()` returns a UUIDv7 generated on first call and
-// persisted to device storage. The id survives app restarts and, on
-// iOS specifically, app reinstalls (because the Keychain backend is
-// preserved across uninstall — that's the whole point).
-//
-// Storage tier order:
-//   1. `react-native-keychain` (optional peer; iOS + Android Keystore)
-//   2. AsyncStorage (host already needs this for launch-crash-guard /
-//      offline queue, so we don't add a hard new peer dep)
-//   3. Process-memory only (no persistence — covers SSR / tests)
-//
-// Opaque to the host. The id is NOT tied to a `setUser` call; the
-// server doesn't auto-correlate to user identity. It exists purely
-// as a stable device key so the security posture engine (S3) can
-// score per-install signals independently of authentication state.
-
-import { uuidV7 } from '@goliapkg/sentori-core';
-
-import { isAnyNativeModuleLinked } from './native-loader';
-
-const KEYCHAIN_SERVICE = 'sentori.install-id';
-const ASYNC_STORAGE_KEY = '@sentori/install-id';
-
-type AsyncStorageLike = {
-  getItem: (key: string) => Promise<null | string>;
-  setItem: (key: string, value: string) => Promise<void>;
-};
-
-type KeychainModule = {
-  getGenericPassword: (options: {
-    service: string;
-  }) => Promise<false | { password: string; username: string }>;
-  setGenericPassword: (
-    username: string,
-    password: string,
-    options: { service: string },
-  ) => Promise<unknown>;
-};
-
-let _cached: null | string = null;
-let _inflight: null | Promise<string> = null;
-
-function loadKeychain(): KeychainModule | null {
-  // react-native-keychain is the recommended secure-storage peer.
-  // Optional: if the host hasn't installed it we fall through to
-  // AsyncStorage. The Keychain backend is what gives the iOS
-  // "survives reinstall" guarantee.
-  try {
-    // eslint-disable-next-line @typescript-eslint/no-require-imports
-    const mod = require('react-native-keychain') as KeychainModule;
-    if (typeof mod.getGenericPassword !== 'function') return null;
-    return mod;
-  } catch {
-    return null;
-  }
-}
-
-function loadAsyncStorage(): AsyncStorageLike | null {
-  if (!isAnyNativeModuleLinked(['RNCAsyncStorage', 'AsyncStorageModule'])) {
-    return null;
-  }
-  try {
-    // eslint-disable-next-line @typescript-eslint/no-require-imports
-    const mod = require('@react-native-async-storage/async-storage') as {
-      default?: AsyncStorageLike;
-    };
-    return mod.default ?? (mod as unknown as AsyncStorageLike);
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Resolve the device's stable install id, generating one if absent.
- * Cached in memory after first resolve so subsequent calls are sync-
- * adjacent (no storage I/O). Idempotent under concurrent calls — a
- * second caller during the first resolve awaits the same promise.
- */
-export async function getInstallId(): Promise<string> {
-  if (_cached !== null) return _cached;
-  if (_inflight !== null) return _inflight;
-  _inflight = (async () => {
-    try {
-      const kc = loadKeychain();
-      if (kc) {
-        const existing = await kc
-          .getGenericPassword({ service: KEYCHAIN_SERVICE })
-          .catch(() => false as const);
-        if (existing && existing.password) {
-          _cached = existing.password;
-          return existing.password;
-        }
-        const fresh = uuidV7();
-        await kc
-          .setGenericPassword('sentori', fresh, { service: KEYCHAIN_SERVICE })
-          .catch(() => undefined);
-        _cached = fresh;
-        return fresh;
-      }
-      const storage = loadAsyncStorage();
-      if (storage) {
-        const existing = await storage
-          .getItem(ASYNC_STORAGE_KEY)
-          .catch(() => null);
-        if (existing) {
-          _cached = existing;
-          return existing;
-        }
-        const fresh = uuidV7();
-        await storage.setItem(ASYNC_STORAGE_KEY, fresh).catch(() => undefined);
-        _cached = fresh;
-        return fresh;
-      }
-      // No storage available — generate but don't persist. The id is
-      // still stable for the lifetime of the process which is good
-      // enough for tests / SSR / no-native-modules contexts.
-      const fresh = uuidV7();
-      _cached = fresh;
-      return fresh;
-    } finally {
-      _inflight = null;
-    }
-  })();
-  return _inflight;
-}
-
-/** Sync read of the currently-cached install id. `null` before the
- *  first `getInstallId()` resolves. Use this in hot paths (event
- *  payload assembly) that can't await storage; callers should kick
- *  off `getInstallId()` once at startup to warm the cache. */
-export function peekInstallId(): null | string {
-  return _cached;
-}
-
-export function __resetInstallIdForTests(): void {
-  _cached = null;
-  _inflight = null;
-}
-
-/** For tests + advanced operator flows that need to seed an id from
- *  an external secure-storage migration. */
-export function __setInstallIdForTests(id: string): void {
-  _cached = id;
-}