@suigar/sdk 2.0.0-beta.4 → 2.0.0-beta.5

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @suigar/sdk
 
+## 2.0.0-beta.5
+
+### Patch Changes
+
+- bf98e0a: Update PvP coinflip registry lookups so `getPvPCoinflipGames()` can skip
+  individual game resolution failures by default while still supporting
+  `rejectOnError: true` for strict rejection.
+  - Document the `rejectOnError` behavior in the public JSDoc and README examples.
+  - Clarify repo guidance and skill documentation to distinguish general PvP game
+    guidance from the current PvP coinflip-specific runtime surface.
+
 ## 2.0.0-beta.4
 
 ### Patch Changes

package/README.md

@@ -208,6 +208,10 @@ the Move flow removes it from the registry and deletes the live `Game` object.
 Use this when a product needs the current set of open PvP coinflip matches for
 browsing or lobby views.
 
+By default, failures to resolve an individual game are skipped so one broken or
+already-deleted registry entry does not reject the full lookup. Pass
+`rejectOnError: true` if you want the call to reject instead.
+
 ```ts
 const games = await client.suigar.getPvPCoinflipGames({ limit: 20 });
 
@@ -217,6 +221,13 @@ for (const game of games) {
 }
 ```
 
+```ts
+const games = await client.suigar.getPvPCoinflipGames({
+	limit: 20,
+	rejectOnError: true,
+});
+```
+
 ### `resolvePvPConflipGame(gameId)`
 
 Fetches a PvP coinflip game object from chain and parses it into the SDK's
@@ -246,7 +257,7 @@ console.log(game.is_private);
 > - after a game is joined and resolved, the live `Game` object is removed from the registry and deleted, so inspect `PvPCoinflipGameResolved` to read the final result
 
 > [!TIP]
-> Prefer this helper over manual object parsing when you only need the parsed state for a live PvP game object.
+> Prefer this helper over manual object parsing when you only need the parsed state for a live PvP coinflip game object.
 
 ## `tx`
 
