Class TunnelInstance

setAdditionalForwardingCallback

• setAdditionalForwardingCallback(
      callback: (
          payload: {
              bindAddress: string;
              errorMessage: string | null;
              forwardToAddr: string;
          },
      ) => void,
  ): void

  Sets a callback function to receive AdditionalForwarding events.

  Delegates to Tunnel#setAdditionalForwardingCallback.

  Parameters

  • callback: (
        payload: {
            bindAddress: string;
            errorMessage: string | null;
            forwardToAddr: string;
        },
    ) => void

    The callback function to receive AdditionalForwarding events.

  Returns void

  Throws

  If the tunnel is not initialized.

setTunnelDisconnectedCallback

• setTunnelDisconnectedCallback(
      callback: (payload: { error: string; messages: string[] }) => void,
  ): void

  Sets a callback function to receive disconnected events.

  Delegates to Tunnel#setTunnelDisconnectedCallback.

  Parameters

  • callback: (payload: { error: string; messages: string[] }) => void

    The callback function to receive disconnected events.

  Returns void

  Throws

  If the tunnel is not initialized.

setTunnelErrorCallback

• setTunnelErrorCallback(
      callback: (
          payload: { error: string; errorNo: number; recoverable: boolean },
      ) => void,
  ): void

  Sets a callback function to receive errors.

  Delegates to Tunnel#setTunnelErrorCallback.

  Parameters

  • callback: (payload: { error: string; errorNo: number; recoverable: boolean }) => void

    The callback function to receive errors.

  Returns void

  Throws

  If the tunnel is not initialized.

setTunnelEstablishedCallback

• setTunnelEstablishedCallback(
      callback: (payload: { message: string; urls?: string[] }) => void,
  ): void

  Sets a callback function to receive Tunnel established events.

  Delegates to Tunnel#setTunnelEstablishedCallback.

  Parameters

  • callback: (payload: { message: string; urls?: string[] }) => void

    The callback function to receive Tunnel established events.

  Returns void

  Throws

  If the tunnel is not initialized.

setTunnelForwardingChangedCallback

• setTunnelForwardingChangedCallback(
      callback: (payload: { address?: string[]; message: string }) => void,
  ): void

  Sets a callback function to receive Forwarding changed events.

  Delegates to Tunnel#setOnTunnelForwardingChanged.

  Parameters

  • callback: (payload: { address?: string[]; message: string }) => void

    The callback function to receive Forwarding change events.

  Returns void

  Throws

  If the tunnel is not initialized.

setUsageUpdateCallback

• setUsageUpdateCallback(callback: (payload: TunnelUsageType) => void): void

  Sets a callback function to receive usage updates.

  Delegates to Tunnel#setUsageUpdateCallback.

  Parameters

  • callback: (payload: TunnelUsageType) => void

    The callback function to receive usage updates.

  Returns void

  Throws

  If the tunnel is not initialized.

setWorkerErrorCallback

• setWorkerErrorCallback(callback: Function): void

  Registers a callback function to receive errors from the tunnel worker. It is recommended to always set this callback to ensure your program exits gracefully, since if the tunnel worker exits, the tunnel is no longer active.

  Parameters

  • callback: Function

    The callback function to receive errors.

  Returns void

getAllowPreflight

• getAllowPreflight(): Promise<boolean | null>

  Retrieves Allow-Preflight configuration for this tunnel instance.

  Returns Promise<boolean | null>

  The Allow-Preflight sconfig

getArgument

• getArgument(): Promise<string | null>

  Gets the current argument string for the tunnel configuration.

  Delegates to Config#getArgument.

  Returns Promise<string | null>

  The argument string, or null if unavailable.

getAutoReconnect

• getAutoReconnect(): Promise<boolean | null>

  Returns auto-reconnect configuration for this tunnel instance.

  Returns Promise<boolean | null>

  The auto-reconnect setting, or null if not configured.

getBasicAuth

• getBasicAuth(): Promise<string[] | null>

  Retrieves the basic authentication values from the instance configuration.

  Returns Promise<string[] | null>

  An array of basic auth credentials when configured, or null if none are set.

getBearerTokenAuth

• getBearerTokenAuth(): Promise<string[]>

  Returns bearer token authentication values defined in the configuration.

  Returns Promise<string[]>

  An array of bearer token strings if present; otherwise an empty array.

