@oxyhq/core 1.0.0

package/dist/types/mixins/OxyServices.user.d.ts

@@ -0,0 +1,182 @@
+/**
+ * User Management Methods Mixin
+ */
+import type { User, Notification, SearchProfilesResponse } from '../models/interfaces';
+import type { OxyServicesBase } from '../OxyServices.base';
+import { type PaginationParams } from '../utils/apiUtils';
+export declare function OxyServicesUserMixin<T extends typeof OxyServicesBase>(Base: T): {
+    new (...args: any[]): {
+        /**
+         * Get profile by username
+         */
+        getProfileByUsername(username: string): Promise<User>;
+        /**
+         * Search user profiles
+         */
+        searchProfiles(query: string, pagination?: PaginationParams): Promise<SearchProfilesResponse>;
+        /**
+         * Get profile recommendations
+         */
+        getProfileRecommendations(): Promise<Array<{
+            id: string;
+            username: string;
+            name?: {
+                first?: string;
+                last?: string;
+                full?: string;
+            };
+            description?: string;
+            _count?: {
+                followers: number;
+                following: number;
+            };
+            [key: string]: any;
+        }>>;
+        /**
+         * Get user by ID
+         */
+        getUserById(userId: string): Promise<User>;
+        /**
+         * Get current user
+         */
+        getCurrentUser(): Promise<User>;
+        /**
+         * Update user profile
+         * TanStack Query handles offline queuing automatically
+         */
+        updateProfile(updates: Record<string, any>): Promise<User>;
+        /**
+         * Get privacy settings for a user
+         * @param userId - The user ID (defaults to current user)
+         */
+        getPrivacySettings(userId?: string): Promise<any>;
+        /**
+         * Update privacy settings
+         * @param settings - Partial privacy settings object
+         * @param userId - The user ID (defaults to current user)
+         */
+        updatePrivacySettings(settings: Record<string, any>, userId?: string): Promise<any>;
+        /**
+         * Request account verification
+         */
+        requestAccountVerification(reason: string, evidence?: string): Promise<{
+            message: string;
+            requestId: string;
+        }>;
+        /**
+         * Download account data export
+         */
+        downloadAccountData(format?: "json" | "csv"): Promise<Blob>;
+        /**
+         * Delete account permanently
+         * @param password - User password for confirmation
+         * @param confirmText - Confirmation text (usually username)
+         */
+        deleteAccount(password: string, confirmText: string): Promise<{
+            message: string;
+        }>;
+        /**
+         * Follow a user
+         */
+        followUser(userId: string): Promise<{
+            success: boolean;
+            message: string;
+        }>;
+        /**
+         * Unfollow a user
+         */
+        unfollowUser(userId: string): Promise<{
+            success: boolean;
+            message: string;
+        }>;
+        /**
+         * Get follow status
+         */
+        getFollowStatus(userId: string): Promise<{
+            isFollowing: boolean;
+        }>;
+        /**
+         * Get user followers
+         */
+        getUserFollowers(userId: string, pagination?: PaginationParams): Promise<{
+            followers: User[];
+            total: number;
+            hasMore: boolean;
+        }>;
+        /**
+         * Get user following
+         */
+        getUserFollowing(userId: string, pagination?: PaginationParams): Promise<{
+            following: User[];
+            total: number;
+            hasMore: boolean;
+        }>;
+        /**
+         * Get notifications
+         */
+        getNotifications(): Promise<Notification[]>;
+        /**
+         * Get unread notification count
+         */
+        getUnreadCount(): Promise<number>;
+        /**
+         * Create notification
+         */
+        createNotification(data: Partial<Notification>): Promise<Notification>;
+        /**
+         * Mark notification as read
+         */
+        markNotificationAsRead(notificationId: string): Promise<void>;
+        /**
+         * Mark all notifications as read
+         */
+        markAllNotificationsAsRead(): Promise<void>;
+        /**
+         * Delete notification
+         */
+        deleteNotification(notificationId: string): Promise<void>;
+        httpService: import("../HttpService").HttpService;
+        cloudURL: string;
+        config: import("../OxyServices.base").OxyConfig;
+        makeRequest<T_1>(method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE", url: string, data?: any, options?: import("../HttpService").RequestOptions): Promise<T_1>;
+        getBaseURL(): string;
+        getClient(): import("../HttpService").HttpService;
+        getMetrics(): {
+            totalRequests: number;
+            successfulRequests: number;
+            failedRequests: number;
+            cacheHits: number;
+            cacheMisses: number;
+            averageResponseTime: number;
+        };
+        clearCache(): void;
+        clearCacheEntry(key: string): void;
+        getCacheStats(): {
+            size: number;
+            hits: number;
+            misses: number;
+            hitRate: number;
+        };
+        getCloudURL(): string;
+        setTokens(accessToken: string, refreshToken?: string): void;
+        clearTokens(): void;
+        getCurrentUserId(): string | null;
+        hasValidToken(): boolean;
+        getAccessToken(): string | null;
+        waitForAuth(timeoutMs?: number): Promise<boolean>;
+        withAuthRetry<T_1>(operation: () => Promise<T_1>, operationName: string, options?: {
+            maxRetries?: number;
+            retryDelay?: number;
+            authTimeoutMs?: number;
+        }): Promise<T_1>;
+        validate(): Promise<boolean>;
+        handleError(error: unknown): Error;
+        healthCheck(): Promise<{
+            status: string;
+            users?: number;
+            timestamp?: string;
+            [key: string]: any;
+        }>;
+    };
+    __resetTokensForTests(): void;
+} & T;

package/dist/types/mixins/OxyServices.utility.d.ts

@@ -0,0 +1,93 @@
+import type { ApiError } from '../models/interfaces';
+import type { OxyServicesBase } from '../OxyServices.base';
+export declare function OxyServicesUtilityMixin<T extends typeof OxyServicesBase>(Base: T): {
+    new (...args: any[]): {
+        /**
+         * Fetch link metadata
+         */
+        fetchLinkMetadata(url: string): Promise<{
+            url: string;
+            title: string;
+            description: string;
+            image?: string;
+        }>;
+        /**
+         * Simple Express.js authentication middleware
+         *
+         * Built-in authentication middleware that validates JWT tokens and adds user data to requests.
+         *
+         * @example
+         * ```typescript
+         * // Basic usage - just add it to your routes
+         * app.use('/api/protected', oxyServices.auth());
+         *
+         * // With debug logging
+         * app.use('/api/protected', oxyServices.auth({ debug: true }));
+         *
+         * // With custom error handling
+         * app.use('/api/protected', oxyServices.auth({
+         *   onError: (error) => console.error('Auth failed:', error)
+         * }));
+         *
+         * // Load full user data
+         * app.use('/api/protected', oxyServices.auth({ loadUser: true }));
+         * ```
+         *
+         * @param options Optional configuration
+         * @param options.debug Enable debug logging (default: false)
+         * @param options.onError Custom error handler
+         * @param options.loadUser Load full user data (default: false for performance)
+         * @param options.session Use session-based validation (default: false)
+         * @returns Express middleware function
+         */
+        auth(options?: {
+            debug?: boolean;
+            onError?: (error: ApiError) => any;
+            loadUser?: boolean;
+            session?: boolean;
+        }): (req: any, res: any, next: any) => any;
+        httpService: import("../HttpService").HttpService;
+        cloudURL: string;
+        config: import("../OxyServices.base").OxyConfig;
+        makeRequest<T_1>(method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE", url: string, data?: any, options?: import("../HttpService").RequestOptions): Promise<T_1>;
+        getBaseURL(): string;
+        getClient(): import("../HttpService").HttpService;
+        getMetrics(): {
+            totalRequests: number;
+            successfulRequests: number;
+            failedRequests: number;
+            cacheHits: number;
+            cacheMisses: number;
+            averageResponseTime: number;
+        };
+        clearCache(): void;
+        clearCacheEntry(key: string): void;
+        getCacheStats(): {
+            size: number;
+            hits: number;
+            misses: number;
+            hitRate: number;
+        };
+        getCloudURL(): string;
+        setTokens(accessToken: string, refreshToken?: string): void;
+        clearTokens(): void;
+        getCurrentUserId(): string | null;
+        hasValidToken(): boolean;
+        getAccessToken(): string | null;
+        waitForAuth(timeoutMs?: number): Promise<boolean>;
+        withAuthRetry<T_1>(operation: () => Promise<T_1>, operationName: string, options?: {
+            maxRetries?: number;
+            retryDelay?: number;
+            authTimeoutMs?: number;
+        }): Promise<T_1>;
+        validate(): Promise<boolean>;
+        handleError(error: unknown): Error;
+        healthCheck(): Promise<{
+            status: string;
+            users?: number;
+            timestamp?: string;
+            [key: string]: any;
+        }>;
+    };
+    __resetTokensForTests(): void;
+} & T;

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

@@ -0,0 +1,30 @@
+/**
+ * Centralized mixin exports and composition helper
+ *
+ * This module provides a clean way to compose all mixins
+ * and ensures consistent ordering for better maintainability
+ */
+type MixinFunction = (Base: any) => any;
+/**
+ * Mixin pipeline - applied in order from first to last.
+ *
+ * Order matters for dependencies:
+ * 1. Base auth mixin first (required by all others)
+ * 2. Cross-domain auth mixins (FedCM, Popup, Redirect)
+ * 3. User mixin (requires auth)
+ * 4. Feature mixins (can depend on user)
+ * 5. Utility mixin last (augments all)
+ *
+ * To add a new mixin: insert it at the appropriate position in this array.
+ */
+declare const MIXIN_PIPELINE: MixinFunction[];
+/**
+ * Composes all OxyServices mixins using a pipeline pattern.
+ *
+ * This is equivalent to the nested calls but more readable and maintainable.
+ * Adding a new mixin: just add it to MIXIN_PIPELINE at the appropriate position.
+ *
+ * @returns The fully composed OxyServices class with all mixins applied
+ */
+export declare function composeOxyServices(): any;
+export { MIXIN_PIPELINE };

package/dist/types/mixins/mixinHelpers.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Helper utilities for mixin classes
+ * Provides common patterns to reduce code duplication
+ */
+import type { OxyServicesBase } from '../OxyServices.base';
+/**
+ * Wraps an async method with standard error handling
+ * Reduces boilerplate in mixin methods
+ */
+export declare function withErrorHandling<T>(operation: () => Promise<T>, handleError: (error: any) => Error): Promise<T>;
+/**
+ * Creates a standard API request method with error handling
+ * Reduces duplication across mixin methods
+ */
+export declare function createApiMethod<T>(makeRequest: OxyServicesBase['makeRequest'], handleError: OxyServicesBase['handleError'], method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE', url: string | ((...args: any[]) => string), options?: {
+    cache?: boolean;
+    cacheTTL?: number;
+    retry?: boolean;
+    transformData?: (data: any) => any;
+    transformResponse?: (response: any) => T;
+}): (...args: any[]) => Promise<T>;
+/**
+ * Cache time constants (in milliseconds)
+ */
+export declare const CACHE_TIMES: {
+    readonly SHORT: number;
+    readonly MEDIUM: number;
+    readonly LONG: number;
+    readonly VERY_LONG: number;
+    readonly EXTRA_LONG: number;
+};