signalbird 2.5.0 → 2.8.1

package/README.md

@@ -19,17 +19,17 @@ Bir seçenek daha var ve kod yazmaz: hazır sohbet widget'ı
 | Dil / platform | Telsiz | Gönderim | Yönetim | Uygulama | Kurulum |
 |---|:--:|:--:|:--:|:--:|---|
 | Node.js / TypeScript | ✓ | ✓ | ✓ | ✓ | `npm i signalbird` |
-| Tarayıcı (düz JS) | ✓ | — | — | ✓ | `signalbird/browser` · `/app` |
+| Tarayıcı (düz JS) | ✓ | - | - | ✓ | `signalbird/browser` · `/app` |
 | React / Next.js | ✓ | ✓ | ✓ | ✓ | `signalbird/react` |
-| Vue 3 | ✓ | — | — | ✓ | `signalbird/vue` |
-| Angular | ✓ | — | — | ✓ | `signalbird/angular` |
-| React Native / Expo | ✓ | — | — | ✓ | `signalbird/react-native` |
-| PHP / Laravel | ✓ | ✓ | ✓ | — | `composer require pariette/signalbird` |
-| Python | ✓ | ✓ | ✓ | — | `pip install signalbird` |
-| Go | ✓ | ✓ | ✓ | — | `go get github.com/Pariette-Inc/signalbird.sdk` |
-| .NET / ASP.NET Core | ✓ | ✓ | ✓ | — | `dotnet add package Signalbird.Sdk` |
-| Swift (iOS) | ✓ | — | — | ✓ | SPM: `Signalbird` |
-| Kotlin (Android) | ✓ | — | — | ✓ | `io.signalbird:signalbird-sdk` |
+| Vue 3 | ✓ | - | - | ✓ | `signalbird/vue` |
+| Angular | ✓ | - | - | ✓ | `signalbird/angular` |
+| React Native / Expo | ✓ | - | - | ✓ | `signalbird/react-native` |
+| PHP / Laravel | ✓ | ✓ | ✓ | - | `composer require pariette/signalbird` |
+| Python | ✓ | ✓ | ✓ | - | `pip install signalbird` |
+| Go | ✓ | ✓ | ✓ | - | `go get github.com/Pariette-Inc/signalbird.sdk` |
+| .NET / ASP.NET Core | ✓ | ✓ | ✓ | - | `dotnet add package Signalbird.Sdk` |
+| Swift (iOS) | ✓ | - | - | ✓ | SPM: `Signalbird` |
+| Kotlin (Android) | ✓ | - | - | ✓ | `io.signalbird:signalbird-sdk` |
 
 Metot adları diller arasında **birebir** aynıdır; her dil kendi yazım
 geleneğini korur (`createRadioProject` / `create_radio_project` /
@@ -65,7 +65,7 @@ SIGNALBIRD_DOMAIN_KEY=sb_secret_live_…
 Takım anahtarı (`sb_…`) her şeyi kapsar: e-posta, SMS, push, kişi ve kampanya,
 sohbet, uygulama, domain, Telsiz log yazımı. Ne yapabileceğini anahtarın
 kapsamları belirler; panelde üretilirken seçersiniz. **Adres yazmanız
-gerekmez** — üretim kökü paketin içindedir.
+gerekmez** - üretim kökü paketin içindedir.
 
 Ayrı anahtar isteğe bağlıdır: bir sunucunun yalnız log yazıp gönderim
 yapamamasını istiyorsanız o sunucuya dar kapsamlı ikinci bir anahtar verirsiniz.
@@ -80,7 +80,7 @@ ve gizli olmadıkları için ayrı durmak zorundadırlar:
 
 Gizli anahtar tarayıcıya **gömülemez**: sunucu, `Origin` başlığı taşıyan bir
 istekte gizli anahtarı reddeder (`SECRET_KEY_IN_BROWSER`). Bu bir kolaylık
-değil, kasıtlı bir duvardır — anahtar bir kez istemciye indiğinde herkesindir.
+değil, kasıtlı bir duvardır - anahtar bir kez istemciye indiğinde herkesindir.
 
 ## Kurulum
 
@@ -94,10 +94,10 @@ değil, kasıtlı bir duvardır — anahtar bir kez istemciye indiğinde herkesi
 | Go | `go get github.com/Pariette-Inc/signalbird.sdk` |
 | .NET, ASP.NET Core | `dotnet add package Signalbird.Sdk` |
 | Swift (iOS, macOS) | SPM: `https://github.com/Pariette-Inc/signalbird.sdk` |
-| Kotlin (Android) | `implementation("io.signalbird:signalbird-sdk:2.5.0")` |
+| Kotlin (Android) | `implementation("io.signalbird:signalbird-sdk:2.8.1")` |
 | Canlı sohbet widget'ı (herhangi bir site) | `<script async src="https://signalbird.io/sdk/v1/signalbird.js" data-key="sb_public_live_…" data-channel="destek"></script>` |
 
-> Hepsi **bu repodan** çıkar ve **aynı sürümü** taşır — ayrı SDK reposu ya da
+> Hepsi **bu repodan** çıkar ve **aynı sürümü** taşır - ayrı SDK reposu ya da
 > dil başına sürüm yoktur.
 
 ## Node.js / TypeScript
@@ -146,7 +146,7 @@ const result = await signalbird().batch([
 ### Next.js
 
 Sunucu tarafında (route handler, server action, `app/api/**`) doğrudan
-`signalbird` kullanılır. **İstemci bileşenlerinde kullanmayın** — anahtar
+`signalbird` kullanılır. **İstemci bileşenlerinde kullanmayın** - anahtar
 paketle birlikte tarayıcıya iner.
 
 ```ts
@@ -183,7 +183,7 @@ sb.error('browser', 'sepet güncellenemedi', { cartId })
 Kayıtlar tek tek değil, **toplu** gider (varsayılan 3 saniyede bir) ve sekme
 kapanırken `sendBeacon` ile boşaltılır.
 
-**React** — `app/providers.tsx` ya da `main.tsx`:
+**React** - `app/providers.tsx` ya da `main.tsx`:
 
 ```tsx
 useEffect(() => {
@@ -192,14 +192,14 @@ useEffect(() => {
 }, [])
 ```
 
-**Vue** — `main.ts`:
+**Vue** - `main.ts`:
 
 ```ts
 const sb = initSignalbird({ publicKey: import.meta.env.VITE_SIGNALBIRD_DOMAIN_KEY })
 app.config.errorHandler = (err) => sb.error('browser', String(err))
 ```
 
-**Angular** — `ErrorHandler` sağlayıcısı:
+**Angular** - `ErrorHandler` sağlayıcısı:
 
 ```ts
 @Injectable()
@@ -232,7 +232,7 @@ SIGNALBIRD_DOMAIN_KEY=sb_secret_live_…
 SIGNALBIRD_SOURCE=api-01
 ```
 
-**Laravel'in kendi loglarını Telsiz'e bağlamak** — `config/logging.php`:
+**Laravel'in kendi loglarını Telsiz'e bağlamak** - `config/logging.php`:
 
 ```php
 'signalbird' => [
@@ -262,17 +262,26 @@ Signalbird::error('api', 'veritabanı bağlantısı koptu');
   geçerli bir sebep değildir. Geliştirme sırasında `throwOnError: true`.
 - **Tanımsız kanal düşürülmez.** İlk `log('odeme-hatasi', …)` çağrısında kanal
   kendiliğinden açılır ve panelde "otomatik açıldı" işaretiyle görünür. Yeni
-  kanal **sessizdir** — kuralı ekip koyar.
+  kanal **sessizdir** - kuralı ekip koyar.
 - **Seviye kanalın varsayılanını ezer.** `level` göndermezseniz kanalın kendi
   seviyesi geçerlidir.
 - **Kritik seviye sessiz saatleri deler.** Gece üçte ölen servis sabahı bekleyemez.
 - **Tekrar bastırma kaydı değil bildirimi susturur.** Aynı mesaj kanalın
   `dedupe` süresi içinde tekrar gelirse ikinci bildirim gitmez ama kayıt tutulur.
+- **SDK sürümünü bildirir (2.6.0).** Her istek `X-Signalbird-Sdk:
+  <platform>/<sürüm>` taşır. Yeni sürüm çıktığında SDK süreç başına **bir kez**
+  uyarı yazar; eski sürümdeki anahtarların sahiplerine panel bildirimi gider.
+  Uyarı hata değildir, istek sonucu değişmez (CONTRACT §14).
+- **Ziyaretçi kimliği doğrulanır (2.7.0).** Sohbet/push ziyaretçisinin
+  `external_id`'si ancak sunucunuzda üretilen `identity_hash` ile birlikte
+  gelirse güvenilir sayılır: kişi kaydına bağlama, cihaza push ve kanal
+  ajanının araçlarına giden güvenilir kimlik buna bağlıdır. Widget ayrıca
+  gerektiğinde Cloudflare Turnstile ister (CONTRACT §15).
 
 ## Gönderim (Messaging)
 
 Takım API anahtarı (`sb_…`, panelde **Konsol → API anahtarları**, scope'lu)
-ile çalışır. Telsiz anahtarı burada geçmez — istemci kurulurken
+ile çalışır. Telsiz anahtarı burada geçmez - istemci kurulurken
 `WRONG_KEY_TYPE` ile reddeder. Yalnız sunucuda kullanılır.
 
 Node:
@@ -370,7 +379,7 @@ import { management } from 'signalbird'
 // Yeni ortam kurulumu: proje aç, kanalını tanımla, anahtarı sakla
 const { data } = await management().createRadioProject({ name: 'ödeme-servisi' })
 
-// `secret` YALNIZ burada döner — sunucuda yalnız özeti saklanır
+// `secret` YALNIZ burada döner - sunucuda yalnız özeti saklanır
 await vault.write('SIGNALBIRD_DOMAIN_KEY', data!.secret)
 
 await management().createRadioChannel(data!.project.id, {
@@ -405,7 +414,7 @@ const { data } = await management().embedToken({ module: 'chat' })
 // data.url → 120 saniyelik, TEK KULLANIMLIK adres; doğrudan <iframe>'e verin
 ```
 
-Anahtar `embed:issue` kapsamı ister — jeton 60 dakikalık bir panel oturumuna
+Anahtar `embed:issue` kapsamı ister - jeton 60 dakikalık bir panel oturumuna
 çevrildiği için bu kapsam bilerek ayrıdır.
 
 Aynısı PHP, Python, Go ve .NET'te birebir aynı metot adlarıyla:
@@ -428,7 +437,7 @@ await management.CreateRadioProjectAsync(new { name = "ödeme-servisi" });
 
 Tam liste (40 metot): `docs/CONTRACT.md § 10`.
 
-## Partner — müşteri sağlama
+## Partner - müşteri sağlama
 
 Signalbird'ü kendi ürününüzün içinde satıyorsanız (sözleşmeli platform) bu yüzey
 sizindir: müşteri hesabı açar, domain ekleyip izlemeye alır, uptime okur, ödeme
@@ -439,7 +448,7 @@ import { SignalbirdPartner } from 'signalbird'
 
 const partner = new SignalbirdPartner({ domainKey: process.env.SIGNALBIRD_DOMAIN_KEY! })
 
-// Müşteri açıldı — idempotent: aynı external_id ikinci kez yeni hesap AÇMAZ
+// Müşteri açıldı - idempotent: aynı external_id ikinci kez yeni hesap AÇMAZ
 const { data } = await partner.createCompany({
   external_id: 'sc_9911',
   name: 'Acme',
@@ -465,7 +474,7 @@ const embed = await partner.createEmbedToken('sc_9911', {
 })
 // → <iframe src={embed.data.url} />
 
-// Gönderilen her şeyin durumu — kendi panelinizde çizmek için (salt okur)
+// Gönderilen her şeyin durumu - kendi panelinizde çizmek için (salt okur)
 const log = await partner.listMessages('sc_9911', { channel: 'email', status: 'delivered' })
 const one = await partner.getMessage('sc_9911', 'm_01J…')       // olay zaman çizelgesi
 const sum = await partner.messageSummary('sc_9911', '7d')       // kanal bazlı özet
@@ -479,10 +488,10 @@ PHP'de `Signalbird::partner()->createCompany([...])`.
 İki kural: **anahtar tarayıcıya inmez** ve **TXT'siz domain kampanya
 gönderemez** (izleme, sohbet ve push açıktır). Ayrıntı: `docs/CONTRACT.md § 12`.
 
-Mesaj uçları **salt okurdur**: alıcı maskeli döner, gövde hiç dönmez — gövde
+Mesaj uçları **salt okurdur**: alıcı maskeli döner, gövde hiç dönmez - gövde
 zaten saklanmıyor.
 
-## Gönderim — müşterinin kendi sisteminden
+## Gönderim - müşterinin kendi sisteminden
 
 Bir platformun (SubmitCMS, veribenim…) müşterisiyseniz kendi sunucunuzdan da
 gönderim yapabilirsiniz. Gereken tek şey **kendi takım anahtarınızdır**
@@ -537,7 +546,7 @@ istemiyorsanız ikincisi.
 3. **Anahtar sunucuda kalır.** Tarayıcıya ya da mobil uygulamaya konmaz;
    oralar için açık uygulama anahtarı (`sb_public_live_…`) vardır.
 
-## Uygulama (App) — kendi sohbet arayüzünüz
+## Uygulama (App) - kendi sohbet arayüzünüz
 
 Hazır widget yerine kendi arayüzünüzü yazmak, ya da sohbeti **mobil
 uygulamanıza** koymak istiyorsanız bu yüzey içindir. Açık uygulama anahtarı
@@ -638,17 +647,49 @@ Signalbird.chat.open()                       // close() · toggle() · isOpen()
 Signalbird.chat.on('unread', (n) => badge.textContent = n)
 Signalbird.push.register({ token, platform: 'web', provider: 'fcm' })
 Signalbird.destroy()
+Signalbird.reset()                           // kullanıcı ÇIKIŞ yapınca (2.8.0, CONTRACT §15.3)
 ```
 
+**Çıkışta `Signalbird.reset()` zorunlu (2.8.0).** Ziyaretçi sırrını, sohbet
+geçmişini ve kimliği tarayıcıdan siler; aynı tarayıcıyı kullanan sonraki kişi
+öncekinin sohbetini görmez, destek ajanı onu önceki kullanıcı sanmaz.
+Sunucu da kimliği her oturumda yeniden imza ister.
+
 `data-key`/`data-channel` yerine `Signalbird.init({ publicKey, chatKey, baseUrl?, locale? })` da
-çağrılabilir. Widget ev sahibi sayfaya asla hata fırlatmaz; Shadow DOM içinde
-çalışır, sayfanızın CSS'iyle çakışmaz; < 20 KB gzip. Ayrıntı:
+çağrılabilir.
+
+**Kimlik doğrulaması (2.7.0).** Oturum açmış kullanıcıyı tanıtırken
+`external_id`'nin hash'ini SUNUCUNUZDA üretip birlikte verin; yoksa Signalbird
+bu kimliği doğrulanmamış sayar (kişi kaydına bağlamaz, cihaza push hedeflemez,
+ajan araçları kimliği yalnız `visitor.unverified` altında görür):
+
+```php
+// Blade - gizli anahtar sunucuda kalır
+<script async src="https://signalbird.io/sdk/v1/signalbird.js"
+        data-key="sb_public_live_…" data-channel="destek"
+        data-external-id="{{ $user->id }}"
+        data-identity-hash="{{ Signalbird::identityHash((string) $user->id) }}"></script>
+```
+
+```js
+Signalbird.identify({ external_id: 'user-1042', identityHash: '<sunucudan>', email: 'ali@example.com' })
+```
+
+`identity_hash = hex(HMAC-SHA256(hex(SHA-256(sb_secret_live_…)), external_id))`;
+Node `client.identityHash(id)`, Python `client.identity_hash(id)`, Go
+`client.IdentityHash(id)`, .NET `client.IdentityHash(id)`.
+
+**Captcha.** Kanalda açıksa widget yeni ziyaretçide ve doğrulanmamış
+ziyaretçinin ilk konuşmasında görünmez bir Cloudflare Turnstile jetonu alır;
+betik yalnız panel ilk açıldığında yüklenir, etkileşim yalnız Cloudflare
+isterse görünür. Kurulumda yapmanız gereken bir şey yoktur. Widget ev sahibi sayfaya asla hata fırlatmaz; Shadow DOM içinde
+çalışır, sayfanızın CSS'iyle çakışmaz; < 40 KB gzip. Ayrıntı:
 `docs/CONTRACT.md § 9` ve https://signalbird.io/sdk/widget.
 
-## Gömme (embed) — Signalbird ekranını kendi panelinizde çalıştırın
+## Gömme (embed) - Signalbird ekranını kendi panelinizde çalıştırın
 
 Partner (veribenim, submitcms, yeni ortaklar) Signalbird modülünü kendi
-panelinin içinde gösterir. Ekran kopyalanmaz — **çalışan ekranın kendisi**
+panelinin içinde gösterir. Ekran kopyalanmaz - **çalışan ekranın kendisi**
 gelir; Signalbird'de güncellenen her şey partner panelinde de anında günceldir.
 
 ```html
@@ -693,7 +734,7 @@ Sunucu tarafı tek çağrıdır (`Signalbird::partner()->createEmbedToken(...)`,
 | `CHANNEL_NOT_ALLOWED` | Tarayıcı anahtarı bu kanala yazamaz |
 | `MODULE_DISABLED` | Paketinizde Telsiz (`logger`) modülü yok |
 | `LIMIT_REACHED` | Aylık kayıt limitiniz doldu |
-| `CHANNEL_DISABLED` | Kanal kapalı — kayıt yazılmaz, kota da harcanmaz |
+| `CHANNEL_DISABLED` | Kanal kapalı - kayıt yazılmaz, kota da harcanmaz |
 
 Gönderim ve Yönetim istemcilerine özgü: `WRONG_KEY_TYPE` (kurulumda),
 `API_KEY_INVALID`, `API_KEY_SCOPE` (anahtarda gereken scope yok),
@@ -701,5 +742,6 @@ Gönderim ve Yönetim istemcilerine özgü: `WRONG_KEY_TYPE` (kurulumda),
 `LIST_NOT_FOUND`, `MODULE_DISABLED`, `NETWORK_ERROR`, `TIMEOUT`, `HTTP_<durum>`.
 
 Uygulama yüzeyi ve widget: `VISITOR_INVALID` (yerel kimlik silinir, yeni
-oturum açılır), `CHAT_UNAVAILABLE` (kota — "sohbet kullanılamıyor" bandı),
-`NOT_INITIALIZED`.
+oturum açılır), `CHAT_UNAVAILABLE` (kota - "sohbet kullanılamıyor" bandı),
+`NOT_INITIALIZED`, `CAPTCHA_REQUIRED` / `CAPTCHA_INVALID` (403 - widget yeni
+jetonla bir kez yeniden dener), `CONVERSATION_RATE_LIMITED` (429 - nazik bant).

package/dist/angular.d.mts

@@ -2,7 +2,7 @@ import { Observable } from 'rxjs';
 import { SignalbirdApp, AppConfig, ChatState, SessionInput, IdentifyInput, RegisterDeviceInput } from './app.mjs';
 
 /**
- * `signalbird/angular` — Angular servisi ve sağlayıcısı.
+ * `signalbird/angular` - Angular servisi ve sağlayıcısı.
  *
  * Dekoratör KULLANMAZ: `@Injectable()` yazsaydık paketin derlenmesi Angular
  * sürümüne bağlanırdı ve her büyük sürümde yeniden yayın gerekirdi. Bunun
@@ -12,7 +12,7 @@ import { SignalbirdApp, AppConfig, ChatState, SessionInput, IdentifyInput, Regis
  * RxJS bir `peerDependency`'dir (Angular zaten getirir).
  */
 
-/** DI belirteci — Angular'ın `InjectionToken`'ına sarılır (aşağıda). */
+/** DI belirteci - Angular'ın `InjectionToken`'ına sarılır (aşağıda). */
 declare const SIGNALBIRD_CONFIG = "SIGNALBIRD_CONFIG";
 /**
  * Uygulama başına tek örnek (`providedIn: 'root'` karşılığı).
@@ -27,7 +27,7 @@ declare class SignalbirdService {
     constructor(config: AppConfig);
     /** Sohbet durumu akışı. İlk abone olduğunda oturum başlar. */
     chat$(): Observable<ChatState>;
-    /** Panel açık mı — yoklama hızını belirler. */
+    /** Panel açık mı - yoklama hızını belirler. */
     setOpen(open: boolean): void;
     send(body: string, attachments?: unknown[]): Promise<unknown>;
     typing(isTyping: boolean): void;
@@ -48,7 +48,7 @@ declare class SignalbirdService {
 /**
  * `bootstrapApplication(App, { providers: [provideSignalbird({ publicKey })] })`
  *
- * Dönen nesne Angular'ın `Provider` biçimindedir ama tipi buraya gömülmez —
+ * Dönen nesne Angular'ın `Provider` biçimindedir ama tipi buraya gömülmez -
  * paket Angular'a derleme zamanı bağımlılık taşımaz.
  */
 declare function provideSignalbird(config: AppConfig): {

package/dist/angular.d.ts

@@ -2,7 +2,7 @@ import { Observable } from 'rxjs';
 import { SignalbirdApp, AppConfig, ChatState, SessionInput, IdentifyInput, RegisterDeviceInput } from './app.js';
 
 /**
- * `signalbird/angular` — Angular servisi ve sağlayıcısı.
+ * `signalbird/angular` - Angular servisi ve sağlayıcısı.
  *
  * Dekoratör KULLANMAZ: `@Injectable()` yazsaydık paketin derlenmesi Angular
  * sürümüne bağlanırdı ve her büyük sürümde yeniden yayın gerekirdi. Bunun
@@ -12,7 +12,7 @@ import { SignalbirdApp, AppConfig, ChatState, SessionInput, IdentifyInput, Regis
  * RxJS bir `peerDependency`'dir (Angular zaten getirir).
  */
 
-/** DI belirteci — Angular'ın `InjectionToken`'ına sarılır (aşağıda). */
+/** DI belirteci - Angular'ın `InjectionToken`'ına sarılır (aşağıda). */
 declare const SIGNALBIRD_CONFIG = "SIGNALBIRD_CONFIG";
 /**
  * Uygulama başına tek örnek (`providedIn: 'root'` karşılığı).
@@ -27,7 +27,7 @@ declare class SignalbirdService {
     constructor(config: AppConfig);
     /** Sohbet durumu akışı. İlk abone olduğunda oturum başlar. */
     chat$(): Observable<ChatState>;
-    /** Panel açık mı — yoklama hızını belirler. */
+    /** Panel açık mı - yoklama hızını belirler. */
     setOpen(open: boolean): void;
     send(body: string, attachments?: unknown[]): Promise<unknown>;
     typing(isTyping: boolean): void;
@@ -48,7 +48,7 @@ declare class SignalbirdService {
 /**
  * `bootstrapApplication(App, { providers: [provideSignalbird({ publicKey })] })`
  *
- * Dönen nesne Angular'ın `Provider` biçimindedir ama tipi buraya gömülmez —
+ * Dönen nesne Angular'ın `Provider` biçimindedir ama tipi buraya gömülmez -
  * paket Angular'a derleme zamanı bağımlılık taşımaz.
  */
 declare function provideSignalbird(config: AppConfig): {

package/dist/angular.js

@@ -4,6 +4,26 @@ var rxjs = require('rxjs');
 
 // src/angular/index.ts
 
+// src/shared/version.ts
+var SDK_VERSION = "2.8.1" ;
+var SDK_HEADER = "X-Signalbird-Sdk";
+function sdkHeaderValue(platform) {
+  return `${platform}/${SDK_VERSION}`;
+}
+var warned = false;
+function noteSdkStatus(headers) {
+  if (warned || !headers) return;
+  try {
+    const status = headers.get("Signalbird-Sdk-Status");
+    if (status !== "outdated" && status !== "unsupported") return;
+    warned = true;
+    const latest = headers.get("Signalbird-Sdk-Latest") ?? "?";
+    const message = status === "unsupported" ? `[signalbird] Bu SDK s\xFCr\xFCm\xFC (${SDK_VERSION}) art\u0131k desteklenmiyor. Son s\xFCr\xFCm: ${latest}. Paketi g\xFCncelleyin.` : `[signalbird] Yeni SDK s\xFCr\xFCm\xFC var: ${latest} (kurulu: ${SDK_VERSION}).`;
+    if (typeof console !== "undefined") console.warn(message);
+  } catch {
+  }
+}
+
 // src/app/client.ts
 var DEFAULT_BASE_URL = "https://live.signalbird.io/api";
 var STORAGE_KEY = "sb_visitor";
@@ -53,9 +73,19 @@ var SignalbirdApp = class {
     this.doFetch = config.fetchImpl ?? ((...args) => fetch(...args));
   }
   // ── Kimlik ────────────────────────────────────────────────────────────
-  /** Uygulama ayarları: sohbet açık mı, renk, çalışma saati, ön-form. */
-  bootstrap() {
-    return this.request("POST", "/v1/sdk/bootstrap", { locale: this.config.locale });
+  /**
+   * Uygulama ayarları: sohbet açık mı, renk, çalışma saati, ön-form.
+   *
+   * Oturum açmış kullanıcı biliniyorsa `external_id` + `identity_hash`
+   * verilir (CONTRACT §15.3): sunucu kimliği açılışta da doğrular. Kimliksiz
+   * açılış ziyaretçiye dokunmaz; çıkışta `signOut()` çağrılır.
+   */
+  bootstrap(identity) {
+    const id = identity ? withIdentityHash(identity) : void 0;
+    return this.request("POST", "/v1/sdk/bootstrap", {
+      locale: this.config.locale,
+      ...id?.external_id && id.identity_hash ? { external_id: id.external_id, identity_hash: id.identity_hash } : {}
+    });
   }
   /**
    * Canlı bağlantı kanalı için imza.
@@ -74,7 +104,7 @@ var SignalbirdApp = class {
    * derse yerel kimlik silinir ve bir sonraki çağrı yeni oturum açar.
    */
   async startSession(input = {}) {
-    const result = await this.request("POST", "/v1/sdk/chat/session", input);
+    const result = await this.request("POST", "/v1/sdk/chat/session", withIdentityHash(input));
     const visitor = result.data?.visitor;
     if (result.ok && visitor?.id && visitor.secret) {
       await this.storeVisitor({
@@ -89,9 +119,9 @@ var SignalbirdApp = class {
   }
   /** Oturum açmış kullanıcıyı ziyaretçiye bağlar (kişi kaydı upsert edilir). */
   identify(input) {
-    return this.request("POST", "/v1/sdk/identify", input);
+    return this.request("POST", "/v1/sdk/identify", withIdentityHash(input));
   }
-  /** Saklanan ziyaretçi kimliği — yoksa `null`. */
+  /** Saklanan ziyaretçi kimliği - yoksa `null`. */
   async currentVisitor() {
     const stored = await this.loadVisitor();
     return stored ? { id: stored.id, name: stored.name, email: stored.email } : null;
@@ -110,7 +140,7 @@ var SignalbirdApp = class {
     return this.request("GET", `/v1/sdk/chat/conversations/${enc(id)}`, void 0, query);
   }
   /**
-   * İlk mesajla konuşma açar. Kota burada harcanır — konuşma başına sayılır,
+   * İlk mesajla konuşma açar. Kota burada harcanır - konuşma başına sayılır,
    * mesaj başına değil.
    */
   startConversation(input) {
@@ -184,25 +214,25 @@ var SignalbirdApp = class {
   // ── Push ──────────────────────────────────────────────────────────────
   /**
    * Cihaz token'ını kaydeder. Token'ı almak (FCM/APNs/Web Push izni) ev
-   * sahibinin işidir; SDK yalnız iletir — izin diyaloğunu kimin, ne zaman
+   * sahibinin işidir; SDK yalnız iletir - izin diyaloğunu kimin, ne zaman
    * göstereceği ürün kararıdır, kütüphane kararı değil.
    */
   registerDevice(input) {
-    return this.request("POST", "/v1/sdk/devices", input);
+    return this.request("POST", "/v1/sdk/devices", withIdentityHash(input));
   }
   /** Çıkışta çağrılır: kayıt silinmez, kapatılır (geçmiş korunur). */
   unregisterDevice(token) {
     return this.request("DELETE", `/v1/sdk/devices/${enc(token)}`);
   }
   /**
-   * Bildirime dokunuldu — açılma damgası.
+   * Bildirime dokunuldu - açılma damgası.
    *
    * Push'ta açılmayı YALNIZCA uygulama bilir: FCM/APNs "teslim ettim" der,
    * "kullanıcı dokundu" demez. Bildirim yükündeki `data.sb_message_id`
    * değerini buraya geri gönderin.
    *
    * ```ts
-   * // React Native / Expo — bildirime dokunma işleyicisinde
+   * // React Native / Expo - bildirime dokunma işleyicisinde
    * const id = response.notification.request.content.data?.sb_message_id
    * if (id) await sb.reportPushOpened(String(id))
    * ```
@@ -219,7 +249,8 @@ var SignalbirdApp = class {
     const isForm = typeof FormData !== "undefined" && body instanceof FormData;
     const headers = {
       Accept: "application/json",
-      "X-Signalbird-Key": this.config.publicKey
+      "X-Signalbird-Key": this.config.publicKey,
+      [SDK_HEADER]: sdkHeaderValue(appPlatform())
     };
     const moduleKey = path.startsWith("/v1/sdk/devices") || path.startsWith("/v1/sdk/push") ? this.config.pushKey : this.config.chatKey;
     if (moduleKey) headers["X-Signalbird-Module-Key"] = moduleKey;
@@ -235,6 +266,7 @@ var SignalbirdApp = class {
         body: body === void 0 ? void 0 : isForm ? body : JSON.stringify(body),
         signal: controller.signal
       });
+      noteSdkStatus(response.headers);
       const text = await response.text();
       let data = null;
       try {
@@ -297,6 +329,11 @@ var SignalbirdApp = class {
     }
   }
 };
+function withIdentityHash(input) {
+  if (!input || input.identityHash === void 0) return input;
+  const { identityHash, ...rest } = input;
+  return { ...rest, identity_hash: rest.identity_hash ?? identityHash };
+}
 function enc(value) {
   return encodeURIComponent(value);
 }
@@ -310,6 +347,9 @@ function buildQuery(query) {
   const encoded = params.toString();
   return encoded ? `?${encoded}` : "";
 }
+function appPlatform() {
+  return typeof navigator !== "undefined" && navigator.product === "ReactNative" ? "react-native" : "app";
+}
 
 // src/shared/socket.ts
 var BACKOFF = [1e3, 2e3, 5e3, 1e4, 3e4];
@@ -434,7 +474,7 @@ var Socket = class {
     }
   }
   /**
-   * Olay yolla — ACK İSTEMEDEN.
+   * Olay yolla - ACK İSTEMEDEN.
    *
    * `subscribe`in sonucunu beklemek bir tur daha protokol yönetmek demekti;
    * oysa sonucu zaten davranıştan görüyoruz: imza tutmadıysa yayın gelmez ve
@@ -499,6 +539,8 @@ var ChatSession = class {
      * da düzenleme ekrana hiç yansımaz.
      */
     this.forceFull = false;
+    /** Son gönderilen `typing(true)` zamanı; 0 = açık sinyal yok. */
+    this.lastTypingSent = 0;
     this.active = options.active ?? false;
   }
   // ── Abonelik ──────────────────────────────────────────────────────────
@@ -533,7 +575,7 @@ var ChatSession = class {
     this.patch({ loading: false });
     this.schedule();
   }
-  /** Panel açıldı/kapandı — yoklama hızı buna göre değişir. */
+  /** Panel açıldı/kapandı - yoklama hızı buna göre değişir. */
   setActive(active) {
     if (this.active === active) return;
     this.active = active;
@@ -548,7 +590,7 @@ var ChatSession = class {
    * Konuşmayı bırakır; sonraki mesaj YENİ bir konuşma açar.
    *
    * Ekranın "yeni sohbet" düğmesi de bunu çağırır. Sunucuda hiçbir şey
-   * silinmez — yalnız bu oturumun neye baktığı değişir.
+   * silinmez - yalnız bu oturumun neye baktığı değişir.
    */
   reset() {
     this.patch({ conversation: null, messages: [], unread: 0, agentTyping: false, errorCode: void 0 });
@@ -562,7 +604,7 @@ var ChatSession = class {
     this.socket = null;
     this.live = false;
   }
-  /** Canlı bağlantı kurulu mu — arayüz isterse gösterir (zorunlu değil). */
+  /** Canlı bağlantı kurulu mu - arayüz isterse gösterir (zorunlu değil). */
   get isLive() {
     return this.live;
   }
@@ -617,16 +659,32 @@ var ChatSession = class {
   }
   /**
    * Ziyaretçinin konu seçimi. Konuşma AÇILDIKTAN sonra çağrılırsa etkisizdir:
-   * açılmış konuşmanın konusunu ajan panelden değiştirir — ziyaretçiye kendi
+   * açılmış konuşmanın konusunu ajan panelden değiştirir - ziyaretçiye kendi
    * konuşmasını yeniden sınıflandırma yetkisi vermek, atamayı da bozardı.
    */
   setTopic(slug) {
     this.patch({ topic: slug });
   }
-  /** İlk tuşta `true`, 2.5 s hareketsizlikte `false` — çağıran zamanlar. */
+  /**
+   * İlk tuşta `true`, 2.5 s hareketsizlikte `false` - çağıran zamanlar.
+   *
+   * SDK yine de kendini korur (18 Eyl 2026): `true` 4 saniyede bir kez gider,
+   * `false` yalnız açık bir `true` varsa. Bir entegrasyon her tuşta
+   * çağırdığında (Penyu mobil öyle yapıyordu) 40 harflik mesaj 40 istek
+   * oluyor ve sunucunun hız sınırı ikinci mesajı 429 ile düşürüyordu. Web
+   * widget'ındaki kuralın aynısı.
+   */
   typing(isTyping) {
     const conversation = this.state.conversation;
     if (!conversation) return;
+    const now = Date.now();
+    if (isTyping) {
+      if (now - this.lastTypingSent < 4e3) return;
+      this.lastTypingSent = now;
+    } else {
+      if (this.lastTypingSent === 0) return;
+      this.lastTypingSent = 0;
+    }
     void this.app.setTyping(conversation.id, isTyping);
   }
   /** Görülen son mesaja kadar okundu işaretler. */
@@ -825,7 +883,7 @@ var SignalbirdService = class {
     }
     return this.subject.asObservable();
   }
-  /** Panel açık mı — yoklama hızını belirler. */
+  /** Panel açık mı - yoklama hızını belirler. */
   setOpen(open) {
     this.session.setActive(open);
   }