Skip to content

feat(middleware): auto-resolve transitive dependencies#396

Merged
usernane merged 1 commit into
devfrom
feat/middleware-transitive-deps
Jun 14, 2026
Merged

feat(middleware): auto-resolve transitive dependencies#396
usernane merged 1 commit into
devfrom
feat/middleware-transitive-deps

Conversation

@usernane

Copy link
Copy Markdown
Member

Summary

Auto-resolve transitive middleware dependencies from the registry when assigned to a route.

Motivation

Previously, getDependencies() only affected sort order for middleware already assigned. If a dependency was not explicitly listed on the route, it was silently skipped. Now assigning middleware E (which depends on D→C→B→A) auto-includes the entire chain.

Changes

  • Added resolveDependencies() in RouterUri — BFS traversal of dependency graph
  • Called before sortByDependencies() in getMiddleware()
  • Missing dependencies silently skipped (same as before)
  • No duplicates when already assigned

How to Test / Verify

6 unit tests covering all branches:

vendor/bin/phpunit --filter MiddlewareTransitiveDepsTest

Breaking Changes and Migration Steps

None. Existing routes with all middleware explicitly assigned behave identically. Routes that relied on dependencies being silently skipped will now have those dependencies execute — this is the correct behavior per ADR-0002.

Checklist

  • I reviewed my own diff before requesting review
  • My commits follow Conventional Commits
  • I added/updated tests (or explained why not)
  • I updated docs (if needed) Docs Repo
  • I ran lint/cs-fixer (if applicable)
  • I considered backward compatibility
  • I considered security

Related issues

Closes #380

When a middleware declares dependencies via getDependencies(), assigning
only that middleware to a route now auto-includes all transitive
dependencies from MiddlewareRegistry via BFS traversal.

- resolveDependencies() walks the dependency graph before sorting
- Missing dependencies are silently skipped
- No duplicates when dependency is already assigned
- Execution order preserved via existing topological sort

Closes #380
@codecov

codecov Bot commented Jun 14, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 83.75%. Comparing base (b982bd6) to head (35763a9).
⚠️ Report is 4 commits behind head on dev.

Additional details and impacted files
@@             Coverage Diff              @@
##                dev     #396      +/-   ##
============================================
+ Coverage     83.67%   83.75%   +0.07%     
- Complexity     3067     3083      +16     
============================================
  Files           103      104       +1     
  Lines          9018     9061      +43     
============================================
+ Hits           7546     7589      +43     
  Misses         1472     1472              
Flag Coverage Δ
php-8.1 82.63% <100.00%> (+0.03%) ⬆️
php-8.2 82.63% <100.00%> (+0.03%) ⬆️
php-8.3 92.13% <100.00%> (+0.04%) ⬆️
php-8.4 92.13% <100.00%> (+0.04%) ⬆️
php-8.5 92.00% <100.00%> (+0.04%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@sonarqubecloud

Copy link
Copy Markdown

@usernane usernane merged commit d2d0a64 into dev Jun 14, 2026
16 checks passed
@usernane usernane deleted the feat/middleware-transitive-deps branch June 14, 2026 08:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant