docs(ip-restriction): add clear JSDoc examples and param types (#4851)

Adds a comprehensive @example block and fully documents the @param and @returns tags for the  middleware to help developers understand its capabilities regarding allowList/denyList out of the box.