@camunda8/sdk 8.7.20 → 8.7.22

package/AGENT.md

@@ -0,0 +1,181 @@
+# Agent Information for Camunda 8 JavaScript SDK
+
+This file contains information for AI agents working on the Camunda 8 JavaScript SDK repository.
+
+## Project Overview
+
+The Camunda 8 JavaScript SDK is the official TypeScript/Node.js SDK for Camunda Platform 8. It provides unified access to all Camunda 8 APIs including Zeebe, Operate, Optimize, Tasklist, Modeler, and Admin.
+
+## Essential Commands
+
+### Build & Compilation
+```bash
+npm run build          # Clean, compile TypeScript, and copy proto files
+npm run clean          # Remove dist folder and build artifacts
+npm run compile        # Compile TypeScript to JavaScript
+```
+
+### Testing
+```bash
+npm test               # Run unit tests only
+npm run test:integration    # Run integration tests (requires Docker)
+npm run test:local     # Run local integration tests
+npm run test:smoketest # Build and run smoke tests
+npm run test:c8run     # Run Camunda 8 specific tests
+```
+
+### Code Quality
+```bash
+npm run lint           # Run ESLint on TypeScript files
+npm run format         # Format code with Prettier
+```
+
+### Development Environment
+```bash
+npm run sm:start       # Start Docker Compose for Self-Managed Camunda 8
+npm run sm:stop        # Stop Docker Compose services
+npm run sm:start8.8    # Start Camunda 8.8 specific environment
+npm run sm:stop8.8     # Stop Camunda 8.8 environment
+```
+
+### Documentation
+```bash
+npm run docs           # Generate TypeDoc documentation
+npm run docs:watch     # Generate and watch docs for changes
+```
+
+## Project Structure
+
+```
+src/
+├── index.ts              # Main entry point
+├── lib/                  # Common utilities and base classes
+├── c8/                   # Camunda 8 unified client and REST API
+│   ├── index.ts         # Camunda8 main class
+│   └── lib/
+│       ├── C8Dto.ts     # Data Transfer Objects for REST API
+│       └── CamundaRestClient.ts  # REST API client implementation
+├── zeebe/               # Zeebe gRPC and REST clients
+├── operate/             # Operate API client
+├── optimize/            # Optimize API client  
+├── tasklist/            # Tasklist API client
+├── modeler/             # Web Modeler API client
+├── admin/               # Admin API client
+├── oauth/               # OAuth authentication providers
+└── __tests__/           # Test files organized by component
+```
+
+## Key Architecture Patterns
+
+### Client Pattern
+- Each API has its own client class (e.g., `OperateApiClient`, `TasklistApiClient`)
+- All clients are instantiated through the main `Camunda8` factory class
+- Clients support both SaaS and Self-Managed configurations
+
+### DTO Pattern
+- Data Transfer Objects (DTOs) extend `LosslessDto` for int64 handling
+- Use decorators like `@Int64String` for precise number handling
+- Search request DTOs extend `BaseSearchRequest<TSortFields, TFilter>` or `BaseSearchRequestWithOptionalFilter<TSortFields, TFilter>`
+- Response DTOs use `PaginatedCamundaRestSearchResponse<T>` pattern for consistent pagination
+
+### Authentication
+- OAuth2/OIDC support for SaaS
+- Basic auth and custom auth providers for Self-Managed
+- Token caching and automatic refresh
+
+### Pagination
+- **CamundaRestClient**: Uses `startCursor`/`endCursor` (string values)
+- **Other APIs**: Use `firstSortValues`/`lastSortValues` or `sortValues` (arrays)
+
+## Testing Patterns
+
+### Test Organization
+- Unit tests: `*.unit.spec.ts` - Mock external dependencies
+- Integration tests: `*.integration.spec.ts` - Test against real services
+- Local integration: `*local-integration.spec.ts` - Test local Docker setup
+
+### Test Environment Variables
+- `CAMUNDA_UNIT_TEST=true` - Forces unit test mode
+- Various `ZEEBE_*`, `OPERATE_*` environment variables for service configuration
+- Integration tests use environment files from `env/` directory (e.g., `env/8.8-alpha.env`)
+
+### Test Utilities
+- Use `jest` as the test framework
+- Tests are organized by component in `src/__tests__/`
+- Integration tests require either Docker services or sourced environment variables
+- **Running Integration Tests**: `source env/8.8-alpha.env && npx jest path/to/test.rest.spec.ts`
+- **Running Unit Tests**: `npm test -- --testPathPattern="testname.unit"`
+
+## Common Development Tasks
+
+### Adding New Search Endpoints
+1. Define filter interface (e.g., `ProcessInstanceSearchFilter`)
+2. Extend `BaseSearchRequest<TSortFields, TFilter>` or `BaseSearchRequestWithOptionalFilter<TSortFields, TFilter>`
+3. Define details interface for response items (e.g., `DecisionInstanceDetails`)
+4. Create `CamundaRest*Response` interface extending `PaginatedCamundaRestSearchResponse<DetailsType>`
+5. Add method to `CamundaRestClient` using `callApiEndpoint` pattern
+6. Write comprehensive unit tests with mocked `callApiEndpoint`
+7. Write integration tests that source environment variables from `env/` directory
+
+### Adding New API Clients
+1. Create client class in appropriate directory (e.g., `src/newservice/`)
+2. Define DTOs in `*Dto.ts` file
+3. Add client factory method to main `Camunda8` class
+4. Export client from main `index.ts`
+
+### Handling Authentication
+- Clients accept `IHeadersProvider` for custom auth
+- Use `constructOAuthProvider()` for standard OAuth flows
+- Set appropriate environment variables for configuration
+
+## Important Files
+
+- `src/c8/lib/C8Dto.ts` - Main DTO definitions for REST API
+- `src/c8/lib/CamundaRestClient.ts` - Unified REST API client
+- `src/lib/Configuration.ts` - Configuration management
+- `src/lib/LosslessDto.ts` - Base class for DTOs with int64 support
+- `package.json` - Scripts and dependencies
+- `tsconfig.json` - TypeScript configuration
+
+## Common Issues & Solutions
+
+### Build Issues
+- Run `npm run clean` before building if encountering cache issues
+- Ensure all imports use correct relative paths
+- Check for TypeScript errors with `npm run compile`
+
+### Test Issues  
+- Integration tests require Docker services: `npm run sm:start`
+- Use `npm run test` for unit tests only
+- Check test environment variables are set correctly
+
+### Authentication Issues
+- Verify OAuth configuration for SaaS
+- Check basic auth credentials for Self-Managed
+- Ensure certificates are properly configured for custom CA
+
+## Code Style Guidelines
+
+- Use TypeScript strict mode
+- Follow existing patterns for DTO definitions
+- Use `LosslessDto` base class for API responses
+- Prefer composition over inheritance for client features
+- Write comprehensive JSDoc comments for public APIs
+
+## Recent Additions
+
+### Search Decision Instances API
+- `searchDecisionInstances()` method in `CamundaRestClient`
+- `DecisionInstanceSearchFilter` and `SearchDecisionInstancesRequest` DTOs
+- `CamundaRestSearchDecisionInstancesResponse` with cursor-based pagination
+- Comprehensive unit and integration tests
+- Follows established patterns for search endpoints
+
+## Dependencies
+
+Key dependencies to be aware of:
+- `got` - HTTP client library
+- `@grpc/grpc-js` - gRPC client
+- `lossless-json` - JSON parsing with int64 support
+- `form-data` - Multipart form handling
+- `jest` - Testing framework

