yaver-feedback-react-native 0.9.0 → 0.9.3

package/dist/dogfoodPolicy.d.ts

@@ -0,0 +1,25 @@
+export interface SDKDogfoodConfig {
+    /** Explicit opt-in. Omitted/false keeps the normal Feedback SDK. */
+    enabled?: boolean;
+    /** App-account IDs allowed to enter Dogfood. Public identifiers, not secrets. */
+    accountIds?: string[];
+    /** The third-party app's currently authenticated account ID. */
+    currentAccountId?: string;
+    /** Account-free installation identity resolved by YaverDeviceDogfood. */
+    appId?: string;
+    installationId?: string;
+    installationStatus?: 'pending' | 'active' | 'cancelled' | 'revoked' | 'superseded';
+    /** Called after the user confirms Exit Dogfood mode. */
+    onExit?: () => void | Promise<void>;
+    /** Optional app label shown beside Dogfood mode. */
+    label?: string;
+}
+export interface SDKDogfoodStatus {
+    active: boolean;
+    code: 'SDK_DOGFOOD_ACTIVE' | 'SDK_DOGFOOD_DISABLED' | 'SDK_DOGFOOD_ACCOUNT_REQUIRED' | 'SDK_DOGFOOD_ACCOUNT_NOT_ALLOWED' | 'SDK_DOGFOOD_INSTALLATION_REQUIRED' | 'SDK_DOGFOOD_INSTALLATION_NOT_ACTIVE';
+    accountId?: string;
+    label: string;
+}
+/** Pure, fail-closed account gate shared by init, the Y badge and tests.
+ * This controls SDK UX only; every task/reload still requires Yaver auth. */
+export declare function resolveSDKDogfood(config?: SDKDogfoodConfig | null): SDKDogfoodStatus;

package/dist/dogfoodPolicy.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSDKDogfood = resolveSDKDogfood;
+/** Pure, fail-closed account gate shared by init, the Y badge and tests.
+ * This controls SDK UX only; every task/reload still requires Yaver auth. */
+function resolveSDKDogfood(config) {
+    const label = String(config?.label || 'Dogfood').trim() || 'Dogfood';
+    if (config?.enabled !== true)
+        return { active: false, code: 'SDK_DOGFOOD_DISABLED', label };
+    if (config.appId) {
+        if (!config.installationId)
+            return { active: false, code: 'SDK_DOGFOOD_INSTALLATION_REQUIRED', label };
+        if (config.installationStatus !== 'active')
+            return { active: false, code: 'SDK_DOGFOOD_INSTALLATION_NOT_ACTIVE', label };
+        return { active: true, code: 'SDK_DOGFOOD_ACTIVE', accountId: config.installationId, label };
+    }
+    const accountId = String(config.currentAccountId || '').trim();
+    if (!accountId)
+        return { active: false, code: 'SDK_DOGFOOD_ACCOUNT_REQUIRED', label };
+    const allowed = new Set((config.accountIds || []).map((id) => String(id).trim()).filter(Boolean));
+    if (!allowed.has(accountId))
+        return { active: false, code: 'SDK_DOGFOOD_ACCOUNT_NOT_ALLOWED', accountId, label };
+    return { active: true, code: 'SDK_DOGFOOD_ACTIVE', accountId, label };
+}

package/dist/index.d.ts

