@oxyhq/core 10.2.0 → 11.0.0

package/src/session/__tests__/accountDialogController.test.ts

@@ -5,7 +5,7 @@ import type { SessionLoginResponse, MinimalUserData } from '../../models/session
 import type { AccountNode } from '../../mixins/OxyServices.accounts';
 import { SessionClient, type SessionClientHost } from '../SessionClient';
 import type { MinimalSocket, SocketIOFactory } from '../socketLoader';
-import { logger } from '../../utils/loggerUtils';
+import { logger } from '../../logger';
 import {
   AccountDialogController,
   createAccountDialogController,

package/src/session/accountDialogController.ts

@@ -29,7 +29,7 @@
 import type { OxyServices } from '../OxyServices';
 import type { SessionLoginResponse, MinimalUserData } from '../models/session';
 import type { User } from '../models/interfaces';
-import { logger } from '../utils/loggerUtils';
+import { logger } from '../logger';
 import { extractErrorStatus } from '../utils/errorUtils';
 import { CENTRAL_IDP_APEX } from '../utils/authWebUrl';
 import {

package/src/session/authStateStore.ts

@@ -17,7 +17,7 @@
  * ESM-safe (no `require()`).
  */
 
-import { logger } from '../utils/loggerUtils';
+import { logger } from '../logger';
 
 /**
  * The persisted session credential set for a single origin.

package/src/session/refresh.ts

@@ -26,7 +26,7 @@ import type { AuthRefreshHandler, AuthRefreshReason } from '../HttpService';
 import type { AuthStateStore, PersistedAuthState } from './authStateStore';
 import { isNative } from '../utils/platform';
 import { extractErrorStatus } from '../utils/errorUtils';
-import { logger } from '../utils/loggerUtils';
+import { logger } from '../logger';
 
 /**
  * Lead time (ms) before access-token expiry at which the proactive scheduler

package/src/session/socketLoader.ts

@@ -1,4 +1,4 @@
-import { logger } from '../utils/loggerUtils';
+import { logger } from '../logger';
 
 export interface MinimalSocket {
   connected: boolean;

package/src/utils/asyncUtils.ts

@@ -2,7 +2,7 @@
  * Async utilities for common asynchronous patterns and error handling
  */
 
-import { logger } from './loggerUtils';
+import { logger } from '../logger';
 
 /**
  * Wrapper for async operations with automatic error handling

package/src/utils/avatarUtils.ts

@@ -1,3 +1,5 @@
+import { logger } from '../logger';
+
 /**
  * Minimal interface for services that can update asset visibility.
  * Kept loose to avoid mixin type-inference issues with the OxyServices class.
@@ -31,7 +33,7 @@ export async function updateAvatarVisibility(
       ? (visError as Error & { status: number }).status
       : undefined;
     if (status !== 404) {
-      console.error(`[${contextName}] Failed to update avatar visibility for ${fileId}:`, visError);
+      logger.error(`[${contextName}] Failed to update avatar visibility for ${fileId}`, visError, { component: contextName });
     }
   }
 }

package/src/utils/deviceManager.ts

@@ -1,4 +1,7 @@
 import { loadAsyncStorage } from '@oxyhq/protocol';
+import { createLogger } from '../logger';
+
+const log = createLogger('DeviceManager');
 
 export interface DeviceFingerprint {
   userAgent: string;
@@ -55,7 +58,7 @@ export class DeviceManager {
           removeItem: storage.removeItem.bind(storage),
         };
       } catch (error) {
-        console.error('AsyncStorage not available in React Native:', error);
+        log.error('AsyncStorage not available in React Native', error);
         throw new Error('AsyncStorage is required in React Native environment');
       }
     } else {
@@ -112,7 +115,7 @@ export class DeviceManager {
       // Create new device info
       return await this.createNewDeviceInfo();
     } catch (error) {
-      console.error('Error getting device info:', error);
+      log.error('Error getting device info', error);
       return await this.createNewDeviceInfo();
     }
   }
@@ -140,7 +143,7 @@ export class DeviceManager {
       const storage = await this.getStorage();
       await storage.setItem(this.DEVICE_KEY, JSON.stringify(deviceInfo));
     } catch (error) {
-      console.error('Error saving device info:', error);
+      log.error('Error saving device info', error);
     }
   }
 
@@ -153,7 +156,7 @@ export class DeviceManager {
       deviceInfo.deviceName = deviceName;
       await this.saveDeviceInfo(deviceInfo);
     } catch (error) {
-      console.error('Error updating device name:', error);
+      log.error('Error updating device name', error);
     }
   }
 
@@ -165,7 +168,7 @@ export class DeviceManager {
       const storage = await this.getStorage();
       await storage.removeItem(this.DEVICE_KEY);
     } catch (error) {
-      console.error('Error clearing device info:', error);
+      log.error('Error clearing device info', error);
     }
   }
 

package/src/utils/errorUtils.ts

@@ -1,5 +1,5 @@
 import type { ApiError } from '../models/interfaces';
-import { logger } from './loggerUtils';
+import { logger } from '../logger';
 
 /**
  * Error handling utilities for consistent error processing

package/src/utils/oauthPkce.ts

@@ -17,7 +17,7 @@
  */
 
 import { isNodeJS, isReactNative, loadExpoCrypto, loadNodeCrypto, sha256 } from '@oxyhq/protocol';
-import { logger } from './loggerUtils';
+import { logger } from '../logger';
 
 /** The central Oxy IdP authorization endpoint used by default. */
 export const OXY_AUTHORIZE_URL = 'https://auth.oxy.so/authorize';

package/src/utils/requestUtils.ts

@@ -169,7 +169,7 @@ 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
+ * For structured, namespaced, level-gated logging, use `@oxyhq/core/logger`.
  *
  * @example
  * ```typescript

package/dist/cjs/shared/utils/debugUtils.js

@@ -1,80 +0,0 @@
-"use strict";
-/**
- * Debug Utilities
- *
- * Provides safe logging functions that only output in development mode.
- * All logs are stripped in production builds.
- *
- * @module shared/utils/debugUtils
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createDebugLogger = exports.debugError = exports.debugWarn = exports.debugLog = exports.isDev = void 0;
-/**
- * Check if running in development mode
- */
-const isDev = () => {
-    if (typeof __DEV__ !== 'undefined')
-        return __DEV__;
-    try {
-        return typeof process !== 'undefined' && process.env?.NODE_ENV === 'development';
-    }
-    catch {
-        return false;
-    }
-};
-exports.isDev = isDev;
-/**
- * Log a debug message (only in development)
- * @param prefix - Log prefix (e.g., '[ColdBoot]')
- * @param args - Arguments to log
- */
-const debugLog = (prefix, ...args) => {
-    if ((0, exports.isDev)()) {
-        console.log(prefix, ...args);
-    }
-};
-exports.debugLog = debugLog;
-/**
- * Log a debug warning (only in development)
- * @param prefix - Log prefix
- * @param args - Arguments to log
- */
-const debugWarn = (prefix, ...args) => {
-    if ((0, exports.isDev)()) {
-        console.warn(prefix, ...args);
-    }
-};
-exports.debugWarn = debugWarn;
-/**
- * Log a debug error (only in development)
- * @param prefix - Log prefix
- * @param args - Arguments to log
- */
-const debugError = (prefix, ...args) => {
-    if ((0, exports.isDev)()) {
-        console.error(prefix, ...args);
-    }
-};
-exports.debugError = debugError;
-/**
- * Create a namespaced debug logger
- * @param namespace - Logger namespace (e.g., 'ColdBoot', 'DeviceAuth')
- * @returns Object with log, warn, error methods
- *
- * @example
- * ```ts
- * const debug = createDebugLogger('ColdBoot');
- * debug.log('Starting authentication');
- * debug.warn('Token expires soon');
- * debug.error('Authentication failed', error);
- * ```
- */
-const createDebugLogger = (namespace) => {
-    const prefix = `[${namespace}]`;
-    return {
-        log: (...args) => (0, exports.debugLog)(prefix, ...args),
-        warn: (...args) => (0, exports.debugWarn)(prefix, ...args),
-        error: (...args) => (0, exports.debugError)(prefix, ...args),
-    };
-};
-exports.createDebugLogger = createDebugLogger;

package/dist/cjs/utils/loggerUtils.js

@@ -1,126 +0,0 @@
-"use strict";
-/**
- * Centralized logging utilities for consistent logging across the application
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.logPerformance = exports.logError = exports.logPayment = exports.logDevice = exports.logUser = exports.logSession = exports.logApi = exports.logAuth = exports.logger = exports.LogLevel = void 0;
-var LogLevel;
-(function (LogLevel) {
-    LogLevel[LogLevel["DEBUG"] = 0] = "DEBUG";
-    LogLevel[LogLevel["INFO"] = 1] = "INFO";
-    LogLevel[LogLevel["WARN"] = 2] = "WARN";
-    LogLevel[LogLevel["ERROR"] = 3] = "ERROR";
-    LogLevel[LogLevel["NONE"] = 4] = "NONE";
-})(LogLevel || (exports.LogLevel = LogLevel = {}));
-class Logger {
-    constructor() {
-        this.level = LogLevel.INFO;
-        this.isDevelopment = process.env.NODE_ENV === 'development';
-    }
-    setLevel(level) {
-        this.level = level;
-    }
-    shouldLog(level) {
-        return level >= this.level;
-    }
-    formatMessage(level, message, context) {
-        const timestamp = new Date().toISOString();
-        const contextStr = context ? ` [${Object.entries(context).map(([k, v]) => `${k}:${v}`).join(', ')}]` : '';
-        return `[${timestamp}] ${level}${contextStr}: ${message}`;
-    }
-    debug(message, context, ...args) {
-        if (this.shouldLog(LogLevel.DEBUG)) {
-            const formattedMessage = this.formatMessage('DEBUG', message, context);
-            if (this.isDevelopment) {
-                console.log(formattedMessage, ...args);
-            }
-        }
-    }
-    info(message, context, ...args) {
-        if (this.shouldLog(LogLevel.INFO)) {
-            const formattedMessage = this.formatMessage('INFO', message, context);
-            console.log(formattedMessage, ...args);
-        }
-    }
-    warn(message, context, ...args) {
-        if (this.shouldLog(LogLevel.WARN)) {
-            const formattedMessage = this.formatMessage('WARN', message, context);
-            console.warn(formattedMessage, ...args);
-        }
-    }
-    error(message, error, context, ...args) {
-        if (this.shouldLog(LogLevel.ERROR)) {
-            const formattedMessage = this.formatMessage('ERROR', message, context);
-            if (error) {
-                console.error(formattedMessage, error, ...args);
-            }
-            else {
-                console.error(formattedMessage, ...args);
-            }
-        }
-    }
-    // Specialized logging methods for common patterns
-    auth(message, context, ...args) {
-        this.info(`🔐 ${message}`, { ...context, category: 'auth' }, ...args);
-    }
-    api(message, context, ...args) {
-        this.info(`🌐 ${message}`, { ...context, category: 'api' }, ...args);
-    }
-    session(message, context, ...args) {
-        this.info(`📱 ${message}`, { ...context, category: 'session' }, ...args);
-    }
-    user(message, context, ...args) {
-        this.info(`👤 ${message}`, { ...context, category: 'user' }, ...args);
-    }
-    device(message, context, ...args) {
-        this.info(`📱 ${message}`, { ...context, category: 'device' }, ...args);
-    }
-    payment(message, context, ...args) {
-        this.info(`💳 ${message}`, { ...context, category: 'payment' }, ...args);
-    }
-    // Performance logging
-    performance(operation, duration, context) {
-        const level = duration > 1000 ? LogLevel.WARN : LogLevel.INFO;
-        const message = `⏱️ ${operation} completed in ${duration}ms`;
-        if (level === LogLevel.WARN) {
-            this.warn(message, { ...context, category: 'performance', duration });
-        }
-        else {
-            this.info(message, { ...context, category: 'performance', duration });
-        }
-    }
-    // Error logging with stack trace
-    errorWithStack(message, error, context) {
-        this.error(message, error, { ...context, stack: error.stack });
-    }
-    // Group related log messages
-    group(label, fn) {
-        if (this.isDevelopment && this.shouldLog(LogLevel.DEBUG)) {
-            console.group(label);
-            fn();
-            console.groupEnd();
-        }
-        else {
-            fn();
-        }
-    }
-}
-// Create singleton instance
-exports.logger = new Logger();
-// Convenience functions for common logging patterns
-const logAuth = (message, context, ...args) => exports.logger.auth(message, context, ...args);
-exports.logAuth = logAuth;
-const logApi = (message, context, ...args) => exports.logger.api(message, context, ...args);
-exports.logApi = logApi;
-const logSession = (message, context, ...args) => exports.logger.session(message, context, ...args);
-exports.logSession = logSession;
-const logUser = (message, context, ...args) => exports.logger.user(message, context, ...args);
-exports.logUser = logUser;
-const logDevice = (message, context, ...args) => exports.logger.device(message, context, ...args);
-exports.logDevice = logDevice;
-const logPayment = (message, context, ...args) => exports.logger.payment(message, context, ...args);
-exports.logPayment = logPayment;
-const logError = (message, error, context, ...args) => exports.logger.error(message, error, context, ...args);
-exports.logError = logError;
-const logPerformance = (operation, duration, context) => exports.logger.performance(operation, duration, context);
-exports.logPerformance = logPerformance;

package/dist/esm/shared/utils/debugUtils.js

@@ -1,72 +0,0 @@
-/**
- * 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 const isDev = () => {
-    if (typeof __DEV__ !== 'undefined')
-        return __DEV__;
-    try {
-        return typeof process !== 'undefined' && process.env?.NODE_ENV === 'development';
-    }
-    catch {
-        return false;
-    }
-};
-/**
- * Log a debug message (only in development)
- * @param prefix - Log prefix (e.g., '[ColdBoot]')
- * @param args - Arguments to log
- */
-export const debugLog = (prefix, ...args) => {
-    if (isDev()) {
-        console.log(prefix, ...args);
-    }
-};
-/**
- * Log a debug warning (only in development)
- * @param prefix - Log prefix
- * @param args - Arguments to log
- */
-export const debugWarn = (prefix, ...args) => {
-    if (isDev()) {
-        console.warn(prefix, ...args);
-    }
-};
-/**
- * Log a debug error (only in development)
- * @param prefix - Log prefix
- * @param args - Arguments to log
- */
-export const debugError = (prefix, ...args) => {
-    if (isDev()) {
-        console.error(prefix, ...args);
-    }
-};
-/**
- * Create a namespaced debug logger
- * @param namespace - Logger namespace (e.g., 'ColdBoot', 'DeviceAuth')
- * @returns Object with log, warn, error methods
- *
- * @example
- * ```ts
- * const debug = createDebugLogger('ColdBoot');
- * debug.log('Starting authentication');
- * debug.warn('Token expires soon');
- * debug.error('Authentication failed', error);
- * ```
- */
-export const createDebugLogger = (namespace) => {
-    const prefix = `[${namespace}]`;
-    return {
-        log: (...args) => debugLog(prefix, ...args),
-        warn: (...args) => debugWarn(prefix, ...args),
-        error: (...args) => debugError(prefix, ...args),
-    };
-};

package/dist/esm/utils/loggerUtils.js

@@ -1,115 +0,0 @@
-/**
- * Centralized logging utilities for consistent logging across the application
- */
-export var LogLevel;
-(function (LogLevel) {
-    LogLevel[LogLevel["DEBUG"] = 0] = "DEBUG";
-    LogLevel[LogLevel["INFO"] = 1] = "INFO";
-    LogLevel[LogLevel["WARN"] = 2] = "WARN";
-    LogLevel[LogLevel["ERROR"] = 3] = "ERROR";
-    LogLevel[LogLevel["NONE"] = 4] = "NONE";
-})(LogLevel || (LogLevel = {}));
-class Logger {
-    constructor() {
-        this.level = LogLevel.INFO;
-        this.isDevelopment = process.env.NODE_ENV === 'development';
-    }
-    setLevel(level) {
-        this.level = level;
-    }
-    shouldLog(level) {
-        return level >= this.level;
-    }
-    formatMessage(level, message, context) {
-        const timestamp = new Date().toISOString();
-        const contextStr = context ? ` [${Object.entries(context).map(([k, v]) => `${k}:${v}`).join(', ')}]` : '';
-        return `[${timestamp}] ${level}${contextStr}: ${message}`;
-    }
-    debug(message, context, ...args) {
-        if (this.shouldLog(LogLevel.DEBUG)) {
-            const formattedMessage = this.formatMessage('DEBUG', message, context);
-            if (this.isDevelopment) {
-                console.log(formattedMessage, ...args);
-            }
-        }
-    }
-    info(message, context, ...args) {
-        if (this.shouldLog(LogLevel.INFO)) {
-            const formattedMessage = this.formatMessage('INFO', message, context);
-            console.log(formattedMessage, ...args);
-        }
-    }
-    warn(message, context, ...args) {
-        if (this.shouldLog(LogLevel.WARN)) {
-            const formattedMessage = this.formatMessage('WARN', message, context);
-            console.warn(formattedMessage, ...args);
-        }
-    }
-    error(message, error, context, ...args) {
-        if (this.shouldLog(LogLevel.ERROR)) {
-            const formattedMessage = this.formatMessage('ERROR', message, context);
-            if (error) {
-                console.error(formattedMessage, error, ...args);
-            }
-            else {
-                console.error(formattedMessage, ...args);
-            }
-        }
-    }
-    // Specialized logging methods for common patterns
-    auth(message, context, ...args) {
-        this.info(`🔐 ${message}`, { ...context, category: 'auth' }, ...args);
-    }
-    api(message, context, ...args) {
-        this.info(`🌐 ${message}`, { ...context, category: 'api' }, ...args);
-    }
-    session(message, context, ...args) {
-        this.info(`📱 ${message}`, { ...context, category: 'session' }, ...args);
-    }
-    user(message, context, ...args) {
-        this.info(`👤 ${message}`, { ...context, category: 'user' }, ...args);
-    }
-    device(message, context, ...args) {
-        this.info(`📱 ${message}`, { ...context, category: 'device' }, ...args);
-    }
-    payment(message, context, ...args) {
-        this.info(`💳 ${message}`, { ...context, category: 'payment' }, ...args);
-    }
-    // Performance logging
-    performance(operation, duration, context) {
-        const level = duration > 1000 ? LogLevel.WARN : LogLevel.INFO;
-        const message = `⏱️ ${operation} completed in ${duration}ms`;
-        if (level === LogLevel.WARN) {
-            this.warn(message, { ...context, category: 'performance', duration });
-        }
-        else {
-            this.info(message, { ...context, category: 'performance', duration });
-        }
-    }
-    // Error logging with stack trace
-    errorWithStack(message, error, context) {
-        this.error(message, error, { ...context, stack: error.stack });
-    }
-    // Group related log messages
-    group(label, fn) {
-        if (this.isDevelopment && this.shouldLog(LogLevel.DEBUG)) {
-            console.group(label);
-            fn();
-            console.groupEnd();
-        }
-        else {
-            fn();
-        }
-    }
-}
-// Create singleton instance
-export const logger = new Logger();
-// Convenience functions for common logging patterns
-export const logAuth = (message, context, ...args) => logger.auth(message, context, ...args);
-export const logApi = (message, context, ...args) => logger.api(message, context, ...args);
-export const logSession = (message, context, ...args) => logger.session(message, context, ...args);
-export const logUser = (message, context, ...args) => logger.user(message, context, ...args);
-export const logDevice = (message, context, ...args) => logger.device(message, context, ...args);
-export const logPayment = (message, context, ...args) => logger.payment(message, context, ...args);
-export const logError = (message, error, context, ...args) => logger.error(message, error, context, ...args);
-export const logPerformance = (operation, duration, context) => logger.performance(operation, duration, context);

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

@@ -1,48 +0,0 @@
-/**
- * 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., '[ColdBoot]')
- * @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., 'ColdBoot', 'DeviceAuth')
- * @returns Object with log, warn, error methods
- *
- * @example
- * ```ts
- * const debug = createDebugLogger('ColdBoot');
- * 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;
-};

package/dist/types/utils/loggerUtils.d.ts

@@ -1,48 +0,0 @@
-/**
- * Centralized logging utilities for consistent logging across the application
- */
-export declare enum LogLevel {
-    DEBUG = 0,
-    INFO = 1,
-    WARN = 2,
-    ERROR = 3,
-    NONE = 4
-}
-export interface LogContext {
-    component?: string;
-    method?: string;
-    userId?: string;
-    sessionId?: string;
-    requestId?: string;
-    [key: string]: unknown;
-}
-declare class Logger {
-    private level;
-    private isDevelopment;
-    setLevel(level: LogLevel): void;
-    private shouldLog;
-    private formatMessage;
-    debug(message: string, context?: LogContext, ...args: unknown[]): void;
-    info(message: string, context?: LogContext, ...args: unknown[]): void;
-    warn(message: string, context?: LogContext, ...args: unknown[]): void;
-    error(message: string, error?: Error | unknown, context?: LogContext, ...args: unknown[]): void;
-    auth(message: string, context?: LogContext, ...args: unknown[]): void;
-    api(message: string, context?: LogContext, ...args: unknown[]): void;
-    session(message: string, context?: LogContext, ...args: unknown[]): void;
-    user(message: string, context?: LogContext, ...args: unknown[]): void;
-    device(message: string, context?: LogContext, ...args: unknown[]): void;
-    payment(message: string, context?: LogContext, ...args: unknown[]): void;
-    performance(operation: string, duration: number, context?: LogContext): void;
-    errorWithStack(message: string, error: Error, context?: LogContext): void;
-    group(label: string, fn: () => void): void;
-}
-export declare const logger: Logger;
-export declare const logAuth: (message: string, context?: LogContext, ...args: unknown[]) => void;
-export declare const logApi: (message: string, context?: LogContext, ...args: unknown[]) => void;
-export declare const logSession: (message: string, context?: LogContext, ...args: unknown[]) => void;
-export declare const logUser: (message: string, context?: LogContext, ...args: unknown[]) => void;
-export declare const logDevice: (message: string, context?: LogContext, ...args: unknown[]) => void;
-export declare const logPayment: (message: string, context?: LogContext, ...args: unknown[]) => void;
-export declare const logError: (message: string, error?: Error | unknown, context?: LogContext, ...args: unknown[]) => void;
-export declare const logPerformance: (operation: string, duration: number, context?: LogContext) => void;
-export {};