added prioritization intercepter

[amyssnippet]

This relates to...

closes / fixes #4766

Rationale

Changes

added priority interceptor with:

• PriorityQueue — a simple sorted queue with configurable concurrency that dispatches higher-priority requests first
• PriorityHandler — extends DecoratorHandler, releases the queue slot on response end or error
• createPriorityInterceptor({ concurrency }) — factory function matching undici's interceptor pattern
• Requests without opts.priority or without opts.origin bypass the queue entirely
• Per-origin queues so different origins are scheduled independently

Features

this can be used like the foll code:

const { Client, interceptors } = require('undici')
const client = new Client('http://example.com')
  .compose(interceptors.priority({ concurrency: 1 }))

await client.request({ method: 'GET', path: '/', priority: 10 }) // higher = sooner

Bug Fixes

n/a

Breaking Changes and Deprecations

NA

Status

added tests

• I have read and agreed to the Developer's Certificate of Origin
• Tested
• Benchmarked (optional)
• Documented
• Review ready
• In review
• Merge ready

[amyssnippet]

@mcollina or @ronag should i document this one?? and yes then can i get some guide?

[codecov-commenter]

Codecov Report

❌ Patch coverage is 94.78261% with 6 lines in your changes missing coverage. Please review.
✅ Project coverage is 92.90%. Comparing base (07276c9) to head (c1e00c6).
⚠️ Report is 12 commits behind head on main.

Files with missing lines	Patch %	Lines
lib/interceptor/priority.js	94.69%	6 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #4878      +/-   ##
==========================================
- Coverage   93.02%   92.90%   -0.13%     
==========================================
  Files         112      113       +1     
  Lines       35287    35779     +492     
==========================================
+ Hits        32827    33239     +412     
- Misses       2460     2540      +80     

☔ View full report in Codecov by Sentry.
📢 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.

[metcoder95]

Please add TS types and documentation for it

[amyssnippet]

@metcoder95 what about the documentation??

[metcoder95]

can you add documentation for the new interceptor?

[amyssnippet]

i added ts types and documentation along with limiting the priorities with

const PRIORITIES = {
  HIGHEST: 4,
  HIGH: 3,
  MEDIUM: 2,
  LOW: 1,
  LOWEST: 0
}

[amyssnippet]

the test ci failure is likely a timeout or connection issue on the ci runner

[metcoder95]

did you push your changes? Current state of the PR hints otherwise

[amyssnippet]

@metcoder95 actually i forgot to push the changes, as i was amending them to the previous commit, completely my fault. now you can review the changes, i pushed them now perfectly