feat: add ContainmentPattern type for JSON condition matching

[jumski]

Add type-safe condition patterns for Flow steps

This PR introduces a new ContainmentPattern<T> utility type that provides type safety for condition patterns in Flow steps. The implementation matches PostgreSQL's JSON containment semantics (@>) where:

• Primitives require exact value matches
• Objects have all keys optional and are recursively applied
• Arrays expect elements to be present in the target array

The PR enhances the Flow API by:

1. Adding proper type checking for condition options in all step methods
2. Ensuring conditions for root steps match the flow input structure
3. Ensuring conditions for dependent steps match the dependency object structure
4. Preventing invalid keys or value types in condition patterns

Comprehensive type tests are included to verify the behavior of the ContainmentPattern<T> utility and its integration with the Flow API.

[changeset-bot]

⚠️ No Changeset found

Latest commit: 5db1a76

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[jumski]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• docs: add conditional steps documentation and skipped step styling #594
• fix: improve type safety for skip-cascade mode in flow steps #593
• refactor: rename condition_pattern to required_input_pattern and condition_not_pattern to forbidden_input_pattern #587
• feat: add whenUnmet and whenFailed condition modes to flow shapes #585
• feat: add ifNot condition pattern for negative condition checks #584
• feat: improve type safety for flow step outputs and skippable dependencies #583
• feat: add type safety for skippable step dependencies #582
• feat: add ContainmentPattern type for JSON condition matching #576 👈 (View in Graphite)
• feat: add whenFailed option for error handling after retries exhausted #575
• feat: add conditional step execution with skip/fail behavior #573
• feat: add conditional step execution with skip infrastructure #572
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[nx-cloud]

View your CI Pipeline Execution ↗ for commit 5db1a76

Command	Status	Duration	Result
nx run client:e2e	✅ Succeeded	1m 9s	View ↗
nx run edge-worker:test:integration	✅ Succeeded	5m 15s	View ↗
nx run cli:e2e	✅ Succeeded	3s	View ↗
nx run core:pgtap	✅ Succeeded	1s	View ↗
nx run edge-worker:e2e	✅ Succeeded	41s	View ↗
nx affected -t verify-exports --base=origin/mai...	✅ Succeeded	3s	View ↗
nx affected -t build --configuration=production...	✅ Succeeded	4s	View ↗
nx affected -t lint typecheck test --parallel -...	✅ Succeeded	44s	View ↗

---

☁️ Nx Cloud last updated this comment at 2026-01-14 08:08:51 UTC