Feature/debug function

[jankapunkt]

Implements #906 by allowing debug to be a boolean or function type.

• if boolean is passed, logging is either off or done to console (non-breaking default)
• if a function is passed, logging is done into this function
• function arguments are ...args as in the original logging

[jankapunkt]

@dr-dimitru I think there should be one or two additional tests to make sure this is not breaking. What do you think?

[Copilot]

Pull request overview

This PR implements feature request #906 by extending the debug configuration parameter to accept either a boolean or a function type. When a function is provided, all debug logging is routed to that custom function instead of the console, allowing developers to integrate with their own logging systems.

Key Changes

• Modified _debug() method in core.js to check if debug is a function and use it accordingly
• Updated validation logic in server.js and client.js to accept both boolean and function types
• Updated JSDoc comments and documentation to reflect the new function parameter option

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 3 comments.

File	Description
core.js	Modified _debug() method to conditionally use custom debug function when provided, falling back to console logging when debug === true
server.js	Updated validation to accept function type for debug parameter and updated JSDoc documentation
client.js	Updated validation to accept function type for debug parameter and updated JSDoc documentation
docs/constructor.md	Updated documentation table to reflect that debug accepts Boolean or Function type

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[dr-dimitru]

lgtm