signalbird 1.4.0

package/dist/browser.d.ts

@@ -0,0 +1,56 @@
+/**
+ * signalbird/browser — tarayıcı istemcisi.
+ *
+ * Ayrı bir giriş noktası olmasının sebebi teknik değil, GÜVENLİKTİR: sunucu
+ * anahtarı istemciye gömülemez ve sunucu `Origin` başlığı taşıyan bir istekte
+ * onu zaten reddeder. Tarayıcı, açık anahtarı (`sbr_pub_…`) kullanır ve
+ * güvenliği gizlilikten değil kısıttan gelir — yalnız izinli alan adlarından
+ * ve yalnız izin verilen kanallara yazabilir.
+ *
+ * React, Vue, Angular ve düz JS aynı istemciyi kullanır; çatıya özel sarmalayıcı
+ * yoktur çünkü gereken tek şey bir fonksiyon çağrısıdır.
+ */
+type Level = 'debug' | 'info' | 'warn' | 'error' | 'critical';
+interface BrowserConfig {
+    /** Açık anahtar (`sbr_pub_…`). Gizli anahtar BURAYA YAZILMAZ. */
+    publicKey: string;
+    baseUrl?: string;
+    source?: string;
+    /**
+     * Kayıtlar tek tek değil, toplu gider. Kullanıcının tarayıcısından saniyede
+     * onlarca istek çıkarmak hem yavaş hem pahalıdır.
+     */
+    flushIntervalMs?: number;
+    maxQueue?: number;
+    debug?: boolean;
+}
+declare class SignalbirdBrowser {
+    private readonly config;
+    private queue;
+    private timer;
+    private readonly baseUrl;
+    private readonly maxQueue;
+    constructor(config: BrowserConfig);
+    log(channel: string, message: string, level?: Level, context?: Record<string, unknown>): void;
+    info(channel: string, message: string, context?: Record<string, unknown>): void;
+    warn(channel: string, message: string, context?: Record<string, unknown>): void;
+    error(channel: string, message: string, context?: Record<string, unknown>): void;
+    /**
+     * Tarayıcıdaki yakalanmamış hataları bağlar.
+     *
+     * Kritik kanala YAZMAZ: istemci tarafı kod herkesin elindedir, oradan
+     * kritik alarm tetiklemek kötü niyetli birine ekibin telefonunu çaldırma
+     * imkânı verirdi. Sunucu zaten `browser_channels` ile bunu kısıtlar.
+     */
+    captureErrors(channel?: string): () => void;
+    flush(): Promise<void>;
+    /** Sayfa kapanırken son gönderim. */
+    private flushBeacon;
+    destroy(): void;
+}
+/** Uygulama başlangıcında bir kez çağrılır. */
+declare function initSignalbird(config: BrowserConfig): SignalbirdBrowser;
+/** Kurulmamışsa sessizce yok sayar — log çağrısı uygulamayı çökertmemeli. */
+declare function signalbird(): SignalbirdBrowser | null;
+
+export { type BrowserConfig, type Level, SignalbirdBrowser, initSignalbird, signalbird };

package/dist/browser.js

