Embed widget — changelog

Verzionovanie pomocou query parametra: <script src="https://score.zulien.sk/embed.js?v=1.2.0">. Bez parametra widget tracuje latest. Pre produkčné integrácie odporúčame pinovať verziu, aby boli aktualizácie predvídateľné.

v1.2.0 — 2026-04-25 FEAT

• Verzionovaný URL pattern ?v=1.2.0 + dokumentácia na partners.html a embed-demo.
• EMBED_VERSION konštanta v zdrojáku, exposed cez window.ZulienScore.version (predtým hardcoded "1.1.0").
• Žiadne breaking changes — DOM API, CSS, fetch volania zostávajú identické s 1.1.x.

v1.1.0 — 2026-04-24 FEAT

• Programmatic API pre React/Vue/Svelte: window.ZulienScore.render(el, {domain}) vracia Promise s scan dátami.
• window.ZulienScore.mountAll() pre re-mount po dynamických DOM zmenách (SPA navigation).
• Fallback CTA keď scan ešte neexistuje (predtým widget tichý-fail bol nepoužiteľný).

v1.0.0 — 2026-04-24

• Initial release — Shadow DOM, ~9 KB gzip, deklaratívny data-zulien-score + data-domain API.
• Light + dark mode auto-detect cez prefers-color-scheme.
• Public Supabase REST fetch (anon key embedded — read-only access).

Migration policy

• Patch (1.2.x) — bug fixes, žiadne API zmeny. Bezpečné automaticky upgradnúť.
• Minor (1.x.0) — nové features, backwards-compatible. Upgradovateľné bez zmeny kódu.
• Major (x.0.0) — breaking changes (zmena API, render output, CSS). Predošlá verzia ostane dostupná na pôvodnom URL pattern.
• Pred breaking changes pošleme partnerom upozornenie minimum 30 dní vopred (cez kontakt v info@inger.sk).

Best practices pre partnerov

• Produkcia: pin špecifickú verziu — ?v=1.2.0 — a sledujte changelog pred upgrade.
• Staging: bez ?v parametra (track latest) na zachytenie regresií skôr.
• SPA: volajte window.ZulienScore.mountAll() po route change.
• SSR/Next.js: renderujte cez useEffect + render(ref.current, {domain}) — vyhnete sa hydration mismatch.