@suigar/sdk 2.0.0-beta.6 → 2.0.0-beta.8

package/dist/utils.cjs

@@ -11,21 +11,34 @@ var RANGE_POINT_LIMIT = DEFAULT_RANGE_SCALE * 100;
 var DEFAULT_LIMBO_MULTIPLIER_SCALE = 100;
 
 // src/utils/numeric.ts
-function toBigIntAmount(value, fieldName) {
+function isFiniteNumber(value, message) {
+  if (typeof value !== "number") {
+    throw new Error(`${message}: ${String(value)}`);
+  }
+  if (!Number.isFinite(value)) {
+    throw new Error(`Value must be a finite number: ${value}`);
+  }
+}
+function toBigInt(value) {
   if (typeof value === "bigint") {
     if (value < 0n) {
-      throw new Error(`${fieldName} must be non-negative`);
+      throw new Error(`Value must be non-negative: ${value}`);
     }
     return value;
   }
-  if (!Number.isFinite(value) || value < 0) {
-    throw new Error(`${fieldName} must be a finite non-negative number`);
+  isFiniteNumber(value, "Value must be a bigint or number");
+  if (value < 0) {
+    throw new Error(`Value must be a finite non-negative number: ${value}`);
   }
   return BigInt(Math.trunc(value));
 }
-function toU8Number(value, fieldName) {
-  if (!Number.isInteger(value) || value < 0 || value > 255) {
-    throw new Error(`${fieldName} must be an integer between 0 and 255`);
+function toU8(value) {
+  isFiniteNumber(value, "Value must be a number");
+  if (!Number.isInteger(value)) {
+    throw new Error(`Value must be an integer: ${value}`);
+  }
+  if (value < 0 || value > 255) {
+    throw new Error(`Value must be an integer between 0 and 255: ${value}`);
   }
   return value;
 }
@@ -145,7 +158,7 @@ var GAME_DETAIL_BCS = {
   float: Float,
   string: bcsString
 };
-function parseI64(i64) {
+function fromMoveI64(i64) {
   try {
     const value = BigInt(i64.bits ?? 0);
     const maxPositive = 1n << 63n;
@@ -156,18 +169,18 @@ function parseI64(i64) {
     return 0;
   }
 }
-function parseFloat(float) {
+function fromMoveFloat(float) {
   const mantissa = BigInt(float.mant);
   if (mantissa === 0n) {
     return 0;
   }
-  const exponent = parseI64(float.exp) - 52;
+  const exponent = fromMoveI64(float.exp) - 52;
   const magnitude = Number(mantissa) * Math.pow(2, exponent);
   return float.is_negative ? -magnitude : magnitude;
 }
 function normalizeGameDetailValue(valueType, parsed) {
   if (valueType === "float") {
-    return parseFloat(parsed);
+    return fromMoveFloat(parsed);
   }
   if (valueType === "u64") {
     return Number(parsed);
@@ -201,8 +214,8 @@ exports.DEFAULT_GAS_BUDGET_MIST = DEFAULT_GAS_BUDGET_MIST;
 exports.DEFAULT_LIMBO_MULTIPLIER_SCALE = DEFAULT_LIMBO_MULTIPLIER_SCALE;
 exports.DEFAULT_RANGE_SCALE = DEFAULT_RANGE_SCALE;
 exports.RANGE_POINT_LIMIT = RANGE_POINT_LIMIT;
-exports.parseFloat = parseFloat;
+exports.fromMoveFloat = fromMoveFloat;
+exports.fromMoveI64 = fromMoveI64;
 exports.parseGameDetails = parseGameDetails;
-exports.parseI64 = parseI64;
-exports.toBigIntAmount = toBigIntAmount;
-exports.toU8Number = toU8Number;
+exports.toBigInt = toBigInt;
+exports.toU8 = toU8;

package/dist/utils.d.cts

@@ -61,8 +61,31 @@ declare const DEFAULT_RANGE_SCALE = 1000000;
 declare const RANGE_POINT_LIMIT: number;
 declare const DEFAULT_LIMBO_MULTIPLIER_SCALE = 100;
 
-declare function toBigIntAmount(value: bigint | number, fieldName: string): bigint;
-declare function toU8Number(value: number, fieldName: string): number;
+/**
+ * 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<{
     is_negative: _mysten_bcs.BcsType<boolean, boolean, "bool">;
@@ -72,8 +95,21 @@ declare const Float: MoveStruct<{
     mant: _mysten_bcs.BcsType<string, string | number | bigint, "u64">;
 }, "0xf391858d2a08473e8d4defcc8df89976bd7b123d3865c6b9341b237f7853dbbc::float::Float">;
 
-declare function parseI64(i64: ReturnType<(typeof Float)['parse']>['exp']): number;
-declare function parseFloat(float: ReturnType<(typeof Float)['parse']>): number;
+type MoveFloat = ReturnType<(typeof Float)['parse']>;
+declare function fromMoveI64(i64: MoveFloat['exp']): 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, parseFloat, parseGameDetails, parseI64, toBigIntAmount, toU8Number };
+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

@@ -61,8 +61,31 @@ declare const DEFAULT_RANGE_SCALE = 1000000;
 declare const RANGE_POINT_LIMIT: number;
 declare const DEFAULT_LIMBO_MULTIPLIER_SCALE = 100;
 
-declare function toBigIntAmount(value: bigint | number, fieldName: string): bigint;
-declare function toU8Number(value: number, fieldName: string): number;
+/**
+ * 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<{
     is_negative: _mysten_bcs.BcsType<boolean, boolean, "bool">;
@@ -72,8 +95,21 @@ declare const Float: MoveStruct<{
     mant: _mysten_bcs.BcsType<string, string | number | bigint, "u64">;
 }, "0xf391858d2a08473e8d4defcc8df89976bd7b123d3865c6b9341b237f7853dbbc::float::Float">;
 
-declare function parseI64(i64: ReturnType<(typeof Float)['parse']>['exp']): number;
-declare function parseFloat(float: ReturnType<(typeof Float)['parse']>): number;
+type MoveFloat = ReturnType<(typeof Float)['parse']>;
+declare function fromMoveI64(i64: MoveFloat['exp']): 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, parseFloat, parseGameDetails, parseI64, toBigIntAmount, toU8Number };
+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, parseFloat, parseGameDetails, parseI64, toBigIntAmount, toU8Number } from './chunk-W3WZ2BHO.js';
+export { DEFAULT_GAS_BUDGET_MIST, DEFAULT_LIMBO_MULTIPLIER_SCALE, DEFAULT_RANGE_SCALE, RANGE_POINT_LIMIT, fromMoveFloat, fromMoveI64, parseGameDetails, toBigInt, toU8 } from './chunk-YGYMLRE4.js';

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@suigar/sdk",
-	"version": "2.0.0-beta.6",
+	"version": "2.0.0-beta.8",
 	"description": "TypeScript SDK for Suigar v2 Move contracts on Sui.",
 	"keywords": [
 		"suigar",
@@ -91,20 +91,5 @@
 		"typescript": "^5.9.3",
 		"typescript-eslint": "^8.59.0",
 		"vitest": "^4.1.5"
-	},
-	"lint-staged": {
-		"{src,test,scripts}/**/*.{ts,tsx,js,mjs,cjs}": [
-			"eslint --fix",
-			"prettier --write"
-		],
-		"./*.{ts,tsx,js,mjs,cjs}": [
-			"eslint --fix",
-			"prettier --write"
-		],
-		"examples/game-integration/**/*.{ts,tsx,js,mjs,cjs}": [
-			"npm --prefix examples/game-integration exec eslint -- --fix",
-			"prettier --write"
-		],
-		"*.{json,md,yml,yaml}": "prettier --write"
 	}
 }