@oxyhq/services 30.0.0 → 30.0.1

package/lib/commonjs/ui/hooks/queryClient.js

@@ -0,0 +1,208 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createQueryClient = exports.clearQueryCache = exports.attachQueryPersistence = void 0;
+var _reactQuery = require("@tanstack/react-query");
+var _reactQueryPersistClient = require("@tanstack/react-query-persist-client");
+var _queryAsyncStoragePersister = require("@tanstack/query-async-storage-persister");
+var _core = require("@oxyhq/core");
+/**
+ * Offline-first QueryClient with cross-restart persistence.
+ *
+ * Wires together:
+ * - TanStack Query with `networkMode: 'offlineFirst'` for queries and mutations
+ *   so cached data is served immediately and mutations are queued (paused) while
+ *   the browser/device reports offline.
+ * - `persistQueryClient(...)` from `@tanstack/react-query-persist-client` so that
+ *   query results AND paused mutations survive a cold restart (kill-and-relaunch).
+ * - `onlineManager` resume hook so paused mutations replay the moment the
+ *   network is reported back, even if the host app swapped in a custom
+ *   onlineManager implementation.
+ *
+ * Storage layer:
+ * - React Native -> AsyncStorage via `createAsyncStoragePersister`.
+ * - Web -> localStorage via `createSyncStoragePersister` (wrapped in the
+ *   async persister API for a single call site).
+ * - Both adapters are content-shape compatible with our `StorageInterface`.
+ *
+ * Whitelist policy:
+ * - Persist every account/user/session/privacy query and every queued mutation.
+ * - DO NOT persist large list queries (e.g. activity feeds) — they go stale
+ *   fast and would balloon storage. Add new keys to `PERSISTED_QUERY_PREFIXES`
+ *   when introducing reads that should survive restart.
+ */
+
+const QUERY_CACHE_KEY = 'oxy_query_cache_v3';
+const QUERY_CACHE_MAX_AGE = 30 * 24 * 60 * 60 * 1000; // 30 days
+const QUERY_PERSIST_THROTTLE_MS = 1_000;
+
+/**
+ * Query-key prefixes that should survive cold restart. Anything not listed
+ * is dropped during dehydration so the persisted blob stays small.
+ *
+ * Mutations are persisted independently (always) so the offline write queue
+ * works regardless of the read whitelist.
+ */
+const PERSISTED_QUERY_PREFIXES = ['accounts', 'users', 'sessions', 'devices', 'privacy'];
+
+/**
+ * Adapt our `StorageInterface` (which always returns `null` for missing keys)
+ * to TanStack's `AsyncStorage` shape. The two are structurally identical
+ * apart from naming; this also gives us a single place to add error
+ * suppression if a host platform's storage throws.
+ */
+function adaptStorage(storage) {
+  return {
+    getItem: key => storage.getItem(key),
+    setItem: (key, value) => storage.setItem(key, value),
+    removeItem: key => storage.removeItem(key)
+  };
+}
+
+/**
+ * Decide whether a given query should be written to persistent storage.
+ *
+ * Two gates:
+ * 1. The query must be in our prefix whitelist.
+ * 2. The query must have completed successfully at least once — there's no
+ *    point persisting a `pending`/`error` state, and persisting `error` would
+ *    leak failure objects across restarts.
+ */
+function shouldDehydrateQuery(query) {
+  if (query.state.status !== 'success') {
+    return false;
+  }
+  const head = query.queryKey[0];
+  if (typeof head !== 'string') {
+    return false;
+  }
+  return PERSISTED_QUERY_PREFIXES.includes(head);
+}
+
+/**
+ * Persist every mutation regardless of status — paused mutations are
+ * exactly the ones that must survive restart to replay when online.
+ */
+function shouldDehydrateMutation(_mutation) {
+  return true;
+}
+
+/**
+ * Create a QueryClient with offline-first defaults.
+ *
+ * Mutations marked with `networkMode: 'offlineFirst'` are queued by TanStack
+ * Query when offline (status "paused") and resumed automatically when
+ * `onlineManager` transitions back to online. Network monitoring wiring lives
+ * in `OxyProvider.tsx`.
+ *
+ * Persistence is attached separately via `attachQueryPersistence(...)`.
+ * Splitting the steps lets test/SSR callers create a stateless client.
+ */
+const createQueryClient = () => {
+  const client = new _reactQuery.QueryClient({
+    defaultOptions: {
+      queries: {
+        // Data is fresh for 5 minutes
+        staleTime: 5 * 60 * 1000,
+        // Keep unused data in cache for 30 minutes
+        gcTime: 30 * 60 * 1000,
+        // Retry 3 times with exponential backoff
+        retry: 3,
+        retryDelay: attemptIndex => Math.min(1000 * 2 ** attemptIndex, 30000),
+        // Refetch on reconnect so stale data is refreshed once online again.
+        refetchOnReconnect: true,
+        // Don't refetch on window focus (better for mobile)
+        refetchOnWindowFocus: false,
+        // Offline-first: serve cached data immediately, refetch in background.
+        networkMode: 'offlineFirst'
+      },
+      mutations: {
+        // Retry once for mutations
+        retry: 1,
+        // Offline-first: pause and queue mutations when offline.
+        networkMode: 'offlineFirst'
+      }
+    }
+  });
+
+  // Defensive: explicitly resume paused mutations whenever the network
+  // transitions back to online. TanStack Query does this internally too,
+  // but wiring it here keeps the behaviour robust if a custom onlineManager
+  // implementation is swapped in by the host app.
+  const unsubscribe = _reactQuery.onlineManager.subscribe(isOnline => {
+    if (isOnline) {
+      void client.getMutationCache().resumePausedMutations();
+    }
+  });
+  Object.defineProperty(client, '__oxyOnlineUnsubscribe', {
+    value: unsubscribe,
+    enumerable: false,
+    configurable: true,
+    writable: false
+  });
+  return client;
+};
+exports.createQueryClient = createQueryClient;
+/**
+ * Wire `persistQueryClient` to the supplied storage adapter.
+ *
+ * Returns once the in-flight restore promise is available so callers can
+ * `await result.restored` before rendering UI that depends on cached data.
+ *
+ * Safe to no-op if `storage` is null/undefined (e.g. server-side render
+ * with no host storage).
+ */
+const attachQueryPersistence = (queryClient, storage) => {
+  if (!storage) {
+    return {
+      restored: Promise.resolve(),
+      unsubscribe: () => {}
+    };
+  }
+  const persister = (0, _queryAsyncStoragePersister.createAsyncStoragePersister)({
+    storage: adaptStorage(storage),
+    key: QUERY_CACHE_KEY,
+    throttleTime: QUERY_PERSIST_THROTTLE_MS
+  });
+  const [unsubscribe, restored] = (0, _reactQueryPersistClient.persistQueryClient)({
+    queryClient,
+    persister,
+    maxAge: QUERY_CACHE_MAX_AGE,
+    dehydrateOptions: {
+      shouldDehydrateQuery,
+      shouldDehydrateMutation
+    }
+  });
+  restored.catch(error => {
+    if ((0, _core.isDev)()) {
+      console.warn('[QueryClient] Failed to restore persisted cache', error);
+    }
+  });
+  return {
+    unsubscribe,
+    restored
+  };
+};
+
+/**
+ * Remove the persisted query+mutation cache (used on full sign-out / data reset).
+ * Safe to call even if persistence was never attached.
+ */
+exports.attachQueryPersistence = attachQueryPersistence;
+const clearQueryCache = async storage => {
+  try {
+    await storage.removeItem(QUERY_CACHE_KEY);
+  } catch (error) {
+    if ((0, _core.isDev)()) {
+      console.warn('[QueryClient] Failed to clear persisted query cache', error);
+    }
+  }
+};
+
+/**
+ * Re-export the persisted client shape so callers can type custom persisters.
+ */
+exports.clearQueryCache = clearQueryCache;
+//# sourceMappingURL=queryClient.js.map

