@suigar/sdk 2.0.0-beta.13 → 2.0.0-beta.15

package/dist/utils/numeric.mjs

@@ -0,0 +1,148 @@
+//#region src/utils/numeric.ts
+/**
+* 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.
+*/
+function fromMoveI64(i64) {
+	try {
+		return Number(BigInt.asIntN(64, BigInt(i64.bits ?? 0)));
+	} catch {
+		return 0;
+	}
+}
+/**
+* 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 on-chain 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.
+*/
+function fromMoveFloat(float) {
+	const mantissa = BigInt(float.mant ?? 0);
+	if (mantissa === 0n) return 0;
+	const exponent = fromMoveI64(float.exp) - 52;
+	const magnitude = Number(mantissa) * 2 ** exponent;
+	return float.is_negative ? -magnitude : magnitude;
+}
+/**
+* Ensures a value is a finite JavaScript number.
+*
+* This is only used for helpers that accept raw `number` input before applying
+* additional integer or range validation.
+*/
+function assertFiniteNumber(value, errorMessage) {
+	if (typeof value !== "number" || !Number.isFinite(value)) throw new TypeError(`${errorMessage}: ${String(value)}`);
+}
+/**
+* Normalizes a value into a non-negative `bigint`.
+*
+* Accepted inputs:
+* - `bigint`
+* - finite `number`
+* - base-10 integer `string`
+* - `boolean`
+*
+* 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.
+*/
+function toBigInt(value) {
+	let result;
+	try {
+		if (typeof value === "bigint" || typeof value === "string" || typeof value === "boolean") result = BigInt(value);
+		else {
+			assertFiniteNumber(value, "Value must be a bigint, number, integer string, or boolean");
+			result = BigInt(Math.trunc(value));
+		}
+	} catch {
+		throw new TypeError(`Value must be a bigint, number, integer string, or boolean: ${value}`);
+	}
+	if (result < 0n) throw new RangeError(`Value must be non-negative: ${value}`);
+	return result;
+}
+/**
+* Validates and normalizes a bounded unsigned integer.
+*
+* Accepted inputs:
+* - finite `number`
+* - base-10 integer `string`
+*
+* This internal helper powers the public `toU8()` and `toU16()` helpers. It
+* accepts stringified integers such as `'1'` for parsed values, but rejects
+* booleans, empty strings, fractional values, and out-of-range numbers.
+*
+* @param value Value to validate.
+* @param max Inclusive upper bound.
+* @param typeName Move integer label used in error messages.
+* @returns The validated integer 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 `max`.
+*/
+function toBoundedInt(value, max, typeName) {
+	const num = typeof value === "string" && value.trim() === "" ? NaN : Number(value);
+	assertFiniteNumber(num, "Value must be a finite number or integer string");
+	if (typeof value === "boolean" || value == null || !Number.isInteger(num) || num < 0 || num > max) throw new RangeError(`Value must be a ${typeName} integer (0-${max}): ${value}`);
+	return num;
+}
+/**
+* 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`
+*
+* 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 `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`.
+*/
+function toU8(value) {
+	return toBoundedInt(value, 255, "u8");
+}
+/**
+* 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`.
+*/
+function toU16(value) {
+	return toBoundedInt(value, 65535, "u16");
+}
+//#endregion
+export { fromMoveFloat, fromMoveI64, toBigInt, toU16, toU8 };
+
+//# sourceMappingURL=numeric.mjs.map

