keeperboard 2.0.3 → 2.1.0

package/dist/index.d.mts

@@ -93,6 +93,7 @@ interface HealthResult {
     version: string;
     timestamp: string;
 }
+type ErrorCode = 'PROFANITY_DETECTED' | 'RATE_LIMITED' | 'INVALID_REQUEST' | 'NOT_FOUND' | 'INTERNAL_ERROR';
 interface SessionConfig {
     /** API key from the KeeperBoard dashboard */
     apiKey: string;
@@ -120,6 +121,14 @@ type SessionScoreResult = {
 } | {
     success: false;
     error: string;
+    errorCode?: ErrorCode;
+};
+type UpdateNameResult = {
+    success: true;
+} | {
+    success: false;
+    error: string;
+    errorCode?: ErrorCode;
 };
 interface SnapshotEntry {
     rank: number;
@@ -334,9 +343,9 @@ declare class KeeperBoardSession {
     }): Promise<SnapshotResult>;
     /**
      * Update the player's name on the server and locally.
-     * Returns true on success, false on failure.
+     * Returns `{ success: true }` on success, or `{ success: false, error, errorCode }` on failure.
      */
-    updatePlayerName(newName: string): Promise<boolean>;
+    updatePlayerName(newName: string): Promise<UpdateNameResult>;
     /**
      * Retry submitting a pending score (from a previous failed submission).
      * Call this on app startup.
@@ -510,4 +519,4 @@ declare class RetryQueue {
     clear(): void;
 }
 
-export { Cache, type ClaimResponse, type ClaimResult, type ClaimScoreOptions, type GetLeaderboardOptions, type GetPlayerRankOptions, type HealthResponse, type HealthResult, KeeperBoardClient, type KeeperBoardConfig, KeeperBoardError, KeeperBoardSession, type LeaderboardEntry, type LeaderboardResponse, type LeaderboardResult, type NameValidationOptions, PlayerIdentity, type PlayerIdentityConfig, type PlayerResponse, type PlayerResult, type ResetSchedule, RetryQueue, type ScoreResponse, type ScoreResult, type ScoreSubmission, type SessionConfig, type SessionScoreResult, type SnapshotEntry, type SnapshotResult, type SubmitScoreOptions, type UpdatePlayerNameOptions, generatePlayerName, validateName };
+export { Cache, type ClaimResponse, type ClaimResult, type ClaimScoreOptions, type ErrorCode, type GetLeaderboardOptions, type GetPlayerRankOptions, type HealthResponse, type HealthResult, KeeperBoardClient, type KeeperBoardConfig, KeeperBoardError, KeeperBoardSession, type LeaderboardEntry, type LeaderboardResponse, type LeaderboardResult, type NameValidationOptions, PlayerIdentity, type PlayerIdentityConfig, type PlayerResponse, type PlayerResult, type ResetSchedule, RetryQueue, type ScoreResponse, type ScoreResult, type ScoreSubmission, type SessionConfig, type SessionScoreResult, type SnapshotEntry, type SnapshotResult, type SubmitScoreOptions, type UpdateNameResult, type UpdatePlayerNameOptions, generatePlayerName, validateName };

package/dist/index.d.ts

@@ -93,6 +93,7 @@ interface HealthResult {
     version: string;
     timestamp: string;
 }
+type ErrorCode = 'PROFANITY_DETECTED' | 'RATE_LIMITED' | 'INVALID_REQUEST' | 'NOT_FOUND' | 'INTERNAL_ERROR';
 interface SessionConfig {
     /** API key from the KeeperBoard dashboard */
     apiKey: string;
@@ -120,6 +121,14 @@ type SessionScoreResult = {
 } | {
     success: false;
     error: string;
+    errorCode?: ErrorCode;
+};
+type UpdateNameResult = {
+    success: true;
+} | {
+    success: false;
+    error: string;
+    errorCode?: ErrorCode;
 };
 interface SnapshotEntry {
     rank: number;
@@ -334,9 +343,9 @@ declare class KeeperBoardSession {
     }): Promise<SnapshotResult>;
     /**
      * Update the player's name on the server and locally.
-     * Returns true on success, false on failure.
+     * Returns `{ success: true }` on success, or `{ success: false, error, errorCode }` on failure.
      */
-    updatePlayerName(newName: string): Promise<boolean>;
+    updatePlayerName(newName: string): Promise<UpdateNameResult>;
     /**
      * Retry submitting a pending score (from a previous failed submission).
      * Call this on app startup.
@@ -510,4 +519,4 @@ declare class RetryQueue {
     clear(): void;
 }
 
-export { Cache, type ClaimResponse, type ClaimResult, type ClaimScoreOptions, type GetLeaderboardOptions, type GetPlayerRankOptions, type HealthResponse, type HealthResult, KeeperBoardClient, type KeeperBoardConfig, KeeperBoardError, KeeperBoardSession, type LeaderboardEntry, type LeaderboardResponse, type LeaderboardResult, type NameValidationOptions, PlayerIdentity, type PlayerIdentityConfig, type PlayerResponse, type PlayerResult, type ResetSchedule, RetryQueue, type ScoreResponse, type ScoreResult, type ScoreSubmission, type SessionConfig, type SessionScoreResult, type SnapshotEntry, type SnapshotResult, type SubmitScoreOptions, type UpdatePlayerNameOptions, generatePlayerName, validateName };
+export { Cache, type ClaimResponse, type ClaimResult, type ClaimScoreOptions, type ErrorCode, type GetLeaderboardOptions, type GetPlayerRankOptions, type HealthResponse, type HealthResult, KeeperBoardClient, type KeeperBoardConfig, KeeperBoardError, KeeperBoardSession, type LeaderboardEntry, type LeaderboardResponse, type LeaderboardResult, type NameValidationOptions, PlayerIdentity, type PlayerIdentityConfig, type PlayerResponse, type PlayerResult, type ResetSchedule, RetryQueue, type ScoreResponse, type ScoreResult, type ScoreSubmission, type SessionConfig, type SessionScoreResult, type SnapshotEntry, type SnapshotResult, type SubmitScoreOptions, type UpdateNameResult, type UpdatePlayerNameOptions, generatePlayerName, validateName };

package/dist/index.js

@@ -810,10 +810,14 @@ var KeeperBoardSession = class {
         isNewHighScore: result.isNewHighScore
       };
     } catch (error) {
-      this.retryQueue?.save(score, metadata);
+      const errorCode = error instanceof KeeperBoardError ? error.code : void 0;
+      if (errorCode !== "PROFANITY_DETECTED") {
+        this.retryQueue?.save(score, metadata);
+      }
       return {
         success: false,
-        error: error instanceof Error ? error.message : "Unknown error"
+        error: error instanceof Error ? error.message : "Unknown error",
+        errorCode
       };
     } finally {
       this.isSubmitting = false;
@@ -840,7 +844,7 @@ var KeeperBoardSession = class {
   }
   /**
    * Update the player's name on the server and locally.
-   * Returns true on success, false on failure.
+   * Returns `{ success: true }` on success, or `{ success: false, error, errorCode }` on failure.
    */
   async updatePlayerName(newName) {
     try {
@@ -853,9 +857,14 @@ var KeeperBoardSession = class {
         this.cache.invalidate();
         this.cachedLimit = 0;
       }
-      return true;
-    } catch {
-      return false;
+      return { success: true };
+    } catch (error) {
+      const errorCode = error instanceof KeeperBoardError ? error.code : void 0;
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : "Unknown error",
+        errorCode
+      };
     }
   }
   /**

package/dist/index.mjs

@@ -777,10 +777,14 @@ var KeeperBoardSession = class {
         isNewHighScore: result.isNewHighScore
       };
     } catch (error) {
-      this.retryQueue?.save(score, metadata);
+      const errorCode = error instanceof KeeperBoardError ? error.code : void 0;
+      if (errorCode !== "PROFANITY_DETECTED") {
+        this.retryQueue?.save(score, metadata);
+      }
       return {
         success: false,
-        error: error instanceof Error ? error.message : "Unknown error"
+        error: error instanceof Error ? error.message : "Unknown error",
+        errorCode
       };
     } finally {
       this.isSubmitting = false;
@@ -807,7 +811,7 @@ var KeeperBoardSession = class {
   }
   /**
    * Update the player's name on the server and locally.
-   * Returns true on success, false on failure.
+   * Returns `{ success: true }` on success, or `{ success: false, error, errorCode }` on failure.
    */
   async updatePlayerName(newName) {
     try {
@@ -820,9 +824,14 @@ var KeeperBoardSession = class {
         this.cache.invalidate();
         this.cachedLimit = 0;
       }
-      return true;
-    } catch {
-      return false;
+      return { success: true };
+    } catch (error) {
+      const errorCode = error instanceof KeeperBoardError ? error.code : void 0;
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : "Unknown error",
+        errorCode
+      };
     }
   }
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "keeperboard",
-  "version": "2.0.3",
+  "version": "2.1.0",
   "description": "TypeScript client SDK for KeeperBoard leaderboard-as-a-service",
   "main": "dist/index.js",
   "module": "dist/index.mjs",