package/lib/commonjs/ui/hooks/queryClient.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_reactQuery","require","_reactQueryPersistClient","_queryAsyncStoragePersister","_core","QUERY_CACHE_KEY","QUERY_CACHE_MAX_AGE","QUERY_PERSIST_THROTTLE_MS","PERSISTED_QUERY_PREFIXES","adaptStorage","storage","getItem","key","setItem","value","removeItem","shouldDehydrateQuery","query","state","status","head","queryKey","includes","shouldDehydrateMutation","_mutation","createQueryClient","client","QueryClient","defaultOptions","queries","staleTime","gcTime","retry","retryDelay","attemptIndex","Math","min","refetchOnReconnect","refetchOnWindowFocus","networkMode","mutations","unsubscribe","onlineManager","subscribe","isOnline","getMutationCache","resumePausedMutations","Object","defineProperty","enumerable","configurable","writable","exports","attachQueryPersistence","queryClient","restored","Promise","resolve","persister","createAsyncStoragePersister","throttleTime","persistQueryClient","maxAge","dehydrateOptions","catch","error","isDev","console","warn","clearQueryCache"],"sourceRoot":"../../../../src","sources":["ui/hooks/queryClient.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/ui/hooks/useAssets.js

@@ -0,0 +1,227 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useAssets = exports.setOxyAssetInstance = void 0;
+var _react = require("react");
+var _assetStore = require("../stores/assetStore.js");
+// Create a singleton instance for the hook
+let oxyInstance = null;
+const setOxyAssetInstance = instance => {
+  oxyInstance = instance;
+};
+
+/**
+ * Hook for managing assets with Zustand store integration
+ */
+exports.setOxyAssetInstance = setOxyAssetInstance;
+const useAssets = () => {
+  const {
+    assets,
+    uploadProgress,
+    loading,
+    errors,
+    setAsset,
+    setAssets,
+    removeAsset,
+    setUploadProgress,
+    removeUploadProgress,
+    addLink,
+    removeLink,
+    setUploading,
+    setLinking,
+    setDeleting,
+    setUploadError,
+    setLinkError,
+    setDeleteError,
+    clearErrors,
+    getAssetsByApp,
+    getAssetsByEntity,
+    getAssetUsageCount,
+    isAssetLinked,
+    reset
+  } = (0, _assetStore.useAssetStore)();
+
+  // Upload asset with progress tracking
+  const upload = (0, _react.useCallback)(async (file, metadata) => {
+    if (!oxyInstance) {
+      throw new Error('OxyServices instance not configured. Call setOxyAssetInstance first.');
+    }
+    try {
+      clearErrors();
+      setUploading(true);
+      const result = await oxyInstance.assetUpload(file, undefined, metadata);
+
+      // Update progress with final status
+      if (result?.file) {
+        const fileId = result.file.id;
+        setUploadProgress(fileId, {
+          fileId,
+          uploaded: file.size,
+          total: file.size,
+          percentage: 100,
+          status: 'complete'
+        });
+
+        // Remove progress after a short delay
+        setTimeout(() => {
+          removeUploadProgress(fileId);
+        }, 2000);
+      }
+
+      // Add asset to store
+      if (result.file) {
+        setAsset(result.file);
+        return result.file;
+      }
+      return null;
+    } catch (error) {
+      setUploadError((error instanceof Error ? error.message : null) || 'Upload failed');
+      throw error;
+    } finally {
+      setUploading(false);
+    }
+  }, [clearErrors, setUploading, setUploadProgress, removeUploadProgress, setAsset, setUploadError]);
+
+  // Link asset to entity
+  const link = (0, _react.useCallback)(async (assetId, app, entityType, entityId) => {
+    if (!oxyInstance) {
+      throw new Error('OxyServices instance not configured. Call setOxyAssetInstance first.');
+    }
+    try {
+      clearErrors();
+      setLinking(true);
+
+      // Auto-detect visibility for avatars and profile banners
+      const visibility = entityType === 'avatar' || entityType === 'profile-banner' ? 'public' : undefined;
+      const result = await oxyInstance.assetLink(assetId, app, entityType, entityId, visibility);
+      if (result.file) {
+        setAsset(result.file);
+      } else {
+        // If API doesn't return full file, update store optimistically
+        addLink(assetId, {
+          app,
+          entityType,
+          entityId,
+          createdBy: '',
+          // Will be filled by server
+          createdAt: new Date().toISOString()
+        });
+      }
+    } catch (error) {
+      setLinkError((error instanceof Error ? error.message : null) || 'Link failed');
+      throw error;
+    } finally {
+      setLinking(false);
+    }
+  }, [clearErrors, setLinking, setAsset, addLink, setLinkError]);
+
+  // Unlink asset from entity
+  const unlink = (0, _react.useCallback)(async (assetId, app, entityType, entityId) => {
+    if (!oxyInstance) {
+      throw new Error('OxyServices instance not configured. Call setOxyAssetInstance first.');
+    }
+    try {
+      clearErrors();
+      setLinking(true);
+      const result = await oxyInstance.assetUnlink(assetId, app, entityType, entityId);
+      if (result.file) {
+        setAsset(result.file);
+      } else {
+        // Update store optimistically
+        removeLink(assetId, app, entityType, entityId);
+      }
+    } catch (error) {
+      setLinkError((error instanceof Error ? error.message : null) || 'Unlink failed');
+      throw error;
+    } finally {
+      setLinking(false);
+    }
+  }, [clearErrors, setLinking, setAsset, removeLink, setLinkError]);
+
+  // Get asset URL
+  const getUrl = (0, _react.useCallback)(async (assetId, variant, expiresIn) => {
+    if (!oxyInstance) {
+      throw new Error('OxyServices instance not configured. Call setOxyAssetInstance first.');
+    }
+    const result = await oxyInstance.assetGetUrl(assetId, variant, expiresIn);
+    return result.url;
+  }, []);
+
+  // Get asset metadata
+  const getAsset = (0, _react.useCallback)(async assetId => {
+    if (!oxyInstance) {
+      throw new Error('OxyServices instance not configured. Call setOxyAssetInstance first.');
+    }
+    const result = await oxyInstance.assetGet(assetId);
+    if (result.file) {
+      setAsset(result.file);
+      return result.file;
+    }
+    throw new Error('Asset not found');
+  }, [setAsset]);
+
+  // Delete asset
+  const deleteAsset = (0, _react.useCallback)(async (assetId, force = false) => {
+    if (!oxyInstance) {
+      throw new Error('OxyServices instance not configured. Call setOxyAssetInstance first.');
+    }
+    try {
+      clearErrors();
+      setDeleting(true);
+      await oxyInstance.assetDelete(assetId, force);
+      removeAsset(assetId);
+    } catch (error) {
+      setDeleteError((error instanceof Error ? error.message : null) || 'Delete failed');
+      throw error;
+    } finally {
+      setDeleting(false);
+    }
+  }, [clearErrors, setDeleting, removeAsset, setDeleteError]);
+
+  // Restore asset from trash
+  const restore = (0, _react.useCallback)(async assetId => {
+    if (!oxyInstance) {
+      throw new Error('OxyServices instance not configured. Call setOxyAssetInstance first.');
+    }
+    const result = await oxyInstance.assetRestore(assetId);
+    if (result.file) {
+      setAsset(result.file);
+    }
+  }, [setAsset]);
+
+  // Get variants
+  const getVariants = (0, _react.useCallback)(async assetId => {
+    if (!oxyInstance) {
+      throw new Error('OxyServices instance not configured. Call setOxyAssetInstance first.');
+    }
+    return await oxyInstance.assetGetVariants(assetId);
+  }, []);
+  return {
+    // State
+    assets: Object.values(assets),
+    uploadProgress,
+    loading,
+    errors,
+    // Actions
+    upload,
+    link,
+    unlink,
+    getUrl,
+    getAsset,
+    deleteAsset,
+    restore,
+    getVariants,
+    // Utility methods
+    getAssetsByApp,
+    getAssetsByEntity,
+    getAssetUsageCount,
+    isAssetLinked,
+    // Store management
+    clearErrors,
+    reset
+  };
+};
+exports.useAssets = useAssets;
+//# sourceMappingURL=useAssets.js.map

