@spine-event-engine/proto 2.0.0-snapshot.2

package/proto/spine/server/integration/broker.proto

@@ -0,0 +1,112 @@
+/*
+ * Copyright 2026, TeamDev. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Redistribution and use in source and/or binary forms, with or without
+ * modification, must retain the above copyright notice and the following
+ * disclaimer.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+ * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+ * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+ * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+ * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+
+syntax = "proto3";
+
+package spine.server.integration;
+
+import "spine/options.proto";
+
+option (type_url_prefix) = "type.spine.io";
+option java_package = "io.spine.server.integration";
+option java_multiple_files = true;
+option java_outer_classname = "BrokerProto";
+
+import "google/protobuf/any.proto";
+
+import "spine/core/actor_context.proto";
+import "spine/core/bounded_context.proto";
+
+// A wrapper around a message, which is used to send/receive the original message
+// to/from external application components, such as other Bounded Contexts.
+message ExternalMessage {
+
+    // An ID of the original message wrapped into `Any` (e.g. an event ID).
+    google.protobuf.Any id = 1 [(required) = true];
+
+    // An original message wrapped into `Any` (e.g. a wrapped instance of `io.spine.core.Event`).
+    google.protobuf.Any original_message = 2 [(required) = true];
+
+    // `actor_context` field has been deleted, as it is impossible to populate
+    // it with meaningful values for all types of transmitted external messages.
+    //
+    reserved 3;
+    reserved "actor_context";
+
+    // Name of the Bounded Context, within which an original message was created.
+    spine.core.BoundedContextName bounded_context_name = 4 [(required) = true];
+}
+
+// A document message, describing types of events
+// that are required for consumption by some part of the system.
+//
+// One of the typical scenarios is a notification shout-out from the current Bounded Context
+// to other Bounded Contexts of the application about its `external` subscription needs.
+//
+message ExternalEventsWanted {
+
+    // Multiple types may be requested at a time.
+    repeated ExternalEventType type = 1;
+}
+
+// The type of a domain event that is emitted by one Bounded Context and consumed by
+// other Bounded Contexts as "external" event
+message ExternalEventType {
+    option (is).java_type = "ExternalEventTypeMixin";
+
+    // Type URL of the domain event (e.g. `io.spine.examples.TaskCreated`).
+    string type_url = 1 [(required) = true];
+}
+
+// The type of error that may occur during the `ExternalMessage` validation.
+enum ExternalMessageValidationError {
+
+    // Reserved value.
+    EM_UNKNOWN_REASON = 0;
+
+    // The external message type is not supported by the server.
+    UNSUPPORTED_EXTERNAL_MESSAGE = 1;
+}
+
+// Tells that some Bounded Context is connected to the shared transport.
+//
+// Used to notify other parties connected to the same transport that the external events they
+// might need may be provided by the Bounded Context that is online.
+//
+// Typically, once others receive this message, they might want to send their
+// respective `ExternalEventsWanted` messages to see if the connected Bounded Context
+// is able to provide them.
+//
+// Please note this message does not signify that some context has _just_ connected
+// to the transport. It may be sent by some context that has been using the shared transport
+// for quite some time — in which case this message may serve to notify just-connected Bounded
+// Contexts of its existence.
+//
+message BoundedContextOnline {
+
+    // The name of the Bounded Context that is connected to the transport.
+    spine.core.BoundedContextName context = 1 [(required) = true];
+}

package/proto/spine/server/server_environment.proto

@@ -0,0 +1,57 @@
+/*
+ * Copyright 2022, TeamDev. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Redistribution and use in source and/or binary forms, with or without
+ * modification, must retain the above copyright notice and the following
+ * disclaimer.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+ * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+ * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+ * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+ * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+syntax = "proto3";
+
+package spine.server;
+
+import "spine/options.proto";
+
+option (type_url_prefix) = "type.spine.io";
+option java_package = "io.spine.server";
+option java_outer_classname = "ServerEnvironmentProto";
+option java_multiple_files = true;
+
+// A type of the environment system is deployed to.
+enum DeploymentType {
+
+    // Running in a standalone mode.
+    //
+    // The deployment is considered STANDALONE when no specific runtime is recognized. 
+    //
+    STANDALONE = 0;
+
+    // Running on an App Engine local development server.
+    APPENGINE_EMULATOR = 1;
+
+    // Running on an App Engine cloud infrastructure.
+    APPENGINE_CLOUD = 2;
+}
+
+// An identifier of a server node of the application.
+message NodeId {
+
+    string value = 1 [(required) = true];
+}

package/proto/spine/server/transport/transport.proto

@@ -0,0 +1,42 @@
+/*
+ * Copyright 2022, TeamDev. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Redistribution and use in source and/or binary forms, with or without
+ * modification, must retain the above copyright notice and the following
+ * disclaimer.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+ * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+ * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+ * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+ * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+syntax = "proto3";
+
+package spine.server.transport;
+
+import "spine/options.proto";
+
+option (type_url_prefix) = "type.spine.io";
+option java_package = "io.spine.server.transport";
+option java_outer_classname = "TransportProto";
+option java_multiple_files = true;
+
+// Identifier of a transport channel.
+message ChannelId {
+
+    // The type URL of the messages transmitted through the channel.
+    string target_type = 1;
+}

package/proto/spine/string/template_string.proto

@@ -0,0 +1,70 @@
+/*
+ * Copyright 2026, TeamDev. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Redistribution and use in source and/or binary forms, with or without
+ * modification, must retain the above copyright notice and the following
+ * disclaimer.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+ * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+ * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+ * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+ * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+syntax = "proto3";
+
+package spine.string;
+
+import "spine/options.proto";
+
+option (type_url_prefix) = "type.spine.io";
+option java_multiple_files = true;
+option java_outer_classname = "TemplateStringProto";
+option java_package = "io.spine.string";
+
+// Represents a template string with placeholders and a map for further substituting
+// those placeholders with the actual values.
+//
+// Placeholders are specified using the format `${key}`, where `key` is the identifier
+// for the value to be substituted from the `placeholder_value` map. There are no
+// expectations about the identifier format. It can be `myKey`, `my.key`, `my_key`, etc.
+//
+// Example usage:
+//     template_string = "My dog's name is ${dog.name}."
+//     placeholder_values = { "dog.name": "Fido" }
+//
+// After substitution, the final output would be:
+//     "My dog's name is Fido."
+//
+// Each placeholder `key` referenced in the template string must have a corresponding entry
+// in the `placeholder_value` map. However, the `placeholder_value` map is not restricted to
+// containing only the placeholders used in the template. Additional entries in the map
+// that do not correspond to placeholders in the template string are permitted.
+//
+message TemplateString {
+
+    // The template string that may contain one or more placeholders.
+    string with_placeholders = 1;
+
+    // A map that provides values for placeholders referenced in `with_placeholders`.
+    //
+    // The keys in this map should match the placeholder keys inside `with_placeholders`
+    // excluding the `${}` placeholder markers.
+    //
+    // All placeholders present in `with_placeholders` must have corresponding entries
+    // in this map. Otherwise, the template is considered invalid.
+    //
+    map<string, string> placeholder_value = 2;
+}

package/proto/spine/system/server/entity_log_events.proto

@@ -0,0 +1,280 @@
+/*
+ * Copyright 2026, TeamDev. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Redistribution and use in source and/or binary forms, with or without
+ * modification, must retain the above copyright notice and the following
+ * disclaimer.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+ * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+ * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+ * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+ * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+
+syntax = "proto3";
+
+package spine.system.server;
+
+import "spine/options.proto";
+
+option (type_url_prefix) = "type.spine.io";
+option (internal_all) = true;
+
+option java_package = "io.spine.system.server.event";
+option java_outer_classname = "EntityLogEventsProto";
+option java_multiple_files = true;
+
+import "google/protobuf/any.proto";
+import "google/protobuf/timestamp.proto";
+
+import "spine/core/diagnostics.proto";
+import "spine/core/command.proto";
+import "spine/core/event.proto";
+import "spine/core/version.proto";
+import "spine/system/server/entity_type.proto";
+
+// An entity was created.
+message EntityCreated {
+
+    // The ID of the entity.
+    core.MessageId entity = 1 [(required) = true];
+
+    // The kind of the entity.
+    EntityOption.Kind kind = 2 [(required) = true];
+}
+
+// An event is dispatched to a subscriber.
+//
+// This event is relevant only to histories of Projections.
+//
+message EventDispatchedToSubscriber {
+    option (is).java_type = "EventDispatchedMixin";
+
+    // The ID of the entity, which the event is dispatched to.
+    core.MessageId receiver = 1 [(required) = true];
+
+    // The dispatched event.
+    core.Event payload = 2 [(validate) = true];
+
+    // The time when the event was dispatched.
+    //
+    // This timestamp may differ from the one in the context of the event, since the time of
+    // dispatching may not be the same as the time of creation.
+    //
+    google.protobuf.Timestamp when_dispatched = 3 [(required) = true];
+
+    // The fully qualified name of the subscribing entity.
+    EntityTypeName entity_type = 4 [(required) = true];
+}
+
+// An event was dispatched to a reactor.
+//
+// This event is relevant to histories of Aggregates and ProcessManagers.
+//
+message EventDispatchedToReactor {
+    option (is).java_type = "EventDispatchedMixin";
+
+    // The ID of the entity, which the event is dispatched to.
+    core.MessageId receiver = 1 [(required) = true];
+
+    // The dispatched event.
+    core.Event payload = 2 [(validate) = true];
+
+    // The time when the event was dispatched.
+    //
+    // This timestamp may differ from the one in the context of the event, since the time of
+    // dispatching may not be the same as the time of creation.
+    //
+    google.protobuf.Timestamp when_dispatched = 3 [(required) = true];
+
+    // The fully qualified name of the reacting entity.
+    EntityTypeName entity_type = 4 [(required) = true];
+}
+
+// A command was dispatched to a command handler.
+//
+// This event is relevant only to histories of Aggregates and ProcessManagers.
+//
+message CommandDispatchedToHandler {
+    option (is).java_type = "CommandDispatchedMixin";
+
+    // The ID of the entity, which the command is dispatched to.
+    core.MessageId receiver = 1 [(required) = true];
+
+    // The dispatched command.
+    core.Command payload = 2 [(validate) = true];
+
+    // The time when the command was dispatched.
+    //
+    // This timestamp may differ from the one in the context of the event, since the time of
+    // dispatching may not be the same as the time of creation.
+    //
+    google.protobuf.Timestamp when_dispatched = 3 [(required) = true];
+
+    // The fully qualified name of the handling entity.
+    EntityTypeName entity_type = 4 [(required) = true];
+}
+
+// Retained for wire compatibility; no longer emitted.
+//
+// Formerly emitted when an event was imported into an aggregate. Event import was removed
+// during the event-sourcing cutover.
+//
+message EventImported {
+    option (is).java_type = "EventDispatchedMixin";
+
+    // The ID of the aggregate, which imported the event.
+    core.MessageId receiver = 1 [(required) = true];
+
+    // The dispatched event.
+    core.Event payload = 2 [(validate) = true];
+
+    // The time when the event was imported.
+    google.protobuf.Timestamp when_imported = 3 [(required) = true];
+
+    // The fully qualified name of the receiver aggregate.
+    EntityTypeName entity_type = 4 [(required) = true];
+}
+
+// A state of an entity has changed.
+//
+// The event transfers both "old" and "new" states of the entity to allow the further
+// distinction for the subscribers.
+//
+message EntityStateChanged {
+    option (is).java_type = "EntityLifecycleEvent";
+
+    // The ID of the entity.
+    core.MessageId entity = 1 [(required) = true];
+
+    // The old state of the entity.
+    //
+    // May be empty if the entity has just been created.
+    //
+    google.protobuf.Any old_state = 6;
+
+    // The new state of the entity.
+    google.protobuf.Any new_state = 2 [(required) = true];
+
+    // The IDs of the signals that caused the mutation.
+    repeated core.MessageId signal_id = 3 [(required) = true, (validate) = true];
+
+    // The instant when the entity was changed.
+    google.protobuf.Timestamp when = 4;
+
+    // The new version of the entity.
+    core.Version new_version = 5;
+}
+
+// An entity was marked as archived.
+message EntityArchived {
+    option (is).java_type = "EntityLifecycleEvent";
+
+    // The ID of the entity.
+    core.MessageId entity = 1 [(required) = true];
+
+    // The IDs of the signals that caused the mutation.
+    repeated core.MessageId signal_id = 2 [(required) = true, (validate) = true];
+
+    // The instant when the entity was archived.
+    google.protobuf.Timestamp when = 3;
+
+    // The version received by the entity upon archiving.
+    core.Version version = 4;
+
+    // The last known state of the entity.
+    google.protobuf.Any last_state = 5;
+}
+
+// An entity was either marked as deleted or had its record physically removed from the storage.
+message EntityDeleted {
+    option (is).java_type = "EntityLifecycleEvent";
+
+    // The ID of the entity.
+    core.MessageId entity = 1 [(required) = true];
+
+    // The IDs of the signals that caused the mutation.
+    repeated core.MessageId signal_id = 2 [(required) = true, (validate) = true];
+
+    // The instant when the entity was deleted.
+    google.protobuf.Timestamp when = 3;
+
+    // The version received by the entity upon deletion.
+    core.Version version = 4;
+
+    oneof deletion {
+
+        // The entity was marked as deleted.
+        bool marked_as_deleted = 5;
+
+        // The entity record was physically removed from the storage.
+        bool removed_from_storage = 6;
+    }
+
+    // The last known state of the entity.
+    google.protobuf.Any last_state = 7;
+}
+
+// An entity was marked as NOT archived.
+message EntityUnarchived {
+    option (is).java_type = "EntityLifecycleEvent";
+
+    // The ID of the entity.
+    core.MessageId entity = 1 [(required) = true];
+
+    // The IDs of the signals that caused the mutation.
+    repeated core.MessageId signal_id = 2 [(required) = true, (validate) = true];
+
+    // The instant when the entity was unarchived.
+    google.protobuf.Timestamp when = 3;
+
+    // The version received by the entity upon unarchiving.
+    core.Version version = 4;
+
+    // The state of the entity after marking it as non-archived.
+    google.protobuf.Any state = 5;
+}
+
+// An entity was marked as NOT deleted.
+message EntityRestored {
+    option (is).java_type = "EntityLifecycleEvent";
+
+    // The ID of the entity.
+    core.MessageId entity = 1 [(required) = true];
+
+    // The IDs of the signals that caused the mutation.
+    repeated core.MessageId signal_id = 2 [(required) = true, (validate) = true];
+
+    // The instant when the entity was restored.
+    google.protobuf.Timestamp when = 3;
+
+    // The version received by the entity upon restoration.
+    core.Version version = 4;
+
+    // The state of the entity after restoration.
+    google.protobuf.Any state = 5;
+}
+
+// A migration operation was applied to an entity.
+message MigrationApplied {
+    option (is).java_type = "EntityLifecycleEvent";
+
+    // The ID of the entity.
+    core.MessageId entity = 1 [(required) = true];
+
+    // The instant when the migration was applied.
+    google.protobuf.Timestamp when = 2;
+}

package/proto/spine/system/server/entity_type.proto

@@ -0,0 +1,49 @@
+/*
+ * Copyright 2022, TeamDev. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Redistribution and use in source and/or binary forms, with or without
+ * modification, must retain the above copyright notice and the following
+ * disclaimer.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+ * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+ * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+ * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+ * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+syntax = "proto3";
+
+package spine.system.server;
+
+import "spine/options.proto";
+
+option (type_url_prefix) = "type.spine.io";
+option java_package = "io.spine.system.server";
+option java_outer_classname = "EntityTypeProto";
+option java_multiple_files = true;
+
+// Fully qualified name of an entity type.
+//
+// Unlike a type URL of the entity state, an `EntityTypeName` represents the name of the entity
+// class in the implementation language, such as Java.
+//
+message EntityTypeName {
+
+    oneof impl {
+
+        // The canonical name of the Java entity class.
+        string java_class_name = 1;
+    }
+}