Function connect

connect(opts: LdapConnectOptions): Promise<LdapSession>
Opens an LDAP connection, optionally upgrading to TLS and binding.

When LdapConnectOptions.tls is 'implicit' the socket is TLS from the first byte; when 'starttls' the StartTLS extended operation runs and the socket is upgraded before any bind. If LdapConnectOptions.bindDN is set, a simple bind is performed before the session is returned.
Parameters
- opts: LdapConnectOptions
  Connection options.
Returns Promise<LdapSession>
A ready LdapSession.
Throws
If a requested bind is rejected.

Throws
If the connection or TLS upgrade fails.

Throws
If the server misbehaves during StartTLS or bind.

Since
1.0.0
Example
```
await using session = await connect({
  hostname: 'ldap.example.com',
  bindDN: 'cn=admin,dc=example,dc=com',
  password: 'secret'
});
const users = await session.search({ base: 'dc=example,dc=com', filter: '(uid=jdoe)' });
```
- Defined in src/ldap/index.ts:198