@oxyhq/services 30.0.0 → 30.1.0

package/lib/module/ui/hooks/queries/useAccountQueries.js

@@ -0,0 +1,315 @@
+"use strict";
+
+import { useEffect } from 'react';
+import { useQuery, useQueries, useQueryClient } from '@tanstack/react-query';
+import { authenticatedApiCall } from '@oxyhq/core';
+import { queryKeys } from "./queryKeys.js";
+import { mutationKeys } from "../mutations/mutationKeys.js";
+import { useOxy } from "../../context/OxyContext.js";
+import { useAuthStore } from "../../stores/authStore.js";
+
+/**
+ * Get user profile by session ID
+ */
+export const useUserProfile = (sessionId, options) => {
+  const {
+    oxyServices
+  } = useOxy();
+  return useQuery({
+    queryKey: queryKeys.users.profile(sessionId || ''),
+    queryFn: async () => {
+      if (!sessionId) {
+        throw new Error('Session ID is required');
+      }
+      return await oxyServices.getUserBySession(sessionId);
+    },
+    enabled: options?.enabled !== false && !!sessionId,
+    staleTime: 5 * 60 * 1000,
+    // 5 minutes
+    gcTime: 30 * 60 * 1000 // 30 minutes
+  });
+};
+
+/**
+ * Get multiple user profiles by session IDs (batch query)
+ */
+export const useUserProfiles = (sessionIds, options) => {
+  const {
+    oxyServices
+  } = useOxy();
+  return useQueries({
+    queries: sessionIds.map(sessionId => ({
+      queryKey: queryKeys.users.profile(sessionId),
+      queryFn: async () => {
+        const results = await oxyServices.getUsersBySessions([sessionId]);
+        return results[0]?.user || null;
+      },
+      enabled: options?.enabled !== false && !!sessionId,
+      staleTime: 5 * 60 * 1000,
+      gcTime: 30 * 60 * 1000
+    }))
+  });
+};
+
+/**
+ * Get current authenticated user.
+ *
+ * Hydrates from `GET /users/me` (the bearer identifies the session) rather than
+ * `GET /session/user/:activeSessionId`. Post zero-cookie cutover the bearer is
+ * the single source of session truth, so keying the CURRENT user off a session
+ * id in the URL was a second, independently-updated source that could disagree
+ * with the bearer during an account switch — the request fired under the
+ * previous account's token against the new account's session id and 404'd. The
+ * query KEY stays scoped to the active account so the cache re-scopes (and
+ * refetches) on a switch; only the URL stopped carrying a session id.
+ *
+ * The store-mirror effect must NOT overwrite the in-memory user while a
+ * write mutation is in flight — otherwise a stale background refetch
+ * landing between optimistic update and server-confirmed update would
+ * revert the optimistic value and flicker the UI.
+ *
+ * We gate the mirror on the mutation-cache state for any mutation that
+ * touches `User` shape (profile, avatar, settings, privacy). When any of
+ * those is in flight we skip the mirror entirely; the winning onSuccess
+ * handler is responsible for writing the final value to the store.
+ */
+export const useCurrentUser = options => {
+  const {
+    oxyServices,
+    activeSessionId,
+    isAuthenticated
+  } = useOxy();
+  const queryClient = useQueryClient();
+  const query = useQuery({
+    queryKey: queryKeys.accounts.current(activeSessionId),
+    queryFn: async () => {
+      return await oxyServices.getCurrentUser();
+    },
+    enabled: options?.enabled !== false && isAuthenticated && !!activeSessionId,
+    staleTime: 1 * 60 * 1000,
+    // 1 minute for current user
+    gcTime: 30 * 60 * 1000
+  });
+
+  // Mirror fresh server-side user into the auth store so consumers reading
+  // useOxy().user pick up newly-arriving fields (createdAt, updatedAt, etc.).
+  //
+  // Guard 1 (mutation in flight): skip if ANY user-shape mutation is in
+  // flight — the in-progress optimistic value must not be reverted by a
+  // background refetch.
+  // Guard 2 (staleness): if the existing store user has a strictly newer
+  // `updatedAt` than the incoming data, skip. Protects against late-
+  // arriving refetches that race with an already-completed mutation.
+  const data = query.data;
+  useEffect(() => {
+    if (!data) return;
+
+    // Check for any write mutation that mutates the user shape. Match by
+    // any prefix of the user-write mutation keys we own — `isMutating`
+    // matches mutations whose `mutationKey` starts with the provided key.
+    const userWriteMutationsInFlight = queryClient.isMutating({
+      mutationKey: mutationKeys.account.updateProfile
+    }) + queryClient.isMutating({
+      mutationKey: mutationKeys.account.uploadAvatar
+    }) + queryClient.isMutating({
+      mutationKey: mutationKeys.account.updateSettings
+    }) + queryClient.isMutating({
+      mutationKey: mutationKeys.account.updatePrivacySettings
+    });
+    if (userWriteMutationsInFlight > 0) {
+      return;
+    }
+
+    // updatedAt-based staleness gate. Tolerates missing fields on either
+    // side: when the server response or stored user omits `updatedAt`
+    // (partial updates, legacy users), fall through to the mirror — the
+    // mutation-in-flight guard above is the primary defense.
+    const storedUser = useAuthStore.getState().user;
+    const incomingUpdatedAt = parseUpdatedAt(data.updatedAt);
+    const storedUpdatedAt = parseUpdatedAt(storedUser?.updatedAt);
+    if (incomingUpdatedAt !== null && storedUpdatedAt !== null && incomingUpdatedAt < storedUpdatedAt) {
+      return;
+    }
+    useAuthStore.getState().setUser(data);
+  }, [data, queryClient]);
+  return query;
+};
+
+/**
+ * Best-effort parser for the various `updatedAt` representations the API
+ * returns (ISO string, epoch number, Date instance, undefined). Returns
+ * `null` when the value can't be interpreted as a finite timestamp — the
+ * caller then falls back to the mutation-in-flight guard.
+ */
+function parseUpdatedAt(value) {
+  if (value == null) return null;
+  if (typeof value === 'number') return Number.isFinite(value) ? value : null;
+  if (value instanceof Date) {
+    const t = value.getTime();
+    return Number.isFinite(t) ? t : null;
+  }
+  if (typeof value === 'string') {
+    const t = Date.parse(value);
+    return Number.isFinite(t) ? t : null;
+  }
+  return null;
+}
+
+/**
+ * Get user by ID (identity-by-id).
+ *
+ * Keyed on the viewer-INDEPENDENT `queryKeys.users.detail(id)`: this hook is
+ * the card-identity workhorse (name, avatar, username, verified) and does NOT
+ * read the viewer-relative `relationship` field. Keeping the key
+ * viewer-independent lets external by-id identity seeders / precache layers
+ * (e.g. Mention's card enrichment) that all write `queryKeys.users.detail(id)`
+ * share a single cache entry — a viewer-scoped key would dead-end every seed
+ * and cause avatar/name flashes plus N+1 fetches.
+ *
+ * A viewer-scoped, relationship-aware by-id PROFILE fetch is intentionally NOT
+ * this hook — it would be a separate future `useUserProfileById` keyed on
+ * `queryKeys.users.detailForViewer(id, viewerId)`. No current consumer reads
+ * `relationship` from a by-id fetch (only the username path does).
+ */
+export const useUserById = (userId, options) => {
+  const {
+    oxyServices
+  } = useOxy();
+  return useQuery({
+    queryKey: queryKeys.users.detail(userId || ''),
+    queryFn: async () => {
+      if (!userId) {
+        throw new Error('User ID is required');
+      }
+      return await oxyServices.getUserById(userId);
+    },
+    enabled: options?.enabled !== false && !!userId,
+    staleTime: 5 * 60 * 1000,
+    gcTime: 30 * 60 * 1000
+  });
+};
+
+/**
+ * Get user profile by username
+ */
+export const useUserByUsername = (username, options) => {
+  const {
+    oxyServices,
+    user
+  } = useOxy();
+  // Viewer-scope the cache. Authenticated single-profile fetches embed a
+  // viewer-relative `relationship` ({ isFollowing, followsYou }); anonymous
+  // fetches omit it and different viewers get different values. Without the
+  // active viewer in the key, react-query freezes the first (often anonymous
+  // cold-boot) copy and never refetches when the session lands ~5-25s later,
+  // so the "Follows you" tag flashes then vanishes forever. Adding the viewer
+  // makes anon vs authed distinct entries AND forces a refetch when the
+  // session resolves or the account switches. (The SDK's GET response cache is
+  // already identity-scoped by the access-token user id via `computeIdentityTag`,
+  // so it never cross-poisons `relationship` — the only gap was this key.)
+  const viewerId = user?.id ?? '';
+  return useQuery({
+    queryKey: queryKeys.users.byUsername(username || '', viewerId),
+    queryFn: async () => {
+      if (!username) {
+        throw new Error('Username is required');
+      }
+      // Match queryKeys.users.byUsername normalization so the cache key and
+      // the API request agree (case-insensitive local handles).
+      const normalizedUsername = username.trim().toLowerCase();
+      return await oxyServices.getProfileByUsername(normalizedUsername);
+    },
+    enabled: options?.enabled !== false && !!username,
+    staleTime: 5 * 60 * 1000,
+    gcTime: 30 * 60 * 1000,
+    // Enforce the `upsertCachedUser` stale-seed contract from THIS hook rather
+    // than relying on the consuming app's global `refetchOnMount` default.
+    // When a feed/post author is precached into the by-username key it is seeded
+    // SPARSE (no `createdAt`/`relationship`/`_count`) and marked STALE
+    // (`updatedAt: 0`) precisely so this hook refetches the full authoritative
+    // profile on mount. A consumer whose QueryClient sets
+    // `defaultOptions.queries.refetchOnMount: false` (a common perf setting —
+    // Mention does this) would otherwise serve the stale sparse seed forever and
+    // the authoritative fetch (which carries `createdAt`) would never run — the
+    // "Joined <date> missing depending on where you came from" bug. `true` (NOT
+    // `'always'`) with the 5m `staleTime` keeps it efficient: a genuinely fresh
+    // real fetch is NOT refetched, only a stale seed / >5m-old entry is.
+    // `useUserByUsername` is consumed ONLY for single-profile views (never an
+    // N-instance list), so this is exactly one fetch. `useUserById` — the card
+    // workhorse in N-instance lists — deliberately does NOT do this.
+    refetchOnMount: true
+  });
+};
+
+/**
+ * Batch get users by session IDs (optimized single API call)
+ */
+export const useUsersBySessions = (sessionIds, options) => {
+  const {
+    oxyServices
+  } = useOxy();
+  return useQuery({
+    queryKey: queryKeys.accounts.list(sessionIds),
+    queryFn: async () => {
+      if (sessionIds.length === 0) {
+        return [];
+      }
+      return await oxyServices.getUsersBySessions(sessionIds);
+    },
+    enabled: options?.enabled !== false && sessionIds.length > 0,
+    staleTime: 5 * 60 * 1000,
+    gcTime: 30 * 60 * 1000
+  });
+};
+
+/**
+ * List the third-party OAuth applications the current user has connected via
+ * the consent flow (`GET /auth/grants`). Drives the "Connected apps" management
+ * screen.
+ */
+export const useConnectedApps = options => {
+  const {
+    oxyServices,
+    activeSessionId,
+    isAuthenticated
+  } = useOxy();
+  return useQuery({
+    queryKey: queryKeys.connectedApps.list(),
+    queryFn: async () => {
+      return authenticatedApiCall(oxyServices, activeSessionId, () => oxyServices.listConnectedApps());
+    },
+    enabled: options?.enabled !== false && isAuthenticated,
+    staleTime: 30 * 1000,
+    // 30 seconds — short, drives a management UI
+    gcTime: 5 * 60 * 1000
+  });
+};
+
+/**
+ * Get privacy settings for a user
+ */
+export const usePrivacySettings = (userId, options) => {
+  const {
+    oxyServices,
+    activeSessionId,
+    user
+  } = useOxy();
+  // When no explicit user id is supplied, target the ACTIVE account (the
+  // account switched into) so "my privacy settings" reflects the current
+  // account, matching the imperative PrivacySettingsScreen.
+  const targetUserId = userId || user?.id;
+  return useQuery({
+    queryKey: queryKeys.privacy.settings(targetUserId),
+    queryFn: async () => {
+      if (!targetUserId) {
+        throw new Error('User ID is required');
+      }
+      return authenticatedApiCall(oxyServices, activeSessionId, () => oxyServices.getPrivacySettings(targetUserId));
+    },
+    enabled: options?.enabled !== false && !!targetUserId,
+    staleTime: 2 * 60 * 1000,
+    // 2 minutes
+    gcTime: 10 * 60 * 1000 // 10 minutes
+  });
+};
+//# sourceMappingURL=useAccountQueries.js.map

