Asynkron.DurableFunctions 0.0.5

Asynkron.DurableFunctions Library

This library provides an independent durable orchestration framework inspired by orchestration concepts but with our own unique API design. This is not a drop-in replacement for any other framework - it's our own project with our own ideas.

Features

Attributes

• FunctionAttribute - Specifies the name of a function
• OrchestrationTriggerAttribute - Specifies that a parameter should be treated as an orchestration trigger

Interfaces

• IDurableOrchestrationContext - Defines the interface for a durable orchestration context with our **CallFunction ** API

Context Methods

The IDurableOrchestrationContext provides the following methods:

• CallFunction<TResult>(string name, object? input = null) - THE way to call any function asynchronously with a return value
• CreateTimer(DateTime fireAt) - Creates a timer that expires at the specified time
• WaitForExternalEvent<TResult>(string name) - Waits for an external event to be raised (each wait consumes a single queued event; repeated waits require repeated RaiseEventAsync calls)

Properties

• InstanceId - Gets the instance ID of the orchestration
• CurrentUtcDateTime - Gets the current date and time in UTC
• IsReplaying - Gets a value indicating whether the orchestration is replaying

Usage Example

using Asynkron.DurableFunctions;

public class MyOrchestrator
{
    [Function("MyOrchestrator")]
    public async Task<string> RunOrchestrator([OrchestrationTrigger] IDurableOrchestrationContext context)
    {
        // Use CallFunction - THE way to invoke functions in our framework
        var result = await context.CallFunction<string>("MyFunction", "input data");
        return result;
    }

    [Function("MyFunction")]
    public string MyFunction(string input)
    {
        return $"Processed: {input}";
    }
}

Current Status

This library provides a complete orchestration runtime with:

1. ✅ Full orchestration engine
2. ✅ Function discovery and invocation via CallFunction
3. ✅ State persistence and replay logic
4. ✅ Timer management
5. ✅ External event handling
6. ✅ Multiple storage backend support

Our Independent API

CallFunction is the cornerstone of our API design:

• Clean, simple method name
• Consistent across all function types
• No confusion about "activities" vs "functions"
• Our design, our decision