Variable TrustPinConst

Type Declaration

• awaitConfiguration: function

  • awaitConfiguration(timeoutMs?: number): Promise<void>

    Fail-closed readiness gate: resolves once the signed pinning configuration has been fetched, verified, and activated. timeoutMs undefined → native default (the native SDK clamps to its supported range, currently 10–120s). Rejects with FETCH_CERTIFICATE_TIMEOUT when the bound is exceeded.

    Parameters

    • OptionaltimeoutMs: number

    Returns Promise<void>

• isConfigurationLoaded: function

  • isConfigurationLoaded(): Promise<boolean>

    Whether a validated configuration is currently loaded.

    Returns Promise<boolean>

• onLogEvent: function

  • onLogEvent(
        listener: (event: TrustPinLogEvent) => void,
    ): TrustPinEventSubscription

    Subscribes to native TrustPin log messages (already filtered by the configured log level). Buffered early messages replay to the first subscriber.

    Parameters

    • listener: (event: TrustPinLogEvent) => void

    Returns TrustPinEventSubscription

• onValidationEvent: function

  • onValidationEvent(
        listener: (event: TrustPinValidationEvent) => void,
    ): TrustPinEventSubscription

    Subscribes to definitive validation verdicts. Events buffered from before JS was alive are replayed to the first subscriber. Throws TrustPinError(INVALID_PROJECT_CONFIG) if the native module is missing.

    Parameters

    • listener: (event: TrustPinValidationEvent) => void

    Returns TrustPinEventSubscription

• setLogLevel: function

  • setLogLevel(level: TrustPinLogLevel): Promise<void>

    Sets native log verbosity. Full startup coverage requires the native init helper's log-level parameter; this call adjusts verbosity at runtime.

    Parameters

    • level: TrustPinLogLevel

    Returns Promise<void>

• validateConnection: function

  • validateConnection(
        host: string,
        port?: number,
        timeoutMs?: number,
    ): Promise<void>

    Manually validates the TLS certificate of host:port against the pinning configuration (validated natively; certificate material stays native). Resolves on success; rejects with a stable code otherwise.

    Parameters

    • host: string
    • port: number = 443
    • OptionaltimeoutMs: number

    Returns Promise<void>