package/lib/module/ui/hooks/queries/useAccountQueries.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useEffect","useQuery","useQueries","useQueryClient","authenticatedApiCall","queryKeys","mutationKeys","useOxy","useAuthStore","useUserProfile","sessionId","options","oxyServices","queryKey","users","profile","queryFn","Error","getUserBySession","enabled","staleTime","gcTime","useUserProfiles","sessionIds","queries","map","results","getUsersBySessions","user","useCurrentUser","activeSessionId","isAuthenticated","queryClient","query","accounts","current","getCurrentUser","data","userWriteMutationsInFlight","isMutating","mutationKey","account","updateProfile","uploadAvatar","updateSettings","updatePrivacySettings","storedUser","getState","incomingUpdatedAt","parseUpdatedAt","updatedAt","storedUpdatedAt","setUser","value","Number","isFinite","Date","t","getTime","parse","useUserById","userId","detail","getUserById","useUserByUsername","username","viewerId","id","byUsername","normalizedUsername","trim","toLowerCase","getProfileByUsername","refetchOnMount","useUsersBySessions","list","length","useConnectedApps","connectedApps","listConnectedApps","usePrivacySettings","targetUserId","privacy","settings","getPrivacySettings"],"sourceRoot":"../../../../../src","sources":["ui/hooks/queries/useAccountQueries.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/ui/hooks/queries/useAuthMethods.js