@@ -28,31 +28,44 @@
  * ```
  */
 export { YaverFeedback } from './YaverFeedback';
+export type { DogfoodOnboardingOptions } from './YaverFeedback';
+export { captureStoreScreenshots } from './storeShots';
+export type { CaptureStoreScreenshotsOptions, CaptureStoreScreenshotsResult, StoreShotFrame, } from './storeShots';
 export { BlackBox } from './BlackBox';
 export { YaverUpdates } from './YaverUpdates';
 export type { YaverUpdatesConfig, PendingUpdate } from './YaverUpdates';
 export { initExpo } from './expo';
 export { YaverDiscovery } from './Discovery';
 export { P2PClient } from './P2PClient';
+export type { DogfoodDevEvent, DogfoodDevServerStatus, DogfoodRemoteRuntimeCapabilities, DogfoodRemoteRuntimeSession, DogfoodRemoteRuntimeTarget, } from './P2PClient';
+export { createP2PDogfoodDriver, type P2PDogfoodDriverOptions } from './P2PDogfoodDriver';
+export { reloadActions, reloadRequest, reloadFrameworkFamily, describeReloadFailure, RELOAD_PATH, RELOAD_APP_PATH, } from './reloadActions';
+export type { ReloadAction, ReloadActionId, ReloadActionsOptions, ReloadWireMode, DevServerSnapshot, } from './reloadActions';
 export { YaverConnectionScreen } from './ConnectionScreen';
 export { YaverLoginScreen } from './LoginScreen';
 export type { YaverLoginScreenProps } from './LoginScreen';
 export { YaverMachinePickerScreen } from './MachinePickerScreen';
 export type { YaverMachinePickerProps } from './MachinePickerScreen';
-export { YaverGuestOnboardingScreen } from './GuestOnboardingScreen';
-export type { YaverGuestOnboardingScreenProps } from './GuestOnboardingScreen';
 export { PairDeviceModal } from './PairDeviceModal';
 export type { PairDeviceModalProps } from './PairDeviceModal';
 export { AuthOverlay } from './AuthOverlay';
 export { ShakeDetector } from './ShakeDetector';
 export { FloatingButton } from './FloatingButton';
+export { YaverModeBadge, hideYaverModeBadge, showYaverModeBadge, isYaverModeBadgeHidden } from './YaverModeBadge';
+export type { YaverModeBadgeProps } from './YaverModeBadge';
+export { resolveSDKDogfood } from './dogfoodPolicy';
+export type { SDKDogfoodConfig, SDKDogfoodStatus } from './dogfoodPolicy';
+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 { FeedbackModal } from './FeedbackModal';
 export { QuickActionIcon } from './QuickActionIcon';
 export type { QuickActionIconProps } from './QuickActionIcon';
 export { FixReport } from './FixReport';
 export { getQuickIconDisabled, setQuickIconDisabled, clearQuickIconDisabled, } from './preferences';
-export { configureAuthEndpoints, getConvexSiteUrl, getWebBaseUrl, getToken, saveToken, clearToken, getUser, saveUser, getSelectedDeviceId, saveSelectedDeviceId, clearSelectedDeviceId, validateToken, signInWithApple, signInWithOAuth, signupWithEmail, loginWithEmail, listReachableDevices, fetchGuestHosts, findInviteByCode, acceptGuestByCode, acceptGuestInvitation, DEFAULT_CONVEX_SITE_URL, DEFAULT_WEB_BASE_URL, DEFAULT_OAUTH_REDIRECT, } from './auth';
-export type { OAuthProvider, User, RemoteDevice, DeviceList, GuestInvitation, ActiveGuestHost, GuestHostsResponse, InvitationHostDevice, InvitationPreview, } from './auth';
+export { configureAuthEndpoints, getConvexSiteUrl, getWebBaseUrl, getToken, saveToken, clearToken, getUser, saveUser, getSelectedDeviceId, saveSelectedDeviceId, clearSelectedDeviceId, validateToken, signInWithApple, signInWithOAuth, signupWithEmail, loginWithEmail, listReachableDevices, DEFAULT_CONVEX_SITE_URL, DEFAULT_WEB_BASE_URL, DEFAULT_OAUTH_REDIRECT, } from './auth';
+export type { OAuthProvider, User, RemoteDevice, DeviceList, } from './auth';
 export { captureScreenshot, pickFeedbackFile, startVideoRecording, stopVideoRecording, isVideoRecording, } from './capture';
 export { uploadFeedback } from './upload';
 export type { FeedbackConfig, FeedbackBundle, FeedbackMetadata, DeviceInfo, AppInfo, TimelineEvent, FeedbackReport, FeedbackStreamEvent, VoiceCapability, CapturedError, TestFix, TestSession, } from './types';

package/dist/index.js

@@ -29,9 +29,12 @@
  * ```
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-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.acceptGuestInvitation = exports.acceptGuestByCode = exports.findInviteByCode = exports.fetchGuestHosts = exports.listReachableDevices = exports.loginWithEmail = exports.signupWithEmail = exports.signInWithOAuth = exports.signInWithApple = 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.clearQuickIconDisabled = exports.setQuickIconDisabled = exports.getQuickIconDisabled = exports.FixReport = exports.QuickActionIcon = exports.FeedbackModal = exports.FloatingButton = exports.ShakeDetector = exports.AuthOverlay = exports.PairDeviceModal = exports.YaverGuestOnboardingScreen = exports.YaverMachinePickerScreen = exports.YaverLoginScreen = exports.YaverConnectionScreen = exports.P2PClient = exports.YaverDiscovery = exports.initExpo = exports.YaverUpdates = exports.BlackBox = exports.YaverFeedback = void 0;
+exports.saveSelectedDeviceId = exports.getSelectedDeviceId = exports.saveUser = exports.getUser = exports.clearToken = exports.saveToken = exports.getToken = exports.getWebBaseUrl = exports.getConvexSiteUrl = exports.configureAuthEndpoints = 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 = void 0;
 var YaverFeedback_1 = require("./YaverFeedback");
 Object.defineProperty(exports, "YaverFeedback", { enumerable: true, get: function () { return YaverFeedback_1.YaverFeedback; } });
