Add `KeysWithFilter` methods to KV interface

[Jarema]

Proposed change

// KeysWithFilters returns a filtered list of keys in the bucket.
KeysWithFilters(filter []string) ([]string, error)


// And for the new, iterable API:
ListKeysWithFilters(filter []string) (KeyLister, error)

	// KeysWithFilters returns a filtered list of keys in the bucket.
	// Historically this method returned a complete slice of all keys in the bucket,
	// however clients should return interable result.
	// Languages can implement the list of filters in most idiomatic way - as an iterator, variadic argument, slice, etc.
	// When multiple filters are passed, client library should check `consumer info` from `consumer create method` if the filters are matching,
	// as nats-server < 2.10 would ignore them.
	KeysWithFilters(filter []string) ([]string, error)

We have two separate functions for single and multiple filters, as multiple filters requires server 2.10

reference ADR: https://github.com/nats-io/nats-architecture-and-design/blob/main/adr/ADR-8.md?plain=1#L139 reference ADR issue: https://github.com/nats-io/nats-architecture-and-design/issues/289

Use case

https://github.com/nats-io/nats-server/issues/5540

Contribution

No response

[ripienaar]

In the case of go at least, wouldnt a WatchOpt be better? These commands already take those.

[Darshan174]

Hey please checkout PR #1658, any suggestion would be helpful.

[aditya7302]

@Jarema is this issue still open. I would like to work on this. Please assign me this issue.

[somratdnutanix]

Hi @Jarema , worked on the Go one too, would love to have your comments. 😄