@@ -0,0 +1,45 @@
+"use strict";
+
+import { useMemo } from 'react';
+import { useQuery } from '@tanstack/react-query';
+import { queryKeys } from "./queryKeys.js";
+import { useOxy } from "../../context/OxyContext.js";
+
+/** Stable empty list so the derived selectors keep a stable reference while loading. */
+const EMPTY_METHODS = Object.freeze([]);
+
+/**
+ * The current account's linked authentication methods (`GET /auth/methods`),
+ * plus convenience projections. Backs the security / account surfaces that let a
+ * user see and manage their passwords, identity key, social logins, and passkeys.
+ *
+ * `passkeys` is the `type === 'webauthn'` subset — one entry per registered
+ * credential. Invalidate via `queryKeys.authMethods.all` after linking a passkey
+ * (`useOxy().addPasskey()` does this) or removing one.
+ */
+export const useAuthMethods = options => {
+  const {
+    oxyServices,
+    activeSessionId
+  } = useOxy();
+  const query = useQuery({
+    queryKey: queryKeys.authMethods.list(),
+    queryFn: () => oxyServices.listAuthMethods(),
+    enabled: options?.enabled !== false && !!activeSessionId,
+    staleTime: 5 * 60 * 1000,
+    // 5 minutes
+    gcTime: 10 * 60 * 1000 // 10 minutes
+  });
+  const methods = query.data?.methods ?? EMPTY_METHODS;
+  const passkeys = useMemo(() => methods.filter(method => method.type === 'webauthn'), [methods]);
+  return {
+    ...query,
+    /** Every linked auth method. Empty while loading. */
+    methods,
+    /** The registered passkeys (a `type === 'webauthn'` subset of `methods`). */
+    passkeys,
+    /** The account's DID, or `null` while loading. */
+    did: query.data?.did ?? null
+  };
+};
+//# sourceMappingURL=useAuthMethods.js.map

