@camunda8/orchestration-cluster-api 10.0.0-alpha.43 → 10.0.0-alpha.44

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,3 +1,10 @@
1
+ # [10.0.0-alpha.44](https://github.com/camunda/orchestration-cluster-api-js/compare/v10.0.0-alpha.43...v10.0.0-alpha.44) (2026-09-10)
2
+
3
+
4
+ ### Features
5
+
6
+ * regenerate and update agentInstance examples ([#501](https://github.com/camunda/orchestration-cluster-api-js/issues/501)) ([093ffca](https://github.com/camunda/orchestration-cluster-api-js/commit/093ffca9593205585e197daa07fdd8909009fde7))
7
+
1
8
  # [10.0.0-alpha.43](https://github.com/camunda/orchestration-cluster-api-js/compare/v10.0.0-alpha.42...v10.0.0-alpha.43) (2026-08-28)
2
9
 
3
10
 
package/README.md CHANGED
@@ -155,20 +155,11 @@ await camunda.createDeployment({
155
155
 
156
156
  ## Migrating from 8.9
157
157
 
158
- SDK 10.x (for Camunda 8.10) promotes several identifier and name fields from plain `string` to **branded types** via `CamundaKey<T>`. The wire format and runtime API are unchanged — branded values are still plain strings at runtime and are assignable anywhere a `string` is expected (template literals, logging, JSON serialization). Callers need to brand values using `.assumeExists()` (which performs validation) to satisfy the new types.
158
+ SDK 10.x (for Camunda 8.10) promotes several identifier fields from plain `string` to **branded types**, changes the `getResourceContent` response from a string to an object, and makes `BatchOperationItemResponse.processInstanceKey` nullable. Nothing was removed or renamed, and the wire format is unchanged.
159
159
 
160
- ### New branded types
160
+ **→ See [MIGRATION.md](./MIGRATION.md) for the full guide**, including the complete list of affected fields.
161
161
 
162
- | Brand | Used for |
163
- |-------|----------|
164
- | `RoleId` | Role identifiers |
165
- | `GroupId` | Group identifiers |
166
- | `ClientId` | OAuth client identifiers |
167
- | `MappingRuleId` | Mapping-rule identifiers |
168
- | `ClusterVariableName` | Cluster variable names |
169
- | `AgentInstanceKey` | Agent-instance system keys |
170
-
171
- ### Migration
162
+ The common case is branding an identifier at the boundary:
172
163
 
173
164
  <!-- snippet-source: examples/readme.ts | regions: V9ToV10Migration -->
174
165
 
@@ -188,12 +179,6 @@ await camunda.assignRoleToGroup({
188
179
 
189
180
  Each branded type has an `.assumeExists()` method that validates the string and returns the branded value. Validation runs at call time and can throw if the input is malformed, so call it once at the boundary (startup, config parsing, API response) and pass the branded value through your application. See [Branded Keys](#branded-keys) for more on this pattern.
190
181
 
191
- ### What does NOT change
192
-
193
- - The wire format is unchanged — all values are still strings on the wire.
194
- - No method signatures changed name or arity.
195
- - Branded values are assignable anywhere a `string` is expected (template literals, logging, JSON serialization), so existing string-handling code continues to work.
196
-
197
182
  ## Quick Start (Zero‑Config – Recommended)
198
183
 
199
184
  Keep configuration out of application code. Let the factory read `CAMUNDA_*` variables from the environment (12‑factor style). This makes rotation, secret management, and environment promotion safer & simpler.