Skip to content

IntegrationEngine v8.0.0

Choose a tag to compare

View all tags
@CarlosGude CarlosGude released this 22 Sep 16:03
· 42 commits to main since this release
v8.0.0
8fe57e8

IntegrationEngine v8.0.0

A major release with breaking API changes that improve security, simplify configuration, and enhance type safety.

🔐 Security Improvements

  • Scalar-only lifecycle events — Events no longer carry response objects or exceptions, preventing accidental secret leaks in logs
  • Built-in SSRF protection — Declarative host allowlists with optional private network blocking
  • Safe observability — All events contain only primitives (strings, numbers), never secrets

⚙️ Simplified Configuration

  • Webhook definitions in YAML — Centralized, contract-first webhook configuration
  • Declarative retries & timeouts — Configuration-driven retry policies with Retry-After support
  • Form encoding support — encoding: form in action YAML for form-encoded requests

🎯 Type Safety

  • Optional PHPStan rules — Validate mapper/action pairing, response class modifiers, facade return types
  • Connection resolvers — Multi-connection integrations with per-connection auth namespacing
  • Request middleware — Extensible request signing (OAuth 1.0a, etc.) for the fully-built request

🚀 What's New

  • Framework-independent error classification
  • debug:integration command for inspecting configurations
  • Batch token refresh with shared auth
  • Concurrent batch dispatch with encoding preservation
  • Request middleware for custom request signing

⚠️ Breaking Changes

  1. Lifecycle events — ActionStarted, ActionCompleted, ActionFailed → RequestSent, ResponseMapped, RequestFailed (scalar-only)
  2. Webhooks — Move to YAML configuration; mappers still extend AbstractWebhookMapper
  3. Idempotency — Legacy webhook idempotency services removed; applications must implement their own

📚 Migration

See UPGRADE-8.0.md for a comprehensive migration guide covering:

  • Lifecycle events → scalar-only observability (30 min/integration)
  • Webhook YAML definitions (45 min/webhook)
  • Configuration changes (20 min)
  • Estimated total: 2-4 hours per integration

📋 Changelog

See CHANGELOG.md [8.0.0] for detailed features and fixes.

✅ Quality

  • 880/880 tests passing (100%)
  • 0 phpstan errors (max level)
  • 0 architecture violations (deptrac)
  • Complete documentation and migration guide

🔗 Links

PHP: ≥ 8.2 | Symfony: 6.4, 7.x | Stability: Stable

Assets 2
Loading