package/lib/module/ui/hooks/queries/useAuthMethods.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useMemo","useQuery","queryKeys","useOxy","EMPTY_METHODS","Object","freeze","useAuthMethods","options","oxyServices","activeSessionId","query","queryKey","authMethods","list","queryFn","listAuthMethods","enabled","staleTime","gcTime","methods","data","passkeys","filter","method","type","did"],"sourceRoot":"../../../../../src","sources":["ui/hooks/queries/useAuthMethods.ts"],"mappings":";;AAAA,SAASA,OAAO,QAAQ,OAAO;AAC/B,SAASC,QAAQ,QAAQ,uBAAuB;AAEhD,SAASC,SAAS,QAAQ,gBAAa;AACvC,SAASC,MAAM,QAAQ,6BAA0B;;AAEjD;AACA,MAAMC,aAAyC,GAAGC,MAAM,CAACC,MAAM,CAAC,EAAE,CAAC;;AAEnE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,cAAc,GAAIC,OAA+B,IAAK;EACjE,MAAM;IAAEC,WAAW;IAAEC;EAAgB,CAAC,GAAGP,MAAM,CAAC,CAAC;EAEjD,MAAMQ,KAAK,GAAGV,QAAQ,CAAsB;IAC1CW,QAAQ,EAAEV,SAAS,CAACW,WAAW,CAACC,IAAI,CAAC,CAAC;IACtCC,OAAO,EAAEA,CAAA,KAAMN,WAAW,CAACO,eAAe,CAAC,CAAC;IAC5CC,OAAO,EAAET,OAAO,EAAES,OAAO,KAAK,KAAK,IAAI,CAAC,CAACP,eAAe;IACxDQ,SAAS,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI;IAAE;IAC1BC,MAAM,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,CAAE;EAC1B,CAAC,CAAC;EAEF,MAAMC,OAAO,GAAGT,KAAK,CAACU,IAAI,EAAED,OAAO,IAAIhB,aAAa;EACpD,MAAMkB,QAAQ,GAAGtB,OAAO,CACtB,MAAMoB,OAAO,CAACG,MAAM,CAAEC,MAAM,IAAKA,MAAM,CAACC,IAAI,KAAK,UAAU,CAAC,EAC5D,CAACL,OAAO,CACV,CAAC;EAED,OAAO;IACL,GAAGT,KAAK;IACR;IACAS,OAAO;IACP;IACAE,QAAQ;IACR;IACAI,GAAG,EAAEf,KAAK,CAACU,IAAI,EAAEK,GAAG,IAAI;EAC1B,CAAC;AACH,CAAC","ignoreList":[]}

