yaver-feedback-react-native 0.8.6 → 0.8.8

package/src/_core/constants.ts

@@ -57,9 +57,13 @@ export const DEFAULT_BEACON_UDP_PORT = 19837;
 /**
  * How old an agent's last heartbeat can be before the device is
  * considered offline. Mirrors `backend/convex/devices.ts` so
- * Convex + every client agree on the same threshold.
+ * Convex + every client agree on the same threshold. The agent
+ * heartbeats every 5 min (see `desktop/agent/main.go::heartbeatLoop`),
+ * so 6 min tolerates one missed beat + 60 s of jitter without
+ * flapping. Sub-minute death detection comes from the P2P bus, not
+ * this threshold.
  */
-export const HEARTBEAT_STALE_MS = 90_000;
+export const HEARTBEAT_STALE_MS = 360_000;
 
 /**
  * How long after the last UDP beacon an agent is still considered

package/src/types.ts

@@ -20,6 +20,65 @@ export interface RunnerBrowserAuthSession {
   completedAt?: number;
 }
 
+export interface IncidentEvent {
+  id: string;
+  timestamp: number;
+  severity: 'info' | 'warn' | 'error' | 'fatal';
+  category: string;
+  code: string;
+  source: string;
+  title: string;
+  userMessage: string;
+  technicalInfo?: string;
+  suggestedAction?: string;
+  operationId?: string;
+  deviceId?: string;
+  projectPath?: string;
+  target?: string;
+  logsAvailable: boolean;
+  logRefs?: string[];
+  correlationId?: string;
+  recoverable: boolean;
+  metadata?: Record<string, unknown>;
+  resolved?: boolean;
+}
+
+export interface OperationState {
+  id: string;
+  kind: string;
+  status: string;
+  phase?: string;
+  message?: string;
+  progress?: number;
+  deviceId?: string;
+  projectPath?: string;
+  startedAt: number;
+  updatedAt: number;
+  incidentIds?: string[];
+  metadata?: Record<string, unknown>;
+}
+
+export interface CapabilityTargetReadiness {
+  enabled: boolean;
+  reasonCode?: string;
+  reason?: string;
+  suggestedAction?: string;
+  notes?: string[];
+}
+
+export interface CapabilitySnapshot {
+  generatedAt: string;
+  machine?: Record<string, unknown>;
+  infra?: Record<string, unknown>;
+  connectivity?: {
+    directAvailable?: boolean;
+    relayConfigured?: boolean;
+    tunnelConfigured?: boolean;
+    tailscaleAvailable?: boolean;
+  };
+  targets: Record<string, CapabilityTargetReadiness>;
+}
+
 export interface FeedbackConfig {
   /** URL of the Yaver agent (e.g. "http://192.168.1.10:18080"). If omitted, auto-discovery is used. */
   agentUrl?: string;
@@ -64,6 +123,35 @@ export interface FeedbackConfig {
   preferredDeviceId?: string;
   /** How feedback collection is triggered */
   trigger?: 'shake' | 'floating-button' | 'manual';
+  /**
+   * Non-default escape hatch for host apps that want the SDK without
+   * shake gesture handling. When enabled:
+   * - the SDK does not start ShakeDetector
+   * - if `quickIcon` was left as `'auto'`/unset, it is promoted to `'always'`
+   * - the app should rely on the draggable quick icon or explicit
+   *   `YaverFeedback.startReport()` calls instead
+   *
+   * Intended for builds where another surface owns motion / haptics.
+   */
+  disableShakeGesture?: boolean;
+  /**
+   * Auto-open the BlackBox SSE command channel after init() returns.
+   *
+   * Default: `true` (0.8.8+). Listens for `reload`, `reload_bundle`,
+   * and `status` commands the agent broadcasts after a vibe-coding
+   * task commits a fix — drives the auto-reload loop without the host
+   * app needing to call `BlackBox.start()` manually.
+   *
+   * The auto-start is deferred 500ms after init() and gated on having
+   * BOTH `agentUrl` and `authToken` resolved, to avoid the iOS 18.3.1
+   * rope-string SIGSEGV that the early auto-start in 0.7.6 hit when
+   * the agent was in needs-auth mode (tight 401-retry loop in SSE).
+   *
+   * Set `false` if your host app wants to gate BlackBox start on its
+   * own state machine (e.g. only after the user opts into telemetry).
+   * Calling `BlackBox.start()` manually is still safe — it's idempotent.
+   */
+  autoStartBlackBox?: boolean;
   /**
    * Small tap-to-open icon that floats above the app so the user
    * doesn't have to shake every time they want to open feedback.