package/dist/utils/numeric.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"numeric.mjs","names":[],"sources":["../../src/utils/numeric.ts"],"sourcesContent":["// Copyright (c) Suigar\n// SPDX-License-Identifier: Apache-2.0\n\nimport { MoveFloat } from '../types';\n\n/**\n * Converts a generated Move `i64` wrapper into a JavaScript number.\n *\n * The generated bindings expose signed 64-bit integers through a `{ bits }`\n * field that stores the raw two's-complement bit pattern. This helper\n * reinterprets those bits as a signed `i64` and returns a plain JS number.\n * Invalid or missing input falls back to `0`.\n *\n * @param i64 Generated Move `i64` value, typically used for float exponents.\n * @returns The signed 64-bit value as a JavaScript number.\n */\nexport function fromMoveI64(i64: MoveFloat['exp']): number {\n\ttry {\n\t\treturn Number(BigInt.asIntN(64, BigInt(i64.bits ?? 0)));\n\t} catch {\n\t\treturn 0;\n\t}\n}\n\n/**\n * Converts a generated Move `Float` struct into a JavaScript number.\n *\n * Suigar float values are represented as a sign flag, an unsigned mantissa,\n * and a Move `i64` exponent. This helper rebuilds the numeric value using the\n * same normalization expected by the on-chain format and applies the sign at\n * the end. Missing mantissas are treated as `0`, and a zero mantissa returns `0`.\n *\n * @param float Generated Move float value with `mant`, `exp`, and `is_negative`.\n * @returns The decoded floating-point value as a JavaScript number.\n */\nexport function fromMoveFloat(float: MoveFloat): number {\n\tconst mantissa = BigInt(float.mant ?? 0);\n\tif (mantissa === 0n) {\n\t\treturn 0;\n\t}\n\tconst exponent = fromMoveI64(float.exp) - 52;\n\tconst magnitude = Number(mantissa) * 2 ** exponent;\n\treturn float.is_negative ? -magnitude : magnitude;\n}\n\n/**\n * Ensures a value is a finite JavaScript number.\n *\n * This is only used for helpers that accept raw `number` input before applying\n * additional integer or range validation.\n */\nfunction assertFiniteNumber(\n\tvalue: unknown,\n\terrorMessage: string,\n): asserts value is number {\n\tif (typeof value !== 'number' || !Number.isFinite(value)) {\n\t\tthrow new TypeError(`${errorMessage}: ${String(value)}`);\n\t}\n}\n\n/**\n * Normalizes a value into a non-negative `bigint`.\n *\n * Accepted inputs:\n * - `bigint`\n * - finite `number`\n * - base-10 integer `string`\n * - `boolean`\n *\n * Number inputs are truncated toward zero before conversion, so `5.9` becomes\n * `5n`. String and boolean inputs are parsed through the native\n * `BigInt(...)` constructor, so `true` becomes `1n`, `false` becomes `0n`,\n * and only integer strings are accepted.\n *\n * @param value Value to normalize.\n * @returns A non-negative `bigint`.\n * @throws When `value` is not a bigint, finite number, integer string, or\n * boolean.\n * @throws When the normalized value is negative.\n */\nexport function toBigInt(value: unknown): bigint {\n\tlet result: bigint;\n\n\ttry {\n\t\tif (\n\t\t\ttypeof value === 'bigint' ||\n\t\t\ttypeof value === 'string' ||\n\t\t\ttypeof value === 'boolean'\n\t\t) {\n\t\t\tresult = BigInt(value);\n\t\t} else {\n\t\t\tassertFiniteNumber(\n\t\t\t\tvalue,\n\t\t\t\t'Value must be a bigint, number, integer string, or boolean',\n\t\t\t);\n\t\t\tresult = BigInt(Math.trunc(value));\n\t\t}\n\t} catch {\n\t\tthrow new TypeError(\n\t\t\t`Value must be a bigint, number, integer string, or boolean: ${value}`,\n\t\t);\n\t}\n\n\tif (result < 0n) {\n\t\tthrow new RangeError(`Value must be non-negative: ${value}`);\n\t}\n\n\treturn result;\n}\n\n/**\n * Validates and normalizes a bounded unsigned integer.\n *\n * Accepted inputs:\n * - finite `number`\n * - base-10 integer `string`\n *\n * This internal helper powers the public `toU8()` and `toU16()` helpers. It\n * accepts stringified integers such as `'1'` for parsed values, but rejects\n * booleans, empty strings, fractional values, and out-of-range numbers.\n *\n * @param value Value to validate.\n * @param max Inclusive upper bound.\n * @param typeName Move integer label used in error messages.\n * @returns The validated integer as a JavaScript `number`.\n * @throws When `value` is not a finite number or integer string.\n * @throws When `value` is not an integer between `0` and `max`.\n */\nfunction toBoundedInt(value: unknown, max: number, typeName: string): number {\n\tconst num =\n\t\ttypeof value === 'string' && value.trim() === '' ? NaN : Number(value);\n\n\tassertFiniteNumber(num, 'Value must be a finite number or integer string');\n\tif (\n\t\ttypeof value === 'boolean' ||\n\t\tvalue == null ||\n\t\t!Number.isInteger(num) ||\n\t\tnum < 0 ||\n\t\tnum > max\n\t) {\n\t\tthrow new RangeError(\n\t\t\t`Value must be a ${typeName} integer (0-${max}): ${value}`,\n\t\t);\n\t}\n\n\treturn num;\n}\n\n/**\n * Validates that a value can be safely used as a Move `u8` in the `0..255`\n * range.\n *\n * Accepted inputs:\n * - finite `number`\n * - base-10 integer `string`\n *\n * String inputs are accepted for parsed values such as `'1'`, but only when\n * they are plain non-negative integer strings. This helper does not accept\n * booleans and does not truncate fractional values.\n *\n * @param value Value to validate.\n * @returns The validated `u8` value as a JavaScript `number`.\n * @throws When `value` is not a finite number or integer string.\n * @throws When `value` is not an integer between `0` and `255`.\n */\nexport function toU8(value: unknown): number {\n\treturn toBoundedInt(value, 255, 'u8');\n}\n\n/**\n * Validates that a value can be safely used as a Move `u16` in the\n * `0..65535` range.\n *\n * Accepted inputs:\n * - finite `number`\n * - base-10 integer `string`\n *\n * String inputs are accepted for parsed values such as `'1'`, but only when\n * they are plain non-negative integer strings. This helper does not accept\n * booleans and does not truncate fractional values.\n *\n * @param value Value to validate.\n * @returns The validated `u16` value as a JavaScript `number`.\n * @throws When `value` is not a finite number or integer string.\n * @throws When `value` is not an integer between `0` and `65535`.\n */\nexport function toU16(value: unknown): number {\n\treturn toBoundedInt(value, 65535, 'u16');\n}\n"],"mappings":";;;;;;;;;;;;AAgBA,SAAgB,YAAY,KAA+B;CAC1D,IAAI;EACH,OAAO,OAAO,OAAO,OAAO,IAAI,OAAO,IAAI,QAAQ,EAAE,CAAC,CAAC;SAChD;EACP,OAAO;;;;;;;;;;;;;;AAeT,SAAgB,cAAc,OAA0B;CACvD,MAAM,WAAW,OAAO,MAAM,QAAQ,EAAE;CACxC,IAAI,aAAa,IAChB,OAAO;CAER,MAAM,WAAW,YAAY,MAAM,IAAI,GAAG;CAC1C,MAAM,YAAY,OAAO,SAAS,GAAG,KAAK;CAC1C,OAAO,MAAM,cAAc,CAAC,YAAY;;;;;;;;AASzC,SAAS,mBACR,OACA,cAC0B;CAC1B,IAAI,OAAO,UAAU,YAAY,CAAC,OAAO,SAAS,MAAM,EACvD,MAAM,IAAI,UAAU,GAAG,aAAa,IAAI,OAAO,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;AAwB1D,SAAgB,SAAS,OAAwB;CAChD,IAAI;CAEJ,IAAI;EACH,IACC,OAAO,UAAU,YACjB,OAAO,UAAU,YACjB,OAAO,UAAU,WAEjB,SAAS,OAAO,MAAM;OAChB;GACN,mBACC,OACA,6DACA;GACD,SAAS,OAAO,KAAK,MAAM,MAAM,CAAC;;SAE5B;EACP,MAAM,IAAI,UACT,+DAA+D,QAC/D;;CAGF,IAAI,SAAS,IACZ,MAAM,IAAI,WAAW,+BAA+B,QAAQ;CAG7D,OAAO;;;;;;;;;;;;;;;;;;;;AAqBR,SAAS,aAAa,OAAgB,KAAa,UAA0B;CAC5E,MAAM,MACL,OAAO,UAAU,YAAY,MAAM,MAAM,KAAK,KAAK,MAAM,OAAO,MAAM;CAEvE,mBAAmB,KAAK,kDAAkD;CAC1E,IACC,OAAO,UAAU,aACjB,SAAS,QACT,CAAC,OAAO,UAAU,IAAI,IACtB,MAAM,KACN,MAAM,KAEN,MAAM,IAAI,WACT,mBAAmB,SAAS,cAAc,IAAI,KAAK,QACnD;CAGF,OAAO;;;;;;;;;;;;;;;;;;;AAoBR,SAAgB,KAAK,OAAwB;CAC5C,OAAO,aAAa,OAAO,KAAK,KAAK;;;;;;;;;;;;;;;;;;;AAoBtC,SAAgB,MAAM,OAAwB;CAC7C,OAAO,aAAa,OAAO,OAAO,MAAM"}

