@oxyhq/services 5.27.0 → 6.0.1

package/dist/web/types/utils/requestUtils.d.ts

@@ -1,123 +0,0 @@
-/**
- * Request utilities for HTTP clients
- *
- * Provides reusable components for request deduplication, queuing, and logging
- */
-/**
- * Request deduplication - prevents duplicate concurrent requests
- *
- * When multiple requests with the same key are made simultaneously,
- * only one request is executed and all callers receive the same result.
- *
- * @example
- * ```typescript
- * const deduplicator = new RequestDeduplicator();
- *
- * // Multiple calls with same key will share the same promise
- * const promise1 = deduplicator.deduplicate('user-123', () => fetchUser('123'));
- * const promise2 = deduplicator.deduplicate('user-123', () => fetchUser('123'));
- * // promise1 === promise2, only one API call is made
- * ```
- */
-export declare class RequestDeduplicator {
-    private pendingRequests;
-    /**
-     * Deduplicate a request by key
-     * @param key Unique key for the request
-     * @param requestFn Function that returns a promise
-     * @returns Promise that will be shared if key already exists
-     */
-    deduplicate<T>(key: string, requestFn: () => Promise<T>): Promise<T>;
-    /**
-     * Clear all pending requests
-     */
-    clear(): void;
-    /**
-     * Get number of pending requests
-     */
-    size(): number;
-}
-/**
- * Request queue with concurrency control
- *
- * Limits the number of concurrent requests and queues excess requests.
- * Useful for rate limiting and preventing request flooding.
- *
- * @example
- * ```typescript
- * const queue = new RequestQueue(5, 100); // Max 5 concurrent, queue up to 100
- *
- * // All requests will be queued and processed with max 5 concurrent
- * await queue.enqueue(() => fetchUser('1'));
- * await queue.enqueue(() => fetchUser('2'));
- * // ...
- * ```
- */
-export declare class RequestQueue {
-    private queue;
-    private running;
-    private maxConcurrent;
-    private maxQueueSize;
-    /**
-     * Create a new request queue
-     * @param maxConcurrent Maximum number of concurrent requests (default: 10)
-     * @param maxQueueSize Maximum queue size (default: 100)
-     */
-    constructor(maxConcurrent?: number, maxQueueSize?: number);
-    /**
-     * Enqueue a request
-     * @param requestFn Function that returns a promise
-     * @returns Promise that resolves when request completes
-     */
-    enqueue<T>(requestFn: () => Promise<T>): Promise<T>;
-    /**
-     * Process queued requests
-     */
-    private process;
-    /**
-     * Clear all queued requests
-     */
-    clear(): void;
-    /**
-     * Get queue size
-     */
-    size(): number;
-    /**
-     * Get number of currently running requests
-     */
-    runningCount(): number;
-}
-/** Log level type for SimpleLogger */
-export type LogLevel = 'none' | 'error' | 'warn' | 'info' | 'debug';
-/**
- * Simple logger with level support
- *
- * Lightweight logger for HTTP clients and utilities.
- * For more advanced logging, use loggerUtils.ts
- *
- * @example
- * ```typescript
- * const logger = new SimpleLogger(true, 'debug');
- * logger.debug('Debug message');
- * logger.info('Info message');
- * logger.error('Error message');
- * ```
- */
-export declare class SimpleLogger {
-    private enabled;
-    private level;
-    private prefix;
-    /**
-     * Create a new simple logger
-     * @param enabled Whether logging is enabled
-     * @param level Minimum log level
-     * @param prefix Prefix for log messages (default: '')
-     */
-    constructor(enabled?: boolean, level?: LogLevel, prefix?: string);
-    private shouldLog;
-    private formatMessage;
-    error(...args: any[]): void;
-    warn(...args: any[]): void;
-    info(...args: any[]): void;
-    debug(...args: any[]): void;
-}

package/dist/web/types/utils/sessionUtils.d.ts