+var storeShots_1 = require("./storeShots");
+Object.defineProperty(exports, "captureStoreScreenshots", { enumerable: true, get: function () { return storeShots_1.captureStoreScreenshots; } });
 var BlackBox_1 = require("./BlackBox");
 Object.defineProperty(exports, "BlackBox", { enumerable: true, get: function () { return BlackBox_1.BlackBox; } });
 var YaverUpdates_1 = require("./YaverUpdates");
@@ -42,14 +45,21 @@ 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 P2PDogfoodDriver_1 = require("./P2PDogfoodDriver");
+Object.defineProperty(exports, "createP2PDogfoodDriver", { enumerable: true, get: function () { return P2PDogfoodDriver_1.createP2PDogfoodDriver; } });
+var reloadActions_1 = require("./reloadActions");
+Object.defineProperty(exports, "reloadActions", { enumerable: true, get: function () { return reloadActions_1.reloadActions; } });
+Object.defineProperty(exports, "reloadRequest", { enumerable: true, get: function () { return reloadActions_1.reloadRequest; } });
+Object.defineProperty(exports, "reloadFrameworkFamily", { enumerable: true, get: function () { return reloadActions_1.reloadFrameworkFamily; } });
+Object.defineProperty(exports, "describeReloadFailure", { enumerable: true, get: function () { return reloadActions_1.describeReloadFailure; } });
+Object.defineProperty(exports, "RELOAD_PATH", { enumerable: true, get: function () { return reloadActions_1.RELOAD_PATH; } });
+Object.defineProperty(exports, "RELOAD_APP_PATH", { enumerable: true, get: function () { return reloadActions_1.RELOAD_APP_PATH; } });
 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 GuestOnboardingScreen_1 = require("./GuestOnboardingScreen");
-Object.defineProperty(exports, "YaverGuestOnboardingScreen", { enumerable: true, get: function () { return GuestOnboardingScreen_1.YaverGuestOnboardingScreen; } });
 var PairDeviceModal_1 = require("./PairDeviceModal");
 Object.defineProperty(exports, "PairDeviceModal", { enumerable: true, get: function () { return PairDeviceModal_1.PairDeviceModal; } });
 var AuthOverlay_1 = require("./AuthOverlay");
