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

package/generated/spine/validation/validation_error_pb.ts

@@ -0,0 +1,181 @@
+/*
+ * Generated by Spine TypeScript. Do not edit manually.
+ * Source Proto: spine/validation/validation_error.proto
+ */
+
+
+
+// @generated by protoc-gen-es v2.12.1 with parameter "target=ts,import_extension=js"
+// @generated from file spine/validation/validation_error.proto (package spine.validation, syntax proto3)
+/* eslint-disable */
+
+import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
+import { fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv2";
+import { file_spine_options } from "../options_pb.js";
+import type { Any } from "@bufbuild/protobuf/wkt";
+import { file_google_protobuf_any } from "@bufbuild/protobuf/wkt";
+import type { TemplateString } from "../string/template_string_pb.js";
+import { file_spine_string_template_string } from "../string/template_string_pb.js";
+import type { FieldPath } from "../base/field_path_pb.js";
+import { file_spine_base_field_path } from "../base/field_path_pb.js";
+import type { Message } from "@bufbuild/protobuf";
+
+/**
+ * Describes the file spine/validation/validation_error.proto.
+ * Generated from Proto: spine/validation/validation_error.proto.
+ */
+export const file_spine_validation_validation_error: GenFile = /*@__PURE__*/
+  fileDesc("CidzcGluZS92YWxpZGF0aW9uL3ZhbGlkYXRpb25fZXJyb3IucHJvdG8SEHNwaW5lLnZhbGlkYXRpb24iVgoPVmFsaWRhdGlvbkVycm9yEkMKFGNvbnN0cmFpbnRfdmlvbGF0aW9uGAEgAygLMiUuc3BpbmUudmFsaWRhdGlvbi5Db25zdHJhaW50VmlvbGF0aW9uIpYCChNDb25zdHJhaW50VmlvbGF0aW9uEhYKCm1zZ19mb3JtYXQYASABKAlCAhgBEhEKBXBhcmFtGAIgAygJQgIYARItCgdtZXNzYWdlGAggASgLMhwuc3BpbmUuc3RyaW5nLlRlbXBsYXRlU3RyaW5nEhEKCXR5cGVfbmFtZRgHIAEoCRIpCgpmaWVsZF9wYXRoGAMgASgLMhUuc3BpbmUuYmFzZS5GaWVsZFBhdGgSKQoLZmllbGRfdmFsdWUYBCABKAsyFC5nb29nbGUucHJvdG9idWYuQW55EjwKCXZpb2xhdGlvbhgFIAMoCzIlLnNwaW5lLnZhbGlkYXRpb24uQ29uc3RyYWludFZpb2xhdGlvbkICGAFCPgoTaW8uc3BpbmUudmFsaWRhdGlvbkIUVmFsaWRhdGlvbkVycm9yUHJvdG9QAaqNJA10eXBlLnNwaW5lLmlvYgZwcm90bzM", [file_spine_options, file_google_protobuf_any, file_spine_string_template_string, file_spine_base_field_path]);
+
+/**
+ * An error indicating that a message did not pass validation.
+ *
+ * @generated from message spine.validation.ValidationError
+ * Generated from Proto: spine/validation/validation_error.proto.
+ */
+export type ValidationError = Message<"spine.validation.ValidationError"> & {
+  /**
+   * Validation constraint violations found by validator.
+   *
+   * @generated from field: repeated spine.validation.ConstraintViolation constraint_violation = 1;
+   */
+  constraintViolation: ConstraintViolation[];
+};
+
+/**
+ * Describes the message spine.validation.ValidationError.
+ * Use `create(ValidationErrorSchema)` to create a new message.
+ * Generated from Proto: spine/validation/validation_error.proto.
+ */
+export const ValidationErrorSchema: GenMessage<ValidationError> = /*@__PURE__*/
+  messageDesc(file_spine_validation_validation_error, 0);
+
+/**
+ * Describes the violation of a validation constraint found in a message.
+ *
+ * @generated from message spine.validation.ConstraintViolation
+ * Generated from Proto: spine/validation/validation_error.proto.
+ */
+export type ConstraintViolation = Message<"spine.validation.ConstraintViolation"> & {
+  /**
+   * Deprecated: use `message` field to access the error message.
+   *
+   * @generated from field: string msg_format = 1 [deprecated = true];
+   * @deprecated
+   */
+  msgFormat: string;
+
+  /**
+   * Deprecated: use `message` field to access the error message.
+   *
+   * @generated from field: repeated string param = 2 [deprecated = true];
+   * @deprecated
+   */
+  param: string[];
+
+  /**
+   * An error message for this violation.
+   *
+   * The returned message can be formatted using one of the following approaches:
+   *
+   * 1. In Kotlin, use the `TemplateString.format()` extension.
+   * 2. In Java, use the `io.spine.string.TemplateStrings.format()` static method.
+   *
+   *
+   * @generated from field: spine.string.TemplateString message = 8;
+   */
+  message?: TemplateString | undefined;
+
+  /**
+   * The name of the validated message type.
+   *
+   * If the `(validate)` option is applied and a nested field contains an invalid value,
+   * this property holds the name of the root message, which triggered the validation.
+   *
+   * Example:
+   *
+   * ```
+   * message AddressBook {
+   *     Contacts contacts = 1 [(validate) = true];
+   * }
+   *
+   * message Contacts {
+   *     Email email = 1 [(validate) = true];
+   * }
+   *
+   * message Email {
+   *     string value = 1 [(pattern).regex = "^[\\w.-]+@[\\w.-]+\\.[a-zA-Z]{2,}$"];
+   * }
+   * ```
+   *
+   * When the `AddressBook` message is validated and the `value` field in the nested `Email`
+   * message is invalid, this property will contain the `AddressBook` type name, not `Email`.
+   * This is so because this type is an entry point to the nested validation.
+   *
+   *
+   * @generated from field: string type_name = 7;
+   */
+  typeName: string;
+
+  /**
+   * A path to the field containing an invalid value.
+   *
+   * If the `(validate)` option is applied and a nested field contains an invalid value,
+   * this property holds the path to the invalid field. If there is no nesting, the path
+   * consists only of the field name.
+   *
+   * Example:
+   *
+   * ```
+   * message Student {
+   *     Contacts contacts = 1 [(validate) = true];
+   * }
+   *
+   * message Contacts {
+   *     Email email = 1 [(validate) = true];
+   * }
+   *
+   * message Email {
+   *     string value = 1 [(pattern).regex = "^[\\w.-]+@[\\w.-]+\\.[a-zA-Z]{2,}$"];
+   * }
+   * ```
+   *
+   * When the `Student` message is validated and the `value` field in the nested `Email` message
+   * is invalid, this property will contain the full path to the invalid field: `contacts.email.value`.
+   * However, if the `Email` message is validated independently (not as part of `Student`),
+   * the path will consist only of the field name: `value`.
+   *
+   *
+   * @generated from field: spine.base.FieldPath field_path = 3;
+   */
+  fieldPath?: FieldPath | undefined;
+
+  /**
+   * The value of the field which violates the validation constraint.
+   *
+   * Contains a corresponding wrapper message for primitives
+   * (google.protobuf.StringValue for "string" field type and so on).
+   *
+   *
+   * @generated from field: google.protobuf.Any field_value = 4;
+   */
+  fieldValue?: Any | undefined;
+
+  /**
+   * Deprecated: all violations are top-level now. Their nesting is reflected in the value
+   * of `field_path` field.
+   *
+   * @generated from field: repeated spine.validation.ConstraintViolation violation = 5 [deprecated = true];
+   * @deprecated
+   */
+  violation: ConstraintViolation[];
+};
+
+/**
+ * Describes the message spine.validation.ConstraintViolation.
+ * Use `create(ConstraintViolationSchema)` to create a new message.
+ * Generated from Proto: spine/validation/validation_error.proto.
+ */
+export const ConstraintViolationSchema: GenMessage<ConstraintViolation> = /*@__PURE__*/
+  messageDesc(file_spine_validation_validation_error, 1);
+

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@spine-event-engine/proto",
+  "version": "2.0.0-snapshot.2",
+  "license": "Apache-2.0",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/SpineEventEngine/spine-ts",
+    "directory": "packages/proto"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public",
+    "tag": "snapshot"
+  },
+  "description": "Spine TS generated Protobuf-ES schema exports.",
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "default": "./dist/src/index.js"
+    },
+    "./client": {
+      "types": "./dist/src/client/index.d.ts",
+      "default": "./dist/src/client/index.js"
+    },
+    "./auth": {
+      "types": "./dist/src/auth/index.d.ts",
+      "default": "./dist/src/auth/index.js"
+    },
+    "./delivery": {
+      "types": "./dist/src/delivery/index.d.ts",
+      "default": "./dist/src/delivery/index.js"
+    },
+    "./delivery-server": {
+      "types": "./dist/src/delivery-server/index.d.ts",
+      "default": "./dist/src/delivery-server/index.js"
+    },
+    "./deployment": {
+      "types": "./dist/src/deployment/index.d.ts",
+      "default": "./dist/src/deployment/index.js"
+    },
+    "./spine-proto-manifest.json": "./spine-proto-manifest.json",
+    "./proto/*": "./proto/*",
+    "./generated/*.js": {
+      "types": "./dist/generated/*.d.ts",
+      "default": "./dist/generated/*.js"
+    }
+  },
+  "files": [
+    "dist",
+    "generated",
+    "README.md",
+    "REFERENCE.md",
+    "proto",
+    "spine-proto.json",
+    "spine-proto-manifest.json"
+  ],
+  "dependencies": {
+    "@bufbuild/protobuf": "2.12.1"
+  }
+}