getConfig

• getConfig(): Promise<PinggyOptions | null>

  Returns the current tunnel configuration as a PinggyOptions object. Extracts values from the instance and parses argument strings for advanced options.

  Returns Promise<PinggyOptions | null>

  The tunnel configuration, or null if unavailable.

getForce

• getForce(): Promise<boolean | null>

  Gets the current force configuration setting for the tunnel.

  Delegates to Config#getForce.

  Returns Promise<boolean | null>

  The force setting, or null if unavailable.

getForwarding

• getForwarding(): Promise<string | null>

  Gets the forwarding rules configuration. Returns a JSON string containing all forwarding rules configured for this tunnel. Delegates to Config#getForwarding.

  Returns Promise<string | null>

  The tunnel type, or null if unavailable.

getHeaderModification

• getHeaderModification(): Promise<string[] | null>

  Returns header modification values defined in the configuration.

  Returns Promise<string[] | null>

  An array of header modification objects if present; otherwise null.

getHttpsOnly

• getHttpsOnly(): Promise<boolean | null>

  Returns whether HTTPS-only mode is enabled for the tunnel instance.

  Returns Promise<boolean | null>

  true if HTTPS-only mode is enabled, false if disabled, or null if the configuration is unavailable.

getIpWhiteList

• getIpWhiteList(): Promise<string[]>

  Retrieves IP whitelist for this tunnel instance.

  Returns Promise<string[]>

  An array of whitelisted IP addresses, or an empty array if no whitelist is configured.

getLocalServerTls

• getLocalServerTls(): Promise<string | null>

  Returns local server TLS configuration for this tunnel instance.

  Returns Promise<string | null>

  The local server TLS setting, or null if not configured.

getMaxReconnectAttempts

• getMaxReconnectAttempts(): Promise<number | null>

  Returns MaxReconnectAttempts configuration for this tunnel instance.

  Returns Promise<number | null>

  The MaxReconnectAttempts setting, or null if not configured.

getNoReverseProxy

• getNoReverseProxy(): Promise<boolean | null>

  Retrieves No-Reverse-Proxy configuration for this tunnel instance.

  Returns Promise<boolean | null>

  The No-Reverse-Proxy setting, or null if not configured.

getOriginalRequestUrl

• getOriginalRequestUrl(): Promise<boolean | null>

  Retrieves Original-Request-URL configuration for this tunnel instance.

  Returns Promise<boolean | null>

  The Original-Request-URL setting, or null if not configured.

getReconnectInterval

• getReconnectInterval(): Promise<number | null>

  Returns reconnect interval configuration for this tunnel instance.

  Returns Promise<number | null>

  The reconnect interval setting, or null if not configured.

getServerAddress

• getServerAddress(): Promise<string | null>

  Gets the current server address for the tunnel.

  Delegates to Config#getServerAddress.

  Returns Promise<string | null>

  The server address, or null if unavailable.

getSniServerName

• getSniServerName(): Promise<string | null>

  Gets the current SNI server name for the tunnel.

  Delegates to Config#getSniServerName.

  Returns Promise<string | null>

  The SNI server name, or null if unavailable.

getToken

• getToken(): Promise<string | null>

  Gets the current authentication token for the tunnel.

  Delegates to Config#getToken.

  Returns Promise<string | null>

  The authentication token, or null if unavailable.

getTunnelSsl

• getTunnelSsl(): Promise<boolean | null>

  Gets the current SSL setting for the tunnel.

  Delegates to Config#getTunnelSsl.

  Returns Promise<boolean | null>

  The SSL setting, or null if unavailable.

GetTunnelState

• GetTunnelState(): Promise<TunnelState>

  Gets the current tunnel state for the tunnel.

  Delegates to Tunnel#GetTunnelState.

  Returns Promise<TunnelState>

  The tunnel state as a string.

getXForwardedFor

• getXForwardedFor(): Promise<boolean | null>

  Retrieves X-Forwarded-For configuration for this tunnel instance.

  Returns Promise<boolean | null>

  The X-Forwarded-For setting, or null if not configured.

Staticcreate

• create(options: PinggyOptions): Promise<TunnelInstance>

  Creates a new TunnelInstance with the specified options. Internally creates a TunnelWorkerManager, Config, and Tunnel.

  Parameters

  • options: PinggyOptions

  Returns Promise<TunnelInstance>

