@oxyhq/services 6.10.3 → 6.10.4

package/lib/typescript/module/ui/hooks/queries/paymentTypes.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Payment / wallet / subscription domain types.
+ *
+ * These model the JSON shapes the Oxy API actually returns for the
+ * payment-related read endpoints, so the corresponding query hooks
+ * (`useUserSubscription`, `useUserPayments`, `useUserWallet`,
+ * `useUserWalletTransactions`) expose precise types instead of `any`.
+ *
+ * Source of truth (API):
+ *  - Subscription:  GET /subscription/:userId   -> `Subscription` model JSON,
+ *                   or the fallback `{ plan: 'basic' }` when none exists.
+ *  - Payments:      GET /payments/user          -> `Payment[]` (sendSuccess).
+ *  - Wallet:        GET /wallet/:userId         -> `Wallet` (sendSuccess).
+ *  - Transactions:  GET /wallet/transactions/:userId
+ *                   -> `WalletTransactionsResponse` (sendPaginated envelope).
+ *
+ * All `Date` columns are serialized as ISO-8601 strings over the wire.
+ *
+ * Note: `@oxyhq/services` deliberately does NOT re-export these from
+ * `@oxyhq/core`. They live here because they describe the return shape of
+ * the services-layer query hooks; consumers that need core domain types
+ * import those directly from `@oxyhq/core`.
+ */
+/** Subscription tier. Mirrors the `plan` enum on the API `Subscription` model. */
+export type SubscriptionPlan = 'basic' | 'pro' | 'business';
+/** Lifecycle state of a subscription. */
+export type SubscriptionStatus = 'active' | 'canceled' | 'expired';
+/** Feature flags toggled by the active subscription plan. */
+export interface SubscriptionFeatures {
+    analytics: boolean;
+    premiumBadge: boolean;
+    unlimitedFollowing: boolean;
+    higherUploadLimits: boolean;
+    promotedPosts: boolean;
+    businessTools: boolean;
+}
+/**
+ * A user's subscription.
+ *
+ * When a user has never subscribed, the API returns the minimal fallback
+ * `{ plan: 'basic' }`; every other field is therefore optional so the type
+ * covers both the persisted document and the fallback.
+ */
+export interface Subscription {
+    plan: SubscriptionPlan;
+    status?: SubscriptionStatus;
+    /** Account this subscription belongs to (absent on the basic fallback). */
+    userId?: string;
+    /** ISO-8601 timestamp the current period started. */
+    startDate?: string;
+    /** ISO-8601 timestamp the current period ends / renews. */
+    endDate?: string;
+    autoRenew?: boolean;
+    paymentMethod?: string;
+    latestInvoice?: string;
+    features?: SubscriptionFeatures;
+    /** ISO-8601 creation timestamp. */
+    createdAt?: string;
+    /** ISO-8601 last-update timestamp. */
+    updatedAt?: string;
+}
+/**
+ * A billing / payment history entry, derived from `deposit` and `purchase`
+ * transactions on the API side (`GET /payments/user`).
+ */
+export interface Payment {
+    id: string;
+    userId: string;
+    type: string;
+    amount: number;
+    status: string;
+    description?: string;
+    itemId?: string;
+    itemType?: string;
+    /** ISO-8601 timestamp the payment was created (maps to `createdAt`). */
+    timestamp?: string;
+    /** ISO-8601 timestamp the payment settled, when applicable. */
+    completedAt?: string;
+}
+/** FairCoin wallet balance for a user (`GET /wallet/:userId`). */
+export interface Wallet {
+    userId: string;
+    balance: number;
+    /** On-chain withdrawal address, `null` until one is set. */
+    address: string | null;
+}
+/** Direction/category of a wallet transaction. */
+export type WalletTransactionType = 'deposit' | 'withdrawal' | 'transfer' | 'purchase';
+/** Settlement state of a wallet transaction. */
+export type WalletTransactionStatus = 'pending' | 'completed' | 'failed' | 'cancelled';
+/**
+ * A single wallet ledger entry returned by the transaction-history endpoint.
+ *
+ * The populated `userId` / `recipientId` may arrive either as a bare id
+ * string or as a `{ _id, username }` object depending on Mongoose
+ * population, so both shapes are modelled.
+ */
+export interface WalletTransaction {
+    id: string;
+    userId: string | {
+        _id: string;
+        username?: string;
+    };
+    type: WalletTransactionType;
+    amount: number;
+    status: WalletTransactionStatus;
+    description?: string;
+    recipientId?: string | {
+        _id: string;
+        username?: string;
+    } | null;
+    itemId?: string;
+    itemType?: string;
+    /** ISO-8601 creation timestamp (maps to `createdAt`). */
+    timestamp?: string;
+    /** ISO-8601 settlement timestamp, when applicable. */
+    completedAt?: string;
+}
+/** Pagination metadata attached to a paginated list response. */
+export interface WalletPagination {
+    total: number;
+    limit: number;
+    offset: number;
+    hasMore: boolean;
+}
+/**
+ * Paginated envelope returned by `GET /wallet/transactions/:userId`.
+ *
+ * The HTTP layer preserves the `{ data, pagination }` shape for paginated
+ * responses (it only unwraps the plain `{ data }` success envelope), so
+ * callers receive the list under `data`.
+ */
+export interface WalletTransactionsResponse {
+    data: WalletTransaction[];
+    pagination: WalletPagination;
+}
+//# sourceMappingURL=paymentTypes.d.ts.map

