إنتقل إلى المحتوى الرئيسي

سجل التغييرات

تغييرات بارزة على embed SDK وplatform API. يتم إصدار wire contract في /embed/v1/* و/inference-api/b2b/v1/*؛ والتغييرات الكاسرة تصدر ضمن إصدار رئيسي جديد بجانب الإصدار القديم (إصدارات CDN).

2026-09​

  • مصدر حقيقة واحد لسياسة الإمكانات. أصبحت علاقة المنتج → scope والخطة → API-capabilities موجودة مرة واحدة في @kaleidr/shared-types (B2B_PRODUCT_REQUIRED_SCOPE, B2B_TIER_API_CAPABILITIES) مع اختبارات تكافؤ. وتستخدمها shared-api (mint / rotate / PATCH clamp)، وinference-api (session exchange، runtime credentials)، والوثائق.
  • الإمكانية الفعلية = المفتاح المخزن × الخطة الحالية. يعيد session exchange وكل مسار runtime credential حساب السماح بناءً على خطة المؤسسة الحالية — فمفتاح Pro تم تخفيضه إلى Free ينشئ الآن جلسات tile فقط من تلك اللحظة. subcode منفصل: tier_capability_not_allowed (كانت لديه الإمكانية لكن الخطة لم تعد تسمح بها) مقابل insufficient_scope (لم تكن لديه أصلًا).
  • تغييرات خطة الفوترة تبطل cache الخاص بـ apikey:*. تقوم webhooks الخاصة بالاشتراكات بإبطال snapshots لكل مفتاح حتى تصل عمليات التخفيض/الترقية إلى runtime فورًا. وبما أن الجلسات تعيد قراءة سياسة المفتاح الحية عند كل طلب، فإن التخفيض يصل الآن إلى الجلسات المنشأة مسبقًا أيضًا — ولم يعد مقيدًا بـ session TTL. أما الترقية فما زالت تحتاج إلى جلسة جديدة، لأن الجلسة لا يمكنها إلا تضييق الصلاحيات مقارنة بالأصل.
  • رفض توسيع PATCH في خطة Free. تعديل مفتاح Free لتوسيع scopes / allowed_products إلى ما يتجاوز ما تسمح به الخطة يعيد 403 tier_capability_not_allowed، بما في ذلك حالة empty-products = all.
  • تمت إزالة حدث SSE grounding. ما زال Grounding يؤثر في الإجابة؛ لكنه لم يعد يضع frame على wire. العملاء الذين كانوا يستمعون إليه لن يتلقوه بعد الآن.

2026-08​

  • الوصول إلى basemap مصرح به بالمفتاح. الاستخدام المباشر من أطراف ثالثة لـ tile.kaleidr.com مقيد؛ أما embeds الخاصة بـ <kaleidr-map> والخرائط المستضافة لدى Kaleidr فلا تتأثر. جلسات basemap تخصم من الحصة الشهرية المشتركة لتحميلات الخرائط لدى المؤسسة (quota).
  • Session exchange + refresh. يتم تبديل مفاتيح publishable إلى جلسات قصيرة العمر مرتبطة بالأصل (kld_sess_{env}_…, 15-min TTL)؛ ويتولى SDK تحديث الجلسة.
  • Place bridge / iframe seam. تم توحيد postMessage seam لأحداث Place عبر الإطارات بين منتجات iframe والصفحة الأصلية.
  • الإعداد الافتراضي للـ basemap في المؤسسة. يعيد /sdk/sessions قيمة basemap_style_id الافتراضية المخزنة للمؤسسة عندما لا يحدد embed واحدة؛ ويطبق SDK هذه القيمة قبل الرجوع إلى kaleidr-morning.
  • رفض server key في المتصفح. يرفض SDK المفتاح kld_sk_… عند mount (server keys مخصصة للخادم فقط).
  • إعداد CDN + API لبيئتي dev / prod. يتم تقديم البيئتين من endpoints مستقرة الإصدار؛ وتم فصل viewerBase عن base الخاص بالـ loader وفصل tileBase لـ tile CDN الخاص بـ editor.
  • ألوان مسارات Seam v2. يحمل حدث route قيم color / label / alternatives / comparison ضمن العقد المستقر.

v1​

  • loader kaleidr.js + عنصر <kaleidr-map> — واجهة واحدة وأربعة منتجات (chat / viewer / editor / tile) وطريقتا دمج.
  • مفاتيح متصفح publishable (kld_pk_) ومفاتيح server (kld_sk_) مع scopes ai | maps | design | vendor؛ ويتم تبديل مفاتيح publishable إلى جلسات قصيرة العمر مرتبطة بالأصل. وتستمر مفاتيح kld_live_ القديمة في العمل.
  • عائلات المسارات /inference-api/b2b/v1/chat/* (SSE) + /design/*.

سيتم استكمال هذه الصفحة مع صدور الإصدارات.