@@ -0,0 +1,113 @@
+'use strict';
+
+// src/browser/index.ts
+var DEFAULT_BASE_URL = "https://signalbird.io/api";
+var SignalbirdBrowser = class {
+  constructor(config) {
+    this.config = config;
+    this.queue = [];
+    this.timer = null;
+    if (!config.publicKey?.startsWith("sbr_pub_")) {
+      throw new Error(
+        "Signalbird: taray\u0131c\u0131 istemcisi a\xE7\u0131k anahtar ister (sbr_pub_\u2026). Gizli anahtar\u0131 (sbr_live_\u2026) istemci koduna KOYMAYIN."
+      );
+    }
+    this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, "");
+    this.maxQueue = config.maxQueue ?? 50;
+    if (typeof window !== "undefined") {
+      this.timer = setInterval(() => void this.flush(), config.flushIntervalMs ?? 3e3);
+      window.addEventListener("pagehide", () => this.flushBeacon());
+    }
+  }
+  log(channel, message, level, context) {
+    this.queue.push({ channel, message, level, context, source: this.config.source });
+    if (this.queue.length >= this.maxQueue) {
+      void this.flush();
+    }
+  }
+  info(channel, message, context) {
+    this.log(channel, message, "info", context);
+  }
+  warn(channel, message, context) {
+    this.log(channel, message, "warn", context);
+  }
+  error(channel, message, context) {
+    this.log(channel, message, "error", context);
+  }
+  /**
+   * Tarayıcıdaki yakalanmamış hataları bağlar.
+   *
+   * Kritik kanala YAZMAZ: istemci tarafı kod herkesin elindedir, oradan
+   * kritik alarm tetiklemek kötü niyetli birine ekibin telefonunu çaldırma
+   * imkânı verirdi. Sunucu zaten `browser_channels` ile bunu kısıtlar.
+   */
+  captureErrors(channel = "browser") {
+    const onError = (event) => {
+      this.error(channel, event.message, {
+        file: event.filename,
+        line: event.lineno,
+        column: event.colno,
+        url: window.location.href
+      });
+    };
+    const onRejection = (event) => {
+      this.error(channel, String(event.reason), { url: window.location.href });
+    };
+    window.addEventListener("error", onError);
+    window.addEventListener("unhandledrejection", onRejection);
+    return () => {
+      window.removeEventListener("error", onError);
+      window.removeEventListener("unhandledrejection", onRejection);
+    };
+  }
+  async flush() {
+    if (this.queue.length === 0) return;
+    const batch = this.queue.splice(0, 100);
+    try {
+      await fetch(`${this.baseUrl}/v1/radio/log/batch`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "X-Signalbird-Key": this.config.publicKey
+        },
+        body: JSON.stringify({ events: batch }),
+        keepalive: true
+      });
+    } catch (error) {
+      if (this.config.debug) {
+        console.warn("[signalbird] g\xF6nderilemedi", error);
+      }
+      this.queue = [...batch, ...this.queue].slice(0, this.maxQueue);
+    }
+  }
+  /** Sayfa kapanırken son gönderim. */
+  flushBeacon() {
+    if (this.queue.length === 0 || typeof navigator === "undefined") return;
+    const blob = new Blob(
+      [JSON.stringify({ events: this.queue.splice(0, 100) })],
+      { type: "application/json" }
+    );
+    navigator.sendBeacon?.(
+      `${this.baseUrl}/v1/radio/log/batch?key=${encodeURIComponent(this.config.publicKey)}`,
+      blob
+    );
+  }
+  destroy() {
+    if (this.timer) clearInterval(this.timer);
+    void this.flush();
+  }
+};
+var singleton = null;
+function initSignalbird(config) {
+  singleton = new SignalbirdBrowser(config);
+  return singleton;
+}
+function signalbird() {
+  return singleton;
+}
+
+exports.SignalbirdBrowser = SignalbirdBrowser;
+exports.initSignalbird = initSignalbird;
+exports.signalbird = signalbird;
+//# sourceMappingURL=browser.js.map
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/browser/index.ts"],"names":[],"mappings":"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","file":"browser.js","sourcesContent":["/**\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ı (`sbr_pub_…`) kullanır ve\n * güvenliği gizlilikten değil kısıttan gelir — yalnız izinli alan adlarından\n * ve yalnız izin verilen kanallara yazabilir.\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 */\nexport type Level = 'debug' | 'info' | 'warn' | 'error' | 'critical';\n\nexport interface BrowserConfig {\n  /** Açık anahtar (`sbr_pub_…`). 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  channel: string;\n  message: string;\n  level?: Level;\n  context?: Record<string, unknown>;\n  source?: string;\n}\n\nconst DEFAULT_BASE_URL = 'https://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('sbr_pub_')) {\n      throw new Error(\n        'Signalbird: tarayıcı istemcisi açık anahtar ister (sbr_pub_…). ' +\n          'Gizli anahtarı (sbr_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(channel: string, message: string, level?: Level, context?: Record<string, unknown>): void {\n    this.queue.push({ channel, 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(channel: string, message: string, context?: Record<string, unknown>) {\n    this.log(channel, message, 'info', context);\n  }\n\n  warn(channel: string, message: string, context?: Record<string, unknown>) {\n    this.log(channel, message, 'warn', context);\n  }\n\n  error(channel: string, message: string, context?: Record<string, unknown>) {\n    this.log(channel, message, 'error', context);\n  }\n\n  /**\n   * Tarayıcıdaki yakalanmamış hataları bağlar.\n   *\n   * Kritik kanala YAZMAZ: istemci tarafı kod herkesin elindedir, oradan\n   * kritik alarm tetiklemek kötü niyetli birine ekibin telefonunu çaldırma\n   * imkânı verirdi. Sunucu zaten `browser_channels` ile bunu kısıtlar.\n   */\n  captureErrors(channel = 'browser'): () => void {\n    const onError = (event: ErrorEvent) => {\n      this.error(channel, 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(channel, 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      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        },\n        body: JSON.stringify({ events: batch }),\n        keepalive: true,\n      });\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 sorgu dizesinden gider.\n    navigator.sendBeacon?.(\n      `${this.baseUrl}/v1/radio/log/batch?key=${encodeURIComponent(this.config.publicKey)}`,\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

@@ -0,0 +1,109 @@
+// src/browser/index.ts
+var DEFAULT_BASE_URL = "https://signalbird.io/api";
+var SignalbirdBrowser = class {
+  constructor(config) {
+    this.config = config;
+    this.queue = [];
+    this.timer = null;
+    if (!config.publicKey?.startsWith("sbr_pub_")) {
+      throw new Error(
+        "Signalbird: taray\u0131c\u0131 istemcisi a\xE7\u0131k anahtar ister (sbr_pub_\u2026). Gizli anahtar\u0131 (sbr_live_\u2026) istemci koduna KOYMAYIN."
+      );
+    }
+    this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, "");
+    this.maxQueue = config.maxQueue ?? 50;
+    if (typeof window !== "undefined") {
+      this.timer = setInterval(() => void this.flush(), config.flushIntervalMs ?? 3e3);
+      window.addEventListener("pagehide", () => this.flushBeacon());
+    }
+  }
+  log(channel, message, level, context) {
+    this.queue.push({ channel, message, level, context, source: this.config.source });
+    if (this.queue.length >= this.maxQueue) {
+      void this.flush();
+    }
+  }
+  info(channel, message, context) {
+    this.log(channel, message, "info", context);
+  }
+  warn(channel, message, context) {
+    this.log(channel, message, "warn", context);
+  }
+  error(channel, message, context) {
+    this.log(channel, message, "error", context);
+  }
+  /**
+   * Tarayıcıdaki yakalanmamış hataları bağlar.
+   *
+   * Kritik kanala YAZMAZ: istemci tarafı kod herkesin elindedir, oradan
+   * kritik alarm tetiklemek kötü niyetli birine ekibin telefonunu çaldırma
+   * imkânı verirdi. Sunucu zaten `browser_channels` ile bunu kısıtlar.
+   */
+  captureErrors(channel = "browser") {
+    const onError = (event) => {
+      this.error(channel, event.message, {
+        file: event.filename,
+        line: event.lineno,
+        column: event.colno,
+        url: window.location.href
+      });
+    };
+    const onRejection = (event) => {
+      this.error(channel, String(event.reason), { url: window.location.href });
+    };
+    window.addEventListener("error", onError);
+    window.addEventListener("unhandledrejection", onRejection);
+    return () => {
+      window.removeEventListener("error", onError);
+      window.removeEventListener("unhandledrejection", onRejection);
+    };
+  }
+  async flush() {
+    if (this.queue.length === 0) return;
+    const batch = this.queue.splice(0, 100);
+    try {
+      await fetch(`${this.baseUrl}/v1/radio/log/batch`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "X-Signalbird-Key": this.config.publicKey
+        },
+        body: JSON.stringify({ events: batch }),
+        keepalive: true
+      });
+    } catch (error) {
+      if (this.config.debug) {
+        console.warn("[signalbird] g\xF6nderilemedi", error);
+      }
+      this.queue = [...batch, ...this.queue].slice(0, this.maxQueue);
+    }
+  }
+  /** Sayfa kapanırken son gönderim. */
+  flushBeacon() {
+    if (this.queue.length === 0 || typeof navigator === "undefined") return;
+    const blob = new Blob(
+      [JSON.stringify({ events: this.queue.splice(0, 100) })],
+      { type: "application/json" }
+    );
+    navigator.sendBeacon?.(
+      `${this.baseUrl}/v1/radio/log/batch?key=${encodeURIComponent(this.config.publicKey)}`,
+      blob
+    );
+  }
+  destroy() {
+    if (this.timer) clearInterval(this.timer);
+    void this.flush();
+  }
+};
+var singleton = null;
+function initSignalbird(config) {
+  singleton = new SignalbirdBrowser(config);
+  return singleton;
+}
+function signalbird() {
+  return singleton;
+}
+
+export { SignalbirdBrowser, initSignalbird, signalbird };
+//# sourceMappingURL=browser.mjs.map
+//# sourceMappingURL=browser.mjs.map