@@ -537,7 +548,7 @@ This repository now includes a Next.js integration example in [examples/game-int
 It demonstrates:
 
 - standard game transactions through `client.suigar.tx.createBetTransaction(...)`
-- PvP coinflip create, join, and cancel flows through `client.suigar.tx.createPvPCoinflipTransaction(...)`, exposed in the example through a PvP game selector ready for future PvP games
+- PvP coinflip create, join, and cancel flows through `client.suigar.tx.createPvPCoinflipTransaction(...)`, exposed in the example through a PvP coinflip action selector
 - wallet connection and execution with `@mysten/dapp-kit-core` and `@mysten/dapp-kit-react`
 - supported coin selection from `client.suigar.getConfig()`
 - connected-wallet balance display for each supported coin in the example app

package/dist/index.cjs

@@ -1014,18 +1014,32 @@ var SuigarClient = class {
    * browsing or lobby views.
    *
    * @param options Optional dynamic field pagination forwarded to `listDynamicFields()`, excluding `parentId`.
-   * @returns Parsed unresolved PvP coinflip game objects for the requested registry page.
+   * Pass `rejectOnError: true` to fail the whole lookup when any referenced game
+   * cannot be resolved. By default, failed game resolutions are skipped and only
+   * successfully parsed unresolved games are returned.
+   * @returns Parsed unresolved PvP coinflip game objects for the requested
+   * registry page. When `rejectOnError` is `false`, entries that fail
+   * `resolvePvPConflipGame()` are omitted from the returned array.
    */
   async getPvPCoinflipGames(options = {
     limit: 50
   }) {
+    const { rejectOnError = false, ...listOptions } = options;
     const { dynamicFields } = await this.#client.core.listDynamicFields({
       parentId: this.#config.registryIds.pvpCoinflip,
-      ...options
+      ...listOptions
     });
-    return await Promise.all(
+    if (rejectOnError) {
+      return Promise.all(
+        dynamicFields.map(({ childId }) => this.resolvePvPConflipGame(childId))
+      );
+    }
+    const settledGames = await Promise.allSettled(
       dynamicFields.map(({ childId }) => this.resolvePvPConflipGame(childId))
     );
+    return settledGames.flatMap(
+      (result) => result.status === "fulfilled" ? [result.value] : []
+    );
   }
   /**
    * Fetches a PvP coinflip game object from chain and parses it into the SDK's

package/dist/index.d.cts

@@ -52,9 +52,16 @@ declare class SuigarClient {
      * browsing or lobby views.
      *
      * @param options Optional dynamic field pagination forwarded to `listDynamicFields()`, excluding `parentId`.
-     * @returns Parsed unresolved PvP coinflip game objects for the requested registry page.
+     * Pass `rejectOnError: true` to fail the whole lookup when any referenced game
+     * cannot be resolved. By default, failed game resolutions are skipped and only
+     * successfully parsed unresolved games are returned.
+     * @returns Parsed unresolved PvP coinflip game objects for the requested
+     * registry page. When `rejectOnError` is `false`, entries that fail
+     * `resolvePvPConflipGame()` are omitted from the returned array.
      */
-    getPvPCoinflipGames(options?: Omit<SuiClientTypes.ListDynamicFieldsOptions, 'parentId'>): Promise<{
+    getPvPCoinflipGames(options?: Omit<SuiClientTypes.ListDynamicFieldsOptions, 'parentId'> & {
+        rejectOnError?: boolean;
+    }): Promise<{
         coinType: string;
         id: string;
         creator: string;

package/dist/index.d.ts

@@ -52,9 +52,16 @@ declare class SuigarClient {
      * browsing or lobby views.
      *
      * @param options Optional dynamic field pagination forwarded to `listDynamicFields()`, excluding `parentId`.
-     * @returns Parsed unresolved PvP coinflip game objects for the requested registry page.
+     * Pass `rejectOnError: true` to fail the whole lookup when any referenced game
+     * cannot be resolved. By default, failed game resolutions are skipped and only
+     * successfully parsed unresolved games are returned.
+     * @returns Parsed unresolved PvP coinflip game objects for the requested
+     * registry page. When `rejectOnError` is `false`, entries that fail
+     * `resolvePvPConflipGame()` are omitted from the returned array.
      */
-    getPvPCoinflipGames(options?: Omit<SuiClientTypes.ListDynamicFieldsOptions, 'parentId'>): Promise<{
+    getPvPCoinflipGames(options?: Omit<SuiClientTypes.ListDynamicFieldsOptions, 'parentId'> & {
+        rejectOnError?: boolean;
+    }): Promise<{
         coinType: string;
         id: string;
         creator: string;

package/dist/index.js

@@ -839,18 +839,32 @@ var SuigarClient = class {
    * browsing or lobby views.
    *
    * @param options Optional dynamic field pagination forwarded to `listDynamicFields()`, excluding `parentId`.
-   * @returns Parsed unresolved PvP coinflip game objects for the requested registry page.
+   * Pass `rejectOnError: true` to fail the whole lookup when any referenced game
+   * cannot be resolved. By default, failed game resolutions are skipped and only
+   * successfully parsed unresolved games are returned.
+   * @returns Parsed unresolved PvP coinflip game objects for the requested
+   * registry page. When `rejectOnError` is `false`, entries that fail
+   * `resolvePvPConflipGame()` are omitted from the returned array.
    */
   async getPvPCoinflipGames(options = {
     limit: 50
   }) {
+    const { rejectOnError = false, ...listOptions } = options;
     const { dynamicFields } = await this.#client.core.listDynamicFields({
       parentId: this.#config.registryIds.pvpCoinflip,
-      ...options
+      ...listOptions
     });
-    return await Promise.all(
+    if (rejectOnError) {
+      return Promise.all(
+        dynamicFields.map(({ childId }) => this.resolvePvPConflipGame(childId))
+      );
+    }
+    const settledGames = await Promise.allSettled(
       dynamicFields.map(({ childId }) => this.resolvePvPConflipGame(childId))
     );
+    return settledGames.flatMap(
+      (result) => result.status === "fulfilled" ? [result.value] : []
+    );
   }
   /**
    * Fetches a PvP coinflip game object from chain and parses it into the SDK's

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@suigar/sdk",
-	"version": "2.0.0-beta.4",
+	"version": "2.0.0-beta.5",
 	"description": "TypeScript SDK for Suigar v2 Move contracts on Sui.",
 	"keywords": [
 		"suigar",