@spawnco/sdk-types 0.0.52 → 0.0.54

package/dist/index.d.mts

@@ -207,6 +207,16 @@ interface SpawnServerSDK__V1<TConfig = any> {
         /** Returns true if the user is currently muted (and not expired) */
         checkIsMuted(userId: string): Promise<boolean>;
     };
+    studioChat: {
+        /** Send a hidden DM-style notification to Savi for this variant's app. */
+        notifyDm(options: {
+            message: string;
+            source?: string;
+            entityId?: string;
+        }): Promise<{
+            success: boolean;
+        }>;
+    };
     sparks: {
         verifyPurchase({ purchaseId, price }: {
             purchaseId: string;
@@ -261,6 +271,23 @@ interface SpawnServerSDK__V1<TConfig = any> {
          */
         unlock(key: string): Promise<void>;
     };
+    /**
+     * Game spec access (Tome).
+     * Returns the latest resolved game_spec for an app.
+     */
+    gameSpec: {
+        /**
+         * Fetch the latest game spec for this variant's app, or an explicit appId override.
+         * Returns null if no spec exists.
+         */
+        latest(options?: {
+            appId?: string;
+        }): Promise<{
+            appId: string;
+            version: number;
+            gameSpec: Record<string, unknown>;
+        } | null>;
+    };
     config: {
         get(): Promise<TConfig>;
         version(): Promise<string>;
@@ -271,7 +298,7 @@ interface SpawnServerSDK__V1<TConfig = any> {
         getClaimsToday(userId: string): Promise<{
             claimedIds: ('A' | 'B' | 'C')[];
         }>;
-        /** Claim a dew plant for a user. Returns random 10-20 dew amount. */
+        /** Claim a dew plant for a user. Returns random 5-10 dew amount. */
         claim(userId: string, plantId: 'A' | 'B' | 'C'): Promise<{
             success: boolean;
             amount?: number;
@@ -465,7 +492,7 @@ interface JobDewEnv {
     getClaimsToday(userId: string): Promise<{
         claimedIds: ('A' | 'B' | 'C')[];
     }>;
-    /** Claim a dew plant for a user. Returns random 10-20 dew amount. */
+    /** Claim a dew plant for a user. Returns random 5-10 dew amount. */
     claim(userId: string, plantId: 'A' | 'B' | 'C'): Promise<{
         success: boolean;
         amount?: number;

package/dist/index.d.ts

@@ -207,6 +207,16 @@ interface SpawnServerSDK__V1<TConfig = any> {
         /** Returns true if the user is currently muted (and not expired) */
         checkIsMuted(userId: string): Promise<boolean>;
     };
+    studioChat: {
+        /** Send a hidden DM-style notification to Savi for this variant's app. */
+        notifyDm(options: {
+            message: string;
+            source?: string;
+            entityId?: string;
+        }): Promise<{
+            success: boolean;
+        }>;
+    };
     sparks: {
         verifyPurchase({ purchaseId, price }: {
             purchaseId: string;
@@ -261,6 +271,23 @@ interface SpawnServerSDK__V1<TConfig = any> {
          */
         unlock(key: string): Promise<void>;
     };
+    /**
+     * Game spec access (Tome).
+     * Returns the latest resolved game_spec for an app.
+     */
+    gameSpec: {
+        /**
+         * Fetch the latest game spec for this variant's app, or an explicit appId override.
+         * Returns null if no spec exists.
+         */
+        latest(options?: {
+            appId?: string;
+        }): Promise<{
+            appId: string;
+            version: number;
+            gameSpec: Record<string, unknown>;
+        } | null>;
+    };
     config: {
         get(): Promise<TConfig>;
         version(): Promise<string>;
@@ -271,7 +298,7 @@ interface SpawnServerSDK__V1<TConfig = any> {
         getClaimsToday(userId: string): Promise<{
             claimedIds: ('A' | 'B' | 'C')[];
         }>;
-        /** Claim a dew plant for a user. Returns random 10-20 dew amount. */
+        /** Claim a dew plant for a user. Returns random 5-10 dew amount. */
         claim(userId: string, plantId: 'A' | 'B' | 'C'): Promise<{
             success: boolean;
             amount?: number;
@@ -465,7 +492,7 @@ interface JobDewEnv {
     getClaimsToday(userId: string): Promise<{
         claimedIds: ('A' | 'B' | 'C')[];
     }>;
-    /** Claim a dew plant for a user. Returns random 10-20 dew amount. */
+    /** Claim a dew plant for a user. Returns random 5-10 dew amount. */
     claim(userId: string, plantId: 'A' | 'B' | 'C'): Promise<{
         success: boolean;
         amount?: number;

package/package.json

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

package/src/v1.ts

@@ -230,6 +230,11 @@ export interface SpawnServerSDK__V1<TConfig = any> {
     checkIsMuted(userId: string): Promise<boolean>;
   };
 
+  studioChat: {
+    /** Send a hidden DM-style notification to Savi for this variant's app. */
+    notifyDm(options: { message: string; source?: string; entityId?: string }): Promise<{ success: boolean }>;
+  };
+
   sparks: {
     verifyPurchase({ purchaseId, price }: { purchaseId: string; price: number }): Promise<boolean>;
   };
@@ -291,6 +296,22 @@ export interface SpawnServerSDK__V1<TConfig = any> {
     unlock(key: string): Promise<void>;
   };
 
+  /**
+   * Game spec access (Tome).
+   * Returns the latest resolved game_spec for an app.
+   */
+  gameSpec: {
+    /**
+     * Fetch the latest game spec for this variant's app, or an explicit appId override.
+     * Returns null if no spec exists.
+     */
+    latest(options?: { appId?: string }): Promise<{
+      appId: string;
+      version: number;
+      gameSpec: Record<string, unknown>;
+    } | null>;
+  };
+
   config: {
     get(): Promise<TConfig>;
     version(): Promise<string>;
@@ -301,7 +322,7 @@ export interface SpawnServerSDK__V1<TConfig = any> {
     /** Get today's plant claims for a user in this variant */
     getClaimsToday(userId: string): Promise<{ claimedIds: ('A' | 'B' | 'C')[] }>;
 
-    /** Claim a dew plant for a user. Returns random 10-20 dew amount. */
+    /** Claim a dew plant for a user. Returns random 5-10 dew amount. */
     claim(
       userId: string,
       plantId: 'A' | 'B' | 'C'
@@ -550,7 +571,7 @@ export interface JobDewEnv {
   /** Get today's plant claims for a user in this variant */
   getClaimsToday(userId: string): Promise<{ claimedIds: ('A' | 'B' | 'C')[] }>;
 
-  /** Claim a dew plant for a user. Returns random 10-20 dew amount. */
+  /** Claim a dew plant for a user. Returns random 5-10 dew amount. */
   claim(
     userId: string,
     plantId: 'A' | 'B' | 'C'