protobuf-platform 1.2.617 → 1.2.622

package/docs/promotional-big-wins.md

@@ -0,0 +1,76 @@
+# Promotional Big Wins contract
+
+Release: `protobuf-platform@1.2.620`.
+
+## Public feed
+
+`bet.Bet/getPromotionalBigWins(PaginationRequest) -> WinRatesResponse` is a separate
+simulated promotional feed. Gateway selects this method only when promotional
+mode is explicitly requested. The requesting UI must visibly disclose that the
+cards are simulated promotional examples, not genuine player activity.
+
+Only `limit` and `offset` are used. Offset follows the existing Big Wins convention:
+a zero-based page number, with the row start calculated as `offset * limit`.
+The shared request's user/history filters do not apply to this method.
+
+`getWinRates`, `getLastWins`, `getTopWinByMultiplier`, `PaginationRequest`,
+`WinRatesResponse`, and `WinRateItem` retain their existing fields and semantics.
+There is no response disclosure flag, player ID, or financial operation in the
+new contract. The public amount retains its existing protobuf `float` type.
+Implementations must account for wire rounding when enforcing generated ranges;
+configuration decimal strings must never be converted to floats for storage.
+
+## Configuration management
+
+These methods are internal and must be exposed only through the gateway's
+authenticated, authorized BackOffice path. They manage bet-service configuration,
+never real bets, users, wallets, or ledger entries.
+
+| RPC | Request | Response |
+| --- | --- | --- |
+| `readListPromotionalBigWins` | `PaginationRequest` | `PromotionalBigWinItemsResponse` |
+| `setPromotionalBigWin` | `PromotionalBigWinRequest` | `PromotionalBigWinItem` |
+| `deletePromotionalBigWin` | `PromotionalBigWinKey` | `PromotionalBigWinStatusResponse` |
+
+The list includes active and inactive configurations and uses the same page-offset
+convention. Set is a full create-or-replace operation keyed by canonical game ID.
+It requires positive `game_id`, positive integer `frequency`, exact non-negative
+decimal `min_win` and `max_win` with `max_win >= min_win`, and explicit `is_active`.
+The optional boolean preserves absent versus explicitly false on the wire; the
+service must reject absence. Setting false disables selection. Delete is
+idempotent: absence is successful.
+
+Amounts are in the authoritative runtime BaseCurrency, with the platform currency
+scale and implementation range validation. They do not encode a fixed currency.
+Frequency is a selection weight, not a count or quota. Timestamps in returned
+configuration items are service-generated ISO timestamps.
+
+## Game authority and seed resolution
+
+Existing `game.Game/getProviderCatalogBatch` and `getGameCatalogBatch` expose
+canonical IDs, titles, slugs, provider associations, and availability flags.
+`getGamesByIds` provides card metadata. No game contract change is required.
+Runtime validation must consider game/provider availability: the existing poor
+metadata lookup excludes deactivated content but alone does not check all active
+and hidden flags.
+
+Seed matching must join provider identity and game title/slug conservatively,
+report missing/ambiguous matches, and store only resolved game IDs. Invalid source
+rows and conflicting duplicate configurations must be reported and skipped rather
+than defaulted or overwritten according to spreadsheet order.
+
+## Compatibility and rollout
+
+This release only adds RPCs and messages. Older clients can call existing methods
+on upgraded servers unchanged. New promotional methods are unavailable on older
+bet servers; gateway must never fall back to genuine wins for a promotional request.
+
+Publish the prepared package manually, then verify registry resolution and update
+bet/gateway package locks before their implementation. Deploy the bet migration
+and server support before enabling the gateway selector. The game service must
+already expose the existing catalog and metadata methods. Frontend disclosure
+must be present before promotional mode is exposed to users.
+
+On rollback, disable promotional routing before rolling back bet support. Keep
+configuration data unless a separately reviewed migration rollback is intended.
+Package publication alone neither deploys the feature nor runs a migration/seed.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "protobuf-platform",
-  "version": "1.2.617",
+  "version": "1.2.622",
   "description": "Protobuf structures",
   "main": "index.js",
   "scripts": {

package/user/user.proto

@@ -622,8 +622,8 @@ message GetUserWalletBalancesRequest {
 message UserWalletBalanceItem {
     string currency = 1;
     int32 currency_scale = 2;
-    int64 real_amount_minor = 3;
-    int64 bonus_amount_minor = 4;
+    int64 real_amount_minor = 3 [jstype = JS_STRING];
+    int64 bonus_amount_minor = 4 [jstype = JS_STRING];
     optional string updated_at = 5;
 }
 message UserWalletBalancesResponse {

package/user/user_pb.js

@@ -24621,8 +24621,8 @@ proto.user.UserWalletBalanceItem.toObject = function(includeInstance, msg) {
   var f, obj = {
     currency: jspb.Message.getFieldWithDefault(msg, 1, ""),
     currencyScale: jspb.Message.getFieldWithDefault(msg, 2, 0),
-    realAmountMinor: jspb.Message.getFieldWithDefault(msg, 3, 0),
-    bonusAmountMinor: jspb.Message.getFieldWithDefault(msg, 4, 0),
+    realAmountMinor: jspb.Message.getFieldWithDefault(msg, 3, "0"),
+    bonusAmountMinor: jspb.Message.getFieldWithDefault(msg, 4, "0"),
     updatedAt: jspb.Message.getFieldWithDefault(msg, 5, "")
   };
 
@@ -24669,11 +24669,11 @@ proto.user.UserWalletBalanceItem.deserializeBinaryFromReader = function(msg, rea
       msg.setCurrencyScale(value);
       break;
     case 3:
-      var value = /** @type {number} */ (reader.readInt64());
+      var value = /** @type {string} */ (reader.readInt64String());
       msg.setRealAmountMinor(value);
       break;
     case 4:
-      var value = /** @type {number} */ (reader.readInt64());
+      var value = /** @type {string} */ (reader.readInt64String());
       msg.setBonusAmountMinor(value);
       break;
     case 5:
@@ -24724,15 +24724,15 @@ proto.user.UserWalletBalanceItem.serializeBinaryToWriter = function(message, wri
     );
   }
   f = message.getRealAmountMinor();
-  if (f !== 0) {
-    writer.writeInt64(
+  if (parseInt(f, 10) !== 0) {
+    writer.writeInt64String(
       3,
       f
     );
   }
   f = message.getBonusAmountMinor();
-  if (f !== 0) {
-    writer.writeInt64(
+  if (parseInt(f, 10) !== 0) {
+    writer.writeInt64String(
       4,
       f
     );
@@ -24785,37 +24785,37 @@ proto.user.UserWalletBalanceItem.prototype.setCurrencyScale = function(value) {
 
 /**
  * optional int64 real_amount_minor = 3;
- * @return {number}
+ * @return {string}
  */
 proto.user.UserWalletBalanceItem.prototype.getRealAmountMinor = function() {
-  return /** @type {number} */ (jspb.Message.getFieldWithDefault(this, 3, 0));
+  return /** @type {string} */ (jspb.Message.getFieldWithDefault(this, 3, "0"));
 };
 
 
 /**
- * @param {number} value
+ * @param {string} value
  * @return {!proto.user.UserWalletBalanceItem} returns this
  */
 proto.user.UserWalletBalanceItem.prototype.setRealAmountMinor = function(value) {
-  return jspb.Message.setProto3IntField(this, 3, value);
+  return jspb.Message.setProto3StringIntField(this, 3, value);
 };
 
 
 /**
  * optional int64 bonus_amount_minor = 4;
- * @return {number}
+ * @return {string}
  */
 proto.user.UserWalletBalanceItem.prototype.getBonusAmountMinor = function() {
-  return /** @type {number} */ (jspb.Message.getFieldWithDefault(this, 4, 0));
+  return /** @type {string} */ (jspb.Message.getFieldWithDefault(this, 4, "0"));
 };
 
 
 /**
- * @param {number} value
+ * @param {string} value
  * @return {!proto.user.UserWalletBalanceItem} returns this
  */
 proto.user.UserWalletBalanceItem.prototype.setBonusAmountMinor = function(value) {
-  return jspb.Message.setProto3IntField(this, 4, value);
+  return jspb.Message.setProto3StringIntField(this, 4, value);
 };