protobuf-platform 1.2.628 → 1.2.629

package/AGENTS.md

@@ -1,12 +1,15 @@
 # protobuf-platform: contract repository
 
-- Repository directory: `protobuf`; npm package: `protobuf-platform`. Work on `main`, never `staging`. This is a contract package, not a running service; it owns no database, queues or migrations.
+Read [Project Rules](../../platform-rules/PROJECT_RULES.md) for the canonical shared execution policy; this file specializes the protobuf commands.
+
+- Repository directory: `protobuf`; npm package: `protobuf-platform`. Work locally on `main`, never switch to local `staging`. The Project Rules' final push command targets `origin HEAD:staging` without changing this local branch; do not execute it without explicit push authorization. This is a contract package, not a running service; it owns no database, queues or migrations.
 - Inspect this repository first for every business master task. Reuse existing contracts when sufficient and record `PROTOBUF_CHANGE_NOT_REQUIRED` when no change is needed.
-- A new/material contract decision needs `PROTOBUF_CHANGE_APPROVAL_REQUIRED` and `APPROVE_PROTOBUF_CHANGE` unless the master task already explicitly approved it. Include exact contract, insufficiency, compatibility and affected repositories. Contract work precedes dependent service implementation.
+- A new/material contract decision or breaking change needs explicit approval of that exact change; additive approval never authorizes breaking compatibility. If approval is missing, report `PROTOBUF_CHANGE_APPROVAL_REQUIRED` with the exact contract, insufficiency, compatibility and affected repositories. Contract work precedes dependent implementation.
 - Sources are domain `*.proto` files; `update_protobuf.sh` writes colocated `*_pb.js` and `*_grpc_pb.js`; `index.js` exports domain bindings.
 - npm with `package-lock.json`; generated output is CommonJS. Run `npm run proto:build`, inspect generated diff, and review old/new producer-consumer compatibility (field tags/types, optional/default behavior, enum values, RPC methods and exports). Fix Critical/Medium findings before committing.
 - The build script uses `~/node-x64/bin/npm`; `proto:build:x64` uses `~/node-v22.21.1-darwin-x64/bin/npm`. Verify the selected local runtime and grpc-tools binary. `proto:install:x64` deletes node_modules AND the lockfile: it is a recovery script, not ordinary dependency installation.
 - For a contract release, prepare one version bump with `npm version patch --no-git-tag-version` (or the already-approved version), verify package.json and package-lock.json agree, review generated/package contents, and create a local atomic commit including version files. Avoid a second bump if already prepared.
-- Stop with `MANUAL_PROTOBUF_PUBLISH_REQUIRED`; the sole remaining publication command, run by the human in this repository, is `npm publish`. Do not execute it or `npm run publish-update` (which combines bump and publication).
-- Wait for `PROTOBUF_PUBLISHED`, then resume the same master task and verify downstream package/lockfile resolution before dependent implementation. Never publish automatically.
+- For an explicitly approved additive change, run `npm publish` after validation and the release commit, using existing authorized registry credentials. Do not run `npm run publish-update` after preparing the version: it would bump again. On an ambiguous result, inspect the registry before retrying; never blindly republish or bump.
+- Local npm machine authentication was verified from this repository against `https://registry.npmjs.org/` on 2026-09-15; identity and package metadata resolved. Use the existing setup without requesting OTP or a manual publication handoff. This read-only check did not exercise publication permissions. If auth actually fails, diagnose the exact error and request only the minimum action needed to restore machine authentication; never expose a token.
+- Verify the exact release with `npm view protobuf-platform@<release-version> version`, then run only `sh sync_internal_libs.sh` directly in each affected service repository under the Project Rules. Verify installed/dependency/lockfile state and the expected contract, then continue the same master task automatically without a publication acknowledgement or manual sync handoff. Request human action only for genuinely unavailable authentication or permissions; never expose credentials.
 - package.json has no lint command; its test script is a failing placeholder. For documentation-only edits use diff/link review; generation is required when contracts change, not for editing these instructions.