package/dist/utils/parser.d.mts

@@ -0,0 +1,54 @@
+import { Game, SuigarGameEvent } from "../types/game.type.mjs";
+import { BetResultGameDetails, GameDetails } from "../types/game-details.type.mjs";
+import { SuiClientTypes } from "@mysten/sui/client";
+
+//#region src/utils/parser.d.ts
+/**
+ * Extracts and normalizes the first generic coin type from a Move object type.
+ *
+ * PvP Coinflip game object types encode the wager coin as their first type parameter,
+ * for example `Game<0x2::sui::SUI>`. This helper converts that generic type
+ * argument into the SDK's canonical struct tag string.
+ *
+ * @param type Fully qualified Move object type with the coin type as its first generic argument.
+ * @returns Normalized coin type struct tag.
+ */
+declare function parseCoinType(type: string): string;
+/**
+ * Resolves a supported Suigar event into its normalized SDK game id and event name.
+ *
+ * This helper recognizes all supported Suigar event names in `GAME_EVENTS`.
+ * Standard `BetResultEvent` payloads encode the game family through the core
+ * client event module or generic type parameter, while PvP coinflip events
+ * resolve to the `pvp-coinflip` game id from their `pvp_coinflip` module.
+ *
+ * @param event Sui event returned by the core client.
+ * @returns Parsed SDK game id and raw Move event name, or `null` when the event
+ * name is unsupported or the game id cannot be resolved.
+ */
+declare function parseGameEvent(event: SuiClientTypes.Event): SuigarGameEvent | null;
+/**
+ * Decodes `BetResultEvent.game_details` into plain application values.
+ *
+ * Use this only with the `game_details` field from a decoded `BetResultEvent`.
+ * Suigar stores those entries as `VecMap<string, vector<u8>>`, so raw BCS
+ * decoding leaves each value as bytes. This helper uses the provided `gameId`
+ * to narrow the known detail schema, parses each byte array into the expected
+ * runtime type, and preserves the original on-chain keys in the returned
+ * object. Unknown keys fall back to string decoding so newer detail fields
+ * remain readable by default.
+ *
+ * Call `parseGameEvent(event)` first when you need to derive the matching
+ * `gameId` from the raw `SuiClientTypes.Event` before decoding
+ * `decoded.game_details`.
+ *
+ * @param gameId Suigar game id used to narrow the known detail keys and value
+ * types for this bet result payload.
+ * @param gameDetails Raw `game_details` map from a decoded `BetResultEvent`.
+ * @returns A plain object with decoded values for the known keys of the
+ * selected game.
+ */
+declare function parseGameDetails<TGame extends Game>(gameId: TGame, gameDetails: BetResultGameDetails): GameDetails<TGame>;
+//#endregion
+export { parseCoinType, parseGameDetails, parseGameEvent };
+//# sourceMappingURL=parser.d.mts.map