package/CHANGELOG.md

@@ -1,3 +1,30 @@
+## [8.7.22](https://github.com/camunda/camunda-8-js-sdk/compare/v8.7.21...v8.7.22) (2025-07-22)
+
+
+### Bug Fixes
+
+* fix QuerySubscription duplicate item emission. fixes [#540](https://github.com/camunda/camunda-8-js-sdk/issues/540) ([8d61bcb](https://github.com/camunda/camunda-8-js-sdk/commit/8d61bcb7a191b7bf561c1ed65dccb53e8d0fa22e))
+
+
+### Features
+
+* correctly handle backpressure 503 response. fixes [#509](https://github.com/camunda/camunda-8-js-sdk/issues/509) ([7994b5f](https://github.com/camunda/camunda-8-js-sdk/commit/7994b5fbef0852eb49a19b37089070d3225a7f89))
+* enable debugging for Camunda Rest Client ([cba989f](https://github.com/camunda/camunda-8-js-sdk/commit/cba989f72ed446e40eb9dcd8dfd0b898bf1a90a8))
+* implement getDecisionInstance. fixes [#293](https://github.com/camunda/camunda-8-js-sdk/issues/293) ([eea159d](https://github.com/camunda/camunda-8-js-sdk/commit/eea159d11cc411144c6472f1dfe364380d856592))
+* implement searchDecisionInstances. fixes [#292](https://github.com/camunda/camunda-8-js-sdk/issues/292) ([83a7d7b](https://github.com/camunda/camunda-8-js-sdk/commit/83a7d7b0abd163abeb3311588305c7c0b9db8caa))
+
+
+### Reverts
+
+* remove logging for [#491](https://github.com/camunda/camunda-8-js-sdk/issues/491) ([ae69149](https://github.com/camunda/camunda-8-js-sdk/commit/ae69149bd2e10d143fd1186a721fa02cd8ccbabb))
+
+## [8.7.21](https://github.com/camunda/camunda-8-js-sdk/compare/v8.7.20...v8.7.21) (2025-07-17)
+
+
+### Features
+
+* backoff retry on 429 "Too many client requests". FIxes [#528](https://github.com/camunda/camunda-8-js-sdk/issues/528) ([63ea9ec](https://github.com/camunda/camunda-8-js-sdk/commit/63ea9ecf6b53b3327ebfb54bca41a3e13f1b01e7))
+
 ## [8.7.20](https://github.com/camunda/camunda-8-js-sdk/compare/v8.7.19...v8.7.20) (2025-07-16)
 
 ## [8.7.19](https://github.com/camunda/camunda-8-js-sdk/compare/v8.7.18...v8.7.19) (2025-07-15)

package/README.md

@@ -394,6 +394,7 @@ const subscription = QuerySubscription({
 	return false // No new items, do not emit
   },
   interval: 5000,
+  trackingWindow: 5, // Remember emitted items from last 5 poll cycles (default)
 })
 
 subscription.on('data', data => {
@@ -404,24 +405,46 @@ subscription.cancel() // close subscription and free resources
 // You can also use subscription.pause() and subscription.resume() to pause and resume the subscription
 ```
 
+**Note**:
+- `QuerySubscription` uses a rolling window approach to prevent memory leaks when tracking emitted items. By default, it remembers items from the last 5 poll cycles to prevent duplicates. You can adjust this with the `trackingWindow` parameter:
+
+```typescript
+const subscription = QuerySubscription({
+  query,
+  predicate: myCustomPredicate,
+  interval: 5000,
+  trackingWindow: 10, // Remember items from the last 10 polling cycles
+})
+```
+
+If you implement a custom predicate, your predicate determines what data should be emitted, and then the rolling window mechanism prevents duplicate emissions across multiple poll cycles.
+
+**Important:** The rolling window mechanism operates by serializing each emitted item to a string and tracking it for the specified number of poll cycles. This means that if an entity changes state and then returns to a previous state within the tracking window timeframe, the second appearance in the original state might not trigger an emission. For example, if a process instance transitions from "READY" to "NOT_READY" and back to "READY" within the tracking window, the second "READY" state might not be emitted. If you need to track all state transitions regardless of previous states, consider:
+
+1. Setting a smaller `trackingWindow` value to reduce the tracking period
+2. Implementing a custom state tracking mechanism in your application
+3. Including a timestamp or version field in your item identification logic
+
 ## Debugging
 
 The SDK uses the [`debug`](https://github.com/debug-js/debug) library to help you debug specific issues. This produces verbose, low-level output from specific components to the console.
 
 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:querySubscription` | QuerySubscription debugging               |
+| `camunda:grpc`              | Zeebe gRPC channel                        |
+| `camunda:worker`            | Zeebe Worker                              |
+| `camunda:worker:verbose`    | Zeebe Worker (additional detail)          |
+| `camunda:zeebeclient`       | Zeebe Client                              |
+| `camunda:orchestration-rest`              | Camunda Orchestration Cluster API Client  |
 
 Here is an example of turning on debugging for the OAuth and Operate components:
 

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

@@ -50,20 +50,21 @@ export declare class ProcessDeployment extends LosslessDto {
     tenantId: string;
 }
 export declare class DecisionDeployment extends LosslessDto {
-    dmnDecisionId: string;
+    decisionDefinitionId: string;
     version: number;
     decisionKey: string;
-    dmnDecisionName: string;
+    name: string;
     tenantId: string;
-    dmnDecisionRequirementsId: string;
-    dmnDecisionRequirementsKey: string;
+    decisionRequirementsId: string;
+    decisionRequirementsKey: string;
+    decisionDefinitionKey: string;
 }
 export declare class DecisionRequirementsDeployment extends LosslessDto {
-    dmnDecisionRequirementsId: string;
+    decisionRequirementsId: string;
     version: number;
-    dmnDecisionRequirementsName: string;
+    decisionRequirementsName: string;
     tenantId: string;
-    dmnDecisionRequirementsKey: string;
+    decisionRequirementsKey: string;
     resourceName: string;
 }
 export declare class FormDeployment {
@@ -105,7 +106,7 @@ export declare class CreateProcessInstanceResponse<T = Record<string, never>> {
     /**
      * The version of the process; set to -1 to use the latest version
      */
-    readonly version: number;
+    readonly processDefinitionVersion: number;
     readonly processInstanceKey: string;
     /**
      * the tenant identifier of the created process instance
@@ -180,7 +181,7 @@ export interface CreateProcessBaseRequest<V extends JSONDoc | LosslessDto> {
     /**
      * the version of the process; if not specified it will use the latest version
      */
-    version?: number;
+    processDefinitionVersion?: number;
     /**
      * JSON document that will instantiate the variables for the root variable scope of the
      * process instance.
@@ -323,19 +324,27 @@ export interface AdvancedStringFilter {
     /** Checks if the current property exists. */
     $exists?: boolean;
     /** Checks if the property matches any of the provided values. */
-    $in: string[];
+    $in?: string[];
     /** Checks if the property matches the provided like value. Supported wildcard characters depend on the configured search client. */
-    $like: string;
+    $like?: string;
 }
 export interface AdvancedNumberFilter {
+    /** Checks for equality with the provided value. */
     $eq?: number;
+    /** Checks for inequality with the provided value. */
     $neq?: number;
-    $exists: boolean;
-    $in: number[];
-    $gt: number;
-    $gte: number;
-    $lt: number;
-    $lte: number;
+    /** Checks if the current property exists. */
+    $exists?: boolean;
+    /** Checks if the property matches any of the provided values. */
+    $in?: number[];
+    /** Checks if the property is greater than the provided value. */
+    $gt?: number;
+    /** Checks if the property is greater than or equal to the provided value. */
+    $gte?: number;
+    /** Checks if the property is less than the provided value. */
+    $lt?: number;
+    /** Checks if the property is less than or equal to the provided value. */
+    $lte?: number;
 }
 export interface VariableSearchFilterRequest {
     /** The key for this variable. */
@@ -574,7 +583,7 @@ export interface ProcessInstanceSearchFilter {
     /** The process definition name. */
     processDefinitionName?: string | AdvancedStringFilter;
     /** The process definition version. */
-    processDefinitionVersion?: string | AdvancedStringFilter;
+    processDefinitionVersion?: number | AdvancedStringFilter;
     /** The process definition version tag. */
     processDefinitionVersionTag?: string | AdvancedStringFilter;
     /** The process definition key. */
@@ -596,21 +605,21 @@ export interface ProcessInstanceSearchFilter {
         /** Name of the variable. */
         name: string;
         /** The value of the variable */
-        value: string;
+        value: string | AdvancedStringFilter;
     }>;
 }
 /** This is the 8.8 API.  */
 export interface SearchProcessInstanceRequest extends BaseSearchRequest<'processInstanceKey' | 'processDefinitionId' | 'processDefinitionName' | 'processDefinitionVersion' | 'processDefinitionVersionTag' | 'processDefinitionKey' | 'parentProcessInstanceKey' | 'parentFlowNodeInstanceKey' | 'state' | 'startDate' | 'endDate' | 'tenantId' | 'hasIncident', ProcessInstanceSearchFilter> {
 }
-interface ProcessInstanceDetails {
+export interface ProcessInstanceDetails {
     /** The key of the process instance. */
     processInstanceKey: string;
     /** The key of the process definition. */
     processDefinitionKey: string;
     /** The key of the parent process instance. */
-    parentProcessInstanceKey: string;
+    parentProcessInstanceKey?: string;
     /** The key of the parent flow node instance. */
-    parentFlowNodeInstanceKey: string;
+    parentFlowNodeInstanceKey?: string;
     /** The BPMN process ID of the process definition. */
     processDefinitionId: string;
     /** The name of the process definition. */
@@ -1034,4 +1043,93 @@ interface IncidentDetails {
 }
 export interface CamundaRestSearchIncidentsResponse extends PaginatedCamundaRestSearchResponse<IncidentDetails> {
 }
+export interface DecisionInstanceSearchFilter {
+    /** The decision instance key. */
+    decisionInstanceKey?: string | AdvancedStringFilter;
+    /** The decision definition ID. */
+    decisionDefinitionId?: string | AdvancedStringFilter;
+    /** The decision definition key. */
+    decisionDefinitionKey?: string | AdvancedStringFilter;
+    /** The decision definition name. */
+    decisionDefinitionName?: string | AdvancedStringFilter;
+    /** The decision definition version. */
+    decisionDefinitionVersion?: number | AdvancedNumberFilter;
+    /** The process definition key associated to this decision instance. */
+    processDefinitionKey?: string | AdvancedStringFilter;
+    /** The process instance key associated to this decision instance. */
+    processInstanceKey?: string | AdvancedStringFilter;
+    /** The state of the decision instance. */
+    state?: 'EVALUATED' | 'FAILED' | 'UNKNOWN' | 'UNSPECIFIED';
+    /** The evaluation date. */
+    evaluationDate?: string | AdvancedDateTimeFilter;
+    /** The tenant ID. */
+    tenantId?: string | AdvancedStringFilter;
+    /** The decision type. */
+    decisionType?: 'DECISION_TABLE' | 'LITERAL_EXPRESSION' | 'UNSPECIFIED' | 'UNKNOWN';
+}
+export interface CamundaRestSearchDecisionInstancesRequest extends BaseSearchRequest<'decisionInstanceKey' | 'decisionDefinitionId' | 'decisionDefinitionKey' | 'decisionDefinitionName' | 'decisionDefinitionVersion' | 'processDefinitionKey' | 'processInstanceKey' | 'state' | 'evaluationDate' | 'tenantId' | 'decisionType', DecisionInstanceSearchFilter> {
+}
+interface DecisionInstanceDetails {
+    /** The decision instance key. */
+    decisionInstanceKey: string;
+    /** The decision definition ID. */
+    decisionDefinitionId: string;
+    /** The decision definition key. */
+    decisionDefinitionKey: string;
+    /** The decision definition name. */
+    decisionDefinitionName: string;
+    /** The decision definition version. */
+    decisionDefinitionVersion: number;
+    /** The process definition key associated to this decision instance. */
+    processDefinitionKey: string;
+    /** The process instance key associated to this decision instance. */
+    processInstanceKey: string;
+    /** The state of the decision instance. */
+    state: 'EVALUATED' | 'FAILED' | 'UNKNOWN' | 'UNSPECIFIED';
+    /** The evaluation date. */
+    evaluationDate: string;
+    /** The evaluation failure message, if any. */
+    evaluationFailure?: string;
+    /** The tenant ID. */
+    tenantId: string;
+    /** The decision type. */
+    decisionType: 'DECISION_TABLE' | 'LITERAL_EXPRESSION' | 'UNSPECIFIED' | 'UNKNOWN';
+    /** The result of the decision evaluation. */
+    result: string;
+    /** The ID of the decision instance. */
+    decisionInstanceId: string;
+}
+export interface CamundaRestSearchDecisionInstancesResponse extends PaginatedCamundaRestSearchResponse<DecisionInstanceDetails> {
+}
+/**
+ * Response from getting a single decision instance by its key.
+ */
+export interface GetDecisionInstanceResponse {
+    /** The decision instance key. */
+    decisionInstanceKey: string;
+    /** The decision definition ID. */
+    decisionDefinitionId: string;
+    /** The decision definition key. */
+    decisionDefinitionKey: string;
+    /** The decision definition name. */
+    decisionDefinitionName: string;
+    /** The decision definition version. */
+    decisionDefinitionVersion: number;
+    /** The process definition key associated to this decision instance. */
+    processDefinitionKey: string;
+    /** The process instance key associated to this decision instance. */
+    processInstanceKey: string;
+    /** The state of the decision instance. */
+    state: 'EVALUATED' | 'FAILED' | 'UNKNOWN' | 'UNSPECIFIED';
+    /** The evaluation date. */
+    evaluationDate: string;
+    /** The evaluation failure message, if any. */
+    evaluationFailure?: string;
+    /** The tenant ID. */
+    tenantId: string;
+    /** The decision type. */
+    decisionDefinitionType: 'DECISION_TABLE' | 'LITERAL_EXPRESSION' | 'UNSPECIFIED' | 'UNKNOWN';
+    /** The result of the decision evaluation. */
+    result: string;
+}
 export {};

package/dist/c8/lib/C8Dto.js

@@ -40,13 +40,13 @@ __decorate([
 ], DecisionDeployment.prototype, "decisionKey", void 0);
 __decorate([
     lib_1.Int64String
-], DecisionDeployment.prototype, "dmnDecisionRequirementsKey", void 0);
+], DecisionDeployment.prototype, "decisionRequirementsKey", void 0);
 class DecisionRequirementsDeployment extends lib_1.LosslessDto {
 }
 exports.DecisionRequirementsDeployment = DecisionRequirementsDeployment;
 __decorate([
     lib_1.Int64String
-], DecisionRequirementsDeployment.prototype, "dmnDecisionRequirementsKey", void 0);
+], DecisionRequirementsDeployment.prototype, "decisionRequirementsKey", void 0);
 class FormDeployment {
 }
 exports.FormDeployment = FormDeployment;

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

@@ -1 +1 @@
-{"version":3,"file":"C8Dto.js","sourceRoot":"","sources":["../../../src/c8/lib/C8Dto.ts"],"names":[],"mappings":";;;;;;;;;AAIA,mCAA8D;AAS9D,MAAa,UAGX,SAAQ,iBAAW;CAoBpB;AAvBD,gCAuBC;AAlBA;IADC,iBAAW;0CACG;AAGf;IADC,iBAAW;sDACe;AAI3B;IADC,iBAAW;wDACiB;AAG7B;IADC,iBAAW;sDACe;AAK3B;IADC,iBAAW;4CACK;AAuClB,MAAa,iBAAkB,SAAQ,iBAAW;CAOjD;AAPD,8CAOC;AAHA;IADC,iBAAW;+DACiB;AAK9B,MAAa,kBAAmB,SAAQ,iBAAW;CAUlD;AAVD,gDAUC;AANA;IADC,iBAAW;uDACQ;AAKpB;IADC,iBAAW;sEACuB;AAGpC,MAAa,8BAA+B,SAAQ,iBAAW;CAQ9D;AARD,wEAQC;AAFA;IADC,iBAAW;kFACuB;AAGpC,MAAa,cAAc;CAO1B;AAPD,wCAOC;AAHA;IADC,iBAAW;+CACI;AAKjB,MAAa,yBAA0B,SAAQ,iBAAW;CAUzD;AAVD,8DAUC;AARA;IADC,iBAAW;gEACU;AAUvB,MAAa,sBAAuB,SAAQ,yBAAyB;CAKpE;AALD,wDAKC;AAED,MAAa,6BAA6B;CAyBzC;AAzBD,sEAyBC;AAnBS;IADR,iBAAW;2EAC0B;AAU7B;IADR,iBAAW;yEACwB;AA8BrC,gCAAgC;AAChC,MAAa,uBAAwB,SAAQ,iBAAW;CAMvD;AAND,0DAMC;AAHA;IAFC,iBAAW;IACZ,sDAAsD;0DACpC;AA4BnB,MAAa,wBAAyB,SAAQ,iBAAW;CASxD;AATD,4DASC;AANA;IADC,iBAAW;4DACO;AAKnB;IADC,iBAAW;oEACe;AAG5B,MAAa,sBAAuB,SAAQ,iBAAW;CAMtD;AAND,wDAMC;AAHA;IADC,iBAAW;0DACO;AA8lBpB,MAAa,sBAAuB,SAAQ,iBAAW;IAAvD;;QACC,uDAAuD;QACvD,KAAC,uBAAuB,CAAC,GAAG,SAAS,CAAA;IAQtC,CAAC;CAAA;AAVD,wDAUC;AAED,MAAa,uBAAuB;CAUnC;AAVD,0DAUC;AAuED,MAAa,eAAgB,SAAQ,iBAAW;CAO/C;AAPD,0CAOC;AAED,MAAa,WAAY,SAAQ,iBAAW;CAO3C;AAPD,kCAOC;AADA;IADC,IAAA,cAAQ,EAAC,eAAe,CAAC;qDACU;AAGrC,MAAa,cAAe,SAAQ,iBAAW;CAO9C;AAPD,wCAOC;AAED,MAAa,iBAAkB,SAAQ,iBAAW;CAmBjD;AAnBD,8CAmBC;AALA;IADC,IAAA,cAAQ,EAAC,WAAW,CAAC;uDACM;AAE5B;IADC,IAAA,cAAQ,EAAC,cAAc,CAAC;0DACS;AAKnC,MAAa,wBAAyB,SAAQ,iBAAW;CAyBxD;AAzBD,4DAyBC;AADA;IADC,IAAA,cAAQ,EAAC,iBAAiB,CAAC;oEACY;AA4DzC,MAAM,QAAS,SAAQ,iBAAW;CAYjC;AATA;IADC,iBAAW;oCACD;AAWZ,8BAA8B;AAC9B,MAAa,mBAAoB,SAAQ,iBAAW;CAMnD;AAND,kDAMC;AADA;IADC,IAAA,cAAQ,EAAC,QAAQ,CAAC;kDACD;AAGnB,MAAa,mBAAmB;CAO/B;AAPD,kDAOC"}
+{"version":3,"file":"C8Dto.js","sourceRoot":"","sources":["../../../src/c8/lib/C8Dto.ts"],"names":[],"mappings":";;;;;;;;;AAIA,mCAA8D;AAS9D,MAAa,UAGX,SAAQ,iBAAW;CAoBpB;AAvBD,gCAuBC;AAlBA;IADC,iBAAW;0CACG;AAGf;IADC,iBAAW;sDACe;AAI3B;IADC,iBAAW;wDACiB;AAG7B;IADC,iBAAW;sDACe;AAK3B;IADC,iBAAW;4CACK;AAuClB,MAAa,iBAAkB,SAAQ,iBAAW;CAOjD;AAPD,8CAOC;AAHA;IADC,iBAAW;+DACiB;AAK9B,MAAa,kBAAmB,SAAQ,iBAAW;CAWlD;AAXD,gDAWC;AAPA;IADC,iBAAW;uDACQ;AAKpB;IADC,iBAAW;mEACoB;AAIjC,MAAa,8BAA+B,SAAQ,iBAAW;CAQ9D;AARD,wEAQC;AAFA;IADC,iBAAW;+EACoB;AAGjC,MAAa,cAAc;CAO1B;AAPD,wCAOC;AAHA;IADC,iBAAW;+CACI;AAKjB,MAAa,yBAA0B,SAAQ,iBAAW;CAUzD;AAVD,8DAUC;AARA;IADC,iBAAW;gEACU;AAUvB,MAAa,sBAAuB,SAAQ,yBAAyB;CAKpE;AALD,wDAKC;AAED,MAAa,6BAA6B;CAyBzC;AAzBD,sEAyBC;AAnBS;IADR,iBAAW;2EAC0B;AAU7B;IADR,iBAAW;yEACwB;AA8BrC,gCAAgC;AAChC,MAAa,uBAAwB,SAAQ,iBAAW;CAMvD;AAND,0DAMC;AAHA;IAFC,iBAAW;IACZ,sDAAsD;0DACpC;AA4BnB,MAAa,wBAAyB,SAAQ,iBAAW;CASxD;AATD,4DASC;AANA;IADC,iBAAW;4DACO;AAKnB;IADC,iBAAW;oEACe;AAG5B,MAAa,sBAAuB,SAAQ,iBAAW;CAMtD;AAND,wDAMC;AAHA;IADC,iBAAW;0DACO;AAsmBpB,MAAa,sBAAuB,SAAQ,iBAAW;IAAvD;;QACC,uDAAuD;QACvD,KAAC,uBAAuB,CAAC,GAAG,SAAS,CAAA;IAQtC,CAAC;CAAA;AAVD,wDAUC;AAED,MAAa,uBAAuB;CAUnC;AAVD,0DAUC;AAuED,MAAa,eAAgB,SAAQ,iBAAW;CAO/C;AAPD,0CAOC;AAED,MAAa,WAAY,SAAQ,iBAAW;CAO3C;AAPD,kCAOC;AADA;IADC,IAAA,cAAQ,EAAC,eAAe,CAAC;qDACU;AAGrC,MAAa,cAAe,SAAQ,iBAAW;CAO9C;AAPD,wCAOC;AAED,MAAa,iBAAkB,SAAQ,iBAAW;CAmBjD;AAnBD,8CAmBC;AALA;IADC,IAAA,cAAQ,EAAC,WAAW,CAAC;uDACM;AAE5B;IADC,IAAA,cAAQ,EAAC,cAAc,CAAC;0DACS;AAKnC,MAAa,wBAAyB,SAAQ,iBAAW;CAyBxD;AAzBD,4DAyBC;AADA;IADC,IAAA,cAAQ,EAAC,iBAAiB,CAAC;oEACY;AA4DzC,MAAM,QAAS,SAAQ,iBAAW;CAYjC;AATA;IADC,iBAAW;oCACD;AAWZ,8BAA8B;AAC9B,MAAa,mBAAoB,SAAQ,iBAAW;CAMnD;AAND,kDAMC;AADA;IADC,IAAA,cAAQ,EAAC,QAAQ,CAAC;kDACD;AAGnB,MAAa,mBAAmB;CAO/B;AAPD,kDAOC"}

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

@@ -6,13 +6,13 @@ import PCancelable from 'p-cancelable';
 import { Camunda8ClientConfiguration, LosslessDto } from '../../lib';
 import { IHeadersProvider } from '../../oauth';
 import { ActivateJobsRequest, BroadcastSignalReq, CompleteJobRequest, ErrorJobWithVariables, FailJobRequest, JSONDoc, PublishMessageRequest, TopologyResponse } from '../../zeebe/types';
-import { AssignUserTaskRequest, BroadcastSignalResponse, CamundaRestSearchElementInstancesResponse, CamundaRestSearchIncidentsResponse, CamundaRestSearchProcessDefinitionsResponse, CamundaRestSearchProcessInstanceResponse, CamundaRestSearchUserTasksResponse, CamundaRestSearchVariablesResponse, CamundaRestUserTaskVariablesResponse, CorrelateMessageResponse, CreateDocumentLinkRequest, CreateProcessInstanceReq, CreateProcessInstanceResponse, Ctor, DeployResourceResponse, DownloadDocumentRequest, ElementInstanceDetails, EvaluateDecisionRequest, EvaluateDecisionResponse, GetProcessDefinitionResponse, GetVariableResponse, JobUpdateChangeset, JobWithMethods, JsonApiEndpointRequest, MigrationRequest, ModifyProcessInstanceRequest, NewUserInfo, PatchAuthorizationRequest, PublishMessageResponse, RawApiEndpointRequest, SearchElementInstancesRequest, SearchIncidentsRequest, SearchProcessDefinitionsRequest, SearchProcessInstanceRequest, SearchTasksRequest, SearchUsersRequest, SearchUsersResponse, SearchVariablesRequest, TaskChangeSet, UnknownRequestBody, UpdateElementVariableRequest, UploadDocumentRequest, UploadDocumentResponse, UploadDocumentsResponse, UserTask, UserTaskVariablesRequest } from './C8Dto';
+import { AssignUserTaskRequest, BroadcastSignalResponse, CamundaRestSearchDecisionInstancesRequest, CamundaRestSearchDecisionInstancesResponse, CamundaRestSearchElementInstancesResponse, CamundaRestSearchIncidentsResponse, CamundaRestSearchProcessDefinitionsResponse, CamundaRestSearchProcessInstanceResponse, CamundaRestSearchUserTasksResponse, CamundaRestSearchVariablesResponse, CamundaRestUserTaskVariablesResponse, CorrelateMessageResponse, CreateDocumentLinkRequest, CreateProcessInstanceReq, CreateProcessInstanceResponse, Ctor, DeployResourceResponse, DownloadDocumentRequest, ElementInstanceDetails, EvaluateDecisionRequest, EvaluateDecisionResponse, GetDecisionInstanceResponse, GetProcessDefinitionResponse, GetVariableResponse, JobUpdateChangeset, JobWithMethods, JsonApiEndpointRequest, MigrationRequest, ModifyProcessInstanceRequest, NewUserInfo, PatchAuthorizationRequest, PublishMessageResponse, RawApiEndpointRequest, SearchElementInstancesRequest, SearchIncidentsRequest, SearchProcessDefinitionsRequest, SearchProcessInstanceRequest, SearchTasksRequest, SearchUsersRequest, SearchUsersResponse, SearchVariablesRequest, TaskChangeSet, UnknownRequestBody, UpdateElementVariableRequest, UploadDocumentRequest, UploadDocumentResponse, UploadDocumentsResponse, UserTask, UserTaskVariablesRequest } from './C8Dto';
 import { Logger } from './C8Logger';
 import { CamundaJobWorker, CamundaJobWorkerConfig } from './CamundaJobWorker';
 /**
- * The client for the unified Camunda 8 REST API.
+ * The client for the unified Camunda 8 Orchestration Cluster REST API.
  *
- * Logging: to enable debug tracing during development, you can set `DEBUG=camunda:zeebe-rest`.
+ * Logging: to enable debug tracing during development, you can set `DEBUG=camunda:orchestration-rest`.
  *
  * For production, you can pass in an logger compatible with {@link Logger} to the constructor as `logger`.
  *
@@ -320,7 +320,7 @@ export declare class CamundaRestClient {
      *
      * @since 8.6.0
      */
-    migrateProcessInstance(req: MigrationRequest): Promise<unknown>;
+    migrateProcessInstance(req: MigrationRequest): Promise<''>;
     /**
      * Query process instances
      *
@@ -534,7 +534,7 @@ export declare class CamundaRestClient {
      * Documentation https://docs.camunda.io/docs/apis-tools/camunda-api-rest/specifications/modify-process-instance/
      * @since 8.6.0
      */
-    modifyProcessInstance(request: ModifyProcessInstanceRequest): Promise<void>;
+    modifyProcessInstance(request: ModifyProcessInstanceRequest): Promise<''>;
     /**
      * Evaluate decision
      *
@@ -583,6 +583,18 @@ export declare class CamundaRestClient {
      * @since 8.8.0
      */
     searchIncidents(request: SearchIncidentsRequest): Promise<CamundaRestSearchIncidentsResponse>;
+    /**
+     * @description Search for decision instances based on given criteria.
+     * Documentation: https://docs.camunda.io/docs/next/apis-tools/orchestration-cluster-api-rest/specifications/search-decision-instances/
+     * @since 8.8.0
+     */
+    searchDecisionInstances(request: CamundaRestSearchDecisionInstancesRequest): Promise<CamundaRestSearchDecisionInstancesResponse>;
+    /**
+     * Get a decision instance by key.
+     * @param decisionInstanceKey The key of the decision instance to get
+     * @returns Decision instance details
+     */
+    getDecisionInstance(decisionInstanceKey: string): Promise<GetDecisionInstanceResponse>;
     /**
      * This is a generic method to call an API endpoint. Use this method to call any REST API endpoint in the Camunda 8 cluster.
      * TODO: This does not currently support multipart form-data, but it will.