Documentation

<script>
(function (window, document) {
  if (window.SSA && window.SSA.__initialized) return;

  var STORAGE_KEY = '__ssa_queue__';
  var MAX_RETRIES = 3;
  var BATCH_SIZE = 5;
  var FLUSH_INTERVAL = 400;

  function uuid() {
    return 'xxxxxxxxxxxx4xxxyxxxxxxxxxxxxxxx'.replace(/[xy]/g, function (c) {
      var r = Math.random() * 16 | 0;
      var v = c === 'x' ? r : (r & 0x3 | 0x8);
      return v.toString(16);
    });
  }

  function safeParse(val, fallback) {
    try { return JSON.parse(val); } catch (e) { return fallback; }
  }

  var SSA = {
    __initialized: true,
    siteId: 'YOUR_SITE_ID', // From your dashboard
    endpoint: 'https://signalsyncads.vercel.app/api/track',
    consent: true,
    debug: false,
    queue: safeParse(localStorage.getItem(STORAGE_KEY), []),
    isSending: false,
    flushTimer: null,

    setConsent: function (value) { this.consent = !!value; },
    enableDebug: function () { this.debug = true; console.info('[SSA] Debug mode enabled'); },
    
    _persist: function () {
      try { localStorage.setItem(STORAGE_KEY, JSON.stringify(this.queue)); } catch (e) {}
    },

    track: function (eventName, data) {
      if (!this.consent || !eventName) return;
      var payload = {
        id: uuid(),
        siteId: this.siteId,
        event_name: eventName,
        timestamp: Date.now(),
        url: window.location.href,
        referrer: document.referrer || null,
        retries: 0,
        data: data || {}
      };
      this.queue.push(payload);
      this._persist();
      this._scheduleFlush();
    },

    _scheduleFlush: function () {
      if (this.flushTimer) return;
      var self = this;
      this.flushTimer = setTimeout(function () {
        self.flushTimer = null;
        self._flush();
      }, FLUSH_INTERVAL);
    },

    _sendBatch: function (batch, useBeacon) {
      var body = JSON.stringify(batch);
      if (useBeacon && navigator.sendBeacon) {
        var blob = new Blob([body], { type: 'application/json' });
        return navigator.sendBeacon(this.endpoint, blob);
      }
      return fetch(this.endpoint, {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        keepalive: true,
        body: body
      });
    },

    _flush: function (forceBeacon) {
      if (this.isSending || !this.queue.length) return;
      this.isSending = true;
      var batch = this.queue.slice(0, BATCH_SIZE);
      var self = this;
      var result = this._sendBatch(batch, forceBeacon);
      function success() { self.queue.splice(0, batch.length); self._persist(); }
      function failure() {
        for (var i = 0; i < batch.length; i++) batch[i].retries++;
        self.queue = batch.concat(self.queue.slice(batch.length))
          .filter(function (e) { return e.retries <= MAX_RETRIES; });
        self._persist();
      }
      if (result === true) { success(); self.isSending = false; return; }
      Promise.resolve(result).then(success).catch(failure).finally(function () {
        self.isSending = false;
        if (self.queue.length) self._scheduleFlush();
      });
    }
  };

  window.SSA = SSA;
  window.addEventListener('visibilitychange', function () {
    if (document.visibilityState === 'hidden') SSA._flush(true);
  });
  window.addEventListener('beforeunload', function () { SSA._flush(true); });
  if (SSA.queue.length) SSA._scheduleFlush();
})(window, document);
</script>

<!-- Example: Track a conversion -->
<script>
  SSA.track('Purchase', { value: 99.99, currency: 'USD' });
</script>