fix: apply stricter typing to the v* signatures

[robbtraister]

The v4 function is guaranteed to return a string unless the buf argument is provided. By modifying the signature to denote this parameter as required for the Uint8Array case, we get the benefit of a stricter return type of string when simply calling v4().

[broofa]

Nice! Thanks for the contribution.

Can you do me a favor and update the other methods that take an optional buf argument as well? (v1.ts, v3.ts, v5.ts, and v7.ts)

Edit: ... and v6.ts, too. So basically "all the thingz!"

[broofa]

@robbtraister Thanks for the update. This looks good.

FYI, I added this commit after realizing the overload types for v3 and v5 aren't really necessary. (Right? If I got that wrong, please let me know.)

[robbtraister]

@robbtraister Thanks for the update. This looks good.

FYI, I added this commit after realizing the overload types for v3 and v5 aren't really necessary. (Right? If I got that wrong, please let me know.)

Calling v3("value", "namespace") should always return string, but removing the overloads types it as string | Uint8Array.

Having said that, I only ever use v4, so 🤷

[broofa]

Calling v3("value", "namespace") should always return string, but removing the overloads types it as string | Uint8Array.

Ah, right... thanks for catching that!