@oxyhq/services 5.16.23 → 5.16.24

package/lib/module/utils/validationUtils.js

@@ -0,0 +1,170 @@
+"use strict";
+
+/**
+ * Validation utilities for common data validation patterns
+ */
+
+/**
+ * Email validation regex
+ */
+export const EMAIL_REGEX = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+
+/**
+ * Username validation regex (alphanumeric, underscores, and hyphens, 3-30 chars)
+ */
+export const USERNAME_REGEX = /^[a-zA-Z0-9_-]{3,30}$/;
+
+/**
+ * Password validation regex (at least 8 chars, 1 uppercase, 1 lowercase, 1 number)
+ */
+// At least 8 characters (tests expect len>=8 without complexity requirements)
+export const PASSWORD_REGEX = /^.{8,}$/;
+
+/**
+ * Validate email format
+ */
+export function isValidEmail(email) {
+  return EMAIL_REGEX.test(email);
+}
+
+/**
+ * Validate username format
+ */
+export function isValidUsername(username) {
+  return USERNAME_REGEX.test(username);
+}
+
+/**
+ * Validate password strength
+ */
+export function isValidPassword(password) {
+  return PASSWORD_REGEX.test(password);
+}
+
+/**
+ * Validate required string
+ */
+export function isRequiredString(value) {
+  return typeof value === 'string' && value.trim().length > 0;
+}
+
+/**
+ * Validate required number
+ */
+export function isRequiredNumber(value) {
+  return typeof value === 'number' && !Number.isNaN(value);
+}
+
+/**
+ * Validate required boolean
+ */
+export function isRequiredBoolean(value) {
+  return typeof value === 'boolean';
+}
+
+/**
+ * Validate array
+ */
+export function isValidArray(value) {
+  return Array.isArray(value);
+}
+
+/**
+ * Validate object
+ */
+export function isValidObject(value) {
+  return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+
+/**
+ * Validate UUID format
+ */
+export function isValidUUID(uuid) {
+  const UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+  return UUID_REGEX.test(uuid);
+}
+
+/**
+ * Validate URL format
+ */
+export function isValidURL(url) {
+  try {
+    new URL(url);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Validate date string
+ */
+export function isValidDate(dateString) {
+  const date = new Date(dateString);
+  return !Number.isNaN(date.getTime());
+}
+
+/**
+ * Validate file size (in bytes)
+ */
+export function isValidFileSize(size, maxSize) {
+  return size > 0 && size <= maxSize;
+}
+
+/**
+ * Validate file type
+ */
+export function isValidFileType(filename, allowedTypes) {
+  const extension = filename.split('.').pop()?.toLowerCase();
+  return extension ? allowedTypes.includes(extension) : false;
+}
+
+/**
+ * Sanitize string input
+ */
+export function sanitizeString(input) {
+  // Remove HTML tags entirely and trim whitespace
+  return input.trim().replace(/<[^>]*>/g, '');
+}
+
+/**
+ * Sanitize HTML input
+ */
+export function sanitizeHTML(input) {
+  return input.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;').replace(/'/g, '&#x27;');
+}
+
+/**
+ * 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 function isValidObjectId(id) {
+  if (typeof id !== 'string') {
+    return false;
+  }
+  // MongoDB ObjectId is 24 hex characters
+  const OBJECT_ID_REGEX = /^[0-9a-fA-F]{24}$/;
+  return OBJECT_ID_REGEX.test(id);
+}
+
+/**
+ * Validate and sanitize user input
+ */
+export function validateAndSanitizeUserInput(input, type) {
+  if (typeof input !== 'string') {
+    return null;
+  }
+  const sanitized = sanitizeString(input);
+  switch (type) {
+    case 'email':
+      return isValidEmail(sanitized) ? sanitized : null;
+    case 'username':
+      return isValidUsername(sanitized) ? sanitized : null;
+    case 'string':
+      return isRequiredString(sanitized) ? sanitized : null;
+    default:
+      return null;
+  }
+}
+//# sourceMappingURL=validationUtils.js.map

package/lib/module/utils/validationUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["EMAIL_REGEX","USERNAME_REGEX","PASSWORD_REGEX","isValidEmail","email","test","isValidUsername","username","isValidPassword","password","isRequiredString","value","trim","length","isRequiredNumber","Number","isNaN","isRequiredBoolean","isValidArray","Array","isArray","isValidObject","isValidUUID","uuid","UUID_REGEX","isValidURL","url","URL","isValidDate","dateString","date","Date","getTime","isValidFileSize","size","maxSize","isValidFileType","filename","allowedTypes","extension","split","pop","toLowerCase","includes","sanitizeString","input","replace","sanitizeHTML","isValidObjectId","id","OBJECT_ID_REGEX","validateAndSanitizeUserInput","type","sanitized"],"sourceRoot":"../../../src","sources":["utils/validationUtils.ts"],"mappings":"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","ignoreList":[]}

package/lib/typescript/assets/icons/OxyServices.d.ts

@@ -0,0 +1,29 @@
+import type React from 'react';
+import type { ViewStyle } from 'react-native';
+interface OxyLogoProps {
+    width?: number;
+    height?: number;
+    style?: ViewStyle;
+    /**
+     * Primary fill color for the logo
+     * If not provided, the theme's primary color will be used
+     */
+    fillColor?: string;
+    /**
+     * Secondary fill color for the inner glow effect
+     * If not provided, a lighter shade of the fillColor will be used
+     */
+    secondaryFillColor?: string;
+    /**
+     * Theme to use for the logo colors
+     * @default 'light'
+     */
+    theme?: 'light' | 'dark';
+}
+/**
+ * SVG logo component for Oxy
+ * This component renders the Oxy logo as an SVG and uses theme colors by default
+ */
+export declare const OxyServicesLogo: React.FC<OxyLogoProps>;
+export default OxyServicesLogo;
+//# sourceMappingURL=OxyServices.d.ts.map

package/lib/typescript/assets/icons/OxyServices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OxyServices.d.ts","sourceRoot":"","sources":["../../../../src/assets/icons/OxyServices.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAG9C,UAAU,YAAY;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC5B;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,YAAY,CAkClD,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/lib/typescript/assets/illustrations/HighFive.d.ts

@@ -0,0 +1,9 @@
+import type React from 'react';
+interface HighFiveProps {
+    width?: number;
+    height?: number;
+    color?: string;
+}
+declare const HighFive: React.FC<HighFiveProps>;
+export default HighFive;
+//# sourceMappingURL=HighFive.d.ts.map

package/lib/typescript/assets/illustrations/HighFive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HighFive.d.ts","sourceRoot":"","sources":["../../../../src/assets/illustrations/HighFive.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,UAAU,aAAa;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,QAAA,MAAM,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,aAAa,CA6BrC,CAAC;AAEF,eAAe,QAAQ,CAAC"}

package/lib/typescript/constants/version.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Package version and metadata constants
+ * This file is auto-generated to avoid runtime dependency on package.json
+ */
+export declare const packageInfo: {
+    readonly name: "@oxyhq/services";
+    readonly version: "5.2.1";
+    readonly description: "Reusable OxyHQ module to handle authentication, user management, karma system and more 🚀";
+    readonly main: "lib/commonjs/node/index.js";
+    readonly module: "lib/module/node/index.js";
+    readonly types: "lib/typescript/node/index.d.ts";
+};
+export declare const name: "@oxyhq/services", version: "5.2.1", description: "Reusable OxyHQ module to handle authentication, user management, karma system and more 🚀";
+//# sourceMappingURL=version.d.ts.map

package/lib/typescript/constants/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../src/constants/version.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,WAAW;;;;;;;CAOd,CAAC;AAEX,eAAO,MAAQ,IAAI,qBAAE,OAAO,WAAE,WAAW,6FAAgB,CAAC"}

package/lib/typescript/core/HttpService.d.ts

@@ -0,0 +1,159 @@
+/**
+ * Unified HTTP Service
+ *
+ * Consolidates HttpClient + RequestManager into a single efficient class.
+ * Uses native fetch instead of axios for smaller bundle size.
+ *
+ * Handles:
+ * - Authentication (token management, auto-refresh)
+ * - Caching (TTL-based)
+ * - Deduplication (concurrent requests)
+ * - Retry logic
+ * - Error handling
+ * - Request queuing
+ */
+import type { OxyConfig } from '../models/interfaces';
+export interface RequestOptions {
+    cache?: boolean;
+    cacheTTL?: number;
+    deduplicate?: boolean;
+    retry?: boolean;
+    maxRetries?: number;
+    timeout?: number;
+    signal?: AbortSignal;
+    headers?: Record<string, string>;
+}
+interface RequestConfig extends RequestOptions {
+    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    url: string;
+    data?: unknown;
+    params?: Record<string, unknown>;
+}
+/**
+ * Unified HTTP Service
+ *
+ * Consolidates HttpClient + RequestManager into a single efficient class.
+ * Uses native fetch instead of axios for smaller bundle size.
+ */
+export declare class HttpService {
+    private baseURL;
+    private cache;
+    private deduplicator;
+    private requestQueue;
+    private logger;
+    private config;
+    private requestMetrics;
+    constructor(config: OxyConfig);
+    /**
+     * Robust FormData detection that works in browser and Node.js environments
+     * Checks multiple conditions to handle different FormData implementations
+     */
+    private isFormData;
+    /**
+     * Main request method - handles everything in one place
+     */
+    request<T = unknown>(config: RequestConfig): Promise<T>;
+    /**
+     * Generate cache key efficiently
+     * Uses simple hash for large objects to avoid expensive JSON.stringify
+     */
+    private generateCacheKey;
+    /**
+     * Build full URL with query params
+     */
+    private buildURL;
+    /**
+     * Get auth header with automatic token refresh
+     * Uses TokenService for all token operations
+     */
+    private getAuthHeader;
+    /**
+     * Unwrap standardized API response format
+     */
+    private unwrapResponse;
+    /**
+     * Update request metrics
+     */
+    private updateMetrics;
+    /**
+     * GET request convenience method
+     */
+    get<T = unknown>(url: string, config?: Omit<RequestConfig, 'method' | 'url'>): Promise<{
+        data: T;
+    }>;
+    /**
+     * POST request convenience method
+     * Supports FormData uploads - Content-Type will be set automatically for FormData
+     * @param url - Request URL
+     * @param data - Request body (can be FormData for file uploads)
+     * @param config - Request configuration including optional headers
+     * @example
+     * ```typescript
+     * const formData = new FormData();
+     * formData.append('file', file);
+     * await api.post('/upload', formData, { headers: { 'X-Custom-Header': 'value' } });
+     * ```
+     */
+    post<T = unknown>(url: string, data?: unknown, config?: Omit<RequestConfig, 'method' | 'url' | 'data'>): Promise<{
+        data: T;
+    }>;
+    /**
+     * PUT request convenience method
+     * Supports FormData uploads - Content-Type will be set automatically for FormData
+     * @param url - Request URL
+     * @param data - Request body (can be FormData for file uploads)
+     * @param config - Request configuration including optional headers
+     * @example
+     * ```typescript
+     * const formData = new FormData();
+     * formData.append('file', file);
+     * await api.put('/upload', formData, { headers: { 'X-Custom-Header': 'value' } });
+     * ```
+     */
+    put<T = unknown>(url: string, data?: unknown, config?: Omit<RequestConfig, 'method' | 'url' | 'data'>): Promise<{
+        data: T;
+    }>;
+    /**
+     * PATCH request convenience method
+     * Supports FormData uploads - Content-Type will be set automatically for FormData
+     * @param url - Request URL
+     * @param data - Request body (can be FormData for file uploads)
+     * @param config - Request configuration including optional headers
+     * @example
+     * ```typescript
+     * const formData = new FormData();
+     * formData.append('file', file);
+     * await api.patch('/upload', formData, { headers: { 'X-Custom-Header': 'value' } });
+     * ```
+     */
+    patch<T = unknown>(url: string, data?: unknown, config?: Omit<RequestConfig, 'method' | 'url' | 'data'>): Promise<{
+        data: T;
+    }>;
+    delete<T = unknown>(url: string, config?: Omit<RequestConfig, 'method' | 'url'>): Promise<{
+        data: T;
+    }>;
+    setTokens(accessToken: string, refreshToken?: string): void;
+    clearTokens(): void;
+    getAccessToken(): string | null;
+    hasAccessToken(): boolean;
+    getBaseURL(): string;
+    clearCache(): void;
+    clearCacheEntry(key: string): void;
+    getCacheStats(): {
+        size: number;
+        hits: number;
+        misses: number;
+        hitRate: number;
+    };
+    getMetrics(): {
+        totalRequests: number;
+        successfulRequests: number;
+        failedRequests: number;
+        cacheHits: number;
+        cacheMisses: number;
+        averageResponseTime: number;
+    };
+    static __resetTokensForTests(): void;
+}
+export {};
+//# sourceMappingURL=HttpService.d.ts.map

package/lib/typescript/core/HttpService.d.ts.map

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

package/lib/typescript/core/OxyServices.base.d.ts

@@ -0,0 +1,133 @@
+/**
+ * OxyServices Base Class
+ *
+ * Contains core infrastructure, HTTP client, request management, and error handling
+ */
+import type { OxyConfig as OxyConfigBase } from '../models/interfaces';
+import { HttpService, type RequestOptions } from './HttpService';
+export interface OxyConfig extends OxyConfigBase {
+    cloudURL?: string;
+}
+/**
+ * Base class for OxyServices with core infrastructure
+ */
+export declare class OxyServicesBase {
+    httpService: HttpService;
+    cloudURL: string;
+    config: OxyConfig;
+    constructor(...args: any[]);
+    static __resetTokensForTests(): void;
+    /**
+     * Make a request with all performance optimizations
+     * This is the main method for all API calls - ensures authentication and performance features
+     */
+    makeRequest<T>(method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE', url: string, data?: any, options?: RequestOptions): Promise<T>;
+    /**
+     * Get the configured Oxy API base URL
+     */
+    getBaseURL(): string;
+    /**
+     * Get the HTTP service instance
+     * Useful for advanced use cases where direct access to the HTTP service is needed
+     */
+    getClient(): HttpService;
+    /**
+     * Get performance metrics
+     */
+    getMetrics(): {
+        totalRequests: number;
+        successfulRequests: number;
+        failedRequests: number;
+        cacheHits: number;
+        cacheMisses: number;
+        averageResponseTime: number;
+    };
+    /**
+     * Clear request cache
+     */
+    clearCache(): void;
+    /**
+     * Clear specific cache entry
+     */
+    clearCacheEntry(key: string): void;
+    /**
+     * Get cache statistics
+     */
+    getCacheStats(): {
+        size: number;
+        hits: number;
+        misses: number;
+        hitRate: number;
+    };
+    /**
+     * Get the configured Oxy Cloud (file storage/CDN) URL
+     */
+    getCloudURL(): string;
+    /**
+     * Set authentication tokens
+     */
+    setTokens(accessToken: string, refreshToken?: string): void;
+    /**
+     * Clear stored authentication tokens
+     */
+    clearTokens(): void;
+    /**
+     * Get the current user ID from the access token
+     * Returns MongoDB ObjectId (never publicKey)
+     */
+    getCurrentUserId(): string | null;
+    /**
+     * Check if the client has a valid access token (public method)
+     */
+    hasValidToken(): boolean;
+    /**
+     * Get the raw access token (for constructing anchor URLs when needed)
+     */
+    getAccessToken(): string | null;
+    /**
+     * Wait for authentication to be ready
+     *
+     * Optimized for high-scale usage with immediate synchronous check and adaptive polling.
+     * Returns immediately if token is already available (0ms delay), otherwise uses
+     * adaptive polling that starts fast (50ms) and gradually increases to reduce CPU usage.
+     *
+     * @param timeoutMs Maximum time to wait in milliseconds (default: 5000ms)
+     * @returns Promise that resolves to true if authentication is ready, false if timeout
+     *
+     * @example
+     * ```typescript
+     * const isReady = await oxyServices.waitForAuth(3000);
+     * if (isReady) {
+     *   // Proceed with authenticated operations
+     * }
+     * ```
+     */
+    waitForAuth(timeoutMs?: number): Promise<boolean>;
+    /**
+     * Execute a function with automatic authentication retry logic
+     * This handles the common case where API calls are made before authentication completes
+     */
+    withAuthRetry<T>(operation: () => Promise<T>, operationName: string, options?: {
+        maxRetries?: number;
+        retryDelay?: number;
+        authTimeoutMs?: number;
+    }): Promise<T>;
+    /**
+     * Validate the current access token with the server
+     */
+    validate(): Promise<boolean>;
+    /**
+     * Centralized error handling
+     */
+    handleError(error: unknown): Error;
+    /**
+     * Health check endpoint
+     */
+    healthCheck(): Promise<{
+        status: string;
+        users?: number;
+        timestamp?: string;
+        [key: string]: any;
+    }>;
+}
+//# sourceMappingURL=OxyServices.base.d.ts.map

package/lib/typescript/core/OxyServices.base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OxyServices.base.d.ts","sourceRoot":"","sources":["../../../src/core/OxyServices.base.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,SAAS,IAAI,aAAa,EAAkB,MAAM,sBAAsB,CAAC;AAEvF,OAAO,EAAE,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAIjE,MAAM,WAAW,SAAU,SAAQ,aAAa;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,qBAAa,eAAe;IACnB,WAAW,EAAE,WAAW,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,CAAC;gBAEb,GAAG,IAAI,EAAE,GAAG,EAAE;IAa1B,MAAM,CAAC,qBAAqB,IAAI,IAAI;IAIpC;;;OAGG;IACU,WAAW,CAAC,CAAC,EACxB,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,EACnD,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,GAAG,EACV,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,CAAC,CAAC;IAcb;;OAEG;IACI,UAAU,IAAI,MAAM;IAI3B;;;OAGG;IACI,SAAS,IAAI,WAAW;IAI/B;;OAEG;IACI,UAAU;;;;;;;;IAIjB;;OAEG;IACI,UAAU,IAAI,IAAI;IAIzB;;OAEG;IACI,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIzC;;OAEG;IACI,aAAa;;;;;;IAIpB;;OAEG;IACI,WAAW,IAAI,MAAM;IAI5B;;OAEG;IACI,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,SAAK,GAAG,IAAI;IAI9D;;OAEG;IACI,WAAW,IAAI,IAAI;IAI1B;;;OAGG;IACI,gBAAgB,IAAI,MAAM,GAAG,IAAI;IAIxC;;OAEG;IACI,aAAa,IAAI,OAAO;IAI/B;;OAEG;IACI,cAAc,IAAI,MAAM,GAAG,IAAI;IAItC;;;;;;;;;;;;;;;;;OAiBG;IACU,WAAW,CAAC,SAAS,SAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IA6B5D;;;OAGG;IACU,aAAa,CAAC,CAAC,EAC1B,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE;QACP,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,aAAa,CAAC,EAAE,MAAM,CAAC;KACnB,GACL,OAAO,CAAC,CAAC,CAAC;IAuDb;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IAgBlC;;OAEG;IACI,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK;IAWzC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC;QAC3B,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KACnB,CAAC;CAWH"}

package/lib/typescript/core/OxyServices.d.ts

@@ -0,0 +1,113 @@
+/**
+ * OxyServices - Unified client for Oxy API and Oxy Cloud
+ *
+ * # Usage Examples
+ *
+ * ## Browser (ESM/TypeScript)
+ *
+ * ```typescript
+ * import { OxyServices } from './core/OxyServices';
+ *
+ * const oxy = new OxyServices({
+ *   baseURL: 'https://api.oxy.so',
+ *   cloudURL: 'https://cloud.oxy.so',
+ * });
+ *
+ * // Authenticate and fetch user
+ * await oxy.setTokens('ACCESS_TOKEN');
+ * const user = await oxy.getCurrentUser();
+ *
+ * // Upload a file (browser File API)
+ * const fileInput = document.querySelector('input[type=file]');
+ * const file = fileInput.files[0];
+ * await oxy.uploadRawFile(file);
+ *
+ * // Get a file download URL for <img src>
+ * const url = oxy.getFileDownloadUrl('fileId', 'thumb');
+ * ```
+ *
+ * ## Node.js (CommonJS/TypeScript)
+ *
+ * ```typescript
+ * import { OxyServices } from './core/OxyServices';
+ * import fs from 'fs';
+ *
+ * const oxy = new OxyServices({
+ *   baseURL: 'https://api.oxy.so',
+ *   cloudURL: 'https://cloud.oxy.so',
+ * });
+ *
+ * // Authenticate and fetch user
+ * await oxy.setTokens('ACCESS_TOKEN');
+ * const user = await oxy.getCurrentUser();
+ *
+ * // Upload a file (Node.js Buffer)
+ * const buffer = fs.readFileSync('myfile.png');
+ * const blob = new Blob([buffer]);
+ * await oxy.uploadRawFile(blob, { filename: 'myfile.png' });
+ *
+ * // Get a file download URL
+ * const url = oxy.getFileDownloadUrl('fileId');
+ * ```
+ *
+ * ## Configuration
+ * - `baseURL`: Oxy API endpoint (e.g., https://api.oxy.so)
+ * - `cloudURL`: Oxy Cloud/CDN endpoint (e.g., https://cloud.oxy.so)
+ *
+ * See method JSDoc for more details and options.
+ */
+import { type OxyConfig } from './OxyServices.base';
+import { OxyAuthenticationError, OxyAuthenticationTimeoutError } from './OxyServices.errors';
+import { composeOxyServices } from './mixins';
+/**
+ * OxyServices - Unified client library for interacting with the Oxy API
+ *
+ * This class provides all API functionality in one simple, easy-to-use interface.
+ *
+ * ## Architecture
+ * - **HttpService**: Unified HTTP service handling authentication, caching, deduplication, queuing, and retry
+ * - **OxyServices**: Provides high-level API methods
+ *
+ * ## Mixin Composition
+ * The class is composed using TypeScript mixins for better code organization:
+ * - **Base**: Core infrastructure (HTTP client, request management, error handling)
+ * - **Auth**: Authentication and session management
+ * - **User**: User profiles, follow, notifications
+ * - **Privacy**: Blocked and restricted users
+ * - **Language**: Language detection and metadata
+ * - **Payment**: Payment processing
+ * - **Karma**: Karma system
+ * - **Assets**: File upload and asset management
+ * - **Developer**: Developer API management
+ * - **Location**: Location-based features
+ * - **Analytics**: Analytics tracking
+ * - **Devices**: Device management
+ * - **Utility**: Utility methods and Express middleware
+ *
+ * @example
+ * ```typescript
+ * const oxy = new OxyServices({
+ *   baseURL: 'https://api.oxy.so',
+ *   cloudURL: 'https://cloud.oxy.so'
+ * });
+ * ```
+ */
+declare const OxyServicesComposed: ReturnType<typeof composeOxyServices>;
+export declare class OxyServices extends OxyServicesComposed {
+    constructor(config: OxyConfig);
+}
+export { OxyAuthenticationError, OxyAuthenticationTimeoutError };
+/**
+ * Export the default Oxy Cloud URL (for backward compatibility)
+ */
+export declare const OXY_CLOUD_URL = "https://cloud.oxy.so";
+/**
+ * Export the default Oxy API URL (for documentation)
+ */
+export declare const OXY_API_URL: any;
+/**
+ * Pre-configured client instance for easy import
+ * Uses OXY_API_URL as baseURL and OXY_CLOUD_URL as cloudURL
+ */
+export declare const oxyClient: OxyServices;
+//# sourceMappingURL=OxyServices.d.ts.map

package/lib/typescript/core/OxyServices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OxyServices.d.ts","sourceRoot":"","sources":["../../../src/core/OxyServices.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AACH,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AAG7F,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,QAAA,MAAM,mBAAmB,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAwB,CAAC;AAGxF,qBAAa,WAAY,SAAQ,mBAAmB;gBACtC,MAAM,EAAE,SAAS;CAG9B;AAGD,OAAO,EAAE,sBAAsB,EAAE,6BAA6B,EAAE,CAAC;AAEjE;;GAEG;AACH,eAAO,MAAM,aAAa,yBAAyB,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,WAAW,KAAqG,CAAC;AAE9H;;;GAGG;AACH,eAAO,MAAM,SAAS,aAAqE,CAAC"}

package/lib/typescript/core/OxyServices.errors.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Custom error types for better error handling
+ */
+export declare class OxyAuthenticationError extends Error {
+    readonly code: string;
+    readonly status: number;
+    constructor(message: string, code?: string, status?: number);
+}
+export declare class OxyAuthenticationTimeoutError extends OxyAuthenticationError {
+    constructor(operationName: string, timeoutMs: number);
+}
+//# sourceMappingURL=OxyServices.errors.d.ts.map