انتقل إلى المحتوى
NanoFlags
ابدأ مجانًا

حِزم SDK

SDK ‏.NET

تقيّم الحزمة NanoFlags الأعلام محليًا ودون أي عملية إدخال/إخراج، على إعداد موقّع في الذاكرة تُبقيه محدّثًا في الخلفية عبر الاتصال الحي. ولا ترمي القراءات استثناءً ولا تحجب التنفيذ أبدًا، ويمكن مشاركة عميل واحد بأمان بين الخيوط.

التثبيت

sh
dotnet add package NanoFlags
dotnet add package NanoFlags.OpenFeature   # optional: OpenFeature provider
  • منشورة على NuGet باسم NanoFlags 0.2.0 وNanoFlags.OpenFeature 0.2.0. تستهدف netstandard2.0 وnet8.0، فتعمل على .NET 8 وما بعده، وعلى .NET Framework وغيره من بيئات .NET Standard 2.0.
  • الاعتمادية الوحيدة هي Microsoft.Extensions.Logging.Abstractions. والتحقق من Ed25519 تنفيذ مستقل لمعيار RFC 8032، فلا حاجة إلى تشفير أصلي أو مكتبة خارجية.
  • مساحة الأسماء NanoFlags (العميل) وNanoFlags.OpenFeature (المزوّد). والمحرك في NanoFlags.Engine نقلٌ لمحرك NanoFlags، مختبَر على الحالات المشتركة المولَّدة من المحرك المرجعي (21,998 حالة تقييم)، فيعطي النتائج نفسها التي تعطيها كل حزم SDK الأخرى. وتحليل الأرقام وتنسيقها دقيقان، فلا تتوقف النتائج على بيئة التشغيل.
  • برخصة Apache-2.0. والشيفرة المصدرية في nanoflags-sdk/dotnet.

البدء السريع

انسخ مفتاح خادم (nf_srv_…) من الإعدادات ← مفاتيح SDK (Settings → SDK keys) في لوحة التحكم واحفظه في متغير بيئة. واشترك في الحدث Error مباشرة بعد إنشاء العميل، قبل انتظار الجاهزية.

Program.cs
using NanoFlags;

var flags = NanoFlagsClient.Create(
    Environment.GetEnvironmentVariable("NANOFLAGS_SDK_KEY")!,   // nf_srv_… (server view)
    new NanoFlagsOptions { Service = "checkout-api" });         // shown in "which revision is each service running"

flags.Error += (_, e) => Console.Error.WriteLine($"nanoflags {e.Code}: {e.Message}");

if (!await flags.WaitForReadyAsync(TimeSpan.FromSeconds(5)))    // never throws
    Console.WriteLine($"flags not loaded yet ({flags.LastError?.Message}): evaluations return their fallbacks");

var user = new Dictionary<string, object?> { ["key"] = "user-42", ["plan"] = "pro", ["country"] = "SA" };
if (flags.BoolVariation("new-checkout", user, false))
{
    // ...
}

await flags.CloseAsync();                                       // on shutdown (or Dispose())
  • أنشئ عميلًا واحدًا لكل مفتاح SDK عند بدء التشغيل وشاركه، فهو آمن للاستخدام من عدة خيوط. والعنوان الأساسي افتراضيًا هو الحافة المستضافة https://edge.nanoflags.io.
  • يبدأ العميل التحميل فور عودة Create، فقد يصل خطأ المحاولة الأولى قبل ربط معالجك؛ لكن LastError يحمل دائمًا آخر خطأ.
  • تعمل مفاتيح المتصفح (nf_pub_…) أيضًا لكنها لا ترى إلا الأعلام المكشوفة للعميل. ولا ترمي Create الاستثناء NanoFlagsException (بالرمز Config) إلا لمفتاح فارغ أو عنوان أساسي ليس http(s).

ASP.NET Core

Program.cs
builder.Services.AddSingleton(_ =>
{
    var client = NanoFlagsClient.Create(
        builder.Configuration["NanoFlags:SdkKey"]!,
        new NanoFlagsOptions { Service = "web" });
    client.Error += (_, e) => Console.Error.WriteLine($"nanoflags {e.Code}: {e.Message}");
    return client;
});

// in a handler
app.MapGet("/checkout", (NanoFlagsClient flags, HttpContext http) =>
    flags.BoolVariation("new-checkout", new Dictionary<string, object?> { ["key"] = http.User.Identity?.Name }, false)
        ? Results.Ok("new") : Results.Ok("classic"));

