@onlyworlds/sdk 4.76.2 → 4.77.0

package/CHANGELOG.md

@@ -5,6 +5,12 @@ earlier history lives in git log only.
 
 ## [Unreleased]
 
+## [4.77.0] - 2026-10-26
+
+### Added
+
+- **`isCharacterPlayed`** on `OwApiError`: a delete (or a review's decline) of a Character someone plays on the roster, the world's `owner_character` or a live member's, an AI seat's or a player's, answers 422 `character_played` (`param` id) and deletes nothing. The predicate tells it from a malformed id's 422, which carries the same `param`. The way out is to re-point that member to another Character, or remove the member, then delete.
+
 ## [4.76.2] - 2026-10-25
 
 ### Changed

package/dist/index.d.ts

@@ -3336,6 +3336,16 @@ declare class OwApiError extends Error {
      * `character_taken` (see isCharacterTaken).
      */
     get isCharacterInvalid(): boolean;
+    /**
+     * delete, or reviewNewElement's decline: the Character is one someone plays on the roster, the
+     * world's `owner_character` or a live member's, an AI seat's or a player's Character (422
+     * `character_played`, `param` id). Nothing was deleted; the message says who plays it, never by
+     * email or username. Re-point that member to another Character (the owner's own through
+     * patchWorld's `owner_character`, a seat's by the owner on the member PATCH, a person's own
+     * through setMyCharacter), or remove the member, then delete. Never true for a malformed id's
+     * 422, which carries the same `param`.
+     */
+    get isCharacterPlayed(): boolean;
     /**
      * redeemJoin: the world already has its 50 live players (422 `world_full`),
      * at any player link, a table's or a link for one's. Nothing is spent; a place frees when the

package/dist/index.js

@@ -223,6 +223,18 @@ var OwApiError = class extends Error {
   get isCharacterInvalid() {
     return this.status === 422 && this.code === "invalid_request" && this.param === "character";
   }
+  /**
+   * delete, or reviewNewElement's decline: the Character is one someone plays on the roster, the
+   * world's `owner_character` or a live member's, an AI seat's or a player's Character (422
+   * `character_played`, `param` id). Nothing was deleted; the message says who plays it, never by
+   * email or username. Re-point that member to another Character (the owner's own through
+   * patchWorld's `owner_character`, a seat's by the owner on the member PATCH, a person's own
+   * through setMyCharacter), or remove the member, then delete. Never true for a malformed id's
+   * 422, which carries the same `param`.
+   */
+  get isCharacterPlayed() {
+    return this.status === 422 && this.code === "character_played";
+  }
   /**
    * redeemJoin: the world already has its 50 live players (422 `world_full`),
    * at any player link, a table's or a link for one's. Nothing is spent; a place frees when the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onlyworlds/sdk",
-  "version": "4.76.2",
+  "version": "4.77.0",
   "description": "TypeScript SDK for the OnlyWorlds API - build world-building applications with type safety",
   "type": "module",
   "exports": {