@oxyhq/services 5.26.4 → 5.27.0

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

@@ -0,0 +1,415 @@
+export interface OxyConfig {
+    baseURL: string;
+    cloudURL?: string;
+    authWebUrl?: string;
+    authRedirectUri?: string;
+    enableCache?: boolean;
+    cacheTTL?: number;
+    enableRequestDeduplication?: boolean;
+    enableRetry?: boolean;
+    maxRetries?: number;
+    retryDelay?: number;
+    requestTimeout?: number;
+    maxConcurrentRequests?: number;
+    requestQueueSize?: number;
+    enableLogging?: boolean;
+    logLevel?: 'none' | 'error' | 'warn' | 'info' | 'debug';
+    onRequestStart?: (url: string, method: string) => void;
+    onRequestEnd?: (url: string, method: string, duration: number, success: boolean) => void;
+    onRequestError?: (url: string, method: string, error: Error) => void;
+}
+export interface User {
+    id: string;
+    publicKey: string;
+    username: string;
+    email?: string;
+    avatar?: string;
+    privacySettings?: {
+        [key: string]: unknown;
+    };
+    name?: {
+        first?: string;
+        last?: string;
+        full?: string;
+        [key: string]: unknown;
+    };
+    bio?: string;
+    karma?: number;
+    location?: string;
+    website?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    links?: Array<{
+        title?: string;
+        description?: string;
+        image?: string;
+        link: string;
+    }>;
+    _count?: {
+        followers?: number;
+        following?: number;
+    };
+    accountExpiresAfterInactivityDays?: number | null;
+    [key: string]: unknown;
+}
+export interface LoginResponse {
+    accessToken?: string;
+    refreshToken?: string;
+    token?: string;
+    user: User;
+    message?: string;
+}
+export interface Notification {
+    id: string;
+    message: string;
+}
+export interface Wallet {
+    id: string;
+    balance: number;
+}
+export interface Transaction {
+    id: string;
+    amount: number;
+    type: string;
+    timestamp: string;
+}
+export interface BlockedUser {
+    _id?: string;
+    blockedId: string | {
+        _id: string;
+        username: string;
+        avatar?: string;
+    };
+    userId: string;
+    createdAt?: string;
+    blockedAt?: string;
+    username?: string;
+    avatar?: string;
+}
+export interface RestrictedUser {
+    _id?: string;
+    restrictedId: string | {
+        _id: string;
+        username: string;
+        avatar?: string;
+    };
+    userId: string;
+    createdAt?: string;
+    restrictedAt?: string;
+    username?: string;
+    avatar?: string;
+}
+export interface TransferFundsRequest {
+    fromUserId: string;
+    toUserId: string;
+    amount: number;
+}
+export interface PurchaseRequest {
+    userId: string;
+    itemId: string;
+    amount: number;
+}
+export interface WithdrawalRequest {
+    userId: string;
+    amount: number;
+    address: string;
+}
+export interface TransactionResponse {
+    success: boolean;
+    transaction: Transaction;
+}
+export interface PaginationInfo {
+    total: number;
+    limit: number;
+    offset: number;
+    hasMore: boolean;
+}
+export interface SearchProfilesResponse {
+    data: User[];
+    pagination: PaginationInfo;
+}
+export interface KarmaRule {
+    id: string;
+    description: string;
+}
+export interface KarmaHistory {
+    id: string;
+    userId: string;
+    points: number;
+}
+export interface KarmaLeaderboardEntry {
+    userId: string;
+    total: number;
+}
+export interface KarmaAwardRequest {
+    userId: string;
+    points: number;
+    reason?: string;
+}
+export interface ApiError {
+    message: string;
+    code: string;
+    status: number;
+    details?: Record<string, unknown>;
+}
+export interface PaymentMethod {
+    id: string;
+    type: string;
+}
+export interface PaymentRequest {
+    userId: string;
+    planId: string;
+    paymentMethodId: string;
+}
+export interface PaymentResponse {
+    transactionId: string;
+    status: string;
+}
+export interface AnalyticsData {
+    userId: string;
+}
+export interface FollowerDetails {
+    userId: string;
+    followers: number;
+}
+export interface ContentViewer {
+    userId: string;
+    viewedAt: string;
+}
+/**
+ * File management interfaces
+ */
+export interface FileMetadata {
+    id: string;
+    filename: string;
+    contentType: string;
+    length: number;
+    chunkSize: number;
+    uploadDate: string;
+    metadata?: {
+        userId?: string;
+        description?: string;
+        title?: string;
+        tags?: string[];
+        [key: string]: unknown;
+    };
+    variants?: Array<{
+        type: string;
+        key: string;
+        width?: number;
+        height?: number;
+        readyAt?: string;
+        metadata?: Record<string, unknown>;
+    }>;
+}
+export interface FileUploadResponse {
+    files: FileMetadata[];
+}
+export interface FileListResponse {
+    files: FileMetadata[];
+    total: number;
+    hasMore: boolean;
+}
+export interface FileUpdateRequest {
+    filename?: string;
+    metadata?: {
+        description?: string;
+        title?: string;
+        tags?: string[];
+        [key: string]: unknown;
+    };
+}
+export interface FileDeleteResponse {
+    success: boolean;
+    message: string;
+    fileId: string;
+}
+/**
+ * Central Asset Service interfaces
+ */
+/**
+ * File visibility levels
+ * - private: Only accessible by owner (default)
+ * - public: Accessible by anyone without authentication (e.g., avatars, public profile content)
+ * - unlisted: Accessible with direct link but not listed publicly
+ */
+export type FileVisibility = 'private' | 'public' | 'unlisted';
+export interface AssetLink {
+    app: string;
+    entityType: string;
+    entityId: string;
+    createdBy: string;
+    createdAt: string;
+}
+export type AssetMetadata = Record<string, string | number | boolean | null | undefined>;
+export interface AssetVariant {
+    type: string;
+    key: string;
+    width?: number;
+    height?: number;
+    readyAt?: string;
+    size?: number;
+    metadata?: AssetMetadata;
+}
+export interface Asset {
+    id: string;
+    sha256: string;
+    size: number;
+    mime: string;
+    ext: string;
+    originalName?: string;
+    ownerUserId: string;
+    status: 'active' | 'trash' | 'deleted';
+    visibility: FileVisibility;
+    usageCount: number;
+    createdAt: string;
+    updatedAt: string;
+    links: AssetLink[];
+    variants: AssetVariant[];
+    metadata?: AssetMetadata;
+}
+export interface AssetInitRequest {
+    sha256: string;
+    size: number;
+    mime: string;
+}
+export interface AssetInitResponse {
+    uploadUrl: string;
+    fileId: string;
+    sha256: string;
+}
+export interface AssetCompleteRequest {
+    fileId: string;
+    originalName: string;
+    size: number;
+    mime: string;
+    visibility?: FileVisibility;
+    metadata?: AssetMetadata;
+}
+export interface AssetLinkRequest {
+    app: string;
+    entityType: string;
+    entityId: string;
+    visibility?: FileVisibility;
+}
+export interface AssetUnlinkRequest {
+    app: string;
+    entityType: string;
+    entityId: string;
+}
+export interface AssetUrlResponse {
+    success: boolean;
+    url: string;
+    variant?: string;
+    expiresIn: number;
+}
+export interface AssetDeleteSummary {
+    fileId: string;
+    wouldDelete: boolean;
+    affectedApps: string[];
+    remainingLinks: number;
+    variants: string[];
+}
+export interface AssetUpdateVisibilityRequest {
+    visibility: FileVisibility;
+}
+export interface AssetUpdateVisibilityResponse {
+    success: boolean;
+    file: {
+        id: string;
+        visibility: FileVisibility;
+        updatedAt: string;
+    };
+}
+/**
+ * Account storage usage (server-side usage, not local AsyncStorage)
+ */
+export interface AccountStorageCategoryUsage {
+    bytes: number;
+    count: number;
+}
+export interface AccountStorageUsageResponse {
+    plan: 'basic' | 'pro' | 'business';
+    totalUsedBytes: number;
+    totalLimitBytes: number;
+    categories: {
+        documents: AccountStorageCategoryUsage;
+        mail: AccountStorageCategoryUsage;
+        photosVideos: AccountStorageCategoryUsage;
+        recordings: AccountStorageCategoryUsage;
+        family: AccountStorageCategoryUsage;
+        other: AccountStorageCategoryUsage;
+    };
+    updatedAt: string;
+}
+/**
+ * Security activity event types
+ */
+export type SecurityEventType = 'sign_in' | 'sign_out' | 'email_changed' | 'profile_updated' | 'device_added' | 'device_removed' | 'account_recovery' | 'security_settings_changed' | 'private_key_exported' | 'backup_created' | 'suspicious_activity';
+/**
+ * Security event severity levels
+ */
+export type SecurityEventSeverity = 'low' | 'medium' | 'high' | 'critical';
+/**
+ * Security event severity mapping (single source of truth)
+ * Maps each event type to its default severity level
+ */
+export declare const SECURITY_EVENT_SEVERITY_MAP: Record<SecurityEventType, SecurityEventSeverity>;
+/**
+ * Security activity event
+ */
+export interface SecurityActivity {
+    id: string;
+    userId: string;
+    eventType: SecurityEventType;
+    eventDescription: string;
+    metadata?: Record<string, any>;
+    ipAddress?: string;
+    userAgent?: string;
+    deviceId?: string;
+    timestamp: string;
+    severity: SecurityEventSeverity;
+    createdAt: string;
+}
+/**
+ * Security activity response with pagination
+ */
+export interface SecurityActivityResponse {
+    data: SecurityActivity[];
+    total: number;
+    limit: number;
+    offset: number;
+    hasMore: boolean;
+}
+export interface AssetUploadProgress {
+    fileId: string;
+    uploaded: number;
+    total: number;
+    percentage: number;
+    status: 'uploading' | 'processing' | 'complete' | 'error';
+    error?: string;
+}
+export interface DeviceSession {
+    sessionId: string;
+    deviceId: string;
+    deviceName: string;
+    isActive: boolean;
+    lastActive: string;
+    expiresAt: string;
+    isCurrent: boolean;
+    user?: User;
+    createdAt?: string;
+}
+export interface DeviceSessionsResponse {
+    deviceId: string;
+    sessions: DeviceSession[];
+}
+export interface DeviceSessionLogoutResponse {
+    message: string;
+    deviceId: string;
+    sessionsTerminated: number;
+}
+export interface UpdateDeviceNameResponse {
+    message: string;
+    deviceName: string;
+}

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