سجّل العميل كخدمة singleton. تتخلّص منه الحاوية عند الإيقاف، فيُرسل القياس ويتوقف العمل في الخلفية. ومرّر ILogger في NanoFlagsOptions.Logger لتمرّ سجلاته عبر إعدادات التسجيل لديك.

القراءات المُنمَّطة

كل دالة قراءة تأخذ مفتاح العلم والسياق والقيمة الاحتياطية. والسياق من النوع IReadOnlyDictionary<string, object?> (ويصلح Dictionary<string, object?>)؛ و"key" هو الهوية المستخدمة في الطرح بالنسب المئوية. ويمكن أن تكون القيم نصوصًا أو قيمًا منطقية أو أي نوع رقمي أو null أو متتاليات أو قواميس.

csharp
bool    enabled = flags.BoolVariation("new-checkout", user, false);
string  accent  = flags.StringVariation("accent", user, "blue");
double  ratio   = flags.DoubleVariation("sample-ratio", user, 0.1);
int     limit   = flags.IntVariation("rate-limit", user, 100);
long    quota   = flags.LongVariation("quota-bytes", user, 1_000_000L);
object? layout  = flags.JsonVariation("layout", user, null);   // null, bool, double, string, List<object?>, Dictionary<string, object?>

var every = flags.AllFlags(user);                               // records no telemetry
الدالةتعيد
BoolVariation(key, context, fallback)قيمة bool
StringVariation · DoubleVariationقيمة string، أو double منتهية
IntVariation · LongVariationعددًا صحيحًا
JsonVariation(key, context, fallback)بيانات .NET عادية: null أو bool أو double أو string أو List<object?> أو Dictionary<string, object?> (بترتيب الإعداد)
JsonValueVariation(key, context, fallback)القيمة نفسها ككائن JsonValue بأنواع جافاسكريبت
…VariationDetail(key, context, fallback)كائن EvaluationDetail<T>، انظر التفاصيل والأسباب
Evaluate(key, context, fallback)نتيجة المحرك دون فحص للنوع
AllFlags(context) · AllFlagsDetail(context)كل أعلام الإعداد المحمَّل (دون قياس)

تحصل على قيمتك الاحتياطية عندما لم يُحمَّل إعداد بعد، أو عندما يكون العلم مجهولًا، أو عندما يقدّم قيمة من نوع آخر (السبب FlagNotFound أو Error). والعلم المعطّل ليس حالة احتياط: فهو يعيد قيمة off المضبوطة له.

التفاصيل والأسباب

csharp
var d = flags.BoolVariationDetail("new-checkout", user, false);
Console.WriteLine($"{d.Value} {d.Reason} {d.RuleId} r{d.Revision}");   // True RuleMatch beta r63

foreach (var step in d.Trace)                                         // the same steps the dashboard shows
    Console.WriteLine(step);
الخاصيةالمعنى
Valueالقيمة المقدَّمة (قيمتك الاحتياطية في حالات الاحتياط).
ReasonRuleMatch، Default (لم تطابق قاعدة)، Off (العلم معطّل)، FlagNotFound، Error (نوع خاطئ أو إعداد مشوّه)
RuleIndex · RuleIdالقاعدة المطابقة (فهرس يبدأ من الصفر) ومعرّفها.
InRollout · Bucketللطرح بالنسب المئوية: هل المفتاح داخل التوزيع، وشريحته (من 0 إلى 99.99).
Revisionنسخة الإعداد التي جاءت منها النتيجة.
Traceقائمة من TraceStep تشرح القرار خطوة بخطوة.
Errorلماذا كان Reason هو Error.

التحديثات الحيّة والأحداث

يفتح العميل اتصال WebSocket واحدًا إلى wss://edge.nanoflags.io/v1/live (بالبروتوكول الفرعي nanoflags.v1، وينتقل المفتاح في ترويسة Authorization، لا في العنوان أبدًا). وتدفع الحافة كل نسخة منشورة موقّعةً مسبقًا؛ فيتحقق منها العميل ويستبدلها ذرّيًا.

csharp
flags.Changed += (_, e) =>
    Console.WriteLine($"now on r{e.Revision} (was r{e.PreviousRevision}) via {e.Transport}, {e.Latency?.TotalMilliseconds} ms after commit");

