yaver-feedback-react-native 0.9.0 → 0.9.3

package/dist/YaverFeedback.d.ts

@@ -1,6 +1,15 @@
 import { FeedbackConfig, CapturedError } from './types';
 import { P2PClient } from './P2PClient';
+import { CaptureStoreScreenshotsOptions, CaptureStoreScreenshotsResult } from './storeShots';
 import { QuickIconColorPreset } from './preferences';
+import { type SDKDogfoodStatus } from './dogfoodPolicy';
+import { type DeviceDogfoodOptions, type DeviceDogfoodSession, type DeviceDogfoodState } from './deviceDogfood';
+export interface DogfoodOnboardingOptions extends DeviceDogfoodOptions {
+    /** Hint used to preselect the matching project returned by the owner machine. */
+    projectName?: string;
+    /** Framework fallback when the machine has not classified the project yet. */
+    framework?: string;
+}
 /**
  * Main entry point for the Yaver Feedback SDK.
  * Call `YaverFeedback.init()` once at app startup.
@@ -15,7 +24,26 @@ export declare class YaverFeedback {
      * If no `agentUrl` is provided, the SDK will attempt auto-discovery
      * via `YaverDiscovery` on the first `startReport()` call.
      */
+    /** The runtime lane, when running on web inside a Yaver preview WebView. */
+    static detectWebLane(): 'browser' | 'webrtc' | null;
+    /**
+     * Mount a draggable DOM floating "Y" icon for the BROWSER lane (RN-web). It
+     * lives in the WebView's document.body (position:fixed, max z-index), so it
+     * renders ON TOP of the page inside the WebView and is never occluded by the
+     * fullScreen preview modal — the one occlusion-proof affordance on iOS.
+     * Tap opens the SDK's existing report flow (the RN FeedbackModal renders in
+     * the same WebView DOM, also un-occluded). No-op off-web or off-lane, and
+     * idempotent (a re-init reuses the existing node).
+     */
+    static mountBrowserLaneIcon(): void;
     static init(cfg: FeedbackConfig): void;
+    /**
+     * Opt-in global crash handler. This wraps the existing React Native
+     * ErrorUtils handler and still calls it, so Sentry/Crashlytics/Bugsnag can
+     * remain the system of record. The SDK only uploads a crash report and,
+     * when configured, asks the agent to create a fix task.
+     */
+    static installCrashHandler(): void;
     /**
      * Run agent discovery in the background.
      * Called automatically from init() when no agentUrl is provided.
@@ -46,6 +74,29 @@ export declare class YaverFeedback {
     static setAuthToken(token: string): Promise<void>;
     /** Returns true once the SDK has a session token it can use. */
     static isAuthed(): boolean;
+    /**
+     * On-device App Store screenshot capture (Engine 2). Walks the routes
+     * the host hands us, screenshots each, and uploads to the agent which
+     * runs the App Store Connect backend. agentUrl / authToken / relay
+     * password default to the SDK's resolved session; the host only has to
+     * supply a navigation ref + the ordered route list.
+     *
+     *   YaverFeedback.captureStoreScreenshots({
+     *     app: 'sfmg',
+     *     navigationRef,
+     *     routes: ['/(tabs)/dashboard', '/(tabs)/messages', '/(tabs)/clients'],
+     *     submit: true,
+     *   })
+     */
+    static captureStoreScreenshots(opts: Omit<CaptureStoreScreenshotsOptions, 'agentUrl' | 'authToken' | 'relayPassword'> & Partial<Pick<CaptureStoreScreenshotsOptions, 'agentUrl' | 'authToken' | 'relayPassword'>>): Promise<CaptureStoreScreenshotsResult>;
+    /**
+     * Let the mobile app / CLI kick THIS device into self-capturing. Registers
+     * a BlackBox command listener that fires captureStoreScreenshots when the
+     * agent pushes a `capture_store_shots` command (its `data` may override
+     * `submit` / `locale`). Returns an unsubscribe fn. Call once after init,
+     * passing the app's navigation ref + the routes to walk.
+     */
+    static enableStoreShotsOnCommand(opts: Omit<CaptureStoreScreenshotsOptions, 'agentUrl' | 'authToken' | 'relayPassword'>): () => void;
     /**
      * Request the embedded FeedbackModal to show the login screen. Works by
      * emitting an event the modal listens for — avoids forcing the host app
@@ -57,6 +108,12 @@ export declare class YaverFeedback {
      * an active session; no-ops otherwise.
      */
     static showMachinePicker(): void;
