Release 1.0.0

.github/workflows/build-check.yml

@@ -1,6 +1,9 @@
 name: Build check
 
-on: push
+on:
+  push:
+    branches: [develop]
+  pull_request:
 
 jobs:
   build-check:

.github/workflows/ci.yml

@@ -1,6 +1,9 @@
-name: Unity tests
+name: Unit tests
 
-on: push
+on:
+  push:
+    branches: [develop]
+  pull_request:
 
 jobs:
   test:

AGENTS.md

@@ -45,18 +45,22 @@ The SDK supports offline operation via `TaloSettings.offlineMode`. When offline,
 Events are batched and flushed on application quit/pause/focus loss. On WebGL, events flush every `webGLEventFlushRate` seconds (default 30s) due to platform limitations.
 
 ### Debouncing
-Player updates and save updates are debounced to prevent excessive API calls during rapid property changes. APIs that need debouncing inherit from `DebouncedAPI<TOperation>` (a generic base class) and define a `DebouncedOperation` enum for type-safe operation keys. The base class uses a dictionary to track multiple debounced operations independently.
+Player updates and save updates are debounced to prevent excessive API calls during rapid property changes. APIs that need debouncing inherit from `DebouncedAPI<TOperation, TReturnData, TUpdateResult>` and define a `DebouncedOperation` enum for type-safe operation keys. The base class uses a dictionary to track multiple debounced operations independently.
 
-The debounce is **leading and trailing**: the first call fires immediately (leading), and if further calls arrive during the debounce window they are coalesced into a single trailing call executed after the window closes. The window is defined by `debounceTimerSeconds` (default: 1s) and resets on each subsequent call.
+The debounce is **trailing**: calls are coalesced into a single API call executed after the debounce window closes. The window is defined by `debounceTimerSeconds` (default: 1s) and resets on each subsequent call. All callers in the same window share the same `Task` result.
 
 To add debouncing to an API:
 1. Define a public `enum DebouncedOperation` with your debounced operations
-2. Inherit from `DebouncedAPI<YourAPI.DebouncedOperation>`
+2. Inherit from `DebouncedAPI<YourAPI.DebouncedOperation, TReturnData, TUpdateResult>`
 3. Call `Debounce(DebouncedOperation.YourOperation)` to queue an operation
 4. Implement `ExecuteDebouncedOperation(DebouncedOperation operation)` with a switch statement
 5. The base class's `ProcessPendingUpdates()` is called by `TaloManager.Update()` every frame
 
-Example: `PlayersAPI` defines `enum DebouncedOperation { Update }` and inherits from `DebouncedAPI<PlayersAPI.DebouncedOperation>`. When `Player.SetProp()` is called, it calls `Debounce(DebouncedOperation.Update)`. The first call fires immediately; subsequent calls within the debounce window result in a single trailing API call at the end of the window.
+Example: `PlayersAPI` defines `enum DebouncedOperation { Update }` and inherits from `DebouncedAPI<PlayersAPI.DebouncedOperation, RejectedProp[], PlayersAPI.PlayerUpdateResult>`. When `Player.SetProp()` is called, it calls `Debounce(DebouncedOperation.Update)`. The first call opens a window; subsequent calls within the window extend it. A single trailing API call fires at the end of the window.
+
+#### Debounced update completion signals
+
+`Player.SetProp(...)` returns `Task<PlayerUpdateResult>`, `Talo.Saves.UpdateCurrentSave()` returns `Task<SaveUpdateResult>`. All callers in the same debounce window share the same settle result. `FlushUpdates()` returns `FlushResult` (`NothingPending`, `Success`, `Failure`). `OnPlayerUpdated(bool)` / `OnSaveUpdated(bool, GameSave)` fire after each settle. `TaloManager.OnApplicationQuit()` flushes pending updates automatically.
 
 ## Key Configuration
 

Assets/Talo Game Services/Talo/Runtime/APIs/BaseAPI.cs