flags.StatusChanged += (_, status) => Console.WriteLine($"nanoflags status: {status}");   // NotReady, Ready or Stale
الخاصيةالمعنى
Revision · PreviousRevisionالنسخة الجديدة والنسخة التي حلّت محلها (-1 للأولى).
Checksumالمجموع الاختباري للإعداد الجديد.
SourceNetwork أو Store أو Bootstrap
TransportLive (مدفوعة)، أو Stream (جُلبت بعد إشعار من أحداث الخادم)، أو Poll
Latencyقيمة TimeSpan? من لحظة الحفظ في قاعدة البيانات إلى هذا الحدث، للنسخ المدفوعة التي تحمل وقت حفظها. وهي تقارن بين ساعتين.
  • تعمل المعالجات واحدًا تلو الآخر، بالترتيب، على خيط تابع للعميل. اجعلها قصيرة؛ والمعالج الذي يرمي استثناءً لا يعطّل العميل أبدًا. وافصلها بـ -=.
  • البدائل: إن تعذّر فتح المقبس يستخدم العميل أحداث الخادم (/v1/stream) ويستطلع /v1/bundle مع ETag كل 30 ثانية. وما دام المقبس سليمًا يعمل استطلاع احتياطي كل 5 دقائق. وتتباعد محاولات إعادة الاتصال من ثانية واحدة حتى 5 دقائق مع تذبذب عشوائي. وانظر وسائل النقل لتفاصيل البروتوكول.
  • لا تحلّ إجابة HTTP أقدم محل نسخة مدفوعة أبدًا، ولا تعيد إجابةٌ من الحافة موسومة بـ X-NanoFlags-Stale العميلَ إلى الوراء.

الجاهزية والحالة

csharp
bool inUse = await flags.Ready;                          // Task<bool>: completes after the first load attempt, never faults
bool ok = flags.WaitForReady(TimeSpan.FromSeconds(5));   // synchronous variant

Status status = flags.Status;           // Status.NotReady | Status.Ready | Status.Stale
long revision = flags.Revision;         // revision in use, or -1
Transport transport = flags.Transport;  // Transport.Live | Transport.Stream | Transport.Poll
var lastError = flags.LastError;        // the error of the last failed request, or null
  • تكتمل Ready حين تنتهي محاولة التحميل الأولى: true إن كان هناك إعداد قيد الاستخدام. وتحدّ WaitForReadyAsync(timeout) وWaitForReady(timeout) مدة الانتظار. ولا يرمي أيٌّ منها استثناءً عند الفشل.
  • Ready: الإعداد معروف أنه محدّث. Stale: هناك إعداد قيد الاستخدام لكن لا يُعرف أنه محدّث (استُعيد من المخزن، أو تعذّر الوصول إلى الحافة، أو حُذفت البيئة). NotReady: لم يُحمَّل شيء، وكل قراءة تعيد قيمتها الاحتياطية.
  • لا تجعل أي طلب ينتظر الجاهزية. انتظر مرة واحدة عند بدء التشغيل بمهلة قصيرة، ودع قيمك الاحتياطية تغطي الباقي.

آخر إعداد سليم والتهيئة المسبقة

بعد التحميل يبقى آخر إعداد سليم قيد الاستخدام رغم أعطال الشبكة والحزم المرفوضة وأخطاء الحافة (فتصبح Status بقيمة Stale).

csharp
var options = new NanoFlagsOptions
{
    Service = "checkout-api",
    Store = new FileStore("/var/cache/app/flags.json"),   // keep the last good bundle across restarts
};

// Or start from a bundle you ship, served until the edge answers:
var offline = new NanoFlagsOptions { BootstrapJson = File.ReadAllText("flags-bootstrap.json") };
  • يكتب FileStore ذرّيًا، بصلاحيات للمالك وحده على أنظمة Unix. ويُتحقَّق من النسخة المستعادة مجددًا قبل استخدامها. ونفّذ الواجهة IStore لحفظها في مكان آخر.
  • تأخذ Bootstrap (كائن Bundle) وBootstrapJson إعدادًا تشحنه مع تطبيقك؛ والإعداد غير الصالح يُتجاهل ويُبلَّغ عنه بالرمز InvalidBundle.
  • يحمل المخزن قواعد الأعلام، ولا يحمل مفتاح الـ SDK أبدًا.

التحقق من التوقيع