package/lib/module/ui/hooks/queries/useFileQueries.js

@@ -0,0 +1,120 @@
+"use strict";
+
+/**
+ * User file-library queries + cache helpers.
+ *
+ * The file list is owned by React Query (`useInfiniteQuery`), NOT a zustand
+ * store: server pages live in the query cache, and every optimistic mutation
+ * (upload / delete / visibility) edits that cache via the pure `*InCache`
+ * helpers below. The `queryFn` is side-effect-free — it only fetches and maps a
+ * page. This is what lets the file manager stay effect-free while preserving
+ * infinite scroll, pull-to-refresh, and optimistic upload reconciliation.
+ */
+
+import { useInfiniteQuery } from '@tanstack/react-query';
+import { useOxy } from "../../context/OxyContext.js";
+import { queryKeys } from "./queryKeys.js";
+
+/** Files fetched per page. */
+export const FILES_PAGE_SIZE = 40;
+
+/** Raw file record as returned by `oxyServices.listUserFiles` / `assetUpload`. */
+
+/** One page of the infinite file list. */
+
+/** Normalize a raw API file record into the client `FileMetadata` shape. */
+export function mapRawFileToMetadata(raw) {
+  return {
+    id: raw.id,
+    filename: raw.originalName ?? raw.sha256 ?? '',
+    contentType: raw.mime ?? '',
+    length: raw.size ?? 0,
+    chunkSize: 0,
+    uploadDate: raw.createdAt ?? '',
+    metadata: raw.metadata ?? {},
+    variants: raw.variants ?? []
+  };
+}
+
+/**
+ * Infinite-paginated list of the owner's files. Fires on mount and whenever
+ * `ownerId` changes (a new key); `staleTime: 0` reloads on every open. The
+ * rendered list is `data.pages.flatMap(p => p.files)`.
+ */
+export const useUserFilesInfinite = ownerId => {
+  const {
+    oxyServices
+  } = useOxy();
+  return useInfiniteQuery({
+    queryKey: queryKeys.files.list(ownerId),
+    queryFn: async ({
+      pageParam
+    }) => {
+      const offset = typeof pageParam === 'number' ? pageParam : 0;
+      const response = await oxyServices.listUserFiles(FILES_PAGE_SIZE, offset);
+      const raw = response.files ?? [];
+      const files = raw.map(mapRawFileToMetadata);
+      return {
+        files,
+        total: response.total ?? offset + files.length,
+        hasMore: Boolean(response.hasMore),
+        nextOffset: offset + FILES_PAGE_SIZE
+      };
+    },
+    initialPageParam: 0,
+    getNextPageParam: lastPage => lastPage.hasMore ? lastPage.nextOffset : undefined,
+    enabled: Boolean(ownerId),
+    staleTime: 0,
+    refetchOnWindowFocus: false
+  });
+};
+
+// --- Pure cache transforms (optimistic updates) -----------------------------
+// Each edits the cached `InfiniteData` for one owner. All no-op when nothing is
+// cached yet (e.g. an upload before the first page loads) — the subsequent
+// `invalidateQueries` reconcile then brings the authoritative record.
+
+const fileListKey = ownerId => queryKeys.files.list(ownerId);
+const mapPages = (data, fn) => ({
+  ...data,
+  pages: data.pages.map(page => ({
+    ...page,
+    files: fn(page.files)
+  }))
+});
+
+/** Prepend an (optimistic) file to the first page. */
+export function prependFileToCache(queryClient, ownerId, file) {
+  queryClient.setQueryData(fileListKey(ownerId), data => {
+    if (!data || data.pages.length === 0) return data;
+    return {
+      ...data,
+      pages: data.pages.map((page, index) => index === 0 ? {
+        ...page,
+        files: [file, ...page.files]
+      } : page)
+    };
+  });
+}
+
+/** Remove a file (by id) from every page. */
+export function removeFileFromCache(queryClient, ownerId, fileId) {
+  queryClient.setQueryData(fileListKey(ownerId), data => data ? mapPages(data, files => files.filter(f => f.id !== fileId)) : data);
+}
+
+/** Swap an optimistic file (by id) for its persisted counterpart. */
+export function replaceFileInCache(queryClient, ownerId, oldId, newFile) {
+  queryClient.setQueryData(fileListKey(ownerId), data => data ? mapPages(data, files => files.map(f => f.id === oldId ? newFile : f)) : data);
+}
+
+/** Shallow-merge a metadata patch into a cached file (e.g. visibility change). */
+export function patchFileMetadataInCache(queryClient, ownerId, fileId, metadataPatch) {
+  queryClient.setQueryData(fileListKey(ownerId), data => data ? mapPages(data, files => files.map(f => f.id === fileId ? {
+    ...f,
+    metadata: {
+      ...f.metadata,
+      ...metadataPatch
+    }
+  } : f)) : data);
+}
+//# sourceMappingURL=useFileQueries.js.map

