signalbird 2.6.0 → 2.9.0

package/dist/browser.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/shared/version.ts","../src/browser/index.ts"],"names":[],"mappings":"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","file":"browser.js","sourcesContent":["/**\n * SDK sürüm bildirimi - CONTRACT §14.\n *\n * Her istek `X-Signalbird-Sdk: <platform>/<sürüm>` taşır; API bunu kaydeder\n * ve yanıtta `Signalbird-Sdk-Status` (current | outdated | unsupported) ile\n * `Signalbird-Sdk-Latest` döner. SDK eski olduğunu öğrenince geliştiriciye\n * süreç başına BİR KEZ uyarı yazar. Uyarı hata değildir: istek sonucu\n * değişmez, istisna fırlatılmaz.\n *\n * Sürüm numarası derlemede `VERSION` dosyasından gömülür (tsup `define`).\n */\n\ndeclare const __SB_VERSION__: string;\n\nexport const SDK_VERSION: string = typeof __SB_VERSION__ === 'string' ? __SB_VERSION__ : '0.0.0';\n\nexport const SDK_HEADER = 'X-Signalbird-Sdk';\n\n/** `node/2.6.0` - platform adları CONTRACT §14.1'deki listededir. */\nexport function sdkHeaderValue(platform: string): string {\n  return `${platform}/${SDK_VERSION}`;\n}\n\n/** Başlık okuyabilen her şey: fetch `Headers`, ya da sahte bir yanıt. */\ninterface HeaderSource {\n  get(name: string): string | null;\n}\n\nlet warned = false;\n\n/**\n * Yanıttaki sürüm durumuna bakar; eskiyse bir kez `console.warn` yazar.\n * Hiçbir koşulda hata fırlatmaz: sürüm uyarısı yüzünden müşterinin isteği\n * bozulmamalı.\n */\nexport function noteSdkStatus(headers: HeaderSource | null | undefined): void {\n  if (warned || !headers) return;\n\n  try {\n    const status = headers.get('Signalbird-Sdk-Status');\n\n    if (status !== 'outdated' && status !== 'unsupported') return;\n\n    warned = true;\n\n    const latest = headers.get('Signalbird-Sdk-Latest') ?? '?';\n    const message = status === 'unsupported'\n      ? `[signalbird] Bu SDK sürümü (${SDK_VERSION}) artık desteklenmiyor. Son sürüm: ${latest}. Paketi güncelleyin.`\n      : `[signalbird] Yeni SDK sürümü var: ${latest} (kurulu: ${SDK_VERSION}).`;\n\n    if (typeof console !== 'undefined') console.warn(message);\n  } catch {\n    // uyarı yazılamadıysa sessiz kal\n  }\n}\n\n/** Yalnız testler için: uyarıyı yeniden kurar. */\nexport function resetSdkStatusWarning(): void {\n  warned = false;\n}\n","/**\n * signalbird/browser - tarayıcı istemcisi.\n *\n * Ayrı bir giriş noktası olmasının sebebi teknik değil, GÜVENLİKTİR: sunucu\n * anahtarı istemciye gömülemez ve sunucu `Origin` başlığı taşıyan bir istekte\n * onu zaten reddeder. Tarayıcı, açık anahtarı (`sb_public_live_…`) kullanır ve\n * güvenliği gizlilikten değil kısıttan gelir: yalnız izinli alan adlarından\n * çalışır ve Origin taşımayan istekte reddedilir (`ORIGIN_REQUIRED`).\n *\n * React, Vue, Angular ve düz JS aynı istemciyi kullanır; çatıya özel sarmalayıcı\n * yoktur çünkü gereken tek şey bir fonksiyon çağrısıdır.\n */\nimport { SDK_HEADER, noteSdkStatus, sdkHeaderValue } from '../shared/version';\n\nexport type Level = 'debug' | 'info' | 'warn' | 'error' | 'critical';\n\nexport interface BrowserConfig {\n  /** Açık anahtar (`sb_public_live_…`). Gizli anahtar BURAYA YAZILMAZ. */\n  publicKey: string;\n  baseUrl?: string;\n  source?: string;\n  /**\n   * Kayıtlar tek tek değil, toplu gider. Kullanıcının tarayıcısından saniyede\n   * onlarca istek çıkarmak hem yavaş hem pahalıdır.\n   */\n  flushIntervalMs?: number;\n  maxQueue?: number;\n  debug?: boolean;\n}\n\ninterface QueuedEvent {\n  key: string;\n  message: string;\n  level?: Level;\n  context?: Record<string, unknown>;\n  source?: string;\n}\n\nconst DEFAULT_BASE_URL = 'https://live.signalbird.io/api';\n\nexport class SignalbirdBrowser {\n  private queue: QueuedEvent[] = [];\n  private timer: ReturnType<typeof setInterval> | null = null;\n  private readonly baseUrl: string;\n  private readonly maxQueue: number;\n\n  constructor(private readonly config: BrowserConfig) {\n    if (!config.publicKey?.startsWith('sb_public_live_')) {\n      throw new Error(\n        'Signalbird: tarayıcı istemcisi açık anahtar ister (sb_public_live_…). ' +\n        'Gizli anahtarı (sb_secret_live_…) istemci koduna KOYMAYIN.'\n      );\n    }\n\n    this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/$/, '');\n    this.maxQueue = config.maxQueue ?? 50;\n\n    if (typeof window !== 'undefined') {\n      this.timer = setInterval(() => void this.flush(), config.flushIntervalMs ?? 3000);\n\n      // Sekme kapanırken kuyruk boşaltılır. `sendBeacon` sayfa ölürken bile\n      // gider; normal fetch yarıda kesilirdi.\n      window.addEventListener('pagehide', () => this.flushBeacon());\n    }\n  }\n\n  log(key: string, message: string, level?: Level, context?: Record<string, unknown>): void {\n    this.queue.push({ key, message, level, context, source: this.config.source });\n\n    // Kuyruk dolduysa beklemeden gönder: bellekte sonsuza kadar biriktirmek,\n    // logu hiç göndermemekten kötüdür.\n    if (this.queue.length >= this.maxQueue) {\n      void this.flush();\n    }\n  }\n\n  info(key: string, message: string, context?: Record<string, unknown>) {\n    this.log(key, message, 'info', context);\n  }\n\n  warn(key: string, message: string, context?: Record<string, unknown>) {\n    this.log(key, message, 'warn', context);\n  }\n\n  error(key: string, message: string, context?: Record<string, unknown>) {\n    this.log(key, message, 'error', context);\n  }\n\n  /**\n   * Tarayıcıdaki yakalanmamış hataları bağlar.\n   *\n   * Varsayılan anahtar `browser`dır ve KRİTİK DEĞİLDİR: istemci tarafı kod\n   * herkesin elindedir, oradan kritik alarm tetiklemek kötü niyetli birine\n   * ekibin telefonunu çaldırma imkânı verirdi. Hangi kanalın kime bildirim\n   * göndereceği panelde durur; oradan sessiz bırakılabilir.\n   */\n  captureErrors(key = 'browser'): () => void {\n    const onError = (event: ErrorEvent) => {\n      this.error(key, event.message, {\n        file: event.filename,\n        line: event.lineno,\n        column: event.colno,\n        url: window.location.href,\n      });\n    };\n\n    const onRejection = (event: PromiseRejectionEvent) => {\n      this.error(key, String(event.reason), { url: window.location.href });\n    };\n\n    window.addEventListener('error', onError);\n    window.addEventListener('unhandledrejection', onRejection);\n\n    return () => {\n      window.removeEventListener('error', onError);\n      window.removeEventListener('unhandledrejection', onRejection);\n    };\n  }\n\n  async flush(): Promise<void> {\n    if (this.queue.length === 0) return;\n\n    const batch = this.queue.splice(0, 100);\n\n    try {\n      const response = await fetch(`${this.baseUrl}/v1/radio/log/batch`, {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n          'X-Signalbird-Key': this.config.publicKey,\n          [SDK_HEADER]: sdkHeaderValue('browser'),\n        },\n        body: JSON.stringify({ events: batch }),\n        keepalive: true,\n      });\n      noteSdkStatus(response.headers);\n    } catch (error) {\n      if (this.config.debug) {\n        console.warn('[signalbird] gönderilemedi', error);\n      }\n      // Kayıtlar geri konur ama kuyruk sınırı aşılmaz: ağ uzun süre kapalıysa\n      // sekme belleği şişmemeli.\n      this.queue = [...batch, ...this.queue].slice(0, this.maxQueue);\n    }\n  }\n\n  /** Sayfa kapanırken son gönderim. */\n  private flushBeacon(): void {\n    if (this.queue.length === 0 || typeof navigator === 'undefined') return;\n\n    const blob = new Blob(\n      [JSON.stringify({ events: this.queue.splice(0, 100) })],\n      { type: 'application/json' }\n    );\n\n    // sendBeacon özel başlık taşıyamaz; anahtar ve SDK sürümü sorgu dizesinden gider.\n    navigator.sendBeacon?.(\n      `${this.baseUrl}/v1/radio/log/batch?k=${encodeURIComponent(this.config.publicKey)}` +\n        `&sdk=${encodeURIComponent(sdkHeaderValue('browser'))}`,\n      blob\n    );\n  }\n\n  destroy(): void {\n    if (this.timer) clearInterval(this.timer);\n    void this.flush();\n  }\n}\n\nlet singleton: SignalbirdBrowser | null = null;\n\n/** Uygulama başlangıcında bir kez çağrılır. */\nexport function initSignalbird(config: BrowserConfig): SignalbirdBrowser {\n  singleton = new SignalbirdBrowser(config);\n  return singleton;\n}\n\n/** Kurulmamışsa sessizce yok sayar - log çağrısı uygulamayı çökertmemeli. */\nexport function signalbird(): SignalbirdBrowser | null {\n  return singleton;\n}\n"]}
+{"version":3,"sources":["../src/shared/version.ts","../src/shared/serialize.ts","../src/browser/index.ts"],"names":[],"mappings":"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","file":"browser.js","sourcesContent":["/**\n * SDK sürüm bildirimi - CONTRACT §14.\n *\n * Her istek `X-Signalbird-Sdk: <platform>/<sürüm>` taşır; API bunu kaydeder\n * ve yanıtta `Signalbird-Sdk-Status` (current | outdated | unsupported) ile\n * `Signalbird-Sdk-Latest` döner. SDK eski olduğunu öğrenince geliştiriciye\n * süreç başına BİR KEZ uyarı yazar. Uyarı hata değildir: istek sonucu\n * değişmez, istisna fırlatılmaz.\n *\n * Sürüm numarası derlemede `VERSION` dosyasından gömülür (tsup `define`).\n */\n\ndeclare const __SB_VERSION__: string;\n\nexport const SDK_VERSION: string = typeof __SB_VERSION__ === 'string' ? __SB_VERSION__ : '0.0.0';\n\nexport const SDK_HEADER = 'X-Signalbird-Sdk';\n\n/** `node/2.6.0` - platform adları CONTRACT §14.1'deki listededir. */\nexport function sdkHeaderValue(platform: string): string {\n  return `${platform}/${SDK_VERSION}`;\n}\n\n/** Başlık okuyabilen her şey: fetch `Headers`, ya da sahte bir yanıt. */\ninterface HeaderSource {\n  get(name: string): string | null;\n}\n\nlet warned = false;\n\n/**\n * Yanıttaki sürüm durumuna bakar; eskiyse bir kez `console.warn` yazar.\n * Hiçbir koşulda hata fırlatmaz: sürüm uyarısı yüzünden müşterinin isteği\n * bozulmamalı.\n */\nexport function noteSdkStatus(headers: HeaderSource | null | undefined): void {\n  if (warned || !headers) return;\n\n  try {\n    const status = headers.get('Signalbird-Sdk-Status');\n\n    if (status !== 'outdated' && status !== 'unsupported') return;\n\n    warned = true;\n\n    const latest = headers.get('Signalbird-Sdk-Latest') ?? '?';\n    const message = status === 'unsupported'\n      ? `[signalbird] Bu SDK sürümü (${SDK_VERSION}) artık desteklenmiyor. Son sürüm: ${latest}. Paketi güncelleyin.`\n      : `[signalbird] Yeni SDK sürümü var: ${latest} (kurulu: ${SDK_VERSION}).`;\n\n    if (typeof console !== 'undefined') console.warn(message);\n  } catch {\n    // uyarı yazılamadıysa sessiz kal\n  }\n}\n\n/** Yalnız testler için: uyarıyı yeniden kurar. */\nexport function resetSdkStatusWarning(): void {\n  warned = false;\n}\n","/**\n * Telsiz gövdesini sunucunun kabul edeceği biçime getiren yardımcılar.\n *\n * Node ve tarayıcı istemcisi ortak kullanır. Sınıf metodu DEĞİL, modül\n * fonksiyonudur: `check-parity.mjs` istemci sınıfının girintili metotlarını\n * sayar ve buraya eklenen bir yardımcı Telsiz paritesini bozardı.\n */\n\n/**\n * API `message` alanını `max:4000` ile doğrular (Laravel → `mb_strlen`, yani\n * KOD NOKTASI). Sınırı aşan tek satır 422 alır ve toplu gönderimde bütün\n * paketi düşürür - 99 sağlam log bir uzun yığın izi yüzünden kaybolurdu.\n */\nexport const MAX_MESSAGE_LENGTH = 4000;\n\n/**\n * Mesajı 4000 kod noktasına kırpar.\n *\n * `.slice(0, 4000)` UTF-16 birimi sayar ve bir emoji'nin (vekil çift) ortasından\n * kesebilir; tek kalan vekil `\\ud83d` olarak gider ve PHP `json_decode` bütün\n * gövdeyi reddeder - düzeltmeye çalıştığımız hatanın aynısı. `Array.from` kod\n * noktası üzerinden yürür; pahalıdır, bu yüzden yalnız sınır aşıldığında çalışır.\n */\nexport function truncateMessage(message: string): string {\n  const text = typeof message === 'string' ? message : String(message);\n\n  if (text.length <= MAX_MESSAGE_LENGTH) {\n    return text;\n  }\n\n  return Array.from(text).slice(0, MAX_MESSAGE_LENGTH).join('');\n}\n\n/**\n * `context`'i JSON'a güvenle çevrilebilir bir kopyaya dönüştürür.\n *\n * `JSON.stringify` döngüsel nesnede (ör. `req`, Mongoose belgesi) ve\n * `BigInt`'te İSTİSNA fırlatır. Node'da bu istisna isteğin içinde\n * yakalanıp `NETWORK_ERROR` diye raporlanıyordu - asıl sebep görünmüyordu.\n * Tarayıcıda daha kötüsü: başarısız toplu gönderim kuyruğa geri konur, aynı\n * satır her 3 saniyede tekrar patlar ve arkasındaki bütün loglar takılı kalırdı.\n *\n *  - döngüsel başvuru → `\"[Circular]\"` (yalnız ATA zinciri sayılır: aynı nesneye\n *    iki kardeş alandan başvurmak döngü değildir ve korunur)\n *  - `Error` → `{name, message, stack}` (JSON'da `{}` olurdu, yani bilgi kaybı)\n *  - `BigInt` → string\n *  - `toJSON` taşıyan nesne (Date vb.) → onun çıktısı\n *  - erişimde fırlatan getter → `\"[Unserializable]\"`\n */\nexport function toJsonSafe(value: unknown): unknown {\n  const ancestors: object[] = [];\n\n  const walk = (current: unknown): unknown => {\n    if (typeof current === 'bigint') {\n      return current.toString();\n    }\n\n    // Fonksiyon, symbol ve undefined olduğu gibi kalır: JSON.stringify onları\n    // zaten atar (dizide null yapar); burada ayrıca karar vermeye gerek yok.\n    if (current === null || typeof current !== 'object') {\n      return current;\n    }\n\n    if (ancestors.includes(current)) {\n      return '[Circular]';\n    }\n\n    if (current instanceof Error) {\n      return { name: current.name, message: current.message, stack: current.stack };\n    }\n\n    const withToJson = current as { toJSON?: () => unknown };\n\n    if (typeof withToJson.toJSON === 'function') {\n      try {\n        ancestors.push(current);\n        return walk(withToJson.toJSON());\n      } catch {\n        return '[Unserializable]';\n      } finally {\n        ancestors.pop();\n      }\n    }\n\n    ancestors.push(current);\n\n    try {\n      if (Array.isArray(current)) {\n        return current.map((item) => walk(item));\n      }\n\n      const out: Record<string, unknown> = {};\n\n      for (const key of Object.keys(current)) {\n        let item: unknown;\n\n        try {\n          item = (current as Record<string, unknown>)[key];\n        } catch {\n          item = '[Unserializable]';\n        }\n\n        out[key] = walk(item);\n      }\n\n      return out;\n    } finally {\n      ancestors.pop();\n    }\n  };\n\n  return walk(value);\n}\n\n/** `context` verilmediyse `undefined` kalır (gövdeye hiç girmez). */\nexport function safeContext(context?: Record<string, unknown>): Record<string, unknown> | undefined {\n  if (context === undefined || context === null) {\n    return undefined;\n  }\n\n  return toJsonSafe(context) as Record<string, unknown>;\n}\n","/**\n * signalbird/browser - tarayıcı istemcisi.\n *\n * Ayrı bir giriş noktası olmasının sebebi teknik değil, GÜVENLİKTİR: sunucu\n * anahtarı istemciye gömülemez ve sunucu `Origin` başlığı taşıyan bir istekte\n * onu zaten reddeder. Tarayıcı, açık anahtarı (`sb_public_live_…`) kullanır ve\n * güvenliği gizlilikten değil kısıttan gelir: yalnız izinli alan adlarından\n * çalışır ve Origin taşımayan istekte reddedilir (`ORIGIN_REQUIRED`).\n *\n * React, Vue, Angular ve düz JS aynı istemciyi kullanır; çatıya özel sarmalayıcı\n * yoktur çünkü gereken tek şey bir fonksiyon çağrısıdır.\n */\nimport { SDK_HEADER, noteSdkStatus, sdkHeaderValue } from '../shared/version';\nimport { safeContext, truncateMessage } from '../shared/serialize';\n\nexport type Level = 'debug' | 'info' | 'warn' | 'error' | 'critical';\n\nexport interface BrowserConfig {\n  /** Açık anahtar (`sb_public_live_…`). Gizli anahtar BURAYA YAZILMAZ. */\n  publicKey: string;\n  baseUrl?: string;\n  source?: string;\n  /**\n   * Kayıtlar tek tek değil, toplu gider. Kullanıcının tarayıcısından saniyede\n   * onlarca istek çıkarmak hem yavaş hem pahalıdır.\n   */\n  flushIntervalMs?: number;\n  maxQueue?: number;\n  debug?: boolean;\n}\n\ninterface QueuedEvent {\n  key: string;\n  message: string;\n  level?: Level;\n  context?: Record<string, unknown>;\n  source?: string;\n}\n\nconst DEFAULT_BASE_URL = 'https://live.signalbird.io/api';\n\nexport class SignalbirdBrowser {\n  private queue: QueuedEvent[] = [];\n  private timer: ReturnType<typeof setInterval> | null = null;\n  private readonly baseUrl: string;\n  private readonly maxQueue: number;\n\n  constructor(private readonly config: BrowserConfig) {\n    if (!config.publicKey?.startsWith('sb_public_live_')) {\n      throw new Error(\n        'Signalbird: tarayıcı istemcisi açık anahtar ister (sb_public_live_…). ' +\n        'Gizli anahtarı (sb_secret_live_…) istemci koduna KOYMAYIN.'\n      );\n    }\n\n    this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/$/, '');\n    this.maxQueue = config.maxQueue ?? 50;\n\n    if (typeof window !== 'undefined') {\n      this.timer = setInterval(() => void this.flush(), config.flushIntervalMs ?? 3000);\n\n      // Sekme kapanırken kuyruk boşaltılır. `sendBeacon` sayfa ölürken bile\n      // gider; normal fetch yarıda kesilirdi.\n      window.addEventListener('pagehide', () => this.flushBeacon());\n    }\n  }\n\n  /**\n   * Kanalı bağlar ve yazacı döner - sunucu istemcisindeki `radio()` ile aynı\n   * deyim (CONTRACT §1.1):\n   *\n   *     sb.radio('sepet').error('sepet güncellenemedi', { cartId })\n   *\n   * `critical` BİLEREK yoktur: istemci kodu herkesin elindedir ve oradan\n   * kritik alarm (sessiz saatleri delen bildirim) tetiklemek, kötü niyetli\n   * birine ekibin telefonunu çaldırma imkânı verirdi. Gerekirse\n   * `log(key, msg, 'critical')` hâlâ yazılabilir; kanal ayarı panelde durur.\n   */\n  radio(key: string) {\n    return {\n      debug: (message: string, context?: Record<string, unknown>) => this.log(key, message, 'debug', context),\n      info: (message: string, context?: Record<string, unknown>) => this.log(key, message, 'info', context),\n      warn: (message: string, context?: Record<string, unknown>) => this.log(key, message, 'warn', context),\n      error: (message: string, context?: Record<string, unknown>) => this.log(key, message, 'error', context),\n    };\n  }\n\n  log(key: string, message: string, level?: Level, context?: Record<string, unknown>): void {\n    /*\n     * Kırpma ve güvenli kopya KUYRUĞA GİRERKEN yapılır, gönderirken değil:\n     *  - 4000'i aşan tek mesaj bütün toplu paketi 422 ile düşürürdü;\n     *  - döngüsel `context` `JSON.stringify`'da patlar, `flush()` paketi geri\n     *    kuyruğa koyar ve aynı satır her turda tekrar patlayıp arkasındaki\n     *    bütün logları sonsuza dek bekletirdi;\n     *  - kopya o anki durumu saklar; nesne gönderime kadar değişse bile log,\n     *    yazıldığı andaki değeri taşır.\n     */\n    this.queue.push({\n      key,\n      message: truncateMessage(message),\n      level,\n      context: safeContext(context),\n      source: this.config.source,\n    });\n\n    // Kuyruk dolduysa beklemeden gönder: bellekte sonsuza kadar biriktirmek,\n    // logu hiç göndermemekten kötüdür.\n    if (this.queue.length >= this.maxQueue) {\n      void this.flush();\n    }\n  }\n\n  info(key: string, message: string, context?: Record<string, unknown>) {\n    this.log(key, message, 'info', context);\n  }\n\n  warn(key: string, message: string, context?: Record<string, unknown>) {\n    this.log(key, message, 'warn', context);\n  }\n\n  error(key: string, message: string, context?: Record<string, unknown>) {\n    this.log(key, message, 'error', context);\n  }\n\n  /**\n   * Tarayıcıdaki yakalanmamış hataları bağlar.\n   *\n   * Varsayılan anahtar `browser`dır ve KRİTİK DEĞİLDİR: istemci tarafı kod\n   * herkesin elindedir, oradan kritik alarm tetiklemek kötü niyetli birine\n   * ekibin telefonunu çaldırma imkânı verirdi. Hangi kanalın kime bildirim\n   * göndereceği panelde durur; oradan sessiz bırakılabilir.\n   */\n  captureErrors(key = 'browser'): () => void {\n    const onError = (event: ErrorEvent) => {\n      this.error(key, event.message, {\n        file: event.filename,\n        line: event.lineno,\n        column: event.colno,\n        url: window.location.href,\n      });\n    };\n\n    const onRejection = (event: PromiseRejectionEvent) => {\n      this.error(key, String(event.reason), { url: window.location.href });\n    };\n\n    window.addEventListener('error', onError);\n    window.addEventListener('unhandledrejection', onRejection);\n\n    return () => {\n      window.removeEventListener('error', onError);\n      window.removeEventListener('unhandledrejection', onRejection);\n    };\n  }\n\n  async flush(): Promise<void> {\n    if (this.queue.length === 0) return;\n\n    const batch = this.queue.splice(0, 100);\n\n    try {\n      const response = await fetch(`${this.baseUrl}/v1/radio/log/batch`, {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n          'X-Signalbird-Key': this.config.publicKey,\n          [SDK_HEADER]: sdkHeaderValue('browser'),\n        },\n        body: JSON.stringify({ events: batch }),\n        keepalive: true,\n      });\n      noteSdkStatus(response.headers);\n    } catch (error) {\n      if (this.config.debug) {\n        console.warn('[signalbird] gönderilemedi', error);\n      }\n      // Kayıtlar geri konur ama kuyruk sınırı aşılmaz: ağ uzun süre kapalıysa\n      // sekme belleği şişmemeli.\n      this.queue = [...batch, ...this.queue].slice(0, this.maxQueue);\n    }\n  }\n\n  /** Sayfa kapanırken son gönderim. */\n  private flushBeacon(): void {\n    if (this.queue.length === 0 || typeof navigator === 'undefined') return;\n\n    /*\n     * `text/plain`, `application/json` DEĞİL: `sendBeacon` CORS ön kontrolü\n     * (preflight) yapamaz; \"basit\" olmayan içerik türü taşıyan cross-origin\n     * beacon'ı tarayıcı hiç göndermez ve sayfa kapanırken son loglar sessizce\n     * kaybolurdu. Gövde yine JSON'dur; API Telsiz log uçlarında text/plain\n     * gövdeyi JSON olarak ayrıştırır. `fetch` yolu `application/json` kalır.\n     */\n    const blob = new Blob(\n      [JSON.stringify({ events: this.queue.splice(0, 100) })],\n      { type: 'text/plain;charset=UTF-8' }\n    );\n\n    // sendBeacon özel başlık taşıyamaz; anahtar ve SDK sürümü sorgu dizesinden gider.\n    navigator.sendBeacon?.(\n      `${this.baseUrl}/v1/radio/log/batch?k=${encodeURIComponent(this.config.publicKey)}` +\n        `&sdk=${encodeURIComponent(sdkHeaderValue('browser'))}`,\n      blob\n    );\n  }\n\n  destroy(): void {\n    if (this.timer) clearInterval(this.timer);\n    void this.flush();\n  }\n}\n\nlet singleton: SignalbirdBrowser | null = null;\n\n/** Uygulama başlangıcında bir kez çağrılır. */\nexport function initSignalbird(config: BrowserConfig): SignalbirdBrowser {\n  singleton = new SignalbirdBrowser(config);\n  return singleton;\n}\n\n/** Kurulmamışsa sessizce yok sayar - log çağrısı uygulamayı çökertmemeli. */\nexport function signalbird(): SignalbirdBrowser | null {\n  return singleton;\n}\n"]}

package/dist/browser.mjs

@@ -1,5 +1,5 @@
 // src/shared/version.ts
-var SDK_VERSION = "2.6.0" ;
+var SDK_VERSION = "2.9.0" ;
 var SDK_HEADER = "X-Signalbird-Sdk";
 function sdkHeaderValue(platform) {
   return `${platform}/${SDK_VERSION}`;
@@ -18,6 +18,70 @@ function noteSdkStatus(headers) {
   }
 }
 
+// src/shared/serialize.ts
+var MAX_MESSAGE_LENGTH = 4e3;
+function truncateMessage(message) {
+  const text = typeof message === "string" ? message : String(message);
+  if (text.length <= MAX_MESSAGE_LENGTH) {
+    return text;
+  }
+  return Array.from(text).slice(0, MAX_MESSAGE_LENGTH).join("");
+}
+function toJsonSafe(value) {
+  const ancestors = [];
+  const walk = (current) => {
+    if (typeof current === "bigint") {
+      return current.toString();
+    }
+    if (current === null || typeof current !== "object") {
+      return current;
+    }
+    if (ancestors.includes(current)) {
+      return "[Circular]";
+    }
+    if (current instanceof Error) {
+      return { name: current.name, message: current.message, stack: current.stack };
+    }
+    const withToJson = current;
+    if (typeof withToJson.toJSON === "function") {
+      try {
+        ancestors.push(current);
+        return walk(withToJson.toJSON());
+      } catch {
+        return "[Unserializable]";
+      } finally {
+        ancestors.pop();
+      }
+    }
+    ancestors.push(current);
+    try {
+      if (Array.isArray(current)) {
+        return current.map((item) => walk(item));
+      }
+      const out = {};
+      for (const key of Object.keys(current)) {
+        let item;
+        try {
+          item = current[key];
+        } catch {
+          item = "[Unserializable]";
+        }
+        out[key] = walk(item);
+      }
+      return out;
+    } finally {
+      ancestors.pop();
+    }
+  };
+  return walk(value);
+}
+function safeContext(context) {
+  if (context === void 0 || context === null) {
+    return void 0;
+  }
+  return toJsonSafe(context);
+}
+
 // src/browser/index.ts
 var DEFAULT_BASE_URL = "https://live.signalbird.io/api";
 var SignalbirdBrowser = class {
@@ -37,8 +101,33 @@ var SignalbirdBrowser = class {
       window.addEventListener("pagehide", () => this.flushBeacon());
     }
   }
+  /**
+   * Kanalı bağlar ve yazacı döner - sunucu istemcisindeki `radio()` ile aynı
+   * deyim (CONTRACT §1.1):
+   *
+   *     sb.radio('sepet').error('sepet güncellenemedi', { cartId })
+   *
+   * `critical` BİLEREK yoktur: istemci kodu herkesin elindedir ve oradan
+   * kritik alarm (sessiz saatleri delen bildirim) tetiklemek, kötü niyetli
+   * birine ekibin telefonunu çaldırma imkânı verirdi. Gerekirse
+   * `log(key, msg, 'critical')` hâlâ yazılabilir; kanal ayarı panelde durur.
+   */
+  radio(key) {
+    return {
+      debug: (message, context) => this.log(key, message, "debug", context),
+      info: (message, context) => this.log(key, message, "info", context),
+      warn: (message, context) => this.log(key, message, "warn", context),
+      error: (message, context) => this.log(key, message, "error", context)
+    };
+  }
   log(key, message, level, context) {
-    this.queue.push({ key, message, level, context, source: this.config.source });
+    this.queue.push({
+      key,
+      message: truncateMessage(message),
+      level,
+      context: safeContext(context),
+      source: this.config.source
+    });
     if (this.queue.length >= this.maxQueue) {
       void this.flush();
     }
@@ -106,7 +195,7 @@ var SignalbirdBrowser = class {
     if (this.queue.length === 0 || typeof navigator === "undefined") return;
     const blob = new Blob(
       [JSON.stringify({ events: this.queue.splice(0, 100) })],
-      { type: "application/json" }
+      { type: "text/plain;charset=UTF-8" }
     );
     navigator.sendBeacon?.(
       `${this.baseUrl}/v1/radio/log/batch?k=${encodeURIComponent(this.config.publicKey)}&sdk=${encodeURIComponent(sdkHeaderValue("browser"))}`,

package/dist/browser.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/shared/version.ts","../src/browser/index.ts"],"names":[],"mappings":"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","file":"browser.mjs","sourcesContent":["/**\n * SDK sürüm bildirimi - CONTRACT §14.\n *\n * Her istek `X-Signalbird-Sdk: <platform>/<sürüm>` taşır; API bunu kaydeder\n * ve yanıtta `Signalbird-Sdk-Status` (current | outdated | unsupported) ile\n * `Signalbird-Sdk-Latest` döner. SDK eski olduğunu öğrenince geliştiriciye\n * süreç başına BİR KEZ uyarı yazar. Uyarı hata değildir: istek sonucu\n * değişmez, istisna fırlatılmaz.\n *\n * Sürüm numarası derlemede `VERSION` dosyasından gömülür (tsup `define`).\n */\n\ndeclare const __SB_VERSION__: string;\n\nexport const SDK_VERSION: string = typeof __SB_VERSION__ === 'string' ? __SB_VERSION__ : '0.0.0';\n\nexport const SDK_HEADER = 'X-Signalbird-Sdk';\n\n/** `node/2.6.0` - platform adları CONTRACT §14.1'deki listededir. */\nexport function sdkHeaderValue(platform: string): string {\n  return `${platform}/${SDK_VERSION}`;\n}\n\n/** Başlık okuyabilen her şey: fetch `Headers`, ya da sahte bir yanıt. */\ninterface HeaderSource {\n  get(name: string): string | null;\n}\n\nlet warned = false;\n\n/**\n * Yanıttaki sürüm durumuna bakar; eskiyse bir kez `console.warn` yazar.\n * Hiçbir koşulda hata fırlatmaz: sürüm uyarısı yüzünden müşterinin isteği\n * bozulmamalı.\n */\nexport function noteSdkStatus(headers: HeaderSource | null | undefined): void {\n  if (warned || !headers) return;\n\n  try {\n    const status = headers.get('Signalbird-Sdk-Status');\n\n    if (status !== 'outdated' && status !== 'unsupported') return;\n\n    warned = true;\n\n    const latest = headers.get('Signalbird-Sdk-Latest') ?? '?';\n    const message = status === 'unsupported'\n      ? `[signalbird] Bu SDK sürümü (${SDK_VERSION}) artık desteklenmiyor. Son sürüm: ${latest}. Paketi güncelleyin.`\n      : `[signalbird] Yeni SDK sürümü var: ${latest} (kurulu: ${SDK_VERSION}).`;\n\n    if (typeof console !== 'undefined') console.warn(message);\n  } catch {\n    // uyarı yazılamadıysa sessiz kal\n  }\n}\n\n/** Yalnız testler için: uyarıyı yeniden kurar. */\nexport function resetSdkStatusWarning(): void {\n  warned = false;\n}\n","/**\n * signalbird/browser - tarayıcı istemcisi.\n *\n * Ayrı bir giriş noktası olmasının sebebi teknik değil, GÜVENLİKTİR: sunucu\n * anahtarı istemciye gömülemez ve sunucu `Origin` başlığı taşıyan bir istekte\n * onu zaten reddeder. Tarayıcı, açık anahtarı (`sb_public_live_…`) kullanır ve\n * güvenliği gizlilikten değil kısıttan gelir: yalnız izinli alan adlarından\n * çalışır ve Origin taşımayan istekte reddedilir (`ORIGIN_REQUIRED`).\n *\n * React, Vue, Angular ve düz JS aynı istemciyi kullanır; çatıya özel sarmalayıcı\n * yoktur çünkü gereken tek şey bir fonksiyon çağrısıdır.\n */\nimport { SDK_HEADER, noteSdkStatus, sdkHeaderValue } from '../shared/version';\n\nexport type Level = 'debug' | 'info' | 'warn' | 'error' | 'critical';\n\nexport interface BrowserConfig {\n  /** Açık anahtar (`sb_public_live_…`). Gizli anahtar BURAYA YAZILMAZ. */\n  publicKey: string;\n  baseUrl?: string;\n  source?: string;\n  /**\n   * Kayıtlar tek tek değil, toplu gider. Kullanıcının tarayıcısından saniyede\n   * onlarca istek çıkarmak hem yavaş hem pahalıdır.\n   */\n  flushIntervalMs?: number;\n  maxQueue?: number;\n  debug?: boolean;\n}\n\ninterface QueuedEvent {\n  key: string;\n  message: string;\n  level?: Level;\n  context?: Record<string, unknown>;\n  source?: string;\n}\n\nconst DEFAULT_BASE_URL = 'https://live.signalbird.io/api';\n\nexport class SignalbirdBrowser {\n  private queue: QueuedEvent[] = [];\n  private timer: ReturnType<typeof setInterval> | null = null;\n  private readonly baseUrl: string;\n  private readonly maxQueue: number;\n\n  constructor(private readonly config: BrowserConfig) {\n    if (!config.publicKey?.startsWith('sb_public_live_')) {\n      throw new Error(\n        'Signalbird: tarayıcı istemcisi açık anahtar ister (sb_public_live_…). ' +\n        'Gizli anahtarı (sb_secret_live_…) istemci koduna KOYMAYIN.'\n      );\n    }\n\n    this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/$/, '');\n    this.maxQueue = config.maxQueue ?? 50;\n\n    if (typeof window !== 'undefined') {\n      this.timer = setInterval(() => void this.flush(), config.flushIntervalMs ?? 3000);\n\n      // Sekme kapanırken kuyruk boşaltılır. `sendBeacon` sayfa ölürken bile\n      // gider; normal fetch yarıda kesilirdi.\n      window.addEventListener('pagehide', () => this.flushBeacon());\n    }\n  }\n\n  log(key: string, message: string, level?: Level, context?: Record<string, unknown>): void {\n    this.queue.push({ key, message, level, context, source: this.config.source });\n\n    // Kuyruk dolduysa beklemeden gönder: bellekte sonsuza kadar biriktirmek,\n    // logu hiç göndermemekten kötüdür.\n    if (this.queue.length >= this.maxQueue) {\n      void this.flush();\n    }\n  }\n\n  info(key: string, message: string, context?: Record<string, unknown>) {\n    this.log(key, message, 'info', context);\n  }\n\n  warn(key: string, message: string, context?: Record<string, unknown>) {\n    this.log(key, message, 'warn', context);\n  }\n\n  error(key: string, message: string, context?: Record<string, unknown>) {\n    this.log(key, message, 'error', context);\n  }\n\n  /**\n   * Tarayıcıdaki yakalanmamış hataları bağlar.\n   *\n   * Varsayılan anahtar `browser`dır ve KRİTİK DEĞİLDİR: istemci tarafı kod\n   * herkesin elindedir, oradan kritik alarm tetiklemek kötü niyetli birine\n   * ekibin telefonunu çaldırma imkânı verirdi. Hangi kanalın kime bildirim\n   * göndereceği panelde durur; oradan sessiz bırakılabilir.\n   */\n  captureErrors(key = 'browser'): () => void {\n    const onError = (event: ErrorEvent) => {\n      this.error(key, event.message, {\n        file: event.filename,\n        line: event.lineno,\n        column: event.colno,\n        url: window.location.href,\n      });\n    };\n\n    const onRejection = (event: PromiseRejectionEvent) => {\n      this.error(key, String(event.reason), { url: window.location.href });\n    };\n\n    window.addEventListener('error', onError);\n    window.addEventListener('unhandledrejection', onRejection);\n\n    return () => {\n      window.removeEventListener('error', onError);\n      window.removeEventListener('unhandledrejection', onRejection);\n    };\n  }\n\n  async flush(): Promise<void> {\n    if (this.queue.length === 0) return;\n\n    const batch = this.queue.splice(0, 100);\n\n    try {\n      const response = await fetch(`${this.baseUrl}/v1/radio/log/batch`, {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n          'X-Signalbird-Key': this.config.publicKey,\n          [SDK_HEADER]: sdkHeaderValue('browser'),\n        },\n        body: JSON.stringify({ events: batch }),\n        keepalive: true,\n      });\n      noteSdkStatus(response.headers);\n    } catch (error) {\n      if (this.config.debug) {\n        console.warn('[signalbird] gönderilemedi', error);\n      }\n      // Kayıtlar geri konur ama kuyruk sınırı aşılmaz: ağ uzun süre kapalıysa\n      // sekme belleği şişmemeli.\n      this.queue = [...batch, ...this.queue].slice(0, this.maxQueue);\n    }\n  }\n\n  /** Sayfa kapanırken son gönderim. */\n  private flushBeacon(): void {\n    if (this.queue.length === 0 || typeof navigator === 'undefined') return;\n\n    const blob = new Blob(\n      [JSON.stringify({ events: this.queue.splice(0, 100) })],\n      { type: 'application/json' }\n    );\n\n    // sendBeacon özel başlık taşıyamaz; anahtar ve SDK sürümü sorgu dizesinden gider.\n    navigator.sendBeacon?.(\n      `${this.baseUrl}/v1/radio/log/batch?k=${encodeURIComponent(this.config.publicKey)}` +\n        `&sdk=${encodeURIComponent(sdkHeaderValue('browser'))}`,\n      blob\n    );\n  }\n\n  destroy(): void {\n    if (this.timer) clearInterval(this.timer);\n    void this.flush();\n  }\n}\n\nlet singleton: SignalbirdBrowser | null = null;\n\n/** Uygulama başlangıcında bir kez çağrılır. */\nexport function initSignalbird(config: BrowserConfig): SignalbirdBrowser {\n  singleton = new SignalbirdBrowser(config);\n  return singleton;\n}\n\n/** Kurulmamışsa sessizce yok sayar - log çağrısı uygulamayı çökertmemeli. */\nexport function signalbird(): SignalbirdBrowser | null {\n  return singleton;\n}\n"]}
+{"version":3,"sources":["../src/shared/version.ts","../src/shared/serialize.ts","../src/browser/index.ts"],"names":[],"mappings":"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","file":"browser.mjs","sourcesContent":["/**\n * SDK sürüm bildirimi - CONTRACT §14.\n *\n * Her istek `X-Signalbird-Sdk: <platform>/<sürüm>` taşır; API bunu kaydeder\n * ve yanıtta `Signalbird-Sdk-Status` (current | outdated | unsupported) ile\n * `Signalbird-Sdk-Latest` döner. SDK eski olduğunu öğrenince geliştiriciye\n * süreç başına BİR KEZ uyarı yazar. Uyarı hata değildir: istek sonucu\n * değişmez, istisna fırlatılmaz.\n *\n * Sürüm numarası derlemede `VERSION` dosyasından gömülür (tsup `define`).\n */\n\ndeclare const __SB_VERSION__: string;\n\nexport const SDK_VERSION: string = typeof __SB_VERSION__ === 'string' ? __SB_VERSION__ : '0.0.0';\n\nexport const SDK_HEADER = 'X-Signalbird-Sdk';\n\n/** `node/2.6.0` - platform adları CONTRACT §14.1'deki listededir. */\nexport function sdkHeaderValue(platform: string): string {\n  return `${platform}/${SDK_VERSION}`;\n}\n\n/** Başlık okuyabilen her şey: fetch `Headers`, ya da sahte bir yanıt. */\ninterface HeaderSource {\n  get(name: string): string | null;\n}\n\nlet warned = false;\n\n/**\n * Yanıttaki sürüm durumuna bakar; eskiyse bir kez `console.warn` yazar.\n * Hiçbir koşulda hata fırlatmaz: sürüm uyarısı yüzünden müşterinin isteği\n * bozulmamalı.\n */\nexport function noteSdkStatus(headers: HeaderSource | null | undefined): void {\n  if (warned || !headers) return;\n\n  try {\n    const status = headers.get('Signalbird-Sdk-Status');\n\n    if (status !== 'outdated' && status !== 'unsupported') return;\n\n    warned = true;\n\n    const latest = headers.get('Signalbird-Sdk-Latest') ?? '?';\n    const message = status === 'unsupported'\n      ? `[signalbird] Bu SDK sürümü (${SDK_VERSION}) artık desteklenmiyor. Son sürüm: ${latest}. Paketi güncelleyin.`\n      : `[signalbird] Yeni SDK sürümü var: ${latest} (kurulu: ${SDK_VERSION}).`;\n\n    if (typeof console !== 'undefined') console.warn(message);\n  } catch {\n    // uyarı yazılamadıysa sessiz kal\n  }\n}\n\n/** Yalnız testler için: uyarıyı yeniden kurar. */\nexport function resetSdkStatusWarning(): void {\n  warned = false;\n}\n","/**\n * Telsiz gövdesini sunucunun kabul edeceği biçime getiren yardımcılar.\n *\n * Node ve tarayıcı istemcisi ortak kullanır. Sınıf metodu DEĞİL, modül\n * fonksiyonudur: `check-parity.mjs` istemci sınıfının girintili metotlarını\n * sayar ve buraya eklenen bir yardımcı Telsiz paritesini bozardı.\n */\n\n/**\n * API `message` alanını `max:4000` ile doğrular (Laravel → `mb_strlen`, yani\n * KOD NOKTASI). Sınırı aşan tek satır 422 alır ve toplu gönderimde bütün\n * paketi düşürür - 99 sağlam log bir uzun yığın izi yüzünden kaybolurdu.\n */\nexport const MAX_MESSAGE_LENGTH = 4000;\n\n/**\n * Mesajı 4000 kod noktasına kırpar.\n *\n * `.slice(0, 4000)` UTF-16 birimi sayar ve bir emoji'nin (vekil çift) ortasından\n * kesebilir; tek kalan vekil `\\ud83d` olarak gider ve PHP `json_decode` bütün\n * gövdeyi reddeder - düzeltmeye çalıştığımız hatanın aynısı. `Array.from` kod\n * noktası üzerinden yürür; pahalıdır, bu yüzden yalnız sınır aşıldığında çalışır.\n */\nexport function truncateMessage(message: string): string {\n  const text = typeof message === 'string' ? message : String(message);\n\n  if (text.length <= MAX_MESSAGE_LENGTH) {\n    return text;\n  }\n\n  return Array.from(text).slice(0, MAX_MESSAGE_LENGTH).join('');\n}\n\n/**\n * `context`'i JSON'a güvenle çevrilebilir bir kopyaya dönüştürür.\n *\n * `JSON.stringify` döngüsel nesnede (ör. `req`, Mongoose belgesi) ve\n * `BigInt`'te İSTİSNA fırlatır. Node'da bu istisna isteğin içinde\n * yakalanıp `NETWORK_ERROR` diye raporlanıyordu - asıl sebep görünmüyordu.\n * Tarayıcıda daha kötüsü: başarısız toplu gönderim kuyruğa geri konur, aynı\n * satır her 3 saniyede tekrar patlar ve arkasındaki bütün loglar takılı kalırdı.\n *\n *  - döngüsel başvuru → `\"[Circular]\"` (yalnız ATA zinciri sayılır: aynı nesneye\n *    iki kardeş alandan başvurmak döngü değildir ve korunur)\n *  - `Error` → `{name, message, stack}` (JSON'da `{}` olurdu, yani bilgi kaybı)\n *  - `BigInt` → string\n *  - `toJSON` taşıyan nesne (Date vb.) → onun çıktısı\n *  - erişimde fırlatan getter → `\"[Unserializable]\"`\n */\nexport function toJsonSafe(value: unknown): unknown {\n  const ancestors: object[] = [];\n\n  const walk = (current: unknown): unknown => {\n    if (typeof current === 'bigint') {\n      return current.toString();\n    }\n\n    // Fonksiyon, symbol ve undefined olduğu gibi kalır: JSON.stringify onları\n    // zaten atar (dizide null yapar); burada ayrıca karar vermeye gerek yok.\n    if (current === null || typeof current !== 'object') {\n      return current;\n    }\n\n    if (ancestors.includes(current)) {\n      return '[Circular]';\n    }\n\n    if (current instanceof Error) {\n      return { name: current.name, message: current.message, stack: current.stack };\n    }\n\n    const withToJson = current as { toJSON?: () => unknown };\n\n    if (typeof withToJson.toJSON === 'function') {\n      try {\n        ancestors.push(current);\n        return walk(withToJson.toJSON());\n      } catch {\n        return '[Unserializable]';\n      } finally {\n        ancestors.pop();\n      }\n    }\n\n    ancestors.push(current);\n\n    try {\n      if (Array.isArray(current)) {\n        return current.map((item) => walk(item));\n      }\n\n      const out: Record<string, unknown> = {};\n\n      for (const key of Object.keys(current)) {\n        let item: unknown;\n\n        try {\n          item = (current as Record<string, unknown>)[key];\n        } catch {\n          item = '[Unserializable]';\n        }\n\n        out[key] = walk(item);\n      }\n\n      return out;\n    } finally {\n      ancestors.pop();\n    }\n  };\n\n  return walk(value);\n}\n\n/** `context` verilmediyse `undefined` kalır (gövdeye hiç girmez). */\nexport function safeContext(context?: Record<string, unknown>): Record<string, unknown> | undefined {\n  if (context === undefined || context === null) {\n    return undefined;\n  }\n\n  return toJsonSafe(context) as Record<string, unknown>;\n}\n","/**\n * signalbird/browser - tarayıcı istemcisi.\n *\n * Ayrı bir giriş noktası olmasının sebebi teknik değil, GÜVENLİKTİR: sunucu\n * anahtarı istemciye gömülemez ve sunucu `Origin` başlığı taşıyan bir istekte\n * onu zaten reddeder. Tarayıcı, açık anahtarı (`sb_public_live_…`) kullanır ve\n * güvenliği gizlilikten değil kısıttan gelir: yalnız izinli alan adlarından\n * çalışır ve Origin taşımayan istekte reddedilir (`ORIGIN_REQUIRED`).\n *\n * React, Vue, Angular ve düz JS aynı istemciyi kullanır; çatıya özel sarmalayıcı\n * yoktur çünkü gereken tek şey bir fonksiyon çağrısıdır.\n */\nimport { SDK_HEADER, noteSdkStatus, sdkHeaderValue } from '../shared/version';\nimport { safeContext, truncateMessage } from '../shared/serialize';\n\nexport type Level = 'debug' | 'info' | 'warn' | 'error' | 'critical';\n\nexport interface BrowserConfig {\n  /** Açık anahtar (`sb_public_live_…`). Gizli anahtar BURAYA YAZILMAZ. */\n  publicKey: string;\n  baseUrl?: string;\n  source?: string;\n  /**\n   * Kayıtlar tek tek değil, toplu gider. Kullanıcının tarayıcısından saniyede\n   * onlarca istek çıkarmak hem yavaş hem pahalıdır.\n   */\n  flushIntervalMs?: number;\n  maxQueue?: number;\n  debug?: boolean;\n}\n\ninterface QueuedEvent {\n  key: string;\n  message: string;\n  level?: Level;\n  context?: Record<string, unknown>;\n  source?: string;\n}\n\nconst DEFAULT_BASE_URL = 'https://live.signalbird.io/api';\n\nexport class SignalbirdBrowser {\n  private queue: QueuedEvent[] = [];\n  private timer: ReturnType<typeof setInterval> | null = null;\n  private readonly baseUrl: string;\n  private readonly maxQueue: number;\n\n  constructor(private readonly config: BrowserConfig) {\n    if (!config.publicKey?.startsWith('sb_public_live_')) {\n      throw new Error(\n        'Signalbird: tarayıcı istemcisi açık anahtar ister (sb_public_live_…). ' +\n        'Gizli anahtarı (sb_secret_live_…) istemci koduna KOYMAYIN.'\n      );\n    }\n\n    this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/$/, '');\n    this.maxQueue = config.maxQueue ?? 50;\n\n    if (typeof window !== 'undefined') {\n      this.timer = setInterval(() => void this.flush(), config.flushIntervalMs ?? 3000);\n\n      // Sekme kapanırken kuyruk boşaltılır. `sendBeacon` sayfa ölürken bile\n      // gider; normal fetch yarıda kesilirdi.\n      window.addEventListener('pagehide', () => this.flushBeacon());\n    }\n  }\n\n  /**\n   * Kanalı bağlar ve yazacı döner - sunucu istemcisindeki `radio()` ile aynı\n   * deyim (CONTRACT §1.1):\n   *\n   *     sb.radio('sepet').error('sepet güncellenemedi', { cartId })\n   *\n   * `critical` BİLEREK yoktur: istemci kodu herkesin elindedir ve oradan\n   * kritik alarm (sessiz saatleri delen bildirim) tetiklemek, kötü niyetli\n   * birine ekibin telefonunu çaldırma imkânı verirdi. Gerekirse\n   * `log(key, msg, 'critical')` hâlâ yazılabilir; kanal ayarı panelde durur.\n   */\n  radio(key: string) {\n    return {\n      debug: (message: string, context?: Record<string, unknown>) => this.log(key, message, 'debug', context),\n      info: (message: string, context?: Record<string, unknown>) => this.log(key, message, 'info', context),\n      warn: (message: string, context?: Record<string, unknown>) => this.log(key, message, 'warn', context),\n      error: (message: string, context?: Record<string, unknown>) => this.log(key, message, 'error', context),\n    };\n  }\n\n  log(key: string, message: string, level?: Level, context?: Record<string, unknown>): void {\n    /*\n     * Kırpma ve güvenli kopya KUYRUĞA GİRERKEN yapılır, gönderirken değil:\n     *  - 4000'i aşan tek mesaj bütün toplu paketi 422 ile düşürürdü;\n     *  - döngüsel `context` `JSON.stringify`'da patlar, `flush()` paketi geri\n     *    kuyruğa koyar ve aynı satır her turda tekrar patlayıp arkasındaki\n     *    bütün logları sonsuza dek bekletirdi;\n     *  - kopya o anki durumu saklar; nesne gönderime kadar değişse bile log,\n     *    yazıldığı andaki değeri taşır.\n     */\n    this.queue.push({\n      key,\n      message: truncateMessage(message),\n      level,\n      context: safeContext(context),\n      source: this.config.source,\n    });\n\n    // Kuyruk dolduysa beklemeden gönder: bellekte sonsuza kadar biriktirmek,\n    // logu hiç göndermemekten kötüdür.\n    if (this.queue.length >= this.maxQueue) {\n      void this.flush();\n    }\n  }\n\n  info(key: string, message: string, context?: Record<string, unknown>) {\n    this.log(key, message, 'info', context);\n  }\n\n  warn(key: string, message: string, context?: Record<string, unknown>) {\n    this.log(key, message, 'warn', context);\n  }\n\n  error(key: string, message: string, context?: Record<string, unknown>) {\n    this.log(key, message, 'error', context);\n  }\n\n  /**\n   * Tarayıcıdaki yakalanmamış hataları bağlar.\n   *\n   * Varsayılan anahtar `browser`dır ve KRİTİK DEĞİLDİR: istemci tarafı kod\n   * herkesin elindedir, oradan kritik alarm tetiklemek kötü niyetli birine\n   * ekibin telefonunu çaldırma imkânı verirdi. Hangi kanalın kime bildirim\n   * göndereceği panelde durur; oradan sessiz bırakılabilir.\n   */\n  captureErrors(key = 'browser'): () => void {\n    const onError = (event: ErrorEvent) => {\n      this.error(key, event.message, {\n        file: event.filename,\n        line: event.lineno,\n        column: event.colno,\n        url: window.location.href,\n      });\n    };\n\n    const onRejection = (event: PromiseRejectionEvent) => {\n      this.error(key, String(event.reason), { url: window.location.href });\n    };\n\n    window.addEventListener('error', onError);\n    window.addEventListener('unhandledrejection', onRejection);\n\n    return () => {\n      window.removeEventListener('error', onError);\n      window.removeEventListener('unhandledrejection', onRejection);\n    };\n  }\n\n  async flush(): Promise<void> {\n    if (this.queue.length === 0) return;\n\n    const batch = this.queue.splice(0, 100);\n\n    try {\n      const response = await fetch(`${this.baseUrl}/v1/radio/log/batch`, {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n          'X-Signalbird-Key': this.config.publicKey,\n          [SDK_HEADER]: sdkHeaderValue('browser'),\n        },\n        body: JSON.stringify({ events: batch }),\n        keepalive: true,\n      });\n      noteSdkStatus(response.headers);\n    } catch (error) {\n      if (this.config.debug) {\n        console.warn('[signalbird] gönderilemedi', error);\n      }\n      // Kayıtlar geri konur ama kuyruk sınırı aşılmaz: ağ uzun süre kapalıysa\n      // sekme belleği şişmemeli.\n      this.queue = [...batch, ...this.queue].slice(0, this.maxQueue);\n    }\n  }\n\n  /** Sayfa kapanırken son gönderim. */\n  private flushBeacon(): void {\n    if (this.queue.length === 0 || typeof navigator === 'undefined') return;\n\n    /*\n     * `text/plain`, `application/json` DEĞİL: `sendBeacon` CORS ön kontrolü\n     * (preflight) yapamaz; \"basit\" olmayan içerik türü taşıyan cross-origin\n     * beacon'ı tarayıcı hiç göndermez ve sayfa kapanırken son loglar sessizce\n     * kaybolurdu. Gövde yine JSON'dur; API Telsiz log uçlarında text/plain\n     * gövdeyi JSON olarak ayrıştırır. `fetch` yolu `application/json` kalır.\n     */\n    const blob = new Blob(\n      [JSON.stringify({ events: this.queue.splice(0, 100) })],\n      { type: 'text/plain;charset=UTF-8' }\n    );\n\n    // sendBeacon özel başlık taşıyamaz; anahtar ve SDK sürümü sorgu dizesinden gider.\n    navigator.sendBeacon?.(\n      `${this.baseUrl}/v1/radio/log/batch?k=${encodeURIComponent(this.config.publicKey)}` +\n        `&sdk=${encodeURIComponent(sdkHeaderValue('browser'))}`,\n      blob\n    );\n  }\n\n  destroy(): void {\n    if (this.timer) clearInterval(this.timer);\n    void this.flush();\n  }\n}\n\nlet singleton: SignalbirdBrowser | null = null;\n\n/** Uygulama başlangıcında bir kez çağrılır. */\nexport function initSignalbird(config: BrowserConfig): SignalbirdBrowser {\n  singleton = new SignalbirdBrowser(config);\n  return singleton;\n}\n\n/** Kurulmamışsa sessizce yok sayar - log çağrısı uygulamayı çökertmemeli. */\nexport function signalbird(): SignalbirdBrowser | null {\n  return singleton;\n}\n"]}

package/dist/index.d.mts

@@ -57,7 +57,7 @@ interface LogResult {
     ok: boolean;
     /** Sunucunun döndüğü olay kimliği (rev_…). */
     eventId?: string;
-    /** Reddedildiyse sebep: INVALID_KEY, MODULE_DISABLED, LIMIT_REACHED… */
+    /** Reddedildiyse sebep: DOMAIN_KEY_INVALID, MODULE_DISABLED, MODULE_KEY_DISABLED, LIMIT_REACHED… */
     code?: string;
     status?: number;
 }
@@ -114,13 +114,22 @@ declare class SignalbirdClient {
         error: (message: string, context?: Record<string, unknown>) => Promise<LogResult>;
         critical: (message: string, context?: Record<string, unknown>) => Promise<LogResult>;
     };
-    /** Tek kayıt gönderir. */
+    /**
+     * Tek kayıt gönderir.
+     *
+     * `message` 4000 kod noktasına kırpılır (API sınırı; aşan satır 422 alırdı)
+     * ve `context` güvenli kopyaya çevrilir: döngüsel nesne ya da BigInt artık
+     * `NETWORK_ERROR` gibi görünen bir istisnaya dönüşmez.
+     */
     log(input: LogInput): Promise<LogResult>;
     /**
      * Toplu gönderim - 100 kayda kadar.
      *
      * Kısmi başarı normaldir (kota tam ortada dolabilir), o yüzden sonuç tek bir
      * durum değil satır satır döner.
+     *
+     * Doğrulama ise satır satır DEĞİLDİR: tek bir geçersiz satır (4000'i aşan
+     * mesaj) bütün paketi 422 ile düşürür. Bu yüzden kırpma burada da yapılır.
      */
     batch(events: LogInput[]): Promise<BatchResult>;
     debugLog(key: string, message: string, context?: Record<string, unknown>): Promise<LogResult>;
@@ -128,6 +137,17 @@ declare class SignalbirdClient {
     warn(key: string, message: string, context?: Record<string, unknown>): Promise<LogResult>;
     error(key: string, message: string, context?: Record<string, unknown>): Promise<LogResult>;
     critical(key: string, message: string, context?: Record<string, unknown>): Promise<LogResult>;
+    /**
+     * Kimlik doğrulama hash'i (CONTRACT §15.2) - sohbet/push ziyaretçisinin
+     * `external_id`'sini GÜVENİLİR kılar.
+     *
+     *     identity_hash = hex(HMAC-SHA256(hex(SHA-256(secretKey)), externalId))
+     *
+     * Anahtar gizli anahtarın kendisi değil SHA-256 özetidir: sunucu anahtarı
+     * düz saklamaz. Hash sunucuda üretilir, sayfaya `external_id` ile birlikte
+     * yazılır; gizli anahtar istemciye İNMEZ.
+     */
+    identityHash(externalId: string): string;
     /**
      * Yakalanmamış hataları Telsiz'e bağlar.
      *
@@ -148,7 +168,7 @@ declare class SignalbirdClient {
  * bulunur ve iki doküman arasında çeviri tablosu gerekmez.
  */
 interface MessagingConfig {
-    /** Takım API anahtarı (`sb_…`). GİZLİDİR, yalnız sunucuda kullanılır. */
+    /** Gizli domain anahtarı (`sb_secret_live_…`). Yalnız sunucuda kullanılır. */
     domainKey: string;
     /** Varsayılan: https://live.signalbird.io/api */
     baseUrl?: string;
@@ -174,22 +194,96 @@ type SbResult$1<T> = {
 /** İleti sınıfı - API'de zorunludur ve varsayılanı YOKTUR (hukuki kapı). */
 type MessageClass = 'transactional' | 'commercial';
 type Channel = 'email' | 'sms' | 'push';
+/** E-posta eki - içerik base64; toplam çözülmüş boyut sınırı sunucudadır (7 MB). */
+interface EmailAttachment {
+    filename: string;
+    mime?: string;
+    /** Dosya içeriği, base64. */
+    content_b64: string;
+}
+/**
+ * `POST /v1/email/send` gövdesi - alanlar API doğrulamasıyla birebir
+ * (signalbird.api `Api\V1\MessagingController::sendEmail`).
+ *
+ * İçerik iki yoldan gelir: ya `subject` + `body`, ya panelde tanımlı bir
+ * şablon (`template` adıyla ya da `template_id` ile). Şablon verilmediyse
+ * `subject` ve `body` ZORUNLUDUR (API: `required_without_all:template_id,template`);
+ * verildiyse ikisi de şablondan gelir ve istenirse ezilebilir.
+ *
+ * Tip bilerek arayüz olarak kaldı (birleşim tipi değil): kullanıcı kodunda
+ * `extends SendEmailInput` yazan herkes kırılırdı.
+ */
 interface SendEmailInput {
+    /** Alıcı e-posta adresi. */
     to: string;
+    /** Zorunlu, varsayılanı yok: işlemsel ile ticari arasındaki fark hukukidir. */
     class: MessageClass;
-    subject: string;
+    /** Konu (en fazla 255). Şablon yoksa zorunlu. */
+    subject?: string;
+    /** Gövde - HTML ya da düz metin. Şablon yoksa zorunlu. */
     body?: string;
-    template_hash?: string;
+    /** Panelde tanımlı şablonun ADI (en fazla 190). Ad tercih edilir: şablon yeniden yaratılsa da kod değişmez. */
+    template?: string;
+    /** Panelde tanımlı şablonun kimliği. */
+    template_id?: number;
+    /** Şablon/gövde değişkenleri - `{{ad}}` yerine geçer. */
     vars?: Record<string, unknown>;
+    /**
+     * GÖNDERİCİ KANALI: panelde adresle birlikte açılan `email` modül anahtarı
+     * (`noReply`). From adresini kanal seçer - PHP'deki
+     * `Signalbird::sendMail('noReply')` karşılığı. Kanala adres bağlanmamışsa
+     * 422 `SENDER_NOT_CONFIGURED`; tanımsız kanal `MODULE_KEY_NOT_FOUND`.
+     */
+    module_key?: string;
+    /** Belirli bir doğrulanmış gönderen alan adından çıksın. */
     sending_domain_id?: number;
+    /** Gönderen ADRES seçimi (destek@…); alan adını da belirler. `module_key` verilirse kanalınki geçerlidir. */
+    sending_address_id?: number;
+    /** Signalbird'deki kişi kaydı - açılma/tıklama geçmişi ona yazılsın. */
     contact_id?: number;
+    /** Görünen gönderen adı (en fazla 120). Zarf adresi değil. */
+    from_name?: string;
+    /** "Yanıtla" adresi. */
+    reply_to?: string;
+    /** En fazla 5 ek. */
+    attachments?: EmailAttachment[];
+    /**
+     * @deprecated API bu alanı hiç okumaz ve SDK onu GÖNDERMEZ (2.9.0). Şablon
+     * için `template` (ad) ya da `template_id` kullanın. Yalnız eski kodun tip
+     * denetiminde kırılmaması için tanımlı; başka bir alana eşlenmez.
+     */
+    template_hash?: string;
 }
+/**
+ * `POST /v1/sms/send` gövdesi - alanlar API doğrulamasıyla birebir
+ * (signalbird.api `Api\V1\MessagingController::sendSms`).
+ *
+ * İçerik ya `body` ya da panelde tanımlı bir şablondur (`template` adıyla ya
+ * da `template_id` ile). Şablon verilmediyse `body` ZORUNLUDUR (API:
+ * `required_without_all:template_id,template`).
+ *
+ * E-postanın aksine SMS ucunda gönderici KANALI (`module_key`) yoktur;
+ * gönderen adı `sender` ile seçilir.
+ */
 interface SendSmsInput {
+    /** Alıcı telefon (en fazla 20). Sunucu normalize eder; geçersizse 422 `INVALID_PHONE`. */
     to: string;
+    /** Zorunlu, varsayılanı yok: işlemsel ile ticari arasındaki fark hukukidir. */
     class: MessageClass;
-    body: string;
+    /** Mesaj metni (en fazla 1600). Şablon yoksa zorunlu. */
+    body?: string;
+    /** Panelde tanımlı şablonun ADI (en fazla 190). */
+    template?: string;
+    /** Panelde tanımlı şablonun kimliği. */
+    template_id?: number;
+    /** Şablon/gövde değişkenleri - `{{ad}}` yerine geçer. */
+    vars?: Record<string, unknown>;
+    /** Marka (SMS başlığı/kotası bu markadan). */
     brand_id?: number;
+    /** Signalbird'deki kişi kaydı. */
     contact_id?: number;
+    /** Onaylı SMS gönderici adı (en fazla 11). Verilmezse şirketin varsayılanı. */
+    sender?: string;
 }
 interface SendPushInput {
     /** Cihaz token'ı, `contact:<id>` ya da `external:<external_id>`. */
@@ -599,7 +693,7 @@ interface EmbedToken {
 }
 
 interface ManagementConfig {
-    /** Takım API anahtarı (`sb_…`) - `radio:*`, `chat:*`, `apps:*` scope'larıyla. */
+    /** Gizli domain anahtarı (`sb_secret_live_…`). Scope yoktur (v2); yalnız gömme jetonu ayrı onay ister. */
     domainKey: string;
     /** Varsayılan: https://live.signalbird.io/api */
     baseUrl?: string;
@@ -913,9 +1007,9 @@ interface TeamEmbedTokenInput {
  * kayıtlarına dokunur; başka takımın kaydı 404 döner.
  *
  * Neden ayrı sınıf: Gönderim (`SignalbirdMessaging`) ileti gönderir ve kota
- * harcar; bu istemci yapılandırma değiştirir. Aynı anahtar ailesini kullanırlar
- * (`sb_…`) ama scope'ları ve hata kümeleri farklıdır - tek sınıfta birleşseydi
- * "hangi scope gerekiyordu" sorusu her metotta yeniden sorulurdu.
+ * harcar; bu istemci yapılandırma değiştirir. Aynı gizli domain anahtarını
+ * (`sb_secret_live_…`) kullanırlar ama hata kümeleri farklıdır - tek sınıfta
+ * birleşseydi her metotta "bu kod hangi yüzeyin" sorusu sorulurdu.
  *
  * Sözleşme: docs/CONTRACT.md § 10
  */
@@ -1055,7 +1149,7 @@ declare class SignalbirdManagement {
  *
  * **Bu, CLAUDE.md'deki "Admin yüzeyi OLMAYACAK" kuralının bilinçli
  * istisnasıdır** ve istisna olduğu için ayrı anahtar türü taşır. Kural,
- * müşterinin kendi anahtarıyla (`sb_`) şirket açamaması içindi; o kural aynen
+ * müşterinin kendi anahtarıyla şirket açamaması içindi; o kural aynen
  * duruyor. Sözleşmeli partner farklı bir taraftır.
  *
  * Gizli anahtar **asla tarayıcıya inmez**: gömme jetonunu partner'ın
@@ -1162,11 +1256,12 @@ declare function verifyWebhook(rawBody: string | Uint8Array, signatureHeader: st
  * Node betikleri buradan alır. TARAYICI için `signalbird/browser`
  * kullanılır - gizli anahtar istemciye inmez.
  *
- * Üç sunucu istemcisi vardır; anahtarları ve kapıları farklıdır:
- *  - `SignalbirdClient`     → Telsiz (log yazma), `sb_secret_live_…`
- *  - `SignalbirdMessaging`  → Gönderim (e-posta/SMS/push/kişi/kampanya), `sb_…`
- *  - `SignalbirdManagement` → Yönetim (Telsiz projesi, sohbet gelen kutusu,
- *                             uygulama kaydı), `sb_…` + `radio|chat|apps` scope'ları
+ * Sunucu istemcilerinin HEPSİ aynı gizli domain anahtarını (`sb_secret_live_…`)
+ * kullanır; ayrım anahtarda değil, kapıdadır:
+ *  - `SignalbirdClient`     → Telsiz (log yazma)
+ *  - `SignalbirdMessaging`  → Gönderim (e-posta/SMS/push/kişi/kampanya)
+ *  - `SignalbirdManagement` → Yönetim (olay akışı, modül anahtarları, sohbet
+ *                             gelen kutusu)
  *  - `SignalbirdPartner`    → Partner (müşteri sağlama, modül yetkisi, gömme),
  *                             gizli anahtar - yalnız sözleşmeli platformlar
  *
@@ -1190,8 +1285,8 @@ declare function resetSignalbird(): void;
 /**
  * Ortam değişkeninden kurulan paylaşımlı yönetim istemcisi.
  *
- * `SIGNALBIRD_DOMAIN_KEY` okunur (yoksa `SIGNALBIRD_DOMAIN_KEY` - ikisi de aynı
- * takım anahtarı ailesidir ve çoğu kurulumda tek anahtar kullanılır).
+ * `SIGNALBIRD_DOMAIN_KEY` okunur - Telsiz ve Gönderim ile aynı gizli domain
+ * anahtarı (`sb_secret_live_…`).
  *
  *   import { management } from 'signalbird'
  *   await management().createModuleKey('logger', { title: 'Kritik API hatası' })
@@ -1200,4 +1295,4 @@ declare function management(config?: Partial<ManagementConfig>): SignalbirdManag
 /** Test ve sıcak yeniden yükleme için yönetim istemcisini sıfırlar. */
 declare function resetManagement(): void;
 
-export { type AddDomainInput, type AddDomainResult, type AppDevice, type AppPlatform, type Batch, type BatchResult, type BulkContactsInput, type BulkContactsResult, type CampaignCreateResult, type CampaignDetail, type CannedReply, type CannedReplyInput, type Channel, type ChatConversation, type ChatMessage, type ChatVisitor, type Contact, type ContactInput, type ContactList, type ConversationStatus, type CreateCampaignInput, type CreateCompanyInput, type CreateCompanyResult, type CreateContactListInput, DEFAULT_BASE_URL, type DnsRecord, type EmbedModule, type EmbedToken, type EmbedTokenInput, type GrantModuleInput, type Level, type ListAppDevicesQuery, type ListCampaignMessagesQuery, type ListCampaignsQuery, type ListChatMessagesQuery, type ListContactsQuery, type ListConversationsQuery, type ListMessagesQuery, type ListRadioEventsQuery, type LogInput, type LogResult, type ManagementConfig, type Message, type MessageClass, type MessagingConfig, type MessagingErrorCode, type ModuleEntitlement, type Paginated$1 as Paginated, type PartnerCompany, type PartnerConfig, type PartnerDomain, type PartnerOwnerInput, type PartnerUser, type PartnerUserInput, type RadioEvent, type RadioLevel, type ReplyInput, type SbResult$1 as SbResult, type SendEmailInput, type SendPushInput, type SendResult, type SendSmsInput, SignalbirdClient, type SignalbirdConfig, SignalbirdError, SignalbirdManagement, SignalbirdMessaging, SignalbirdPartner, type SmsPreview, type StartConversationInput, type TeamEmbedTokenInput, type UpdateConversationInput, type UpdateVisitorInput, type UptimeIncident, type UptimeRange, type UptimeReport, type VerifyDomainResult, management, resetManagement, resetSignalbird, signalbird, verifyWebhook };
+export { type AddDomainInput, type AddDomainResult, type AppDevice, type AppPlatform, type Batch, type BatchResult, type BulkContactsInput, type BulkContactsResult, type CampaignCreateResult, type CampaignDetail, type CannedReply, type CannedReplyInput, type Channel, type ChatConversation, type ChatMessage, type ChatVisitor, type Contact, type ContactInput, type ContactList, type ConversationStatus, type CreateCampaignInput, type CreateCompanyInput, type CreateCompanyResult, type CreateContactListInput, DEFAULT_BASE_URL, type DnsRecord, type EmailAttachment, type EmbedModule, type EmbedToken, type EmbedTokenInput, type GrantModuleInput, type Level, type ListAppDevicesQuery, type ListCampaignMessagesQuery, type ListCampaignsQuery, type ListChatMessagesQuery, type ListContactsQuery, type ListConversationsQuery, type ListMessagesQuery, type ListRadioEventsQuery, type LogInput, type LogResult, type ManagementConfig, type Message, type MessageClass, type MessagingConfig, type MessagingErrorCode, type ModuleEntitlement, type Paginated$1 as Paginated, type PartnerCompany, type PartnerConfig, type PartnerDomain, type PartnerOwnerInput, type PartnerUser, type PartnerUserInput, type RadioEvent, type RadioLevel, type ReplyInput, type SbResult$1 as SbResult, type SendEmailInput, type SendPushInput, type SendResult, type SendSmsInput, SignalbirdClient, type SignalbirdConfig, SignalbirdError, SignalbirdManagement, SignalbirdMessaging, SignalbirdPartner, type SmsPreview, type StartConversationInput, type TeamEmbedTokenInput, type UpdateConversationInput, type UpdateVisitorInput, type UptimeIncident, type UptimeRange, type UptimeReport, type VerifyDomainResult, management, resetManagement, resetSignalbird, signalbird, verifyWebhook };