@buoy-gg/impersonate 1.0.3-beta.0

package/lib/typescript/impersonate/hooks/useAutoClearRedux.d.ts

@@ -0,0 +1,78 @@
+/**
+ * useAutoClearRedux Hook
+ *
+ * Auto-detects Redux store and provides a reset function.
+ * Uses the same pattern as @buoy-gg/redux's useAutoInstrumentRedux.
+ *
+ * This hook:
+ * 1. Dynamically requires react-redux
+ * 2. Uses useStore() to get the store from context
+ * 3. Returns a resetStore function that dispatches a reset action
+ *
+ * IMPORTANT: Unlike React Query which has a universal .clear() method,
+ * Redux reset requires the app's reducer to handle the reset action.
+ * The default action type is '@@RESET' but can be customized.
+ *
+ * Example reducer handling:
+ * ```typescript
+ * const rootReducer = (state, action) => {
+ *   if (action.type === '@@RESET') {
+ *     return undefined; // Returns to initial state
+ *   }
+ *   return appReducer(state, action);
+ * };
+ * ```
+ */
+/** The default action type dispatched to reset Redux state */
+export declare const REDUX_RESET_ACTION_TYPE = "@@RESET";
+export interface UseAutoClearReduxOptions {
+    /** Custom action type to dispatch for reset (default: '@@RESET') */
+    resetActionType?: string;
+}
+export interface UseAutoClearReduxResult {
+    /** Whether Redux is available and connected */
+    isAvailable: boolean;
+    /** Error message if not available */
+    error: string | null;
+    /** Function to dispatch reset action to Redux store */
+    resetStore: (() => void) | null;
+}
+/**
+ * Hook to auto-detect Redux store and provide state reset functionality.
+ *
+ * This dispatches a reset action (default: '@@RESET') to the store.
+ * Your app's root reducer must handle this action to actually reset state.
+ *
+ * @example
+ * ```tsx
+ * // In your component:
+ * function MyComponent() {
+ *   const { isAvailable, resetStore } = useAutoClearRedux();
+ *
+ *   if (isAvailable && resetStore) {
+ *     resetStore(); // Dispatches { type: '@@RESET' }
+ *   }
+ * }
+ *
+ * // In your root reducer:
+ * const rootReducer = (state, action) => {
+ *   if (action.type === '@@RESET') {
+ *     // Return undefined to reset to initial state
+ *     // Or return a specific "logged out" state
+ *     return undefined;
+ *   }
+ *   return appReducer(state, action);
+ * };
+ * ```
+ */
+export declare function useAutoClearRedux(options?: UseAutoClearReduxOptions): UseAutoClearReduxResult;
+/**
+ * Lightweight hook to just check if Redux is available
+ * without getting the store
+ */
+export declare function useReduxAvailability(): {
+    isInstalled: boolean;
+    isConnected: boolean;
+    error: string | null;
+};
+//# sourceMappingURL=useAutoClearRedux.d.ts.map

package/lib/typescript/impersonate/hooks/useAutoClearRedux.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAutoClearRedux.d.ts","sourceRoot":"","sources":["../../../../src/impersonate/hooks/useAutoClearRedux.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAgBH,8DAA8D;AAC9D,eAAO,MAAM,uBAAuB,YAAY,CAAC;AAEjD,MAAM,WAAW,wBAAwB;IACvC,oEAAoE;IACpE,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,uBAAuB;IACtC,+CAA+C;IAC/C,WAAW,EAAE,OAAO,CAAC;IACrB,qCAAqC;IACrC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,uDAAuD;IACvD,UAAU,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC;CACjC;AAyBD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,GAAE,wBAA6B,GACrC,uBAAuB,CAiEzB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI;IACtC,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,CA6BA"}

package/lib/typescript/impersonate/hooks/useImpersonate.d.ts

