@camunda8/orchestration-cluster-api 1.2.2 → 1.2.4-alpha.1

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,9 +1,28 @@
1
- ## [1.2.2](https://github.com/camunda/orchestration-cluster-api-js/compare/v1.2.1...v1.2.2) (2025-12-01)
1
+ ## [1.2.4-alpha.1](https://github.com/camunda/orchestration-cluster-api-js/compare/v1.2.3...v1.2.4-alpha.1) (2026-01-22)
2
+
3
+ ### Bug Fixes
4
+
5
+ - correctly type optional parameters ([8fef8c8](https://github.com/camunda/orchestration-cluster-api-js/commit/8fef8c8a4bc69a3dd86b76ac1e01431d97607050))
6
+ - enhance response validation error message ([d138134](https://github.com/camunda/orchestration-cluster-api-js/commit/d1381348f46c187e8321fdec088b7654b70c4fa8))
7
+ - handle multi-part spec ([86ac930](https://github.com/camunda/orchestration-cluster-api-js/commit/86ac930e3b599126cf5446bcaa323089049bb4ef))
8
+ - **spec:** prevent path-local $like refs breaking dts build ([3b75200](https://github.com/camunda/orchestration-cluster-api-js/commit/3b75200caeffb198f072668567cff7e34f5700f0))
9
+
10
+ ### Features
2
11
 
12
+ - build 8.9 from monorepo spec ([a80303d](https://github.com/camunda/orchestration-cluster-api-js/commit/a80303d3a54f2d6db77c428f46848f131bd8bf42))
13
+ - build from 8.9 spec ([e4ab53c](https://github.com/camunda/orchestration-cluster-api-js/commit/e4ab53cd253ca5d1fcf2d0bf0626c8d26c7da49c))
14
+
15
+ ## [1.2.3](https://github.com/camunda/orchestration-cluster-api-js/compare/v1.2.2...v1.2.3) (2025-12-05)
16
+
17
+ ### Bug Fixes
18
+
19
+ - support fetchVariables in job worker ([b672d8d](https://github.com/camunda/orchestration-cluster-api-js/commit/b672d8d3ec499624a58d1db2b8e920f3ccc77ebc))
20
+
21
+ ## [1.2.2](https://github.com/camunda/orchestration-cluster-api-js/compare/v1.2.1...v1.2.2) (2025-12-01)
3
22
 
4
23
  ### Bug Fixes
5
24
 
6
- * set default requestTimeout to 0 ([c18a22a](https://github.com/camunda/orchestration-cluster-api-js/commit/c18a22a0f5dacfcd6b16ac16d8260307a17f87d9))
25
+ - set default requestTimeout to 0 ([c18a22a](https://github.com/camunda/orchestration-cluster-api-js/commit/c18a22a0f5dacfcd6b16ac16d8260307a17f87d9))
7
26
 
8
27
  ## [1.2.1](https://github.com/camunda/orchestration-cluster-api-js/compare/v1.2.0...v1.2.1) (2025-11-28)
9
28
 
package/README.md CHANGED
@@ -114,7 +114,7 @@ Controlled by `CAMUNDA_SDK_VALIDATION` (or `config` override). Grammar:
114
114
 
115
115
  ```
116
116
  none | warn | strict | req:<mode>[,res:<mode>] | res:<mode>[,req:<mode>]
117
- <mode> = none|warn|strict
117
+ <mode> = none|warn|strict|fanatical
118
118
  ```
119
119
 
120
120
  Examples:
@@ -398,6 +398,8 @@ const worker = client.createJobWorker({
398
398
  maxParallelJobs: 10,
399
399
  timeoutMs: 15_000, // long‑poll timeout (server side requestTimeout)
400
400
  pollIntervalMs: 100, // delay between polls when no jobs / at capacity
401
+ // Optional: only fetch specific variables during activation
402
+ fetchVariables: ['orderId'],
401
403
  inputSchema: Input, // validates incoming variables if validateSchemas true
402
404
  outputSchema: Output, // validates variables passed to complete(...)
403
405
  validateSchemas: true, // set false for max throughput (skip Zod)
@@ -416,6 +418,29 @@ process.on('SIGINT', () => {
416
418
  });
417
419
  ```
418
420
 
421
+ Note on variable fetching:
422
+
423
+ - `fetchVariables: string[]` limits variables returned on activated jobs to the specified keys. If omitted, all visible variables at activation scope are returned. This maps to the REST API field `fetchVariable`.
424
+
425
+ TypeScript inference:
426
+
427
+ - When you provide `inputSchema`, the type of `fetchVariables` is constrained to the keys of the inferred `variables` type from that schema. Example:
428
+
429
+ ```ts
430
+ const Input = z.object({ orderId: z.string(), amount: z.number() });
431
+ client.createJobWorker({
432
+ jobType: 'process-order',
433
+ maxParallelJobs: 5,
434
+ jobTimeoutMs: 30_000,
435
+ inputSchema: Input,
436
+ // Only allows 'orderId' | 'amount' here at compile-time
437
+ fetchVariables: ['orderId', 'amount'],
438
+ jobHandler: async (job) => job.complete(),
439
+ });
440
+ ```
441
+
442
+ - Without `inputSchema`, `fetchVariables` defaults to `string[]`.
443
+
419
444
  ### Job Handler Semantics
420
445
 
421
446
  Your `jobHandler` must ultimately invoke exactly one of: