@suigar/sdk 2.0.0-beta.10 → 2.0.0-beta.12

package/dist/utils.d.cts

@@ -62,30 +62,62 @@ declare const RANGE_POINT_LIMIT: number;
 declare const DEFAULT_LIMBO_MULTIPLIER_SCALE = 100;
 
 /**
- * Normalizes a numeric input into a non-negative `bigint`.
+ * Normalizes a value 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`.
+ * Accepted inputs:
+ * - `bigint`
+ * - finite `number`
+ * - base-10 integer `string`
+ * - `boolean`
  *
- * @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.
+ * Number inputs are truncated toward zero before conversion, so `5.9` becomes
+ * `5n`. String and boolean inputs are parsed through the native
+ * `BigInt(...)` constructor, so `true` becomes `1n`, `false` becomes `0n`,
+ * and only integer strings are accepted.
+ *
+ * @param value Value to normalize.
+ * @returns A non-negative `bigint`.
+ * @throws When `value` is not a bigint, finite number, integer string, or
+ * boolean.
+ * @throws When the normalized value is negative.
  */
 declare function toBigInt(value: unknown): bigint;
 /**
- * Validates that a value can be safely used as a Move `u8`.
+ * Validates that a value can be safely used as a Move `u8` in the `0..255`
+ * range.
+ *
+ * Accepted inputs:
+ * - finite `number`
+ * - base-10 integer `string`
  *
- * 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.
+ * String inputs are accepted for parsed values such as `'1'`, but only when
+ * they are plain non-negative integer strings. This helper does not accept
+ * booleans and does not truncate fractional values.
  *
  * @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`.
+ * @returns The validated `u8` value as a JavaScript `number`.
+ * @throws When `value` is not a finite number or integer string.
+ * @throws When `value` is not an integer between `0` and `255`.
  */
 declare function toU8(value: unknown): number;