@@ -1,54 +0,0 @@
-/**
- * Session management utilities
- *
- * Provides consistent session normalization, deduplication, and sorting
- * to ensure sessions are always displayed in a predictable order.
- */
-import type { ClientSession } from '../models/session';
-/**
- * Normalize a session to ensure all required fields are present
- */
-export declare function normalizeSession(session: Partial<ClientSession> & {
-    sessionId: string;
-}): ClientSession;
-/**
- * Compare two sessions for equality
- */
-export declare function sessionsEqual(a: ClientSession, b: ClientSession): boolean;
-/**
- * Sort sessions by lastActive (most recent first), then by sessionId for stability
- */
-export declare function sortSessions(sessions: ClientSession[]): ClientSession[];
-/**
- * Deduplicate sessions by sessionId, keeping the most recent version
- */
-export declare function deduplicateSessions(sessions: ClientSession[]): ClientSession[];
-/**
- * Deduplicate sessions by userId, keeping only one session per user
- * Priority: 1) Active session (if provided), 2) Most recent session
- * This prevents showing duplicate accounts for the same user
- */
-export declare function deduplicateSessionsByUserId(sessions: ClientSession[], activeSessionId?: string | null): ClientSession[];
-/**
- * Normalize, deduplicate, and sort sessions
- * This ensures consistent session ordering across the application
- *
- * @param sessions - Array of sessions to normalize
- * @param activeSessionId - Optional active session ID to prioritize
- * @param deduplicateByUserId - If true, deduplicate by userId (one account per user). Default: true
- */
-export declare function normalizeAndSortSessions(sessions: ClientSession[], activeSessionId?: string | null, deduplicateByUserId?: boolean): ClientSession[];
-/**
- * Merge two session arrays, prioritizing newer data
- * Returns normalized, deduplicated, and sorted sessions
- *
- * @param existing - Existing sessions array
- * @param incoming - New sessions to merge in
- * @param activeSessionId - Optional active session ID to prioritize
- * @param deduplicateByUserId - If true, deduplicate by userId (one account per user). Default: true
- */
-export declare function mergeSessions(existing: ClientSession[], incoming: ClientSession[], activeSessionId?: string | null, deduplicateByUserId?: boolean): ClientSession[];
-/**
- * Check if two session arrays are equal (same sessionIds in same order)
- */
-export declare function sessionsArraysEqual(a: ClientSession[], b: ClientSession[]): boolean;

package/dist/web/types/utils/validationUtils.d.ts

@@ -1,85 +0,0 @@
-/**
- * Validation utilities for common data validation patterns
- */
-/**
- * Email validation regex
- */
-export declare const EMAIL_REGEX: RegExp;
-/**
- * Username validation regex (alphanumeric, underscores, and hyphens, 3-30 chars)
- */
-export declare const USERNAME_REGEX: RegExp;
-/**
- * Password validation regex (at least 8 chars, 1 uppercase, 1 lowercase, 1 number)
- */
-export declare const PASSWORD_REGEX: RegExp;
-/**
- * Validate email format
- */
-export declare function isValidEmail(email: string): boolean;
-/**
- * Validate username format
- */
-export declare function isValidUsername(username: string): boolean;
-/**
- * Validate password strength
- */
-export declare function isValidPassword(password: string): boolean;
-/**
- * Validate required string
- */
-export declare function isRequiredString(value: unknown): boolean;
-/**
- * Validate required number
- */
-export declare function isRequiredNumber(value: unknown): boolean;
-/**
- * Validate required boolean
- */
-export declare function isRequiredBoolean(value: unknown): boolean;
-/**
- * Validate array
- */
-export declare function isValidArray(value: unknown): boolean;
-/**
- * Validate object
- */
-export declare function isValidObject(value: unknown): boolean;
-/**
- * Validate UUID format
- */
-export declare function isValidUUID(uuid: string): boolean;
-/**
- * Validate URL format
- */
-export declare function isValidURL(url: string): boolean;
-/**
- * Validate date string
- */
-export declare function isValidDate(dateString: string): boolean;
-/**
- * Validate file size (in bytes)
- */
-export declare function isValidFileSize(size: number, maxSize: number): boolean;
-/**
- * Validate file type
- */
-export declare function isValidFileType(filename: string, allowedTypes: string[]): boolean;
-/**
- * Sanitize string input
- */
-export declare function sanitizeString(input: string): string;
-/**
- * Sanitize HTML input
- */
-export declare function sanitizeHTML(input: string): string;
-/**
- * Validate MongoDB ObjectId format
- * Note: This is a basic format check. For full validation, use mongoose.Types.ObjectId.isValid()
- * This function works in environments where mongoose may not be available (e.g., client-side)
- */
-export declare function isValidObjectId(id: string): boolean;
-/**
- * Validate and sanitize user input
- */
-export declare function validateAndSanitizeUserInput(input: unknown, type: 'string' | 'email' | 'username'): string | null;