package/lib/commonjs/ui/hooks/useAssets.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","require","_assetStore","oxyInstance","setOxyAssetInstance","instance","exports","useAssets","assets","uploadProgress","loading","errors","setAsset","setAssets","removeAsset","setUploadProgress","removeUploadProgress","addLink","removeLink","setUploading","setLinking","setDeleting","setUploadError","setLinkError","setDeleteError","clearErrors","getAssetsByApp","getAssetsByEntity","getAssetUsageCount","isAssetLinked","reset","useAssetStore","upload","useCallback","file","metadata","Error","result","assetUpload","undefined","fileId","id","uploaded","size","total","percentage","status","setTimeout","error","message","link","assetId","app","entityType","entityId","visibility","assetLink","createdBy","createdAt","Date","toISOString","unlink","assetUnlink","getUrl","variant","expiresIn","assetGetUrl","url","getAsset","assetGet","deleteAsset","force","assetDelete","restore","assetRestore","getVariants","assetGetVariants","Object","values"],"sourceRoot":"../../../../src","sources":["ui/hooks/useAssets.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/ui/hooks/useAsyncAction.js

@@ -0,0 +1,95 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+exports.executeWithToast = executeWithToast;
+exports.useAsyncAction = useAsyncAction;
+var _react = require("react");
+var _toast = require("@oxyhq/bloom/toast");
+/**
+ * Hook for handling async actions with loading state, error handling, and toast notifications.
+ * Reduces boilerplate for common patterns like try-catch with toast feedback.
+ *
+ * @example
+ * const { execute, isLoading } = useAsyncAction({
+ *   action: () => api.saveSettings(settings),
+ *   successMessage: 'Settings saved!',
+ *   errorMessage: 'Failed to save settings',
+ * });
+ *
+ * <Button onPress={execute} disabled={isLoading}>Save</Button>
+ */
+function useAsyncAction(options) {
+  const [isLoading, setIsLoading] = (0, _react.useState)(false);
+  const [error, setError] = (0, _react.useState)(null);
+  const execute = (0, _react.useCallback)(async () => {
+    const {
+      action,
+      successMessage,
+      errorMessage,
+      onSuccess,
+      onError,
+      showLoadingToast,
+      loadingMessage
+    } = options;
+    setIsLoading(true);
+    setError(null);
+    if (showLoadingToast && loadingMessage) {
+      _toast.toast.info(loadingMessage);
+    }
+    try {
+      const result = await action();
+      if (successMessage) {
+        _toast.toast.success(successMessage);
+      }
+      onSuccess?.(result);
+      return result;
+    } catch (err) {
+      const message = typeof errorMessage === 'function' ? errorMessage(err) : errorMessage || (err instanceof Error ? err.message : null) || 'An error occurred';
+      _toast.toast.error(message);
+      setError(err instanceof Error ? err : new Error(message));
+      onError?.(err);
+      return undefined;
+    } finally {
+      setIsLoading(false);
+    }
+  }, [options]);
+  const resetError = (0, _react.useCallback)(() => {
+    setError(null);
+  }, []);
+  return {
+    execute,
+    isLoading,
+    error,
+    resetError
+  };
+}
+
+/**
+ * Simplified version that just executes an async action with toast feedback.
+ * Useful for one-off actions.
+ */
+async function executeWithToast(action, options) {
+  const {
+    successMessage,
+    errorMessage,
+    loadingMessage
+  } = options || {};
+  if (loadingMessage) {
+    _toast.toast.info(loadingMessage);
+  }
+  try {
+    const result = await action();
+    if (successMessage) {
+      _toast.toast.success(successMessage);
+    }
+    return result;
+  } catch (err) {
+    _toast.toast.error(errorMessage || (err instanceof Error ? err.message : null) || 'An error occurred');
+    return undefined;
+  }
+}
+var _default = exports.default = useAsyncAction;
+//# sourceMappingURL=useAsyncAction.js.map

