yaver-feedback-react-native 0.5.3 → 0.5.4

package/dist/index.js

@@ -0,0 +1,80 @@
+"use strict";
+/**
+ * @yaver/feedback-react-native — Visual feedback SDK for Yaver.
+ *
+ * Shake-to-report, screenshots, voice annotations, P2P connection,
+ * device discovery, and live/narrated/batch feedback modes for vibe coding.
+ *
+ * @example
+ * ```tsx
+ * import { YaverFeedback, FeedbackProvider } from '@yaver/feedback-react-native';
+ *
+ * YaverFeedback.init({
+ *   agentUrl: 'http://192.168.1.10:18080',
+ *   authToken: 'your-token',
+ *   trigger: 'shake',
+ *   feedbackMode: 'live',
+ * });
+ *
+ * // Wrap your app root:
+ * <FeedbackProvider>
+ *   <App />
+ * </FeedbackProvider>
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uploadFeedback = exports.stopAudioRecording = exports.startAudioRecording = exports.captureScreenshot = exports.DEFAULT_WEB_BASE_URL = exports.DEFAULT_CONVEX_SITE_URL = exports.listReachableDevices = exports.loginWithEmail = exports.signupWithEmail = exports.pollDeviceCode = exports.startDeviceCode = exports.validateToken = exports.clearSelectedDeviceId = exports.saveSelectedDeviceId = exports.getSelectedDeviceId = exports.saveUser = exports.getUser = exports.clearToken = exports.saveToken = exports.getToken = exports.getWebBaseUrl = exports.getConvexSiteUrl = exports.configureAuthEndpoints = exports.FixReport = exports.FeedbackModal = exports.FloatingButton = exports.ShakeDetector = exports.AuthOverlay = exports.YaverMachinePickerScreen = exports.YaverLoginScreen = exports.YaverConnectionScreen = exports.P2PClient = exports.YaverDiscovery = exports.initExpo = exports.YaverUpdates = exports.BlackBox = exports.YaverFeedback = void 0;
+var YaverFeedback_1 = require("./YaverFeedback");
+Object.defineProperty(exports, "YaverFeedback", { enumerable: true, get: function () { return YaverFeedback_1.YaverFeedback; } });
+var BlackBox_1 = require("./BlackBox");
+Object.defineProperty(exports, "BlackBox", { enumerable: true, get: function () { return BlackBox_1.BlackBox; } });
+var YaverUpdates_1 = require("./YaverUpdates");
+Object.defineProperty(exports, "YaverUpdates", { enumerable: true, get: function () { return YaverUpdates_1.YaverUpdates; } });
+var expo_1 = require("./expo");
+Object.defineProperty(exports, "initExpo", { enumerable: true, get: function () { return expo_1.initExpo; } });
+var Discovery_1 = require("./Discovery");
+Object.defineProperty(exports, "YaverDiscovery", { enumerable: true, get: function () { return Discovery_1.YaverDiscovery; } });
+var P2PClient_1 = require("./P2PClient");
+Object.defineProperty(exports, "P2PClient", { enumerable: true, get: function () { return P2PClient_1.P2PClient; } });
+var ConnectionScreen_1 = require("./ConnectionScreen");
+Object.defineProperty(exports, "YaverConnectionScreen", { enumerable: true, get: function () { return ConnectionScreen_1.YaverConnectionScreen; } });
+var LoginScreen_1 = require("./LoginScreen");
+Object.defineProperty(exports, "YaverLoginScreen", { enumerable: true, get: function () { return LoginScreen_1.YaverLoginScreen; } });
+var MachinePickerScreen_1 = require("./MachinePickerScreen");
+Object.defineProperty(exports, "YaverMachinePickerScreen", { enumerable: true, get: function () { return MachinePickerScreen_1.YaverMachinePickerScreen; } });
+var AuthOverlay_1 = require("./AuthOverlay");
+Object.defineProperty(exports, "AuthOverlay", { enumerable: true, get: function () { return AuthOverlay_1.AuthOverlay; } });
+var ShakeDetector_1 = require("./ShakeDetector");
+Object.defineProperty(exports, "ShakeDetector", { enumerable: true, get: function () { return ShakeDetector_1.ShakeDetector; } });
+var FloatingButton_1 = require("./FloatingButton");
+Object.defineProperty(exports, "FloatingButton", { enumerable: true, get: function () { return FloatingButton_1.FloatingButton; } });
+var FeedbackModal_1 = require("./FeedbackModal");
+Object.defineProperty(exports, "FeedbackModal", { enumerable: true, get: function () { return FeedbackModal_1.FeedbackModal; } });
+var FixReport_1 = require("./FixReport");
+Object.defineProperty(exports, "FixReport", { enumerable: true, get: function () { return FixReport_1.FixReport; } });
+var auth_1 = require("./auth");
+Object.defineProperty(exports, "configureAuthEndpoints", { enumerable: true, get: function () { return auth_1.configureAuthEndpoints; } });
+Object.defineProperty(exports, "getConvexSiteUrl", { enumerable: true, get: function () { return auth_1.getConvexSiteUrl; } });
+Object.defineProperty(exports, "getWebBaseUrl", { enumerable: true, get: function () { return auth_1.getWebBaseUrl; } });
+Object.defineProperty(exports, "getToken", { enumerable: true, get: function () { return auth_1.getToken; } });
+Object.defineProperty(exports, "saveToken", { enumerable: true, get: function () { return auth_1.saveToken; } });
+Object.defineProperty(exports, "clearToken", { enumerable: true, get: function () { return auth_1.clearToken; } });
+Object.defineProperty(exports, "getUser", { enumerable: true, get: function () { return auth_1.getUser; } });
+Object.defineProperty(exports, "saveUser", { enumerable: true, get: function () { return auth_1.saveUser; } });
+Object.defineProperty(exports, "getSelectedDeviceId", { enumerable: true, get: function () { return auth_1.getSelectedDeviceId; } });
+Object.defineProperty(exports, "saveSelectedDeviceId", { enumerable: true, get: function () { return auth_1.saveSelectedDeviceId; } });
+Object.defineProperty(exports, "clearSelectedDeviceId", { enumerable: true, get: function () { return auth_1.clearSelectedDeviceId; } });
+Object.defineProperty(exports, "validateToken", { enumerable: true, get: function () { return auth_1.validateToken; } });
+Object.defineProperty(exports, "startDeviceCode", { enumerable: true, get: function () { return auth_1.startDeviceCode; } });
+Object.defineProperty(exports, "pollDeviceCode", { enumerable: true, get: function () { return auth_1.pollDeviceCode; } });
+Object.defineProperty(exports, "signupWithEmail", { enumerable: true, get: function () { return auth_1.signupWithEmail; } });
+Object.defineProperty(exports, "loginWithEmail", { enumerable: true, get: function () { return auth_1.loginWithEmail; } });
+Object.defineProperty(exports, "listReachableDevices", { enumerable: true, get: function () { return auth_1.listReachableDevices; } });
+Object.defineProperty(exports, "DEFAULT_CONVEX_SITE_URL", { enumerable: true, get: function () { return auth_1.DEFAULT_CONVEX_SITE_URL; } });
+Object.defineProperty(exports, "DEFAULT_WEB_BASE_URL", { enumerable: true, get: function () { return auth_1.DEFAULT_WEB_BASE_URL; } });
+var capture_1 = require("./capture");
+Object.defineProperty(exports, "captureScreenshot", { enumerable: true, get: function () { return capture_1.captureScreenshot; } });
+Object.defineProperty(exports, "startAudioRecording", { enumerable: true, get: function () { return capture_1.startAudioRecording; } });
+Object.defineProperty(exports, "stopAudioRecording", { enumerable: true, get: function () { return capture_1.stopAudioRecording; } });
+var upload_1 = require("./upload");
+Object.defineProperty(exports, "uploadFeedback", { enumerable: true, get: function () { return upload_1.uploadFeedback; } });

package/dist/types.d.ts

@@ -0,0 +1,282 @@
+export interface FeedbackConfig {
+    /** URL of the Yaver agent (e.g. "http://192.168.1.10:18080"). If omitted, auto-discovery is used. */
+    agentUrl?: string;
+    /**
+     * Auth token for the Yaver agent. Optional in 0.5+: if omitted, the SDK
+     * will hydrate one from AsyncStorage or show its in-app login screen
+     * (device-code / email / OAuth) the first time the user triggers feedback.
+     */
+    authToken?: string;
+    /**
+     * When true (default), the SDK will automatically prompt the user to sign
+     * in and pick a remote machine the first time they trigger feedback and
+     * no `authToken` / `preferredDeviceId` is cached. Set false to opt back
+     * into the pre-0.5 behavior where you manage auth yourself and pass
+     * `authToken` at init.
+     */
+    autoLogin?: boolean;
+    /**
+     * Override the public Yaver endpoints the in-app login screen talks to.
+     * Useful when running against staging. Defaults to the production
+     * yaver.io / Convex site URLs.
+     */
+    authConvexSiteUrl?: string;
+    authWebBaseUrl?: string;
+    /**
+     * Convex site URL for cloud IP resolution.
+     * When set, the SDK fetches the agent's IP from Convex instead of
+     * requiring a hardcoded agentUrl. Works with cloud machines (CPU/GPU)
+     * where the IP is managed by Yaver.
+     *
+     * Set this OR agentUrl — not both. If both are set, agentUrl wins.
+     *
+     * @example
+     * convexUrl: 'https://your-app.convex.site'
+     */
+    convexUrl?: string;
+    /**
+     * Preferred device ID to connect to (from Convex device list).
+     * If omitted with convexUrl, connects to the first online device.
+     */
+    preferredDeviceId?: string;
+    /** How feedback collection is triggered */
+    trigger?: 'shake' | 'floating-button' | 'manual';
+    /** Enable/disable the SDK. Defaults to __DEV__ */
+    enabled?: boolean;
+    /**
+     * Reporting-only mode. When true:
+     * - Shake auto-captures screenshot + errors and sends to the agent
+     * - No floating button, no feedback modal, no auto-test UI
+     * - Agent receives and stores the report but does NOT auto-trigger a fix
+     * - Developer reviews reports in CLI and decides what to fix
+     *
+     * Use case: enable for QA testers / beta users who should report bugs
+     * but not trigger code changes. The developer configures their own device
+     * with `reportingOnly: false` to get the full SDK with fix triggers.
+     *
+     * @example
+     * // For beta testers:
+     * YaverFeedback.init({ reportingOnly: true, trigger: 'shake', ... });
+     *
+     * // For the developer:
+     * YaverFeedback.init({ reportingOnly: false, trigger: 'floating-button', ... });
+     */
+    reportingOnly?: boolean;
+    /** Max screen recording duration in seconds. Default: 120 */
+    maxRecordingDuration?: number;
+    /**
+     * Feedback mode:
+     * - 'live': stream events to the agent as they happen
+     * - 'narrated': record everything, send on stop
+     * - 'batch': dump everything at end (default)
+     */
+    feedbackMode?: 'live' | 'narrated' | 'batch';
+    /**
+     * Agent commentary level (0-10).
+     * 0 = silent, 10 = agent comments on everything it sees.
+     * Only relevant in live mode. Default: 0.
+     */
+    agentCommentaryLevel?: number;
+    /**
+     * Enable voice input for feedback annotations. Always true by default.
+     * Audio is recorded on the device and sent to the agent for transcription.
+     * Works regardless of whether a speech-to-speech provider is configured —
+     * if STT is available on the agent, audio is auto-transcribed; otherwise
+     * raw audio is attached to the feedback report.
+     */
+    voiceEnabled?: boolean;
+    /**
+     * Maximum number of captured errors to keep in memory (ring buffer).
+     * Oldest errors are evicted when the buffer is full.
+     * Default: 5.
+     *
+     * Errors are captured via `YaverFeedback.attachError()` or
+     * `YaverFeedback.wrapErrorHandler()`. The SDK never auto-hooks global
+     * error handlers — this avoids conflicts with Sentry, Crashlytics,
+     * Bugsnag, or any other error tracking tool.
+     */
+    maxCapturedErrors?: number;
+    /**
+     * Which platforms the Build button targets.
+     * - 'ios' — build iOS only
+     * - 'android' — build Android only
+     * - 'both' — build iOS and Android sequentially (default)
+     * - 'web' — build web app
+     */
+    buildPlatforms?: 'ios' | 'android' | 'both' | 'web';
+    /**
+     * Auto-deploy builds after successful build.
+     * When true (default), iOS builds are uploaded to TestFlight
+     * and Android builds are uploaded to Google Play internal testing.
+     * When false, builds are created locally without uploading.
+     */
+    autoDeploy?: boolean;
+    /**
+     * Background color of the debug console panel.
+     * Default: "#2d2d2d" (dark gray). Set to any color to match your app's theme
+     * and avoid visual overlap.
+     *
+     * @example
+     * panelBackgroundColor: '#1a1a2e'  // dark blue-gray
+     * panelBackgroundColor: '#333333'  // neutral dark gray
+     */
+    panelBackgroundColor?: string;
+    /**
+     * Callback invoked when the agent pushes a reload command.
+     * This happens when the vibe coder triggers a reload from the Yaver mobile app
+     * or from another connected device.
+     *
+     * If not provided, the SDK will attempt `DevSettings.reload()` in dev mode
+     * or ignore the command in production.
+     *
+     * @example
+     * onReload: () => {
+     *   // Custom reload logic, e.g. re-fetch bundle from agent
+     *   Updates.reloadAsync();
+     * }
+     */
+    onReload?: () => void;
+    /**
+     * Callback invoked when the agent pushes a reload_bundle command with a new
+     * native bundle URL. The SDK passes the bundle URL and assets URL so the app
+     * can fetch and load the new bundle.
+     *
+     * If not provided, the SDK will attempt to POST the bundle to localhost:8347
+     * (Yaver's on-device HTTP server) for native container reload.
+     */
+    onReloadBundle?: (bundleUrl: string, assetsUrl?: string) => void;
+    /**
+     * TLS certificate fingerprint (SHA256) for HTTPS on LAN.
+     * When set, the SDK prefers HTTPS connections and verifies the agent's
+     * self-signed cert matches this fingerprint.
+     */
+    tlsFingerprint?: string;
+    /**
+     * Require TLS for all connections. When true, refuses HTTP connections.
+     * Default: false (HTTPS preferred when fingerprint available, HTTP fallback).
+     */
+    requireTLS?: boolean;
+}
+export interface FeedbackBundle {
+    metadata: FeedbackMetadata;
+    video?: string;
+    /** Voice annotation audio file path (WAV). Always available when voiceEnabled. */
+    audio?: string;
+    /** Transcribed text from voice annotation (if STT/S2S provider is available on agent). */
+    audioTranscript?: string;
+    screenshots: string[];
+    /** Captured errors with stack traces, attached automatically when captureErrors is enabled. */
+    errors?: CapturedError[];
+}
+/** An error captured by the SDK's global error handler. */
+export interface CapturedError {
+    /** Error message. */
+    message: string;
+    /** Parsed stack frames (e.g. "at CheckoutButton.handlePress (CheckoutScreen.tsx:47)"). */
+    stack: string[];
+    /** Whether this was a fatal (unrecoverable) error. */
+    isFatal: boolean;
+    /** Unix timestamp in milliseconds when the error occurred. */
+    timestamp: number;
+    /** Optional developer-attached context via YaverFeedback.attachError(). */
+    metadata?: Record<string, unknown>;
+}
+export interface FeedbackMetadata {
+    timestamp: string;
+    device: DeviceInfo;
+    app: AppInfo;
+    userNote?: string;
+}
+export interface DeviceInfo {
+    platform: string;
+    osVersion: string;
+    model: string;
+    screenWidth: number;
+    screenHeight: number;
+}
+export interface AppInfo {
+    bundleId?: string;
+    version?: string;
+    buildNumber?: string;
+}
+export interface TimelineEvent {
+    type: 'screenshot' | 'audio' | 'video';
+    path: string;
+    timestamp: string;
+    duration?: number;
+}
+export interface FeedbackReport {
+    id: string;
+    bundle: FeedbackBundle;
+    status: 'pending' | 'uploading' | 'uploaded' | 'failed';
+    error?: string;
+}
+export interface AgentCommentary {
+    id: string;
+    timestamp: string;
+    message: string;
+    type: 'observation' | 'suggestion' | 'question' | 'action';
+}
+export interface FeedbackStreamEvent {
+    type: string;
+    timestamp: string;
+    data: any;
+}
+/**
+ * A single fix applied by the AI agent during a test session.
+ * Displayed in the FixReport component as a markdown-style list.
+ */
+export interface TestFix {
+    /** Unique fix ID */
+    id: string;
+    /** File that was modified */
+    file: string;
+    /** Line number of the change */
+    line?: number;
+    /** Short description of what was fixed */
+    description: string;
+    /** The error/exception that triggered this fix */
+    error?: string;
+    /** Diff or code snippet (shown on expand) */
+    diff?: string;
+    /** Timestamp when the fix was applied */
+    timestamp: string;
+    /** Whether the fix resolved the issue (verified after hot reload) */
+    verified?: boolean;
+}
+/**
+ * Test session state returned by the agent's /test-app/status endpoint.
+ */
+export interface TestSession {
+    /** Whether a test session is currently running */
+    active: boolean;
+    /** Current screen being tested */
+    currentScreen?: string;
+    /** Total screens discovered */
+    screensDiscovered: number;
+    /** Total screens tested */
+    screensTested: number;
+    /** Errors found during this session */
+    errorsFound: number;
+    /** Fixes applied (not committed — staged only) */
+    fixes: TestFix[];
+    /** Session start time */
+    startedAt?: string;
+    /** Elapsed seconds */
+    elapsedSeconds?: number;
+    /** Status message */
+    status: string;
+}
+/** Voice capability info returned by the agent's /voice/status endpoint. */
+export interface VoiceCapability {
+    /** Always true — mobile can always record and send audio. */
+    voiceInputEnabled: boolean;
+    /** Speech-to-speech provider (e.g. "personaplex", "openai"), or null. */
+    s2sProvider?: string;
+    /** Whether the S2S provider is ready for real-time sessions. */
+    s2sReady?: boolean;
+    /** Speech-to-text provider for transcription (e.g. "whisper", "openai"). */
+    sttProvider?: string;
+    /** Whether STT is ready (auto-transcription of voice input). */
+    sttReady?: boolean;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/upload.d.ts

@@ -0,0 +1,13 @@
+import { FeedbackBundle } from './types';
+/**
+ * Upload a feedback bundle to the Yaver agent via multipart POST.
+ *
+ * The agent receives the bundle at POST /feedback with:
+ * - `metadata` (JSON string)
+ * - `screenshot_0`, `screenshot_1`, ... (image files)
+ * - `audio` (audio file, if present)
+ * - `video` (video file, if present)
+ *
+ * @returns The feedback report ID from the agent response.
+ */
+export declare function uploadFeedback(agentUrl: string, authToken: string, bundle: FeedbackBundle): Promise<string>;

package/dist/upload.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uploadFeedback = uploadFeedback;
+const react_native_1 = require("react-native");
+/**
+ * Upload a feedback bundle to the Yaver agent via multipart POST.
+ *
+ * The agent receives the bundle at POST /feedback with:
+ * - `metadata` (JSON string)
+ * - `screenshot_0`, `screenshot_1`, ... (image files)
+ * - `audio` (audio file, if present)
+ * - `video` (video file, if present)
+ *
+ * @returns The feedback report ID from the agent response.
+ */
+async function uploadFeedback(agentUrl, authToken, bundle) {
+    const formData = new FormData();
+    // Attach metadata as JSON
+    formData.append('metadata', JSON.stringify(bundle.metadata));
+    // Attach screenshots
+    for (let i = 0; i < bundle.screenshots.length; i++) {
+        const path = bundle.screenshots[i];
+        formData.append(`screenshot_${i}`, {
+            uri: react_native_1.Platform.OS === 'android' ? `file://${path}` : path,
+            type: 'image/png',
+            name: `screenshot_${i}.png`,
+        });
+    }
+    // Attach audio
+    if (bundle.audio) {
+        formData.append('audio', {
+            uri: react_native_1.Platform.OS === 'android' ? `file://${bundle.audio}` : bundle.audio,
+            type: 'audio/m4a',
+            name: 'voice_note.m4a',
+        });
+    }
+    // Attach video
+    if (bundle.video) {
+        formData.append('video', {
+            uri: react_native_1.Platform.OS === 'android' ? `file://${bundle.video}` : bundle.video,
+            type: 'video/mp4',
+            name: 'screen_recording.mp4',
+        });
+    }
+    const url = agentUrl.replace(/\/$/, '') + '/feedback';
+    const response = await fetch(url, {
+        method: 'POST',
+        headers: {
+            Authorization: `Bearer ${authToken}`,
+        },
+        body: formData,
+    });
+    if (!response.ok) {
+        const text = await response.text().catch(() => '');
+        throw new Error(`[YaverFeedback] Upload failed (${response.status}): ${text}`);
+    }
+    const result = await response.json();
+    return result.id ?? result.reportId ?? 'unknown';
+}

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "yaver-feedback-react-native",
-  "version": "0.5.3",
+  "version": "0.5.4",
   "description": "Visual feedback SDK for Yaver — bug reports, screen recording, voice annotations, and local-first developer workflows",
-  "main": "src/index.ts",
-  "types": "src/index.ts",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "files": [
+    "dist/",
     "src/",
     "ios/",
     "android/",
@@ -36,6 +37,8 @@
     "typescript": "^5.0.0"
   },
   "scripts": {
+    "build": "rm -rf dist && (tsc || true) && test -f dist/index.js",
+    "prepublishOnly": "npm run build",
     "test": "jest"
   },
   "jest": {