Connect SDK Libraries
Essential knowledge
Intended Audience:
Technical User
Author:
Fluent Commerce
Changed on:
8 June 2026
Overview
The Connect SDK Libraries comprise a modular software development framework designed for building integrations with Fluent Order Management. The architecture centers around a mandatory core module that handles foundational communication, configuration storage, and routing capabilities. Implementation teams can extend this baseline engine using specialized, pluggable add-on libraries to introduce web frameworks, security filters, specific cloud or infrastructure adapters, and isolated simulation testing suites.Key points
- What You Will Learn: You will understand the structural purpose of each component within the Connect SDK framework and learn how to select the appropriate core, web, cloud infrastructure, or testing dependencies for your implementation project.
- Mandatory Core Requirement: The
`connect-sdk-core`library is a mandatory dependency for all SDK-based implementations. It houses the baseline engine components, including the REST and GraphQL API client, authentication management for sensitive credentials, message routing, and the configuration manager. - Asynchronous Processing Boundary: All transactional endpoints and internal processing steps handled by the SDK execute asynchronously in the background. The explicit exception to this design rule is product availability processing, which runs synchronously.
- Pluggable Architecture Strategy: Advanced technical capabilities are intentionally isolated into decoupled modules. Developers append specialized add-ons like
`connect-sdk-core-web-security`for Spring Security filters,`connect-sdk-core-aws`for Amazon Web Services (AWS) deployment services like Amazon Simple Queue Service (SQS) and AWS Secrets Manager, or`connect-sdk-core-kafka`for Apache Kafka support. - Isolated Testing Frameworks: The SDK segregates quality assurance utilities into specific test scopes. Teams deploy
`connect-sdk-test-core`to mock external API calls with Wiremock, or utilize the AWS and Kafka test extensions to run integration tests inside software containers alongside LocalStack or virtual Kafka brokers.
| Name | Description | Maven dependency |
| SDK Core | The core library of the SDK is a necessary component for all SDK-based implementations, as it provides a variety of essential features:
| `<dependency>` `<groupId>com.fluentcommerce.connect</groupId>``<artifactId>connect-sdk-core</artifactId>``</dependency>` |
| SDK Core Web Security | Adds spring security with a couple of handy security filters | `<dependency>``<groupId>com.fluentcommerce.connect</groupId>``<artifactId>connect-sdk-core-web-security</artifactId>``</dependency>` |
| SDK Core Web with Spring MVC | Addon bringing a number of web-enabled features: | `<dependency>``<groupId>com.fluentcommerce.connect</groupId>``<artifactId>connect-sdk-core-web-mvc</artifactId>``</dependency>` |
| SDK Core AWS | Addon enables the SDK to be deployed to AWS and use its services like SQS and Secret manager. | `<dependency>``<groupId>com.fluentcommerce.connect</groupId>``<artifactId>connect-sdk-core-aws</artifactId>``</dependency>` |
| SDK Core Kafka | Adds support for Kafka | `<dependency>``<groupId>com.fluentcommerce.connect</groupId>``<artifactId>connect-sdk-core-kafka</artifactId>``</dependency>` |
| SDK Core Test for integration tests | Adds the ability to run integration tests mocking external calls with Wiremock. | `<dependency>``<groupId>com.fluentcommerce.connect</groupId>``<artifactId>connect-sdk-test-core</artifactId>``<scope>tes\</scope>``</dependency>` |
| SDK Core Test for AWS | Extend the common Core Test library to run the integration tests in a container along with localstack | `<dependency>``<groupId>com.fluentcommerce.connect</groupId>``<artifactId>connect-sdk-test-core-aws</artifactId>``<scope>test</scope>``</dependency>` |
| SDK Core Test for Kafka | Extend the common Core Test library to run the integration tests in a container along with Kafka. | `<dependency>``<groupId>com.fluentcommerce.connect</groupId>``<artifactId>connect-sdk-test-core-kafka</artifactId>``<scope>test</scope>``</dependency>` |