getGreetMessage

• getGreetMessage(): Promise<string[]>

  Get greeting message for the tunnel.

  Delegates to Tunnel#getTunnelGreetMessage.

  Returns Promise<string[]>

  The greeting message.

  Throws

  If the tunnel is not initialized.

getLatestUsage

• getLatestUsage(): Promise<TunnelUsageType | null>

  Get the latest usage statistics for the tunnel.

  Delegates to Tunnel#getLatestUsage.

  Returns Promise<TunnelUsageType | null>

  The latest usage statistics, or null if unavailable.

  Throws

  If the tunnel is not initialized.

getStatus

• getStatus(): Promise<TunnelStatus>

  Gets the current status of the tunnel.

  Returns the status from Tunnel#status.

  Returns Promise<TunnelStatus>

  The tunnel status.

getUsages

• getUsages(): Promise<string | null>

  Retrieves usage information from the underlying tunnel instance.

  This method delegates to the tunnel's getTunnelUsages() implementation. If the tunnel is not initialized or its reference is missing, an Error is thrown.

  Returns Promise<string | null>

  The tunnel usages as a string, or null if no usages are available.

  Throws

  If the tunnel or its tunnelRef is not initialized.

isActive

• isActive(): Promise<boolean>

  Checks if the tunnel is currently active.

  Delegates to Tunnel#tunnelIsActive.

  Returns Promise<boolean>

  True if the tunnel is active, false otherwise.

start

• start(): Promise<string[]>

  Starts the tunnel and returns the public URLs.

  Delegates to Tunnel#start.

  Returns Promise<string[]>

  Resolves with the list of public tunnel URLs.

  Throws

  If the tunnel is not initialized or fails to start.

startUsageUpdate

• startUsageUpdate(): void

  Starts continuous usage updates for the tunnel.

  Returns void

  void

  Throws

  If the tunnel instance or its tunnelRef is not initialized.

stop

• stop(): Promise<void>

  Stops the tunnel and cleans up resources.

  Delegates to Tunnel#tunnelStop.

  Returns Promise<void>

  Throws

  If the tunnel is not initialized.

stopUsageUpdate

• stopUsageUpdate(): Promise<void>

  Stops continuous usage updates for the tunnel.

  Returns Promise<void>

  Throws

  If the tunnel instance or its tunnelRef is not initialized.

tunnelRequestAdditionalForwarding

• tunnelRequestAdditionalForwarding(
      hostname: string,
      target: string,
  ): Promise<void>

  Requests additional forwarding for the tunnel.

  Delegates to Tunnel#tunnelRequestAdditionalForwarding.

  Parameters

  • hostname: string

    The remote address to forward from.

  • target: string

    The local address to forward to.

  Returns Promise<void>

  Throws

  If the tunnel is not initialized.

urls

• urls(): Promise<string[]>

  Gets the list of public URLs for the tunnel.

  Delegates to Tunnel#getUrls.

  Returns Promise<string[]>

  The list of public tunnel URLs.

config

tunnel

setDebugLogging

• setDebugLogging(
      enable: boolean,
      logLevel?: LogLevel,
      logFilePath: string | null,
  ): Promise<void>

  Enables or disables debug logging for the tunnel worker.

  Parameters

  • enable: boolean
  • logLevel: LogLevel = LogLevel.INFO
  • logFilePath: string | null

  Returns Promise<void>

getWebDebuggerAddress

• getWebDebuggerAddress(): string

  Returns the WebDebugger address for this tunnel instance.

  Returns string

getWebDebuggerInfo

• getWebDebuggerInfo(): Promise<string | null>

  Returns the WebDebugger information for this tunnel instance.

  Returns Promise<string | null>

getWebDebuggerPort

• getWebDebuggerPort(): Promise<number>

  Returns WebDebuggerPort configuration for this tunnel instance.

  Returns Promise<number>

  The WebDebuggerPort setting, or null if not configured.

startWebDebugging

• startWebDebugging(listenAddress: string): void

  Starts web debugging for the tunnel on the specified local port.

  Delegates to Tunnel#startWebDebugging.

  Parameters

  • listenAddress: string

    The local port to start web debugging on.

  Returns void

  Throws

  If the tunnel is not initialized.