133
Test Cases
100% Passing Rate
451
Assertions
Zero Failures
0
Errors or Warnings
0 Notices · 0 Deprecations
PHP 8.2–8.5
Strict Types
PHPUnit 12 Validated
Domain Coverage Scope
Every architectural layer in the extension is backed by isolated unit tests with mocked framework dependencies:
| Test Suite Domain | Tests | Assertions | Coverage Scope |
|---|---|---|---|
| Data Providers & Extraction | 25 | 108 | CMS, Category, and Product Markdown generation, MSI stock resolution, configurable options, price/availability toggles, currency rate conversion, and 20k knowledge attributes. |
| Indexers & Mview Operations | 17 | 56 | Positive ID deduplication, chunking (BATCH_SIZE = 100), store iteration, and plan verification short-circuiting. |
| Queue & Messaging Pipeline | 20 | 69 | RabbitMQ publishing, non-positive ID validation, batch processing, connection resilience, and consumer dispatching. |
| Observers & Action Plugins | 16 | 45 | Save commit events, mass attribute update interception, and store ID sanitization. |
| CLI Management Suite | 26 | 88 | Full command coverage (config:*, sync:*, test, consume) across table and JSON modes. |
| Admin UI & Controllers | 29 | 85 | Status dashboard metrics, Important Information merchant guide, AJAX queue processing, and form modifiers. |
| Total Enterprise Suite | 133 | 451 | 100% Pass Rate (0 failures, 0 errors, 0 deprecations) |
Data Providers & Extraction
25 Tests108 Assertions
CMS, Category, and Product Markdown generation, MSI stock resolution, configurable options, price/availability toggles, currency rate conversion, and 20k knowledge attributes.
Indexers & Mview Operations
17 Tests56 Assertions
Positive ID deduplication, chunking (BATCH_SIZE = 100), store iteration, and plan verification short-circuiting.
Queue & Messaging Pipeline
20 Tests69 Assertions
RabbitMQ publishing, non-positive ID validation, batch processing, connection resilience, and consumer dispatching.
Observers & Action Plugins
16 Tests45 Assertions
Save commit events, mass attribute update interception, and store ID sanitization.
CLI Management Suite
26 Tests88 Assertions
Full command coverage (config:*, sync:*, test, consume) across table and JSON modes.
Admin UI & Controllers
29 Tests85 Assertions
Status dashboard metrics, Important Information merchant guide, AJAX queue processing, and form modifiers.
Total: 133 Tests • 451 Assertions
100% Pass Rate (0 failures, 0 errors, 0 deprecations)
Running the Test Suite Locally or in CI/CD
To execute the unit tests from your Magento root directory:
vendor/bin/phpunit app/code/ClusterifyAI/ChatBot/Test/Unit/
Testing & QA FAQ
Frequently Asked Questions: Automated Testing & Stability
Technical questions regarding test coverage, mocked dependencies, and front-end immunity.
How many automated unit tests and assertions are included with the extension?
The extension includes a comprehensive automated test suite of 133 unit tests validating 451 assertions with a 100% pass rate and zero errors, warnings, notices, or deprecations.
Which PHP versions and PHPUnit frameworks are supported?
The test suite strictly complies with PHPUnit 12 (and PHPUnit 11 on PHP 8.2) and is validated across modern PHP 8.2, 8.3, 8.4, and 8.5 environments using strict parameter and return type declarations.
How does the test suite guarantee zero front-end regressions on live storefronts?
Tests verify front-end immunity: layout blocks are asserted as cacheable (
cacheable="true"), script tags load asynchronously, and silent failsafes guarantee that if API keys are inactive or unconfigured, the block outputs an empty string, keeping the live storefront DOM 100% untouched. Learn more in our Page Visibility guide.How do unit tests verify smart fallback logic for unpopulated AI knowledge?
Tests validate that when the dedicated 20,000-character AI knowledge attribute is null or empty, the provider automatically falls back to standard storefront descriptions and core attributes. Shoppers never receive blank responses. Learn more in our Knowledge Architecture guide.
How can developers or agency QA teams execute the test suite locally?
Run a single terminal command from your Magento root directory:
vendor/bin/phpunit app/code/ClusterifyAI/ChatBot/Test/Unit/. The entire 133-test suite executes in under two seconds.Are Magento framework dependencies mocked in the test suite?
Yes. The tests use isolated unit testing with stubs and mocks for
ScopeConfigInterface, StoreManagerInterface, and the official PHP SDK client. Tests run cleanly without requiring an active MySQL or Redis connection.How are Mview changelog triggers and indexer chunking validated?
Dedicated tests assert that unique positive entity IDs are deduplicated from changelog tables and chunked in batches of 100 (
BATCH_SIZE = 100). Review our RabbitMQ sync architecture.Are RabbitMQ message serialization and consumer dispatching tested?
Yes. The queue test suite validates AMQP envelope creation, topic routing keys (
sync.cms, sync.category, sync.product), batch processing resilience, and consumer error handling.How does the test suite validate Adobe Commerce Content Staging compatibility?
Tests mock
MetadataPool versioning and assert that data providers resolve active staged campaign versions through repository interfaces without triggering row_id errors. Read our Cloud Compatibility Guide.Are CLI commands tested across both table and JSON output modes?
Yes. 26 dedicated CLI tests validate command execution across all 10 commands using Symfony Console command testers, verifying valid JSON structures and exit codes (
0 or 1). Consult our CLI Reference.