package/dist/utils/parser.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.mts","names":[],"sources":["../../src/utils/parser.ts"],"mappings":";;;;;;;;;AAkCA;;;;;AAqBA;iBArBgB,aAAA,CAAc,IAAA;;;;;;;;;AA4F9B;;;;iBAvEgB,cAAA,CACf,KAAA,EAAO,cAAA,CAAe,KAAA,GACpB,eAAA;;;;;;;;;;;;;;;;;;;;;;iBAqEa,gBAAA,eAA+B,IAAA,CAAA,CAC9C,MAAA,EAAQ,KAAA,EACR,WAAA,EAAa,oBAAA,GACX,WAAA,CAAY,KAAA"}

package/dist/utils/parser.mjs

@@ -0,0 +1,94 @@
+import { fromMoveFloat } from "./numeric.mjs";
+import { GAME_DETAILS_SCHEMAS, GAME_DETAIL_BCS } from "../types/game-details.type.mjs";
+import { GAMES, GAME_EVENTS } from "../types/game.type.mjs";
+import { normalizeStructTag, parseStructTag } from "@mysten/sui/utils";
+import { bcs } from "@mysten/sui/bcs";
+//#region src/utils/parser.ts
+const textDecoder = new TextDecoder();
+/**
+* Extracts and normalizes the first generic coin type from a Move object type.
+*
+* PvP Coinflip game object types encode the wager coin as their first type parameter,
+* for example `Game<0x2::sui::SUI>`. This helper converts that generic type
+* argument into the SDK's canonical struct tag string.
+*
+* @param type Fully qualified Move object type with the coin type as its first generic argument.
+* @returns Normalized coin type struct tag.
+*/
+function parseCoinType(type) {
+	const coinType = parseStructTag(type).typeParams[0];
+	if (!coinType) throw new TypeError(`Unable to parse coin type from ${type}`);
+	return normalizeStructTag(coinType);
+}
+/**
+* Resolves a supported Suigar event into its normalized SDK game id and event name.
+*
+* This helper recognizes all supported Suigar event names in `GAME_EVENTS`.
+* Standard `BetResultEvent` payloads encode the game family through the core
+* client event module or generic type parameter, while PvP coinflip events
+* resolve to the `pvp-coinflip` game id from their `pvp_coinflip` module.
+*
+* @param event Sui event returned by the core client.
+* @returns Parsed SDK game id and raw Move event name, or `null` when the event
+* name is unsupported or the game id cannot be resolved.
+*/
+function parseGameEvent(event) {
+	const { name: eventName, typeParams } = parseStructTag(event.eventType);
+	const module = event.module.replaceAll("_", "-");
+	const gameId = GAMES.includes(module) ? module : typeParams[0];
+	if (!GAME_EVENTS.includes(eventName) || typeof gameId !== "string") return null;
+	return {
+		gameId,
+		eventName
+	};
+}
+function parseStringGameDetail(value) {
+	const bytes = Uint8Array.from(value);
+	try {
+		return bcs.String.parse(bytes);
+	} catch {
+		return textDecoder.decode(bytes);
+	}
+}
+function parseGameDetail(valueType, value) {
+	if (valueType === "string") return parseStringGameDetail(value);
+	const parsed = GAME_DETAIL_BCS[valueType].parse(Uint8Array.from(value));
+	switch (valueType) {
+		case "float": return fromMoveFloat(parsed);
+		case "u64": return Number(parsed);
+		default: return parsed;
+	}
+}
+/**
+* Decodes `BetResultEvent.game_details` into plain application values.
+*
+* Use this only with the `game_details` field from a decoded `BetResultEvent`.
+* Suigar stores those entries as `VecMap<string, vector<u8>>`, so raw BCS
+* decoding leaves each value as bytes. This helper uses the provided `gameId`
+* to narrow the known detail schema, parses each byte array into the expected
+* runtime type, and preserves the original on-chain keys in the returned
+* object. Unknown keys fall back to string decoding so newer detail fields
+* remain readable by default.
+*
+* Call `parseGameEvent(event)` first when you need to derive the matching
+* `gameId` from the raw `SuiClientTypes.Event` before decoding
+* `decoded.game_details`.
+*
+* @param gameId Suigar game id used to narrow the known detail keys and value
+* types for this bet result payload.
+* @param gameDetails Raw `game_details` map from a decoded `BetResultEvent`.
+* @returns A plain object with decoded values for the known keys of the
+* selected game.
+*/
+function parseGameDetails(gameId, gameDetails) {
+	const schema = GAME_DETAILS_SCHEMAS[gameId];
+	return gameDetails.contents.reduce((parsedDetails, entry) => {
+		const valueType = schema[entry.key] ?? "string";
+		parsedDetails[entry.key] = parseGameDetail(valueType, entry.value);
+		return parsedDetails;
+	}, {});
+}
+//#endregion
+export { parseCoinType, parseGameDetails, parseGameEvent };
+
+//# sourceMappingURL=parser.mjs.map

