io.kurrentdb.protocol.v2.streams.errors

Enum StreamsError

java.lang.Object

java.lang.Enum<StreamsError>

io.kurrentdb.protocol.v2.streams.errors.StreamsError

All Implemented Interfaces:

com.google.protobuf.Internal.EnumLite, com.google.protobuf.ProtocolMessageEnum, java.io.Serializable, java.lang.Comparable<StreamsError>

public enum StreamsError
extends java.lang.Enum<StreamsError>
implements com.google.protobuf.ProtocolMessageEnum

 Error codes specific to the Streams API.
 These errors represent failure modes when working with streams of records.
 

Protobuf enum kurrentdb.protocol.v2.streams.errors.StreamsError

Enum Constant Summary

Enum Constants

Enum Constant and Description
STREAMS_ERROR_APPEND_RECORD_SIZE_EXCEEDED A single record being appended exceeds the maximum allowed size.
STREAMS_ERROR_APPEND_SESSION_NO_REQUESTS An append session was started but no append requests were sent before completing the stream.
STREAMS_ERROR_APPEND_TRANSACTION_SIZE_EXCEEDED The total size of all records in a single append session exceeds the maximum allowed transaction size.
STREAMS_ERROR_STREAM_ALREADY_EXISTS The stream already exists when an operation expected it not to exist.
STREAMS_ERROR_STREAM_ALREADY_IN_APPEND_SESSION The same stream appears multiple times in a single append session.
STREAMS_ERROR_STREAM_DELETED The stream has been soft deleted.
STREAMS_ERROR_STREAM_NOT_FOUND The requested stream does not exist in the database.
STREAMS_ERROR_STREAM_REVISION_CONFLICT The expected revision does not match the actual stream revision.
STREAMS_ERROR_STREAM_TOMBSTONED The stream has been tombstoned (permanently deleted).
STREAMS_ERROR_UNSPECIFIED Default value.
UNRECOGNIZED

Field Summary

Fields

Modifier and Type	Field and Description
static int	STREAMS_ERROR_APPEND_RECORD_SIZE_EXCEEDED_VALUE A single record being appended exceeds the maximum allowed size.
static int	STREAMS_ERROR_APPEND_SESSION_NO_REQUESTS_VALUE An append session was started but no append requests were sent before completing the stream.
static int	STREAMS_ERROR_APPEND_TRANSACTION_SIZE_EXCEEDED_VALUE The total size of all records in a single append session exceeds the maximum allowed transaction size.
static int	STREAMS_ERROR_STREAM_ALREADY_EXISTS_VALUE The stream already exists when an operation expected it not to exist.
static int	STREAMS_ERROR_STREAM_ALREADY_IN_APPEND_SESSION_VALUE The same stream appears multiple times in a single append session.
static int	STREAMS_ERROR_STREAM_DELETED_VALUE The stream has been soft deleted.
static int	STREAMS_ERROR_STREAM_NOT_FOUND_VALUE The requested stream does not exist in the database.
static int	STREAMS_ERROR_STREAM_REVISION_CONFLICT_VALUE The expected revision does not match the actual stream revision.
static int	STREAMS_ERROR_STREAM_TOMBSTONED_VALUE The stream has been tombstoned (permanently deleted).
static int	STREAMS_ERROR_UNSPECIFIED_VALUE Default value.

Method Summary