تُفحص كل حزمة (‏Ed25519، حسب معرّف المفتاح) قبل أن تحلّ محل الحزمة المستخدمة: عبر الاستطلاع والمقبس الحي والنسخة المخزّنة على حد سواء. ومع العنوان الأساسي الافتراضي يكون ذلك مفعّلًا افتراضيًا بمفاتيح الإنتاج المضمّنة في الحزمة (NanoFlagsOptions.OfficialSigningKeys)، وتُرفض الحزم غير الموقّعة. وتُجزَّأ البايتات الموقّعة كما قُدّمت تمامًا.

csharp
// Self-hosted or proxied edge: pin your keys and require signatures
var options = new NanoFlagsOptions
{
    BaseUrl = "https://flags.internal.example",
    Verify = new VerifyOptions
    {
        PublicKeys = { Jwk.Ed25519("…base64url public key…", "k1") },
        Require = true,
    },
};
  • الحزمة التي لا تجتاز التحقق لا تُستخدم: تبقى السابقة، ويُطلق الحدث Error بالرمز Signature.
  • الحزمة التي تذكر معرّف مفتاح مجهولًا (تدوير المفاتيح) تجعل العميل يحمّل GET /v1/keys مرة واحدة، وعلى الأكثر مرة في الدقيقة. ويحمّل FetchKeys = true المفاتيح من الحافة بدل تثبيتها؛ والمفاتيح المثبّتة أقوى.
  • تُربط الحزم بأول بيئة وُقّعت لها. ومع عنوان أساسي آخر يكون التحقق معطّلًا ما لم تضبط Verify؛ ويعطّله DisableVerification = true صراحةً.
  • تُرفض الحزمة المكتوبة لمحرك تقييم أحدث من NanoFlagsClient.SupportedEngineVersion (بالرمز Engine) ويبقى الإعداد الحالي: حدّث الحزمة. والسلسلة المعيارية موصوفة في التواقيع.

القياس والإخفاء

تُرسل عيّنة 10 % من التقييمات كل 10 ثوانٍ، مع بلاغ خدمة كل 60 ثانية. وافتراضيًا لا تغادر قيم السياق العملية أبدًا: لا يحمل الحدث إلا أسماء الخصائص التي تستخدمها قواعد العلم مع أنواع قيمها ({"plan": "string"}).

csharp
var options = new NanoFlagsOptions
{
    Events = new EventsOptions
    {
        SampleRate = 0.05,
        Redact = ctx => new Dictionary<string, object?> { ["plan"] = ctx.TryGetValue("plan", out var p) ? p : null },
    },
};

var quiet = new NanoFlagsOptions { Events = EventsOptions.Disabled };   // no telemetry at all

تتلقى Redact نسخة من سياق التقييم وتعيد القاموس الذي يُرسل بدل الافتراضي. ويعطّل EventsOptions.Disabled القياس كله، بما فيه بلاغ الخدمة. ويرسل FlushAsync() الأحداث المنتظرة فورًا.

جلسات الاختبار

تثبّت جلسة الاختبار المشتركة (بالإنجليزية)، التي تُنشأ في لوحة التحكم (السيناريوهات ← جلسة اختبار مشتركة، Scenarios → Shared test session)، لقطةً من الإعداد وسياقًا اصطناعيًا على رمز (nf_ts_…). والخدمة التي تتلقى الرمز في ترويسة x-nanoflags-session تقيّم على تلك اللقطة، بسياق الجلسة وقد غطّاه سياق الاستدعاء (والغلبة للاستدعاء)، لذلك الطلب وحده. وتحمل الأحداث المأخوذة كعيّنة من جلسة معرّفَها. وجلسات الاختبار المشتركة جزء من خطة Scale.

csharp
var s = await flags.SessionAsync(Request.Headers[NanoFlagsClient.SessionHeader].FirstOrDefault()); // or (token, "checkout-api")
s.BoolVariation("checkout-v2", ctx, false); // session bundle while active
_ = (s.IsActive, s.Id, s.ExpiresAt, s.Revision);

لكل طلب، دون تمرير المقيّم من دالة إلى أخرى: يحتفظ NanoFlagsSession بالجلسة الحالية في AsyncLocal يتبع الطلب عبر عمليات await. ولا يحتاج ASP.NET Core إلى حزمة إضافية؛ تكفي بضعة أسطر من الوسيط:

Program.cs
app.Use(async (http, next) =>
{
    using (NanoFlagsSession.Begin(http.Request.Headers[NanoFlagsSession.Header].FirstOrDefault()))
    {
        await NanoFlagsSession.FlagsForAsync(flags); // resolve once, before the endpoint runs
        await next();
    }
});