@@ -58,6 +68,26 @@ 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; } });
+// The polite "you're inside Yaver" mark. Rendered automatically by the SDK's
+// overlay host when config.modeBadge !== false; exported so an app that manages
+// its own overlay tree can place it itself.
+var YaverModeBadge_1 = require("./YaverModeBadge");
+Object.defineProperty(exports, "YaverModeBadge", { enumerable: true, get: function () { return YaverModeBadge_1.YaverModeBadge; } });
+Object.defineProperty(exports, "hideYaverModeBadge", { enumerable: true, get: function () { return YaverModeBadge_1.hideYaverModeBadge; } });
+Object.defineProperty(exports, "showYaverModeBadge", { enumerable: true, get: function () { return YaverModeBadge_1.showYaverModeBadge; } });
+Object.defineProperty(exports, "isYaverModeBadgeHidden", { enumerable: true, get: function () { return YaverModeBadge_1.isYaverModeBadgeHidden; } });
+var dogfoodPolicy_1 = require("./dogfoodPolicy");
+Object.defineProperty(exports, "resolveSDKDogfood", { enumerable: true, get: function () { return dogfoodPolicy_1.resolveSDKDogfood; } });
+var deviceDogfood_1 = require("./deviceDogfood");
+Object.defineProperty(exports, "YaverDeviceDogfood", { enumerable: true, get: function () { return deviceDogfood_1.YaverDeviceDogfood; } });
+var DogfoodRuntime_1 = require("./DogfoodRuntime");
+Object.defineProperty(exports, "DogfoodController", { enumerable: true, get: function () { return DogfoodRuntime_1.DogfoodController; } });
+Object.defineProperty(exports, "DogfoodRuntimeError", { enumerable: true, get: function () { return DogfoodRuntime_1.DogfoodRuntimeError; } });
+Object.defineProperty(exports, "defaultDogfoodLane", { enumerable: true, get: function () { return DogfoodRuntime_1.defaultDogfoodLane; } });
+Object.defineProperty(exports, "dogfoodLaneOptions", { enumerable: true, get: function () { return DogfoodRuntime_1.dogfoodLaneOptions; } });
+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 FeedbackModal_1 = require("./FeedbackModal");
 Object.defineProperty(exports, "FeedbackModal", { enumerable: true, get: function () { return FeedbackModal_1.FeedbackModal; } });
 var QuickActionIcon_1 = require("./QuickActionIcon");
@@ -86,10 +116,6 @@ Object.defineProperty(exports, "signInWithOAuth", { enumerable: true, get: funct
 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, "fetchGuestHosts", { enumerable: true, get: function () { return auth_1.fetchGuestHosts; } });
-Object.defineProperty(exports, "findInviteByCode", { enumerable: true, get: function () { return auth_1.findInviteByCode; } });
-Object.defineProperty(exports, "acceptGuestByCode", { enumerable: true, get: function () { return auth_1.acceptGuestByCode; } });
-Object.defineProperty(exports, "acceptGuestInvitation", { enumerable: true, get: function () { return auth_1.acceptGuestInvitation; } });
 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; } });
 Object.defineProperty(exports, "DEFAULT_OAUTH_REDIRECT", { enumerable: true, get: function () { return auth_1.DEFAULT_OAUTH_REDIRECT; } });

package/dist/reloadActions.d.ts