package/dist/web/types/web/WebOxyContext.d.ts

@@ -1,151 +0,0 @@
-/**
- * Web-Only Oxy Context
- *
- * Clean implementation with ZERO React Native dependencies.
- * Provides FedCM, popup, and redirect authentication methods.
- * Uses centralized AuthManager for token and session management.
- *
- * @module web/WebOxyContext
- */
-import { type ReactNode } from 'react';
-import { OxyServices } from '../core/OxyServices';
-import { CrossDomainAuth } from '../core/CrossDomainAuth';
-import { AuthManager } from '../core/AuthManager';
-import type { User } from '../models/interfaces';
-export interface WebAuthState {
-    user: User | null;
-    isAuthenticated: boolean;
-    isLoading: boolean;
-    error: string | null;
-}
-export interface WebAuthActions {
-    /**
-     * Sign in using the best available method (FedCM → Popup → Redirect)
-     */
-    signIn: () => Promise<void>;
-    /**
-     * Sign in using FedCM (browser-native, Google-style)
-     * Falls back to popup if FedCM is not supported
-     */
-    signInWithFedCM: () => Promise<void>;
-    /**
-     * Sign in using popup window
-     */
-    signInWithPopup: () => Promise<void>;
-    /**
-     * Sign in using redirect (full page redirect to auth.oxy.so)
-     */
-    signInWithRedirect: () => void;
-    /**
-     * Sign out and clear session
-     */
-    signOut: () => Promise<void>;
-    /**
-     * Check if FedCM is supported in the current browser
-     */
-    isFedCMSupported: () => boolean;
-}
-export interface WebOxyContextValue extends WebAuthState, WebAuthActions {
-    oxyServices: OxyServices;
-    crossDomainAuth: CrossDomainAuth;
-    authManager: AuthManager;
-}
-export interface WebOxyProviderProps {
-    children: ReactNode;
-    /** Base URL for the Oxy API (e.g., 'https://api.oxy.so') */
-    baseURL: string;
-    /** Optional auth web URL for popup/redirect (defaults to 'https://auth.oxy.so') */
-    authWebUrl?: string;
-    /** Callback when auth state changes */
-    onAuthStateChange?: (user: User | null) => void;
-    /** Callback when an error occurs */
-    onError?: (error: Error) => void;
-    /** Preferred auth method: 'auto' (default), 'fedcm', 'popup', or 'redirect' */
-    preferredAuthMethod?: 'auto' | 'fedcm' | 'popup' | 'redirect';
-    /** Skip automatic session check on mount */
-    skipAutoCheck?: boolean;
-}
-/**
- * Web-only Oxy Provider
- *
- * Provides authentication context for pure web applications (React, Next.js, Vite).
- * Supports FedCM, popup, and redirect authentication methods.
- *
- * @example
- * ```tsx
- * import { WebOxyProvider, useAuth } from '@oxyhq/services/web';
- *
- * function App() {
- *   return (
- *     <WebOxyProvider baseURL="https://api.oxy.so">
- *       <YourApp />
- *     </WebOxyProvider>
- *   );
- * }
- *
- * function LoginButton() {
- *   const { signIn, isLoading, isFedCMSupported } = useAuth();
- *   return (
- *     <button onClick={signIn} disabled={isLoading}>
- *       {isFedCMSupported() ? 'Sign in with Oxy' : 'Sign in'}
- *     </button>
- *   );
- * }
- * ```
- */
-export declare function WebOxyProvider({ children, baseURL, authWebUrl, onAuthStateChange, onError, preferredAuthMethod, skipAutoCheck, }: WebOxyProviderProps): import("react/jsx-runtime").JSX.Element;
-/**
- * Hook to access the full Web Oxy context.
- *
- * @returns Full context value including oxyServices and crossDomainAuth
- * @throws Error if used outside WebOxyProvider
- */
-export declare function useWebOxy(): WebOxyContextValue;
-/**
- * Hook for authentication in web apps.
- *
- * Provides a simplified interface for common auth operations.
- *
- * @returns Auth state and actions
- * @throws Error if used outside WebOxyProvider
- *
- * @example
- * ```tsx
- * function LoginPage() {
- *   const { user, isAuthenticated, isLoading, signIn, signOut, isFedCMSupported } = useAuth();
- *
- *   if (isLoading) return <Spinner />;
- *
- *   if (isAuthenticated) {
- *     return (
- *       <div>
- *         <p>Welcome, {user.username}!</p>
- *         <button onClick={signOut}>Sign Out</button>
- *       </div>
- *     );
- *   }
- *
- *   return (
- *     <button onClick={signIn}>
- *       {isFedCMSupported() ? 'Sign in with Oxy' : 'Sign in'}
- *     </button>
- *   );
- * }
- * ```
- */
-export declare function useAuth(): {
-    user: User | null;
-    isAuthenticated: boolean;
-    isLoading: boolean;
-    isReady: boolean;
-    error: string | null;
-    signIn: () => Promise<void>;
-    signInWithFedCM: () => Promise<void>;
-    signInWithPopup: () => Promise<void>;
-    signInWithRedirect: () => void;
-    signOut: () => Promise<void>;
-    isFedCMSupported: () => boolean;
-    oxyServices: OxyServices;
-    authManager: AuthManager;
-};
-export default WebOxyProvider;