package/lib/commonjs/ui/hooks/useAsyncAction.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","require","_toast","useAsyncAction","options","isLoading","setIsLoading","useState","error","setError","execute","useCallback","action","successMessage","errorMessage","onSuccess","onError","showLoadingToast","loadingMessage","toast","info","result","success","err","message","Error","undefined","resetError","executeWithToast","_default","exports","default"],"sourceRoot":"../../../../src","sources":["ui/hooks/useAsyncAction.ts"],"mappings":";;;;;;;;AAAA,IAAAA,MAAA,GAAAC,OAAA;AACA,IAAAC,MAAA,GAAAD,OAAA;AA8BA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASE,cAAcA,CAC1BC,OAAiC,EACV;EACvB,MAAM,CAACC,SAAS,EAAEC,YAAY,CAAC,GAAG,IAAAC,eAAQ,EAAC,KAAK,CAAC;EACjD,MAAM,CAACC,KAAK,EAAEC,QAAQ,CAAC,GAAG,IAAAF,eAAQ,EAAe,IAAI,CAAC;EAEtD,MAAMG,OAAO,GAAG,IAAAC,kBAAW,EAAC,YAAoC;IAC5D,MAAM;MACFC,MAAM;MACNC,cAAc;MACdC,YAAY;MACZC,SAAS;MACTC,OAAO;MACPC,gBAAgB;MAChBC;IACJ,CAAC,GAAGd,OAAO;IAEXE,YAAY,CAAC,IAAI,CAAC;IAClBG,QAAQ,CAAC,IAAI,CAAC;IAEd,IAAIQ,gBAAgB,IAAIC,cAAc,EAAE;MACpCC,YAAK,CAACC,IAAI,CAACF,cAAc,CAAC;IAC9B;IAEA,IAAI;MACA,MAAMG,MAAM,GAAG,MAAMT,MAAM,CAAC,CAAC;MAE7B,IAAIC,cAAc,EAAE;QAChBM,YAAK,CAACG,OAAO,CAACT,cAAc,CAAC;MACjC;MAEAE,SAAS,GAAGM,MAAM,CAAC;MACnB,OAAOA,MAAM;IACjB,CAAC,CAAC,OAAOE,GAAY,EAAE;MACnB,MAAMC,OAAO,GAAG,OAAOV,YAAY,KAAK,UAAU,GAC5CA,YAAY,CAACS,GAAG,CAAC,GACjBT,YAAY,KAAKS,GAAG,YAAYE,KAAK,GAAGF,GAAG,CAACC,OAAO,GAAG,IAAI,CAAC,IAAI,mBAAmB;MAExFL,YAAK,CAACX,KAAK,CAACgB,OAAO,CAAC;MACpBf,QAAQ,CAACc,GAAG,YAAYE,KAAK,GAAGF,GAAG,GAAG,IAAIE,KAAK,CAACD,OAAO,CAAC,CAAC;MACzDR,OAAO,GAAGO,GAAG,CAAC;MACd,OAAOG,SAAS;IACpB,CAAC,SAAS;MACNpB,YAAY,CAAC,KAAK,CAAC;IACvB;EACJ,CAAC,EAAE,CAACF,OAAO,CAAC,CAAC;EAEb,MAAMuB,UAAU,GAAG,IAAAhB,kBAAW,EAAC,MAAM;IACjCF,QAAQ,CAAC,IAAI,CAAC;EAClB,CAAC,EAAE,EAAE,CAAC;EAEN,OAAO;IAAEC,OAAO;IAAEL,SAAS;IAAEG,KAAK;IAAEmB;EAAW,CAAC;AACpD;;AAEA;AACA;AACA;AACA;AACO,eAAeC,gBAAgBA,CAClChB,MAAwB,EACxBR,OAIC,EACqB;EACtB,MAAM;IAAES,cAAc;IAAEC,YAAY;IAAEI;EAAe,CAAC,GAAGd,OAAO,IAAI,CAAC,CAAC;EAEtE,IAAIc,cAAc,EAAE;IAChBC,YAAK,CAACC,IAAI,CAACF,cAAc,CAAC;EAC9B;EAEA,IAAI;IACA,MAAMG,MAAM,GAAG,MAAMT,MAAM,CAAC,CAAC;IAC7B,IAAIC,cAAc,EAAE;MAChBM,YAAK,CAACG,OAAO,CAACT,cAAc,CAAC;IACjC;IACA,OAAOQ,MAAM;EACjB,CAAC,CAAC,OAAOE,GAAY,EAAE;IACnBJ,YAAK,CAACX,KAAK,CAACM,YAAY,KAAKS,GAAG,YAAYE,KAAK,GAAGF,GAAG,CAACC,OAAO,GAAG,IAAI,CAAC,IAAI,mBAAmB,CAAC;IAC/F,OAAOE,SAAS;EACpB;AACJ;AAAC,IAAAG,QAAA,GAAAC,OAAA,CAAAC,OAAA,GAEc5B,cAAc","ignoreList":[]}

