Prepare v0.5.0 release

Author: teesofttech

README.md

@@ -411,16 +411,41 @@ export TERMII_API_KEY="your-termii-api-key"
 dotnet run --project examples/Termii.Examples
 ```
 
+Run the offline webhook signature example:
+
+```bash
+export TERMII_EXAMPLE_ACTION="webhook-signature"
+dotnet run --project examples/Termii.Examples
+```
+
 Run a live balance example:
 
 ```bash
+export TERMII_API_KEY="your-termii-api-key"
 export TERMII_EXAMPLE_ACTION="balance"
 dotnet run --project examples/Termii.Examples
 ```
 
+List phonebooks with a read-only live example:
+
+```bash
+export TERMII_API_KEY="your-termii-api-key"
+export TERMII_EXAMPLE_ACTION="phonebooks-list"
+dotnet run --project examples/Termii.Examples
+```
+
+List campaigns with a read-only live example:
+
+```bash
+export TERMII_API_KEY="your-termii-api-key"
+export TERMII_EXAMPLE_ACTION="campaigns-list"
+dotnet run --project examples/Termii.Examples
+```
+
 Send a live Number API example message:
 
 ```bash
+export TERMII_API_KEY="your-termii-api-key"
 export TERMII_EXAMPLE_ACTION="number-message"
 export TERMII_EXAMPLE_PHONE_NUMBER="2348012345678"
 dotnet run --project examples/Termii.Examples

examples/Termii.Examples/Program.cs

@@ -1,10 +1,26 @@
+using System.Security.Cryptography;
+using System.Text;
 using Termii;
 
+var action = Environment.GetEnvironmentVariable("TERMII_EXAMPLE_ACTION");
+
+if (string.Equals(action, "webhook-signature", StringComparison.OrdinalIgnoreCase))
+{
+    const string payload = """{"type":"delivery_report","message_id":"msg-123","status":"delivered"}""";
+    const string secretKey = "example-webhook-secret";
+    var signature = CreateWebhookSignature(payload, secretKey);
+    var verified = TermiiWebhookSignature.Verify(payload, signature, secretKey);
+
+    Console.WriteLine($"Webhook signature verified: {verified}");
+    return;
+}
+
 var apiKey = Environment.GetEnvironmentVariable("TERMII_API_KEY");
 
 if (string.IsNullOrWhiteSpace(apiKey))
 {
-    Console.WriteLine("Set TERMII_API_KEY to run the Termii examples.");
+    Console.WriteLine("Set TERMII_API_KEY to run live Termii examples.");
+    Console.WriteLine("Set TERMII_EXAMPLE_ACTION=webhook-signature to run the offline webhook signature example.");
     return;
 }
 
@@ -15,7 +31,6 @@
 
 Console.WriteLine($"Termii client configured for {client.Options.BaseUrl}.");
 
-var action = Environment.GetEnvironmentVariable("TERMII_EXAMPLE_ACTION");
 var phoneNumber = Environment.GetEnvironmentVariable("TERMII_EXAMPLE_PHONE_NUMBER");
 
 if (string.Equals(action, "balance", StringComparison.OrdinalIgnoreCase))
@@ -26,6 +41,30 @@
     return;
 }
 
+if (string.Equals(action, "phonebooks-list", StringComparison.OrdinalIgnoreCase))
+{
+    var phonebooks = await client.Campaigns.GetPhonebooksAsync(new GetPhonebooksRequest
+    {
+        Page = 0,
+        Size = 10,
+    });
+
+    Console.WriteLine($"Phonebooks returned: {phonebooks.Content.Count}");
+    return;
+}
+
+if (string.Equals(action, "campaigns-list", StringComparison.OrdinalIgnoreCase))
+{
+    var campaigns = await client.Campaigns.GetCampaignsAsync(new GetCampaignsRequest
+    {
+        Page = 0,
+        Size = 10,
+    });
+
+    Console.WriteLine($"Campaigns returned: {campaigns.Content.Count}");
+    return;
+}
+
 if (string.Equals(action, "number-message", StringComparison.OrdinalIgnoreCase))
 {
     if (string.IsNullOrWhiteSpace(phoneNumber))
@@ -44,4 +83,18 @@
     return;
 }
 
-Console.WriteLine("Set TERMII_EXAMPLE_ACTION=balance or TERMII_EXAMPLE_ACTION=number-message to run a live example.");
+Console.WriteLine("Set TERMII_EXAMPLE_ACTION to one of: balance, phonebooks-list, campaigns-list, number-message, webhook-signature.");
+
+static string CreateWebhookSignature(string payload, string secretKey)
+{
+    using var hmac = new HMACSHA512(Encoding.UTF8.GetBytes(secretKey));
+    var hash = hmac.ComputeHash(Encoding.UTF8.GetBytes(payload));
+    var builder = new StringBuilder(hash.Length * 2);
+
+    foreach (var value in hash)
+    {
+        builder.Append(value.ToString("x2"));
+    }
+
+    return builder.ToString();
+}

src/Termii/Termii.csproj

@@ -4,9 +4,9 @@
     <AssemblyName>Termii</AssemblyName>
     <RootNamespace>Termii</RootNamespace>
     <PackageId>Termii.SDK</PackageId>
-    <VersionPrefix>0.4.0</VersionPrefix>
+    <VersionPrefix>0.5.0</VersionPrefix>
     <Description>A .NET SDK for the Termii messaging, token, and insights APIs, compatible with .NET Core 3.1 through .NET 10.</Description>
-    <PackageReleaseNotes>Add Campaign phonebook APIs, product notification email API, and WhatsApp template message APIs.</PackageReleaseNotes>
+    <PackageReleaseNotes>Add Contacts APIs, full Campaign APIs, webhook signature verification, and expanded examples.</PackageReleaseNotes>
     <PackageTags>termii;sms;otp;messaging;dotnet;sdk;netstandard2.0;netcoreapp3.1;net10</PackageTags>
     <GenerateDocumentationFile>true</GenerateDocumentationFile>
     <NoWarn>$(NoWarn);1591</NoWarn>