processUrlSearchParams callback not called with method: 'debounce'

[joschka-w]

Context

What's your version of nuqs?

"nuqs": "^2.8.2",

What framework are you using?

• ✅ Next.js (app router)
• ❌ Next.js (pages router)
• ✅ React SPA (no router)
• ❌ Remix
• ❌ React Router
• ❌ Other (please specify)

Which version of your framework are you using?

next: 16.0.7,
react: 19.0.0,
react-dom: 19.0.0

Description

There's an issue with the processUrlSearchParams callback when using the debounce update method on the NuqsAdapter.

When method: 'debounce' is set, the processUrlSearchParams callback is not executed. The callback works correctly with method: 'throttle'.

This issue occurs in both next.js 16.0.7 (app router) and react SPA environments.

Reproduction

Steps to reproduce the behavior:

1. Go to https://codesandbox.io/p/sandbox/nuqs-testing-pt7hp8
2. Click the "Update query state" button to trigger a state update
3. The processUrlSearchParams callback in index.js does not fire
4. Change the method in limitUrlUpdates from 'debounce' to 'throttle' by clicking the other button
5. The processUrlSearchParams callback should execute correctly now

[franky47]

Thanks, I can reproduce locally and I think I see where the issue is: the processUrlSearchParams callback is indeed not passed through the debounce queue to the throttle queue where it's applied.

I didn't manage to get a quick fix to solve the issue in your repro, I'll have a proper look and add some tests tomorrow.

[franky47]

Could you try the following preview build please? It solves the issue in your repro (patching the built package in node_modules must have been cached somehow). See PR #1250.

pnpm add https://pkg.pr.new/nuqs@1250

[joschka-w]

Thanks for the quick response, I've tested with the preview build and can confirm it fixes the issue 👍

[github-actions]

🎉 This issue has been resolved in version 2.8.3 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