package/dist/web/types/web/index.d.ts

@@ -1,52 +0,0 @@
-/**
- * @oxyhq/services/web - Web-Only Module
- *
- * Clean, professional web module with ZERO React Native dependencies.
- * Perfect for Next.js, Vite, Create React App, and other pure React web apps.
- *
- * Features:
- * - WebOxyProvider for React context
- * - useAuth hook for authentication
- * - Cross-domain SSO via FedCM, popup, or redirect
- * - Full TypeScript support
- * - Zero bundler configuration needed
- *
- * Usage:
- * ```tsx
- * import { WebOxyProvider, useAuth } from '@oxyhq/services/web';
- *
- * function App() {
- *   return (
- *     <WebOxyProvider baseURL="https://api.oxy.so">
- *       <YourApp />
- *     </WebOxyProvider>
- *   );
- * }
- *
- * function YourApp() {
- *   const { user, isAuthenticated, signIn, signOut, isFedCMSupported } = useAuth();
- *
- *   return (
- *     <button onClick={signIn}>
- *       {isFedCMSupported() ? 'Sign in with Oxy' : 'Sign in'}
- *     </button>
- *   );
- * }
- * ```
- */
-export { OxyServices, OxyAuthenticationError, OxyAuthenticationTimeoutError, OXY_CLOUD_URL, oxyClient, CrossDomainAuth, createCrossDomainAuth, DeviceManager, AuthManager, createAuthManager, } from '../core';
-export type { CrossDomainAuthOptions, DeviceFingerprint, StoredDeviceInfo, StorageAdapter, AuthStateChangeCallback, AuthMethod, AuthManagerConfig, } from '../core';
-export { WebOxyProvider, useWebOxy, useAuth, } from './WebOxyContext';
-export type { WebOxyProviderProps, WebAuthState, WebAuthActions, WebOxyContextValue, } from './WebOxyContext';
-export { darkenColor, lightenColor, hexToRgb, rgbToHex, withOpacity, isLightColor, getContrastTextColor, } from '../shared/utils/colorUtils';
-export { normalizeTheme, normalizeColorScheme, getOppositeTheme, systemPrefersDarkMode, getSystemColorScheme, } from '../shared/utils/themeUtils';
-export type { ThemeValue } from '../shared/utils/themeUtils';
-export { HttpStatus, getErrorStatus, getErrorMessage, isAlreadyRegisteredError, isUnauthorizedError, isForbiddenError, isNotFoundError, isRateLimitError, isServerError, isNetworkError, isRetryableError, } from '../shared/utils/errorUtils';
-export { delay, withRetry, } from '../shared/utils/networkUtils';
-export type { User, ApiError, Notification, FileMetadata, AssetUploadProgress, PaymentMethod, KarmaLeaderboardEntry, KarmaRule, Transaction, DeviceSession, LoginResponse, } from '../models/interfaces';
-export type { SessionLoginResponse } from '../models/session';
-export type { ClientSession, MinimalUserData } from '../models/session';
-export { SUPPORTED_LANGUAGES, getLanguageMetadata, getLanguageName, getNativeLanguageName, normalizeLanguageCode, } from '../utils/languageUtils';
-export type { LanguageMetadata } from '../utils/languageUtils';
-import { WebOxyProvider } from './WebOxyContext';
-export default WebOxyProvider;