package/lib/typescript/module/ui/hooks/queries/paymentTypes.d.ts.map

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

package/lib/typescript/module/ui/hooks/queries/queryKeys.d.ts

@@ -50,6 +50,17 @@ export declare const queryKeys: {
         readonly recent: (limit: number) => readonly ["security", "recent", number];
         readonly infinite: (limit: number, eventType?: string) => readonly ["security", "infinite", number, string | undefined];
     };
+    readonly storage: {
+        readonly all: readonly ["storage"];
+        readonly usage: () => readonly ["storage", "usage"];
+    };
+    readonly payments: {
+        readonly all: readonly ["payments"];
+        readonly subscription: (userId?: string) => readonly ["payments", "subscription", string];
+        readonly history: (userId?: string) => readonly ["payments", "history", string];
+        readonly wallet: (userId?: string) => readonly ["payments", "wallet", string];
+        readonly walletTransactions: (limit?: number, offset?: number, userId?: string) => readonly ["payments", "wallet", string, "transactions", number | undefined, number | undefined];
+    };
 };
 /**
  * Helper to invalidate all account-related queries

package/lib/typescript/module/ui/hooks/queries/queryKeys.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queryKeys.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/hooks/queries/queryKeys.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAO,MAAM,SAAS;;;;oCAKC,MAAM,EAAE;;qCAEP,MAAM;;;;;;;iCASV,MAAM,EAAE;;kCAEP,MAAM;sCACF,MAAM;;;;;iCAOX,MAAM;;qCAEF,MAAM;;oCAEP,MAAM;;;;;iCAOT,MAAM;;oCAEH,MAAM;;;;qCAML,MAAM;;;;oCAMP,MAAM,WAAW,MAAM,cAAc,MAAM;iCAE9C,MAAM;mCAEJ,MAAM,cAAc,MAAM;;CAGtC,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,wBAAwB,GAAI,aAAa,GAAG,SAExD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAAI,aAAa,GAAG,SAErD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,GAAI,aAAa,GAAG,SAExD,CAAC"}
+{"version":3,"file":"queryKeys.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/hooks/queries/queryKeys.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAO,MAAM,SAAS;;;;oCAKC,MAAM,EAAE;;qCAEP,MAAM;;;;;;;iCASV,MAAM,EAAE;;kCAEP,MAAM;sCACF,MAAM;;;;;iCAOX,MAAM;;qCAEF,MAAM;;oCAEP,MAAM;;;;;iCAOT,MAAM;;oCAEH,MAAM;;;;qCAML,MAAM;;;;oCAMP,MAAM,WAAW,MAAM,cAAc,MAAM;iCAE9C,MAAM;mCAEJ,MAAM,cAAc,MAAM;;;;;;;;yCAapB,MAAM;oCAEX,MAAM;mCAEP,MAAM;8CAEK,MAAM,WAAW,MAAM,WAAW,MAAM;;CAU/D,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,wBAAwB,GAAI,aAAa,GAAG,SAExD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAAI,aAAa,GAAG,SAErD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,GAAI,aAAa,GAAG,SAExD,CAAC"}

package/lib/typescript/module/ui/hooks/queries/usePaymentQueries.d.ts

@@ -0,0 +1,63 @@
+import type { Subscription, Payment, Wallet, WalletTransactionsResponse } from './paymentTypes';
+/**
+ * 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`). Returns the persisted subscription or the
+ * API's `{ plan: 'basic' }` fallback when the user has never subscribed.
+ */
+export declare const useUserSubscription: (options?: {
+    enabled?: boolean;
+}) => import("@tanstack/react-query").UseQueryResult<NoInfer<Subscription>, Error>;
+/**
+ * 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 declare const useUserPayments: (options?: {
+    enabled?: boolean;
+}) => import("@tanstack/react-query").UseQueryResult<NoInfer<Payment[]>, Error>;
+/**
+ * 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 declare const useUserWallet: (options?: {
+    enabled?: boolean;
+}) => import("@tanstack/react-query").UseQueryResult<NoInfer<Wallet>, Error>;
+/**
+ * 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 declare const useUserWalletTransactions: (params?: {
+    limit?: number;
+    offset?: number;
+}, options?: {
+    enabled?: boolean;
+}) => import("@tanstack/react-query").UseQueryResult<NoInfer<WalletTransactionsResponse>, Error>;
+//# sourceMappingURL=usePaymentQueries.d.ts.map

package/lib/typescript/module/ui/hooks/queries/usePaymentQueries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePaymentQueries.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/hooks/queries/usePaymentQueries.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,YAAY,EACZ,OAAO,EACP,MAAM,EACN,0BAA0B,EAC3B,MAAM,gBAAgB,CAAC;AAExB;;;;;;;;;;;;;;;GAeG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAAI,UAAU;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,iFAiBlE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAI,UAAU;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,8EAiB9D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,UAAU;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,2EAgB5D,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,yBAAyB,GACpC,SAAS;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EAC5C,UAAU;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,+FAmBhC,CAAC"}

package/lib/typescript/module/ui/hooks/queries/useServicesQueries.d.ts

@@ -1,4 +1,4 @@
-import type { ClientSession } from '@oxyhq/core';
+import type { AccountStorageUsageResponse, ClientSession } from '@oxyhq/core';
 /**
  * Get all active sessions for the current user
  */