package/lib/module/ui/hooks/queries/useFileQueries.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useInfiniteQuery","useOxy","queryKeys","FILES_PAGE_SIZE","mapRawFileToMetadata","raw","id","filename","originalName","sha256","contentType","mime","length","size","chunkSize","uploadDate","createdAt","metadata","variants","useUserFilesInfinite","ownerId","oxyServices","queryKey","files","list","queryFn","pageParam","offset","response","listUserFiles","map","total","hasMore","Boolean","nextOffset","initialPageParam","getNextPageParam","lastPage","undefined","enabled","staleTime","refetchOnWindowFocus","fileListKey","mapPages","data","fn","pages","page","prependFileToCache","queryClient","file","setQueryData","index","removeFileFromCache","fileId","filter","f","replaceFileInCache","oldId","newFile","patchFileMetadataInCache","metadataPatch"],"sourceRoot":"../../../../../src","sources":["ui/hooks/queries/useFileQueries.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/ui/hooks/queries/usePaymentQueries.js

@@ -0,0 +1,137 @@
+"use strict";
+
+import { useQuery } from '@tanstack/react-query';
+import { authenticatedApiCall } from '@oxyhq/core';
+import { queryKeys } from "./queryKeys.js";
+import { useOxy } from "../../context/OxyContext.js";
+/**
+ * Payment / wallet / subscription query hooks.
+ *
+ * These replace the imperative `oxyServices.*` + `Promise.allSettled` +
+ * `useEffect` pattern used in app screens. Each hook:
+ *  - is gated on `isAuthenticated` (the underlying SDK methods read the
+ *    current user id off the access token and throw when unauthenticated),
+ *  - routes through `authenticatedApiCall` so a stale token is refreshed and
+ *    auth errors are handled consistently (matches `useUserDevices` /
+ *    `usePrivacySettings`),
+ *  - keeps its `queryFn` pure — no store writes, no side effects.
+ *
+ * The wrapped SDK methods (`@oxyhq/core` payment mixin) return `any`; the
+ * generic on `authenticatedApiCall<T>` pins the resolved value to the
+ * precise domain type so consumers get full typing.
+ */
+
+/**
+ * Get the current user's subscription.
+ *
+ * Wraps `oxyServices.getCurrentUserSubscription()`
+ * (`GET /subscription/:userId`, billing-first). Returns the persisted
+ * subscription or the API's `{ plan: 'basic' }` fallback when the user has
+ * never subscribed.
+ */
+export const useUserSubscription = options => {
+  const {
+    oxyServices,
+    isAuthenticated,
+    activeSessionId,
+    user
+  } = useOxy();
+  return useQuery({
+    queryKey: queryKeys.payments.subscription(user?.id),
+    queryFn: async () => {
+      return authenticatedApiCall(oxyServices, activeSessionId, () => oxyServices.getCurrentUserSubscription());
+    },
+    enabled: options?.enabled !== false && isAuthenticated && !!user?.id,
+    // Subscription state changes rarely; tolerate a longer fresh window.
+    staleTime: 5 * 60 * 1000,
+    // 5 minutes
+    gcTime: 30 * 60 * 1000 // 30 minutes
+  });
+};
+
+/**
+ * Get the current user's payment / billing history.
+ *
+ * Wraps `oxyServices.getUserPayments()` (`GET /payments/user`), which
+ * returns the user's `deposit` and `purchase` transactions newest-first.
+ */
+export const useUserPayments = options => {
+  const {
+    oxyServices,
+    isAuthenticated,
+    activeSessionId,
+    user
+  } = useOxy();
+  return useQuery({
+    queryKey: queryKeys.payments.history(user?.id),
+    queryFn: async () => {
+      return authenticatedApiCall(oxyServices, activeSessionId, () => oxyServices.getUserPayments());
+    },
+    enabled: options?.enabled !== false && isAuthenticated && !!user?.id,
+    // Billing history is append-mostly; a short fresh window is fine.
+    staleTime: 2 * 60 * 1000,
+    // 2 minutes
+    gcTime: 30 * 60 * 1000 // 30 minutes
+  });
+};
+
+/**
+ * Get the current user's FairCoin wallet balance.
+ *
+ * Wraps `oxyServices.getCurrentUserWallet()` (`GET /wallet/:userId`).
+ * Balance changes frequently, so the fresh window is intentionally short.
+ */
+export const useUserWallet = options => {
+  const {
+    oxyServices,
+    isAuthenticated,
+    activeSessionId,
+    user
+  } = useOxy();
+  return useQuery({
+    queryKey: queryKeys.payments.wallet(user?.id),
+    queryFn: async () => {
+      return authenticatedApiCall(oxyServices, activeSessionId, () => oxyServices.getCurrentUserWallet());
+    },
+    enabled: options?.enabled !== false && isAuthenticated && !!user?.id,
+    staleTime: 60 * 1000,
+    // 1 minute (balance moves often)
+    gcTime: 10 * 60 * 1000 // 10 minutes
+  });
+};
+
+/**
+ * Get the current user's wallet transaction history (paginated).
+ *
+ * Wraps `oxyServices.getCurrentUserWalletTransactions(options)`
+ * (`GET /wallet/transactions/:userId`). The API responds with a
+ * `{ data, pagination }` envelope, preserved here as
+ * `WalletTransactionsResponse`.
+ *
+ * @param params - Optional `limit` / `offset` pagination controls. These are
+ *   part of the query key, so distinct pages cache independently.
+ */
+export const useUserWalletTransactions = (params, options) => {
+  const {
+    oxyServices,
+    isAuthenticated,
+    activeSessionId,
+    user
+  } = useOxy();
+  const limit = params?.limit;
+  const offset = params?.offset;
+  return useQuery({
+    queryKey: queryKeys.payments.walletTransactions(limit, offset, user?.id),
+    queryFn: async () => {
+      return authenticatedApiCall(oxyServices, activeSessionId, () => oxyServices.getCurrentUserWalletTransactions({
+        limit,
+        offset
+      }));
+    },
+    enabled: options?.enabled !== false && isAuthenticated && !!user?.id,
+    staleTime: 60 * 1000,
+    // 1 minute (ledger updates frequently)
+    gcTime: 10 * 60 * 1000 // 10 minutes
+  });
+};
+//# sourceMappingURL=usePaymentQueries.js.map

package/lib/module/ui/hooks/queries/usePaymentQueries.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useQuery","authenticatedApiCall","queryKeys","useOxy","useUserSubscription","options","oxyServices","isAuthenticated","activeSessionId","user","queryKey","payments","subscription","id","queryFn","getCurrentUserSubscription","enabled","staleTime","gcTime","useUserPayments","history","getUserPayments","useUserWallet","wallet","getCurrentUserWallet","useUserWalletTransactions","params","limit","offset","walletTransactions","getCurrentUserWalletTransactions"],"sourceRoot":"../../../../../src","sources":["ui/hooks/queries/usePaymentQueries.ts"],"mappings":"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","ignoreList":[]}