package/dist/utils/parser.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.mjs","names":[],"sources":["../../src/utils/parser.ts"],"sourcesContent":["// Copyright (c) Suigar\n// SPDX-License-Identifier: Apache-2.0\n\nimport { bcs } from '@mysten/sui/bcs';\nimport type { SuiClientTypes } from '@mysten/sui/client';\nimport { normalizeStructTag, parseStructTag } from '@mysten/sui/utils';\nimport {\n\tBetResultGameDetails,\n\tGAME_DETAIL_BCS,\n\tGAME_DETAILS_SCHEMAS,\n\tGAME_EVENTS,\n\tGameDetail,\n\tGameDetails,\n\tGameEvent,\n\tGAMES,\n\tMoveFloat,\n\tSuigarGameEvent,\n\ttype Game,\n\ttype GameDetailValueType,\n} from '../types';\nimport { fromMoveFloat } from './numeric';\n\nconst textDecoder = new TextDecoder();\n\n/**\n * Extracts and normalizes the first generic coin type from a Move object type.\n *\n * PvP Coinflip game object types encode the wager coin as their first type parameter,\n * for example `Game<0x2::sui::SUI>`. This helper converts that generic type\n * argument into the SDK's canonical struct tag string.\n *\n * @param type Fully qualified Move object type with the coin type as its first generic argument.\n * @returns Normalized coin type struct tag.\n */\nexport function parseCoinType(type: string): string {\n\tconst coinType = parseStructTag(type).typeParams[0];\n\tif (!coinType) {\n\t\tthrow new TypeError(`Unable to parse coin type from ${type}`);\n\t}\n\n\treturn normalizeStructTag(coinType);\n}\n\n/**\n * Resolves a supported Suigar event into its normalized SDK game id and event name.\n *\n * This helper recognizes all supported Suigar event names in `GAME_EVENTS`.\n * Standard `BetResultEvent` payloads encode the game family through the core\n * client event module or generic type parameter, while PvP coinflip events\n * resolve to the `pvp-coinflip` game id from their `pvp_coinflip` module.\n *\n * @param event Sui event returned by the core client.\n * @returns Parsed SDK game id and raw Move event name, or `null` when the event\n * name is unsupported or the game id cannot be resolved.\n */\nexport function parseGameEvent(\n\tevent: SuiClientTypes.Event,\n): SuigarGameEvent | null {\n\tconst { name: eventName, typeParams } = parseStructTag(event.eventType);\n\tconst module = event.module.replaceAll('_', '-');\n\tconst gameId = GAMES.includes(module as Game) ? module : typeParams[0];\n\n\tif (\n\t\t!GAME_EVENTS.includes(eventName as GameEvent) ||\n\t\ttypeof gameId !== 'string'\n\t) {\n\t\treturn null;\n\t}\n\n\treturn {\n\t\tgameId,\n\t\teventName,\n\t} as SuigarGameEvent;\n}\n\nfunction parseStringGameDetail(value: number[]): string {\n\tconst bytes = Uint8Array.from(value);\n\n\ttry {\n\t\treturn bcs.String.parse(bytes);\n\t} catch {\n\t\treturn textDecoder.decode(bytes);\n\t}\n}\n\nfunction parseGameDetail<TValueType extends GameDetailValueType>(\n\tvalueType: TValueType,\n\tvalue: number[],\n): GameDetail<TValueType> {\n\tif (valueType === 'string') {\n\t\treturn parseStringGameDetail(value) as GameDetail<TValueType>;\n\t}\n\n\tconst parsed = GAME_DETAIL_BCS[valueType].parse(Uint8Array.from(value));\n\n\tswitch (valueType) {\n\t\tcase 'float':\n\t\t\treturn fromMoveFloat(parsed as MoveFloat) as GameDetail<TValueType>;\n\t\tcase 'u64':\n\t\t\treturn Number(parsed) as GameDetail<TValueType>;\n\t\tdefault:\n\t\t\treturn parsed as GameDetail<TValueType>;\n\t}\n}\n\n/**\n * Decodes `BetResultEvent.game_details` into plain application values.\n *\n * Use this only with the `game_details` field from a decoded `BetResultEvent`.\n * Suigar stores those entries as `VecMap<string, vector<u8>>`, so raw BCS\n * decoding leaves each value as bytes. This helper uses the provided `gameId`\n * to narrow the known detail schema, parses each byte array into the expected\n * runtime type, and preserves the original on-chain keys in the returned\n * object. Unknown keys fall back to string decoding so newer detail fields\n * remain readable by default.\n *\n * Call `parseGameEvent(event)` first when you need to derive the matching\n * `gameId` from the raw `SuiClientTypes.Event` before decoding\n * `decoded.game_details`.\n *\n * @param gameId Suigar game id used to narrow the known detail keys and value\n * types for this bet result payload.\n * @param gameDetails Raw `game_details` map from a decoded `BetResultEvent`.\n * @returns A plain object with decoded values for the known keys of the\n * selected game.\n */\nexport function parseGameDetails<TGame extends Game>(\n\tgameId: TGame,\n\tgameDetails: BetResultGameDetails,\n): GameDetails<TGame> {\n\tconst schema: Record<string, GameDetailValueType> =\n\t\tGAME_DETAILS_SCHEMAS[gameId];\n\tconst details = gameDetails.contents.reduce<Record<string, unknown>>(\n\t\t(parsedDetails, entry) => {\n\t\t\tconst valueType = schema[entry.key] ?? 'string';\n\t\t\tparsedDetails[entry.key] = parseGameDetail(valueType, entry.value);\n\t\t\treturn parsedDetails;\n\t\t},\n\t\t{},\n\t);\n\n\treturn details as GameDetails<TGame>;\n}\n"],"mappings":";;;;;;AAsBA,MAAM,cAAc,IAAI,aAAa;;;;;;;;;;;AAYrC,SAAgB,cAAc,MAAsB;CACnD,MAAM,WAAW,eAAe,KAAK,CAAC,WAAW;CACjD,IAAI,CAAC,UACJ,MAAM,IAAI,UAAU,kCAAkC,OAAO;CAG9D,OAAO,mBAAmB,SAAS;;;;;;;;;;;;;;AAepC,SAAgB,eACf,OACyB;CACzB,MAAM,EAAE,MAAM,WAAW,eAAe,eAAe,MAAM,UAAU;CACvE,MAAM,SAAS,MAAM,OAAO,WAAW,KAAK,IAAI;CAChD,MAAM,SAAS,MAAM,SAAS,OAAe,GAAG,SAAS,WAAW;CAEpE,IACC,CAAC,YAAY,SAAS,UAAuB,IAC7C,OAAO,WAAW,UAElB,OAAO;CAGR,OAAO;EACN;EACA;EACA;;AAGF,SAAS,sBAAsB,OAAyB;CACvD,MAAM,QAAQ,WAAW,KAAK,MAAM;CAEpC,IAAI;EACH,OAAO,IAAI,OAAO,MAAM,MAAM;SACvB;EACP,OAAO,YAAY,OAAO,MAAM;;;AAIlC,SAAS,gBACR,WACA,OACyB;CACzB,IAAI,cAAc,UACjB,OAAO,sBAAsB,MAAM;CAGpC,MAAM,SAAS,gBAAgB,WAAW,MAAM,WAAW,KAAK,MAAM,CAAC;CAEvE,QAAQ,WAAR;EACC,KAAK,SACJ,OAAO,cAAc,OAAoB;EAC1C,KAAK,OACJ,OAAO,OAAO,OAAO;EACtB,SACC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;AAyBV,SAAgB,iBACf,QACA,aACqB;CACrB,MAAM,SACL,qBAAqB;CAUtB,OATgB,YAAY,SAAS,QACnC,eAAe,UAAU;EACzB,MAAM,YAAY,OAAO,MAAM,QAAQ;EACvC,cAAc,MAAM,OAAO,gBAAgB,WAAW,MAAM,MAAM;EAClE,OAAO;IAER,EAAE,CAGW"}