@@ -0,0 +1,27 @@
+export interface ClientSession {
+    sessionId: string;
+    deviceId: string;
+    expiresAt: string;
+    lastActive: string;
+    userId?: string;
+    isCurrent?: boolean;
+}
+export interface StorageKeys {
+    sessions: string;
+    activeSessionId: string;
+}
+export interface MinimalUserData {
+    id: string;
+    username: string;
+    avatar?: string;
+}
+export interface SessionLoginResponse {
+    sessionId: string;
+    deviceId: string;
+    expiresAt: string;
+    user: MinimalUserData;
+    /** JWT access token for API authentication */
+    accessToken?: string;
+    /** Refresh token for obtaining new access tokens */
+    refreshToken?: string;
+}

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

@@ -0,0 +1,9 @@
+/**
+ * OxyHQServices Node.js Entry Point
+ */
+import { OxyServices, OXY_CLOUD_URL, oxyClient } from '../core';
+import * as Models from '../models/interfaces';
+export { OxyServices, OXY_CLOUD_URL, oxyClient };
+export { Models };
+export * from '../models/interfaces';
+export default OxyServices;

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

@@ -0,0 +1,28 @@
+/**
+ * OxyServices Shared Module
+ *
+ * Platform-agnostic utilities and helpers that work everywhere:
+ * - Browser (Web, Expo Web)
+ * - React Native (iOS, Android)
+ * - Node.js (Backend)
+ *
+ * This module contains NO React Native or browser-specific dependencies.
+ *
+ * @module shared
+ *
+ * @example
+ * ```ts
+ * import { darkenColor, normalizeTheme, withRetry } from '@oxyhq/services/shared';
+ *
+ * const darkBlue = darkenColor('#0066FF', 0.3);
+ * const theme = normalizeTheme(userPreference);
+ * const data = await withRetry(() => fetchData(), { maxRetries: 3 });
+ * ```
+ */
+export { darkenColor, lightenColor, hexToRgb, rgbToHex, withOpacity, isLightColor, getContrastTextColor, } from './utils/colorUtils';
+export { normalizeTheme, normalizeColorScheme, getOppositeTheme, systemPrefersDarkMode, getSystemColorScheme, } from './utils/themeUtils';
+export type { ThemeValue } from './utils/themeUtils';
+export { HttpStatus, getErrorStatus, getErrorMessage, isAlreadyRegisteredError, isUnauthorizedError, isForbiddenError, isNotFoundError, isRateLimitError, isServerError, isNetworkError, isRetryableError, } from './utils/errorUtils';
+export { DEFAULT_CIRCUIT_BREAKER_CONFIG, createCircuitBreakerState, calculateBackoffInterval, recordFailure, recordSuccess, shouldAllowRequest, delay, withRetry, } from './utils/networkUtils';
+export type { CircuitBreakerState, CircuitBreakerConfig, } from './utils/networkUtils';
+export { isDev, debugLog, debugWarn, debugError, createDebugLogger, } from './utils/debugUtils';