+    /** Begin the reusable host-app Dogfood wizard. Owner OAuth and machine
+     * selection intentionally happen before installation enrollment/runtime
+     * controls because starting builds or runners is owner-level authority. */
+    static beginDogfoodOnboarding(options: DogfoodOnboardingOptions): void;
+    static getDogfoodOnboarding(): DogfoodOnboardingOptions | null;
+    static clearDogfoodOnboarding(): void;
     /**
      * Update the selected remote device. Resets the cached agent URL so the
      * next `startReport()` (or FloatingButton press) rediscovers against the
@@ -112,10 +169,64 @@ export declare class YaverFeedback {
      * - All methods become active
      */
     static setEnabled(value: boolean): void;
+    /**
+     * Turn shake-to-report on or off without tearing the SDK down.
+     *
+     * `trigger` is read only inside init(), so before this the only ways to
+     * stop listening for a shake were setEnabled(false) — which also kills the
+     * flight recorder and the agent command channel — or a re-init, which used
+     * to stack a duplicate command handler. Neither is what "turn the shake
+     * catcher off" should cost.
+     *
+     * Persists onto config.disableShakeGesture, so a later setEnabled(true)
+     * honours it rather than resurrecting the listener.
+     */
+    static setShakeEnabled(value: boolean): void;
+    /** Whether the shake listener is currently armed. */
+    static isShakeEnabled(): boolean;
+    /**
+     * Bring the shake listener in line with the current config. Idempotent —
+     * safe to call whenever `enabled`, `trigger`, or `disableShakeGesture`
+     * moves.
+     */
+    private static syncShakeDetector;
+    private static stopShakeDetector;
+    /** Cancel a pending BlackBox auto-start retry chain. */
+    private static cancelBlackBoxAutoStart;
+    /**
+     * Start BlackBox as soon as we have BOTH an agentUrl and a token, polling
+     * until then.
+     *
+     * Both conditions are mandatory and deliberate: starting without a token
+     * makes the SSE channel 401 and retry with backoff, which is the tight
+     * string-concat + JSON-parse loop that used to SIGSEGV Hermes on iOS 18.3.1
+     * during Screenshot & Fix. This only re-checks that same guard over time.
+     *
+     * Bounded at ~60s: long enough for AsyncStorage hydration plus a Convex
+     * discovery round trip on a cold, off-LAN start, short enough that a device
+     * whose user never signs in stops polling. Giving up here costs nothing —
+     * setAuthToken() and startReport() both reschedule, so signing in later
+     * still brings the channel up.
+     */
+    private static scheduleBlackBoxAutoStart;
     /** Returns whether the SDK is currently enabled. */
     static isEnabled(): boolean;
     /** Returns the current config, or null if not initialized. */
     static getConfig(): FeedbackConfig | null;
+    /** Current third-party SDK mode. Fails closed unless enabled + account match. */
+    static getDogfoodStatus(): SDKDogfoodStatus;
+    /** One-call, account-free Dogfood bootstrap for third-party apps. On first
+     * launch it creates/proves the installation key and returns pending; after
+     * owner approval the same call obtains a short-lived scoped Yaver session
+     * and enables Dogfood UX without the host app implementing OAuth. */
+    static enableDeviceDogfood(options: DeviceDogfoodOptions): Promise<{
+        status: DeviceDogfoodState;
+        installationId: string;
+        session: DeviceDogfoodSession | null;
+    }>;
+    /** Confirmed by the Y badge/UI before this is called. Reverts this SDK to
+     * normal Feedback mode for the remainder of the app run. */
+    static exitDogfoodMode(): Promise<void>;
     /** Returns the resolved relay password the SDK is currently using.
      *  Empty string when no relay routing is in play (direct LAN agent
      *  URLs need no password). Callers attaching it to relay-routed
@@ -150,11 +261,32 @@ export declare class YaverFeedback {
      * // wrapper, and the chain stays intact.
      */
     static wrapErrorHandler(next?: ((error: Error, isFatal?: boolean) => void) | null): (error: Error, isFatal?: boolean) => void;
+    /**
+     * Upload a crash-aware feedback bundle. Apps can call this from their own
+     * error boundary/global handler. If crashReporting.autoFix is true, the SDK
+     * also triggers the agent's feedback-fix task; reload delivery still happens
+     * through the existing BlackBox command stream.
+     */
+    static reportCrash(error: Error, opts?: {
+        isFatal?: boolean;
+        source?: 'manual' | 'global-handler';
+        metadata?: Record<string, unknown>;
+        autoFix?: boolean;
+    }): Promise<{
+        reportId?: string;
+        taskId?: string;
+    }>;
     /**
      * Returns the P2P client instance.
      * Available after init if agentUrl is set, or after first successful discovery.
      */
     static getP2PClient(): P2PClient | null;
+    /** Renderer/reload route; intentionally distinct from the coding client. */
+    static getRenderP2PClient(): P2PClient | null;
+    static getMachineRouting(): {
+        codingDeviceId?: string;
+        renderDeviceId?: string;
+    };
     /**
      * Record a business event. Routes through BlackBox so the agent
      * persists it to the analytics ledger (no dashboards — export