package/dist/browser.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/browser/index.ts"],"names":[],"mappings":"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","file":"browser.mjs","sourcesContent":["/**\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ı (`sbr_pub_…`) kullanır ve\n * güvenliği gizlilikten değil kısıttan gelir — yalnız izinli alan adlarından\n * ve yalnız izin verilen kanallara yazabilir.\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 */\nexport type Level = 'debug' | 'info' | 'warn' | 'error' | 'critical';\n\nexport interface BrowserConfig {\n  /** Açık anahtar (`sbr_pub_…`). 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  channel: string;\n  message: string;\n  level?: Level;\n  context?: Record<string, unknown>;\n  source?: string;\n}\n\nconst DEFAULT_BASE_URL = 'https://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('sbr_pub_')) {\n      throw new Error(\n        'Signalbird: tarayıcı istemcisi açık anahtar ister (sbr_pub_…). ' +\n          'Gizli anahtarı (sbr_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(channel: string, message: string, level?: Level, context?: Record<string, unknown>): void {\n    this.queue.push({ channel, 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(channel: string, message: string, context?: Record<string, unknown>) {\n    this.log(channel, message, 'info', context);\n  }\n\n  warn(channel: string, message: string, context?: Record<string, unknown>) {\n    this.log(channel, message, 'warn', context);\n  }\n\n  error(channel: string, message: string, context?: Record<string, unknown>) {\n    this.log(channel, message, 'error', context);\n  }\n\n  /**\n   * Tarayıcıdaki yakalanmamış hataları bağlar.\n   *\n   * Kritik kanala YAZMAZ: istemci tarafı kod herkesin elindedir, oradan\n   * kritik alarm tetiklemek kötü niyetli birine ekibin telefonunu çaldırma\n   * imkânı verirdi. Sunucu zaten `browser_channels` ile bunu kısıtlar.\n   */\n  captureErrors(channel = 'browser'): () => void {\n    const onError = (event: ErrorEvent) => {\n      this.error(channel, 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(channel, 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      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        },\n        body: JSON.stringify({ events: batch }),\n        keepalive: true,\n      });\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 sorgu dizesinden gider.\n    navigator.sendBeacon?.(\n      `${this.baseUrl}/v1/radio/log/batch?key=${encodeURIComponent(this.config.publicKey)}`,\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"]}