castle-web-sdk 0.4.23 → 0.4.24

package/README.md

@@ -4,8 +4,10 @@
 platform — for example, a deck can save per-player data, post and read
 scores on a leaderboard, or get a server-synced time for daily content.
 
-Comes with `castle-web init`. Import what you need from
-`castle-web-sdk`:
+Comes with every deck: the SDK is a file of the `base` kit each deck
+imports (`imports/castle.base/sdk/`), and the bare specifier resolves
+there — nothing to install, and no deck `package.json` names it. Import
+what you need from `castle-web-sdk`:
 
 ```js
 import { setup, initCard, Storage, Leaderboard } from "castle-web-sdk";
@@ -255,7 +257,10 @@ const dailyPuzzle = (date.daysSinceCastleEpoch % 30) + 1;
 Returns the signed-in player. Throws `CastleError`
 (`LOGIN_REQUIRED`) when nobody is signed in.
 
-The returned `CastleUser` has `userId`, `username`, and `isActive`.
+The returned `CastleUser` has `userId`, `username`, `isAnonymous`, and `isActive`.
+Anonymous accounts are real logins with generated `anonymous-user-...` names;
+check `isAnonymous` before accepting writes into anything other players see,
+such as a shared gallery.
 
 ```js
 const me = await User.getCurrent();

package/dist/commands.d.ts

@@ -136,6 +136,7 @@ export interface CommandResult {
         user: {
             userId: string;
             username: string;
+            isAnonymous?: boolean;
         } | null;
     };
     "time.getServerTime": {

package/dist/user.d.ts

@@ -1,6 +1,7 @@
 export interface CastleUser {
     userId: string;
     username: string;
+    isAnonymous: boolean;
     isActive: boolean;
 }
 export interface CastleUserApi {

package/dist/user.js

@@ -24,9 +24,13 @@ async function fetchCurrentUser() {
             operation,
         });
     }
+    const username = requiredString(user.username, "user.username", operation);
     return {
         userId: requiredString(user.userId, "user.userId", operation),
-        username: requiredString(user.username, "user.username", operation),
+        username,
+        // A host that predates the flag omits it; anonymous account usernames are
+        // always minted as `anonymous-user-<uuid>`, so the prefix is the fallback.
+        isAnonymous: user.isAnonymous === true || username.toLowerCase().startsWith("anonymous-user-"),
         isActive: true,
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "castle-web-sdk",
-  "version": "0.4.23",
+  "version": "0.4.24",
   "type": "module",
   "main": "dist/castle.js",
   "types": "dist/castle.d.ts",