@@ -0,0 +1,76 @@
+/**
+ * useImpersonate Hook
+ *
+ * Main hook for managing impersonation state and actions.
+ * Provides all the controls needed to search users, start/stop
+ * impersonation, and manage settings.
+ */
+import type { User, HistoryEntry, DataNukeSettings } from "../types";
+export interface UseImpersonateOptions {
+    /** Callback to search users - provided by host app */
+    onSearchUsers?: (query: string) => Promise<User[]>;
+    /** Callback to clear React Query cache */
+    onClearReactQuery?: () => void | Promise<void>;
+    /** Callback to clear/reset Redux state */
+    onClearRedux?: () => void | Promise<void>;
+    /** Callback to clear AsyncStorage */
+    onClearAsyncStorage?: () => void | Promise<void>;
+    /** Callback to clear MMKV */
+    onClearMMKV?: () => void | Promise<void>;
+}
+export interface UseImpersonateReturn {
+    isActive: boolean;
+    currentUser: User | null;
+    headerKey: string;
+    ignorePatterns: string[];
+    dataNukeSettings: DataNukeSettings;
+    showBanner: boolean;
+    history: HistoryEntry[];
+    searchQuery: string;
+    searchResults: User[];
+    isSearching: boolean;
+    searchError: string | null;
+    searchUsers: (query: string) => Promise<void>;
+    clearSearch: () => void;
+    startImpersonation: (user: User) => Promise<void>;
+    stopImpersonation: () => Promise<void>;
+    quickSwitch: (user: User) => Promise<void>;
+    updateHeaderKey: (key: string) => Promise<void>;
+    updateIgnorePatterns: (patterns: string[]) => Promise<void>;
+    updateDataNukeSettings: (settings: Partial<DataNukeSettings>) => Promise<void>;
+    updateShowBanner: (show: boolean) => Promise<void>;
+    removeFromHistory: (userId: string) => Promise<void>;
+    clearHistory: () => Promise<void>;
+}
+/**
+ * Hook for managing impersonation
+ *
+ * @example
+ * ```tsx
+ * function ImpersonatePanel() {
+ *   const {
+ *     isActive,
+ *     currentUser,
+ *     searchUsers,
+ *     searchResults,
+ *     startImpersonation,
+ *     stopImpersonation,
+ *   } = useImpersonate({
+ *     onSearchUsers: async (query) => api.searchUsers(query),
+ *     onClearReactQuery: () => queryClient.clear(),
+ *   });
+ *
+ *   return (
+ *     <View>
+ *       {isActive ? (
+ *         <Text>Impersonating: {currentUser?.email}</Text>
+ *       ) : (
+ *         <Text>Not impersonating</Text>
+ *       )}
+ *     </View>
+ *   );
+ * }
+ * ```
+ */
+export declare function useImpersonate(options?: UseImpersonateOptions): UseImpersonateReturn;
+//# sourceMappingURL=useImpersonate.d.ts.map

package/lib/typescript/impersonate/hooks/useImpersonate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useImpersonate.d.ts","sourceRoot":"","sources":["../../../../src/impersonate/hooks/useImpersonate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAIrE,MAAM,WAAW,qBAAqB;IACpC,sDAAsD;IACtD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACnD,0CAA0C;IAC1C,iBAAiB,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,qCAAqC;IACrC,mBAAmB,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,oBAAoB;IAEnC,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,YAAY,EAAE,CAAC;IAGxB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,IAAI,EAAE,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,WAAW,EAAE,MAAM,IAAI,CAAC;IAGxB,kBAAkB,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,iBAAiB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,WAAW,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAG3C,eAAe,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,oBAAoB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,sBAAsB,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,gBAAgB,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/E,gBAAgB,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAGnD,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,cAAc,CAC5B,OAAO,GAAE,qBAA0B,GAClC,oBAAoB,CA+LtB"}

package/lib/typescript/impersonate/hooks/useImpersonateHistory.d.ts

