Adding the widget to your website

breezaro('open');

<script>
const BREEZARO_APP_ID = 'YOUR_APP_ID';

function breezaroResetGeneration() {
  try {
    const reset = JSON.parse(
      localStorage.getItem('breezaro-widget_reset_' + BREEZARO_APP_ID),
    );

    if (typeof reset?.id !== 'string' || !reset.id) {
      return { resetId: null, resetAt: null };
    }

    return {
      resetId: reset.id,
      resetAt: Number.isFinite(reset.at) ? reset.at : null,
    };
  } catch {
    return { resetId: null, resetAt: null };
  }
}

  window.breezaro =
    window.breezaro ||
    function () {
      (window.breezaro.q = window.breezaro.q || []).push(arguments);
    };
  breezaro('open');

  // Queue 'identify' only WITH the current reset generation. An untagged queued
  // identify is refused once this browser has ever signed out, because
  // nothing bounds when it was pushed.
  breezaro('identify', identity, undefined, breezaroResetGeneration());
</script>

// 1. Relativní posun nahoru při zobrazení cookie lišty (např. výška 80px):
breezaro('setPosition', { y: 80 });

// 2. Návrat na výchozí pozici po zavření cookie lišty:
breezaro('setPosition', { x: 0, y: 0 });

// 3. Alternativně můžete použít i přímé nastavení rohové pozice nebo absolutního odsazení:
breezaro('setPosition', {
  position: 'bottom-left', // 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left'
  offsetX: 24,
  offsetY: 80,
});

// 4. Kompletní reset všech dynamických přepisů do původního stavu z administrace:
breezaro('resetPosition');

const BREEZARO_APP_ID = 'YOUR_APP_ID';

function breezaroResetGeneration() {
  try {
    const reset = JSON.parse(
      localStorage.getItem('breezaro-widget_reset_' + BREEZARO_APP_ID),
    );

    if (typeof reset?.id !== 'string' || !reset.id) {
      return { resetId: null, resetAt: null };
    }

    return {
      resetId: reset.id,
      resetAt: Number.isFinite(reset.at) ? reset.at : null,
    };
  } catch {
    return { resetId: null, resetAt: null };
  }
}

async function onContextResult(snapshot, result, mayRetry) {
  if (result?.ok) return;

  if (
    !mayRetry ||
    result?.reason !== 'reset' ||
    typeof result.resetId !== 'string' ||
    (!Number.isFinite(result.resetAt) && result.resetAt !== null)
  ) {
    console.warn('Breezaro setContext failed:', result?.reason);
    return;
  }

  const generation = { resetId: result.resetId, resetAt: result.resetAt };

  try {
    const clearsContext =
      snapshot === null ||
      (typeof snapshot === 'object' &&
        snapshot !== null &&
        !Array.isArray(snapshot) &&
        Object.keys(snapshot).length === 0);

    // A cart snapshot may belong to the pre-reset account. Fetch it again;
    // either documented clear shape carries no account data.
    const currentSnapshot = clearsContext
      ? null
      : await fetch('/my-api/cart').then((response) => response.json());

    applyCartContext(currentSnapshot, generation, false);
  } catch {
    console.warn('Breezaro cart refresh failed');
  }
}

function applyCartContext(snapshot, generation, mayRetry = true) {
  window.breezaro(
    'setContext',
    snapshot,
    (result) => void onContextResult(snapshot, result, mayRetry),
    generation ?? breezaroResetGeneration(),
  );
}

function clearCartContext() {
  applyCartContext(null);
}

const cartSnapshot = {
  version: 1,
  cart: {
    currency: 'CZK',
    subtotal: 1490,
    total: 1390,
    items: [
      {
        id: 'product-123',
        sku: 'WREATH-NATURAL',
        name: 'Natural wreath',
        variant: '40 cm',
        quantity: 1,
        unitPrice: 1390,
        url: 'https://shop.example.com/products/natural-wreath',
      },
    ],
  },
};

applyCartContext(cartSnapshot);

window.addEventListener('breezaro:conversation-changed', async (event) => {
  const { appId, resetId, resetAt } = event.detail ?? {};

  if (
    appId !== BREEZARO_APP_ID ||
    typeof resetId !== 'string' ||
    !Number.isFinite(resetAt)
  ) return;

  // Capture BOTH values before this round trip. A later reset may reuse its id,
  // and resetAt still makes the outdated snapshot fail closed.
  const resetGeneration = { resetId, resetAt };
  const snapshot = await fetch('/my-api/cart').then((response) =>
    response.json(),
  );

  applyCartContext(snapshot, resetGeneration);
});

const BREEZARO_APP_ID = 'YOUR_APP_ID';

function breezaroResetGeneration() {
  try {
    const reset = JSON.parse(
      localStorage.getItem('breezaro-widget_reset_' + BREEZARO_APP_ID),
    );

    if (typeof reset?.id !== 'string' || !reset.id) {
      return { resetId: null, resetAt: null };
    }

    return {
      resetId: reset.id,
      resetAt: Number.isFinite(reset.at) ? reset.at : null,
    };
  } catch {
    return { resetId: null, resetAt: null };
  }
}

document.addEventListener('visibilitychange', async () => {
  if (document.visibilityState !== 'visible') return;

  // Read the generation BEFORE the round trip, not after it.
  const resetGeneration = breezaroResetGeneration();

  // Your own endpoint: it signs a fresh payload server-side, where the
  // secret lives, and returns { email, name, externalId, issuedAt, nonce, hmac }.
  const identity = await fetch('/my-api/breezaro-identity').then((r) => r.json());

  breezaro('identify', identity, undefined, resetGeneration);
});

const BREEZARO_APP_ID = 'YOUR_APP_ID';

async function signOut() {
  // Ask the widget to reset, then sign out no matter what it answers: a blocked
  // or unmounted loader must never trap the user in a session they ended.
  const resetResult = await new Promise((resolve) => {
    const done = setTimeout(() => resolve(null), 500);
    const finish = (result) => {
      clearTimeout(done);
      resolve(result);
    };

    // Missing or broken loaders enter the durable fallback immediately; the
    // timeout covers a mounted widget that never answers.
    if (typeof window.breezaro !== 'function') {
      finish(null);
      return;
    }

    try {
      window.breezaro('reset', undefined, finish);
    } catch (_) {
      finish(null);
    }
  });

  // A successful reset also returns resetId and resetAt for calls that continue
  // on this page. Sign-out navigates away, so only durable matters here.
  // If the widget could not confirm a durable reset (ad blocker, storage error,
  // never mounted), write the marker the loader reads on the next load so the
  // next visitor starts a clean conversation instead of restoring this one.
  if (!resetResult?.ok || !resetResult.durable) {
    try {
      localStorage.setItem(
        'breezaro-widget_reset_' + BREEZARO_APP_ID,
        JSON.stringify({ id: crypto.randomUUID(), at: Date.now() }),
      );
    } catch (_) {}
  }

  await fetch('/my-api/sign-out', { method: 'POST' });
  window.location.assign('/');
}