How to Customize Logging#

SDK Layer#

// In AppDelegate.application(_:didFinishLaunchingWithOptions:)
HaapiLogger.followUpTags = DriverFollowUpTag.allCases + SdkFollowUpTag.allCases
HaapiLogger.setLogType(LogType.info)
// isSensitiveValueMasked defaults to true; leave it that way in production.

UI Layer#

Add the UI follow-up tags on top of the Driver + SDK sets:

HaapiLogger.followUpTags = DriverFollowUpTag.allCases
    + SdkFollowUpTag.allCases
    + UIKitFollowUpTag.allCases
HaapiLogger.setLogType(LogType.info)

Without UIKitFollowUpTag.allCases, every UI-layer record is silently suppressed — a common cause of “the SDK looks fine but the screens log nothing”.

SDK Layer#

// In Application.onCreate
HaapiLogger.enabled = true
HaapiLogger.setLevel(HaapiLogger.LogLevel.INFO)
// isSensitiveValueMasked defaults to true; leave it that way in production.

UI Layer#

Same call — the UI-layer records flow through alongside Driver and SDK once the logger is enabled. Filter at the sink (next step) or by LogCat tag prefix (logcat -s 'HAAPI_UI_*:V').

React Native has only an SDK Layer surface. getRNLogger is a singleton factory — call it once at startup with the configuration; subsequent calls return the same instance. The configuration is forwarded to the native iOS and Android loggers atomically:

import { getRNLogger, RNLogLevel, initializeForHaapi } from 'identityserver.haapi.reactnative.sdk'

const logger = getRNLogger({
    logLevel: RNLogLevel.Info,           // Info | Debug | Trace | Warn | Error
    isSensitiveValueMasked: true,         // keep true outside local development
})

const accessor = await initializeForHaapi(haapiConfig, logger)

Records emitted by both native layers (iOS and Android) reach the JS side through a single event channel. Tag prefixes (HAAPI_DRIVER_*, HAAPI_SDK_*) survive the bridge — filter them in your sink, not at the native side.

final class CrashReporterLogSink: LogSink {
    func log(
        level: LogType,
        tag: FollowUpTag,
        message: String,
        file: String,
        line: Int
    ) {
        // Forward to your crash reporter
        MyCrashReporter.log(
            level: level.rawValue,
            tag: "\(tag)",
            message: message,
            file: file,
            line: line
        )
    }
}

HaapiLogger.add(sink: CrashReporterLogSink())

class CrashReporterLogSink : LogSink {
    override fun log(
        level: HaapiLogger.LogLevel,
        tag: String,
        message: String,
        file: String,
        line: Int
    ) {
        // Forward to your crash reporter
        MyCrashReporter.log(level.name, tag, message, file, line)
    }
}

HaapiLogger.addSink(CrashReporterLogSink())

import type { RNLogEvent } from 'identityserver.haapi.reactnative.sdk'

const sinkHandle = logger.addSink((event: RNLogEvent) => {
    // Forward to your crash reporter / analytics pipeline.
    MyCrashReporter.log(event.level, event.tag, event.message, event.file, event.line)
    // Keep this fast — sinks fire on the JS thread synchronously.
})

// Later: sinkHandle.remove() to detach the sink.

RN sinks run on the JS thread (unlike native sinks, which run on the calling native thread). For heavy work — network I/O, large serialisation — post to a worker or queue and return immediately.