Initial commit

Services/Scenarios/Sessions/BattlePassLevelSession.cs

@@ -0,0 +1,25 @@
+using System.Threading;
+using System.Threading.Tasks;
+
+namespace RudderSdk.Core;
+
+/// <summary>Session of a scenario battle-pass-level node.</summary>
+public sealed class BattlePassLevelSession
+{
+    internal BattlePassLevelSession(ScenarioNodeContext context) => Context = context;
+
+    /// <summary>Underlying node context.</summary>
+    public ScenarioNodeContext Context { get; }
+
+    /// <summary>Node id.</summary>
+    public string Id => Context.NodeId;
+
+    /// <summary>Reads a typed value from the node data.</summary>
+    public T Get<T>(string key, T defaultValue = default!) => Context.Get(key, defaultValue);
+
+    /// <summary>Advances the run through the onComplete handle.</summary>
+    public Task CompleteAsync(CancellationToken cancellationToken = default) => Context.CompleteAsync("onComplete", cancellationToken);
+
+    /// <summary>Advances the run through the onComplete handle (fire-and-forget).</summary>
+    public void Complete() => Context.Complete("onComplete");
+}

Services/Scenarios/Sessions/BattlePassSession.cs

@@ -0,0 +1,43 @@
+using System.Threading;
+using System.Threading.Tasks;
+
+namespace RudderSdk.Core;
+
+/// <summary>Session of a scenario battle-pass node.</summary>
+public sealed class BattlePassSession
+{
+    internal BattlePassSession(ScenarioNodeContext context) => Context = context;
+
+    /// <summary>Underlying node context.</summary>
+    public ScenarioNodeContext Context { get; }
+
+    /// <summary>Node id.</summary>
+    public string Id => Context.NodeId;
+
+    /// <summary>Reads a typed value from the node data.</summary>
+    public T Get<T>(string key, T defaultValue = default!) => Context.Get(key, defaultValue);
+
+    /// <summary>Advances the run through the onLevelUp handle.</summary>
+    public Task LevelUpAsync(CancellationToken cancellationToken = default) => Context.CompleteAsync("onLevelUp", cancellationToken);
+
+    /// <summary>Advances the run through the onLevelUp handle (fire-and-forget).</summary>
+    public void LevelUp() => Context.Complete("onLevelUp");
+
+    /// <summary>Advances the run through the onMaxLevel handle.</summary>
+    public Task MaxLevelAsync(CancellationToken cancellationToken = default) => Context.CompleteAsync("onMaxLevel", cancellationToken);
+
+    /// <summary>Advances the run through the onMaxLevel handle (fire-and-forget).</summary>
+    public void MaxLevel() => Context.Complete("onMaxLevel");
+
+    /// <summary>Advances the run through the onPremiumPurchase handle.</summary>
+    public Task PremiumPurchaseAsync(CancellationToken cancellationToken = default) => Context.CompleteAsync("onPremiumPurchase", cancellationToken);
+
+    /// <summary>Advances the run through the onPremiumPurchase handle (fire-and-forget).</summary>
+    public void PremiumPurchase() => Context.Complete("onPremiumPurchase");
+
+    /// <summary>Advances the run through the onComplete handle.</summary>
+    public Task CompleteAsync(CancellationToken cancellationToken = default) => Context.CompleteAsync("onComplete", cancellationToken);
+
+    /// <summary>Advances the run through the onComplete handle (fire-and-forget).</summary>
+    public void Complete() => Context.Complete("onComplete");
+}

Services/Scenarios/Sessions/ConfigChangedSession.cs

@@ -0,0 +1,13 @@
+namespace RudderSdk.Core;
+
+/// <summary>
+/// Session of a scenario remote-config-override node. The patches are already
+/// applied to <see cref="RemoteConfigService"/> when the event fires.
+/// </summary>
+public sealed class ConfigChangedSession
+{
+    internal ConfigChangedSession(ScenarioNodeContext context) => Context = context;
+
+    /// <summary>Underlying node context.</summary>
+    public ScenarioNodeContext Context { get; }
+}

Services/Scenarios/Sessions/LeaderboardSession.cs

@@ -0,0 +1,31 @@
+using System.Threading;
+using System.Threading.Tasks;
+
+namespace RudderSdk.Core;
+
+/// <summary>Session of a scenario leaderboard node.</summary>
+public sealed class LeaderboardSession
+{
+    internal LeaderboardSession(ScenarioNodeContext context) => Context = context;
+
+    /// <summary>Underlying node context.</summary>
+    public ScenarioNodeContext Context { get; }
+
+    /// <summary>Node id.</summary>
+    public string Id => Context.NodeId;
+
+    /// <summary>Reads a typed value from the node data.</summary>
+    public T Get<T>(string key, T defaultValue = default!) => Context.Get(key, defaultValue);
+
+    /// <summary>Advances the run through the onEnd handle.</summary>
+    public Task EndAsync(CancellationToken cancellationToken = default) => Context.CompleteAsync("onEnd", cancellationToken);
+
+    /// <summary>Advances the run through the onEnd handle (fire-and-forget).</summary>
+    public void End() => Context.Complete("onEnd");
+
+    /// <summary>Advances the run through the onRewardClaimed handle.</summary>
+    public Task RewardClaimedAsync(CancellationToken cancellationToken = default) => Context.CompleteAsync("onRewardClaimed", cancellationToken);
+
+    /// <summary>Advances the run through the onRewardClaimed handle (fire-and-forget).</summary>
+    public void RewardClaimed() => Context.Complete("onRewardClaimed");
+}

Services/Scenarios/Sessions/NotificationSession.cs