Modifier and Type	Method and Description
static StreamsError	forNumber(int value)
static com.google.protobuf.Descriptors.EnumDescriptor	getDescriptor()
com.google.protobuf.Descriptors.EnumDescriptor	getDescriptorForType()
int	getNumber()
com.google.protobuf.Descriptors.EnumValueDescriptor	getValueDescriptor()
static com.google.protobuf.Internal.EnumLiteMap<StreamsError>	internalGetValueMap()
static StreamsError	valueOf(com.google.protobuf.Descriptors.EnumValueDescriptor desc)
static StreamsError	valueOf(int value) Deprecated. Use forNumber(int) instead.
static StreamsError	valueOf(java.lang.String name) Returns the enum constant of this type with the specified name.
static StreamsError[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

STREAMS_ERROR_UNSPECIFIED

public static final StreamsError STREAMS_ERROR_UNSPECIFIED

 Default value. This value is not used.
 An error code MUST always be set to a non-zero value.
 If an error code is not explicitly set, it MUST be treated as
 an internal server error (INTERNAL).
 

STREAMS_ERROR_UNSPECIFIED = 0;

STREAMS_ERROR_STREAM_NOT_FOUND

public static final StreamsError STREAMS_ERROR_STREAM_NOT_FOUND

 The requested stream does not exist in the database.

 Common causes:
 - Stream name typo or incorrect stream identifier
 - Stream was never created (no events appended yet)
 - Stream was deleted and not yet recreated

 Client action: Verify the stream name is correct. Create the stream by appending to it.
 Recoverable by creating the stream first (append with NO_STREAM expected revision).
 

STREAMS_ERROR_STREAM_NOT_FOUND = 1 [(.kurrent.rpc.error) = { ... }

STREAMS_ERROR_STREAM_ALREADY_EXISTS

public static final StreamsError STREAMS_ERROR_STREAM_ALREADY_EXISTS

 The stream already exists when an operation expected it not to exist.

 Common causes:
 - Attempting to create a stream that already has events
 - Using NO_STREAM expected revision on an existing stream
 - Race condition with concurrent stream creation

 Client action: Use the existing stream or use a different expected revision.
 Recoverable by adjusting the expected revision or using the existing stream.
 

STREAMS_ERROR_STREAM_ALREADY_EXISTS = 2 [(.kurrent.rpc.error) = { ... }

STREAMS_ERROR_STREAM_DELETED

public static final StreamsError STREAMS_ERROR_STREAM_DELETED

 The stream has been soft deleted.
 Soft-deleted streams are hidden from stream lists but can be restored by appending to them.

 Common causes:
 - Stream was explicitly soft-deleted via delete operation
 - Attempting to read from a soft-deleted stream

 Client action: Restore the stream by appending new events, or accept that the stream is deleted.
 Recoverable by appending to the stream to restore it.
 

STREAMS_ERROR_STREAM_DELETED = 3 [(.kurrent.rpc.error) = { ... }

STREAMS_ERROR_STREAM_TOMBSTONED

public static final StreamsError STREAMS_ERROR_STREAM_TOMBSTONED

 The stream has been tombstoned (permanently deleted).
 Tombstoned streams cannot be restored and will never accept new events.

 Common causes:
 - Stream was explicitly tombstoned via tombstone operation
 - Administrative deletion of sensitive data
 - Attempting to write to or read from a tombstoned stream

 Client action: Stream is permanently removed. Create a new stream with a different name if needed.
 Not recoverable - the stream cannot be restored.
 

STREAMS_ERROR_STREAM_TOMBSTONED = 4 [(.kurrent.rpc.error) = { ... }

STREAMS_ERROR_STREAM_REVISION_CONFLICT

public static final StreamsError STREAMS_ERROR_STREAM_REVISION_CONFLICT

 The expected revision does not match the actual stream revision.
 This is an optimistic concurrency control failure.

 Common causes:
 - Another client modified the stream concurrently
 - Client has stale state about the stream revision
 - Race condition in distributed system

 Client action: Fetch the current stream revision and retry with the correct expected revision.
 Recoverable by reading the current state and retrying with proper optimistic concurrency control.
 

STREAMS_ERROR_STREAM_REVISION_CONFLICT = 5 [(.kurrent.rpc.error) = { ... }

STREAMS_ERROR_APPEND_RECORD_SIZE_EXCEEDED

public static final StreamsError STREAMS_ERROR_APPEND_RECORD_SIZE_EXCEEDED

 A single record being appended exceeds the maximum allowed size.

 Common causes:
 - Record payload is too large (exceeds server's max record size configuration)
 - Excessive metadata in properties
 - Large binary data without chunking

 Client action: Reduce record size, split large payloads across multiple records, or increase server limits.
 Recoverable by reducing record size or adjusting server configuration.
 

STREAMS_ERROR_APPEND_RECORD_SIZE_EXCEEDED = 6 [(.kurrent.rpc.error) = { ... }

STREAMS_ERROR_APPEND_TRANSACTION_SIZE_EXCEEDED

public static final StreamsError STREAMS_ERROR_APPEND_TRANSACTION_SIZE_EXCEEDED

 The total size of all records in a single append session exceeds the maximum allowed transaction size.

 Common causes:
 - Too many records in a single append session
 - Combined payload size exceeds server's max transaction size
 - Attempting to write very large batches

 Client action: Split the append into multiple smaller transactions.
 Recoverable by reducing the number of records per append session.
 

STREAMS_ERROR_APPEND_TRANSACTION_SIZE_EXCEEDED = 7 [(.kurrent.rpc.error) = { ... }

STREAMS_ERROR_STREAM_ALREADY_IN_APPEND_SESSION

public static final StreamsError STREAMS_ERROR_STREAM_ALREADY_IN_APPEND_SESSION

 The same stream appears multiple times in a single append session.
 This is currently not supported to prevent complexity with expected revisions and ordering.

 Common causes:
 - Accidentally appending to the same stream twice in one session
 - Application logic error in batch operations

 Client action: Remove duplicate streams from the append session or split into multiple sessions.
 Recoverable by restructuring the append session to reference each stream only once.
 

STREAMS_ERROR_STREAM_ALREADY_IN_APPEND_SESSION = 8 [(.kurrent.rpc.error) = { ... }

STREAMS_ERROR_APPEND_SESSION_NO_REQUESTS

public static final StreamsError STREAMS_ERROR_APPEND_SESSION_NO_REQUESTS

 An append session was started but no append requests were sent before completing the stream.

 Common causes:
 - Client completed the stream without sending any AppendRequest messages
 - Application logic error

 Client action: Ensure at least one AppendRequest is sent before completing the stream.
 Recoverable by properly implementing the append session protocol.
 

STREAMS_ERROR_APPEND_SESSION_NO_REQUESTS = 9 [(.kurrent.rpc.error) = { ... }

UNRECOGNIZED

public static final StreamsError UNRECOGNIZED

Field Detail

STREAMS_ERROR_UNSPECIFIED_VALUE

public static final int STREAMS_ERROR_UNSPECIFIED_VALUE

 Default value. This value is not used.
 An error code MUST always be set to a non-zero value.
 If an error code is not explicitly set, it MUST be treated as
 an internal server error (INTERNAL).
 

STREAMS_ERROR_UNSPECIFIED = 0;

See Also:

Constant Field Values

STREAMS_ERROR_STREAM_NOT_FOUND_VALUE

public static final int STREAMS_ERROR_STREAM_NOT_FOUND_VALUE

 The requested stream does not exist in the database.

 Common causes:
 - Stream name typo or incorrect stream identifier
 - Stream was never created (no events appended yet)
 - Stream was deleted and not yet recreated

 Client action: Verify the stream name is correct. Create the stream by appending to it.
 Recoverable by creating the stream first (append with NO_STREAM expected revision).
 

STREAMS_ERROR_STREAM_NOT_FOUND = 1 [(.kurrent.rpc.error) = { ... }

See Also:

Constant Field Values

STREAMS_ERROR_STREAM_ALREADY_EXISTS_VALUE

public static final int STREAMS_ERROR_STREAM_ALREADY_EXISTS_VALUE

 The stream already exists when an operation expected it not to exist.

 Common causes:
 - Attempting to create a stream that already has events
 - Using NO_STREAM expected revision on an existing stream
 - Race condition with concurrent stream creation

 Client action: Use the existing stream or use a different expected revision.
 Recoverable by adjusting the expected revision or using the existing stream.
 

STREAMS_ERROR_STREAM_ALREADY_EXISTS = 2 [(.kurrent.rpc.error) = { ... }

See Also:

Constant Field Values

STREAMS_ERROR_STREAM_DELETED_VALUE

public static final int STREAMS_ERROR_STREAM_DELETED_VALUE

 The stream has been soft deleted.
 Soft-deleted streams are hidden from stream lists but can be restored by appending to them.

 Common causes:
 - Stream was explicitly soft-deleted via delete operation
 - Attempting to read from a soft-deleted stream

 Client action: Restore the stream by appending new events, or accept that the stream is deleted.
 Recoverable by appending to the stream to restore it.
 

STREAMS_ERROR_STREAM_DELETED = 3 [(.kurrent.rpc.error) = { ... }

See Also:

Constant Field Values

STREAMS_ERROR_STREAM_TOMBSTONED_VALUE

public static final int STREAMS_ERROR_STREAM_TOMBSTONED_VALUE

 The stream has been tombstoned (permanently deleted).
 Tombstoned streams cannot be restored and will never accept new events.

 Common causes:
 - Stream was explicitly tombstoned via tombstone operation
 - Administrative deletion of sensitive data
 - Attempting to write to or read from a tombstoned stream

 Client action: Stream is permanently removed. Create a new stream with a different name if needed.
 Not recoverable - the stream cannot be restored.
 

STREAMS_ERROR_STREAM_TOMBSTONED = 4 [(.kurrent.rpc.error) = { ... }

See Also:

Constant Field Values

STREAMS_ERROR_STREAM_REVISION_CONFLICT_VALUE

public static final int STREAMS_ERROR_STREAM_REVISION_CONFLICT_VALUE

 The expected revision does not match the actual stream revision.
 This is an optimistic concurrency control failure.

 Common causes:
 - Another client modified the stream concurrently
 - Client has stale state about the stream revision
 - Race condition in distributed system

 Client action: Fetch the current stream revision and retry with the correct expected revision.
 Recoverable by reading the current state and retrying with proper optimistic concurrency control.
 

STREAMS_ERROR_STREAM_REVISION_CONFLICT = 5 [(.kurrent.rpc.error) = { ... }

See Also:

Constant Field Values

STREAMS_ERROR_APPEND_RECORD_SIZE_EXCEEDED_VALUE

public static final int STREAMS_ERROR_APPEND_RECORD_SIZE_EXCEEDED_VALUE

 A single record being appended exceeds the maximum allowed size.

 Common causes:
 - Record payload is too large (exceeds server's max record size configuration)
 - Excessive metadata in properties
 - Large binary data without chunking

 Client action: Reduce record size, split large payloads across multiple records, or increase server limits.
 Recoverable by reducing record size or adjusting server configuration.
 

STREAMS_ERROR_APPEND_RECORD_SIZE_EXCEEDED = 6 [(.kurrent.rpc.error) = { ... }

See Also:

Constant Field Values

STREAMS_ERROR_APPEND_TRANSACTION_SIZE_EXCEEDED_VALUE

public static final int STREAMS_ERROR_APPEND_TRANSACTION_SIZE_EXCEEDED_VALUE

 The total size of all records in a single append session exceeds the maximum allowed transaction size.

 Common causes:
 - Too many records in a single append session
 - Combined payload size exceeds server's max transaction size
 - Attempting to write very large batches

 Client action: Split the append into multiple smaller transactions.
 Recoverable by reducing the number of records per append session.
 

STREAMS_ERROR_APPEND_TRANSACTION_SIZE_EXCEEDED = 7 [(.kurrent.rpc.error) = { ... }

See Also:

Constant Field Values

STREAMS_ERROR_STREAM_ALREADY_IN_APPEND_SESSION_VALUE

public static final int STREAMS_ERROR_STREAM_ALREADY_IN_APPEND_SESSION_VALUE

 The same stream appears multiple times in a single append session.
 This is currently not supported to prevent complexity with expected revisions and ordering.

 Common causes:
 - Accidentally appending to the same stream twice in one session
 - Application logic error in batch operations

 Client action: Remove duplicate streams from the append session or split into multiple sessions.
 Recoverable by restructuring the append session to reference each stream only once.
 

STREAMS_ERROR_STREAM_ALREADY_IN_APPEND_SESSION = 8 [(.kurrent.rpc.error) = { ... }

See Also:

Constant Field Values

STREAMS_ERROR_APPEND_SESSION_NO_REQUESTS_VALUE

public static final int STREAMS_ERROR_APPEND_SESSION_NO_REQUESTS_VALUE

 An append session was started but no append requests were sent before completing the stream.

 Common causes:
 - Client completed the stream without sending any AppendRequest messages
 - Application logic error

 Client action: Ensure at least one AppendRequest is sent before completing the stream.
 Recoverable by properly implementing the append session protocol.
 

STREAMS_ERROR_APPEND_SESSION_NO_REQUESTS = 9 [(.kurrent.rpc.error) = { ... }

See Also:

Constant Field Values

Method Detail

values

public static StreamsError[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (StreamsError c : StreamsError.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static StreamsError valueOf(java.lang.String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

java.lang.IllegalArgumentException - if this enum type has no constant with the specified name

java.lang.NullPointerException - if the argument is null

getNumber

public final int getNumber()

Specified by:

getNumber in interface com.google.protobuf.Internal.EnumLite

Specified by:

getNumber in interface com.google.protobuf.ProtocolMessageEnum

valueOf

@Deprecated
public static StreamsError valueOf(int value)

Deprecated. Use forNumber(int) instead.

Parameters:

value - The numeric wire value of the corresponding enum entry.

Returns:

The enum associated with the given numeric wire value.

forNumber

public static StreamsError forNumber(int value)

Parameters:

value - The numeric wire value of the corresponding enum entry.

Returns:

The enum associated with the given numeric wire value.

internalGetValueMap

public static com.google.protobuf.Internal.EnumLiteMap<StreamsError> internalGetValueMap()

getValueDescriptor

public final com.google.protobuf.Descriptors.EnumValueDescriptor getValueDescriptor()

Specified by:

getValueDescriptor in interface com.google.protobuf.ProtocolMessageEnum

getDescriptorForType

public final com.google.protobuf.Descriptors.EnumDescriptor getDescriptorForType()

Specified by:

getDescriptorForType in interface com.google.protobuf.ProtocolMessageEnum

getDescriptor

public static final com.google.protobuf.Descriptors.EnumDescriptor getDescriptor()

valueOf

public static StreamsError valueOf(com.google.protobuf.Descriptors.EnumValueDescriptor desc)