app.MapGet("/cart", () => NanoFlagsSession.FlagsFor(flags).BoolVariation("checkout-v2", ctx, false));

// The next service joins the session: every request of this HttpClient carries the header.
builder.Services.AddHttpClient("pricing").AddHttpMessageHandler(() => new NanoFlagsSessionHandler());

// Queues, jobs and tests
await NanoFlagsSession.RunAsync(job.SessionToken, async () => { var f = await NanoFlagsSession.FlagsForAsync(flags); /* … */ });
الواجهةالوصف
client.SessionAsync(token, service?, ct) · Session(token, service?)تحلّ الجلسة (GET /v1/session) وتعيد SessionEvaluator؛ ويُرسل service كـ X-NanoFlags-Service (افتراضيًا: Service)؛ ولا ينهي ct إلا الانتظار.
SessionEvaluatorدوال القراءة الخاصة بالعميل، ومعها IsActive وId وExpiresAt وRevision.
NanoFlagsSession.Begin(token) · Run · RunAsyncتجعل token الجلسة الحالية لهذا التدفق غير المتزامن (والتخلّص منها يستعيد السابقة)؛ والرمز الغائب أو المشوّه يعمل خارج أي جلسة.
NanoFlagsSession.FlagsForAsync(client, service?, ct)مقيّم الطلب الحالي، يُحلّ مرة واحدة لكل نطاق وعميل؛ وخارج الجلسة يتصرّف كالعميل.
NanoFlagsSession.FlagsFor(client)متزامنة ولا تحجب أبدًا: المقيّم الذي حلّته FlagsForAsync، وإلا مقيّم يتصرّف كالعميل.
NanoFlagsSession.CurrentSession · Headers()الرمز الحالي (أو null)؛ و{x-nanoflags-session: token} (أو فارغ).
NanoFlagsSessionHandlerDelegatingHandler يضيف الترويسة إلى طلبات HttpClient الصادرة داخل الجلسة.
NanoFlagsClient.SessionHeader · IsSessionToken(s)"x-nanoflags-session"؛ والرمز من 1 إلى 512 محرفًا ASCII قابلًا للطباعة.
  • تُسأل الحافة مرة واحدة لكل رمز وخدمة، ويتشارك المستدعون المتزامنون الطلب نفسه، ويُخزَّن الجواب مؤقتًا حتى تنتهي الجلسة. وتُتذكَّر الرموز المجهولة 15 ثانية، وعمليات البحث الفاشلة (المبلَّغ عنها برمز الخطأ Session) 3 ثوانٍ.
  • لا ترمي استثناءً أبدًا: الرمز الغائب أو المشوّه أو المجهول أو المنتهي أو الملغى أو غير المسموح به يعود إلى الإعداد العادي، ويتصرّف المقيّم تمامًا كالعميل. وإن انتهت الجلسة أثناء الطلب تصبح غير نشطة وتستمر التقييمات على الإعداد المنشور. ولا تغيّر نسخةٌ منشورة حديثًا جلسةً نشطة.
  • تُمرَّر الجلسة المجهولة إلى الخدمات التالية مع ذلك: الخدمة التالية تقرّر بنفسها.
  • تغيّر الجلسة اللقطة والسياق اللذين يستخدمهما التقييم فقط؛ فهي لا تمنح أي وصول إلى البيانات ولا يجوز استخدامها للتفويض. وحزم الجلسات غير موقّعة، فلا ينطبق عليها التحقق. والجلسة الملغاة تظل تعمل في عملية خزّنتها مؤقتًا حتى وقت انتهائها.

مزوّد OpenFeature

sh
dotnet add package NanoFlags.OpenFeature
csharp
using NanoFlags;
using NanoFlags.OpenFeature;
using OpenFeature;
using OpenFeature.Model;

var flags = NanoFlagsClient.Create(Environment.GetEnvironmentVariable("NANOFLAGS_SDK_KEY")!);
await Api.Instance.SetProviderAsync(new NanoFlagsProvider(flags, closeClient: true));

