Utility Bundles - Core, Dynamic and Test

Docs

Search

Help & Feedback

Get Started
Functionality
Learning
Extension
Dev Tooling
APIs
Releases

Release

Author:

Holger Lierse

Changed on:

1 Sept 2025

Target release date:	2025-09-01
Release status:	Released

Description

Fluent Commerce announces the release of the Fluent Commerce Utility Bundles, a major step forward in making Rule development faster, cleaner, and more consistent.These new bundles give developers a powerful set of ready-to-use tools for building Rules, handling Events, working with GraphQL, and writing reliable tests - all while reducing repetitive code and improving maintainability.The Utility Bundles support the development of both simple Rules and complex Workflows, enabling faster delivery, minimizing common pitfalls, and maintaining a clean codebase.The following three Utility Bundles are now available and should be adopted in Rule development:🔧 Core Utilities BundleEssential tools for day-to-day rule development, including:

Event Utilities: Create and manipulate Fluent events effectively
Rule Utilities: Common logic for building and evaluating rules
Query Utilities: Simplified construction of GraphQL queries
Settings Utilities: Access and manage settings consistently
JSON Utilities: Safe and reliable JSON processing
GraphQL Date Utilities: Robust handling of date formatting in GraphQL
Log Utilities: Standardized logging for easier debugging

Benefit:

Eliminates repetitive, error-prone code
Keeps rules clean and focused
Speeds up development by providing ready-to-use functions

⚡ Dynamic Utilities BundleStreamlines dynamic GraphQL interactions, including:

Dynamic Queries: Generate flexible, parameterized queries at runtime
Dynamic Mutations: Build complex mutations without boilerplate
Dynamic Pagination: Simplifies handling of paginated responses

Benefit:

Reduces complexity for advanced rule scenarios
Improves maintainability for rules that depend on dynamic data
Keeps business logic flexible without sacrificing code clarity

🧪 Test Utilities BundlesTools to make rule testing fast and reliable:

RuleExecutor: Simulate rule execution in isolation
WorkflowExecutor: Test entire workflows end-to-end
MockApiClient: Mock API interactions for safe, controlled testing
RuleContextGenerator: Set up consistent test contexts efficiently

Benefit:

Accelerates unit and integration testing
Reduces the risk of bugs reaching production
Makes test setup straightforward, even for complex rules

Changelog

Initial release

Packages

Core Utilities

Edited 51 days ago

The Core Utility (`util-core`) is a standard library of utility functions designed to simplify and accelerate Rule development on the Fluent Commerce platform. It provides a foundational set of helper classes that address the most common challenges and repetitive tasks developers face.

Dynamic Utilities

Edited 51 days ago

The `util-dynamic` library is a collection of powerful utility functions that allow you to generate GraphQL queries and mutations at runtime. This enables the creation of highly configurable and reusable rules that can adapt to different needs without requiring code changes.

Test Utilities

Edited 51 days ago

The `util-test` library is a comprehensive collection of utility functions, mock objects, and executors designed to minimize the overhead and complexity of testing your Fluent Commerce rules. It provides a fluent, builder-style API that makes writing clean, readable, and robust tests straightforward.

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

Related content

Utility Bundles Overview

Edited 166 days ago

The Fluent Commerce Utility Bundles are a set of libraries designed to accelerate Rule development, reduce boilerplate code, and improve the overall quality and maintainability of implementations. They are the cornerstone of writing maintainable, reusable, and easily upgradeable Rules for the Fluent Commerce platform.

Getting Started with the Utility Bundles

Edited 156 days ago

Core Utilities Overview

Edited 202 days ago

The Core Utility (`util-core`) is a standard library of utility functions designed to simplify and accelerate Rule development on the Fluent Commerce platform. It provides a foundational set of helper classes that address common development challenges - such as safely handling event attributes, retrieving and converting settings, logging consistently, and minimizing boilerplate code when forwarding events or querying data.PrerequisitesThese articles assumes you're familiar with:

Java
Maven
JUnit

Dynamic Utilities Overview

Edited 78 days ago

The `util-dynamic` library is a collection of utility functions that allow you to generate GraphQL queries and mutations at runtime. This enables the creation of highly configurable and reusable rules that can adapt to different needs without requiring code changes.PrerequisitesThese articles assumes you're familiar with:

Java
Maven
JUnit

Test Utilities Overview

Edited 167 days ago

The `util-test` library is a comprehensive collection of utility functions, mock objects, and executors designed to minimize the overhead and complexity of testing your Fluent Commerce rules.PrerequisitesThese articles assumes you're familiar with:

Java
Maven
JUnit

Holger Lierse

Holger Lierse

Copyright © 2024-2026 Fluent Retail Pty Ltd (trading as Fluent Commerce). Unless otherwise expressly stated in a current written agreement with Fluent Commerce or any of its affiliates or on any single page of the docs.fluentcommerce.com site, use of the materials on this site is strictly limited to viewing by individuals over 18 years old for legitimate commercially appropriate reasons; and any downloading, copying or other actions or uses of any kind or by any means of the materials on this site, including by artificial intelligence tools, is strictly prohibited. All other rights reserved.