@@ -0,0 +1,88 @@
+/** Stable identifier for each action the overlay can render. */
+export type ReloadActionId = 'hot' | 'full' | 'rebuild';
+/** Wire value of the `mode` field (or `bundle` for /dev/reload-app). */
+export type ReloadWireMode = 'fast' | 'full' | 'bundle';
+/** The part of GET /dev/status this decision depends on. */
+export interface DevServerSnapshot {
+    /** Is a dev server process alive on the machine? */
+    running: boolean;
+    /** Is it still compiling? A reload now would race the build. */
+    building?: boolean;
+    /** Agent's framework name: expo | react-native | flutter | vite | nextjs. */
+    framework?: string;
+}
+export interface ReloadActionsOptions {
+    /**
+     * Is the HOST APP a development build?
+     *
+     * There is no honest default here, so there is no default: every stack has
+     * its own signal (`__DEV__`, `kDebugMode`, `Debug.isDebugBuild`,
+     * `FLAG_DEBUGGABLE`, `#if DEBUG`) and the caller passes it. False means the
+     * list is EMPTY — a shipped app never gets a reload button.
+     */
+    isDevBuild: boolean;
+    /** Do we have an agent connection / selected machine at all? */
+    connected: boolean;
+    /** Human label for the machine, used inside the disabled reason. */
+    machineLabel?: string;
+    /**
+     * Offer the React Native bundle rebuild as a third action. Only the RN SDK
+     * can act on the pushed bundle, so only the RN SDK sets this.
+     */
+    includeRebuild?: boolean;
+}
+export interface ReloadAction {
+    id: ReloadActionId;
+    /** Button label — stack-idiomatic wording lives here, not at the call site. */
+    label: string;
+    /** One line under/next to the button explaining what it actually does. */
+    hint: string;
+    mode: ReloadWireMode;
+    /** Agent path this action POSTs to. */
+    path: string;
+    enabled: boolean;
+    /**
+     * Present exactly when `enabled` is false. Names the specific blocker and
+     * the fix — never "unavailable".
+     */
+    disabledReason?: string;
+}
+type FrameworkFamily = 'flutter' | 'react-native' | 'web' | 'unknown';
+/**
+ * Map the agent's framework name onto the family whose reload vocabulary we
+ * borrow. Unknown frameworks still get generic actions: the agent is the
+ * authority on what it can do, and refusing to offer a reload because we did
+ * not recognise a name would be us inventing a limit the product does not have.
+ */
+export declare function reloadFrameworkFamily(framework?: string): FrameworkFamily;
+/** Path constants — mirrored from AGENT_ENDPOINTS so a typo cannot diverge. */
+export declare const RELOAD_PATH = "/dev/reload";
+export declare const RELOAD_APP_PATH = "/dev/reload-app";
+/**
+ * The whole decision, in one pure function.
+ *
+ * Returns the ordered list the overlay should render. An EMPTY list means
+ * "render no reload UI at all" — that is the production-build answer, and it
+ * is deliberately indistinguishable from "this SDK has no reload feature",
+ * because to a shipped app it doesn't.
+ *
+ * A NON-empty list may still contain disabled entries: showing a greyed
+ * "Hot Reload — no dev server is running on primary" teaches the user what
+ * to fix. Hiding it teaches them nothing.
+ */
+export declare function reloadActions(snapshot: DevServerSnapshot | null | undefined, opts: ReloadActionsOptions): ReloadAction[];
+/** The exact request an action makes. Kept next to the labels on purpose. */
+export declare function reloadRequest(action: Pick<ReloadAction, 'mode' | 'path'>): {
+    method: 'POST';
+    path: string;
+    body: Record<string, unknown>;
+};
+/**
+ * Turn a failed reload into a sentence that names the cause AND the fix.
+ *
+ * "Reload failed" is the shape of error this codebase keeps paying whole
+ * sessions for. Every branch below exists because the raw text the agent (or
+ * Go's net stack) produces is accurate and unreadable.
+ */
+export declare function describeReloadFailure(status: number, body: string, snapshot?: DevServerSnapshot | null): string;
+export {};

package/dist/reloadActions.js

