refactor(audience-sdk): introduce EventNames

Names the auto-fired and typed event-name strings so runtime emit and the sample-app catalogue read
from one place.

- Constants.cs: adds EventNames with SessionStart, SessionEnd, SessionHeartbeat, GameLaunch,
  Progression, Resource, Purchase, MilestoneReached.
- Session.cs: SafeTrack calls for session_start / session_end / session_heartbeat read from
  EventNames.
- ImmutableAudience.cs: auto-fired game_launch event reads from EventNames.GameLaunch.
- TypedEvents.cs: Progression / Resource / Purchase / MilestoneReached EventName properties read
  from EventNames.
- AudienceSample.Events.cs: typed-event catalogue and the BuildTypedEvent dispatch read from
  EventNames.

Author: ImmutableJeffrey

examples/audience/Assets/SampleApp/Scripts/AudienceSample.Events.cs

@@ -51,7 +51,7 @@ internal readonly struct EventSpec
                 EventField.Text("platform", optional: true),
             }),
             new EventSpec("wishlist_remove", new[] { EventField.Text("gameId") }),
-            new EventSpec("purchase",        new[] {
+            new EventSpec(EventNames.Purchase, new[] {
                 EventField.Text("currency"),
                 EventField.Number("value"),
                 EventField.Text("itemId",        optional: true),
@@ -62,22 +62,22 @@ internal readonly struct EventSpec
             // game_launch is deliberately absent. The Event Reference v1 defines
             // it as auto-tracked on Init with no public typed class; firing it
             // from the Send button would double-emit.
-            new EventSpec("progression", new[] {
+            new EventSpec(EventNames.Progression, new[] {
                 EventField.Enum("status", new[] { "start", "complete", "fail" }),
                 EventField.Text("world",         optional: true),
                 EventField.Text("level",         optional: true),
                 EventField.Text("stage",         optional: true),
                 EventField.Number("score",       optional: true),
                 EventField.Number("durationSec", optional: true),
             }),
-            new EventSpec("resource", new[] {
+            new EventSpec(EventNames.Resource, new[] {
                 EventField.Enum("flow", new[] { "sink", "source" }),
                 EventField.Text("currency"),
                 EventField.Number("amount"),
                 EventField.Text("itemType", optional: true),
                 EventField.Text("itemId",   optional: true),
             }),
-            new EventSpec("milestone_reached", new[] { EventField.Text("name") }),
+            new EventSpec(EventNames.MilestoneReached, new[] { EventField.Text("name") }),
             new EventSpec("game_page_viewed",  new[] {
                 EventField.Text("gameId"),
                 EventField.Text("gameName", optional: true),
@@ -99,7 +99,7 @@ internal readonly struct EventSpec
         {
             switch (name)
             {
-                case "progression":
+                case EventNames.Progression:
                     return new Progression
                     {
                         Status = ParseProgressionStatus(props),
@@ -109,7 +109,7 @@ internal readonly struct EventSpec
                         Score = OptionalInt(props, "score"),
                         DurationSec = OptionalFloat(props, "durationSec"),
                     };
-                case "resource":
+                case EventNames.Resource:
                     return new Resource
                     {
                         Flow = ParseResourceFlow(props),
@@ -118,7 +118,7 @@ internal readonly struct EventSpec
                         ItemType = OptionalString(props, "itemType"),
                         ItemId = OptionalString(props, "itemId"),
                     };
-                case "purchase":
+                case EventNames.Purchase:
                     return new Purchase
                     {
                         Currency = OptionalString(props, "currency") ?? "",
@@ -128,7 +128,7 @@ internal readonly struct EventSpec
                         Quantity = OptionalInt(props, "quantity"),
                         TransactionId = OptionalString(props, "transactionId"),
                     };
-                case "milestone_reached":
+                case EventNames.MilestoneReached:
                     return new MilestoneReached { Name = OptionalString(props, "name") ?? "" };
                 default:
                     return null;

src/Packages/Audience/Runtime/Core/Constants.cs

@@ -76,6 +76,24 @@ internal static class ResponseFields
         internal const string Rejected = "rejected";
     }
 
+    // Event names we send on Track.
+    internal static class EventNames
+    {
+        // Session lifecycle (auto-fired)
+        internal const string SessionStart = "session_start";
+        internal const string SessionEnd = "session_end";
+        internal const string SessionHeartbeat = "session_heartbeat";
+
+        // Init lifecycle (auto-fired)
+        internal const string GameLaunch = "game_launch";
+
+        // Typed events (IEvent implementations)
+        internal const string Progression = "progression";
+        internal const string Resource = "resource";
+        internal const string Purchase = "purchase";
+        internal const string MilestoneReached = "milestone_reached";
+    }
+
     // Wire-format field names that cross module boundaries inside the SDK
     // (read by one module, written by another).
     internal static class MessageFields

src/Packages/Audience/Runtime/Core/Session.cs

@@ -101,7 +101,7 @@ internal void Start()
                 _heartbeatTimer = new Timer(_ => OnHeartbeat(), null, _heartbeatIntervalMs, _heartbeatIntervalMs);
             }
 
-            SafeTrack("session_start", new Dictionary<string, object>
+            SafeTrack(EventNames.SessionStart, new Dictionary<string, object>
             {
                 ["sessionId"] = sessionId
             });
@@ -177,7 +177,7 @@ internal void End()
 
             // duration is engagement-aware (excludes pause). Web SDK emits
             // wall-clock; dashboards should not assume parity.
-            SafeTrack("session_end", new Dictionary<string, object>
+            SafeTrack(EventNames.SessionEnd, new Dictionary<string, object>
             {
                 ["sessionId"] = sessionId,
                 ["durationSec"] = duration
@@ -202,7 +202,7 @@ internal void EmitEndAndSeal()
                 ResetSessionStateLocked();
             }
 
-            SafeTrack("session_end", new Dictionary<string, object>
+            SafeTrack(EventNames.SessionEnd, new Dictionary<string, object>
             {
                 ["sessionId"] = sessionId,
                 ["durationSec"] = duration
@@ -250,7 +250,7 @@ internal void OnHeartbeat()
                 ["durationSec"] = duration
             };
 
-            SafeTrack("session_heartbeat", properties);
+            SafeTrack(EventNames.SessionHeartbeat, properties);
         }
 
         // Stops exceptions from the track callback from reaching upstream.

src/Packages/Audience/Runtime/Events/TypedEvents.cs

@@ -78,7 +78,7 @@ public class Progression : IEvent
         public float? DurationSec { get; set; }
 
         /// <inheritdoc/>
-        public string EventName => "progression";
+        public string EventName => EventNames.Progression;
 
         /// <inheritdoc/>
         public Dictionary<string, object> ToProperties()
@@ -163,7 +163,7 @@ public class Resource : IEvent
         public string? ItemId { get; set; }
 
         /// <inheritdoc/>
-        public string EventName => "resource";
+        public string EventName => EventNames.Resource;
 
         /// <inheritdoc/>
         public Dictionary<string, object> ToProperties()
@@ -227,7 +227,7 @@ public class Purchase : IEvent
         public string? TransactionId { get; set; }
 
         /// <inheritdoc/>
-        public string EventName => "purchase";
+        public string EventName => EventNames.Purchase;
 
         // Hand-rolled to avoid pulling System.Text.RegularExpressions into the IL2CPP build.
         private static bool IsIso4217(string s)
@@ -278,7 +278,7 @@ public class MilestoneReached : IEvent
         public string? Name { get; set; }
 
         /// <inheritdoc/>
-        public string EventName => "milestone_reached";
+        public string EventName => EventNames.MilestoneReached;
 
         /// <inheritdoc/>
         public Dictionary<string, object> ToProperties()

src/Packages/Audience/Runtime/ImmutableAudience.cs

@@ -1020,7 +1020,7 @@ private static void FireGameLaunch(AudienceConfig config, ConsentLevel consentAt
 
             // No sessionId on game_launch per Event Reference. Pipeline correlates
             // via eventTimestamp with the session_start that fires just before.
-            Track("game_launch", properties.Count > 0 ? properties : null);
+            Track(EventNames.GameLaunch, properties.Count > 0 ? properties : null);
         }
     }
 }