Added docs and test

Packages/com.darkmattergameproduction.com.darkmatter.fonepay-unity/Tests/Runtime/Darkmatter.FonepayUnity.Runtime.Tests.asmdef

@@ -0,0 +1,21 @@
+{
+    "name": "Darkmatter.FonepayUnity.Runtime.Tests",
+    "rootNamespace": "",
+    "references": [
+        "Darkmatter.FonepayUnity",
+        "UnityEngine.TestRunner"
+    ],
+    "includePlatforms": [],
+    "excludePlatforms": [],
+    "allowUnsafeCode": false,
+    "overrideReferences": true,
+    "precompiledReferences": [
+        "nunit.framework.dll"
+    ],
+    "autoReferenced": false,
+    "defineConstraints": [
+        "UNITY_INCLUDE_TESTS"
+    ],
+    "versionDefines": [],
+    "noEngineReferences": false
+}

Packages/com.darkmattergameproduction.com.darkmatter.fonepay-unity/Tests/Runtime/Darkmatter.FonepayUnity.Runtime.Tests.asmdef.meta

@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: 5b7c0851a1002412dadc7d1c37a4cef5
+AssemblyDefinitionImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

Packages/com.darkmattergameproduction.com.darkmatter.fonepay-unity/Tests/Runtime/FonepayRuntimeTests.cs

@@ -0,0 +1,100 @@
+using System;
+using System.Collections;
+using System.Threading;
+using System.Threading.Tasks;
+using Darkmatter.Fonepay;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Darkmatter.FonepayUnity.Tests
+{
+    public class WebsocketMessagePlayModeTests
+    {
+        [Test]
+        public void Status_ParsesNestedJsonInPlayer()
+        {
+            const string raw =
+                "{\"transactionStatus\":\"{\\\"paymentSuccess\\\":true,\\\"success\\\":true,\\\"amount\\\":7}\"}";
+
+            var envelope = JsonUtility.FromJson<WebsocketMessage<QRPaymentStatus>>(raw);
+            var status = envelope.Status;
+
+            Assert.IsTrue(status.paymentSuccess);
+            Assert.AreEqual(7f, status.amount);
+            Assert.AreEqual(PaymentOutcome.Complete, status.Outcome);
+        }
+
+        [Test]
+        public void Status_ReparsesEachAccess()
+        {
+            const string raw =
+                "{\"transactionStatus\":\"{\\\"success\\\":true,\\\"paymentSuccess\\\":true}\"}";
+
+            var envelope = JsonUtility.FromJson<WebsocketMessage<QRPaymentStatus>>(raw);
+            var a = envelope.Status;
+            var b = envelope.Status;
+
+            Assert.AreEqual(a.Outcome, b.Outcome);
+            Assert.AreEqual(PaymentOutcome.Complete, a.Outcome);
+        }
+    }
+
+    public class FonepayClientPlayModeTests
+    {
+        [SetUp]
+        public void Reset() => FonepayConfig.Invalidate();
+
+        [Test]
+        public void Ctor_WithoutConfigAsset_Throws()
+        {
+            Assert.Throws<FonepayError>(() => new FonepayClient());
+        }
+
+        [UnityTest]
+        public IEnumerator AwaitPaymentAsync_EmptyUrl_Throws() => RunAsync(async () =>
+        {
+            var client = TryBuildClient();
+            if (client == null)
+            {
+                Assert.Pass("Skipped: no FonepayConfig in test context.");
+                return;
+            }
+
+            Assert.ThrowsAsync<ArgumentException>(async () =>
+                await client.AwaitPaymentAsync(string.Empty));
+            await Task.CompletedTask;
+        });
+
+        [UnityTest]
+        public IEnumerator AwaitPaymentAsync_PreCancelled_Throws() => RunAsync(async () =>
+        {
+            var client = TryBuildClient();
+            if (client == null)
+            {
+                Assert.Pass("Skipped: no FonepayConfig in test context.");
+                return;
+            }
+
+            using var cts = new CancellationTokenSource();
+            cts.Cancel();
+
+            Assert.ThrowsAsync<OperationCanceledException>(async () =>
+                await client.AwaitPaymentAsync("ws://127.0.0.1:1/", ct: cts.Token));
+            await Task.CompletedTask;
+        });
+
+        private static FonepayClient TryBuildClient()
+        {
+            try { return new FonepayClient(); }
+            catch (FonepayError) { return null; }
+        }
+
+        private static IEnumerator RunAsync(Func<Task> body)
+        {
+            var t = body();
+            while (!t.IsCompleted) yield return null;
+            if (t.IsFaulted) throw t.Exception;
+        }
+    }
+}

Packages/com.darkmattergameproduction.com.darkmatter.fonepay-unity/Tests/Runtime/FonepayRuntimeTests.cs.meta

@@ -0,0 +1,2 @@
+fileFormatVersion: 2
+guid: 3eeb964c506324b58bd6f95c088096fa