Fluent Commerce Logo
Docs

Controls Utilities Bundle

Release

Author:

Holger Lierse

Changed on:

31 Aug 2026

Target release date:2026-08-26
Release status:Released

Description

Controls determine what inventory is available to sell in a Virtual Catalog, applying buffers, exclusions and thresholds to positions. This bundle enables a Rule resolve and apply those controls consistently, and consolidates what would otherwise be many individual controls into fewer, wide-scope context-based ones. The Utility includes:
  • Applying Controls: resolve the controls that apply to a position and apply them in one call, returning the updated position and an audit of every change (`ControlUtils`).
  • Standard Control Types: inclusion, exclusion, buffer (absolute and percentage), limit and threshold controls are applied in a defined order (`ControlTypes`).
  • Context-Based Targeting: match positions by catalog, product, variant, location, category, network or the virtual position itself.
  • Extensibility: add or override control types with custom control functions.
Benefit:
  • Reduces redundancy by replacing many individual controls with fewer wide-scope, context-based ones
  • Applies availability controls consistently wherever they are used
  • Keeps rules lightweight by loading the required data and resolving controls
  • Produces a full before/after audit of every applied control
  • Extends to tenant-specific control types

Changelog

Initial release
  • Apply inclusion, exclusion, buffer, limit and threshold controls to inventory and Virtual Catalog Positions
  • Context-based control matching with chained conditions (AND across conditions, OR within multi-value conditions)
  • Group-level (`BULK_`) and position/product/variant-level control resolution, with most-specific precedence
  • Configurable `executionOrder` and support for custom control functions

Limitations

Released capability depth:New capability
Release bundle / Capability type:Tool