JamaisVU.Extensions 1.0.0-alpha4

JamaisVu.Framework

Ensure your operations run never before-only once.
JamaisVu is a small, flexible .NET framework that lets you guard any piece of code—background jobs, message handlers, console tools, domain services—against duplicate execution, with zero pipeline magic or attributes required.

🚀 Key Features

• Framework-agnostic
  Call a guard anywhere in your code: worker loops, event handlers, CLI tools, domain services—no filters or middleware needed.

• Pluggable stores
  Swap in-memory, Redis, SQL, or your own implementation by registering IJamaisVuStore variants via DI.

• Fluent, intent-driven API

• Result-driven control flow:

  public enum JamaisVuStatus { FirstRun, Repeated, StoreUnavailable }
  public sealed class JamaisVuResult { public JamaisVuStatus Status { get; init; } }
  
  

• DI-ready One extension wires up flow factories, guards and your store implementations.

⚙️ Installation

dotnet add package JamaisVu.Framework

📦 DI Configuration

using JamaisVu.Extensions;
using Microsoft.Extensions.DependencyInjection;

var builder = Host.CreateDefaultBuilder(args)
    .ConfigureServices(services =>
    {
        services
            .AddJamaisVu()
            .ConfigureStores(stores =>
            {
                stores.AddScoped<InMemoryJamaisVuStore>();
                stores.AddSingleton<RedisJamaisVuStore>();
                // …add your custom stores here
            });

        // …other services
    });

⚡ Quickstart

// inject JamaisVuGuard<YourStore> via DI
await _guard.ExecuteAsync(
    key: $"invoice:{orderId}",
    onFirstRunAsync:    () => ProcessInvoiceAsync(orderId),
    onRepeatedAsync:    () => SkipProcessingAsync(orderId),
    onUnavailableAsync: () => LogWarningAsync(orderId)
);

📚 API Overview

public enum JamaisVuStatus
{
    FirstRun,
    Repeated,
    StoreUnavailable
}

public sealed class JamaisVuResult
{
    public JamaisVuStatus Status { get; init; }
}

public interface IJamaisVuStore
{
    Task<JamaisVuResult> EnsureAsync(string key);
}

public interface IJamaisVuFlow
{
    IJamaisVuFlow For(string key);
    IJamaisVuFlow OnFirstRunAsync(Func<Task> action);
    IJamaisVuFlow OnRepeatedAsync(Func<Task> action);
    IJamaisVuFlow OnUnavailableAsync(Func<Task> action);
    Task EnsureAsync();
}

public class JamaisVuGuard<TStore> where TStore : IJamaisVuStore
{
    public Task ExecuteAsync(
        string key,
        Func<Task> onFirstRunAsync,
        Func<Task>? onRepeatedAsync    = null,
        Func<Task>? onUnavailableAsync = null
    );
}

🔍 Why JamaisVu?

Most libraries tie idempotency to HTTP filters, messaging outboxes, or middleware. JamaisVu gives you a pure “call-where-you-need” guard, so you decide exactly which operations run once, without hidden pipelines or attributes.

📖 License

Released under the MIT License.