@@ -0,0 +1,25 @@
+using System.Threading;
+using System.Threading.Tasks;
+
+namespace RudderSdk.Core;
+
+/// <summary>Session of a scenario notification node.</summary>
+public sealed class NotificationSession
+{
+    internal NotificationSession(ScenarioNodeContext context) => Context = context;
+
+    /// <summary>Underlying node context.</summary>
+    public ScenarioNodeContext Context { get; }
+
+    /// <summary>Node id.</summary>
+    public string Id => Context.NodeId;
+
+    /// <summary>Reads a typed value from the node data.</summary>
+    public T Get<T>(string key, T defaultValue = default!) => Context.Get(key, defaultValue);
+
+    /// <summary>Advances the run through the output handle.</summary>
+    public Task CompleteAsync(CancellationToken cancellationToken = default) => Context.CompleteAsync("output", cancellationToken);
+
+    /// <summary>Advances the run through the output handle (fire-and-forget).</summary>
+    public void Complete() => Context.Complete("output");
+}

Services/Scenarios/Sessions/QuestSession.cs

@@ -0,0 +1,37 @@
+using System.Threading;
+using System.Threading.Tasks;
+
+namespace RudderSdk.Core;
+
+/// <summary>Session of a scenario quest node.</summary>
+public sealed class QuestSession
+{
+    internal QuestSession(ScenarioNodeContext context) => Context = context;
+
+    /// <summary>Underlying node context.</summary>
+    public ScenarioNodeContext Context { get; }
+
+    /// <summary>Node id.</summary>
+    public string Id => Context.NodeId;
+
+    /// <summary>Reads a typed value from the node data.</summary>
+    public T Get<T>(string key, T defaultValue = default!) => Context.Get(key, defaultValue);
+
+    /// <summary>Adds progress to one of the node's counters.</summary>
+    public Task AddProgressAsync(string counterKey, long amount, CancellationToken cancellationToken = default) => Context.AddProgressAsync(counterKey, amount, cancellationToken);
+
+    /// <summary>Adds progress to one of the node's counters (fire-and-forget).</summary>
+    public void AddProgress(string counterKey, long amount) => _ = AddProgressAsync(counterKey, amount);
+
+    /// <summary>Advances the run through the onComplete handle.</summary>
+    public Task CompleteAsync(CancellationToken cancellationToken = default) => Context.CompleteAsync("onComplete", cancellationToken);
+
+    /// <summary>Advances the run through the onComplete handle (fire-and-forget).</summary>
+    public void Complete() => Context.Complete("onComplete");
+
+    /// <summary>Advances the run through the onFail handle.</summary>
+    public Task FailAsync(CancellationToken cancellationToken = default) => Context.CompleteAsync("onFail", cancellationToken);
+
+    /// <summary>Advances the run through the onFail handle (fire-and-forget).</summary>
+    public void Fail() => Context.Complete("onFail");
+}

Services/Scenarios/Sessions/StoreOfferSession.cs

@@ -0,0 +1,56 @@
+using System.Collections.Generic;
+using System.Threading;
+using System.Threading.Tasks;
+
+namespace RudderSdk.Core;
+
+/// <summary>Session of a scenario store-offer node; resolve it with a purchase or a decline.</summary>
+public sealed class StoreOfferSession
+{
+    internal StoreOfferSession(ScenarioNodeContext context)
+    {
+        Context = context;
+        Data = context.AsObjectDictionary();
+    }
+
+    /// <summary>Underlying node context.</summary>
+    public ScenarioNodeContext Context { get; }
+
+    /// <summary>Node id.</summary>
+    public string Id => Context.NodeId;
+
+    /// <summary>Node data payload.</summary>
+    public IReadOnlyDictionary<string, object> Data { get; }
+
+    /// <summary>True after the session was resolved once.</summary>
+    public bool IsResolved { get; private set; }
+
+    /// <summary>Reads a typed value from the node data.</summary>
+    public T Get<T>(string key, T defaultValue = default!) => Context.Get(key, defaultValue);
+
+    /// <summary>Resolves the offer as purchased.</summary>
+    public Task PurchaseAsync(CancellationToken cancellationToken = default) => ResolveAsync("onPurchase", cancellationToken);
+
+    /// <summary>Resolves the offer as purchased (fire-and-forget).</summary>
+    public void Purchase() => Resolve("onPurchase");
+
+    /// <summary>Resolves the offer as declined.</summary>
+    public Task DeclineAsync(CancellationToken cancellationToken = default) => ResolveAsync("onDecline", cancellationToken);
+
+    /// <summary>Resolves the offer as declined (fire-and-forget).</summary>
+    public void Decline() => Resolve("onDecline");
+
+    private async Task ResolveAsync(string handle, CancellationToken cancellationToken)
+    {
+        if (IsResolved) return;
+        IsResolved = true;
+        await Context.CompleteAsync(handle, cancellationToken).ConfigureAwait(false);
+    }
+
+    private void Resolve(string handle)
+    {
+        if (IsResolved) return;
+        IsResolved = true;
+        Context.Complete(handle);
+    }
+}

Services/Scenarios/Sessions/WaitSession.cs

@@ -0,0 +1,19 @@
+using System;
+
+namespace RudderSdk.Core;
+
+/// <summary>Session of a scenario wait node; the run continues automatically at the deadline.</summary>
+public sealed class WaitSession
+{
+    internal WaitSession(ScenarioNodeContext context, DateTimeOffset deadlineUtc)
+    {
+        Context = context;
+        DeadlineUtc = deadlineUtc;
+    }
+
+    /// <summary>Underlying node context.</summary>
+    public ScenarioNodeContext Context { get; }
+
+    /// <summary>When the wait ends (UTC).</summary>
+    public DateTimeOffset DeadlineUtc { get; }
+}