feat: add setLogger

Author: Minishlink

docs/api-js/README.md

@@ -29,6 +29,7 @@
 
 - [DownloadProgressCallback](type-aliases/DownloadProgressCallback.md)
 - [HandleBinaryVersionMismatchCallback](type-aliases/HandleBinaryVersionMismatchCallback.md)
+- [LoggerFunction](type-aliases/LoggerFunction.md)
 - [SyncStatusChangedCallback](type-aliases/SyncStatusChangedCallback.md)
 
 ## Variables
@@ -48,8 +49,10 @@
 - [getUpdateMetadata](functions/getUpdateMetadata.md)
 - [notifyAppReady](functions/notifyAppReady.md)
 - [resetClientUniqueId](functions/resetClientUniqueId.md)
+- [resetLogger](functions/resetLogger.md)
 - [restartApp](functions/restartApp.md)
 - [setDataTransmissionEnabled](functions/setDataTransmissionEnabled.md)
+- [setLogger](functions/setLogger.md)
 - [setLogLevel](functions/setLogLevel.md)
 - [setTelemetryEnabled](functions/setTelemetryEnabled.md)
 - [sync](functions/sync.md)

docs/api-js/enumerations/LogLevel.md

@@ -6,6 +6,8 @@
 
 # Enumeration: LogLevel
 
+Used to categorize log messages by their severity and importance.
+
 ## Enumeration Members
 
 ### DEBUG

docs/api-js/functions/resetLogger.md

@@ -0,0 +1,15 @@
+[**@appzung/react-native-code-push v11.0.0-rc5**](../README.md)
+
+---
+
+[@appzung/react-native-code-push](../README.md) / resetLogger
+
+# Function: resetLogger()
+
+> **resetLogger**(): `void`
+
+Reset the logger to the default implementation
+
+## Returns
+
+`void`

docs/api-js/functions/setLogger.md

@@ -0,0 +1,40 @@
+[**@appzung/react-native-code-push v11.0.0-rc5**](../README.md)
+
+---
+
+[@appzung/react-native-code-push](../README.md) / setLogger
+
+# Function: setLogger()
+
+> **setLogger**(`logger`): `void`
+
+Set a custom logger function to handle all CodePush logs
+
+## Parameters
+
+### logger
+
+[`LoggerFunction`](../type-aliases/LoggerFunction.md)
+
+A function that takes a log level and message and handles the logging
+
+## Returns
+
+`void`
+
+## Example
+
+```
+import { setLogger, LogLevel } from '@appzung/react-native-code-push';
+
+// Custom logger that sends critical logs to a crash reporting service
+setLogger((level, message) => {
+  // Always log to console
+  console.log(`[CodePush] ${message}`);
+
+  // Send error logs to crash reporting
+  if (level === LogLevel.ERROR) {
+    MyCrashReportingService.log(`CodePush error: ${message}`);
+  }
+});
+```

docs/api-js/type-aliases/LoggerFunction.md

@@ -0,0 +1,23 @@
+[**@appzung/react-native-code-push v11.0.0-rc5**](../README.md)
+
+---
+
+[@appzung/react-native-code-push](../README.md) / LoggerFunction
+
+# Type Alias: LoggerFunction()
+
+> **LoggerFunction**: (`level`, `message`) => `void`
+
+## Parameters
+
+### level
+
+[`LogLevel`](../enumerations/LogLevel.md)
+
+### message
+
+`string`
+
+## Returns
+
+`void`

src/enums/LogLevel.enum.ts

@@ -1,3 +1,6 @@
+/**
+ * Used to categorize log messages by their severity and importance.
+ */
 export enum LogLevel {
   DEBUG,
   INFO,

src/index.ts

@@ -11,6 +11,7 @@ export * from './sync';
 export * from './getClientUniqueId';
 export * from './resetClientUniqueId';
 export * from './logLevel';
+export * from './logger';
 export * from './telemetry';
 export * from './dataTransmission';
 

src/internals/logger.ts

@@ -0,0 +1,46 @@
+import type { LogLevel } from '../enums/LogLevel.enum';
+
+export type LoggerFunction = (level: LogLevel, message: string) => void;
+
+const defaultLogger: LoggerFunction = (_level: LogLevel, message: string): void => {
+  console.log(`[CodePush] ${message}`);
+};
+
+let currentLogger: LoggerFunction = defaultLogger;
+
+/**
+ * Set a custom logger function to handle all CodePush logs
+ *
+ * @param logger A function that takes a log level and message and handles the logging
+ * @example
+ * ```
+ * import { setLogger, LogLevel } from '@appzung/react-native-code-push';
+ *
+ * // Custom logger that sends critical logs to a crash reporting service
+ * setLogger((level, message) => {
+ *   // Always log to console
+ *   console.log(`[CodePush] ${message}`);
+ *
+ *   // Send error logs to crash reporting
+ *   if (level === LogLevel.ERROR) {
+ *     MyCrashReportingService.log(`CodePush error: ${message}`);
+ *   }
+ * });
+ * ```
+ */
+export const setLogger = (logger: LoggerFunction): void => {
+  currentLogger = logger;
+};
+
+/**
+ * Get the current logger function
+ * @returns The current logger function
+ */
+export const getLogger = (): LoggerFunction => currentLogger;
+
+/**
+ * Reset the logger to the default implementation
+ */
+export const resetLogger = (): void => {
+  currentLogger = defaultLogger;
+};

src/internals/utils/log.ts

@@ -1,12 +1,14 @@
 import type { LogLevel } from '../../enums/LogLevel.enum';
 import { getLogLevel } from '../../logLevel';
+import { getLogger } from '../logger';
 
-/* Logs messages to console with the [CodePush] prefix */
+/* Logs messages using the configured logger */
 export function log(level: LogLevel, message: string): void {
   const currentLogLevel = getLogLevel();
   if (level < currentLogLevel) {
     return;
   }
 
-  console.log(`[CodePush] ${message}`);
+  const logger = getLogger();
+  logger(level, message);
 }

src/logger.ts

@@ -0,0 +1,2 @@
+export { setLogger, resetLogger } from './internals/logger';
+export type { LoggerFunction } from './internals/logger';