@spawnco/sdk-types 0.0.49 → 0.0.51

package/dist/index.d.mts

@@ -236,12 +236,51 @@ interface SpawnServerSDK__V1<TConfig = any> {
          * List all document names for this variant.
          */
         list(): Promise<string[]>;
+        /**
+         * Acquire a distributed lock on a key. Blocks until lock is acquired or timeout.
+         * Always use try/finally to ensure unlock() is called.
+         *
+         * @example
+         * await sdk.documents.lock("leaderboard");
+         * try {
+         *   const data = await sdk.documents.get("leaderboard");
+         *   // ... mutate data ...
+         *   await sdk.documents.set("leaderboard", data);
+         * } finally {
+         *   await sdk.documents.unlock("leaderboard");
+         * }
+         */
+        lock(key: string, options?: {
+            /** Auto-expire if worker crashes (default: 30000ms) */
+            ttlMs?: number;
+            /** Max time to wait for lock (default: 10000ms) */
+            waitMs?: number;
+        }): Promise<void>;
+        /**
+         * Release a distributed lock. Must be called after lock() in a finally block.
+         */
+        unlock(key: string): Promise<void>;
     };
     config: {
         get(): Promise<TConfig>;
         version(): Promise<string>;
         effectiveVersion(): Promise<string>;
     };
+    dew: {
+        /** 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(userId: string, plantId: 'A' | 'B' | 'C'): Promise<{
+            success: boolean;
+            amount?: number;
+            new_balance?: number;
+            duplicate?: boolean;
+            claim_id?: string;
+            error?: string;
+        }>;
+    };
     economy: {
         redeemPurchase<T extends Record<string, any>>(token: string): Promise<{
             success: boolean;

package/dist/index.d.ts

@@ -236,12 +236,51 @@ interface SpawnServerSDK__V1<TConfig = any> {
          * List all document names for this variant.
          */
         list(): Promise<string[]>;
+        /**
+         * Acquire a distributed lock on a key. Blocks until lock is acquired or timeout.
+         * Always use try/finally to ensure unlock() is called.
+         *
+         * @example
+         * await sdk.documents.lock("leaderboard");
+         * try {
+         *   const data = await sdk.documents.get("leaderboard");
+         *   // ... mutate data ...
+         *   await sdk.documents.set("leaderboard", data);
+         * } finally {
+         *   await sdk.documents.unlock("leaderboard");
+         * }
+         */
+        lock(key: string, options?: {
+            /** Auto-expire if worker crashes (default: 30000ms) */
+            ttlMs?: number;
+            /** Max time to wait for lock (default: 10000ms) */
+            waitMs?: number;
+        }): Promise<void>;
+        /**
+         * Release a distributed lock. Must be called after lock() in a finally block.
+         */
+        unlock(key: string): Promise<void>;
     };
     config: {
         get(): Promise<TConfig>;
         version(): Promise<string>;
         effectiveVersion(): Promise<string>;
     };
+    dew: {
+        /** 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(userId: string, plantId: 'A' | 'B' | 'C'): Promise<{
+            success: boolean;
+            amount?: number;
+            new_balance?: number;
+            duplicate?: boolean;
+            claim_id?: string;
+            error?: string;
+        }>;
+    };
     economy: {
         redeemPurchase<T extends Record<string, any>>(token: string): Promise<{
             success: boolean;

package/package.json

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

package/src/v1.ts

@@ -260,6 +260,35 @@ export interface SpawnServerSDK__V1<TConfig = any> {
      * List all document names for this variant.
      */
     list(): Promise<string[]>;
+
+    /**
+     * Acquire a distributed lock on a key. Blocks until lock is acquired or timeout.
+     * Always use try/finally to ensure unlock() is called.
+     *
+     * @example
+     * await sdk.documents.lock("leaderboard");
+     * try {
+     *   const data = await sdk.documents.get("leaderboard");
+     *   // ... mutate data ...
+     *   await sdk.documents.set("leaderboard", data);
+     * } finally {
+     *   await sdk.documents.unlock("leaderboard");
+     * }
+     */
+    lock(
+      key: string,
+      options?: {
+        /** Auto-expire if worker crashes (default: 30000ms) */
+        ttlMs?: number;
+        /** Max time to wait for lock (default: 10000ms) */
+        waitMs?: number;
+      }
+    ): Promise<void>;
+
+    /**
+     * Release a distributed lock. Must be called after lock() in a finally block.
+     */
+    unlock(key: string): Promise<void>;
   };
 
   config: {
@@ -268,6 +297,24 @@ export interface SpawnServerSDK__V1<TConfig = any> {
     effectiveVersion(): Promise<string>;
   };
 
+  dew: {
+    /** 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(
+      userId: string,
+      plantId: 'A' | 'B' | 'C'
+    ): Promise<{
+      success: boolean;
+      amount?: number;
+      new_balance?: number;
+      duplicate?: boolean;
+      claim_id?: string;
+      error?: string;
+    }>;
+  };
+
   economy: {
     // Redeem a purchase token from client
     redeemPurchase<T extends Record<string, any>>(