+/**
+ * Validates that a value can be safely used as a Move `u16` in the
+ * `0..65535` range.
+ *
+ * Accepted inputs:
+ * - finite `number`
+ * - base-10 integer `string`
+ *
+ * String inputs are accepted for parsed values such as `'1'`, but only when
+ * they are plain non-negative integer strings. This helper does not accept
+ * booleans and does not truncate fractional values.
+ *
+ * @param value Value to validate.
+ * @returns The validated `u16` value as a JavaScript `number`.
+ * @throws When `value` is not a finite number or integer string.
+ * @throws When `value` is not an integer between `0` and `65535`.
+ */
+declare function toU16(value: unknown): number;
 
 declare const Float: MoveStruct<{
     is_negative: _mysten_bcs.BcsType<boolean, boolean, "bool">;
@@ -145,4 +177,4 @@ declare function parseCoinType(type: string): string;
  */
 declare function parseGameDetails(gameDetails: BetResultGameDetails): ParsedGameDetails;
 
-export { DEFAULT_GAS_BUDGET_MIST, DEFAULT_LIMBO_MULTIPLIER_SCALE, DEFAULT_RANGE_SCALE, RANGE_POINT_LIMIT, fromMoveFloat, fromMoveI64, parseCoinType, parseGameDetails, toBigInt, toU8 };
+export { DEFAULT_GAS_BUDGET_MIST, DEFAULT_LIMBO_MULTIPLIER_SCALE, DEFAULT_RANGE_SCALE, RANGE_POINT_LIMIT, fromMoveFloat, fromMoveI64, parseCoinType, parseGameDetails, toBigInt, toU16, toU8 };

package/dist/utils.d.ts

@@ -62,30 +62,62 @@ declare const RANGE_POINT_LIMIT: number;
 declare const DEFAULT_LIMBO_MULTIPLIER_SCALE = 100;
 
 /**
- * Normalizes a numeric input into a non-negative `bigint`.
+ * Normalizes a value 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`.
+ * Accepted inputs:
+ * - `bigint`
+ * - finite `number`
+ * - base-10 integer `string`
+ * - `boolean`
  *
- * @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.
+ * Number inputs are truncated toward zero before conversion, so `5.9` becomes
+ * `5n`. String and boolean inputs are parsed through the native
+ * `BigInt(...)` constructor, so `true` becomes `1n`, `false` becomes `0n`,
+ * and only integer strings are accepted.
+ *
+ * @param value Value to normalize.
+ * @returns A non-negative `bigint`.
+ * @throws When `value` is not a bigint, finite number, integer string, or
+ * boolean.
+ * @throws When the normalized value is negative.
  */
 declare function toBigInt(value: unknown): bigint;
 /**
- * Validates that a value can be safely used as a Move `u8`.
+ * Validates that a value can be safely used as a Move `u8` in the `0..255`
+ * range.
+ *
+ * Accepted inputs:
+ * - finite `number`
+ * - base-10 integer `string`
  *
- * 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.
+ * String inputs are accepted for parsed values such as `'1'`, but only when
+ * they are plain non-negative integer strings. This helper does not accept
+ * booleans and does not truncate fractional values.
  *
  * @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`.
+ * @returns The validated `u8` value as a JavaScript `number`.
+ * @throws When `value` is not a finite number or integer string.
+ * @throws When `value` is not an integer between `0` and `255`.
  */
 declare function toU8(value: unknown): number;
+/**
+ * Validates that a value can be safely used as a Move `u16` in the
+ * `0..65535` range.
+ *
+ * Accepted inputs:
+ * - finite `number`
+ * - base-10 integer `string`
+ *
+ * String inputs are accepted for parsed values such as `'1'`, but only when
+ * they are plain non-negative integer strings. This helper does not accept
+ * booleans and does not truncate fractional values.
+ *
+ * @param value Value to validate.
+ * @returns The validated `u16` value as a JavaScript `number`.
+ * @throws When `value` is not a finite number or integer string.
+ * @throws When `value` is not an integer between `0` and `65535`.
+ */
+declare function toU16(value: unknown): number;
 
 declare const Float: MoveStruct<{
     is_negative: _mysten_bcs.BcsType<boolean, boolean, "bool">;
@@ -145,4 +177,4 @@ declare function parseCoinType(type: string): string;
  */
 declare function parseGameDetails(gameDetails: BetResultGameDetails): ParsedGameDetails;
 
-export { DEFAULT_GAS_BUDGET_MIST, DEFAULT_LIMBO_MULTIPLIER_SCALE, DEFAULT_RANGE_SCALE, RANGE_POINT_LIMIT, fromMoveFloat, fromMoveI64, parseCoinType, parseGameDetails, toBigInt, toU8 };
+export { DEFAULT_GAS_BUDGET_MIST, DEFAULT_LIMBO_MULTIPLIER_SCALE, DEFAULT_RANGE_SCALE, RANGE_POINT_LIMIT, fromMoveFloat, fromMoveI64, parseCoinType, parseGameDetails, toBigInt, toU16, toU8 };

package/dist/utils.js

@@ -1 +1 @@
-export { DEFAULT_GAS_BUDGET_MIST, DEFAULT_LIMBO_MULTIPLIER_SCALE, DEFAULT_RANGE_SCALE, RANGE_POINT_LIMIT, fromMoveFloat, fromMoveI64, parseCoinType, parseGameDetails, toBigInt, toU8 } from './chunk-PPUDLRHA.js';
+export { DEFAULT_GAS_BUDGET_MIST, DEFAULT_LIMBO_MULTIPLIER_SCALE, DEFAULT_RANGE_SCALE, RANGE_POINT_LIMIT, fromMoveFloat, fromMoveI64, parseCoinType, parseGameDetails, toBigInt, toU16, toU8 } from './chunk-7N55D2TV.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@suigar/sdk",
-  "version": "2.0.0-beta.10",
+  "version": "2.0.0-beta.12",
   "description": "TypeScript SDK for Suigar v2 Move contracts on Sui.",
   "keywords": [
     "suigar",
@@ -68,13 +68,13 @@
     "vitest": "^4.1.5"
   },
   "scripts": {
-    "build": "pnpm run clean && pnpm run codegen && tsup",
+    "build": "pnpm clean && pnpm codegen && tsup",
     "build:ci": "rm -rf dist && tsup",
     "clean": "rm -rf dist src/contracts .vitest-cache",
-    "codegen": "node ./scripts/update-package-configs.mjs && sui-ts-codegen generate && pnpm run lint",
+    "codegen": "node ./scripts/update-package-configs.mjs && sui-ts-codegen generate && pnpm lint",
     "eslint:fix": "eslint . --fix",
-    "format": "pnpm run prettier:fix",
-    "lint": "pnpm run eslint:fix && pnpm run prettier:fix",
+    "format": "pnpm prettier:fix",
+    "lint": "pnpm eslint:fix && pnpm prettier:fix",
     "prettier:fix": "prettier --write --ignore-unknown .",
     "test": "vitest run",
     "typecheck": "tsc --noEmit"