@@ -0,0 +1,200 @@
+"use strict";
+// ─── Reload actions — the ONE decision seam every Yaver feedback SDK mirrors ──
+//
+// The in-app overlay offers the developer a way to reload the app they are
+// looking at, without leaving it. This file answers the three questions that
+// have to be answered IDENTICALLY on every stack, so that a bug fixed in one
+// SDK is not still shipping in the other five:
+//
+//   1. WHICH actions may be shown at all (production build ⇒ none, ever)?
+//   2. WHICH request does each action make (path + body)?
+//   3. WHEN a reload fails, WHAT do we tell the user?
+//
+// It is deliberately PURE — no fetch, no DOM, no globals. That is what makes
+// it unit-testable, and the unit test is the guard: a production build must
+// yield an empty action list. Break `isDevBuild` and the test fails.
+//
+// ── Wire contract (desktop/agent/devserver_http.go) ──────────────────────────
+//
+//   POST /dev/reload      { "mode": "fast" | "full" }
+//        fast — the framework's cheapest refresh. Flutter stdin "r" (hot
+//               reload, keeps state). Metro/Expo fast refresh. Vite/Next HMR.
+//        full — framework-level restart. Flutter stdin "R" (hot RESTART,
+//               resets state). Web lane additionally forces a warm re-export.
+//               NEVER a cache clear or a process cold-start.
+//        Absent/unknown mode is normalised to "fast" by the agent, so an old
+//        client keeps its exact old behaviour.
+//
+//   POST /dev/reload-app  { "mode": "bundle", ...identity }
+//        Rebuild the Hermes bytecode bundle on the agent and push it over the
+//        BlackBox channel. React Native only, and the ONLY action that still
+//        works when no dev server is running — which is why it stays enabled
+//        in exactly that case.
+//
+// ── Auth ─────────────────────────────────────────────────────────────────────
+//
+// None of this needs a new secret. `/dev/reload` and `/dev/reload-app` are
+// registered under `authSDK` (desktop/agent/httpserver.go), the same
+// middleware that already admits the bearer this SDK sends with its feedback
+// POST. A scope-limited SDK token needs the existing `reload` scope,
+// whose path list already contains both routes — no widening, no new gate.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RELOAD_APP_PATH = exports.RELOAD_PATH = void 0;
+exports.reloadFrameworkFamily = reloadFrameworkFamily;
+exports.reloadActions = reloadActions;
+exports.reloadRequest = reloadRequest;
+exports.describeReloadFailure = describeReloadFailure;
+/**
+ * Map the agent's framework name onto the family whose reload vocabulary we
+ * borrow. Unknown frameworks still get generic actions: the agent is the
+ * authority on what it can do, and refusing to offer a reload because we did
+ * not recognise a name would be us inventing a limit the product does not have.
+ */
+function reloadFrameworkFamily(framework) {
+    const f = (framework || '').trim().toLowerCase();
+    if (!f)
+        return 'unknown';
+    if (f.indexOf('flutter') >= 0)
+        return 'flutter';
+    if (f === 'expo' || f.indexOf('react-native') >= 0 || f.indexOf('metro') >= 0) {
+        return 'react-native';
+    }
+    if (f === 'vite' || f === 'next' || f === 'nextjs' || f === 'web' || f === 'webpack') {
+        return 'web';
+    }
+    return 'unknown';
+}
+const LABELS = {
+    flutter: {
+        hot: ['Hot Reload', 'Flutter hot reload (r) — keeps the current app state.'],
+        full: ['Hot Restart', 'Flutter hot restart (R) — restarts the app and resets state.'],
+    },
+    'react-native': {
+        hot: ['Hot Reload', 'Fast Refresh through Metro — keeps component state.'],
+        full: ['Full Reload', 'Reloads the whole JS bundle and resets state.'],
+    },
+    web: {
+        hot: ['Hot Reload', 'Hot module replacement through the dev server.'],
+        full: ['Full Reload', 'Re-exports the bundle and reloads the page.'],
+    },
+    unknown: {
+        hot: ['Hot Reload', "The dev server's cheapest refresh."],
+        full: ['Full Reload', 'Framework-level restart of the running app.'],
+    },
+};
+/** Path constants — mirrored from AGENT_ENDPOINTS so a typo cannot diverge. */
+exports.RELOAD_PATH = '/dev/reload';
+exports.RELOAD_APP_PATH = '/dev/reload-app';
+/**
+ * The whole decision, in one pure function.
+ *
+ * Returns the ordered list the overlay should render. An EMPTY list means
+ * "render no reload UI at all" — that is the production-build answer, and it
+ * is deliberately indistinguishable from "this SDK has no reload feature",
+ * because to a shipped app it doesn't.
+ *
+ * A NON-empty list may still contain disabled entries: showing a greyed
+ * "Hot Reload — no dev server is running on primary" teaches the user what
+ * to fix. Hiding it teaches them nothing.
+ */
+function reloadActions(snapshot, opts) {
+    // 1. Production build — never, under any circumstance.
+    if (!opts.isDevBuild)
+        return [];
+    const snap = snapshot || { running: false };
+    const family = reloadFrameworkFamily(snap.framework);
+    const labels = LABELS[family];
+    const machine = (opts.machineLabel || '').trim() || 'the selected machine';
+    let blocked;
+    if (!opts.connected) {
+        blocked = 'Not connected to a machine yet — pick one first.';
+    }
+    else if (snap.building) {
+        blocked = 'The dev server is still building — reload works once it finishes.';
+    }
+    else if (!snap.running) {
+        blocked =
+            `No dev server is running on ${machine}. ` +
+                'Start one from the Yaver app, or run `yaver dev start` there.';
+    }
+    const actions = [
+        {
+            id: 'hot',
+            label: labels.hot[0],
+            hint: labels.hot[1],
+            mode: 'fast',
+            path: exports.RELOAD_PATH,
+            enabled: !blocked,
+            disabledReason: blocked,
+        },
+        {
+            id: 'full',
+            label: labels.full[0],
+            hint: labels.full[1],
+            mode: 'full',
+            path: exports.RELOAD_PATH,
+            enabled: !blocked,
+            disabledReason: blocked,
+        },
+    ];
+    if (opts.includeRebuild) {
+        // Deliberately NOT gated on `running`: rebuilding the bundle is exactly
+        // what you do when Metro is not up. It is gated on `connected`, because
+        // without a machine there is nothing to rebuild on.
+        const rebuildBlocked = opts.connected
+            ? undefined
+            : 'Not connected to a machine yet — pick one first.';
+        actions.push({
+            id: 'rebuild',
+            label: 'Rebuild Bundle',
+            hint: 'Recompiles the Hermes bundle on the machine. Works with no dev server.',
+            mode: 'bundle',
+            path: exports.RELOAD_APP_PATH,
+            enabled: !rebuildBlocked,
+            disabledReason: rebuildBlocked,
+        });
+    }
+    return actions;
+}
+/** The exact request an action makes. Kept next to the labels on purpose. */
+function reloadRequest(action) {
+    return { method: 'POST', path: action.path, body: { mode: action.mode } };
+}
+/**
+ * Turn a failed reload into a sentence that names the cause AND the fix.
+ *
+ * "Reload failed" is the shape of error this codebase keeps paying whole
+ * sessions for. Every branch below exists because the raw text the agent (or
+ * Go's net stack) produces is accurate and unreadable.
+ */
+function describeReloadFailure(status, body, snapshot) {
+    const lower = (body || '').toLowerCase();
+    const framework = (snapshot?.framework || '').trim();
+    if (lower.indexOf('does not support hot reload') >= 0) {
+        const name = framework || 'This dev server';
+        return `${name} cannot hot reload. Use Rebuild Bundle, or restart the dev server.`;
+    }
+    if (status === 503 ||
+        lower.indexOf('no dev server') >= 0 ||
+        lower.indexOf('dev server not available') >= 0) {
+        return 'No dev server is running on the machine. Start one before reloading.';
+    }
+    if ((lower.indexOf('connection refused') >= 0 || lower.indexOf('econnrefused') >= 0) &&
+        (lower.indexOf('127.0.0.1') >= 0 || lower.indexOf('localhost') >= 0)) {
+        return 'The dev server is not listening on the machine. Start it with `yaver dev start`.';
+    }
+    if (status === 401 || status === 403) {
+        return 'The machine rejected this session — sign in again, or re-pair this device.';
+    }
+    if (status === 404) {
+        return ('This machine’s agent has no /dev/reload route — it is too old. ' +
+            'Update it with `npm install -g yaver-cli@latest`.');
+    }
+    if (status >= 500) {
+        return 'The agent hit an internal error while reloading. Check `yaver logs` on the machine.';
+    }
+    if (status === 0) {
+        return 'Could not reach the machine. Check that it is online and `yaver serve` is running.';
+    }
+    return `Reload failed (HTTP ${status}).`;
+}

