@suigar/sdk 2.0.0-beta.7 → 2.0.0-beta.9

package/dist/utils.cjs

@@ -146,36 +146,28 @@ var GAME_DETAILS_SCHEMA = {
 };
 
 // src/utils/parser.ts
-var bcsU8 = bcs.bcs.u8();
-var bcsU64 = bcs.bcs.u64();
-var bcsBool = bcs.bcs.bool();
-var bcsString = bcs.bcs.string();
 var textDecoder = new TextDecoder();
 var GAME_DETAIL_BCS = {
-  u8: bcsU8,
-  u64: bcsU64,
-  bool: bcsBool,
+  u8: bcs.bcs.U8,
+  u64: bcs.bcs.U64,
+  bool: bcs.bcs.Bool,
   float: Float,
-  string: bcsString
+  string: bcs.bcs.String
 };
 function fromMoveI64(i64) {
   try {
-    const value = BigInt(i64.bits ?? 0);
-    const maxPositive = 1n << 63n;
-    const twoPow64 = 1n << 64n;
-    const signed = value >= maxPositive ? value - twoPow64 : value;
-    return Number(signed);
+    return Number(BigInt.asIntN(64, BigInt(i64.bits ?? 0)));
   } catch {
     return 0;
   }
 }
 function fromMoveFloat(float) {
-  const mantissa = BigInt(float.mant);
+  const mantissa = BigInt(float.mant ?? 0);
   if (mantissa === 0n) {
     return 0;
   }
   const exponent = fromMoveI64(float.exp) - 52;
-  const magnitude = Number(mantissa) * Math.pow(2, exponent);
+  const magnitude = Number(mantissa) * 2 ** exponent;
   return float.is_negative ? -magnitude : magnitude;
 }
 function normalizeGameDetailValue(valueType, parsed) {
@@ -190,7 +182,7 @@ function normalizeGameDetailValue(valueType, parsed) {
 function parseStringGameDetail(value) {
   const bytes = Uint8Array.from(value);
   try {
-    return bcsString.parse(bytes);
+    return bcs.bcs.String.parse(bytes);
   } catch {
     return textDecoder.decode(bytes);
   }

package/dist/utils.d.cts

@@ -1,5 +1,5 @@
 import * as _mysten_bcs from '@mysten/bcs';
-import { M as MoveStruct } from './index-jwSXA8q3.cjs';
+import { M as MoveStruct } from './index-3P_LBbDM.cjs';
 import '@mysten/sui/bcs';
 import '@mysten/sui/client';
 
@@ -61,7 +61,30 @@ declare const DEFAULT_RANGE_SCALE = 1000000;
 declare const RANGE_POINT_LIMIT: number;
 declare const DEFAULT_LIMBO_MULTIPLIER_SCALE = 100;
 
+/**
+ * Normalizes a numeric input into a non-negative `bigint`.
+ *
+ * This helper accepts the two number shapes the SDK commonly sees from app
+ * code: plain JavaScript numbers and already-normalized `bigint` values.
+ * Number inputs are truncated toward zero before conversion, so UI-friendly
+ * values like `5.9` become `5n`.
+ *
+ * @param value Value to coerce into a `bigint`.
+ * @returns The normalized non-negative `bigint`.
+ * @throws When `value` is not a finite number or bigint, or when it is negative.
+ */
 declare function toBigInt(value: unknown): bigint;
+/**
+ * Validates that a value can be safely used as a Move `u8`.
+ *
+ * Use this for config ids and other small integer fields that must stay inside
+ * the `0..255` range. Unlike `toBigInt`, this does not coerce fractional
+ * values: the input must already be an integer.
+ *
+ * @param value Value to validate.
+ * @returns The original number once it has been confirmed to be a valid `u8`.
+ * @throws When `value` is not a finite integer between `0` and `255`.
+ */
 declare function toU8(value: unknown): number;
 
 declare const Float: MoveStruct<{
@@ -73,8 +96,42 @@ declare const Float: MoveStruct<{
 }, "0xf391858d2a08473e8d4defcc8df89976bd7b123d3865c6b9341b237f7853dbbc::float::Float">;
 
 type MoveFloat = ReturnType<(typeof Float)['parse']>;
+/**
+ * Converts a generated Move `i64` wrapper into a JavaScript number.
+ *
+ * The generated bindings expose signed 64-bit integers through a `{ bits }`
+ * field that stores the raw two's-complement bit pattern. This helper
+ * reinterprets those bits as a signed `i64` and returns a plain JS number.
+ * Invalid or missing input falls back to `0`.
+ *
+ * @param i64 Generated Move `i64` value, typically used for float exponents.
+ * @returns The signed 64-bit value as a JavaScript number.
+ */
 declare function fromMoveI64(i64: MoveFloat['exp']): number;
+/**
+ * Converts a generated Move `Float` struct into a JavaScript number.
+ *
+ * Suigar float values are represented as a sign flag, an unsigned mantissa,
+ * and a Move `i64` exponent. This helper rebuilds the numeric value using the
+ * same normalization expected by the onchain format and applies the sign at
+ * the end. Missing mantissas are treated as `0`, and a zero mantissa returns `0`.
+ *
+ * @param float Generated Move float value with `mant`, `exp`, and `is_negative`.
+ * @returns The decoded floating-point value as a JavaScript number.
+ */
 declare function fromMoveFloat(float: MoveFloat): number;
+/**
+ * Decodes `BetResultEvent.game_details` into plain application values.
+ *
+ * Suigar stores game detail entries as `VecMap<string, vector<u8>>`, so raw BCS
+ * decoding leaves each value as bytes. This helper looks up the known schema for
+ * each key, parses the bytes into the expected runtime type, and preserves the
+ * original onchain keys in the returned object. Unknown keys fall back to
+ * string decoding so newer detail fields remain readable by default.
+ *
+ * @param gameDetails Raw `game_details` map from a decoded bet result event.
+ * @returns A plain object with the same keys and decoded string, number, or boolean values.
+ */
 declare function parseGameDetails(gameDetails: BetResultGameDetails): ParsedGameDetails;
 
 export { DEFAULT_GAS_BUDGET_MIST, DEFAULT_LIMBO_MULTIPLIER_SCALE, DEFAULT_RANGE_SCALE, RANGE_POINT_LIMIT, fromMoveFloat, fromMoveI64, parseGameDetails, toBigInt, toU8 };

package/dist/utils.d.ts

@@ -1,5 +1,5 @@
 import * as _mysten_bcs from '@mysten/bcs';
-import { M as MoveStruct } from './index-jwSXA8q3.js';
+import { M as MoveStruct } from './index-3P_LBbDM.js';
 import '@mysten/sui/bcs';
 import '@mysten/sui/client';
 
@@ -61,7 +61,30 @@ declare const DEFAULT_RANGE_SCALE = 1000000;
 declare const RANGE_POINT_LIMIT: number;
 declare const DEFAULT_LIMBO_MULTIPLIER_SCALE = 100;
 
+/**
+ * Normalizes a numeric input into a non-negative `bigint`.
+ *
+ * This helper accepts the two number shapes the SDK commonly sees from app
+ * code: plain JavaScript numbers and already-normalized `bigint` values.
+ * Number inputs are truncated toward zero before conversion, so UI-friendly
+ * values like `5.9` become `5n`.
+ *
+ * @param value Value to coerce into a `bigint`.
+ * @returns The normalized non-negative `bigint`.
+ * @throws When `value` is not a finite number or bigint, or when it is negative.
+ */
 declare function toBigInt(value: unknown): bigint;
+/**
+ * Validates that a value can be safely used as a Move `u8`.
+ *
+ * Use this for config ids and other small integer fields that must stay inside
+ * the `0..255` range. Unlike `toBigInt`, this does not coerce fractional
+ * values: the input must already be an integer.
+ *
+ * @param value Value to validate.
+ * @returns The original number once it has been confirmed to be a valid `u8`.
+ * @throws When `value` is not a finite integer between `0` and `255`.
+ */
 declare function toU8(value: unknown): number;
 
 declare const Float: MoveStruct<{
@@ -73,8 +96,42 @@ declare const Float: MoveStruct<{
 }, "0xf391858d2a08473e8d4defcc8df89976bd7b123d3865c6b9341b237f7853dbbc::float::Float">;
 
 type MoveFloat = ReturnType<(typeof Float)['parse']>;
+/**
+ * Converts a generated Move `i64` wrapper into a JavaScript number.
+ *
+ * The generated bindings expose signed 64-bit integers through a `{ bits }`
+ * field that stores the raw two's-complement bit pattern. This helper
+ * reinterprets those bits as a signed `i64` and returns a plain JS number.
+ * Invalid or missing input falls back to `0`.
+ *
+ * @param i64 Generated Move `i64` value, typically used for float exponents.
+ * @returns The signed 64-bit value as a JavaScript number.
+ */
 declare function fromMoveI64(i64: MoveFloat['exp']): number;
+/**
+ * Converts a generated Move `Float` struct into a JavaScript number.
+ *
+ * Suigar float values are represented as a sign flag, an unsigned mantissa,
+ * and a Move `i64` exponent. This helper rebuilds the numeric value using the
+ * same normalization expected by the onchain format and applies the sign at
+ * the end. Missing mantissas are treated as `0`, and a zero mantissa returns `0`.
+ *
+ * @param float Generated Move float value with `mant`, `exp`, and `is_negative`.
+ * @returns The decoded floating-point value as a JavaScript number.
+ */
 declare function fromMoveFloat(float: MoveFloat): number;
+/**
+ * Decodes `BetResultEvent.game_details` into plain application values.
+ *
+ * Suigar stores game detail entries as `VecMap<string, vector<u8>>`, so raw BCS
+ * decoding leaves each value as bytes. This helper looks up the known schema for
+ * each key, parses the bytes into the expected runtime type, and preserves the
+ * original onchain keys in the returned object. Unknown keys fall back to
+ * string decoding so newer detail fields remain readable by default.
+ *
+ * @param gameDetails Raw `game_details` map from a decoded bet result event.
+ * @returns A plain object with the same keys and decoded string, number, or boolean values.
+ */
 declare function parseGameDetails(gameDetails: BetResultGameDetails): ParsedGameDetails;
 
 export { DEFAULT_GAS_BUDGET_MIST, DEFAULT_LIMBO_MULTIPLIER_SCALE, DEFAULT_RANGE_SCALE, RANGE_POINT_LIMIT, fromMoveFloat, fromMoveI64, parseGameDetails, toBigInt, toU8 };

package/dist/utils.js

@@ -1 +1 @@
-export { DEFAULT_GAS_BUDGET_MIST, DEFAULT_LIMBO_MULTIPLIER_SCALE, DEFAULT_RANGE_SCALE, RANGE_POINT_LIMIT, fromMoveFloat, fromMoveI64, parseGameDetails, toBigInt, toU8 } from './chunk-YGYMLRE4.js';
+export { DEFAULT_GAS_BUDGET_MIST, DEFAULT_LIMBO_MULTIPLIER_SCALE, DEFAULT_RANGE_SCALE, RANGE_POINT_LIMIT, fromMoveFloat, fromMoveI64, parseGameDetails, toBigInt, toU8 } from './chunk-FEQY5O43.js';

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@suigar/sdk",
-	"version": "2.0.0-beta.7",
+	"version": "2.0.0-beta.9",
 	"description": "TypeScript SDK for Suigar v2 Move contracts on Sui.",
 	"keywords": [
 		"suigar",
@@ -46,18 +46,17 @@
 		"build": "npm run clean && npm run codegen && tsup",
 		"build:ci": "rm -rf dist && tsup",
 		"clean": "rm -rf dist src/contracts .vitest-cache",
-		"codegen": "sui-ts-codegen generate",
+		"codegen": "node ./scripts/update-package-configs.mjs && sui-ts-codegen generate",
 		"changeset": "changeset",
 		"changeset:beta:enter": "changeset pre enter beta",
 		"changeset:beta:exit": "changeset pre exit",
+		"changeset:version": "changeset version",
 		"format": "prettier --write .",
 		"lint": "eslint . --fix && npm run format",
 		"prepare": "husky",
 		"release": "changeset publish",
 		"test": "vitest run",
-		"typecheck": "tsc --noEmit",
-		"update:package-configs": "node ./scripts/update-package-configs.mjs",
-		"version-packages": "changeset version"
+		"typecheck": "tsc --noEmit"
 	},
 	"repository": {
 		"type": "git",
@@ -78,7 +77,7 @@
 		"@changesets/cli": "^2.31.0",
 		"@eslint/js": "^10.0.1",
 		"@mysten/bcs": "^2.0.3",
-		"@mysten/codegen": "^0.9.0",
+		"@mysten/codegen": "^0.10.0",
 		"@mysten/sui": "^2.16.0",
 		"@types/node": "^24.0.0",
 		"eslint": "^10.2.1",
@@ -89,7 +88,7 @@
 		"tsup": "^8.5.1",
 		"tsx": "^4.21.0",
 		"typescript": "^5.9.3",
-		"typescript-eslint": "^8.59.0",
+		"typescript-eslint": "^8.59.1",
 		"vitest": "^4.1.5"
 	}
 }