@@ -31,4 +31,14 @@ export declare const useSecurityInfo: (options?: {
 }) => import("@tanstack/react-query").UseQueryResult<NoInfer<{
     recoveryEmail: string | null;
 }>, Error>;
+/**
+ * Get account storage usage (server-aggregated usage across assets, mail,
+ * recordings, etc.). Wraps `oxyServices.getAccountStorageUsage()` in a
+ * TanStack query so consumers get caching, background refetch, and a
+ * consistent `isLoading` / `refetch` surface instead of hand-rolled
+ * `useEffect` fetches.
+ */
+export declare const useAccountStorageUsage: (options?: {
+    enabled?: boolean;
+}) => import("@tanstack/react-query").UseQueryResult<NoInfer<AccountStorageUsageResponse>, Error>;
 //# sourceMappingURL=useServicesQueries.d.ts.map

package/lib/typescript/module/ui/hooks/queries/useServicesQueries.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useServicesQueries.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/hooks/queries/useServicesQueries.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKjD;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,SAAS,MAAM,EAAE,UAAU;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,oFAqB3E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,GAAI,WAAW,MAAM,GAAG,IAAI,EAAE,UAAU;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,kFA6BnF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAU;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,0EAgBhE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,UAAU;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,0EAgB7D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,UAAU;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE;;UAY9D,CAAC"}
+{"version":3,"file":"useServicesQueries.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/hooks/queries/useServicesQueries.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,2BAA2B,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAK9E;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,SAAS,MAAM,EAAE,UAAU;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,oFAqB3E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,GAAI,WAAW,MAAM,GAAG,IAAI,EAAE,UAAU;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,kFA6BnF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAU;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,0EAgBhE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,UAAU;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,0EAgB7D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,UAAU;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE;;UAY9D,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GAAI,UAAU;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,gGAgBrE,CAAC"}

