@oxyhq/services 5.18.0 → 5.18.1

package/lib/typescript/module/core/mixins/OxyServices.auth.d.ts

@@ -0,0 +1,187 @@
+/**
+ * Authentication Methods Mixin
+ *
+ * Supports password-based login (email/username) and public key challenge-response.
+ */
+import type { User } from '../../models/interfaces';
+import type { SessionLoginResponse } from '../../models/session';
+import type { OxyServicesBase } from '../OxyServices.base';
+export interface ChallengeResponse {
+    challenge: string;
+    expiresAt: string;
+}
+export interface RegistrationRequest {
+    publicKey: string;
+    username: string;
+    email?: string;
+    signature: string;
+    timestamp: number;
+}
+export interface ChallengeVerifyRequest {
+    publicKey: string;
+    challenge: string;
+    signature: string;
+    timestamp: number;
+    deviceName?: string;
+    deviceFingerprint?: string;
+}
+export interface PublicKeyCheckResponse {
+    registered: boolean;
+    message: string;
+}
+export declare function OxyServicesAuthMixin<T extends typeof OxyServicesBase>(Base: T): {
+    new (...args: any[]): {
+        /**
+         * Register a new identity with public key authentication
+         * Identity is purely cryptographic - username and profile data are optional
+         *
+         * @param publicKey - The user's ECDSA public key (hex)
+         * @param signature - Signature of the registration request
+         * @param timestamp - Timestamp when the signature was created
+         */
+        register(publicKey: string, signature: string, timestamp: number): Promise<{
+            message: string;
+            user: User;
+        }>;
+        /**
+         * Request an authentication challenge
+         * The client must sign this challenge with their private key
+         *
+         * @param publicKey - The user's public key
+         */
+        requestChallenge(publicKey: string): Promise<ChallengeResponse>;
+        /**
+         * Verify a signed challenge and create a session
+         *
+         * @param publicKey - The user's public key
+         * @param challenge - The challenge string from requestChallenge
+         * @param signature - Signature of the auth message
+         * @param timestamp - Timestamp when the signature was created
+         * @param deviceName - Optional device name
+         * @param deviceFingerprint - Optional device fingerprint
+         */
+        verifyChallenge(publicKey: string, challenge: string, signature: string, timestamp: number, deviceName?: string, deviceFingerprint?: string): Promise<SessionLoginResponse>;
+        /**
+         * Check if a public key is already registered
+         */
+        checkPublicKeyRegistered(publicKey: string): Promise<PublicKeyCheckResponse>;
+        /**
+         * Get user by public key
+         */
+        getUserByPublicKey(publicKey: string): Promise<User>;
+        /**
+         * Get user by session ID
+         */
+        getUserBySession(sessionId: string): Promise<User>;
+        /**
+         * Batch get multiple user profiles by session IDs
+         */
+        getUsersBySessions(sessionIds: string[]): Promise<Array<{
+            sessionId: string;
+            user: User | null;
+        }>>;
+        /**
+         * Get access token by session ID
+         */
+        getTokenBySession(sessionId: string): Promise<{
+            accessToken: string;
+            expiresAt: string;
+        }>;
+        /**
+         * Get sessions by session ID
+         */
+        getSessionsBySessionId(sessionId: string): Promise<any[]>;
+        /**
+         * Logout from a specific session
+         */
+        logoutSession(sessionId: string, targetSessionId?: string): Promise<void>;
+        /**
+         * Logout from all sessions
+         */
+        logoutAllSessions(sessionId: string): Promise<void>;
+        /**
+         * Validate session
+         */
+        validateSession(sessionId: string, options?: {
+            deviceFingerprint?: string;
+            useHeaderValidation?: boolean;
+        }): Promise<{
+            valid: boolean;
+            expiresAt: string;
+            lastActivity: string;
+            user: User;
+            sessionId?: string;
+            source?: string;
+        }>;
+        /**
+         * Check username availability
+         */
+        checkUsernameAvailability(username: string): Promise<{
+            available: boolean;
+            message: string;
+        }>;
+        /**
+         * Check email availability
+         */
+        checkEmailAvailability(email: string): Promise<{
+            available: boolean;
+            message: string;
+        }>;
+        /**
+         * Register a new user with email/username and password
+         */
+        signUp(username: string, email: string, password: string, deviceName?: string, deviceFingerprint?: any): Promise<SessionLoginResponse>;
+        /**
+         * Sign in with email or username and password
+         */
+        signIn(identifier: string, password: string, deviceName?: string, deviceFingerprint?: any): Promise<SessionLoginResponse>;
+        /**
+         * Convenience helper for email sign-in
+         */
+        signInWithEmail(email: string, password: string, deviceName?: string, deviceFingerprint?: any): Promise<SessionLoginResponse>;
+        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;
+//# sourceMappingURL=OxyServices.auth.d.ts.map

package/lib/typescript/module/core/mixins/OxyServices.auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OxyServices.auth.d.ts","sourceRoot":"","sources":["../../../../../src/core/mixins/OxyServices.auth.ts"],"names":[],"mappings":"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"}

package/lib/typescript/module/core/mixins/OxyServices.developer.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Developer API Methods Mixin
+ *
+ * Provides methods for managing developer applications and API keys
+ */
+import type { OxyServicesBase } from '../OxyServices.base';
+export declare function OxyServicesDeveloperMixin<T extends typeof OxyServicesBase>(Base: T): {
+    new (...args: any[]): {
+        /**
+         * Get developer apps for the current user
+         * @returns Array of developer apps
+         */
+        getDeveloperApps(): Promise<any[]>;
+        /**
+         * Create a new developer app
+         * @param data - Developer app configuration
+         * @returns Created developer app
+         */
+        createDeveloperApp(data: {
+            name: string;
+            description?: string;
+            webhookUrl: string;
+            devWebhookUrl?: string;
+            scopes?: string[];
+        }): Promise<any>;
+        /**
+         * Get a specific developer app
+         */
+        getDeveloperApp(appId: string): Promise<any>;
+        /**
+         * Update a developer app
+         * @param appId - The developer app ID
+         * @param data - Updated app configuration
+         * @returns Updated developer app
+         */
+        updateDeveloperApp(appId: string, data: {
+            name?: string;
+            description?: string;
+            webhookUrl?: string;
+            devWebhookUrl?: string;
+            scopes?: string[];
+        }): Promise<any>;
+        /**
+         * Regenerate API secret for a developer app
+         * @param appId - The developer app ID
+         * @returns App with new secret
+         */
+        regenerateDeveloperAppSecret(appId: string): Promise<any>;
+        /**
+         * Delete a developer app
+         * @param appId - The developer app ID
+         * @returns Deletion result
+         */
+        deleteDeveloperApp(appId: string): Promise<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;
+//# sourceMappingURL=OxyServices.developer.d.ts.map

package/lib/typescript/module/core/mixins/OxyServices.developer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OxyServices.developer.d.ts","sourceRoot":"","sources":["../../../../../src/core/mixins/OxyServices.developer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAG3D,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,OAAO,eAAe,EAAE,IAAI,EAAE,CAAC;kBAE1D,GAAG,EAAE;QAI1B;;;WAGG;4BACuB,OAAO,CAAC,GAAG,EAAE,CAAC;QAYxC;;;;WAIG;iCAC4B;YAC7B,IAAI,EAAE,MAAM,CAAC;YACb,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,UAAU,EAAE,MAAM,CAAC;YACnB,aAAa,CAAC,EAAE,MAAM,CAAC;YACvB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;SACnB,GAAG,OAAO,CAAC,GAAG,CAAC;QAShB;;WAEG;+BAC0B,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;QAYlD;;;;;WAKG;kCAC6B,MAAM,QAAQ;YAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,aAAa,CAAC,EAAE,MAAM,CAAC;YACvB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;SACnB,GAAG,OAAO,CAAC,GAAG,CAAC;QAShB;;;;WAIG;4CACuC,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;QAQ/D;;;;WAIG;kCAC6B,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAU0pF,CAAC;sBAA0B,CAAC;yBAA6B,CAAC;;;;;;iBAAuhG,CAAC;qBAAwB,CAAC;;;;;MAF7zL"}

package/lib/typescript/module/core/mixins/OxyServices.devices.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Device Methods Mixin
+ */
+import type { OxyServicesBase } from '../OxyServices.base';
+export declare function OxyServicesDevicesMixin<T extends typeof OxyServicesBase>(Base: T): {
+    new (...args: any[]): {
+        /**
+         * Register a new device
+         * @param deviceData - Device information
+         * @returns Registered device object
+         */
+        registerDevice(deviceData: any): Promise<any>;
+        /**
+         * Get all devices for the current user
+         * @returns Array of user devices
+         */
+        getUserDevices(): Promise<any[]>;
+        /**
+         * Remove a device
+         * @param deviceId - The device ID to remove
+         */
+        removeDevice(deviceId: string): Promise<void>;
+        /**
+         * Get device sessions for a given session ID
+         * Note: Not cached by default to ensure fresh data
+         * @param sessionId - The session ID
+         * @returns Array of device sessions
+         */
+        getDeviceSessions(sessionId: string): Promise<any[]>;
+        /**
+         * Logout all device sessions
+         * @param sessionId - The session ID
+         * @param deviceId - Optional device ID to target
+         * @param excludeCurrent - Whether to exclude the current session
+         * @returns Logout result
+         */
+        logoutAllDeviceSessions(sessionId: string, deviceId?: string, excludeCurrent?: boolean): Promise<any>;
+        /**
+         * Update device name
+         * @param sessionId - The session ID
+         * @param deviceName - New device name
+         * @returns Updated device object
+         */
+        updateDeviceName(sessionId: string, deviceName: string): Promise<any>;
+        /**
+         * Get security information
+         * @returns Security information object
+         */
+        getSecurityInfo(): Promise<{
+            recoveryEmail: string | null;
+        }>;
+        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;
+//# sourceMappingURL=OxyServices.devices.d.ts.map

package/lib/typescript/module/core/mixins/OxyServices.devices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OxyServices.devices.d.ts","sourceRoot":"","sources":["../../../../../src/core/mixins/OxyServices.devices.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,OAAO,eAAe,EAAE,IAAI,EAAE,CAAC;kBAExD,GAAG,EAAE;QAI1B;;;;WAIG;mCAC8B,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;QAQnD;;;WAGG;0BACqB,OAAO,CAAC,GAAG,EAAE,CAAC;QAUtC;;;WAGG;+BAC0B,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;QAQnD;;;;;WAKG;qCACgC,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAa1D;;;;;;WAMG;2CACsC,MAAM,aAAa,MAAM,mBAAmB,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC;QAW3G;;;;;WAKG;oCAC+B,MAAM,cAAc,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;QAQ3E;;;WAGG;2BACsB,OAAO,CAAC;YAC/B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;SAC9B,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAYkuE,CAAC;sBAA0B,CAAC;yBAA6B,CAAC;;;;;;iBAAuhG,CAAC;qBAAwB,CAAC;;;;;MAFl1K"}

package/lib/typescript/module/core/mixins/OxyServices.features.d.ts

@@ -0,0 +1,229 @@
+/**
+ * Features Methods Mixin
+ *
+ * Provides methods for various features:
+ * - Feedback submission
+ * - Subscription plans
+ * - Saves/Collections
+ * - User history
+ * - FAQ
+ * - User stats
+ * - Achievements
+ */
+import type { OxyServicesBase } from '../OxyServices.base';
+export interface FeedbackPayload {
+    type: 'bug' | 'feature' | 'general' | 'support';
+    title: string;
+    description: string;
+    priority: 'low' | 'medium' | 'high' | 'critical';
+    category: string;
+    contactEmail?: string;
+    systemInfo?: {
+        platform: string;
+        version: string;
+        appVersion: string;
+        userId?: string;
+        username?: string;
+        timestamp: string;
+    };
+}
+export interface FeedbackResult {
+    id: string;
+    status: string;
+    createdAt: string;
+}
+export interface SubscriptionPlan {
+    id: string;
+    name: string;
+    description: string;
+    price: number;
+    currency: string;
+    interval: 'month' | 'year';
+    features: string[];
+}
+export interface SubscriptionResult {
+    subscriptionId: string;
+    status: string;
+    currentPeriodEnd: string;
+}
+export interface SavedItem {
+    id: string;
+    itemId: string;
+    itemType: string;
+    title: string;
+    createdAt: string;
+}
+export interface Collection {
+    id: string;
+    name: string;
+    description?: string;
+    itemCount: number;
+    createdAt: string;
+}
+export interface UserStats {
+    postCount: number;
+    commentCount: number;
+    followerCount: number;
+    followingCount: number;
+    karmaScore?: number;
+}
+export interface HistoryItem {
+    id: string;
+    type: string;
+    title: string;
+    timestamp: string;
+    metadata?: Record<string, any>;
+}
+export interface FAQ {
+    id: string;
+    question: string;
+    answer: string;
+    category: string;
+}
+export interface Achievement {
+    id: string;
+    name: string;
+    description: string;
+    icon: string;
+    unlockedAt?: string;
+}
+export declare function OxyServicesFeaturesMixin<T extends typeof OxyServicesBase>(Base: T): {
+    new (...args: any[]): {
+        /**
+         * Submit user feedback
+         */
+        submitFeedback(payload: FeedbackPayload): Promise<FeedbackResult>;
+        /**
+         * Get available subscription plans
+         */
+        getSubscriptionPlans(): Promise<SubscriptionPlan[]>;
+        /**
+         * Get individual purchasable features
+         */
+        getIndividualFeatures(): Promise<any[]>;
+        /**
+         * Subscribe to a plan
+         */
+        subscribe(planId: string, paymentMethodId?: string): Promise<SubscriptionResult>;
+        /**
+         * Subscribe to an individual feature
+         */
+        subscribeToFeature(featureId: string, paymentMethodId?: string): Promise<SubscriptionResult>;
+        /**
+         * Cancel subscription
+         */
+        cancelSubscription(subscriptionId: string): Promise<void>;
+        /**
+         * Reactivate subscription
+         */
+        reactivateSubscription(subscriptionId: string): Promise<void>;
+        /**
+         * Get current user's subscription
+         */
+        getCurrentSubscription(): Promise<SubscriptionResult | null>;
+        /**
+         * Get user's saved items
+         */
+        getSavedItems(userId?: string): Promise<SavedItem[]>;
+        /**
+         * Get user's collections
+         */
+        getCollections(userId?: string): Promise<Collection[]>;
+        /**
+         * Save an item
+         */
+        saveItem(itemId: string, itemType: string, collectionId?: string): Promise<SavedItem>;
+        /**
+         * Remove an item from saves
+         */
+        removeSavedItem(saveId: string): Promise<void>;
+        /**
+         * Create a collection
+         */
+        createCollection(name: string, description?: string): Promise<Collection>;
+        /**
+         * Delete a collection
+         */
+        deleteCollection(collectionId: string): Promise<void>;
+        /**
+         * Get user statistics
+         */
+        getUserStats(userId: string): Promise<UserStats>;
+        /**
+         * Get user history
+         */
+        getUserHistory(userId?: string, limit?: number, offset?: number): Promise<HistoryItem[]>;
+        /**
+         * Clear user history
+         */
+        clearUserHistory(): Promise<void>;
+        /**
+         * Delete a history item
+         */
+        deleteHistoryItem(itemId: string): Promise<void>;
+        /**
+         * Get FAQs
+         */
+        getFAQs(category?: string): Promise<FAQ[]>;
+        /**
+         * Search FAQs
+         */
+        searchFAQs(query: string): Promise<FAQ[]>;
+        /**
+         * Get user achievements
+         */
+        getUserAchievements(userId?: string): Promise<Achievement[]>;
+        /**
+         * Get all available achievements
+         */
+        getAllAchievements(): Promise<Achievement[]>;
+        /**
+         * Delete user account (requires password confirmation)
+         */
+        deleteAccount(password: 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;
+//# sourceMappingURL=OxyServices.features.d.ts.map

package/lib/typescript/module/core/mixins/OxyServices.features.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OxyServices.features.d.ts","sourceRoot":"","sources":["../../../../../src/core/mixins/OxyServices.features.ts"],"names":[],"mappings":"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"}