@@ -0,0 +1,43 @@
+/**
+ * useImpersonateHistory Hook
+ *
+ * Specialized hook for working with impersonation history.
+ * Use this when you only need history functionality.
+ */
+import type { User, HistoryEntry } from "../types";
+export interface UseImpersonateHistoryReturn {
+    /** List of recently impersonated users */
+    history: HistoryEntry[];
+    /** Currently impersonated user ID (null if not impersonating) */
+    currentUserId: string | null;
+    /** Quick switch to a user from history */
+    quickSwitch: (user: User) => Promise<void>;
+    /** Remove a user from history */
+    removeFromHistory: (userId: string) => Promise<void>;
+    /** Clear all history */
+    clearHistory: () => Promise<void>;
+}
+/**
+ * Hook for managing impersonation history
+ *
+ * @example
+ * ```tsx
+ * function HistoryList() {
+ *   const { history, currentUserId, quickSwitch } = useImpersonateHistory();
+ *
+ *   return (
+ *     <FlatList
+ *       data={history}
+ *       renderItem={({ item }) => (
+ *         <TouchableOpacity onPress={() => quickSwitch(item)}>
+ *           <Text>{item.email}</Text>
+ *           {currentUserId === item.id && <Badge>Active</Badge>}
+ *         </TouchableOpacity>
+ *       )}
+ *     />
+ *   );
+ * }
+ * ```
+ */
+export declare function useImpersonateHistory(): UseImpersonateHistoryReturn;
+//# sourceMappingURL=useImpersonateHistory.d.ts.map

package/lib/typescript/impersonate/hooks/useImpersonateHistory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useImpersonateHistory.d.ts","sourceRoot":"","sources":["../../../../src/impersonate/hooks/useImpersonateHistory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAGnD,MAAM,WAAW,2BAA2B;IAC1C,0CAA0C;IAC1C,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,iEAAiE;IACjE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,0CAA0C;IAC1C,WAAW,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,iCAAiC;IACjC,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,wBAAwB;IACxB,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,qBAAqB,IAAI,2BAA2B,CA0BnE"}

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

@@ -0,0 +1,5 @@
+export * from "./types";
+export * from "./utils";
+export * from "./hooks";
+export * from "./components";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/impersonate/index.ts"],"names":[],"mappings":"AACA,cAAc,SAAS,CAAC;AAGxB,cAAc,SAAS,CAAC;AAGxB,cAAc,SAAS,CAAC;AAGxB,cAAc,cAAc,CAAC"}

package/lib/typescript/impersonate/types/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./types";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/impersonate/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC"}

package/lib/typescript/impersonate/types/types.d.ts