package/dist/web/types/shared/utils/colorUtils.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Color Utility Functions
+ *
+ * Consolidated color manipulation utilities used across the OxyServices ecosystem.
+ * These functions work in any JavaScript environment (browser, Node.js, React Native).
+ *
+ * @module shared/utils/colorUtils
+ */
+/**
+ * Darkens a hex color by a specified factor.
+ *
+ * @param color - Hex color string (with or without #)
+ * @param factor - Amount to darken (0-1). Default: 0.6
+ * @returns Darkened hex color string with # prefix
+ *
+ * @example
+ * ```ts
+ * darkenColor('#FF0000', 0.5); // Returns a darker red
+ * darkenColor('FF0000', 0.3);  // Also works without #
+ * ```
+ */
+export declare const darkenColor: (color: string, factor?: number) => string;
+/**
+ * Lightens a hex color by a specified factor.
+ *
+ * @param color - Hex color string (with or without #)
+ * @param factor - Amount to lighten (0-1). Default: 0.3
+ * @returns Lightened hex color string with # prefix
+ *
+ * @example
+ * ```ts
+ * lightenColor('#0000FF', 0.5); // Returns a lighter blue
+ * ```
+ */
+export declare const lightenColor: (color: string, factor?: number) => string;
+/**
+ * Converts a hex color to RGB values.
+ *
+ * @param hex - Hex color string (with or without #)
+ * @returns Object with r, g, b values (0-255)
+ *
+ * @example
+ * ```ts
+ * hexToRgb('#FF5733'); // { r: 255, g: 87, b: 51 }
+ * ```
+ */
+export declare const hexToRgb: (hex: string) => {
+    r: number;
+    g: number;
+    b: number;
+} | null;
+/**
+ * Converts RGB values to a hex color string.
+ *
+ * @param r - Red value (0-255)
+ * @param g - Green value (0-255)
+ * @param b - Blue value (0-255)
+ * @returns Hex color string with # prefix
+ *
+ * @example
+ * ```ts
+ * rgbToHex(255, 87, 51); // '#ff5733'
+ * ```
+ */
+export declare const rgbToHex: (r: number, g: number, b: number) => string;
+/**
+ * Adjusts the opacity of a hex color, returning an rgba string.
+ *
+ * @param hex - Hex color string
+ * @param opacity - Opacity value (0-1)
+ * @returns RGBA color string
+ *
+ * @example
+ * ```ts
+ * withOpacity('#FF0000', 0.5); // 'rgba(255, 0, 0, 0.5)'
+ * ```
+ */
+export declare const withOpacity: (hex: string, opacity: number) => string;
+/**
+ * Checks if a color is considered "light" (for determining text contrast).
+ *
+ * @param hex - Hex color string
+ * @returns true if the color is light, false if dark
+ *
+ * @example
+ * ```ts
+ * isLightColor('#FFFFFF'); // true
+ * isLightColor('#000000'); // false
+ * ```
+ */
+export declare const isLightColor: (hex: string) => boolean;
+/**
+ * Gets a contrasting text color (black or white) for a given background color.
+ *
+ * @param backgroundColor - Hex color string of the background
+ * @returns '#000000' for light backgrounds, '#ffffff' for dark backgrounds
+ *
+ * @example
+ * ```ts
+ * getContrastTextColor('#FFFF00'); // '#000000' (black text on yellow)
+ * getContrastTextColor('#000080'); // '#ffffff' (white text on navy)
+ * ```
+ */
+export declare const getContrastTextColor: (backgroundColor: string) => string;

