ObjectStore links/updates

[aricart]

Overview

This issue documents some updates made to the Go client object store implementation to handle some conditions reasonably.

• update the meta of a deleted object should not be allowed by the client.
• updating the meta to point to an already existing name should not be allowed
• put should not allow setting the meta.link information - this is only supported via the link API
• getInfo should not return info for deleted objects. Optional methods can be added to support getting info on deleted objects.
• list should not return info for deleted objects. Optional methods can be added to support getting info on deleted objects.

ObjectStore ADR nats-io/nats.deno@6164d01

Clients and Tools

• Go @piotrpio
• Java @scottf
• JavaScript nats-io/nats.deno@d85bbf5, nats-io/nats.deno@6164d01
• .Net @scottf
• C @levb
• Python @wallyqs
• Ruby @wallyqs
• Rust @Jarema @caspervonb

Other Tasks

• docs.nats.io updated @jnmoyne
• Update ADR More clarity around GetInfo and List #158
• Update client features spreadsheet

Client authors please update with your progress. If you open issues in your own repositories as a result of this request, please link them to this one by pasting the issue URL in a comment or main issue description.

[scottf]

Object Store ADR-20 is here https://github.com/nats-io/nats-architecture-and-design/blob/main/adr/ADR-20.md

[scottf]

updating the meta to point to an already existing name should not be allowed

It's an error to update an object's name to an existing and not deleted object. You can update an objects name to an existing but deleted object.

[scottf]

put should not allow setting the meta.link information - this is only supported via the link API

The put method should check the incoming meta for a link and fail with error if it finds one.