package/dist/web/types/web.d.ts

@@ -1,53 +0,0 @@
-/**
- * OxyHQServices Web Entry Point - Pure React/Next.js Apps
- *
- * This entry point is optimized for pure web applications without Expo or React Native.
- * It excludes all React Native dependencies for a smaller bundle size.
- *
- * Use this for:
- * - Pure React apps (Vite, Create React App)
- * - Next.js apps
- * - Any web-only application
- *
- * For Expo apps (native + web), use the main entry point instead:
- * import { OxyProvider } from '@oxyhq/services';
- */
-import './crypto/polyfill';
-export { OxyServices, OxyAuthenticationError, OxyAuthenticationTimeoutError } from './core';
-export { OXY_CLOUD_URL, oxyClient } from './core';
-export { CrossDomainAuth, createCrossDomainAuth } from './core';
-export type { CrossDomainAuthOptions } from './core';
-export { KeyManager, SignatureService, RecoveryPhraseService } from './crypto';
-export type { KeyPair, SignedMessage, AuthChallenge, RecoveryPhraseResult } from './crypto';
-export { useOxy } from './ui/context/OxyContext';
-export { useAuth } from './ui/hooks/useAuth';
-export type { AuthState, AuthActions, UseAuthReturn } from './ui/hooks/useAuth';
-export { default as WebOxyProvider } from './ui/components/WebOxyProvider';
-export { DeviceManager } from './utils/deviceManager';
-export type { DeviceFingerprint, StoredDeviceInfo } from './utils/deviceManager';
-export { SUPPORTED_LANGUAGES, getLanguageMetadata, getLanguageName, getNativeLanguageName, normalizeLanguageCode } from './utils/languageUtils';
-export type { LanguageMetadata } from './utils/languageUtils';
-export type { OxyConfig, User, LoginResponse, Notification, Wallet, Transaction, TransferFundsRequest, PurchaseRequest, WithdrawalRequest, TransactionResponse, KarmaRule, KarmaHistory, KarmaLeaderboardEntry, KarmaAwardRequest, ApiError, PaymentMethod, PaymentRequest, PaymentResponse, AnalyticsData, FollowerDetails, ContentViewer, FileMetadata, FileUploadResponse, FileListResponse, FileUpdateRequest, FileDeleteResponse, DeviceSession, DeviceSessionsResponse, DeviceSessionLogoutResponse, UpdateDeviceNameResponse, BlockedUser, RestrictedUser, FileVisibility, AssetLink, AssetVariant, Asset, AssetInitRequest, AssetInitResponse, AssetCompleteRequest, AssetLinkRequest, AssetUnlinkRequest, AssetUrlResponse, AssetDeleteSummary, AssetUploadProgress, AssetUpdateVisibilityRequest, AssetUpdateVisibilityResponse, AccountStorageCategoryUsage, AccountStorageUsageResponse, SecurityEventType, SecurityEventSeverity, SecurityActivity, SecurityActivityResponse } from './models/interfaces';
-export { SECURITY_EVENT_SEVERITY_MAP } from './models/interfaces';
-export type { SessionLoginResponse, ClientSession, MinimalUserData } from './models/session';
-export { useAuthStore } from './ui/stores/authStore';
-export { useAssetStore, useAssets as useAssetsStore, useAsset, useUploadProgress, useAssetLoading, useAssetErrors, useAssetsByApp, useAssetsByEntity, useAssetUsageCount, useIsAssetLinked } from './ui/stores/assetStore';
-export { useSessionSocket } from './ui/hooks/useSessionSocket';
-export { useAssets, setOxyAssetInstance } from './ui/hooks/useAssets';
-export { useFileDownloadUrl, setOxyFileUrlInstance } from './ui/hooks/useFileDownloadUrl';
-export { useUserProfile, useUserProfiles, useCurrentUser, useUserById, useUserByUsername, useUsersBySessions, usePrivacySettings, useSessions, useSession, useDeviceSessions, useUserDevices, useSecurityInfo, useSecurityActivity, useRecentSecurityActivity, } from './ui/hooks/queries';
-export { useUpdateProfile, useUploadAvatar, useUpdateAccountSettings, useUpdatePrivacySettings, useUploadFile, useSwitchSession, useLogoutSession, useLogoutAll, useUpdateDeviceName, useRemoveDevice, } from './ui/hooks/mutations';
-export { createProfileMutation, createGenericMutation, } from './ui/hooks/mutations/mutationFactory';
-export type { ProfileMutationConfig, GenericMutationConfig, } from './ui/hooks/mutations/mutationFactory';
-export { ensureValidToken, withAuthErrorHandling, authenticatedApiCall, isAuthenticationError, SessionSyncRequiredError, AuthenticationFailedError, } from './ui/utils/authHelpers';
-export type { HandleApiErrorOptions } from './ui/utils/authHelpers';
-export { useFileFiltering } from './ui/hooks/useFileFiltering';
-export type { ViewMode, SortBy, SortOrder } from './ui/hooks/useFileFiltering';
-export * from './utils/apiUtils';
-export { ErrorCodes, createApiError, handleHttpError, validateRequiredFields, } from './utils/errorUtils';
-export { retryAsync } from './utils/asyncUtils';
-export * from './utils/validationUtils';
-export { logger, LogLevel, logAuth, logApi, logSession, logUser, logDevice, logPayment, logPerformance } from './utils/loggerUtils';
-export type { LogContext } from './utils/loggerUtils';
-export * from './utils/asyncUtils';
-export * from './utils/hookUtils';

