[FEATURE] Extension Methods and Models to interact with streams

[jrbentzon]

Description

When interacting with streams, we set annotations. To to this extensively from external services we need to load the kubernetes objects, interpret them and annotate them. It would be helpful to have framework methods to aid this process.

Possible solution

Extension methods / service to manipulate Arcane based kubernetes resources.

E.g.:,

cluster.GetStreamDefinition(myNamespace, myStreamKind, myApiVersion)
  .Annotate(ArcaneStatus.RELOAD_REQUESTED);

or

cluster.GetStreamDefinition(myNamespace, myStreamKind, myApiVersion)
  .RequestReload()

Alternatives

Move IStreamDefinition & StreamDefinition to Arcane.Framework

Context

We'd like add features for our clients to request restarts / reloads / etc to streams from UI and need to implement a bridge-service to handle interaction between Customer Backend and Arcane

[s-vitaliy]

We should create a separate package with name like Arcane.Client, Arcane.Facade or so and create required models/functions there. Moving IStreamDefinition & StreamDefinition to Arcane.Framework could potentially cause confusion between the StreamDefinition and StreamContext classes, which I would prefer to avoid.