package/dist/utils.d.mts

@@ -0,0 +1,4 @@
+import { DEFAULT_GAS_BUDGET_MIST, DEFAULT_LIMBO_MULTIPLIER_SCALE, DEFAULT_RANGE_SCALE, RANGE_POINT_LIMIT } from "./utils/constants.mjs";
+import { fromMoveFloat, fromMoveI64, toBigInt, toU16, toU8 } from "./utils/numeric.mjs";
+import { parseCoinType, parseGameDetails, parseGameEvent } from "./utils/parser.mjs";
+export { DEFAULT_GAS_BUDGET_MIST, DEFAULT_LIMBO_MULTIPLIER_SCALE, DEFAULT_RANGE_SCALE, RANGE_POINT_LIMIT, fromMoveFloat, fromMoveI64, parseCoinType, parseGameDetails, parseGameEvent, toBigInt, toU16, toU8 };

package/dist/utils.mjs

@@ -0,0 +1,4 @@
+import { DEFAULT_GAS_BUDGET_MIST, DEFAULT_LIMBO_MULTIPLIER_SCALE, DEFAULT_RANGE_SCALE, RANGE_POINT_LIMIT } from "./utils/constants.mjs";
+import { fromMoveFloat, fromMoveI64, toBigInt, toU16, toU8 } from "./utils/numeric.mjs";
+import { parseCoinType, parseGameDetails, parseGameEvent } from "./utils/parser.mjs";
+export { DEFAULT_GAS_BUDGET_MIST, DEFAULT_LIMBO_MULTIPLIER_SCALE, DEFAULT_RANGE_SCALE, RANGE_POINT_LIMIT, fromMoveFloat, fromMoveI64, parseCoinType, parseGameDetails, parseGameEvent, toBigInt, toU16, toU8 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@suigar/sdk",
-  "version": "2.0.0-beta.13",
+  "version": "2.0.0-beta.15",
   "description": "TypeScript SDK for Suigar v2 Move contracts on Sui.",
   "keywords": [
     "suigar",
@@ -19,28 +19,27 @@
     "CHANGELOG.md",
     "README.md"
   ],
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
     },
     "./games": {
-      "types": "./dist/games.d.ts",
-      "import": "./dist/games.js",
-      "require": "./dist/games.cjs"
+      "types": "./dist/games.d.mts",
+      "import": "./dist/games.mjs",
+      "default": "./dist/games.mjs"
     },
     "./utils": {
-      "types": "./dist/utils.d.ts",
-      "import": "./dist/utils.js",
-      "require": "./dist/utils.cjs"
+      "types": "./dist/utils.d.mts",
+      "import": "./dist/utils.mjs",
+      "default": "./dist/utils.mjs"
     }
   },
   "engines": {
-    "node": ">=24"
+    "node": "^22.18.0 || >=24"
   },
   "repository": {
     "type": "git",
@@ -62,14 +61,14 @@
     "@mysten/codegen": "^0.10.4",
     "@mysten/sui": "^2.16.0",
     "@types/node": "^24.0.0",
-    "tsup": "^8.5.1",
+    "tsdown": "^0.22.0",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
     "vitest": "^4.1.5"
   },
   "scripts": {
-    "build": "pnpm clean && pnpm codegen && tsup",
-    "build:ci": "rm -rf dist && tsup",
+    "build": "pnpm clean && pnpm codegen && tsdown",
+    "build:ci": "rm -rf dist && tsdown",
     "clean": "rm -rf dist src/contracts .vitest-cache",
     "codegen": "node ./scripts/update-package-configs.mjs && sui-ts-codegen generate && pnpm lint",
     "eslint:fix": "eslint . --fix",