@@ -9,7 +9,7 @@ namespace TaloGameServices
     public class BaseAPI
     {
         // automatically updated with a pre-commit hook
-        private const string ClientVersion = "0.60.2";
+        private const string ClientVersion = "1.0.0";
 
         protected string baseUrl;
 
@@ -145,7 +145,14 @@ protected async Task<string> Call(
                             return await Call(uri, method, content, headers, continuity);
                         }
 
-                        throw new PlayerAuthException(errorCode, new Exception(message));
+                        if (uri.AbsolutePath.Contains("/v1/players/auth/"))
+                        {
+                            throw new PlayerAuthException(errorCode, new Exception(message));
+                        }
+                        else
+                        {
+                            throw new RequestException(www.responseCode, new Exception(message), www.downloadHandler.text);
+                        }
                     }
                 }
             }

Assets/Talo Game Services/Talo/Runtime/APIs/ChannelsAPI.cs

@@ -67,9 +67,19 @@ public class CreateChannelOptions
     {
         public string name;
         public (string, string)[] props = Array.Empty<(string, string)>();
-        public bool autoCleanup = false;
-        public bool isPrivate = false;
-        public bool temporaryMembership = false;
+        public bool autoCleanup;
+        public bool isPrivate;
+        public bool temporaryMembership;
+    }
+
+    public class UpdateChannelOptions
+    {
+        public string name;
+        public int newOwnerAliasId = -1;
+        public (string, string)[] props;
+        public bool? autoCleanup = null;
+        public bool? isPrivate = null;
+        public bool? temporaryMembership = null;
     }
 
     public enum ChannelLeavingReason
@@ -86,8 +96,7 @@ public class ChannelsAPI : BaseAPI
         public event Action<Channel, PlayerAlias> OnOwnershipTransferred;
         public event Action<Channel> OnChannelDeleted;
         public event Action<Channel, string[]> OnChannelUpdated;
-        public event Action<RejectedProp[]> OnChannelPropsRejected;
-        public event Action<Channel, ChannelStoragePropError[]> OnChannelStoragePropsFailedToSet;
+        public event Action<Channel, RejectedProp[]> OnChannelStoragePropsFailedToSet;
         public event Action<Channel, ChannelStorageProp[], ChannelStorageProp[]> OnChannelStoragePropsUpdated;
 
         private readonly ChannelStorageManager _storageManager = new ();
@@ -147,12 +156,6 @@ public async Task<ChannelsIndexResponse> GetChannels(GetChannelsOptions options
             return res;
         }
 