package/dist/storeShots.d.ts

@@ -0,0 +1,67 @@
+/**
+ * On-device App Store screenshot capture (Engine 2).
+ *
+ * The desktop `yaver shots` flow drives a simulator with Maestro. This is
+ * the in-app counterpart: the SDK, living inside the real running app,
+ * walks the app's own routes and screenshots each one with
+ * `react-native-view-shot`, then uploads the frames to the Yaver agent
+ * (POST /shots/upload). The agent normalizes them and runs the same App
+ * Store Connect backend (upload → metadata → submit).
+ *
+ * Why this exists alongside the simulator path: it captures *real device*
+ * pixels, knows the exact route map (no heuristics), and the user is
+ * already authenticated — so it sidesteps the i18n / no-testID fragility
+ * that makes a blind simulator walk hard.
+ *
+ * The host wires it once by handing us a navigation ref (react-navigation
+ * or expo-router router) plus the ordered list of routes to visit.
+ */
+export interface StoreShotFrame {
+    route: string;
+    base64: string;
+    mimeType: string;
+}
+export interface CaptureStoreScreenshotsOptions {
+    /** Yaver agent base URL (e.g. http://192.168.1.5:18080 or a relay URL). */
+    agentUrl: string;
+    /** Bearer token for the agent (same-user envelope). */
+    authToken: string;
+    /** Relay password — required only when agentUrl is relay-routed. */
+    relayPassword?: string;
+    /** App name (vault scope / job label on the agent side). */
+    app: string;
+    /** iOS bundle id; the agent falls back to app.json if omitted. */
+    bundleId?: string;
+    /** App Store localization (default en-US). */
+    locale?: string;
+    /** When true, the agent also sets metadata + attempts submit-for-review. */
+    submit?: boolean;
+    /**
+     * Navigation handle. Either a react-navigation ref (has `.navigate`) or
+     * an expo-router `router` (has `.push`/`.navigate`). We call the first
+     * available method with the route string.
+     */
+    navigationRef?: any;
+    /** Ordered routes to visit + screenshot (e.g. ['/(tabs)/dashboard', ...]). */
+    routes: string[];
+    /** Optional per-route screenshot names (defaults to NN_<sanitized route>). */
+    screens?: string[];
+    /** Milliseconds to wait after navigating before capturing (default 900). */
+    settleMs?: number;
+    /** Hook the host can use to hide its own overlay before each capture. */
+    onBeforeCapture?: (route: string, index: number) => void | Promise<void>;
+}
+export interface CaptureStoreScreenshotsResult {
+    ok: boolean;
+    captured: number;
+    uploaded: number;
+    submitted?: boolean;
+    staged?: boolean;
+    message?: string;
+}
+/**
+ * Walk the app's routes, screenshot each, and upload the batch to the
+ * agent. Returns a summary; never throws for a single missed route —
+ * it captures what it can and reports the count.
+ */
+export declare function captureStoreScreenshots(opts: CaptureStoreScreenshotsOptions): Promise<CaptureStoreScreenshotsResult>;