@camunda8/sdk 8.7.5 → 8.7.7

package/CHANGELOG.md

@@ -1,3 +1,18 @@
+## [8.7.7](https://github.com/camunda/camunda-8-js-sdk/compare/v8.7.6...v8.7.7) (2025-05-12)
+
+
+### Bug Fixes
+
+* expose configuration in documentation. fixes [#451](https://github.com/camunda/camunda-8-js-sdk/issues/451) ([55dc5d5](https://github.com/camunda/camunda-8-js-sdk/commit/55dc5d5885c5c30373b930573e783c13b45609fb))
+* refactor tests for configuration change ([4b33ad4](https://github.com/camunda/camunda-8-js-sdk/commit/4b33ad45f3e5bebf02801b535c5bc38252bf938a))
+
+## [8.7.6](https://github.com/camunda/camunda-8-js-sdk/compare/v8.7.5...v8.7.6) (2025-05-08)
+
+
+### Features
+
+* enable arbitrary headers on requests. fixes [#448](https://github.com/camunda/camunda-8-js-sdk/issues/448) ([e07ab76](https://github.com/camunda/camunda-8-js-sdk/commit/e07ab7629ef55f124242eed0c8fb27279c3b76a2))
+
 ## [8.7.5](https://github.com/camunda/camunda-8-js-sdk/compare/v8.7.4...v8.7.5) (2025-05-07)
 
 

package/README.md

@@ -66,47 +66,20 @@ For `int64` values whose type is not known ahead of time, such as job variables,
 
 ## Authorization
 
-Calls to APIs can be authorized using basic auth or via OAuth - a token that is obtained via a client id/secret pair exchange.
+Calls to APIs can be authorized using a number of strategies. The most common is OAuth - a token that is obtained via a client id/secret pair exchange.
 
-### Disable OAuth
+- Camunda SaaS and Self-Managed by default are configured to use OAuth with token exchange. In most cases, you will use the `OAUTH` strategy and provide configuration only. The token exchange and its lifecycle are managed by the SDK in this strategy. This passes the token in the `authorization` header of requests.
+- If you secure the gateway behind an Nginx reverse-proxy secured with basic authentication, you will use the `BASIC` strategy. This adds the login credentials as the `authorization` header on requests.
+- For C8Run 8.7, you will need to use the `COOKIE` strategy. This manages a session cookie obtained from a login endpoint, and adds it as a cookie header to requests.
+- For more customisation, you can use the `BEARER` strategy. This is a strategy that allows you to dynamically provide the `Bearer` token directly. The currently set token is added as the `authorization` header on requests.
+- If you have a even more advanced use-case (for example, the need to add specific headers with specific values to authenticate with a proxy gateway), you can construct your own AuthProvider and pass it to the constructor.
+- You can also disable header auth completely and use mTLS (client certificate) — or no authentication at all — with the `NONE` strategy.
 
-To disable OAuth, set the environment variable `CAMUNDA_OAUTH_DISABLED=true`. You can use this when running against a minimal Zeebe broker in a development environment, for example. You can also use this when your authentication is being done using an x509 mTLS certificate.
+For more details on each of these scenarios, see the relevant section below.
 
-### Basic Auth
-
-To use basic auth, set the following values either via the environment or explicitly in code via the constructor:
-
-```bash
-CAMUNDA_AUTH_STRATEGY=BASIC
-CAMUNDA_BASIC_AUTH_USERNAME=....
-CAMUNDA_BASIC_AUTH_PASSWORD=...
-```
-
-### Bearer Token Auth
+### Disable Auth
 
-To use a Bearer token that you have already obtained, set the following value:
-
-```bash
-CAMUNDA_AUTH_STRATEGY=BEARER
-CAMUNDA_OAUTH_TOKEN=....
-```
-
-To refresh the bearer token dynamically at runtime (for example, when it has expired), call `CamundaRestClient.setBearerToken(newTokenValue)`. This will also update the bearer token for all workers created by this client.
-
-### Cookie Auth
-
-For C8Run with 8.7, you need to use [Cookie Authentication](https://docs.camunda.io/docs/apis-tools/camunda-api-rest/camunda-api-rest-authentication/#authentication-via-cookie-c8run-only).
-
-To use cookie auth, set the following value:
-
-```
-CAMUNDA_AUTH_STRATEGY=COOKIE
-
-# Optional configurable values - these are the defaults
-CAMUNDA_AUTH_COOKIE_URL=http://localhost:8080/api/login
-CAMUNDA_AUTH_COOKIE_USERNAME=demo
-CAMUNDA_AUTH_COOKIE_PASSWORD=demo
-```
+To disable Auth, set the environment variable `CAMUNDA_AUTH_STRATEGY=NONE`. You can use this when running against a minimal Zeebe broker in a development environment, for example. You can also use this when your authentication is being done using an x509 mTLS certificate (see the section on mTLS).
 
 ### OAuth
 
@@ -114,7 +87,7 @@ If your platform is secured with OAuth token exchange (Camunda SaaS or Self-Mana
 
 ```bash
 CAMUNDA_AUTH_STRATEGY=OAUTH
-ZEEBE_GRPC_ADDRESS=...
+ZEEBE_ADDRESS=...
 ZEEBE_CLIENT_ID=...
 ZEEBE_CLIENT_SECRET=...
 CAMUNDA_OAUTH_URL=...
@@ -148,6 +121,77 @@ const c8 = new Camunda8({
 
 If the cache directory does not exist, the SDK will attempt to create it (recursively). If the SDK is unable to create it, or the directory exists but is not writeable by your application, the SDK will throw an exception.
 
+### Basic Auth
+
+To use basic auth, set the following values either via the environment or explicitly in code via the constructor:
+
+```bash
+CAMUNDA_AUTH_STRATEGY=BASIC
+CAMUNDA_BASIC_AUTH_USERNAME=....
+CAMUNDA_BASIC_AUTH_PASSWORD=...
+```
+
+### Cookie Auth
+
+For C8Run with 8.7, you need to use [Cookie Authentication](https://docs.camunda.io/docs/apis-tools/camunda-api-rest/camunda-api-rest-authentication/#authentication-via-cookie-c8run-only).
+
+To use cookie auth, set the following value:
+
+```
+CAMUNDA_AUTH_STRATEGY=COOKIE
+
+# Optional configurable values - these are the defaults
+CAMUNDA_AUTH_COOKIE_URL=http://localhost:8080/api/login
+CAMUNDA_AUTH_COOKIE_USERNAME=demo
+CAMUNDA_AUTH_COOKIE_PASSWORD=demo
+```
+
+### Bearer Token Auth
+
+The BEARER auth strategy is provided as a low-level primitive for advanced use-cases that are not covered by the others. In this case, you need to pass an `authorization` header with a `Bearer` token on requests, but it is not issued by a supported OAuth token exchange endpoint. In this case, you can implement a token exchange mechanism and manage the lifecycle of the token, and dynamically inject it as a header through a `BearerAuthProvider`.
+
+To use a Bearer token that you have already obtained, and that does not need to be dynamically updated during the lifetime of the application, simply set the following values:
+
+```bash
+CAMUNDA_AUTH_STRATEGY=BEARER
+CAMUNDA_OAUTH_TOKEN=....
+```
+
+To refresh the bearer token dynamically at runtime (for example, when it has expired and your obtain a new one), you pass in a `BearerAuthProvider` that you control:
+
+```typescript
+import { Camunda8, Auth } from '@camunda8/sdk'
+
+const bearerAuth = new Auth.BearerAuthProvider()
+const c8 = new Camunda8({ oauthProvider: bearerAuth }) // All clients and workers will use bearerAuth
+// ... after obtaining a new token
+bearerAuth.setToken('SOMETOKENVALUE....') // Dynamically update the bearer token value
+```
+
+### Advanced Custom Headers
+
+You can add arbitrary headers to all requests by implementing `IOAuthProvider`:
+
+```typescript
+import { Camunda8, Auth } from '@camunda8/sdk'
+
+class MyCustomAuthProvider implements Auth.IOAuthProvider {
+	async getToken(audience: string) {
+		// here we give a static example, but this class may read configuration,
+		// exchange credentials with an endpoint, manage token lifecycles, and so forth...
+		// Return an object which will be merged with the headers on the request
+		return {
+			'x-custom-auth-header': 'someCustomValue',
+		}
+	}
+}
+
+const customAuthProvider = new MyCustomAuthProvider()
+const c8 = new Camunda8({ oauthProvider: customAuthProvider })
+```
+
+You can use this approach to wrap one of the existing strategy classes using a facade pattern to encapsulate and extend it.
+
 ## TLS
 
 If you are using self-signed certificates, you can provide the self-signed certificate path using the configuration parameter / environment variable: `CAMUNDA_CUSTOM_ROOT_CERT_PATH`.
@@ -169,7 +213,7 @@ This is the complete environment configuration needed to run against the Dockeri
 
 ```bash
 # Self-Managed
-export ZEEBE_GRPC_ADDRESS='localhost:26500'
+export ZEEBE_ADDRESS='localhost:26500'
 export ZEEBE_REST_ADDRESS='http://localhost:8080'
 export ZEEBE_CLIENT_ID='zeebe'
 export ZEEBE_CLIENT_SECRET='zecret'
@@ -200,7 +244,7 @@ Here is an example of doing this via the constructor, rather than via the enviro
 import { Camunda8 } from '@camunda8/sdk'
 
 const c8 = new Camunda8({
-	ZEEBE_GRPC_ADDRESS: 'localhost:26500',
+	ZEEBE_ADDRESS: 'localhost:26500',
 	ZEEBE_REST_ADDRESS: 'http://localhost:8080',
 	ZEEBE_CLIENT_ID: 'zeebe',
 	ZEEBE_CLIENT_SECRET: 'zecret',
@@ -221,7 +265,7 @@ const c8 = new Camunda8({
 Here is a complete configuration example for connection to Camunda SaaS:
 
 ```bash
-export ZEEBE_GRPC_ADDRESS='5c34c0a7-7f29-4424-8414-125615f7a9b9.syd-1.zeebe.camunda.io:443'
+export ZEEBE_ADDRESS='5c34c0a7-7f29-4424-8414-125615f7a9b9.syd-1.zeebe.camunda.io:443'
 export ZEEBE_REST_ADDRESS='https://syd-1.zeebe.camunda.io/5c34c0a7-7f29-4424-8414-125615f7a9b9'
 export ZEEBE_CLIENT_ID='yvvURO9TmBnP3zx4Xd8Ho6apgeiZTjn6'
 export ZEEBE_CLIENT_SECRET='iJJu-SHgUtuJTTAMnMLdcb8WGF8s2mHfXhXutEwe8eSbLXn98vUpoxtuLk5uG0en'
@@ -247,6 +291,7 @@ export CAMUNDA_CONSOLE_OAUTH_AUDIENCE='api.cloud.camunda.io'
 The SDK uses a Winston / Pino compatible logging setup. By default it uses Winston.
 
 When using the default logging library, you can set the logging level of the SDK via the environment variable (or constructor configuration property) `CAMUNDA_LOG_LEVEL`. This defaults to 'info'. Values (in order of priority): `error`, `warn`, `info`, `http`, `verbose`, `debug`, `silly`.
+
 ### Custom logger
 
 You can supply a custom logger via the constructor. For example, to use the [Pino](https://getpino.io/) logging library:
@@ -261,7 +306,7 @@ const logger = pino({ level }) // Logging level controlled via the logging libra
 
 logger.info('Pino logger created')
 const c8 = new Camunda8({
-    logger,
+	logger,
 })
 c8.log.info('Using pino logger')
 ```
@@ -272,18 +317,18 @@ The SDK uses the [`debug`](https://github.com/debug-js/debug) library to help yo
 
 To enable debugging output, set a value for the `DEBUG` environment variable. The value is a comma-separated list of debugging namespaces. The SDK has the following namespaces:
 
-| Value                  | Component            |
-| ---------------------- | -------------------- |
-| `camunda:adminconsole` | Administration API   |
-| `camunda:modeler`      | Modeler API          |
-| `camunda:operate`      | Operate API          |
-| `camunda:optimize`     | Optimize API         |
-| `camunda:tasklist`     | Tasklist API         |
-| `camunda:oauth`        | OAuth Token Exchange |
-| `camunda:grpc`         | Zeebe gRPC channel   |
-| `camunda:worker`       | Zeebe Worker         |
-| `camunda:worker:verbose`| Zeebe Worker (additional detail) |
-| `camunda:zeebeclient`  | Zeebe Client         |
+| Value                    | Component                        |
+| ------------------------ | -------------------------------- |
+| `camunda:adminconsole`   | Administration API               |
+| `camunda:modeler`        | Modeler API                      |
+| `camunda:operate`        | Operate API                      |
+| `camunda:optimize`       | Optimize API                     |
+| `camunda:tasklist`       | Tasklist API                     |
+| `camunda:oauth`          | OAuth Token Exchange             |
+| `camunda:grpc`           | Zeebe gRPC channel               |
+| `camunda:worker`         | Zeebe Worker                     |
+| `camunda:worker:verbose` | Zeebe Worker (additional detail) |
+| `camunda:zeebeclient`    | Zeebe Client                     |
 
 Here is an example of turning on debugging for the OAuth and Operate components:
 
@@ -408,4 +453,3 @@ When a polling worker encounters an error, including not being authenticated, th
 This means that if you start a worker with invalid credentials, then the polling backoff will look like this, by default (times in seconds): 3, 6, 9, 12, 15, 18, 21, 23, 24, 25, 26, 27, 28, 29, 30, 30, 30...
 
 If the worker is backing off for a reason other than invalid credentials - for example a backpressure signal from the gateway - it will be: 2, 4, 6, 8, 10, 12, 14, 15, 15, 15.....
-

package/dist/admin/lib/AdminApiClient.d.ts

@@ -16,14 +16,14 @@ export declare class AdminApiClient {
     private getHeaders;
     /**
      *
-     * @description Get an array of the current API clients for this cluster. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/GetClients) for more details.
+     * Get an array of the current API clients for this cluster. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/GetClients) for more details.
      * @throws {RESTError}
      * @param clusterUuid - The cluster UUID
      *
      */
     getClients(clusterUuid: string): Promise<Dto.ClusterClient[]>;
     /**
-     * @description Create a new API client for a cluster. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/CreateClient) for more details.
+     * Create a new API client for a cluster. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/CreateClient) for more details.
      * @throws {RESTError}
      */
     createClient(req: {
@@ -32,7 +32,7 @@ export declare class AdminApiClient {
         permissions: string[];
     }): Promise<Dto.CreatedClusterClient>;
     /**
-     * @description Get the details of an API client. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/GetClient) for more details.
+     * Get the details of an API client. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/GetClient) for more details.
      * @param clusterUuid
      * @param clientId
      * @throws {RESTError}
@@ -40,7 +40,7 @@ export declare class AdminApiClient {
      */
     getClient(clusterUuid: string, clientId: string): Promise<Dto.ClusterClientConnectionDetails>;
     /**
-     * @description See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/DeleteClient) for more details.
+     * See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/DeleteClient) for more details.
      * @param clusterUuid
      * @param clientId
      * @throws {RESTError}
@@ -48,13 +48,13 @@ export declare class AdminApiClient {
     deleteClient(clusterUuid: string, clientId: string): Promise<null>;
     /**
      *
-     * @description Return an array of clusters. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/GetClusters) for more details.
+     * Return an array of clusters. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/GetClusters) for more details.
      * @throws {RESTError}
      */
     getClusters(): Promise<Dto.Cluster[]>;
     /**
      *
-     * @description Create a new cluster. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/CreateCluster) for more details.
+     * Create a new cluster. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/CreateCluster) for more details.
      * @throws {RESTError}
      */
     createCluster(createClusterRequest: Dto.CreateClusterBody): Promise<{
@@ -62,27 +62,27 @@ export declare class AdminApiClient {
     }>;
     /**
      *
-     * @description Retrieve the metadata for a cluster. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/GetCluster) for more details.
+     * Retrieve the metadata for a cluster. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/GetCluster) for more details.
      * @throws {RESTError}
      *
      */
     getCluster(clusterUuid: string): Promise<Dto.Cluster>;
     /**
      *
-     * @description Delete a cluster. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/DeleteCluster) for more details.
+     * Delete a cluster. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/DeleteCluster) for more details.
      * @throws {RESTError}
      *
      */
     deleteCluster(clusterUuid: string): Promise<null>;
     /**
      *
-     * @description Retrieve the available parameters for cluster creation. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/GetParameters) for more details.
+     * Retrieve the available parameters for cluster creation. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/GetParameters) for more details.
      * @throws {RESTError}
      */
     getParameters(): Promise<Dto.Parameters>;
     /**
      *
-     * @description Retrieve the connector secrets. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/GetSecrets) for more details.
+     * Retrieve the connector secrets. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/GetSecrets) for more details.
      * @throws {RESTError}
      */
     getSecrets(clusterUuid: string): Promise<{
@@ -90,7 +90,7 @@ export declare class AdminApiClient {
     }>;
     /**
      *
-     * @description Create a new connector secret. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/CreateSecret) for more details.
+     * Create a new connector secret. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/CreateSecret) for more details.
      * @throws {RESTError}
      */
     createSecret({ clusterUuid, secretName, secretValue, }: {
@@ -100,13 +100,13 @@ export declare class AdminApiClient {
     }): Promise<null>;
     /**
      *
-     * @description Delete a connector secret. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/DeleteSecret) for more details.
+     * Delete a connector secret. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/DeleteSecret) for more details.
      * @throws {RESTError}
      */
     deleteSecret(clusterUuid: string, secretName: string): Promise<null>;
     /**
      *
-     * @description Add one or more IPs to the whitelist for the cluster. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/UpdateIpWhitelist) for more details.
+     * Add one or more IPs to the whitelist for the cluster. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/UpdateIpWhitelist) for more details.
      * @throws {RESTError}
      * @param ipwhitelist
      * @returns
@@ -119,20 +119,20 @@ export declare class AdminApiClient {
     ]): Promise<null>;
     /**
      *
-     * @description Retrieve a list of members and pending invites for your organisation. See the [API Documentation]() for more details.
+     * Retrieve a list of members and pending invites for your organisation. See the [API Documentation]() for more details.
      * @throws {RESTError}
      */
     getUsers(): Promise<Dto.Member[]>;
     /**
      *
-     * @description Add a member. See the [API Documentation]() for more details.
+     * Add a member. See the [API Documentation]() for more details.
      * @throws {RESTError}
      *
      */
     createMember(email: string, orgRoles: Dto.OrganizationRole[]): Promise<null>;
     /**
      *
-     * @description Delete a member from your organization. See the [API Documentation]() for more details.
+     * Delete a member from your organization. See the [API Documentation]() for more details.
      * @throws {RESTError}
      *
      */

package/dist/admin/lib/AdminApiClient.js

@@ -48,7 +48,7 @@ class AdminApiClient {
     }
     /**
      *
-     * @description Get an array of the current API clients for this cluster. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/GetClients) for more details.
+     * Get an array of the current API clients for this cluster. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/GetClients) for more details.
      * @throws {RESTError}
      * @param clusterUuid - The cluster UUID
      *
@@ -61,7 +61,7 @@ class AdminApiClient {
         }).json();
     }
     /**
-     * @description Create a new API client for a cluster. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/CreateClient) for more details.
+     * Create a new API client for a cluster. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/CreateClient) for more details.
      * @throws {RESTError}
      */
     async createClient(req) {
@@ -78,7 +78,7 @@ class AdminApiClient {
             .json();
     }
     /**
-     * @description Get the details of an API client. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/GetClient) for more details.
+     * Get the details of an API client. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/GetClient) for more details.
      * @param clusterUuid
      * @param clientId
      * @throws {RESTError}
@@ -92,7 +92,7 @@ class AdminApiClient {
         }).json();
     }
     /**
-     * @description See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/DeleteClient) for more details.
+     * See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/DeleteClient) for more details.
      * @param clusterUuid
      * @param clientId
      * @throws {RESTError}
@@ -108,7 +108,7 @@ class AdminApiClient {
     }
     /**
      *
-     * @description Return an array of clusters. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/GetClusters) for more details.
+     * Return an array of clusters. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/GetClusters) for more details.
      * @throws {RESTError}
      */
     async getClusters() {
@@ -120,7 +120,7 @@ class AdminApiClient {
     }
     /**
      *
-     * @description Create a new cluster. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/CreateCluster) for more details.
+     * Create a new cluster. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/CreateCluster) for more details.
      * @throws {RESTError}
      */
     async createCluster(createClusterRequest) {
@@ -134,7 +134,7 @@ class AdminApiClient {
     }
     /**
      *
-     * @description Retrieve the metadata for a cluster. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/GetCluster) for more details.
+     * Retrieve the metadata for a cluster. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/GetCluster) for more details.
      * @throws {RESTError}
      *
      */
@@ -147,7 +147,7 @@ class AdminApiClient {
     }
     /**
      *
-     * @description Delete a cluster. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/DeleteCluster) for more details.
+     * Delete a cluster. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/DeleteCluster) for more details.
      * @throws {RESTError}
      *
      */
@@ -162,7 +162,7 @@ class AdminApiClient {
     }
     /**
      *
-     * @description Retrieve the available parameters for cluster creation. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/GetParameters) for more details.
+     * Retrieve the available parameters for cluster creation. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/GetParameters) for more details.
      * @throws {RESTError}
      */
     async getParameters() {
@@ -174,7 +174,7 @@ class AdminApiClient {
     }
     /**
      *
-     * @description Retrieve the connector secrets. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/GetSecrets) for more details.
+     * Retrieve the connector secrets. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/GetSecrets) for more details.
      * @throws {RESTError}
      */
     async getSecrets(clusterUuid) {
@@ -186,7 +186,7 @@ class AdminApiClient {
     }
     /**
      *
-     * @description Create a new connector secret. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/CreateSecret) for more details.
+     * Create a new connector secret. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/CreateSecret) for more details.
      * @throws {RESTError}
      */
     async createSecret({ clusterUuid, secretName, secretValue, }) {
@@ -200,7 +200,7 @@ class AdminApiClient {
     }
     /**
      *
-     * @description Delete a connector secret. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/DeleteSecret) for more details.
+     * Delete a connector secret. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/DeleteSecret) for more details.
      * @throws {RESTError}
      */
     async deleteSecret(clusterUuid, secretName) {
@@ -214,7 +214,7 @@ class AdminApiClient {
     }
     /**
      *
-     * @description Add one or more IPs to the whitelist for the cluster. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/UpdateIpWhitelist) for more details.
+     * Add one or more IPs to the whitelist for the cluster. See [the API Documentation](https://console.cloud.camunda.io/customer-api/openapi/docs/#/default/UpdateIpWhitelist) for more details.
      * @throws {RESTError}
      * @param ipwhitelist
      * @returns
@@ -233,7 +233,7 @@ class AdminApiClient {
     }
     /**
      *
-     * @description Retrieve a list of members and pending invites for your organisation. See the [API Documentation]() for more details.
+     * Retrieve a list of members and pending invites for your organisation. See the [API Documentation]() for more details.
      * @throws {RESTError}
      */
     async getUsers() {
@@ -247,7 +247,7 @@ class AdminApiClient {
     }
     /**
      *
-     * @description Add a member. See the [API Documentation]() for more details.
+     * Add a member. See the [API Documentation]() for more details.
      * @throws {RESTError}
      *
      */
@@ -263,7 +263,7 @@ class AdminApiClient {
     }
     /**
      *
-     * @description Delete a member from your organization. See the [API Documentation]() for more details.
+     * Delete a member from your organization. See the [API Documentation]() for more details.
      * @throws {RESTError}
      *
      */

package/dist/c8/index.d.ts

@@ -1,6 +1,7 @@
 import { AdminApiClient } from '../admin';
 import { Camunda8ClientConfiguration } from '../lib';
 import { ModelerApiClient } from '../modeler';
+import { IOAuthProvider } from '../oauth';
 import { OperateApiClient } from '../operate';
 import { OptimizeApiClient } from '../optimize';
 import { TasklistApiClient } from '../tasklist';
@@ -10,7 +11,7 @@ import { CamundaRestClient } from './lib/CamundaRestClient';
 /**
  * A single point of configuration for all Camunda Platform 8 clients.
  *
- * This class is a facade for all the clients in the Camunda Platform 8 SDK.
+ * This class is a factory for all the clients in the Camunda Platform 8 SDK. It allows a single point of configuration for all clients.
  *
  * @example
  * ```typescript
@@ -40,8 +41,21 @@ export declare class Camunda8 {
     log: Logger;
     /**
      * All constructor parameters for configuration are optional. If no configuration is provided, the SDK will use environment variables to configure itself.
+     * See {@link CamundaSDKConfiguration} for the complete list of configuration parameters. Values can be passed in explicitly in code, or set via environment variables (recommended: separate configuration and application logic).
+     * Explicitly set values will override environment variables, which are merged into the configuration.
      */
-    constructor(config?: Camunda8ClientConfiguration);
+    constructor(
+    /**
+     * Optional explicit overrides. With no configuration, the SDK will use environment variables to configure itself.
+     */
+    config?: Camunda8ClientConfiguration & {
+        /**
+         * An optional {@link IOAuthProvider} implementation. This can be used to add headers to REST requests made by the SDK.
+         * In most cases, you will not need to supply this. You can use `CAMUNDA_AUTH_STRATEGY` and appropriate config values to configure
+         * a preconfigured auth strategy. This configuration parameter is provided for advanced use-cases.
+         **/
+        oAuthProvider?: IOAuthProvider;
+    });
     /**
      * Returns a client for the "Operate REST API"
      * See: https://docs.camunda.io/docs/apis-tools/operate-api/overview/

package/dist/c8/index.js

@@ -13,7 +13,7 @@ const CamundaRestClient_1 = require("./lib/CamundaRestClient");
 /**
  * A single point of configuration for all Camunda Platform 8 clients.
  *
- * This class is a facade for all the clients in the Camunda Platform 8 SDK.
+ * This class is a factory for all the clients in the Camunda Platform 8 SDK. It allows a single point of configuration for all clients.
  *
  * @example
  * ```typescript
@@ -32,11 +32,20 @@ const CamundaRestClient_1 = require("./lib/CamundaRestClient");
 class Camunda8 {
     /**
      * All constructor parameters for configuration are optional. If no configuration is provided, the SDK will use environment variables to configure itself.
+     * See {@link CamundaSDKConfiguration} for the complete list of configuration parameters. Values can be passed in explicitly in code, or set via environment variables (recommended: separate configuration and application logic).
+     * Explicitly set values will override environment variables, which are merged into the configuration.
      */
-    constructor(config = {}) {
+    constructor(
+    /**
+     * Optional explicit overrides. With no configuration, the SDK will use environment variables to configure itself.
+     */
+    config = {}) {
         this.configuration =
             lib_1.CamundaEnvironmentConfigurator.mergeConfigWithEnvironment(config);
-        this.oAuthProvider = (0, lib_1.constructOAuthProvider)(this.configuration);
+        // Allow custom oAuthProvider to be passed in.
+        // See: https://github.com/camunda/camunda-8-js-sdk/issues/448
+        this.oAuthProvider =
+            config.oAuthProvider ?? (0, lib_1.constructOAuthProvider)(this.configuration);
         this.log = (0, C8Logger_1.getLogger)(config);
         this.log.debug('Camunda8 SDK initialized');
     }

package/dist/c8/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/c8/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/c8/index.ts"],"names":[],"mappings":"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"}

package/dist/c8/lib/C8Logger.d.ts

@@ -1,5 +1,10 @@
 import winston from 'winston';
 import { Camunda8ClientConfiguration } from '../../lib';
+/**
+ * This is the interface for the logger used in the SDK.
+ * It is based on the Winston logger and provides methods for logging at different levels.
+ * You can use this interface to create your own logger that implements the same methods.
+ */
 export type Logger = {
     info: (message: string | undefined, ...meta: any[]) => void;
     warn: (message: string | undefined, ...meta: any[]) => void;

package/dist/c8/lib/C8Logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"C8Logger.js","sourceRoot":"","sources":["../../../src/c8/lib/C8Logger.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,mDAA6C,CAAC,iBAAiB;AAE/D,mCAGkB;AAYlB,IAAI,aAAqB,CAAA;AACzB,IAAI,YAAgC,CAAA;AAEpC,SAAgB,SAAS,CAAC,MAAoC;IAC7D,MAAM,aAAa,GAClB,oCAA8B,CAAC,0BAA0B,CAAC,MAAM,IAAI,EAAE,CAAC,CAAA;IACxE,wIAAwI;IACxI,IAAI,MAAM,EAAE,MAAM,IAAI,YAAY,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC;QACtD,YAAY,GAAG,MAAM,CAAC,MAAM,CAAA;QAC5B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAA;IAC7C,CAAC;IACD,IAAI,CAAC,aAAa,EAAE,CAAC;QACpB,4BAA4B;QAC5B,MAAM,MAAM,GAAG,YAAY,CAAC;YAC3B,KAAK,EAAE,aAAa,CAAC,iBAAiB;YACtC,MAAM,EAAE,iBAAO,CAAC,MAAM,CAAC,OAAO,CAC7B,iBAAO,CAAC,MAAM,CAAC,SAAS,EAAE,EAC1B,iBAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,EACzB,iBAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CACvB;YACD,UAAU,EAAE,CAAC,IAAI,iBAAO,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;SAC9C,CAAC,CAAA;QAEF,aAAa,GAAG,MAAM,CAAA;IACvB,CAAC;IACD,IAAI,CAAC,YAAY,EAAE,CAAC;QACnB,aAAa,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAA;QACnD,YAAY,GAAG,aAAa,CAAA;IAC7B,CAAC;IACD,OAAO,MAAM,EAAE,MAAM,IAAI,aAAa,CAAA;AACvC,CAAC;AA3BD,8BA2BC;AAED,SAAgB,YAAY,CAAC,OAA+B;IAC3D,MAAM,MAAM,GAER,iBAAO,CAAC,YAAY,CAAC,OAAO,CAAQ,CAAA,CAAC,yDAAyD;IAClG,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAA;IAC3B,OAAO,MAAM,CAAA;AACd,CAAC;AAND,oCAMC;AAEY,QAAA,UAAU,GAAG,YAAY,CAAC;IACtC,UAAU,EAAE,CAAC,IAAI,oBAAU,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;CACtD,CAAC,CAAA"}
+{"version":3,"file":"C8Logger.js","sourceRoot":"","sources":["../../../src/c8/lib/C8Logger.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,mDAA6C,CAAC,iBAAiB;AAE/D,mCAGkB;AAiBlB,IAAI,aAAqB,CAAA;AACzB,IAAI,YAAgC,CAAA;AAEpC,SAAgB,SAAS,CAAC,MAAoC;IAC7D,MAAM,aAAa,GAClB,oCAA8B,CAAC,0BAA0B,CAAC,MAAM,IAAI,EAAE,CAAC,CAAA;IACxE,wIAAwI;IACxI,IAAI,MAAM,EAAE,MAAM,IAAI,YAAY,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC;QACtD,YAAY,GAAG,MAAM,CAAC,MAAM,CAAA;QAC5B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAA;IAC7C,CAAC;IACD,IAAI,CAAC,aAAa,EAAE,CAAC;QACpB,4BAA4B;QAC5B,MAAM,MAAM,GAAG,YAAY,CAAC;YAC3B,KAAK,EAAE,aAAa,CAAC,iBAAiB;YACtC,MAAM,EAAE,iBAAO,CAAC,MAAM,CAAC,OAAO,CAC7B,iBAAO,CAAC,MAAM,CAAC,SAAS,EAAE,EAC1B,iBAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,EACzB,iBAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CACvB;YACD,UAAU,EAAE,CAAC,IAAI,iBAAO,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;SAC9C,CAAC,CAAA;QAEF,aAAa,GAAG,MAAM,CAAA;IACvB,CAAC;IACD,IAAI,CAAC,YAAY,EAAE,CAAC;QACnB,aAAa,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAA;QACnD,YAAY,GAAG,aAAa,CAAA;IAC7B,CAAC;IACD,OAAO,MAAM,EAAE,MAAM,IAAI,aAAa,CAAA;AACvC,CAAC;AA3BD,8BA2BC;AAED,SAAgB,YAAY,CAAC,OAA+B;IAC3D,MAAM,MAAM,GAER,iBAAO,CAAC,YAAY,CAAC,OAAO,CAAQ,CAAA,CAAC,yDAAyD;IAClG,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAA;IAC3B,OAAO,MAAM,CAAA;AACd,CAAC;AAND,oCAMC;AAEY,QAAA,UAAU,GAAG,YAAY,CAAC;IACtC,UAAU,EAAE,CAAC,IAAI,oBAAU,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;CACtD,CAAC,CAAA"}