package/dist/web/types/shared/utils/debugUtils.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Debug Utilities
+ *
+ * Provides safe logging functions that only output in development mode.
+ * All logs are stripped in production builds.
+ *
+ * @module shared/utils/debugUtils
+ */
+/**
+ * Check if running in development mode
+ */
+export declare const isDev: () => boolean;
+/**
+ * Log a debug message (only in development)
+ * @param prefix - Log prefix (e.g., '[FedCM]')
+ * @param args - Arguments to log
+ */
+export declare const debugLog: (prefix: string, ...args: unknown[]) => void;
+/**
+ * Log a debug warning (only in development)
+ * @param prefix - Log prefix
+ * @param args - Arguments to log
+ */
+export declare const debugWarn: (prefix: string, ...args: unknown[]) => void;
+/**
+ * Log a debug error (only in development)
+ * @param prefix - Log prefix
+ * @param args - Arguments to log
+ */
+export declare const debugError: (prefix: string, ...args: unknown[]) => void;
+/**
+ * Create a namespaced debug logger
+ * @param namespace - Logger namespace (e.g., 'FedCM', 'PopupAuth')
+ * @returns Object with log, warn, error methods
+ *
+ * @example
+ * ```ts
+ * const debug = createDebugLogger('FedCM');
+ * debug.log('Starting authentication');
+ * debug.warn('Token expires soon');
+ * debug.error('Authentication failed', error);
+ * ```
+ */
+export declare const createDebugLogger: (namespace: string) => {
+    log: (...args: unknown[]) => void;
+    warn: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+};