package/game/game.proto

@@ -3,6 +3,13 @@ syntax = "proto3";
 package game;
 
 service Game {
+    rpc createSingleMultiScope(stream MultiScopeRequest) returns (MultiScopeResponse);
+    rpc readSingleMultiScope(GetMultiScopeRequest) returns (MultiScopeResponse);
+    rpc updateSingleMultiScope(stream MultiScopeRequest) returns (MultiScopeResponse);
+    rpc deleteSingleMultiScope(GetMultiScopeRequest) returns (MultiScopeStatusResponse);
+    rpc readListMultiScopes(MultiScopeListRequest) returns (MultiScopeItemsResponse);
+    rpc addMultiScopeMembers(MultiScopeMembersRequest) returns (MultiScopeStatusResponse);
+    rpc removeMultiScopeMembers(MultiScopeMembersRequest) returns (MultiScopeStatusResponse);
     //Tech
     rpc checkConnection(PingRequest) returns (PongResponse);
     //Common
@@ -969,6 +976,70 @@ message GamesIds {
 message GamePoorItemsResponse {
     repeated GameItem items = 1;
 }
+/** Global structural composition. Visibility belongs to explicit CMS GEO placements. */
+message MultiScopeMember {
+    int32 id = 1;
+    string title = 2;
+    string slug = 3;
+    bool is_active = 4;
+    optional string image = 5;
+    optional string image_cdn = 6;
+    optional string icon = 7;
+    optional string icon_cdn = 8;
+}
+message MultiScopeItem {
+    int32 id = 1;
+    string title = 2;
+    string slug = 3;
+    bool is_active = 4;
+    optional string image = 5;
+    optional string image_cdn = 6;
+    optional string icon = 7;
+    optional string icon_cdn = 8;
+    string created_at = 9;
+    string updated_at = 10;
+    repeated MultiScopeMember collections = 11;
+    repeated MultiScopeMember tags = 12;
+}
+message MultiScopeItemRequest {
+    optional int32 id = 1;
+    optional string title = 2;
+    optional string slug = 3;
+    optional bool is_active = 4;
+}
+message MultiScopeRequest {
+    oneof request {
+        MultiScopeItemRequest multi_scope_data = 1;
+        File file = 2;
+        EntityFileMetadata file_metadata = 3;
+    }
+}
+message GetMultiScopeRequest {
+    int32 id = 1;
+}
+message MultiScopeListRequest {
+    int32 limit = 1;
+    int32 offset = 2;
+    optional string title = 3;
+    optional bool is_active = 4;
+    repeated int32 ids = 5;
+}
+message MultiScopeMembersRequest {
+    int32 id = 1;
+    repeated int32 collection_ids = 2;
+    repeated int32 tag_ids = 3;
+}
+message MultiScopeResponse {
+    MultiScopeItem data = 1;
+}
+message MultiScopeItemsResponse {
+    repeated MultiScopeItem items = 1;
+    int32 total_pages = 2;
+    int32 total_items = 3;
+}
+message MultiScopeStatusResponse {
+    string status = 1;
+}
 message ScopeRequest {
     string data = 1;
     optional string locale = 2;

package/game/game_grpc_pb.js

@@ -697,6 +697,17 @@ function deserialize_game_GetGameSnapshotsByIdsRequest(buffer_arg) {
   return game_pb.GetGameSnapshotsByIdsRequest.deserializeBinary(new Uint8Array(buffer_arg));
 }
 
+function serialize_game_GetMultiScopeRequest(arg) {
+  if (!(arg instanceof game_pb.GetMultiScopeRequest)) {
+    throw new Error('Expected argument of type game.GetMultiScopeRequest');
+  }
+  return Buffer.from(arg.serializeBinary());
+}
+
+function deserialize_game_GetMultiScopeRequest(buffer_arg) {
+  return game_pb.GetMultiScopeRequest.deserializeBinary(new Uint8Array(buffer_arg));
+}
+
 function serialize_game_GetProviderRequest(arg) {
   if (!(arg instanceof game_pb.GetProviderRequest)) {
     throw new Error('Expected argument of type game.GetProviderRequest');
@@ -862,6 +873,72 @@ function deserialize_game_MerchantFreeSpinLimitsResponse(buffer_arg) {
   return game_pb.MerchantFreeSpinLimitsResponse.deserializeBinary(new Uint8Array(buffer_arg));
 }
 
+function serialize_game_MultiScopeItemsResponse(arg) {
+  if (!(arg instanceof game_pb.MultiScopeItemsResponse)) {
+    throw new Error('Expected argument of type game.MultiScopeItemsResponse');
+  }
+  return Buffer.from(arg.serializeBinary());
+}
+
+function deserialize_game_MultiScopeItemsResponse(buffer_arg) {
+  return game_pb.MultiScopeItemsResponse.deserializeBinary(new Uint8Array(buffer_arg));
+}
+
+function serialize_game_MultiScopeListRequest(arg) {
+  if (!(arg instanceof game_pb.MultiScopeListRequest)) {
+    throw new Error('Expected argument of type game.MultiScopeListRequest');
+  }
+  return Buffer.from(arg.serializeBinary());
+}
+
+function deserialize_game_MultiScopeListRequest(buffer_arg) {
+  return game_pb.MultiScopeListRequest.deserializeBinary(new Uint8Array(buffer_arg));
+}
+
+function serialize_game_MultiScopeMembersRequest(arg) {
+  if (!(arg instanceof game_pb.MultiScopeMembersRequest)) {
+    throw new Error('Expected argument of type game.MultiScopeMembersRequest');
+  }
+  return Buffer.from(arg.serializeBinary());
+}
+
+function deserialize_game_MultiScopeMembersRequest(buffer_arg) {
+  return game_pb.MultiScopeMembersRequest.deserializeBinary(new Uint8Array(buffer_arg));
+}
+
+function serialize_game_MultiScopeRequest(arg) {
+  if (!(arg instanceof game_pb.MultiScopeRequest)) {
+    throw new Error('Expected argument of type game.MultiScopeRequest');
+  }
+  return Buffer.from(arg.serializeBinary());
+}
+
+function deserialize_game_MultiScopeRequest(buffer_arg) {
+  return game_pb.MultiScopeRequest.deserializeBinary(new Uint8Array(buffer_arg));
+}
+
+function serialize_game_MultiScopeResponse(arg) {
+  if (!(arg instanceof game_pb.MultiScopeResponse)) {
+    throw new Error('Expected argument of type game.MultiScopeResponse');
+  }
+  return Buffer.from(arg.serializeBinary());
+}
+
+function deserialize_game_MultiScopeResponse(buffer_arg) {
+  return game_pb.MultiScopeResponse.deserializeBinary(new Uint8Array(buffer_arg));
+}
+
+function serialize_game_MultiScopeStatusResponse(arg) {
+  if (!(arg instanceof game_pb.MultiScopeStatusResponse)) {
+    throw new Error('Expected argument of type game.MultiScopeStatusResponse');
+  }
+  return Buffer.from(arg.serializeBinary());
+}
+
+function deserialize_game_MultiScopeStatusResponse(buffer_arg) {
+  return game_pb.MultiScopeStatusResponse.deserializeBinary(new Uint8Array(buffer_arg));
+}
+
 function serialize_game_NormalizeDuplicateProvidersRequest(arg) {
   if (!(arg instanceof game_pb.NormalizeDuplicateProvidersRequest)) {
     throw new Error('Expected argument of type game.NormalizeDuplicateProvidersRequest');
@@ -1480,6 +1557,83 @@ function deserialize_game_WagerSearchRequest(buffer_arg) {
 
 
 var GameService = exports.GameService = {
+  createSingleMultiScope: {
+    path: '/game.Game/createSingleMultiScope',
+    requestStream: true,
+    responseStream: false,
+    requestType: game_pb.MultiScopeRequest,
+    responseType: game_pb.MultiScopeResponse,
+    requestSerialize: serialize_game_MultiScopeRequest,
+    requestDeserialize: deserialize_game_MultiScopeRequest,
+    responseSerialize: serialize_game_MultiScopeResponse,
+    responseDeserialize: deserialize_game_MultiScopeResponse,
+  },
+  readSingleMultiScope: {
+    path: '/game.Game/readSingleMultiScope',
+    requestStream: false,
+    responseStream: false,
+    requestType: game_pb.GetMultiScopeRequest,
+    responseType: game_pb.MultiScopeResponse,
+    requestSerialize: serialize_game_GetMultiScopeRequest,
+    requestDeserialize: deserialize_game_GetMultiScopeRequest,
+    responseSerialize: serialize_game_MultiScopeResponse,
+    responseDeserialize: deserialize_game_MultiScopeResponse,
+  },
+  updateSingleMultiScope: {
+    path: '/game.Game/updateSingleMultiScope',
+    requestStream: true,
+    responseStream: false,
+    requestType: game_pb.MultiScopeRequest,
+    responseType: game_pb.MultiScopeResponse,
+    requestSerialize: serialize_game_MultiScopeRequest,
+    requestDeserialize: deserialize_game_MultiScopeRequest,
+    responseSerialize: serialize_game_MultiScopeResponse,
+    responseDeserialize: deserialize_game_MultiScopeResponse,
+  },
+  deleteSingleMultiScope: {
+    path: '/game.Game/deleteSingleMultiScope',
+    requestStream: false,
+    responseStream: false,
+    requestType: game_pb.GetMultiScopeRequest,
+    responseType: game_pb.MultiScopeStatusResponse,
+    requestSerialize: serialize_game_GetMultiScopeRequest,
+    requestDeserialize: deserialize_game_GetMultiScopeRequest,
+    responseSerialize: serialize_game_MultiScopeStatusResponse,
+    responseDeserialize: deserialize_game_MultiScopeStatusResponse,
+  },
+  readListMultiScopes: {
+    path: '/game.Game/readListMultiScopes',
+    requestStream: false,
+    responseStream: false,
+    requestType: game_pb.MultiScopeListRequest,
+    responseType: game_pb.MultiScopeItemsResponse,
+    requestSerialize: serialize_game_MultiScopeListRequest,
+    requestDeserialize: deserialize_game_MultiScopeListRequest,
+    responseSerialize: serialize_game_MultiScopeItemsResponse,
+    responseDeserialize: deserialize_game_MultiScopeItemsResponse,
+  },
+  addMultiScopeMembers: {
+    path: '/game.Game/addMultiScopeMembers',
+    requestStream: false,
+    responseStream: false,
+    requestType: game_pb.MultiScopeMembersRequest,
+    responseType: game_pb.MultiScopeStatusResponse,
+    requestSerialize: serialize_game_MultiScopeMembersRequest,
+    requestDeserialize: deserialize_game_MultiScopeMembersRequest,
+    responseSerialize: serialize_game_MultiScopeStatusResponse,
+    responseDeserialize: deserialize_game_MultiScopeStatusResponse,
+  },
+  removeMultiScopeMembers: {
+    path: '/game.Game/removeMultiScopeMembers',
+    requestStream: false,
+    responseStream: false,
+    requestType: game_pb.MultiScopeMembersRequest,
+    responseType: game_pb.MultiScopeStatusResponse,
+    requestSerialize: serialize_game_MultiScopeMembersRequest,
+    requestDeserialize: deserialize_game_MultiScopeMembersRequest,
+    responseSerialize: serialize_game_MultiScopeStatusResponse,
+    responseDeserialize: deserialize_game_MultiScopeStatusResponse,
+  },
   // Tech
 checkConnection: {
     path: '/game.Game/checkConnection',