var client = Api.Instance.GetClient();
var on = await client.GetBooleanValueAsync("new-checkout", false,
    EvaluationContext.Builder().SetTargetingKey("user-42").Set("plan", "pro").Build());
  • للـ SDK الرسمي في .NET (OpenFeature 2.x). ويبقى التقييم محليًا: يغلّف المزوّد العميل أعلاه، فتعمل التحديثات الحيّة والتواقيع وآخر إعداد سليم بالطريقة نفسها.
  • يصبح مفتاح الاستهداف هو key في NanoFlags (ويتقدّم على خاصية اسمها key). الأسباب: DISABLED وDEFAULT وTARGETING_MATCH وSPLIT (الطرح بالنسب المئوية). والأخطاء: FLAG_NOT_FOUND وPROVIDER_NOT_READY وTYPE_MISMATCH وGENERAL. والمتغيّر (variant) هو معرّف القاعدة؛ وتحمل بيانات العلم الوصفية revision وruleIndex.
  • يطلق المزوّد الأحداث PROVIDER_READY وPROVIDER_STALE وPROVIDER_ERROR وPROVIDER_CONFIGURATION_CHANGED مع مفاتيح الأعلام التي تغيّرت.
  • المُنشئ: new NanoFlagsProvider(client, closeClient: false, initTimeout: null). يغلق closeClient: true عميل NanoFlags عند إيقاف المزوّد؛ ويحدّ initTimeout مدة التهيئة (10 ثوانٍ افتراضيًا).

الخيارات

الخاصيةالافتراضيالوصف
BaseUrlhttps://edge.nanoflags.ioعنوان الحافة.
Service"unknown"الاسم الذي تُبلّغ به هذه العملية.
HttpClientينشئه الـ SDKيستخدم إعدادات الوسيط في النظام (مثل HTTPS_PROXY).
PollInterval · LivePollInterval30 ث · 5 دTimeSpan.Zero يعطّل الاستطلاع.
Live · Streamingtrueلتعطيل WebSocket أو أحداث الخادم.
Store · Bootstrap · BootstrapJsonلا شيءانظر آخر إعداد سليم.
Verify · DisableVerificationمفعّل للحافة المستضافةانظر التحقق من التوقيع.
Eventsعيّنة 10 %انظر القياس.
RequestTimeout · LiveConnectTimeout10 ث · 10 ثمهلتا طلب HTTP والاتصال عبر WebSocket.
Loggerلا شيءكائن ILogger.

رموز الأخطاء

تطلق أعطال الخلفية الحدث Error مع NanoFlagsException له Code (وHttpStatus عند الحاجة): Network وUnauthorized وHttp وInvalidBundle وStore وConfig وSignature وSession وEngine وEnvironmentDeleted. ولا تغيّر هذه الأعطال الإعداد المستخدم، ولا يُرمى أي شيء من استدعاء قراءة. والمعاني مطابقة لـ SDK جافاسكريبت.

الإغلاق والإيقاف

csharp
await flags.CloseAsync();   // or flags.Dispose()

// or scope it
using (var job = NanoFlagsClient.Create(sdkKey, new NanoFlagsOptions { Service = "nightly-job" }))
{
    Run(job);
}
  • يرسل CloseAsync() وDispose() القياس المنتظر (بأفضل جهد) ويوقفان العمل في الخلفية. واستدعاء أيٍّ منهما أكثر من مرة آمن.
  • بعد الإغلاق تواصل القراءات العمل على آخر إعداد، لكنه يتوقف عن التحديث فقط. ويعيد RefreshAsync() التحقق فورًا، ويرمي NanoFlagsException إن فشل ذلك الطلب.

حل المشكلات

  1. كل قراءة تعيد القيمة الاحتياطية. افحص Status وLastError. يعني Unauthorized أن المفتاح رُفض؛ ومع مفتاح متصفح (nf_pub_…) لا تُسلَّم إلا الأعلام المكشوفة للعميل.
  2. خلف وسيط أو مع معالج HTTP مخصّص. يستخدم HttpClient الذي ينشئه الـ SDK إعدادات الوسيط في النظام؛ ومرّر HttpClient خاصًا بك لأي شيء آخر. وإن حُجبت ترقية WebSocket يعرض Transport القيمة Stream أو Poll.
  3. أخطاء بالرمز Signature. لم تجتز الحزمة التحقق فلم تُستخدم. ومع BaseUrl مخصّص ثبّت مفاتيح تلك الحافة عبر VerifyOptions.
  4. أخطاء بالرمز EnvironmentDeleted. أغلقت الحافة المقبس بالرمز 4004. يتوقف العميل عن إعادة الاتصال ويُبقي آخر إعداد بحالة Stale؛ استبدل المفتاح.
لغات أخرى
تتوفر حزم SDK أصلية للخوادم أيضًا لـ Python وGo وJava وPHP وRuby. ويمكن للغات الأخرى قراءة أعلام NanoFlags عبر مزوّد OpenFeature OFREP.