-        [Obsolete("Use GetChannels(GetChannelsOptions options) instead.")]
-        public async Task<ChannelsIndexResponse> GetChannels(int page)
-        {
-            return await GetChannels(new GetChannelsOptions { page = page });
-        }
-
         public async Task<Channel[]> GetSubscribedChannels(GetSubscribedChannelsOptions options = null)
         {
             Talo.IdentityCheck();
@@ -166,7 +169,7 @@ public async Task<Channel[]> GetSubscribedChannels(GetSubscribedChannelsOptions
             return res.channels;
         }
 
-        private async Task<Channel> SendCreateChannelRequest(CreateChannelOptions options)
+        private async Task<ChannelUpsertResult> SendCreateChannelRequest(CreateChannelOptions options)
         {
             Talo.IdentityCheck();
 
@@ -187,50 +190,24 @@ private async Task<Channel> SendCreateChannelRequest(CreateChannelOptions option
                 var json = await Call(uri, "POST", content);
 
                 var res = JsonUtility.FromJson<ChannelResponse>(json);
-                return res.channel;
+                return new ChannelUpsertResult(true, res.channel);
             }
             catch (RequestException ex)
             {
                 if (ex.IsBadRequest())
                 {
-                    RejectedProp.TryEmit(ex.responseBody, OnChannelPropsRejected);
+                    return new ChannelUpsertResult(false, null, RejectedProp.FromJson(ex.responseBody));
                 }
                 throw;
             }
         }
 
-        public async Task<Channel> Create(CreateChannelOptions options)
+        public async Task<ChannelUpsertResult> Create(CreateChannelOptions options)
         {
             options ??= new CreateChannelOptions();
             return await SendCreateChannelRequest(options);
         }
 
-        [Obsolete("Use Create(CreateChannelOptions options) instead.")]
-        public async Task<Channel> Create(string name, bool autoCleanup = false, params (string, string)[] propTuples)
-        {
-            var options = new CreateChannelOptions
-            {
-                name = name,
-                autoCleanup = autoCleanup,
-                props = propTuples,
-                isPrivate = false
-            };
-            return await SendCreateChannelRequest(options);
-        }
-
-        [Obsolete("Use Create(CreateChannelOptions options) instead.")]
-        public async Task<Channel> CreatePrivate(string name, bool autoCleanup = false, params (string, string)[] propTuples)
-        {
-            var options = new CreateChannelOptions
-            {
-                name = name,
-                autoCleanup = autoCleanup,
-                props = propTuples,
-                isPrivate = true
-            };
-            return await SendCreateChannelRequest(options);
-        }
-
         public async Task<Channel> Join(int channelId)
         {
             Talo.IdentityCheck();
@@ -250,36 +227,37 @@ public async Task Leave(int channelId)
             await Call(uri, "POST");
         }
 
-        public async Task<Channel> Update(int channelId, string name = "", int newOwnerAliasId = -1, params (string, string)[] propTuples)
+        public async Task<ChannelUpsertResult> Update(int channelId, UpdateChannelOptions options = null)
         {
             Talo.IdentityCheck();
 
-            var props = propTuples.Select((propTuple) => new Prop(propTuple)).ToArray();
+            options ??= new UpdateChannelOptions();
 
             var uri = new Uri($"{baseUrl}/{channelId}");
 
-            var content = "";
-            if (newOwnerAliasId == -1)
-            {
-                content = JsonUtility.ToJson(new ChannelsUpdateRequest { name = name, props = props });
-            }
-            else
-            {
-                content = JsonUtility.ToJson(new ChannelsUpdateOwnerRequest { name = name, newOwnerAliasId = newOwnerAliasId, props = props });
-            }
+            var props = options.props?.Select((propTuple) => new Prop(propTuple)).ToArray();
+
+            var content = JsonUtils.BuildObject(
+                ("name", string.IsNullOrEmpty(options.name) ? null : options.name),
+                ("ownerAliasId", options.newOwnerAliasId == -1 ? null : options.newOwnerAliasId),
+                ("props", props),
+                ("autoCleanup", options.autoCleanup),
+                ("private", options.isPrivate),
+                ("temporaryMembership", options.temporaryMembership)
+            );
 
             try
             {
                 var json = await Call(uri, "PUT", content);
 
                 var res = JsonUtility.FromJson<ChannelResponse>(json);
-                return res.channel;
+                return new ChannelUpsertResult(true, res.channel);
             }
             catch (RequestException ex)
             {
                 if (ex.IsBadRequest())
                 {
-                    RejectedProp.TryEmit(ex.responseBody, OnChannelPropsRejected);
+                    return new ChannelUpsertResult(false, null, RejectedProp.FromJson(ex.responseBody));
                 }
                 throw;
             }
@@ -421,5 +399,19 @@ public async Task<ChannelStorageProp[]> ListStorageProps(int channelId, string[]
 
             return Array.Empty<ChannelStorageProp>();
         }
+
+        public class ChannelUpsertResult
+        {
+            public bool Success { get; }
+            public Channel Channel { get; }
+            public RejectedProp[] RejectedProps { get; }
+
+            public ChannelUpsertResult(bool success, Channel channel, RejectedProp[] rejectedProps = null)
+            {
+                Success = success;
+                Channel = channel;
+                RejectedProps = rejectedProps ?? Array.Empty<RejectedProp>();
+            }
+        }
     }
 }