Link existing events to another stream

[slashdotdash]

Link one or more existing events to another stream.

Event linking allows you to include events in multiple streams, such as copying an event from one stream to another, but only a reference to the original event is stored.

An event may be present in a stream only once, but may be linked into as many streams as required.

Linked events are used to build the $all stream containing every persisted event, globally ordered.

Use each recorded event's event_number field for the position of the event within the read/received stream. The stream_uuid and stream_version fields refer to the event's original stream.

Example usage

Read source events:

{:ok, events} = EventStore.read_stream_forward(source_stream_uuid)

Link events to another stream:

:ok = EventStore.link_to_stream(target_stream_uuid, 0, events)