Update readme.md and func samples with recent changes (#114)

Author: jviau

README.md

@@ -3,13 +3,11 @@
 [![Build status](https://github.com/microsoft/durabletask-dotnet/workflows/Validate%20Build/badge.svg)](https://github.com/microsoft/durabletask-dotnet/actions?workflow=Validate+Build)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 
-⚠ This project is not yet ready for production use ⚠
-
 The Durable Task .NET Client SDK is a .NET Standard 2.0 library for implementing Durable Task orchestrations and activities. It's specifically designed to connect to a "sidecar" process, such as the [Azure Functions .NET Isolated host](https://docs.microsoft.com/azure/azure-functions/dotnet-isolated-process-guide), a special purpose sidecar container, or potentially even [Dapr](https://github.com/dapr/dapr/issues/4576).
 
 If you're looking to run fully self-hosted Durable Task Framework apps, see https://github.com/azure/durabletask.
 
-*Current Release*: [v1.0.0-rc.1](https://github.com/microsoft/durabletask-dotnet/releases/tag/v1.0.0-rc.1)
+*Current Release*: [v1.0.0](https://github.com/microsoft/durabletask-dotnet/releases/tag/v1.0.0)
 
 ## NuGet packages
 
@@ -34,7 +32,7 @@ To get started, add the [Microsoft.Azure.Functions.Worker.Extensions.DurableTask
 ```xml
   <ItemGroup>
     <PackageReference Include="Microsoft.Azure.Functions.Worker" Version="1.10.0" />
-    <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.DurableTask" Version="1.0.0-rc.1" />
+    <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.DurableTask" Version="1.0.0" />
     <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.Http" Version="3.0.13" />
     <PackageReference Include="Microsoft.Azure.Functions.Worker.Sdk" Version="1.7.0" OutputItemType="Analyzer" />
     <PackageReference Include="Microsoft.DurableTask.Generators" Version="1.0.0-preview.1" OutputItemType="Analyzer" />
@@ -47,6 +45,7 @@ You can then use the following code to define a simple "Hello, cities" durable o
 using Microsoft.Azure.Functions.Worker;
 using Microsoft.Azure.Functions.Worker.Http;
 using Microsoft.DurableTask;
+using Microsoft.DurableTask.Client;
 using Microsoft.Extensions.Logging;
 
 namespace IsolatedFunctionApp1.Untyped;
@@ -56,15 +55,15 @@ static class HelloSequenceUntyped
     [Function(nameof(StartHelloCitiesUntyped))]
     public static async Task<HttpResponseData> StartHelloCitiesUntyped(
         [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post")] HttpRequestData req,
-        [DurableClient] DurableClientContext durableContext,
+        [DurableClient] DurableTaskClient client,
         FunctionContext executionContext)
     {
         ILogger logger = executionContext.GetLogger(nameof(StartHelloCitiesUntyped));
 
-        string instanceId = await durableContext.Client.ScheduleNewOrchestrationInstanceAsync(nameof(HelloCitiesUntyped));
+        string instanceId = await client.ScheduleNewOrchestrationInstanceAsync(nameof(HelloCitiesUntyped));
         logger.LogInformation("Created new orchestration with instance ID = {instanceId}", instanceId);
 
-        return durableContext.CreateCheckStatusResponse(req, instanceId);
+        return client.CreateCheckStatusResponse(req, instanceId);
     }
 
     [Function(nameof(HelloCitiesUntyped))]
@@ -101,6 +100,7 @@ The source generators also generate type-safe extension methods on the `client`
 using Microsoft.Azure.Functions.Worker;
 using Microsoft.Azure.Functions.Worker.Http;
 using Microsoft.DurableTask;
+using Microsoft.DurableTask.Client;
 using Microsoft.Extensions.Logging;
 
 namespace IsolatedFunctionApp1.Typed;
@@ -110,15 +110,15 @@ public static class HelloCitiesTypedStarter
     [Function(nameof(StartHelloCitiesTyped))]
     public static async Task<HttpResponseData> StartHelloCitiesTyped(
         [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post")] HttpRequestData req,
-        [DurableClient] DurableClientContext durableContext,
+        [DurableClient] DurableTaskClient client,
         FunctionContext executionContext)
     {
         ILogger logger = executionContext.GetLogger(nameof(StartHelloCitiesTyped));
 
-        string instanceId = await durableContext.Client.ScheduleNewHelloCitiesTypedInstanceAsync();
+        string instanceId = await client.ScheduleNewHelloCitiesTypedInstanceAsync();
         logger.LogInformation("Created new orchestration with instance ID = {instanceId}", instanceId);
 
-        return durableContext.CreateCheckStatusResponse(req, instanceId);
+        return client.CreateCheckStatusResponse(req, instanceId);
     }
 }
 

samples/AzureFunctionsApp/AzureFunctionsApp.cs

@@ -0,0 +1,58 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+
+using Microsoft.Azure.Functions.Worker;
+using Microsoft.Azure.Functions.Worker.Http;
+using Microsoft.DurableTask;
+using Microsoft.DurableTask.Client;
+using Microsoft.Extensions.Logging;
+
+namespace Company.Function
+{
+    public static class AzureFunctionsApp
+    {
+        [Function(nameof(AzureFunctionsApp))]
+        public static async Task<List<string>> RunOrchestrator(
+            [OrchestrationTrigger] TaskOrchestrationContext context)
+        {
+            ILogger logger = context.CreateReplaySafeLogger(nameof(AzureFunctionsApp));
+            logger.LogInformation("Saying hello.");
+            var outputs = new List<string>();
+
+            // Replace name and input with values relevant for your Durable Functions Activity
+            outputs.Add(await context.CallActivityAsync<string>(nameof(SayHello), "Tokyo"));
+            outputs.Add(await context.CallActivityAsync<string>(nameof(SayHello), "Seattle"));
+            outputs.Add(await context.CallActivityAsync<string>(nameof(SayHello), "London"));
+
+            // returns ["Hello Tokyo!", "Hello Seattle!", "Hello London!"]
+            return outputs;
+        }
+
+        [Function(nameof(SayHello))]
+        public static string SayHello([ActivityTrigger] string name, FunctionContext executionContext)
+        {
+            ILogger logger = executionContext.GetLogger("SayHello");
+            logger.LogInformation($"Saying hello to {name}.");
+            return $"Hello {name}!";
+        }
+
+        [Function("AzureFunctionsApp_HttpStart")]
+        public static async Task<HttpResponseData> HttpStart(
+            [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post")] HttpRequestData req,
+            [DurableClient] DurableTaskClient client,
+            FunctionContext executionContext)
+        {
+            ILogger logger = executionContext.GetLogger("AzureFunctionsApp_HttpStart");
+
+            // Function input comes from the request content.
+            string instanceId = await client
+                .ScheduleNewOrchestrationInstanceAsync(nameof(AzureFunctionsApp));
+
+            logger.LogInformation($"Started orchestration with ID = '{instanceId}'.");
+
+            // Returns an HTTP 202 response with an instance management payload.
+            // See https://learn.microsoft.com/azure/azure-functions/durable/durable-functions-http-api#start-orchestration
+            return client.CreateCheckStatusResponse(req, instanceId);
+        }
+    }
+}

samples/AzureFunctionsApp/AzureFunctionsApp.csproj

@@ -9,7 +9,7 @@
 
   <ItemGroup>
     <PackageReference Include="Microsoft.Azure.Functions.Worker" Version="1.10.0" />
-    <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.DurableTask" Version="1.0.0-rc.1" />
+    <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.DurableTask" Version="1.0.0" />
     <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.Http" Version="3.0.13" />
     <PackageReference Include="Microsoft.Azure.Functions.Worker.Sdk" Version="1.7.0" OutputItemType="Analyzer" />
     <PackageReference Include="Microsoft.DurableTask.Generators" Version="1.0.0-preview.1" OutputItemType="Analyzer" />

samples/AzureFunctionsApp/Fib.cs

@@ -4,6 +4,7 @@
 using Microsoft.Azure.Functions.Worker;
 using Microsoft.Azure.Functions.Worker.Http;
 using Microsoft.DurableTask;
+using Microsoft.DurableTask.Client;
 using Microsoft.Extensions.Logging;
 
 namespace AzureFunctionsApp;
@@ -23,17 +24,17 @@ static class Fib
     [Function(nameof(Fib))]
     public static async Task<HttpResponseData> Start(
         [HttpTrigger(AuthorizationLevel.Anonymous, "post")] HttpRequestData req,
-        [DurableClient] DurableClientContext durableContext,
+        [DurableClient] DurableTaskClient client,
         FunctionContext executionContext)
     {
         ILogger logger = executionContext.GetLogger(nameof(Fib));
 
         int? payload = await req.ReadFromJsonAsync<int>();
-        string instanceId = await durableContext.Client
+        string instanceId = await client
             .ScheduleNewOrchestrationInstanceAsync(nameof(FibOrchestration), payload);
         logger.LogInformation("Created new orchestration with instance ID = {instanceId}", instanceId);
 
-        return durableContext.CreateCheckStatusResponse(req, instanceId);
+        return client.CreateCheckStatusResponse(req, instanceId);
     }
 
     [Function(nameof(FibOrchestration))]

samples/AzureFunctionsApp/HelloCitiesTyped.cs

@@ -5,6 +5,7 @@
 using Microsoft.Azure.Functions.Worker;
 using Microsoft.Azure.Functions.Worker.Http;
 using Microsoft.Extensions.Logging;
+using Microsoft.DurableTask.Client;
 
 namespace AzureFunctionsApp.Typed;
 
@@ -14,13 +15,13 @@ public static class HelloCitiesTypedStarter
     /// HTTP-triggered function that starts the <see cref="HelloCitiesTyped"/> orchestration.
     /// </summary>
     /// <param name="req">The HTTP request that was used to trigger this function.</param>
-    /// <param name="durableContext">The Durable Functions client binding context object that is used to start and manage orchestration instances.</param>
+    /// <param name="client">The Durable Functions client that is used to start and manage orchestration instances.</param>
     /// <param name="executionContext">The Azure Functions execution context, which is available to all function types.</param>
     /// <returns>Returns an HTTP response with more information about the started orchestration instance.</returns>
     [Function(nameof(StartHelloCitiesTyped))]
     public static async Task<HttpResponseData> StartHelloCitiesTyped(
         [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post")] HttpRequestData req,
-        [DurableClient] DurableClientContext durableContext,
+        [DurableClient] DurableTaskClient client,
         FunctionContext executionContext)
     {
         ILogger logger = executionContext.GetLogger(nameof(StartHelloCitiesTyped));
@@ -30,9 +31,9 @@ public static async Task<HttpResponseData> StartHelloCitiesTyped(
         // are based on the names of the orchestrator classes. Note that the source generator will *not*
         // generate type-safe extension methods for non-class-based orchestrator functions.
         // NOTE: This feature is in PREVIEW and requires a package reference to Microsoft.DurableTask.Generators.
-        string instanceId = await durableContext.Client.ScheduleNewHelloCitiesTypedInstanceAsync();
+        string instanceId = await client.ScheduleNewHelloCitiesTypedInstanceAsync();
         logger.LogInformation("Created new orchestration with instance ID = {instanceId}", instanceId);
-        return durableContext.CreateCheckStatusResponse(req, instanceId);
+        return client.CreateCheckStatusResponse(req, instanceId);
     }
 }
 

samples/AzureFunctionsApp/HelloCitiesUntyped.cs

@@ -4,6 +4,7 @@
 using Microsoft.Azure.Functions.Worker;
 using Microsoft.Azure.Functions.Worker.Http;
 using Microsoft.DurableTask;
+using Microsoft.DurableTask.Client;
 using Microsoft.Extensions.Logging;
 
 namespace AzureFunctionsApp.Untyped;
@@ -19,21 +20,21 @@ static class HelloSequenceUntyped
     /// HTTP-triggered function that starts the <see cref="HelloCitiesUntyped"/> orchestration.
     /// </summary>
     /// <param name="req">The HTTP request that was used to trigger this function.</param>
-    /// <param name="durableContext">The Durable Functions client binding context object that is used to start and manage orchestration instances.</param>
+    /// <param name="client">The Durable Functions client that is used to start and manage orchestration instances.</param>
     /// <param name="executionContext">The Azure Functions execution context, which is available to all function types.</param>
     /// <returns>Returns an HTTP response with more information about the started orchestration instance.</returns>
     [Function(nameof(StartHelloCitiesUntyped))]
     public static async Task<HttpResponseData> StartHelloCitiesUntyped(
         [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post")] HttpRequestData req,
-        [DurableClient] DurableClientContext durableContext,
+        [DurableClient] DurableTaskClient client,
         FunctionContext executionContext)
     {
         ILogger logger = executionContext.GetLogger(nameof(StartHelloCitiesUntyped));
 
-        string instanceId = await durableContext.Client.ScheduleNewOrchestrationInstanceAsync(nameof(HelloCitiesUntyped));
+        string instanceId = await client.ScheduleNewOrchestrationInstanceAsync(nameof(HelloCitiesUntyped));
         logger.LogInformation("Created new orchestration with instance ID = {instanceId}", instanceId);
 
-        return durableContext.CreateCheckStatusResponse(req, instanceId);
+        return client.CreateCheckStatusResponse(req, instanceId);
     }
 
     /// <summary>