@oxy.so/services 1.0.0

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

@@ -0,0 +1,215 @@
+"use strict";
+
+/**
+ * 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.
+ */
+
+import { QueryClient, onlineManager } from '@tanstack/react-query';
+import { persistQueryClient } from '@tanstack/react-query-persist-client';
+import { createAsyncStoragePersister } from '@tanstack/query-async-storage-persister';
+import { isDev } from '@oxy.so/core';
+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;
+const MAX_QUERY_RETRIES = 2;
+function statusOf(error) {
+  if (!error || typeof error !== 'object') return null;
+  const value = error.status ?? error.response?.status;
+  return typeof value === 'number' ? value : null;
+}
+
+/** Retry only failures that another attempt can plausibly change. */
+export function shouldRetryQuery(failureCount, error) {
+  if (failureCount >= MAX_QUERY_RETRIES) return false;
+  const status = statusOf(error);
+  if (status === null) return true; // transport error without an HTTP response
+  return status === 408 || status === 425 || status === 429 || status >= 500;
+}
+
+/**
+ * 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.
+ */
+export const createQueryClient = () => {
+  const client = new 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: shouldRetryQuery,
+        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: {
+        // A generic mutation has no proof of idempotency. Individual mutation
+        // definitions may opt into retry only when they carry such a proof.
+        retry: false,
+        // 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 = onlineManager.subscribe(isOnline => {
+    if (isOnline) {
+      void client.getMutationCache().resumePausedMutations();
+    }
+  });
+  Object.defineProperty(client, '__oxyOnlineUnsubscribe', {
+    value: unsubscribe,
+    enumerable: false,
+    configurable: true,
+    writable: false
+  });
+  return client;
+};
+/**
+ * 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).
+ */
+export const attachQueryPersistence = (queryClient, storage) => {
+  if (!storage) {
+    return {
+      restored: Promise.resolve(),
+      unsubscribe: () => {}
+    };
+  }
+  const persister = createAsyncStoragePersister({
+    storage: adaptStorage(storage),
+    key: QUERY_CACHE_KEY,
+    throttleTime: QUERY_PERSIST_THROTTLE_MS
+  });
+  const [unsubscribe, restored] = persistQueryClient({
+    queryClient,
+    persister,
+    maxAge: QUERY_CACHE_MAX_AGE,
+    dehydrateOptions: {
+      shouldDehydrateQuery,
+      shouldDehydrateMutation
+    }
+  });
+  restored.catch(error => {
+    if (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.
+ */
+export const clearQueryCache = async storage => {
+  try {
+    await storage.removeItem(QUERY_CACHE_KEY);
+  } catch (error) {
+    if (isDev()) {
+      console.warn('[QueryClient] Failed to clear persisted query cache', error);
+    }
+  }
+};
+
+/**
+ * Re-export the persisted client shape so callers can type custom persisters.
+ */
+//# sourceMappingURL=queryClient.js.map

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

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

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

@@ -0,0 +1,221 @@
+"use strict";
+
+import { useCallback } from 'react';
+import { useAssetStore } from "../stores/assetStore.js";
+// Create a singleton instance for the hook
+let oxyInstance = null;
+export const setOxyAssetInstance = instance => {
+  oxyInstance = instance;
+};
+
+/**
+ * Hook for managing assets with Zustand store integration
+ */
+export 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
+  } = useAssetStore();
+
+  // Upload asset with progress tracking
+  const upload = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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
+  };
+};
+//# sourceMappingURL=useAssets.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","useAssetStore","oxyInstance","setOxyAssetInstance","instance","useAssets","assets","uploadProgress","loading","errors","setAsset","setAssets","removeAsset","setUploadProgress","removeUploadProgress","addLink","removeLink","setUploading","setLinking","setDeleting","setUploadError","setLinkError","setDeleteError","clearErrors","getAssetsByApp","getAssetsByEntity","getAssetUsageCount","isAssetLinked","reset","upload","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/module/ui/hooks/useAsyncAction.js

@@ -0,0 +1,89 @@
+"use strict";
+
+import { useState, useCallback } from 'react';
+import { toast } from '@oxy.so/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>
+ */
+export function useAsyncAction(options) {
+  const [isLoading, setIsLoading] = useState(false);
+  const [error, setError] = useState(null);
+  const execute = useCallback(async () => {
+    const {
+      action,
+      successMessage,
+      errorMessage,
+      onSuccess,
+      onError,
+      showLoadingToast,
+      loadingMessage
+    } = options;
+    setIsLoading(true);
+    setError(null);
+    if (showLoadingToast && loadingMessage) {
+      toast.info(loadingMessage);
+    }
+    try {
+      const result = await action();
+      if (successMessage) {
+        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.error(message);
+      setError(err instanceof Error ? err : new Error(message));
+      onError?.(err);
+      return undefined;
+    } finally {
+      setIsLoading(false);
+    }
+  }, [options]);
+  const resetError = useCallback(() => {
+    setError(null);
+  }, []);
+  return {
+    execute,
+    isLoading,
+    error,
+    resetError
+  };
+}
+
+/**
+ * Simplified version that just executes an async action with toast feedback.
+ * Useful for one-off actions.
+ */
+export async function executeWithToast(action, options) {
+  const {
+    successMessage,
+    errorMessage,
+    loadingMessage
+  } = options || {};
+  if (loadingMessage) {
+    toast.info(loadingMessage);
+  }
+  try {
+    const result = await action();
+    if (successMessage) {
+      toast.success(successMessage);
+    }
+    return result;
+  } catch (err) {
+    toast.error(errorMessage || (err instanceof Error ? err.message : null) || 'An error occurred');
+    return undefined;
+  }
+}
+export default useAsyncAction;
+//# sourceMappingURL=useAsyncAction.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["useState","useCallback","toast","useAsyncAction","options","isLoading","setIsLoading","error","setError","execute","action","successMessage","errorMessage","onSuccess","onError","showLoadingToast","loadingMessage","info","result","success","err","message","Error","undefined","resetError","executeWithToast"],"sourceRoot":"../../../../src","sources":["ui/hooks/useAsyncAction.ts"],"mappings":";;AAAA,SAASA,QAAQ,EAAEC,WAAW,QAAQ,OAAO;AAC7C,SAASC,KAAK,QAAQ,qBAAqB;AA8B3C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,cAAcA,CAC1BC,OAAiC,EACV;EACvB,MAAM,CAACC,SAAS,EAAEC,YAAY,CAAC,GAAGN,QAAQ,CAAC,KAAK,CAAC;EACjD,MAAM,CAACO,KAAK,EAAEC,QAAQ,CAAC,GAAGR,QAAQ,CAAe,IAAI,CAAC;EAEtD,MAAMS,OAAO,GAAGR,WAAW,CAAC,YAAoC;IAC5D,MAAM;MACFS,MAAM;MACNC,cAAc;MACdC,YAAY;MACZC,SAAS;MACTC,OAAO;MACPC,gBAAgB;MAChBC;IACJ,CAAC,GAAGZ,OAAO;IAEXE,YAAY,CAAC,IAAI,CAAC;IAClBE,QAAQ,CAAC,IAAI,CAAC;IAEd,IAAIO,gBAAgB,IAAIC,cAAc,EAAE;MACpCd,KAAK,CAACe,IAAI,CAACD,cAAc,CAAC;IAC9B;IAEA,IAAI;MACA,MAAME,MAAM,GAAG,MAAMR,MAAM,CAAC,CAAC;MAE7B,IAAIC,cAAc,EAAE;QAChBT,KAAK,CAACiB,OAAO,CAACR,cAAc,CAAC;MACjC;MAEAE,SAAS,GAAGK,MAAM,CAAC;MACnB,OAAOA,MAAM;IACjB,CAAC,CAAC,OAAOE,GAAY,EAAE;MACnB,MAAMC,OAAO,GAAG,OAAOT,YAAY,KAAK,UAAU,GAC5CA,YAAY,CAACQ,GAAG,CAAC,GACjBR,YAAY,KAAKQ,GAAG,YAAYE,KAAK,GAAGF,GAAG,CAACC,OAAO,GAAG,IAAI,CAAC,IAAI,mBAAmB;MAExFnB,KAAK,CAACK,KAAK,CAACc,OAAO,CAAC;MACpBb,QAAQ,CAACY,GAAG,YAAYE,KAAK,GAAGF,GAAG,GAAG,IAAIE,KAAK,CAACD,OAAO,CAAC,CAAC;MACzDP,OAAO,GAAGM,GAAG,CAAC;MACd,OAAOG,SAAS;IACpB,CAAC,SAAS;MACNjB,YAAY,CAAC,KAAK,CAAC;IACvB;EACJ,CAAC,EAAE,CAACF,OAAO,CAAC,CAAC;EAEb,MAAMoB,UAAU,GAAGvB,WAAW,CAAC,MAAM;IACjCO,QAAQ,CAAC,IAAI,CAAC;EAClB,CAAC,EAAE,EAAE,CAAC;EAEN,OAAO;IAAEC,OAAO;IAAEJ,SAAS;IAAEE,KAAK;IAAEiB;EAAW,CAAC;AACpD;;AAEA;AACA;AACA;AACA;AACA,OAAO,eAAeC,gBAAgBA,CAClCf,MAAwB,EACxBN,OAIC,EACqB;EACtB,MAAM;IAAEO,cAAc;IAAEC,YAAY;IAAEI;EAAe,CAAC,GAAGZ,OAAO,IAAI,CAAC,CAAC;EAEtE,IAAIY,cAAc,EAAE;IAChBd,KAAK,CAACe,IAAI,CAACD,cAAc,CAAC;EAC9B;EAEA,IAAI;IACA,MAAME,MAAM,GAAG,MAAMR,MAAM,CAAC,CAAC;IAC7B,IAAIC,cAAc,EAAE;MAChBT,KAAK,CAACiB,OAAO,CAACR,cAAc,CAAC;IACjC;IACA,OAAOO,MAAM;EACjB,CAAC,CAAC,OAAOE,GAAY,EAAE;IACnBlB,KAAK,CAACK,KAAK,CAACK,YAAY,KAAKQ,GAAG,YAAYE,KAAK,GAAGF,GAAG,CAACC,OAAO,GAAG,IAAI,CAAC,IAAI,mBAAmB,CAAC;IAC/F,OAAOE,SAAS;EACpB;AACJ;AAEA,eAAepB,cAAc","ignoreList":[]}