@spawnco/sdk-types 0.0.46 → 0.0.48

package/dist/index.d.mts

@@ -213,6 +213,30 @@ interface SpawnServerSDK__V1<TConfig = any> {
             price: number;
         }): Promise<boolean>;
     };
+    /**
+     * Variant-scoped document storage.
+     * Documents persist across server restarts and copy when variants fork.
+     */
+    documents: {
+        /**
+         * Read a document by name. Returns null if not found.
+         * Documents are scoped to the current variant.
+         */
+        get<T = unknown>(name: string): Promise<T | null>;
+        /**
+         * Write a document. Creates if not exists, replaces if exists.
+         * Value must be JSON-serializable.
+         */
+        set<T = unknown>(name: string, value: T): Promise<void>;
+        /**
+         * Delete a document by name.
+         */
+        delete(name: string): Promise<void>;
+        /**
+         * List all document names for this variant.
+         */
+        list(): Promise<string[]>;
+    };
     config: {
         get(): Promise<TConfig>;
         version(): Promise<string>;
@@ -298,6 +322,9 @@ interface TokenPayload {
     variantId: string;
     email?: string;
     username?: string;
+    avatarUrl?: string;
+    characterModelUrl?: string;
+    characterSpriteUrl?: string;
     isGuest: boolean;
     iat: number;
     exp: number;
@@ -307,6 +334,8 @@ interface User {
     id: string;
     username: string;
     avatarUrl?: string;
+    characterModelUrl?: string;
+    characterSpriteUrl?: string;
     isGuest: boolean;
 }
 interface Room<ClientSentMessages extends Record<string, any>, ServerSentMessages extends Record<string, any>> {

package/dist/index.d.ts

@@ -213,6 +213,30 @@ interface SpawnServerSDK__V1<TConfig = any> {
             price: number;
         }): Promise<boolean>;
     };
+    /**
+     * Variant-scoped document storage.
+     * Documents persist across server restarts and copy when variants fork.
+     */
+    documents: {
+        /**
+         * Read a document by name. Returns null if not found.
+         * Documents are scoped to the current variant.
+         */
+        get<T = unknown>(name: string): Promise<T | null>;
+        /**
+         * Write a document. Creates if not exists, replaces if exists.
+         * Value must be JSON-serializable.
+         */
+        set<T = unknown>(name: string, value: T): Promise<void>;
+        /**
+         * Delete a document by name.
+         */
+        delete(name: string): Promise<void>;
+        /**
+         * List all document names for this variant.
+         */
+        list(): Promise<string[]>;
+    };
     config: {
         get(): Promise<TConfig>;
         version(): Promise<string>;
@@ -298,6 +322,9 @@ interface TokenPayload {
     variantId: string;
     email?: string;
     username?: string;
+    avatarUrl?: string;
+    characterModelUrl?: string;
+    characterSpriteUrl?: string;
     isGuest: boolean;
     iat: number;
     exp: number;
@@ -307,6 +334,8 @@ interface User {
     id: string;
     username: string;
     avatarUrl?: string;
+    characterModelUrl?: string;
+    characterSpriteUrl?: string;
     isGuest: boolean;
 }
 interface Room<ClientSentMessages extends Record<string, any>, ServerSentMessages extends Record<string, any>> {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spawnco/sdk-types",
-  "version": "0.0.46",
+  "version": "0.0.48",
   "description": "TypeScript type definitions for Spawn SDK",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",

package/src/v1.ts

@@ -234,6 +234,34 @@ export interface SpawnServerSDK__V1<TConfig = any> {
     verifyPurchase({ purchaseId, price }: { purchaseId: string; price: number }): Promise<boolean>;
   };
 
+  /**
+   * Variant-scoped document storage.
+   * Documents persist across server restarts and copy when variants fork.
+   */
+  documents: {
+    /**
+     * Read a document by name. Returns null if not found.
+     * Documents are scoped to the current variant.
+     */
+    get<T = unknown>(name: string): Promise<T | null>;
+
+    /**
+     * Write a document. Creates if not exists, replaces if exists.
+     * Value must be JSON-serializable.
+     */
+    set<T = unknown>(name: string, value: T): Promise<void>;
+
+    /**
+     * Delete a document by name.
+     */
+    delete(name: string): Promise<void>;
+
+    /**
+     * List all document names for this variant.
+     */
+    list(): Promise<string[]>;
+  };
+
   config: {
     get(): Promise<TConfig>;
     version(): Promise<string>;
@@ -359,6 +387,9 @@ export interface TokenPayload {
   variantId: string;
   email?: string;
   username?: string;
+  avatarUrl?: string;
+  characterModelUrl?: string;
+  characterSpriteUrl?: string;
   isGuest: boolean;
   iat: number;
   exp: number;
@@ -371,6 +402,8 @@ export interface User {
   id: string;
   username: string;
   avatarUrl?: string;
+  characterModelUrl?: string;
+  characterSpriteUrl?: string;
   isGuest: boolean;
 }