package/lib/commonjs/constants/version.js

@@ -1,28 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.version = exports.packageInfo = exports.name = exports.description = void 0;
-/**
- * Package version and metadata constants
- * This file is auto-generated to avoid runtime dependency on package.json
- */
-
-const packageInfo = exports.packageInfo = {
-  name: "@oxyhq/services",
-  version: "5.2.1",
-  description: "Reusable OxyHQ module to handle authentication, user management, karma system and more 🚀",
-  main: "lib/commonjs/node/index.js",
-  module: "lib/module/node/index.js",
-  types: "lib/typescript/node/index.d.ts"
-};
-const {
-  name,
-  version,
-  description
-} = packageInfo;
-exports.description = description;
-exports.version = version;
-exports.name = name;
-//# sourceMappingURL=version.js.map

package/lib/commonjs/constants/version.js.map

@@ -1 +0,0 @@
-{"version":3,"names":["packageInfo","exports","name","version","description","main","module","types"],"sourceRoot":"../../../src","sources":["constants/version.ts"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;;AAEO,MAAMA,WAAW,GAAAC,OAAA,CAAAD,WAAA,GAAG;EACvBE,IAAI,EAAE,iBAAiB;EACvBC,OAAO,EAAE,OAAO;EAChBC,WAAW,EAAE,2FAA2F;EACxGC,IAAI,EAAE,4BAA4B;EAClCC,MAAM,EAAE,0BAA0B;EAClCC,KAAK,EAAE;AACX,CAAU;AAEH,MAAM;EAAEL,IAAI;EAAEC,OAAO;EAAEC;AAAY,CAAC,GAAGJ,WAAW;AAACC,OAAA,CAAAG,WAAA,GAAAA,WAAA;AAAAH,OAAA,CAAAE,OAAA,GAAAA,OAAA;AAAAF,OAAA,CAAAC,IAAA,GAAAA,IAAA","ignoreList":[]}