yaver-feedback-react-native 0.9.7 → 0.9.9

package/dist/__tests__/YaverFeedback.test.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const react_native_1 = require("react-native");
 const YaverFeedback_1 = require("../YaverFeedback");
+const auth_1 = require("../auth");
 // Mock react-native: DeviceEventEmitter for event dispatch + Platform so
 // ShakeDetector.start() can branch on iOS without hitting a real RN runtime.
 jest.mock('react-native', () => ({
@@ -15,6 +16,10 @@ jest.mock('react-native', () => ({
             setDogfoodShortcut: jest.fn(async () => true),
             consumeDogfoodShortcut: jest.fn(async () => false),
         },
+        YaverDogfoodGesture: {
+            getCapability: jest.fn(async () => ({ supported: true, enabled: false, reason: 'supported', platform: 'ios' })),
+            setEnabled: jest.fn(async (next) => ({ supported: true, enabled: next, reason: 'supported', platform: 'ios' })),
+        },
     },
     AppState: { addEventListener: jest.fn(() => ({ remove: jest.fn() })) },
 }));
@@ -32,8 +37,10 @@ jest.mock('../auth', () => ({
     getDogfoodAccountAccess: jest.fn(async (_appId, token) => ({
         authenticated: token === 'owner-token',
         ownerAuthorized: token === 'owner-token',
+        accountAuthorized: token === 'owner-token',
         installationAuthorized: token === 'owner-token',
     })),
+    setDogfoodControlPreference: jest.fn(async () => true),
     saveSelectedDeviceId: jest.fn(async () => { }),
     clearToken: jest.fn(async () => { }),
     clearSelectedDeviceId: jest.fn(async () => { }),
@@ -62,6 +69,25 @@ beforeEach(() => {
     jest.restoreAllMocks();
     jest.clearAllMocks();
 });
+function activeDogfood(controlGesture = true) {
+    return {
+        enabled: true,
+        appId: 'io.example.app',
+        installationId: 'phone-1',
+        installationStatus: 'active',
+        controlGesture,
+    };
+}
+function initActiveDogfood(options = {}) {
+    const controlGesture = options.controlGesture ?? true;
+    YaverFeedback_1.YaverFeedback.init({
+        authToken: options.authToken,
+        bundleId: 'io.example.app',
+        dogfood: { controlGesture },
+    });
+    Object.assign(YaverFeedback_1.YaverFeedback.getConfig().dogfood, activeDogfood(controlGesture));
+    jest.clearAllMocks();
+}
 describe('YaverFeedback', () => {
     describe('Dogfood onboarding', () => {
         it('starts with Yaver OAuth when the host has no session', async () => {
@@ -96,6 +122,17 @@ describe('YaverFeedback', () => {
             unsubscribe();
             expect(states[states.length - 1]).toBe('auth-required');
         });
+        it('returns a visible structured error when access verification fails', async () => {
+            YaverFeedback_1.YaverFeedback.init({ enabled: true, authToken: 'owner-token' });
+            auth_1.getDogfoodAccountAccess.mockRejectedValueOnce(new Error('Access service unavailable'));
+            const state = await YaverFeedback_1.YaverFeedback.beginDogfoodOnboarding({ appId: 'io.example.app' });
+            expect(state).toEqual({
+                phase: 'error',
+                appId: 'io.example.app',
+                error: 'Access service unavailable',
+            });
+            expect(react_native_1.DeviceEventEmitter.emit).not.toHaveBeenCalledWith('yaverFeedback:startReport');
+        });
         it('lets a host ACL hide its affordance without opening auth UI', async () => {
             YaverFeedback_1.YaverFeedback.init({
                 enabled: true,
@@ -113,6 +150,7 @@ describe('YaverFeedback', () => {
                 appId: 'io.example.app',
                 yaverAuthenticated: true,
                 ownerAuthorized: false,
+                accountAuthorized: true,
                 installationId: 'phone-1',
                 deviceState: 'active',
                 authorized: true,
@@ -128,6 +166,7 @@ describe('YaverFeedback', () => {
                 appId: 'io.example.app',
                 yaverAuthenticated: false,
                 ownerAuthorized: false,
+                accountAuthorized: true,
                 installationId: 'phone-1',
                 deviceState: 'active',
                 authorized: false,
@@ -145,6 +184,7 @@ describe('YaverFeedback', () => {
                 appId: 'io.example.app',
                 yaverAuthenticated: true,
                 ownerAuthorized: false,
+                accountAuthorized: true,
                 installationId: 'phone-1',
                 deviceState: 'active',
                 authorized: true,
@@ -153,6 +193,139 @@ describe('YaverFeedback', () => {
             expect(react_native_1.NativeModules.YaverHotReload.setDogfoodShortcut)
                 .toHaveBeenCalledWith(false, 'Dogfood');
         });
+        it('keeps the Y visible until the authorized phone has completed onboarding', async () => {
+            initActiveDogfood();
+            jest.spyOn(YaverFeedback_1.YaverFeedback, 'getDogfoodAccess').mockResolvedValueOnce({
+                appId: 'io.example.app',
+                yaverAuthenticated: true,
+                ownerAuthorized: false,
+                accountAuthorized: true,
+                installationId: 'phone-1',
+                deviceState: 'active',
+                authorized: true,
+            });
+            const state = await YaverFeedback_1.YaverFeedback.syncDogfoodControlGesture();
+            expect(state).toMatchObject({
+                onboardingSeen: false,
+                presentation: 'minimized-y',
+                gestureSupported: true,
+                gestureEnabled: false,
+                fallbackVisible: true,
+            });
+            expect(react_native_1.NativeModules.YaverDogfoodGesture.setEnabled).toHaveBeenCalledWith(false, 900);
+        });
+        it('uses the invisible three-finger hold only after onboarding selects it', async () => {
+            initActiveDogfood();
+            jest.spyOn(YaverFeedback_1.YaverFeedback, 'getDogfoodAccess').mockResolvedValueOnce({
+                appId: 'io.example.app',
+                yaverAuthenticated: true,
+                ownerAuthorized: false,
+                accountAuthorized: true,
+                installationId: 'phone-1',
+                deviceState: 'active',
+                authorized: true,
+                controlPresentation: 'auto',
+                controlOnboardingSeen: true,
+            });
+            const state = await YaverFeedback_1.YaverFeedback.syncDogfoodControlGesture();
+            expect(state).toMatchObject({
+                onboardingSeen: true,
+                presentation: 'auto',
+                gestureSupported: true,
+                gestureEnabled: true,
+                fallbackVisible: false,
+            });
+            expect(react_native_1.NativeModules.YaverDogfoodGesture.setEnabled).toHaveBeenCalledWith(true, 900);
+        });
+        it('keeps the Y when native capability reports support but enabling the gesture fails', async () => {
+            initActiveDogfood();
+            jest.spyOn(YaverFeedback_1.YaverFeedback, 'getDogfoodAccess').mockResolvedValueOnce({
+                appId: 'io.example.app',
+                yaverAuthenticated: true,
+                ownerAuthorized: false,
+                accountAuthorized: true,
+                installationId: 'phone-1',
+                deviceState: 'active',
+                authorized: true,
+                controlPresentation: 'auto',
+                controlOnboardingSeen: true,
+            });
+            react_native_1.NativeModules.YaverDogfoodGesture.setEnabled.mockResolvedValueOnce({
+                supported: true,
+                enabled: false,
+                reason: 'supported',
+                platform: 'ios',
+            });
+            const state = await YaverFeedback_1.YaverFeedback.syncDogfoodControlGesture();
+            expect(state).toMatchObject({
+                gestureSupported: true,
+                gestureEnabled: false,
+                fallbackVisible: true,
+                reason: 'gesture-enable-failed',
+            });
+        });
+        it('persists first-run completion for the exact account app installation', async () => {
+            initActiveDogfood({ authToken: 'owner-token' });
+            jest.spyOn(YaverFeedback_1.YaverFeedback, 'getDogfoodAccess').mockResolvedValueOnce({
+                appId: 'io.example.app',
+                yaverAuthenticated: true,
+                ownerAuthorized: true,
+                accountAuthorized: true,
+                installationId: 'phone-1',
+                deviceState: 'active',
+                authorized: true,
+                controlOnboardingSeen: false,
+            });
+            const state = await YaverFeedback_1.YaverFeedback.setDogfoodControlPresentation('minimized-y');
+            expect(state).toMatchObject({ onboardingSeen: true, presentation: 'minimized-y', fallbackVisible: true });
+            expect(auth_1.setDogfoodControlPreference).toHaveBeenCalledWith(expect.objectContaining({
+                appId: 'io.example.app',
+                installationId: 'phone-1',
+                token: 'owner-token',
+                presentation: 'minimized-y',
+                controlOnboardingSeen: true,
+            }));
+        });
+        it('falls back to the minimized Y when accessibility owns multi-touch', async () => {
+            initActiveDogfood({ controlGesture: { durationMs: 1200 } });
+            jest.spyOn(YaverFeedback_1.YaverFeedback, 'getDogfoodAccess').mockResolvedValueOnce({
+                appId: 'io.example.app',
+                yaverAuthenticated: true,
+                ownerAuthorized: false,
+                accountAuthorized: true,
+                installationId: 'phone-1',
+                deviceState: 'active',
+                authorized: true,
+            });
+            react_native_1.NativeModules.YaverDogfoodGesture.getCapability.mockResolvedValueOnce({
+                supported: false,
+                enabled: false,
+                reason: 'accessibility-touch-exploration',
+                platform: 'ios',
+            });
+            const state = await YaverFeedback_1.YaverFeedback.syncDogfoodControlGesture();
+            expect(state).toMatchObject({ gestureSupported: false, gestureEnabled: false, fallbackVisible: true });
+            expect(react_native_1.NativeModules.YaverDogfoodGesture.setEnabled).toHaveBeenCalledWith(false, 1200);
+        });
+        it('suppresses guest controls inside the Yaver split-view container', async () => {
+            initActiveDogfood();
+            react_native_1.NativeModules.YaverInfo = { isYaver: true };
+            const state = await YaverFeedback_1.YaverFeedback.syncDogfoodControlGesture();
+            delete react_native_1.NativeModules.YaverInfo;
+            expect(state).toMatchObject({ gestureEnabled: false, fallbackVisible: false, reason: 'yaver-host-owns-controls' });
+        });
+        it('removes the gesture and fallback Y when Dogfood exits', async () => {
+            initActiveDogfood();
+            await YaverFeedback_1.YaverFeedback.exitDogfoodMode();
+            const state = await YaverFeedback_1.YaverFeedback.syncDogfoodControlGesture();
+            expect(state).toMatchObject({
+                authorized: false,
+                gestureEnabled: false,
+                fallbackVisible: false,
+                reason: 'dogfood-session-inactive',
+            });
+            expect(react_native_1.NativeModules.YaverDogfoodGesture.setEnabled).toHaveBeenCalledWith(false, 900);
+        });
     });
     describe('init()', () => {
         it('sets config correctly with defaults', () => {

package/dist/auth.d.ts

@@ -52,8 +52,23 @@ export declare function clearSelectedDeviceId(): Promise<void>;
 export declare function getDogfoodAccountAccess(appId: string, token: string, installationId?: string): Promise<{
     authenticated: boolean;
     ownerAuthorized: boolean;
+    accountAuthorized: boolean;
     installationAuthorized: boolean;
+    controlPresentation?: 'auto' | 'minimized-y';
+    gestureSupported?: boolean;
+    gestureCapabilityReason?: string;
+    controlOnboardingSeen?: boolean;
 }>;
+export declare function setDogfoodControlPreference(input: {
+    appId: string;
+    installationId: string;
+    token: string;
+    presentation: 'auto' | 'minimized-y';
+    gestureSupported: boolean;
+    gestureCapabilityReason: string;
+    gesturePlatform: string;
+    controlOnboardingSeen?: boolean;
+}): Promise<boolean>;
 export declare function validateToken(token: string): Promise<User | null>;
 /**
  * Sign in with Apple using the native ASAuthorization flow. Requires

package/dist/auth.js

@@ -32,6 +32,7 @@ exports.getSelectedDeviceId = getSelectedDeviceId;
 exports.saveSelectedDeviceId = saveSelectedDeviceId;
 exports.clearSelectedDeviceId = clearSelectedDeviceId;
 exports.getDogfoodAccountAccess = getDogfoodAccountAccess;
+exports.setDogfoodControlPreference = setDogfoodControlPreference;
 exports.validateToken = validateToken;
 exports.signInWithApple = signInWithApple;
 exports.signInWithOAuth = signInWithOAuth;
@@ -202,16 +203,54 @@ async function getDogfoodAccountAccess(appId, token, installationId) {
         });
         clearTimeout(timeout);
         if (!response.ok)
-            return { authenticated: false, ownerAuthorized: false, installationAuthorized: false };
+            return { authenticated: false, ownerAuthorized: false, accountAuthorized: false, installationAuthorized: false };
         const result = await response.json();
         return {
             authenticated: result?.authenticated === true,
             ownerAuthorized: result?.ownerAuthorized === true,
+            accountAuthorized: result?.accountAuthorized === true,
             installationAuthorized: result?.installationAuthorized === true,
+            controlPresentation: result?.controlPresentation === 'minimized-y' ? 'minimized-y'
+                : result?.controlPresentation === 'auto' ? 'auto' : undefined,
+            gestureSupported: typeof result?.gestureSupported === 'boolean' ? result.gestureSupported : undefined,
+            gestureCapabilityReason: typeof result?.gestureCapabilityReason === 'string'
+                ? result.gestureCapabilityReason
+                : undefined,
+            controlOnboardingSeen: result?.controlOnboardingSeen === true,
         };
     }
     catch {
-        return { authenticated: false, ownerAuthorized: false, installationAuthorized: false };
+        return { authenticated: false, ownerAuthorized: false, accountAuthorized: false, installationAuthorized: false };
+    }
+}
+async function setDogfoodControlPreference(input) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 5000);
+    try {
+        const response = await fetch(`${convexSiteUrl}/dogfood/control-preference`, {
+            method: 'POST',
+            headers: {
+                Authorization: `Bearer ${input.token}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                appId: input.appId,
+                installationId: input.installationId,
+                presentation: input.presentation,
+                gestureSupported: input.gestureSupported,
+                gestureCapabilityReason: input.gestureCapabilityReason,
+                gesturePlatform: input.gesturePlatform,
+                controlOnboardingSeen: input.controlOnboardingSeen === true,
+            }),
+            signal: controller.signal,
+        });
+        return response.ok;
+    }
+    catch {
+        return false;
+    }
+    finally {
+        clearTimeout(timeout);
     }
 }
 // ─── Token validation ──────────────────────────────────────────────────

package/dist/dogfoodPolicy.d.ts

@@ -4,10 +4,18 @@ export interface DogfoodAccessSnapshot {
     yaverAuthenticated: boolean;
     /** Backend-confirmed owner/maintainer of this exact appId. */
     ownerAuthorized: boolean;
+    /** Backend-confirmed app assignment for this Yaver account. App owners are
+     * assigned implicitly; other accounts require an active owner grant. */
+    accountAuthorized: boolean;
     installationId?: string;
     deviceState: 'unknown' | 'unregistered' | 'pending' | 'active' | 'cancelled' | 'revoked' | 'superseded';
-    /** True only for a backend-approved device key or an authenticated owner. */
+    /** True only for an assigned account and this backend-approved device key. */
     authorized: boolean;
+    /** OAuth-backed preference scoped to this user + app + installation. */
+    controlPresentation?: 'auto' | 'minimized-y';
+    gestureSupported?: boolean;
+    gestureCapabilityReason?: string;
+    controlOnboardingSeen?: boolean;
 }
 export interface DogfoodFlowSnapshot {
     phase: 'idle' | 'denied' | 'auth-required' | 'machine-required' | 'opening' | 'error';
@@ -44,6 +52,19 @@ export interface SDKDogfoodConfig {
     appShortcut?: boolean | {
         label?: string;
     };
+    /** Smart in-app quick controls. On supported standalone iOS/Android builds,
+     * a three-finger hold opens a two-action card with no persistent overlay.
+     * Unsupported/accessibility-conflicted devices may show a minimized,
+     * draggable Y fallback. Yaver host/container mode suppresses both. */
+    controlGesture?: boolean | {
+        /** Hold duration, clamped to 650–2000 ms. Default 900 ms. */
+        durationMs?: number;
+        /** Default `minimized-y`; use `none` when Settings is the only fallback. */
+        fallback?: 'minimized-y' | 'none';
+        /** Initial user-facing presentation before their persisted SDK preference
+         * exists. `auto` keeps pixels clear when the gesture works. */
+        defaultPresentation?: 'auto' | 'minimized-y';
+    };
 }
 export interface SDKDogfoodStatus {
     active: boolean;

package/dist/index.d.ts

@@ -28,7 +28,7 @@
  * ```
  */
 export { YaverFeedback } from './YaverFeedback';
-export type { DogfoodOnboardingOptions, DogfoodFlowPhase, DogfoodFlowState } from './YaverFeedback';
+export type { DogfoodOnboardingOptions, DogfoodFlowPhase, DogfoodFlowState, DogfoodControlTriggerState, } from './YaverFeedback';
 export { captureStoreScreenshots } from './storeShots';
 export type { CaptureStoreScreenshotsOptions, CaptureStoreScreenshotsResult, StoreShotFrame, } from './storeShots';
 export { BlackBox } from './BlackBox';
@@ -59,7 +59,10 @@ export { YaverDeviceDogfood } from './deviceDogfood';
 export type { DeviceDogfoodOptions, DeviceDogfoodSession, DeviceDogfoodState } from './deviceDogfood';
 export { DogfoodController, DogfoodRuntimeError, defaultDogfoodLane, dogfoodLaneOptions, dogfoodLogLinesFromDevEvent, runtimeLogLinesFromDevEvent, validateDogfoodProject, } from './DogfoodRuntime';
 export type { DogfoodControllerOptions, DogfoodDriver, DogfoodFailure, DogfoodLane, DogfoodLaneOption, DogfoodLogLine, DogfoodPhase, DogfoodProject, DogfoodResult, DogfoodRunContext, DogfoodSnapshot, } from './DogfoodRuntime';
+export { DogfoodLanePicker, DogfoodLiveConsole, DogfoodStatusRail } from './DogfoodSessionUi';
+export type { DogfoodStatusStep, DogfoodStatusTone, DogfoodUiColors, } from './DogfoodSessionUi';
 export { FeedbackModal } from './FeedbackModal';
+export { DogfoodQuickControls } from './DogfoodQuickControls';
 export { QuickActionIcon } from './QuickActionIcon';
 export type { QuickActionIconProps } from './QuickActionIcon';
 export { FixReport } from './FixReport';

package/dist/index.js

@@ -29,8 +29,8 @@
  * ```
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.saveUser = exports.getUser = exports.clearToken = exports.saveToken = exports.getToken = exports.getWebBaseUrl = exports.getConvexSiteUrl = exports.configureAuthEndpoints = exports.setPreferredDogfoodLane = exports.getPreferredDogfoodLane = exports.clearQuickIconDisabled = exports.setQuickIconDisabled = exports.getQuickIconDisabled = exports.FixReport = exports.QuickActionIcon = exports.FeedbackModal = exports.validateDogfoodProject = exports.runtimeLogLinesFromDevEvent = exports.dogfoodLogLinesFromDevEvent = exports.dogfoodLaneOptions = exports.defaultDogfoodLane = exports.DogfoodRuntimeError = exports.DogfoodController = exports.YaverDeviceDogfood = exports.resolveSDKDogfood = exports.isYaverModeBadgeHidden = exports.showYaverModeBadge = exports.hideYaverModeBadge = exports.YaverModeBadge = exports.FloatingButton = exports.ShakeDetector = exports.AuthOverlay = exports.PairDeviceModal = exports.YaverMachinePickerScreen = exports.YaverLoginScreen = exports.YaverConnectionScreen = exports.RELOAD_APP_PATH = exports.RELOAD_PATH = exports.describeReloadFailure = exports.reloadFrameworkFamily = exports.reloadRequest = exports.reloadActions = exports.createP2PDogfoodDriver = exports.P2PClient = exports.YaverDiscovery = exports.initExpo = exports.YaverUpdates = exports.BlackBox = exports.captureStoreScreenshots = exports.YaverFeedback = void 0;
-exports.uploadFeedback = exports.isVideoRecording = exports.stopVideoRecording = exports.startVideoRecording = exports.pickFeedbackFile = exports.captureScreenshot = exports.DEFAULT_OAUTH_REDIRECT = exports.DEFAULT_WEB_BASE_URL = exports.DEFAULT_CONVEX_SITE_URL = exports.listReachableDevices = exports.loginWithEmail = exports.signupWithEmail = exports.signInWithOAuth = exports.signInWithApple = exports.validateToken = exports.clearSelectedDeviceId = exports.saveSelectedDeviceId = exports.getDogfoodAccountAccess = exports.getSelectedDeviceId = void 0;
+exports.getToken = exports.getWebBaseUrl = exports.getConvexSiteUrl = exports.configureAuthEndpoints = exports.setPreferredDogfoodLane = exports.getPreferredDogfoodLane = exports.clearQuickIconDisabled = exports.setQuickIconDisabled = exports.getQuickIconDisabled = exports.FixReport = exports.QuickActionIcon = exports.DogfoodQuickControls = exports.FeedbackModal = exports.DogfoodStatusRail = exports.DogfoodLiveConsole = exports.DogfoodLanePicker = exports.validateDogfoodProject = exports.runtimeLogLinesFromDevEvent = exports.dogfoodLogLinesFromDevEvent = exports.dogfoodLaneOptions = exports.defaultDogfoodLane = exports.DogfoodRuntimeError = exports.DogfoodController = exports.YaverDeviceDogfood = exports.resolveSDKDogfood = exports.isYaverModeBadgeHidden = exports.showYaverModeBadge = exports.hideYaverModeBadge = exports.YaverModeBadge = exports.FloatingButton = exports.ShakeDetector = exports.AuthOverlay = exports.PairDeviceModal = exports.YaverMachinePickerScreen = exports.YaverLoginScreen = exports.YaverConnectionScreen = exports.RELOAD_APP_PATH = exports.RELOAD_PATH = exports.describeReloadFailure = exports.reloadFrameworkFamily = exports.reloadRequest = exports.reloadActions = exports.createP2PDogfoodDriver = exports.P2PClient = exports.YaverDiscovery = exports.initExpo = exports.YaverUpdates = exports.BlackBox = exports.captureStoreScreenshots = exports.YaverFeedback = void 0;
+exports.uploadFeedback = exports.isVideoRecording = exports.stopVideoRecording = exports.startVideoRecording = exports.pickFeedbackFile = exports.captureScreenshot = exports.DEFAULT_OAUTH_REDIRECT = exports.DEFAULT_WEB_BASE_URL = exports.DEFAULT_CONVEX_SITE_URL = exports.listReachableDevices = exports.loginWithEmail = exports.signupWithEmail = exports.signInWithOAuth = exports.signInWithApple = exports.validateToken = exports.clearSelectedDeviceId = exports.saveSelectedDeviceId = exports.getDogfoodAccountAccess = exports.getSelectedDeviceId = exports.saveUser = exports.getUser = exports.clearToken = exports.saveToken = void 0;
 var YaverFeedback_1 = require("./YaverFeedback");
 Object.defineProperty(exports, "YaverFeedback", { enumerable: true, get: function () { return YaverFeedback_1.YaverFeedback; } });
 var storeShots_1 = require("./storeShots");
@@ -88,8 +88,14 @@ Object.defineProperty(exports, "dogfoodLaneOptions", { enumerable: true, get: fu
 Object.defineProperty(exports, "dogfoodLogLinesFromDevEvent", { enumerable: true, get: function () { return DogfoodRuntime_1.dogfoodLogLinesFromDevEvent; } });
 Object.defineProperty(exports, "runtimeLogLinesFromDevEvent", { enumerable: true, get: function () { return DogfoodRuntime_1.runtimeLogLinesFromDevEvent; } });
 Object.defineProperty(exports, "validateDogfoodProject", { enumerable: true, get: function () { return DogfoodRuntime_1.validateDogfoodProject; } });
+var DogfoodSessionUi_1 = require("./DogfoodSessionUi");
+Object.defineProperty(exports, "DogfoodLanePicker", { enumerable: true, get: function () { return DogfoodSessionUi_1.DogfoodLanePicker; } });
+Object.defineProperty(exports, "DogfoodLiveConsole", { enumerable: true, get: function () { return DogfoodSessionUi_1.DogfoodLiveConsole; } });
+Object.defineProperty(exports, "DogfoodStatusRail", { enumerable: true, get: function () { return DogfoodSessionUi_1.DogfoodStatusRail; } });
 var FeedbackModal_1 = require("./FeedbackModal");
 Object.defineProperty(exports, "FeedbackModal", { enumerable: true, get: function () { return FeedbackModal_1.FeedbackModal; } });
+var DogfoodQuickControls_1 = require("./DogfoodQuickControls");
+Object.defineProperty(exports, "DogfoodQuickControls", { enumerable: true, get: function () { return DogfoodQuickControls_1.DogfoodQuickControls; } });
 var QuickActionIcon_1 = require("./QuickActionIcon");
 Object.defineProperty(exports, "QuickActionIcon", { enumerable: true, get: function () { return QuickActionIcon_1.QuickActionIcon; } });
 var FixReport_1 = require("./FixReport");

package/dist/preferences.d.ts

@@ -12,6 +12,19 @@
  * still works (it just can't remember the disable beyond the
  * in-memory session).
  */
+export type DogfoodControlPresentation = 'auto' | 'minimized-y';
+export type DogfoodControlEdge = 'left' | 'right';
+export interface DogfoodControlPosition {
+    edge: DogfoodControlEdge;
+    /** 0–1 within the safe vertical travel area. */
+    yRatio: number;
+}
+export declare function getDogfoodControlPresentation(scope?: string): Promise<DogfoodControlPresentation | null>;
+export declare function setDogfoodControlPresentation(value: DogfoodControlPresentation, scope?: string): Promise<void>;
+export declare function getDogfoodControlPosition(orientation: 'portrait' | 'landscape', scope?: string): Promise<DogfoodControlPosition | null>;
+export declare function setDogfoodControlPosition(orientation: 'portrait' | 'landscape', position: DogfoodControlPosition, scope?: string): Promise<void>;
+export declare function getDogfoodControlOnboardingSeen(scope?: string): Promise<boolean>;
+export declare function setDogfoodControlOnboardingSeen(seen: boolean, scope?: string): Promise<void>;
 export type QuickIconColorPreset = 'orange' | 'lime' | 'cyan' | 'pink' | 'yellow' | 'slate';
 export declare const QUICK_ICON_COLOR_PRESETS: Record<QuickIconColorPreset, {
     label: string;

package/dist/preferences.js

@@ -15,6 +15,12 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.QUICK_ICON_COLOR_PRESETS = void 0;
+exports.getDogfoodControlPresentation = getDogfoodControlPresentation;
+exports.setDogfoodControlPresentation = setDogfoodControlPresentation;
+exports.getDogfoodControlPosition = getDogfoodControlPosition;
+exports.setDogfoodControlPosition = setDogfoodControlPosition;
+exports.getDogfoodControlOnboardingSeen = getDogfoodControlOnboardingSeen;
+exports.setDogfoodControlOnboardingSeen = setDogfoodControlOnboardingSeen;
 exports.getQuickIconDisabled = getQuickIconDisabled;
 exports.setQuickIconDisabled = setQuickIconDisabled;
 exports.clearQuickIconDisabled = clearQuickIconDisabled;
@@ -36,6 +42,84 @@ catch {
 }
 const QUICK_ICON_DISABLED_KEY = 'yaver_feedback_quickicon_disabled';
 const QUICK_ICON_COLOR_KEY = 'yaver_feedback_quickicon_color';
+const DOGFOOD_CONTROL_PRESENTATION_KEY = 'yaver_dogfood_control_presentation';
+const DOGFOOD_CONTROL_POSITION_PREFIX = 'yaver_dogfood_control_position_';
+const DOGFOOD_CONTROL_ONBOARDING_PREFIX = 'yaver_dogfood_control_onboarding_';
+function dogfoodPreferenceKey(base, scope) {
+    const normalized = String(scope || 'legacy').trim() || 'legacy';
+    return `${base}_${encodeURIComponent(normalized)}`;
+}
+async function getDogfoodControlPresentation(scope) {
+    if (!AsyncStorage)
+        return null;
+    try {
+        const value = await AsyncStorage.getItem(dogfoodPreferenceKey(DOGFOOD_CONTROL_PRESENTATION_KEY, scope));
+        return value === 'auto' || value === 'minimized-y' ? value : null;
+    }
+    catch {
+        return null;
+    }
+}
+async function setDogfoodControlPresentation(value, scope) {
+    if (!AsyncStorage)
+        return;
+    try {
+        await AsyncStorage.setItem(dogfoodPreferenceKey(DOGFOOD_CONTROL_PRESENTATION_KEY, scope), value);
+    }
+    catch {
+        // best-effort
+    }
+}
+async function getDogfoodControlPosition(orientation, scope) {
+    if (!AsyncStorage)
+        return null;
+    try {
+        const raw = await AsyncStorage.getItem(dogfoodPreferenceKey(`${DOGFOOD_CONTROL_POSITION_PREFIX}${orientation}`, scope));
+        if (!raw)
+            return null;
+        const parsed = JSON.parse(raw);
+        if ((parsed.edge !== 'left' && parsed.edge !== 'right') || typeof parsed.yRatio !== 'number')
+            return null;
+        return { edge: parsed.edge, yRatio: Math.max(0, Math.min(1, parsed.yRatio)) };
+    }
+    catch {
+        return null;
+    }
+}
+async function setDogfoodControlPosition(orientation, position, scope) {
+    if (!AsyncStorage)
+        return;
+    try {
+        await AsyncStorage.setItem(dogfoodPreferenceKey(`${DOGFOOD_CONTROL_POSITION_PREFIX}${orientation}`, scope), JSON.stringify(position));
+    }
+    catch {
+        // best-effort
+    }
+}
+async function getDogfoodControlOnboardingSeen(scope) {
+    if (!AsyncStorage)
+        return false;
+    try {
+        return await AsyncStorage.getItem(dogfoodPreferenceKey(DOGFOOD_CONTROL_ONBOARDING_PREFIX, scope)) === '1';
+    }
+    catch {
+        return false;
+    }
+}
+async function setDogfoodControlOnboardingSeen(seen, scope) {
+    if (!AsyncStorage)
+        return;
+    try {
+        const key = dogfoodPreferenceKey(DOGFOOD_CONTROL_ONBOARDING_PREFIX, scope);
+        if (seen)
+            await AsyncStorage.setItem(key, '1');
+        else
+            await AsyncStorage.removeItem(key);
+    }
+    catch {
+        // best-effort startup cache; Convex remains authoritative.
+    }
+}
 exports.QUICK_ICON_COLOR_PRESETS = {
     orange: {
         label: 'Orange',

package/ios/YaverDogfoodGesture.m

@@ -0,0 +1,14 @@
+#import <React/RCTBridgeModule.h>
+#import <React/RCTEventEmitter.h>
+
+@interface RCT_EXTERN_MODULE(YaverDogfoodGesture, RCTEventEmitter)
+
+RCT_EXTERN_METHOD(getCapability:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(setEnabled:(BOOL)enabled
+                  durationMs:(double)durationMs
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+@end