package/lib/typescript/module/ui/hooks/queryClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queryClient.d.ts","sourceRoot":"","sources":["../../../../../src/ui/hooks/queryClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,WAAW,EAA4C,MAAM,uBAAuB,CAAC;AAC9F,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,sCAAsC,CAAC;AAG9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAmEhE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,QAAO,WA6CpC,CAAC;AAEF,MAAM,WAAW,uBAAuB;IACtC,wEAAwE;IACxE,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,8DAA8D;IAC9D,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,GACjC,aAAa,WAAW,EACxB,SAAS,gBAAgB,GAAG,IAAI,GAAG,SAAS,KAC3C,uBA+BF,CAAC;AAMF;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAU,SAAS,gBAAgB,KAAG,OAAO,CAAC,IAAI,CAa7E,CAAC;AAEF;;GAEG;AACH,YAAY,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"queryClient.d.ts","sourceRoot":"","sources":["../../../../../src/ui/hooks/queryClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,WAAW,EAA4C,MAAM,uBAAuB,CAAC;AAC9F,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,sCAAsC,CAAC;AAG9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAoEhE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,QAAO,WA6CpC,CAAC;AAEF,MAAM,WAAW,uBAAuB;IACtC,wEAAwE;IACxE,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,8DAA8D;IAC9D,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,GACjC,aAAa,WAAW,EACxB,SAAS,gBAAgB,GAAG,IAAI,GAAG,SAAS,KAC3C,uBA+BF,CAAC;AAMF;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAU,SAAS,gBAAgB,KAAG,OAAO,CAAC,IAAI,CAa7E,CAAC;AAEF;;GAEG;AACH,YAAY,EAAE,eAAe,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxyhq/services",
-  "version": "6.10.3",
+  "version": "6.10.4",
   "description": "OxyHQ Expo/React Native SDK — UI components, screens, and native features",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",

package/src/index.ts

@@ -63,7 +63,16 @@ export {
   useUserById, useUserByUsername, useUsersBySessions,
   usePrivacySettings, useSessions, useSession,
   useDeviceSessions, useUserDevices, useSecurityInfo,
+  useAccountStorageUsage,
   useSecurityActivity, useRecentSecurityActivity, useInfiniteSecurityActivity,
+  useUserSubscription, useUserPayments, useUserWallet, useUserWalletTransactions,
+} from './ui/hooks/queries';
+
+// Payment / wallet / subscription domain types
+export type {
+  Subscription, SubscriptionPlan, SubscriptionStatus, SubscriptionFeatures,
+  Payment, Wallet, WalletTransaction, WalletTransactionType,
+  WalletTransactionStatus, WalletPagination, WalletTransactionsResponse,
 } from './ui/hooks/queries';
 
 // Mutation hooks

package/src/ui/hooks/queries/index.ts

@@ -16,13 +16,14 @@ export {
   usePrivacySettings,
 } from './useAccountQueries';
 
-// Service query hooks (sessions, devices, security)
+// Service query hooks (sessions, devices, security, storage)
 export {
   useSessions,
   useSession,
   useDeviceSessions,
   useUserDevices,
   useSecurityInfo,
+  useAccountStorageUsage,
 } from './useServicesQueries';
 
 // Security activity query hooks
@@ -32,6 +33,29 @@ export {
   useInfiniteSecurityActivity,
 } from './useSecurityQueries';
 
+// Payment / wallet / subscription query hooks
+export {
+  useUserSubscription,
+  useUserPayments,
+  useUserWallet,
+  useUserWalletTransactions,
+} from './usePaymentQueries';
+
+// Payment / wallet / subscription domain types
+export type {
+  Subscription,
+  SubscriptionPlan,
+  SubscriptionStatus,
+  SubscriptionFeatures,
+  Payment,
+  Wallet,
+  WalletTransaction,
+  WalletTransactionType,
+  WalletTransactionStatus,
+  WalletPagination,
+  WalletTransactionsResponse,
+} from './paymentTypes';
+
 // Query keys and invalidation helpers (for advanced usage)
 export { queryKeys, invalidateAccountQueries, invalidateUserQueries, invalidateSessionQueries } from './queryKeys';
 

package/src/ui/hooks/queries/paymentTypes.ts

@@ -0,0 +1,141 @@
+/**
+ * Payment / wallet / subscription domain types.
+ *
+ * These model the JSON shapes the Oxy API actually returns for the
+ * payment-related read endpoints, so the corresponding query hooks
+ * (`useUserSubscription`, `useUserPayments`, `useUserWallet`,
+ * `useUserWalletTransactions`) expose precise types instead of `any`.
+ *
+ * Source of truth (API):
+ *  - Subscription:  GET /subscription/:userId   -> `Subscription` model JSON,
+ *                   or the fallback `{ plan: 'basic' }` when none exists.
+ *  - Payments:      GET /payments/user          -> `Payment[]` (sendSuccess).
+ *  - Wallet:        GET /wallet/:userId         -> `Wallet` (sendSuccess).
+ *  - Transactions:  GET /wallet/transactions/:userId
+ *                   -> `WalletTransactionsResponse` (sendPaginated envelope).
+ *
+ * All `Date` columns are serialized as ISO-8601 strings over the wire.
+ *
+ * Note: `@oxyhq/services` deliberately does NOT re-export these from
+ * `@oxyhq/core`. They live here because they describe the return shape of
+ * the services-layer query hooks; consumers that need core domain types
+ * import those directly from `@oxyhq/core`.
+ */
+
+/** Subscription tier. Mirrors the `plan` enum on the API `Subscription` model. */
+export type SubscriptionPlan = 'basic' | 'pro' | 'business';
+
+/** Lifecycle state of a subscription. */
+export type SubscriptionStatus = 'active' | 'canceled' | 'expired';
+
+/** Feature flags toggled by the active subscription plan. */
+export interface SubscriptionFeatures {
+  analytics: boolean;
+  premiumBadge: boolean;
+  unlimitedFollowing: boolean;
+  higherUploadLimits: boolean;
+  promotedPosts: boolean;
+  businessTools: boolean;
+}
+
+/**
+ * A user's subscription.
+ *
+ * When a user has never subscribed, the API returns the minimal fallback
+ * `{ plan: 'basic' }`; every other field is therefore optional so the type
+ * covers both the persisted document and the fallback.
+ */
+export interface Subscription {
+  plan: SubscriptionPlan;
+  status?: SubscriptionStatus;
+  /** Account this subscription belongs to (absent on the basic fallback). */
+  userId?: string;
+  /** ISO-8601 timestamp the current period started. */
+  startDate?: string;
+  /** ISO-8601 timestamp the current period ends / renews. */
+  endDate?: string;
+  autoRenew?: boolean;
+  paymentMethod?: string;
+  latestInvoice?: string;
+  features?: SubscriptionFeatures;
+  /** ISO-8601 creation timestamp. */
+  createdAt?: string;
+  /** ISO-8601 last-update timestamp. */
+  updatedAt?: string;
+}
+
+/**
+ * A billing / payment history entry, derived from `deposit` and `purchase`
+ * transactions on the API side (`GET /payments/user`).
+ */
+export interface Payment {
+  id: string;
+  userId: string;
+  type: string;
+  amount: number;
+  status: string;
+  description?: string;
+  itemId?: string;
+  itemType?: string;
+  /** ISO-8601 timestamp the payment was created (maps to `createdAt`). */
+  timestamp?: string;
+  /** ISO-8601 timestamp the payment settled, when applicable. */
+  completedAt?: string;
+}
+
+/** FairCoin wallet balance for a user (`GET /wallet/:userId`). */
+export interface Wallet {
+  userId: string;
+  balance: number;
+  /** On-chain withdrawal address, `null` until one is set. */
+  address: string | null;
+}
+
+/** Direction/category of a wallet transaction. */
+export type WalletTransactionType = 'deposit' | 'withdrawal' | 'transfer' | 'purchase';
+
+/** Settlement state of a wallet transaction. */
+export type WalletTransactionStatus = 'pending' | 'completed' | 'failed' | 'cancelled';
+
+/**
+ * A single wallet ledger entry returned by the transaction-history endpoint.
+ *
+ * The populated `userId` / `recipientId` may arrive either as a bare id
+ * string or as a `{ _id, username }` object depending on Mongoose
+ * population, so both shapes are modelled.
+ */
+export interface WalletTransaction {
+  id: string;
+  userId: string | { _id: string; username?: string };
+  type: WalletTransactionType;
+  amount: number;
+  status: WalletTransactionStatus;
+  description?: string;
+  recipientId?: string | { _id: string; username?: string } | null;
+  itemId?: string;
+  itemType?: string;
+  /** ISO-8601 creation timestamp (maps to `createdAt`). */
+  timestamp?: string;
+  /** ISO-8601 settlement timestamp, when applicable. */
+  completedAt?: string;
+}
+
+/** Pagination metadata attached to a paginated list response. */
+export interface WalletPagination {
+  total: number;
+  limit: number;
+  offset: number;
+  hasMore: boolean;
+}
+
+/**
+ * Paginated envelope returned by `GET /wallet/transactions/:userId`.
+ *
+ * The HTTP layer preserves the `{ data, pagination }` shape for paginated
+ * responses (it only unwraps the plain `{ data }` success envelope), so
+ * callers receive the list under `data`.
+ */
+export interface WalletTransactionsResponse {
+  data: WalletTransaction[];
+  pagination: WalletPagination;
+}

package/src/ui/hooks/queries/queryKeys.ts

@@ -65,6 +65,32 @@ export const queryKeys = {
     infinite: (limit: number, eventType?: string) =>
       [...queryKeys.security.all, 'infinite', limit, eventType] as const,
   },
+
+  // Storage usage queries
+  storage: {
+    all: ['storage'] as const,
+    usage: () => [...queryKeys.storage.all, 'usage'] as const,
+  },
+
+  // Payment / wallet / subscription queries
+  payments: {
+    all: ['payments'] as const,
+    subscription: (userId?: string) =>
+      [...queryKeys.payments.all, 'subscription', userId || 'current'] as const,
+    history: (userId?: string) =>
+      [...queryKeys.payments.all, 'history', userId || 'current'] as const,
+    wallet: (userId?: string) =>
+      [...queryKeys.payments.all, 'wallet', userId || 'current'] as const,
+    walletTransactions: (limit?: number, offset?: number, userId?: string) =>
+      [
+        ...queryKeys.payments.all,
+        'wallet',
+        userId || 'current',
+        'transactions',
+        limit,
+        offset,
+      ] as const,
+  },
 } as const;
 
 /**

package/src/ui/hooks/queries/usePaymentQueries.ts

@@ -0,0 +1,136 @@
+import { useQuery } from '@tanstack/react-query';
+import { authenticatedApiCall } from '@oxyhq/core';
+import { queryKeys } from './queryKeys';
+import { useOxy } from '../../context/OxyContext';
+import type {
+  Subscription,
+  Payment,
+  Wallet,
+  WalletTransactionsResponse,
+} from './paymentTypes';
+
+/**
+ * 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`). Returns the persisted subscription or the
+ * API's `{ plan: 'basic' }` fallback when the user has never subscribed.
+ */
+export const useUserSubscription = (options?: { enabled?: boolean }) => {
+  const { oxyServices, isAuthenticated, activeSessionId } = useOxy();
+
+  return useQuery({
+    queryKey: queryKeys.payments.subscription(),
+    queryFn: async () => {
+      return authenticatedApiCall<Subscription>(
+        oxyServices,
+        activeSessionId,
+        () => oxyServices.getCurrentUserSubscription(),
+      );
+    },
+    enabled: (options?.enabled !== false) && isAuthenticated,
+    // 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?: { enabled?: boolean }) => {
+  const { oxyServices, isAuthenticated, activeSessionId } = useOxy();
+
+  return useQuery({
+    queryKey: queryKeys.payments.history(),
+    queryFn: async () => {
+      return authenticatedApiCall<Payment[]>(
+        oxyServices,
+        activeSessionId,
+        () => oxyServices.getUserPayments(),
+      );
+    },
+    enabled: (options?.enabled !== false) && isAuthenticated,
+    // 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?: { enabled?: boolean }) => {
+  const { oxyServices, isAuthenticated, activeSessionId } = useOxy();
+
+  return useQuery({
+    queryKey: queryKeys.payments.wallet(),
+    queryFn: async () => {
+      return authenticatedApiCall<Wallet>(
+        oxyServices,
+        activeSessionId,
+        () => oxyServices.getCurrentUserWallet(),
+      );
+    },
+    enabled: (options?.enabled !== false) && isAuthenticated,
+    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?: { limit?: number; offset?: number },
+  options?: { enabled?: boolean },
+) => {
+  const { oxyServices, isAuthenticated, activeSessionId } = useOxy();
+  const limit = params?.limit;
+  const offset = params?.offset;
+
+  return useQuery({
+    queryKey: queryKeys.payments.walletTransactions(limit, offset),
+    queryFn: async () => {
+      return authenticatedApiCall<WalletTransactionsResponse>(
+        oxyServices,
+        activeSessionId,
+        () => oxyServices.getCurrentUserWalletTransactions({ limit, offset }),
+      );
+    },
+    enabled: (options?.enabled !== false) && isAuthenticated,
+    staleTime: 60 * 1000, // 1 minute (ledger updates frequently)
+    gcTime: 10 * 60 * 1000, // 10 minutes
+  });
+};