package/proto/README.md

@@ -0,0 +1,81 @@
+# Spine Protobuf sources
+
+This directory contains the `.proto` files used by Spine TS. Most are exact
+copies of Spine JVM contracts, so TypeScript and JVM applications can exchange
+the same commands, events, queries, subscriptions, and context messages. A
+small number are internal Spine TS contracts.
+
+## 📌 Two kinds of source
+
+[`spine-sources.json`](spine-sources.json) records both kinds of source:
+
+- `sources` are frozen copies from upstream Spine repositories. Each entry has
+  the repository, commit, source URL, raw URL, and SHA-256 checksum. Do not
+  edit one by hand. Copy it from its pinned raw URL, preserve it byte-for-byte,
+  then update its manifest checksum and descriptor lock through the verification
+  workflow.
+- `ownedSources` are small Spine TS-maintained internal schemas. Edit these as
+  normal framework source, update their checksum in the manifest, and regenerate
+  the descriptor lock. They are still checked so changes stay deliberate and
+  reproducible.
+
+## 💡 Why verify sources?
+
+- ✅ Builds and tests do not need the network.
+- ✅ Frozen copies retain their upstream repository, commit, URLs, and SHA-256.
+- ✅ Local internal schemas have an explicit checksum and descriptor history.
+- ✅ Descriptor checks catch changes to fields, options, type URLs, and imports.
+- ✅ Generated TypeScript always comes from a known contract set.
+
+The current inventory has 41 frozen source files and two internal Spine TS
+internal schemas. Buf adds standard imported descriptors while compiling them,
+producing the 52-file descriptor set checked by this repository.
+
+## 🚀 Verify and generate
+
+Run these commands from the repository root:
+
+```bash
+pnpm proto:verify
+pnpm proto:lint
+pnpm proto:generate
+pnpm proto:check-generated
+```
+
+`proto:verify` checks that every frozen copy and every maintained schema matches its
+manifest checksum. `proto:lint` checks the contracts with the narrow
+compatibility exceptions required by frozen original Spine files.
+`proto:generate` rebuilds `packages/proto/generated`; the generated directory
+must not be a symlink. `proto:check-generated` rejects missing, stale, orphaned,
+tracked, or symlinked generated output.
+
+## 🔒 Descriptor compatibility
+
+Before generation, the workflow builds a complete
+`google.protobuf.FileDescriptorSet`, removes only source-location comments,
+orders files by name, and compares the result with
+`frozen-descriptor-set.sha256`. Custom options and unknown fields remain in the
+checksum, so compatibility-relevant changes fail closed.
+
+The frozen `spine/options.proto` source is pinned to
+[`SpineEventEngine/base-libraries@51cb428771e5af8a944675fb8e26e9eb2c3d0dfe`](https://github.com/SpineEventEngine/base-libraries/blob/51cb428771e5af8a944675fb8e26e9eb2c3d0dfe/base/src/main/proto/spine/options.proto).
+It retains its Java option fields and adds the upstream TypeScript-only
+`(is).ts_type` and `(every_is).ts_type` declarations. The source manifest and
+descriptor lock verify the exact bytes and field numbers; later generator work
+owns interpretation and generation of those markers.
+
+## ⚠️ Original naming is preserved
+
+Some frozen Spine files use legacy enum, field, package, or version names. They
+remain unchanged because they are wire contracts shared with Spine JVM. New
+application Proto packages should follow the current naming guidance in the
+[end-user guide](../../../docs/USER_GUIDE.md).
+
+The `spine/system/server` schemas are framework-internal contracts. They are
+generated for Spine TS runtime packages but are not curated end-user exports.
+
+## 🔗 Learn more
+
+- [Protobuf package](../README.md)
+- [Protobuf tooling](../../proto-tools/README.md)
+- [JVM compatibility checks](../../../compatibility-tests/jvm/README.md)

package/proto/frozen-descriptor-set.sha256

@@ -0,0 +1,3 @@
+0844be5a0c588717932dc09da4d3fdc62c945a4f82be9bbb4e4d3d4814e42c3b
+# Buf 1.71.0 complete FileDescriptorSet from the 50 manifest-pinned frozen
+# sources; normalized by packages/proto/scripts/verify-descriptor-compatibility.mjs.

package/proto/grpc/health/v1/health.proto

@@ -0,0 +1,63 @@
+// Copyright 2015 The gRPC Authors
+//
+// 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
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+// The canonical version of this proto can be found at
+// https://github.com/grpc/grpc-proto/blob/master/grpc/health/v1/health.proto
+
+syntax = "proto3";
+
+package grpc.health.v1;
+
+option csharp_namespace = "Grpc.Health.V1";
+option go_package = "google.golang.org/grpc/health/grpc_health_v1";
+option java_multiple_files = true;
+option java_outer_classname = "HealthProto";
+option java_package = "io.grpc.health.v1";
+
+message HealthCheckRequest {
+    string service = 1;
+}
+
+message HealthCheckResponse {
+    enum ServingStatus {
+        UNKNOWN = 0;
+        SERVING = 1;
+        NOT_SERVING = 2;
+        SERVICE_UNKNOWN = 3;  // Used only by the Watch method.
+    }
+    ServingStatus status = 1;
+}
+
+service Health {
+    // If the requested service is unknown, the call will fail with status
+    // NOT_FOUND.
+    rpc Check(HealthCheckRequest) returns (HealthCheckResponse);
+
+    // Performs a watch for the serving status of the requested service.
+    // The server will immediately send back a message indicating the current
+    // serving status.  It will then subsequently send a new message whenever
+    // the service's serving status changes.
+    //
+    // If the requested service is unknown when the call is received, the
+    // server will send a message setting the serving status to
+    // SERVICE_UNKNOWN but will *not* terminate the call.  If at some
+    // future point, the serving status of the service becomes known, the
+    // server will send a new message with the service's serving status.
+    //
+    // If the call terminates with status UNIMPLEMENTED, then clients
+    // should assume this method is not supported and should not retry the
+    // call.  If the call terminates with any other status (including OK),
+    // clients should retry the call with appropriate exponential backoff.
+    rpc Watch(HealthCheckRequest) returns (stream HealthCheckResponse);
+}

package/proto/spine/auth/authenticated_subscription.proto

@@ -0,0 +1,36 @@
+/*
+ * Copyright 2026, CodeMatters. 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
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+syntax = "proto3";
+
+package spine.auth;
+
+import "google/protobuf/timestamp.proto";
+import "spine/client/subscription.proto";
+import "spine/options.proto";
+
+option (type_url_prefix) = "type.spine.io";
+option java_multiple_files = true;
+
+// A subscription accepted through an authenticated Gateway request.
+message GatewayAuthenticatedSubscription {
+
+    // The identifier used to store this record.
+    spine.client.SubscriptionId id = 1 [(required) = true, (validate) = true];
+
+    // The authenticated subscription, including its Actor and Tenant context.
+    spine.client.Subscription subscription = 2 [(required) = true, (validate) = true];
+
+    // The time after which the authenticated subscription is no longer valid.
+    google.protobuf.Timestamp when_expires = 3 [(required) = true];
+}

package/proto/spine/auth/authentication_service.proto

@@ -0,0 +1,47 @@
+/*
+ * Copyright 2026, CodeMatters. 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
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+syntax = "proto3";
+
+package spine.auth;
+
+import "google/protobuf/timestamp.proto";
+import "spine/core/tenant_id.proto";
+import "spine/core/user_id.proto";
+import "spine/options.proto";
+
+option (type_url_prefix) = "type.spine.io";
+option java_multiple_files = true;
+
+// The provider-neutral gateway contract for informational browser context.
+service AuthenticationService {
+
+  // Resolves the current actor, tenant, and application-session expiry.
+  rpc ResolveContext(ResolveContextRequest) returns (ResolveContextResponse);
+}
+
+// The session credential travels in transport metadata, not in this message.
+message ResolveContextRequest {}
+
+// Informational session context; each later request is independently authorized.
+message ResolveContextResponse {
+
+  // The user represented by the authenticated request.
+  spine.core.UserId actor = 1;
+
+  // The tenant in whose scope the request is authorized.
+  spine.core.TenantId tenant = 2;
+
+  // The time after which the resolved session is no longer valid.
+  google.protobuf.Timestamp expires_at = 3;
+}

package/proto/spine/base/error.proto

@@ -0,0 +1,68 @@
+/*
+ * 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.base;
+
+import "spine/options.proto";
+
+option (type_url_prefix) = "type.spine.io";
+option java_multiple_files = true;
+option java_outer_classname = "ErrorProto";
+option java_package = "io.spine.base";
+
+import "google/protobuf/struct.proto";
+import "google/protobuf/any.proto";
+
+// Information on a technical error occurred in the system.
+message Error {
+
+    // The type of the error.
+    //
+    // It can be an exception from Java, C# (or another language) or a Proto enum name.
+    //
+    string type = 1;
+
+    // An integer code resulting from a native code call, or a number from a Proto enum value.
+    int32 code = 2;
+
+    reserved "validation_error";
+    reserved 3; // It used to be the index of the deprecated `validation_error` field.
+
+    // The message of the error wrapped into `Any`, if available.
+    google.protobuf.Any details = 4;
+    
+    reserved 5 to 9;
+
+    // A developer-readable diagnostics message on the error.
+    string message = 10;
+
+    // Additional information on the error.
+    map<string, google.protobuf.Value> attributes = 11;
+
+    // A stacktrace of an exception (if available).
+    string stacktrace = 12;
+}

package/proto/spine/base/field_path.proto

@@ -0,0 +1,59 @@
+/*
+ * Copyright 2024, 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.base;
+
+import "spine/options.proto";
+
+option (type_url_prefix) = "type.spine.io";
+option java_package = "io.spine.base";
+option java_outer_classname = "FieldPathProto";
+option java_multiple_files = true;
+
+// Field path provides field names of nested messages.
+//
+// The first entry in the names list is a name of a field in the root message.
+// The second entry is the name of the field in the nested message, and so on.
+//
+// For example, consider the following message declarations:
+//
+//     message CustomerAccount {
+//       User user = 1;
+//     }
+//
+//     message User {
+//       string name = 1;
+//     }
+//
+// The field path for `name` field of the `User` message enclosed into the `CustomerAccount`
+// is ["user", "name"].
+//
+message FieldPath {
+
+    // Unqualified field names.
+    repeated string field_name = 1;
+}

package/proto/spine/client/command_service.proto

@@ -0,0 +1,62 @@
+/*
+ * 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.client;
+
+import "spine/options.proto";
+
+option (type_url_prefix) = "type.spine.io";
+// We put gRPC-based classes into `grpc` sub-package, which is annotated as `@Internal`
+// to hide implementation details from the public API of the framework.
+option java_package = "io.spine.client.grpc";
+option java_multiple_files = true;
+option java_outer_classname = "CommandServiceProto";
+
+import "spine/core/command.proto";
+import "spine/core/ack.proto";
+
+// A service for posting commands to the application backend.
+service CommandService {
+
+    // Posts the given command to the application backend.
+    //
+    // When the command is successfully received by the application, it responds with
+    // an acknowledgement. The received `Ack` may have one of the following statuses:
+    //
+    //    1. `Status.ok` — the command is accepted for further processing.
+    //    2. `Status.error` — there has been an error receiving the command. No further
+    //        processing would occur.
+    //    3. `Status.rejection` — business rules do not allow the execution of the command.
+    //        E.g., a user who made a request does not have the required permission.
+    //
+    // In case of internal gRPC errors or issues on a transport layer, an `Ack`
+    // would not be received. All errors that occur on the side of gRPC should
+    // be handled by the means of the chosen client stub.
+    //
+    rpc Post(core.Command) returns (core.Ack);
+}