@@ -0,0 +1,177 @@
+/**
+ * Type definitions for @buoy-gg/impersonate
+ */
+/**
+ * Represents a user that can be impersonated
+ */
+export interface User {
+    /** Unique user identifier - this value is sent in the impersonation header */
+    id: string;
+    /** Display name for UI (falls back to email, then id) */
+    displayName?: string;
+    /** User's email address */
+    email?: string;
+    /** URL to user's avatar image */
+    avatarUrl?: string;
+    /** Additional metadata to display in UserCard (key-value pairs) */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * A history entry with timestamp
+ */
+export interface HistoryEntry {
+    /** The user that was impersonated */
+    user: User;
+    /** When the impersonation started (ISO string) */
+    lastUsedAt: string;
+}
+/**
+ * Settings for which data stores to clear on impersonation change
+ */
+export interface DataNukeSettings {
+    /** Clear React Query cache (queries + mutations) */
+    reactQuery: boolean;
+    /** Reset Redux state */
+    redux: boolean;
+    /** Clear AsyncStorage (app data only, preserves @buoy/* keys) */
+    asyncStorage: boolean;
+    /** Clear MMKV storage (app data only, preserves @buoy/* keys) */
+    mmkv: boolean;
+}
+/**
+ * Internal impersonation state managed by the store
+ */
+export interface ImpersonationState {
+    /** Whether impersonation is currently active */
+    isActive: boolean;
+    /** Whether impersonation is paused (headers not injected) */
+    isPaused: boolean;
+    /** The currently impersonated user (null if not impersonating) */
+    currentUser: User | null;
+    /** HTTP header key to use for impersonation */
+    headerKey: string;
+    /** URL patterns to exclude from header injection (as regex strings) */
+    ignorePatterns: string[];
+    /** Settings for data clearing on impersonation change */
+    dataNukeSettings: DataNukeSettings;
+    /** Whether to show floating banner when impersonating */
+    showBanner: boolean;
+    /** History of recently impersonated users (max 10) */
+    history: HistoryEntry[];
+}
+/**
+ * Configuration for the impersonate listener
+ */
+export interface ImpersonateListenerConfig {
+    /** Header key to inject (default: 'x-impersonate-user-id') */
+    headerKey: string;
+    /** Current impersonated user ID (null = not impersonating) */
+    userId: string | null;
+    /** URL patterns to ignore (won't inject header) */
+    ignorePatterns: RegExp[];
+}
+/**
+ * Developer-configurable defaults for the impersonate tool
+ */
+export interface ImpersonateDefaults {
+    /** Default header key (default: 'x-impersonate-user-id') */
+    headerKey?: string;
+    /** Default data nuke settings */
+    dataNukeSettings?: Partial<DataNukeSettings>;
+    /** Show floating banner when impersonating (default: true) */
+    showBanner?: boolean;
+}
+/**
+ * Configuration for creating the impersonate tool
+ */
+export interface ImpersonateToolConfig {
+    /** Tool ID (default: 'impersonate') */
+    id?: string;
+    /** Tool name displayed in DevTools (default: 'IMPERSONATE') */
+    name?: string;
+    /** Tool description shown in settings */
+    description?: string;
+    /**
+     * Developer-configurable defaults
+     * These override hardcoded defaults but are overridden by persisted user settings
+     */
+    defaults?: ImpersonateDefaults;
+    /**
+     * Show the settings tab in the modal (default: true)
+     * Set to false to hide settings when using for simple testing
+     */
+    showSettingsTab?: boolean;
+    /**
+     * Search users callback - REQUIRED for user search to work
+     * Return an array of User objects matching the query
+     *
+     * @example
+     * ```typescript
+     * onSearchUsers: async (query) => {
+     *   const res = await api.get(`/admin/users?email=${query}`);
+     *   return res.users.map(u => ({
+     *     id: u.id,
+     *     displayName: u.name,
+     *     email: u.email,
+     *     metadata: { role: u.role }
+     *   }));
+     * }
+     * ```
+     */
+    onSearchUsers: (query: string) => Promise<User[]>;
+    /**
+     * Clear React Query cache
+     * @example `() => queryClient.clear()`
+     */
+    onClearReactQuery?: () => void | Promise<void>;
+    /**
+     * Reset Redux state
+     * @example `() => store.dispatch({ type: 'RESET' })`
+     */
+    onClearRedux?: () => void | Promise<void>;
+    /**
+     * Clear AsyncStorage (app data only)
+     * The callback should filter out @buoy/* keys
+     */
+    onClearAsyncStorage?: () => void | Promise<void>;
+    /**
+     * Clear MMKV storage (app data only)
+     * The callback should filter out @buoy/* keys
+     */
+    onClearMMKV?: () => void | Promise<void>;
+}
+/**
+ * Props passed to the ImpersonateModal component
+ */
+export interface ImpersonateModalProps {
+    /** Controls the visibility of the modal */
+    visible: boolean;
+    /** Callback executed when the modal is dismissed */
+    onClose: () => void;
+    /** Optional handler fired when navigating back */
+    onBack?: () => void;
+    /** Optional handler fired when the modal is minimized */
+    onMinimize?: (modalState: unknown) => void;
+    /** Search users callback */
+    onSearchUsers?: (query: string) => Promise<User[]>;
+    /** Clear React Query callback */
+    onClearReactQuery?: () => void | Promise<void>;
+    /** Clear Redux callback */
+    onClearRedux?: () => void | Promise<void>;
+    /** Clear AsyncStorage callback */
+    onClearAsyncStorage?: () => void | Promise<void>;
+    /** Clear MMKV callback */
+    onClearMMKV?: () => void | Promise<void>;
+    /** Show the settings tab (default: true) */
+    showSettingsTab?: boolean;
+}
+/**
+ * Props for the ImpersonateBanner component
+ */
+export interface ImpersonateBannerProps {
+    /** Called when the banner is tapped (typically opens modal) */
+    onPress?: () => void;
+    /** Called when impersonation is stopped via banner */
+    onStopPress?: () => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/impersonate/types/types.d.ts.map

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

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

@@ -0,0 +1,115 @@
+/**
+ * Impersonate Listener - Header Injection via Fetch/XHR Monkey-Patching
+ *
+ * This module intercepts all network requests and injects the impersonation
+ * header when impersonation is active. It follows the same singleton pattern
+ * as @buoy-gg/network's networkListener.
+ */
+import type { ImpersonateListenerConfig } from "../types";
+/**
+ * Impersonation header injector for network requests
+ *
+ * This class monkey-patches fetch and XMLHttpRequest to inject the
+ * impersonation header on all outgoing requests when impersonation is active.
+ *
+ * @example
+ * ```typescript
+ * // Get the singleton instance
+ * const listener = impersonateListener();
+ *
+ * // Configure impersonation
+ * listener.setConfig({
+ *   headerKey: 'x-impersonate-user-id',
+ *   userId: '12345',
+ *   ignorePatterns: [/\/health/]
+ * });
+ *
+ * // Start injecting headers
+ * listener.startListening();
+ *
+ * // All fetch/XHR requests will now include the header
+ *
+ * // Stop injecting when done
+ * listener.stopListening();
+ * ```
+ */
+declare class ImpersonateListener {
+    private config;
+    private isListeningFlag;
+    private originalFetch;
+    private originalXHROpen;
+    private originalXHRSend;
+    constructor();
+    /**
+     * Update impersonation config without restarting listener
+     *
+     * This is the primary way to activate/deactivate impersonation.
+     * Set userId to null to stop injecting headers.
+     */
+    setConfig(partial: Partial<ImpersonateListenerConfig>): void;
+    /**
+     * Get current configuration
+     */
+    getConfig(): ImpersonateListenerConfig;
+    /**
+     * Check if URL should have header injected
+     *
+     * Returns false if:
+     * - No userId is set (not impersonating)
+     * - URL matches any ignore pattern
+     */
+    private shouldInjectHeader;
+    /**
+     * Extract URL from various input types
+     */
+    private extractUrl;
+    /**
+     * Start intercepting and injecting headers
+     *
+     * This patches globalThis.fetch and XMLHttpRequest.prototype methods
+     * to inject the impersonation header on all requests.
+     */
+    startListening(): void;
+    /**
+     * Stop intercepting - restore original methods
+     *
+     * Note: This restores fetch/XHR to their state when ImpersonateListener
+     * was constructed. If other interceptors were installed after, this may
+     * break their functionality.
+     */
+    stopListening(): void;
+    /**
+     * Check if listener is currently active
+     */
+    get isListening(): boolean;
+    /**
+     * Check if impersonation is currently active (has userId set)
+     */
+    get isImpersonating(): boolean;
+}
+/**
+ * Get the singleton ImpersonateListener instance
+ */
+export declare function impersonateListener(): ImpersonateListener;
+/**
+ * Convenience function to start the listener
+ */
+export declare function startImpersonateListener(): void;
+/**
+ * Convenience function to stop the listener
+ */
+export declare function stopImpersonateListener(): void;
+/**
+ * Convenience function to update config
+ */
+export declare function setImpersonateConfig(config: Partial<ImpersonateListenerConfig>): void;
+/**
+ * Convenience function to check if impersonating
+ */
+export declare function isImpersonating(): boolean;
+/**
+ * Convenience function to get impersonated user ID
+ */
+export declare function getImpersonatedUserId(): string | null;
+export {};
+//# sourceMappingURL=impersonateListener.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"impersonateListener.d.ts","sourceRoot":"","sources":["../../../../src/impersonate/utils/impersonateListener.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAwB1D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,cAAM,mBAAmB;IACvB,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,eAAe,CAAS;IAGhC,OAAO,CAAC,aAAa,CAAe;IACpC,OAAO,CAAC,eAAe,CAAuC;IAC9D,OAAO,CAAC,eAAe,CAAuC;;IAe9D;;;;;OAKG;IACH,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,yBAAyB,CAAC,GAAG,IAAI;IAY5D;;OAEG;IACH,SAAS,IAAI,yBAAyB;IAItC;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB;IAU1B;;OAEG;IACH,OAAO,CAAC,UAAU;IAWlB;;;;;OAKG;IACH,cAAc,IAAI,IAAI;IAkFtB;;;;;;OAMG;IACH,aAAa,IAAI,IAAI;IAYrB;;OAEG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;OAEG;IACH,IAAI,eAAe,IAAI,OAAO,CAE7B;CACF;AAQD;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,mBAAmB,CAKzD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,OAAO,CAAC,yBAAyB,CAAC,GACzC,IAAI,CAEN;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,IAAI,CAErD"}