package/lib/commonjs/ui/hooks/useAuth.js

@@ -0,0 +1,127 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useAuth = useAuth;
+var _react = require("react");
+var _OxyContext = require("../context/OxyContext.js");
+var _isWebBrowser = require("../utils/isWebBrowser.js");
+/**
+ * Unified Auth Hook
+ *
+ * Provides a clean, standard interface for authentication across all platforms.
+ * This is the recommended way to access auth state in Oxy apps.
+ *
+ * Usage:
+ * ```tsx
+ * import { useAuth } from '@oxyhq/services';
+ *
+ * function MyComponent() {
+ *   const { user, isAuthenticated, isLoading, signIn, signOut } = useAuth();
+ *
+ *   if (isLoading) return <Loading />;
+ *   if (!isAuthenticated) return <SignInButton onClick={() => signIn()} />;
+ *   return <Welcome user={user} />;
+ * }
+ * ```
+ *
+ * Session restore (zero cookies):
+ * - Web: this origin's own persisted `{deviceId, deviceSecret}` — a signed-out
+ *   origin stays signed out until the user presses "Continue with Oxy". There is
+ *   no cross-origin silent SSO: the SDK never navigates the tab on its own.
+ * - Native: shared Keychain / app-group identity (Commons)
+ * - Realtime sync: Socket.IO `session_state` on `device:<deviceId>` once authenticated
+ * - Manual sign-in: signIn() opens the in-app account dialog (web + native)
+ */
+
+/**
+ * Unified auth hook for all Oxy apps
+ *
+ * Features:
+ * - Zero config: Just wrap with OxyProvider and use
+ * - Cross-platform: Same API on native and web
+ * - Auto session restore: device-first cold boot (`deviceId` + `deviceSecret` mint);
+ *   never auto-redirects to the IdP
+ * - Type-safe: Full TypeScript support
+ */
+function useAuth() {
+  const {
+    user,
+    isAuthenticated,
+    isLoading,
+    isTokenReady,
+    hasAccessToken,
+    canUsePrivateApi,
+    isPrivateApiPending,
+    isAuthResolved,
+    error,
+    signIn: oxySignIn,
+    logout,
+    logoutAll,
+    refreshSessions,
+    oxyServices,
+    switchToAccount,
+    hasIdentity,
+    getPublicKey,
+    showBottomSheet,
+    openAvatarPicker,
+    openAccountDialog
+  } = (0, _OxyContext.useOxy)();
+  const signIn = (0, _react.useCallback)(async publicKey => {
+    // Native: sign in directly with the cryptographic identity when a public key
+    // is provided, or an existing keychain identity is found.
+    if (publicKey) {
+      return oxySignIn(publicKey);
+    }
+    if (!(0, _isWebBrowser.isWebBrowser)()) {
+      const hasExisting = await hasIdentity();
+      if (hasExisting) {
+        const existingKey = await getPublicKey();
+        if (existingKey) {
+          return oxySignIn(existingKey);
+        }
+      }
+    }
+
+    // Web, or native without a keychain identity: open the unified account dialog
+    // on its sign-in view (device flow / QR / password hand-off). There is NO
+    // automatic navigation to a login page — the device-first cold boot already
+    // restored a session if one existed. The caller reacts to `isAuthenticated`,
+    // so this promise intentionally never resolves.
+    openAccountDialog('signin');
+    return new Promise(() => undefined);
+  }, [oxySignIn, hasIdentity, getPublicKey, openAccountDialog]);
+  const signOut = (0, _react.useCallback)(async () => {
+    await logout();
+  }, [logout]);
+  const signOutAll = (0, _react.useCallback)(async () => {
+    await logoutAll();
+  }, [logoutAll]);
+  const refresh = (0, _react.useCallback)(async () => {
+    await refreshSessions();
+  }, [refreshSessions]);
+  return {
+    // State
+    user,
+    isAuthenticated,
+    isLoading: isLoading || !isAuthResolved,
+    isReady: isTokenReady,
+    hasAccessToken,
+    canUsePrivateApi,
+    isPrivateApiPending,
+    isAuthResolved,
+    error,
+    // Actions
+    signIn,
+    signOut,
+    signOutAll,
+    refresh,
+    // Advanced
+    oxyServices,
+    switchToAccount,
+    showBottomSheet,
+    openAvatarPicker
+  };
+}
+//# sourceMappingURL=useAuth.js.map