ARE.Core 1.0.0

ARE — Action Rule Event Engine

Sıfır bağımlılık, cross-platform, hafif olay-kural-eylem motoru.

Oyun, web, mobil, masaüstü — tek motor, her yerde aynı mantık.

Event ───→ Middleware ───→ Rule Matching ───→ Action Execution
              │               │                    │
           before/after    conditions + matchMode  settings + context
                           priority + groups

Ne İşe Yarar?

Projelerde sürekli tekrar eden bir kalıp var: "Bir şey olduğunda, bazı koşullar sağlanıyorsa, şunları yap."

ARE bu kalıbı tek bir motorla çözer:

Hızlı Başlangıç

C# (.NET)

var engine = new AreEngine();

engine.RegisterAction("send_email", async (ctx, s) =>
{
    Console.WriteLine($"Email: {s.Get("template")}");
});

engine.AddRule(
    Rule.Create("vip_order")
        .On("order.created")
        .WhenGreaterThan("total", 5000.0)
        .Then("send_email", s => s.Set("template", "vip_welcome"))
);

await engine.FireAsync("order.created", e => e.Set("total", 7500.0));
// → Email: vip_welcome

JavaScript / TypeScript

const { AreEngine, Rule } = require('are-core');

const engine = new AreEngine();

engine.registerAction('send_email', async (ctx, s) => {
  console.log('Email:', s.get('template'));
});

engine.addRule(
  Rule.create('vip_order')
    .on('order.created')
    .whenGreaterThan('total', 5000)
    .then('send_email', s => s.set('template', 'vip_welcome'))
);

await engine.fire('order.created', e => e.set('total', 7500));
// → Email: vip_welcome

Özellikler

• Sıfır bağımlılık — Hiçbir harici paket kullanmaz
• Fluent Builder — Rule.Create().On().When().Then() zinciri
• MatchMode — All (AND), Any (OR), None (NOT), ExactlyOne (XOR)
• 9 karşılaştırma operatörü — Equal, GreaterThan, Contains, In vb.
• Middleware — Before/after pipeline araya girme
• Kural grupları — Toplu enable/disable
• Öncelik sırası — Yüksek priority önce çalışır
• Pipeline kontrolü — StopPipeline, SkipRemainingActions
• Dinamik yönetim — Runtime'da kural ekle/kaldır/aç/kapat
• Sonuç raporlama — Hangi kurallar tetiklendi, hangileri neden atlandı
• Async — Tamamen asenkron pipeline

Repo Yapısı

Platform Desteği

Kurulum

C#:

dotnet add package ARE.Core

JavaScript:

npm install are-core

Dokümantasyon

• ARE.Core (C#) — Detaylı API ve kullanım
• are-core (JS/TS) — Detaylı API ve kullanım

Lisans

MIT