@buoy-gg/impersonate 3.0.1 → 4.0.1

package/lib/commonjs/impersonate/utils/impersonateStore.js

@@ -310,6 +310,32 @@ class ImpersonateStore {
     return () => this.listeners.delete(listener);
   };
 
+  // ===========================================================================
+  // REMOTE MIRROR MODE
+  // ===========================================================================
+
+  remoteHandler = null;
+
+  /**
+   * Remote mirror mode (desktop dashboard): while a handler is set, every
+   * mutation forwards (method, params) to the synced device instead of
+   * running locally — header patching, data nuking and persistence all
+   * happen on the device, and the resulting state comes back via
+   * replaceState(). Pass null to restore local behavior.
+   */
+  setRemoteHandler(handler) {
+    this.remoteHandler = handler;
+  }
+
+  /**
+   * Replace the mirrored state from a synced device snapshot. Does not
+   * persist or touch the fetch listener — the device owns both.
+   */
+  replaceState(state) {
+    this.state = state;
+    this.notify();
+  }
+
   // ===========================================================================
   // IMPERSONATION ACTIONS
   // ===========================================================================
@@ -324,6 +350,12 @@ class ImpersonateStore {
    * the visual symptom of "I clicked a user and nothing changed."
    */
   async startImpersonation(user) {
+    if (this.remoteHandler) {
+      this.remoteHandler("startImpersonation", {
+        user
+      });
+      return;
+    }
     const historyEntry = {
       user,
       lastUsedAt: new Date().toISOString()
@@ -358,6 +390,10 @@ class ImpersonateStore {
    * before nuking caches so subsequent refetches go out without the header.
    */
   async stopImpersonation() {
+    if (this.remoteHandler) {
+      this.remoteHandler("stopImpersonation");
+      return;
+    }
     // eslint-disable-next-line no-console
     console.log(`[impersonate] stopImpersonation: isActive ${this.state.isActive} -> false, listeners=${this.listeners.size}`);
     this.state = {
@@ -376,6 +412,10 @@ class ImpersonateStore {
    * Pause impersonation (temporarily stop injecting headers)
    */
   async pauseImpersonation() {
+    if (this.remoteHandler) {
+      this.remoteHandler("pauseImpersonation");
+      return;
+    }
     if (!this.state.isActive || this.state.isPaused) return;
     this.state = {
       ...this.state,
@@ -396,6 +436,10 @@ class ImpersonateStore {
    * Resume impersonation (start injecting headers again)
    */
   async resumeImpersonation() {
+    if (this.remoteHandler) {
+      this.remoteHandler("resumeImpersonation");
+      return;
+    }
     if (!this.state.isActive || !this.state.isPaused) return;
     this.state = {
       ...this.state,
@@ -427,6 +471,12 @@ class ImpersonateStore {
    * Update settings (header key, ignore patterns, data nuke settings, show banner)
    */
   async updateSettings(settings) {
+    if (this.remoteHandler) {
+      this.remoteHandler("updateSettings", {
+        settings
+      });
+      return;
+    }
     this.state = {
       ...this.state,
       headerKey: settings.headerKey ?? this.state.headerKey,
@@ -454,6 +504,12 @@ class ImpersonateStore {
    * Remove a user from history
    */
   async removeFromHistory(userId) {
+    if (this.remoteHandler) {
+      this.remoteHandler("removeFromHistory", {
+        userId
+      });
+      return;
+    }
     this.state = {
       ...this.state,
       history: this.state.history.filter(entry => entry.user.id !== userId)
@@ -466,6 +522,10 @@ class ImpersonateStore {
    * Clear all history
    */
   async clearHistory() {
+    if (this.remoteHandler) {
+      this.remoteHandler("clearHistory");
+      return;
+    }
     this.state = {
       ...this.state,
       history: []

package/lib/commonjs/index.js

@@ -27,6 +27,12 @@ Object.defineProperty(exports, "ImpersonateHistoryList", {
     return _ImpersonateHistoryList.ImpersonateHistoryList;
   }
 });
+Object.defineProperty(exports, "ImpersonateIcon", {
+  enumerable: true,
+  get: function () {
+    return _preset.ImpersonateIcon;
+  }
+});
 Object.defineProperty(exports, "ImpersonateModal", {
   enumerable: true,
   get: function () {
@@ -51,6 +57,12 @@ Object.defineProperty(exports, "UserSearchView", {
     return _UserSearchView.UserSearchView;
   }
 });
+Object.defineProperty(exports, "createImpersonateSyncAdapter", {
+  enumerable: true,
+  get: function () {
+    return _impersonateSyncAdapter.createImpersonateSyncAdapter;
+  }
+});
 Object.defineProperty(exports, "createImpersonateTool", {
   enumerable: true,
   get: function () {
@@ -75,6 +87,12 @@ Object.defineProperty(exports, "impersonateStore", {
     return _impersonateStore.impersonateStore;
   }
 });
+Object.defineProperty(exports, "impersonateSyncAdapter", {
+  enumerable: true,
+  get: function () {
+    return _impersonateSyncAdapter.impersonateSyncAdapter;
+  }
+});
 Object.defineProperty(exports, "isImpersonating", {
   enumerable: true,
   get: function () {
@@ -112,6 +130,7 @@ Object.defineProperty(exports, "useImpersonateHistory", {
   }
 });
 var _preset = require("./preset");
+var _impersonateSyncAdapter = require("./sync/impersonateSyncAdapter");
 var _ImpersonateModal = require("./impersonate/components/ImpersonateModal");
 var _ImpersonateBanner = require("./impersonate/components/ImpersonateBanner");
 var _ImpersonateOverlay = require("./impersonate/components/ImpersonateOverlay");

package/lib/commonjs/preset.js

@@ -3,6 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
+exports.ImpersonateIcon = ImpersonateIcon;
 exports.createImpersonateTool = createImpersonateTool;
 var _react = _interopRequireDefault(require("react"));
 var _reactNative = require("react-native");
@@ -10,6 +11,7 @@ var _ImpersonateModal = require("./impersonate/components/ImpersonateModal");
 var _ImpersonateBanner = require("./impersonate/components/ImpersonateBanner");
 var _impersonateStore = require("./impersonate/utils/impersonateStore");
 var _impersonateListener = require("./impersonate/utils/impersonateListener");
+var _impersonateSyncAdapter = require("./sync/impersonateSyncAdapter");
 var _jsxRuntime = require("react/jsx-runtime");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 /**
@@ -175,6 +177,11 @@ function createImpersonateTool(config) {
     _impersonateStore.impersonateStore.setDeveloperDefaults(defaults);
   }
 
+  // Make the app's user search available to the zero-config external-sync
+  // adapter (FloatingDevTools auto-sync), so the desktop dashboard can proxy
+  // searches without separate wiring.
+  (0, _impersonateSyncAdapter.registerImpersonateSearchUsers)(onSearchUsers ?? null);
+
   // Patch fetch and restore persisted impersonation state up-front. Fire and
   // forget — bootstrapImpersonate guards itself against double-invocation.
   void bootstrapImpersonate();

package/lib/commonjs/sync/impersonateSyncAdapter.js

@@ -0,0 +1,68 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createImpersonateSyncAdapter = createImpersonateSyncAdapter;
+exports.impersonateSyncAdapter = void 0;
+exports.registerImpersonateSearchUsers = registerImpersonateSearchUsers;
+var _impersonateStore = require("../impersonate/utils/impersonateStore");
+// Registered by createImpersonateTool, so the zero-config adapter (see
+// FloatingDevTools' auto external sync) can proxy the dashboard's user
+// search without the app wiring anything twice.
+let registeredSearchUsers = null;
+
+/** @internal Called by createImpersonateTool with the app's onSearchUsers. */
+function registerImpersonateSearchUsers(handler) {
+  registeredSearchUsers = handler;
+}
+function buildActions(onSearchUsers) {
+  return {
+    searchUsers: params => onSearchUsers(params.query),
+    startImpersonation: params => _impersonateStore.impersonateStore.startImpersonation(params.user),
+    stopImpersonation: () => _impersonateStore.impersonateStore.stopImpersonation(),
+    pauseImpersonation: () => _impersonateStore.impersonateStore.pauseImpersonation(),
+    resumeImpersonation: () => _impersonateStore.impersonateStore.resumeImpersonation(),
+    updateSettings: params => _impersonateStore.impersonateStore.updateSettings(params.settings),
+    removeFromHistory: params => _impersonateStore.impersonateStore.removeFromHistory(params.userId),
+    clearHistory: () => _impersonateStore.impersonateStore.clearHistory()
+  };
+}
+/**
+ * Create a sync adapter for the impersonate tool, consumed by
+ * @buoy-gg/external-sync's `useExternalSync` (structurally matches its
+ * ToolSyncAdapter interface so this package doesn't need a dependency on it).
+ *
+ * The dashboard mirrors the impersonation state and forwards every mutation
+ * back as an action — header patching, data nuking and persistence all run
+ * on the device, so impersonating from the desktop behaves exactly like
+ * tapping the modal on the phone.
+ */
+function createImpersonateSyncAdapter({
+  onSearchUsers
+}) {
+  return {
+    version: 1,
+    getSnapshot: () => _impersonateStore.impersonateStore.getState(),
+    subscribe: onChange => _impersonateStore.impersonateStore.subscribe(onChange),
+    actions: buildActions(onSearchUsers)
+  };
+}
+
+/**
+ * Zero-config variant used by FloatingDevTools' auto external sync. User
+ * search proxies to the onSearchUsers the app passed to
+ * createImpersonateTool; if the tool was never configured, the search action
+ * reports a descriptive error to the dashboard.
+ */
+const impersonateSyncAdapter = exports.impersonateSyncAdapter = {
+  version: 1,
+  getSnapshot: () => _impersonateStore.impersonateStore.getState(),
+  subscribe: onChange => _impersonateStore.impersonateStore.subscribe(onChange),
+  actions: buildActions(query => {
+    if (!registeredSearchUsers) {
+      throw new Error("No onSearchUsers configured — pass it to createImpersonateTool()");
+    }
+    return registeredSearchUsers(query);
+  })
+};

package/lib/module/impersonate/utils/impersonateStore.js

@@ -307,6 +307,32 @@ class ImpersonateStore {
     return () => this.listeners.delete(listener);
   };
 
+  // ===========================================================================
+  // REMOTE MIRROR MODE
+  // ===========================================================================
+
+  remoteHandler = null;
+
+  /**
+   * Remote mirror mode (desktop dashboard): while a handler is set, every
+   * mutation forwards (method, params) to the synced device instead of
+   * running locally — header patching, data nuking and persistence all
+   * happen on the device, and the resulting state comes back via
+   * replaceState(). Pass null to restore local behavior.
+   */
+  setRemoteHandler(handler) {
+    this.remoteHandler = handler;
+  }
+
+  /**
+   * Replace the mirrored state from a synced device snapshot. Does not
+   * persist or touch the fetch listener — the device owns both.
+   */
+  replaceState(state) {
+    this.state = state;
+    this.notify();
+  }
+
   // ===========================================================================
   // IMPERSONATION ACTIONS
   // ===========================================================================
@@ -321,6 +347,12 @@ class ImpersonateStore {
    * the visual symptom of "I clicked a user and nothing changed."
    */
   async startImpersonation(user) {
+    if (this.remoteHandler) {
+      this.remoteHandler("startImpersonation", {
+        user
+      });
+      return;
+    }
     const historyEntry = {
       user,
       lastUsedAt: new Date().toISOString()
@@ -355,6 +387,10 @@ class ImpersonateStore {
    * before nuking caches so subsequent refetches go out without the header.
    */
   async stopImpersonation() {
+    if (this.remoteHandler) {
+      this.remoteHandler("stopImpersonation");
+      return;
+    }
     // eslint-disable-next-line no-console
     console.log(`[impersonate] stopImpersonation: isActive ${this.state.isActive} -> false, listeners=${this.listeners.size}`);
     this.state = {
@@ -373,6 +409,10 @@ class ImpersonateStore {
    * Pause impersonation (temporarily stop injecting headers)
    */
   async pauseImpersonation() {
+    if (this.remoteHandler) {
+      this.remoteHandler("pauseImpersonation");
+      return;
+    }
     if (!this.state.isActive || this.state.isPaused) return;
     this.state = {
       ...this.state,
@@ -393,6 +433,10 @@ class ImpersonateStore {
    * Resume impersonation (start injecting headers again)
    */
   async resumeImpersonation() {
+    if (this.remoteHandler) {
+      this.remoteHandler("resumeImpersonation");
+      return;
+    }
     if (!this.state.isActive || !this.state.isPaused) return;
     this.state = {
       ...this.state,
@@ -424,6 +468,12 @@ class ImpersonateStore {
    * Update settings (header key, ignore patterns, data nuke settings, show banner)
    */
   async updateSettings(settings) {
+    if (this.remoteHandler) {
+      this.remoteHandler("updateSettings", {
+        settings
+      });
+      return;
+    }
     this.state = {
       ...this.state,
       headerKey: settings.headerKey ?? this.state.headerKey,
@@ -451,6 +501,12 @@ class ImpersonateStore {
    * Remove a user from history
    */
   async removeFromHistory(userId) {
+    if (this.remoteHandler) {
+      this.remoteHandler("removeFromHistory", {
+        userId
+      });
+      return;
+    }
     this.state = {
       ...this.state,
       history: this.state.history.filter(entry => entry.user.id !== userId)
@@ -463,6 +519,10 @@ class ImpersonateStore {
    * Clear all history
    */
   async clearHistory() {
+    if (this.remoteHandler) {
+      this.remoteHandler("clearHistory");
+      return;
+    }
     this.state = {
       ...this.state,
       history: []

package/lib/module/index.js

@@ -26,7 +26,13 @@
 // FACTORY (Primary entry point)
 // =============================================================================
 
-export { createImpersonateTool } from "./preset";
+export { createImpersonateTool, ImpersonateIcon } from "./preset";
+
+// =============================================================================
+// EXTERNAL SYNC (Adapter for @buoy-gg/external-sync's useExternalSync)
+// =============================================================================
+
+export { createImpersonateSyncAdapter, impersonateSyncAdapter } from "./sync/impersonateSyncAdapter";
 
 // =============================================================================
 // COMPONENTS (For custom UI implementations)

package/lib/module/preset.js

@@ -13,6 +13,7 @@ import { ImpersonateModal } from "./impersonate/components/ImpersonateModal";
 import { ImpersonateBanner } from "./impersonate/components/ImpersonateBanner";
 import { impersonateStore } from "./impersonate/utils/impersonateStore";
 import { impersonateListener } from "./impersonate/utils/impersonateListener";
+import { registerImpersonateSearchUsers } from "./sync/impersonateSyncAdapter";
 import { jsx as _jsx } from "react/jsx-runtime";
 // =============================================================================
 // EAGER BOOTSTRAP
@@ -79,7 +80,7 @@ async function bootstrapImpersonate() {
 /**
  * Impersonate tool icon - a mask/person symbol
  */
-function ImpersonateIcon({
+export function ImpersonateIcon({
   size,
   color = "#F59E0B"
 }) {
@@ -170,6 +171,11 @@ export function createImpersonateTool(config) {
     impersonateStore.setDeveloperDefaults(defaults);
   }
 
+  // Make the app's user search available to the zero-config external-sync
+  // adapter (FloatingDevTools auto-sync), so the desktop dashboard can proxy
+  // searches without separate wiring.
+  registerImpersonateSearchUsers(onSearchUsers ?? null);
+
   // Patch fetch and restore persisted impersonation state up-front. Fire and
   // forget — bootstrapImpersonate guards itself against double-invocation.
   void bootstrapImpersonate();

package/lib/module/sync/impersonateSyncAdapter.js

@@ -0,0 +1,62 @@
+"use strict";
+
+import { impersonateStore } from "../impersonate/utils/impersonateStore";
+// Registered by createImpersonateTool, so the zero-config adapter (see
+// FloatingDevTools' auto external sync) can proxy the dashboard's user
+// search without the app wiring anything twice.
+let registeredSearchUsers = null;
+
+/** @internal Called by createImpersonateTool with the app's onSearchUsers. */
+export function registerImpersonateSearchUsers(handler) {
+  registeredSearchUsers = handler;
+}
+function buildActions(onSearchUsers) {
+  return {
+    searchUsers: params => onSearchUsers(params.query),
+    startImpersonation: params => impersonateStore.startImpersonation(params.user),
+    stopImpersonation: () => impersonateStore.stopImpersonation(),
+    pauseImpersonation: () => impersonateStore.pauseImpersonation(),
+    resumeImpersonation: () => impersonateStore.resumeImpersonation(),
+    updateSettings: params => impersonateStore.updateSettings(params.settings),
+    removeFromHistory: params => impersonateStore.removeFromHistory(params.userId),
+    clearHistory: () => impersonateStore.clearHistory()
+  };
+}
+/**
+ * Create a sync adapter for the impersonate tool, consumed by
+ * @buoy-gg/external-sync's `useExternalSync` (structurally matches its
+ * ToolSyncAdapter interface so this package doesn't need a dependency on it).
+ *
+ * The dashboard mirrors the impersonation state and forwards every mutation
+ * back as an action — header patching, data nuking and persistence all run
+ * on the device, so impersonating from the desktop behaves exactly like
+ * tapping the modal on the phone.
+ */
+export function createImpersonateSyncAdapter({
+  onSearchUsers
+}) {
+  return {
+    version: 1,
+    getSnapshot: () => impersonateStore.getState(),
+    subscribe: onChange => impersonateStore.subscribe(onChange),
+    actions: buildActions(onSearchUsers)
+  };
+}
+
+/**
+ * Zero-config variant used by FloatingDevTools' auto external sync. User
+ * search proxies to the onSearchUsers the app passed to
+ * createImpersonateTool; if the tool was never configured, the search action
+ * reports a descriptive error to the dashboard.
+ */
+export const impersonateSyncAdapter = {
+  version: 1,
+  getSnapshot: () => impersonateStore.getState(),
+  subscribe: onChange => impersonateStore.subscribe(onChange),
+  actions: buildActions(query => {
+    if (!registeredSearchUsers) {
+      throw new Error("No onSearchUsers configured — pass it to createImpersonateTool()");
+    }
+    return registeredSearchUsers(query);
+  })
+};

package/lib/typescript/impersonate/utils/impersonateStore.d.ts

@@ -83,6 +83,20 @@ declare class ImpersonateStore {
      * Returns unsubscribe function
      */
     subscribe: (listener: StateListener) => (() => void);
+    private remoteHandler;
+    /**
+     * Remote mirror mode (desktop dashboard): while a handler is set, every
+     * mutation forwards (method, params) to the synced device instead of
+     * running locally — header patching, data nuking and persistence all
+     * happen on the device, and the resulting state comes back via
+     * replaceState(). Pass null to restore local behavior.
+     */
+    setRemoteHandler(handler: ((method: string, params?: unknown) => void) | null): void;
+    /**
+     * Replace the mirrored state from a synced device snapshot. Does not
+     * persist or touch the fetch listener — the device owns both.
+     */
+    replaceState(state: ImpersonationState): void;
     /**
      * Start impersonating a user.
      *

package/lib/typescript/impersonate/utils/impersonateStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"impersonateStore.d.ts","sourceRoot":"","sources":["../../../../src/impersonate/utils/impersonateStore.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"impersonateStore.d.ts","sourceRoot":"","sources":["../../../../src/impersonate/utils/impersonateStore.ts"],"names":[],"mappings":"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"}

package/lib/typescript/index.d.ts

@@ -19,7 +19,8 @@
  * <FloatingDevTools apps={[impersonateTool]} />
  * ```
  */
-export { createImpersonateTool } from "./preset";
+export { createImpersonateTool, ImpersonateIcon } from "./preset";
+export { createImpersonateSyncAdapter, impersonateSyncAdapter, } from "./sync/impersonateSyncAdapter";
 export { ImpersonateModal } from "./impersonate/components/ImpersonateModal";
 export { ImpersonateBanner, ImpersonateBannerMinimal, } from "./impersonate/components/ImpersonateBanner";
 /**

package/lib/typescript/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAMH,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAMjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAC7E,OAAO,EACL,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,4CAA4C,CAAC;AACpD;;;;GAIG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,6CAA6C,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAE,gBAAgB,IAAI,yBAAyB,EAAE,MAAM,2CAA2C,CAAC;AAC1G,OAAO,EAAE,sBAAsB,EAAE,MAAM,iDAAiD,CAAC;AACzF,OAAO,EAAE,oBAAoB,EAAE,MAAM,+CAA+C,CAAC;AAMrF,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,YAAY,EACV,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AAClF,YAAY,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AAM7F,YAAY,EACV,IAAI,EACJ,gBAAgB,IAAI,oBAAoB,EACxC,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAM7B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAExE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,EACvB,oBAAoB,EACpB,eAAe,EACf,qBAAqB,GACtB,MAAM,yCAAyC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAMH,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAMlE,OAAO,EACL,4BAA4B,EAC5B,sBAAsB,GACvB,MAAM,+BAA+B,CAAC;AAMvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAC7E,OAAO,EACL,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,4CAA4C,CAAC;AACpD;;;;GAIG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,6CAA6C,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAE,gBAAgB,IAAI,yBAAyB,EAAE,MAAM,2CAA2C,CAAC;AAC1G,OAAO,EAAE,sBAAsB,EAAE,MAAM,iDAAiD,CAAC;AACzF,OAAO,EAAE,oBAAoB,EAAE,MAAM,+CAA+C,CAAC;AAMrF,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,YAAY,EACV,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AAClF,YAAY,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AAM7F,YAAY,EACV,IAAI,EACJ,gBAAgB,IAAI,oBAAoB,EACxC,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAM7B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAExE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,EACvB,oBAAoB,EACpB,eAAe,EACf,qBAAqB,GACtB,MAAM,yCAAyC,CAAC"}

package/lib/typescript/preset.d.ts

@@ -7,6 +7,14 @@
 import React from "react";
 import { ImpersonateBanner } from "./impersonate/components/ImpersonateBanner";
 import type { ImpersonateToolConfig } from "./impersonate/types";
+interface IconProps {
+    size: number;
+    color?: string;
+}
+/**
+ * Impersonate tool icon - a mask/person symbol
+ */
+export declare function ImpersonateIcon({ size, color }: IconProps): React.JSX.Element;
 /**
  * Create an impersonate tool with custom configuration
  *
@@ -70,4 +78,5 @@ export declare function createImpersonateTool(config: ImpersonateToolConfig): {
     };
     Banner: typeof ImpersonateBanner;
 };
+export {};
 //# sourceMappingURL=preset.d.ts.map

package/lib/typescript/preset.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"preset.d.ts","sourceRoot":"","sources":["../../src/preset.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAG/E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AA+GjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB;;;;;qBA6B9C;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;uBAGd;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,IAAI,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;QAAC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;KAAE;;;;;EAmB3H"}
+{"version":3,"file":"preset.d.ts","sourceRoot":"","sources":["../../src/preset.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAI/E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAyEjE,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAAE,IAAI,EAAE,KAAiB,EAAE,EAAE,SAAS,qBAmBrE;AAWD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB;;;;;qBAkC9C;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;uBAGd;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,IAAI,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;QAAC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;KAAE;;;;;EAmB3H"}

package/lib/typescript/sync/impersonateSyncAdapter.d.ts

@@ -0,0 +1,59 @@
+import type { User, ImpersonationState } from "../impersonate/types";
+type SearchUsersHandler = (query: string) => Promise<User[]>;
+/** @internal Called by createImpersonateTool with the app's onSearchUsers. */
+export declare function registerImpersonateSearchUsers(handler: SearchUsersHandler | null): void;
+interface CreateImpersonateSyncAdapterOptions {
+    /**
+     * Same user-search callback you pass to the ImpersonateModal — the
+     * dashboard's search box proxies here.
+     */
+    onSearchUsers: SearchUsersHandler;
+}
+/**
+ * Create a sync adapter for the impersonate tool, consumed by
+ * @buoy-gg/external-sync's `useExternalSync` (structurally matches its
+ * ToolSyncAdapter interface so this package doesn't need a dependency on it).
+ *
+ * The dashboard mirrors the impersonation state and forwards every mutation
+ * back as an action — header patching, data nuking and persistence all run
+ * on the device, so impersonating from the desktop behaves exactly like
+ * tapping the modal on the phone.
+ */
+export declare function createImpersonateSyncAdapter({ onSearchUsers, }: CreateImpersonateSyncAdapterOptions): {
+    version: number;
+    getSnapshot: () => ImpersonationState;
+    subscribe: (onChange: () => void) => () => void;
+    actions: {
+        searchUsers: (params: unknown) => Promise<User[]>;
+        startImpersonation: (params: unknown) => Promise<void>;
+        stopImpersonation: () => Promise<void>;
+        pauseImpersonation: () => Promise<void>;
+        resumeImpersonation: () => Promise<void>;
+        updateSettings: (params: unknown) => Promise<void>;
+        removeFromHistory: (params: unknown) => Promise<void>;
+        clearHistory: () => Promise<void>;
+    };
+};
+/**
+ * Zero-config variant used by FloatingDevTools' auto external sync. User
+ * search proxies to the onSearchUsers the app passed to
+ * createImpersonateTool; if the tool was never configured, the search action
+ * reports a descriptive error to the dashboard.
+ */
+export declare const impersonateSyncAdapter: {
+    version: number;
+    getSnapshot: () => ImpersonationState;
+    subscribe: (onChange: () => void) => () => void;
+    actions: {
+        searchUsers: (params: unknown) => Promise<User[]>;
+        startImpersonation: (params: unknown) => Promise<void>;
+        stopImpersonation: () => Promise<void>;
+        pauseImpersonation: () => Promise<void>;
+        resumeImpersonation: () => Promise<void>;
+        updateSettings: (params: unknown) => Promise<void>;
+        removeFromHistory: (params: unknown) => Promise<void>;
+        clearHistory: () => Promise<void>;
+    };
+};
+export {};
+//# sourceMappingURL=impersonateSyncAdapter.d.ts.map

package/lib/typescript/sync/impersonateSyncAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"impersonateSyncAdapter.d.ts","sourceRoot":"","sources":["../../../src/sync/impersonateSyncAdapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAErE,KAAK,kBAAkB,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;AAO7D,8EAA8E;AAC9E,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,kBAAkB,GAAG,IAAI,GACjC,IAAI,CAEN;AAyBD,UAAU,mCAAmC;IAC3C;;;OAGG;IACH,aAAa,EAAE,kBAAkB,CAAC;CACnC;AAED;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAAC,EAC3C,aAAa,GACd,EAAE,mCAAmC;;uBAGjB,kBAAkB;0BACb,MAAM,IAAI;;8BA7CV,OAAO;qCAEA,OAAO;;;;iCAKX,OAAO;oCAQJ,OAAO;;;EAiCtC;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB;;uBAEhB,kBAAkB;0BACb,MAAM,IAAI;;8BA3DR,OAAO;qCAEA,OAAO;;;;iCAKX,OAAO;oCAQJ,OAAO;;;CAqDtC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buoy-gg/impersonate",
-  "version": "3.0.1",
+  "version": "4.0.1",
   "description": "User impersonation tool for Buoy DevTools - inject custom headers for admin testing",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
@@ -26,7 +26,7 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@buoy-gg/shared-ui": "3.0.1"
+    "@buoy-gg/shared-ui": "4.0.1"
   },
   "peerDependencies": {
     "react": "*",