@zerocost/sdk 0.14.0 → 0.16.0

package/dist/core/config.d.ts

@@ -1,2 +1,3 @@
 export declare const EDGE_FUNCTION_BASE = "https://mwbgzpbuoojqsuxduieo.supabase.co/functions/v1";
+export { ZEROCOST_BASE_URL } from './constants';
 export declare function getBaseUrl(custom?: string): string;

package/dist/core/consent-ui.d.ts

@@ -1,12 +1,3 @@
-/**
- * consent-ui.ts — Pure DOM consent popup for the Zerocost SDK.
- *
- * - Desktop: centered card modal (max 480px)
- * - Mobile (≤640px): bottom-sheet modal
- * - Themes: light / dark / auto
- * - Non-dismissable (no Escape, no backdrop click)
- * - Returns a Promise that resolves with the user's toggle selections
- */
 export interface ConsentUIOptions {
     appName: string;
     theme: 'light' | 'dark' | 'auto';

package/dist/core/consent.d.ts

@@ -34,4 +34,6 @@ export declare class ConsentManager {
     private getOrCreateUserId;
     private generateUUID;
     private submitToServer;
+    private injectSettingsButton;
+    private removeSettingsButton;
 }

package/dist/core/constants.d.ts

@@ -0,0 +1,4 @@
+export declare const ZEROCOST_DOMAINS: {
+    MAIN: string;
+};
+export declare const ZEROCOST_BASE_URL: string;

package/dist/index.cjs

@@ -28,6 +28,14 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
+// src/core/constants.ts
+var ZEROCOST_DOMAINS = {
+  MAIN: "https://zerocost.lovable.app"
+  //APP: 'https://app.zerocost.com',
+  //DOCS: 'https://docs.zerocost.com',
+};
+var ZEROCOST_BASE_URL = ZEROCOST_DOMAINS.MAIN;
+
 // src/core/config.ts
 var EDGE_FUNCTION_BASE = "https://mwbgzpbuoojqsuxduieo.supabase.co/functions/v1";
 function getBaseUrl(custom) {
@@ -70,7 +78,7 @@ var ZerocostClient = class {
       ...body || {},
       app_id: this.config.appId
     };
-    this.log(`\u2192 ${url}`, payload);
+    this.log(`\u2192 ${path}`, payload);
     const res = await fetch(url, {
       method: "POST",
       headers: {
@@ -89,7 +97,8 @@ var ZerocostClient = class {
   }
   log(message, data) {
     if (this.config.debug) {
-      console.log(`[Zerocost] ${message}`, data ?? "");
+      const sanitizedMessage = typeof message === "string" ? message.replace(/https:\/\/[a-z0-9.-]+\.supabase\.co/gi, "[INFRA]") : message;
+      console.log(`[Zerocost] ${sanitizedMessage}`, data ?? "");
     }
   }
 };
@@ -141,6 +150,12 @@ var TrackModule = class {
 
 // src/core/widget-render.ts
 var SDK_WIDGET_REFRESH_MS = 2e4;
+var CLOSE_ICON_SVG = `
+  <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round" style="width:100%;height:100%;">
+    <line x1="18" y1="6" x2="6" y2="18"></line>
+    <line x1="6" y1="6" x2="18" y2="18"></line>
+  </svg>
+`;
 function escapeHtml(value) {
   return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
 }
@@ -194,7 +209,7 @@ function renderVideoWidget(ad, theme) {
     <div style="position:relative;width:200px;aspect-ratio:9/16;border-radius:16px;overflow:hidden;background:${palette.bg};border:1px solid rgba(255,255,255,0.12);box-shadow:0 20px 60px rgba(0,0,0,0.45);font-family:Space Grotesk,system-ui,sans-serif;">
       ${media}
       <div style="position:absolute;top:10px;right:10px;display:flex;gap:8px;z-index:3;">
-        <button type="button" data-zc-close style="width:22px;height:22px;border:none;border-radius:999px;background:rgba(0,0,0,0.52);color:#fff;font-size:12px;cursor:pointer;">x</button>
+        <button type="button" data-zc-close style="width:24px;height:24px;padding:5px;border:none;border-radius:999px;background:rgba(0,0,0,0.52);color:#fff;cursor:pointer;display:flex;align-items:center;justify-content:center;">${CLOSE_ICON_SVG}</button>
       </div>
       <div style="position:absolute;inset:0;background:linear-gradient(180deg,rgba(0,0,0,0.04) 0%,rgba(0,0,0,0.12) 35%,rgba(0,0,0,0.85) 100%);"></div>
       <div style="position:absolute;left:0;right:0;bottom:0;padding:14px;z-index:2;">
@@ -215,7 +230,7 @@ function renderTooltipWidget(ad, theme) {
           <span style="width:6px;height:6px;border-radius:999px;background:${palette.text};display:inline-block;"></span>
           Sponsored
         </div>
-        <button type="button" data-zc-close style="background:none;border:none;color:${palette.textFaint};font-size:12px;cursor:pointer;padding:0;">x</button>
+        <button type="button" data-zc-close style="background:none;border:none;color:${palette.textFaint};width:16px;height:16px;cursor:pointer;padding:0;display:flex;align-items:center;justify-content:center;">${CLOSE_ICON_SVG}</button>
       </div>
       <div style="margin-top:10px;color:${palette.text};font-size:13px;line-height:1.55;">
         ${escapeHtml(ad.description || ad.title)} <a href="${escapeHtml(ad.landing_url)}" target="_blank" rel="noreferrer noopener" data-zc-cta style="color:${palette.text};font-weight:700;text-decoration:underline;text-underline-offset:2px;">${escapeHtml(ad.cta_text || "Learn More")}</a>
@@ -232,7 +247,7 @@ function renderSponsoredCard(ad, theme) {
       <div style="padding:12px;">
         <div style="display:flex;align-items:center;justify-content:space-between;gap:8px;">
           <div style="display:inline-flex;align-items:center;padding:4px 6px;border-radius:999px;background:${palette.badgeBg};color:${palette.textFaint};font-size:9px;font-weight:700;letter-spacing:0.12em;text-transform:uppercase;">Sponsored</div>
-          <button type="button" data-zc-close style="background:none;border:none;color:${palette.textFaint};font-size:12px;cursor:pointer;padding:0;">x</button>
+          <button type="button" data-zc-close style="background:none;border:none;color:${palette.textFaint};width:16px;height:16px;cursor:pointer;padding:0;display:flex;align-items:center;justify-content:center;">${CLOSE_ICON_SVG}</button>
         </div>
         <div style="margin-top:10px;color:${palette.text};font-size:13px;font-weight:700;line-height:1.2;">${escapeHtml(ad.title)}</div>
         ${ad.description ? `<div style="margin-top:6px;color:${palette.textMuted};font-size:11px;line-height:1.35;">${escapeHtml(ad.description)}</div>` : ""}
@@ -248,7 +263,7 @@ function renderInlineText(ad, theme) {
     <div style="margin:10px 0;border-radius:14px;overflow:hidden;background:${palette.surface};border:1px solid ${palette.border};font-family:Space Grotesk,system-ui,sans-serif;">
       <div style="display:flex;align-items:center;justify-content:space-between;padding:9px 12px;border-bottom:1px solid ${palette.border};background:${palette.surfaceStrong};">
         <span style="color:${palette.textFaint};font-size:9px;font-weight:700;letter-spacing:0.12em;text-transform:uppercase;">Sponsored</span>
-        <button type="button" data-zc-close style="background:none;border:none;color:${palette.textFaint};font-size:12px;cursor:pointer;padding:0;">x</button>
+        <button type="button" data-zc-close style="background:none;border:none;color:${palette.textFaint};width:16px;height:16px;cursor:pointer;padding:0;display:flex;align-items:center;justify-content:center;">${CLOSE_ICON_SVG}</button>
       </div>
       <div style="padding:12px;display:flex;gap:10px;align-items:flex-start;">
         ${media}
@@ -277,15 +292,15 @@ function renderWidgetMarkup(ad, options) {
 
 // src/modules/widget.ts
 var POSITION_STYLES = {
-  "bottom-right": "position:fixed;bottom:24px;right:24px;z-index:9999;",
+  "bottom-right": "position:fixed;bottom:24px;right:40px;z-index:9999;",
   "bottom-left": "position:fixed;bottom:24px;left:80px;z-index:9999;",
-  "top-right": "position:fixed;top:24px;right:24px;z-index:9999;",
+  "top-right": "position:fixed;top:24px;right:40px;z-index:9999;",
   "top-left": "position:fixed;top:24px;left:24px;z-index:9999;",
   "bottom-center": "position:fixed;bottom:24px;left:50%;transform:translateX(-50%);z-index:9999;",
   "top-center": "position:fixed;top:24px;left:50%;transform:translateX(-50%);z-index:9999;",
   "center": "position:fixed;top:50%;left:50%;transform:translate(-50%,-50%);z-index:9999;",
   "sidebar-left": "position:fixed;top:50%;left:24px;transform:translateY(-50%);z-index:9999;",
-  "sidebar-right": "position:fixed;top:50%;right:24px;transform:translateY(-50%);z-index:9999;"
+  "sidebar-right": "position:fixed;top:50%;right:40px;transform:translateY(-50%);z-index:9999;"
 };
 var FORMAT_PRIORITY = ["video-widget", "tooltip-ad", "sponsored-card", "sidebar-display", "inline-text"];
 var AUTO_SLOT_ID = "zerocost-auto-slot";
@@ -1589,6 +1604,44 @@ function injectStyles(theme) {
     .zc-consent-confirm:active {
       opacity: 0.75;
     }
+
+    /* Floating settings button */
+    .zc-settings-btn {
+      position: fixed;
+      width: 44px;
+      height: 44px;
+      border-radius: 50%;
+      background: var(--zc-bg);
+      border: 1px solid var(--zc-border);
+      color: var(--zc-text);
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      cursor: pointer;
+      z-index: 999998;
+      box-shadow: 0 4px 12px rgba(0,0,0,0.15);
+      transition: transform 200ms, border-color 200ms;
+    }
+
+    .zc-settings-btn:hover {
+      transform: scale(1.05);
+      border-color: var(--zc-text-secondary);
+    }
+
+    .zc-settings-btn svg {
+      width: 20px;
+      height: 20px;
+    }
+
+    .zc-settings-bottom-left { bottom: 20px; left: 20px; }
+    .zc-settings-bottom-right { bottom: 20px; right: 20px; }
+    .zc-settings-top-left { top: 20px; left: 20px; }
+    .zc-settings-top-right { top: 20px; right: 20px; }
+
+    @media (max-width: 640px) {
+      .zc-settings-btn { width: 40px; height: 40px; }
+      .zc-settings-bottom-left, .zc-settings-bottom-right { bottom: 16px; }
+    }
   `;
   const style = document.createElement("style");
   style.id = STYLE_ID;
@@ -1671,33 +1724,33 @@ function showConsentUI(options) {
     card.appendChild(subtitle);
     const toggles = document.createElement("div");
     toggles.className = "zc-consent-toggles";
-    const baseUrl = typeof window !== "undefined" ? window.location.origin : "";
+    const zerocostBaseUrl = ZEROCOST_BASE_URL;
     toggles.appendChild(createToggleCard(
       "zc-toggle-ads",
       "Ads",
       "Contextual, non-intrusive ads. No cookies or browsing history used.",
-      `${baseUrl}/consent/ads`,
+      `${zerocostBaseUrl}/docs/ads`,
       defaults.ads
     ));
     toggles.appendChild(createToggleCard(
       "zc-toggle-usage",
       "Usage data",
       "Anonymized usage patterns. No personal information is shared.",
-      `${baseUrl}/consent/usage-data`,
+      `${zerocostBaseUrl}/docs/usage-data`,
       defaults.usageData
     ));
     toggles.appendChild(createToggleCard(
       "zc-toggle-ai",
       "AI interactions",
       "Anonymized conversation data used for AI research.",
-      `${baseUrl}/consent/ai-interactions`,
+      `${zerocostBaseUrl}/docs/ai-interactions`,
       defaults.aiInteractions
     ));
     card.appendChild(toggles);
     const footer = document.createElement("div");
     footer.className = "zc-consent-footer";
     const ppLink = document.createElement("a");
-    ppLink.href = privacyPolicyUrl || `${baseUrl}/privacy`;
+    ppLink.href = privacyPolicyUrl || `${zerocostBaseUrl}/docs/privacy`;
     ppLink.target = "_blank";
     ppLink.rel = "noopener noreferrer";
     ppLink.textContent = "Privacy Policy";
@@ -1707,7 +1760,7 @@ function showConsentUI(options) {
     sep1.textContent = "\xB7";
     footer.appendChild(sep1);
     const termsLink = document.createElement("a");
-    termsLink.href = `${baseUrl}/terms`;
+    termsLink.href = `${zerocostBaseUrl}/docs/terms`;
     termsLink.target = "_blank";
     termsLink.rel = "noopener noreferrer";
     termsLink.textContent = "Terms";
@@ -1717,7 +1770,7 @@ function showConsentUI(options) {
     sep2.textContent = "\xB7";
     footer.appendChild(sep2);
     const dnsLink = document.createElement("a");
-    dnsLink.href = `${baseUrl}/do-not-sell`;
+    dnsLink.href = `${zerocostBaseUrl}/docs/do-not-sell`;
     dnsLink.target = "_blank";
     dnsLink.rel = "noopener noreferrer";
     dnsLink.textContent = "Do Not Sell My Data";
@@ -1761,6 +1814,9 @@ var ConsentManager = class {
     this.appName = opts.appName ?? "";
     this.theme = opts.theme ?? "dark";
     this.hydrateFromStorage();
+    if (this.consentConfig.showSettingsButton) {
+      this.injectSettingsButton();
+    }
   }
   // ── Public API (per spec §6.3) ───────────────────────────────────
   /** Returns the current consent record, or null if none exists. */
@@ -1826,6 +1882,9 @@ var ConsentManager = class {
     };
     this.record = record;
     this.writeStorage(record);
+    if (this.consentConfig.showSettingsButton) {
+      this.injectSettingsButton();
+    }
     if (this.consentConfig.onConsentChange) {
       try {
         this.consentConfig.onConsentChange(record);
@@ -1904,6 +1963,23 @@ var ConsentManager = class {
       this.client.log(`Failed to submit consent to server: ${err}`);
     }
   }
+  injectSettingsButton() {
+    if (typeof document === "undefined") return;
+    const existing = document.getElementById("zerocost-privacy-settings-btn");
+    if (existing) return;
+    const btn = document.createElement("button");
+    btn.id = "zerocost-privacy-settings-btn";
+    btn.setAttribute("aria-label", "Privacy Settings");
+    btn.title = "Privacy Settings";
+    const pos = this.consentConfig.buttonPosition || "bottom-left";
+    btn.className = `zc-settings-btn zc-settings-${pos}`;
+    btn.innerHTML = `<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M12 22s8-4 8-10V5l-8-3-8 3v7c0 6 8 10 8 10z"/></svg>`;
+    btn.addEventListener("click", () => this.open());
+    document.body.appendChild(btn);
+  }
+  removeSettingsButton() {
+    document.getElementById("zerocost-privacy-settings-btn")?.remove();
+  }
 };
 
 // src/index.ts
@@ -1937,21 +2013,15 @@ var ZerocostSDK = class {
     });
   }
   async init() {
-    this.core.init();
     if (typeof document === "undefined") {
-      this.core.log("Running in non-browser environment; skipping DOM injection.");
       return;
     }
     if (window !== window.top) {
-      this.core.log("Running inside an iframe. Ads render if permissions allow.");
     }
-    this.core.log("Initializing Zerocost SDK.");
     if (this.consent.shouldPrompt()) {
-      this.core.log("Consent required \u2014 showing prompt.");
       await this.consent.promptAndWait();
     }
     if (!this.consent.has("ads")) {
-      this.core.log("Ads consent not granted \u2014 skipping ad injection.");
       return;
     }
     const cachedConfig = this.readCachedConfig();
@@ -1959,12 +2029,11 @@ var ZerocostSDK = class {
       this.lastConfigHash = this.configToHash(cachedConfig);
       this.syncDataCollection(cachedConfig.dataCollection);
       await this.widget.autoInjectWithConfig(cachedConfig.display, cachedConfig.widget);
-      this.core.log("Applied cached config immediately.");
     }
     this.startConfigSync();
     try {
       await this.refreshConfig({ force: true, reason: "init" });
-      this.core.log("SDK fully initialized. Ads are rendering automatically.");
+      this.core.log(`Zerocost SDK initialized (${this.core.getConfig().appId})`);
     } catch (err) {
       this.core.log(`Init error: ${err}. Attempting fallback ad injection.`);
       await this.widget.autoInject();
@@ -2138,6 +2207,10 @@ var ZerocostSDK = class {
       return { valid: false, error: err.message };
     }
   }
+  /** Open the consent/privacy settings popup. */
+  async showSettings() {
+    return this.consent.open();
+  }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/index.d.ts

@@ -39,6 +39,8 @@ export declare class ZerocostSDK {
         valid: boolean;
         error?: string;
     }>;
+    /** Open the consent/privacy settings popup. */
+    showSettings(): Promise<void>;
 }
 export * from './types';
 export { ZerocostClient } from './core/client';

package/dist/index.js

@@ -1,3 +1,11 @@
+// src/core/constants.ts
+var ZEROCOST_DOMAINS = {
+  MAIN: "https://zerocost.lovable.app"
+  //APP: 'https://app.zerocost.com',
+  //DOCS: 'https://docs.zerocost.com',
+};
+var ZEROCOST_BASE_URL = ZEROCOST_DOMAINS.MAIN;
+
 // src/core/config.ts
 var EDGE_FUNCTION_BASE = "https://mwbgzpbuoojqsuxduieo.supabase.co/functions/v1";
 function getBaseUrl(custom) {
@@ -40,7 +48,7 @@ var ZerocostClient = class {
       ...body || {},
       app_id: this.config.appId
     };
-    this.log(`\u2192 ${url}`, payload);
+    this.log(`\u2192 ${path}`, payload);
     const res = await fetch(url, {
       method: "POST",
       headers: {
@@ -59,7 +67,8 @@ var ZerocostClient = class {
   }
   log(message, data) {
     if (this.config.debug) {
-      console.log(`[Zerocost] ${message}`, data ?? "");
+      const sanitizedMessage = typeof message === "string" ? message.replace(/https:\/\/[a-z0-9.-]+\.supabase\.co/gi, "[INFRA]") : message;
+      console.log(`[Zerocost] ${sanitizedMessage}`, data ?? "");
     }
   }
 };
@@ -111,6 +120,12 @@ var TrackModule = class {
 
 // src/core/widget-render.ts
 var SDK_WIDGET_REFRESH_MS = 2e4;
+var CLOSE_ICON_SVG = `
+  <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round" style="width:100%;height:100%;">
+    <line x1="18" y1="6" x2="6" y2="18"></line>
+    <line x1="6" y1="6" x2="18" y2="18"></line>
+  </svg>
+`;
 function escapeHtml(value) {
   return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
 }
@@ -164,7 +179,7 @@ function renderVideoWidget(ad, theme) {
     <div style="position:relative;width:200px;aspect-ratio:9/16;border-radius:16px;overflow:hidden;background:${palette.bg};border:1px solid rgba(255,255,255,0.12);box-shadow:0 20px 60px rgba(0,0,0,0.45);font-family:Space Grotesk,system-ui,sans-serif;">
       ${media}
       <div style="position:absolute;top:10px;right:10px;display:flex;gap:8px;z-index:3;">
-        <button type="button" data-zc-close style="width:22px;height:22px;border:none;border-radius:999px;background:rgba(0,0,0,0.52);color:#fff;font-size:12px;cursor:pointer;">x</button>
+        <button type="button" data-zc-close style="width:24px;height:24px;padding:5px;border:none;border-radius:999px;background:rgba(0,0,0,0.52);color:#fff;cursor:pointer;display:flex;align-items:center;justify-content:center;">${CLOSE_ICON_SVG}</button>
       </div>
       <div style="position:absolute;inset:0;background:linear-gradient(180deg,rgba(0,0,0,0.04) 0%,rgba(0,0,0,0.12) 35%,rgba(0,0,0,0.85) 100%);"></div>
       <div style="position:absolute;left:0;right:0;bottom:0;padding:14px;z-index:2;">
@@ -185,7 +200,7 @@ function renderTooltipWidget(ad, theme) {
           <span style="width:6px;height:6px;border-radius:999px;background:${palette.text};display:inline-block;"></span>
           Sponsored
         </div>
-        <button type="button" data-zc-close style="background:none;border:none;color:${palette.textFaint};font-size:12px;cursor:pointer;padding:0;">x</button>
+        <button type="button" data-zc-close style="background:none;border:none;color:${palette.textFaint};width:16px;height:16px;cursor:pointer;padding:0;display:flex;align-items:center;justify-content:center;">${CLOSE_ICON_SVG}</button>
       </div>
       <div style="margin-top:10px;color:${palette.text};font-size:13px;line-height:1.55;">
         ${escapeHtml(ad.description || ad.title)} <a href="${escapeHtml(ad.landing_url)}" target="_blank" rel="noreferrer noopener" data-zc-cta style="color:${palette.text};font-weight:700;text-decoration:underline;text-underline-offset:2px;">${escapeHtml(ad.cta_text || "Learn More")}</a>
@@ -202,7 +217,7 @@ function renderSponsoredCard(ad, theme) {
       <div style="padding:12px;">
         <div style="display:flex;align-items:center;justify-content:space-between;gap:8px;">
           <div style="display:inline-flex;align-items:center;padding:4px 6px;border-radius:999px;background:${palette.badgeBg};color:${palette.textFaint};font-size:9px;font-weight:700;letter-spacing:0.12em;text-transform:uppercase;">Sponsored</div>
-          <button type="button" data-zc-close style="background:none;border:none;color:${palette.textFaint};font-size:12px;cursor:pointer;padding:0;">x</button>
+          <button type="button" data-zc-close style="background:none;border:none;color:${palette.textFaint};width:16px;height:16px;cursor:pointer;padding:0;display:flex;align-items:center;justify-content:center;">${CLOSE_ICON_SVG}</button>
         </div>
         <div style="margin-top:10px;color:${palette.text};font-size:13px;font-weight:700;line-height:1.2;">${escapeHtml(ad.title)}</div>
         ${ad.description ? `<div style="margin-top:6px;color:${palette.textMuted};font-size:11px;line-height:1.35;">${escapeHtml(ad.description)}</div>` : ""}
@@ -218,7 +233,7 @@ function renderInlineText(ad, theme) {
     <div style="margin:10px 0;border-radius:14px;overflow:hidden;background:${palette.surface};border:1px solid ${palette.border};font-family:Space Grotesk,system-ui,sans-serif;">
       <div style="display:flex;align-items:center;justify-content:space-between;padding:9px 12px;border-bottom:1px solid ${palette.border};background:${palette.surfaceStrong};">
         <span style="color:${palette.textFaint};font-size:9px;font-weight:700;letter-spacing:0.12em;text-transform:uppercase;">Sponsored</span>
-        <button type="button" data-zc-close style="background:none;border:none;color:${palette.textFaint};font-size:12px;cursor:pointer;padding:0;">x</button>
+        <button type="button" data-zc-close style="background:none;border:none;color:${palette.textFaint};width:16px;height:16px;cursor:pointer;padding:0;display:flex;align-items:center;justify-content:center;">${CLOSE_ICON_SVG}</button>
       </div>
       <div style="padding:12px;display:flex;gap:10px;align-items:flex-start;">
         ${media}
@@ -247,15 +262,15 @@ function renderWidgetMarkup(ad, options) {
 
 // src/modules/widget.ts
 var POSITION_STYLES = {
-  "bottom-right": "position:fixed;bottom:24px;right:24px;z-index:9999;",
+  "bottom-right": "position:fixed;bottom:24px;right:40px;z-index:9999;",
   "bottom-left": "position:fixed;bottom:24px;left:80px;z-index:9999;",
-  "top-right": "position:fixed;top:24px;right:24px;z-index:9999;",
+  "top-right": "position:fixed;top:24px;right:40px;z-index:9999;",
   "top-left": "position:fixed;top:24px;left:24px;z-index:9999;",
   "bottom-center": "position:fixed;bottom:24px;left:50%;transform:translateX(-50%);z-index:9999;",
   "top-center": "position:fixed;top:24px;left:50%;transform:translateX(-50%);z-index:9999;",
   "center": "position:fixed;top:50%;left:50%;transform:translate(-50%,-50%);z-index:9999;",
   "sidebar-left": "position:fixed;top:50%;left:24px;transform:translateY(-50%);z-index:9999;",
-  "sidebar-right": "position:fixed;top:50%;right:24px;transform:translateY(-50%);z-index:9999;"
+  "sidebar-right": "position:fixed;top:50%;right:40px;transform:translateY(-50%);z-index:9999;"
 };
 var FORMAT_PRIORITY = ["video-widget", "tooltip-ad", "sponsored-card", "sidebar-display", "inline-text"];
 var AUTO_SLOT_ID = "zerocost-auto-slot";
@@ -1559,6 +1574,44 @@ function injectStyles(theme) {
     .zc-consent-confirm:active {
       opacity: 0.75;
     }
+
+    /* Floating settings button */
+    .zc-settings-btn {
+      position: fixed;
+      width: 44px;
+      height: 44px;
+      border-radius: 50%;
+      background: var(--zc-bg);
+      border: 1px solid var(--zc-border);
+      color: var(--zc-text);
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      cursor: pointer;
+      z-index: 999998;
+      box-shadow: 0 4px 12px rgba(0,0,0,0.15);
+      transition: transform 200ms, border-color 200ms;
+    }
+
+    .zc-settings-btn:hover {
+      transform: scale(1.05);
+      border-color: var(--zc-text-secondary);
+    }
+
+    .zc-settings-btn svg {
+      width: 20px;
+      height: 20px;
+    }
+
+    .zc-settings-bottom-left { bottom: 20px; left: 20px; }
+    .zc-settings-bottom-right { bottom: 20px; right: 20px; }
+    .zc-settings-top-left { top: 20px; left: 20px; }
+    .zc-settings-top-right { top: 20px; right: 20px; }
+
+    @media (max-width: 640px) {
+      .zc-settings-btn { width: 40px; height: 40px; }
+      .zc-settings-bottom-left, .zc-settings-bottom-right { bottom: 16px; }
+    }
   `;
   const style = document.createElement("style");
   style.id = STYLE_ID;
@@ -1641,33 +1694,33 @@ function showConsentUI(options) {
     card.appendChild(subtitle);
     const toggles = document.createElement("div");
     toggles.className = "zc-consent-toggles";
-    const baseUrl = typeof window !== "undefined" ? window.location.origin : "";
+    const zerocostBaseUrl = ZEROCOST_BASE_URL;
     toggles.appendChild(createToggleCard(
       "zc-toggle-ads",
       "Ads",
       "Contextual, non-intrusive ads. No cookies or browsing history used.",
-      `${baseUrl}/consent/ads`,
+      `${zerocostBaseUrl}/docs/ads`,
       defaults.ads
     ));
     toggles.appendChild(createToggleCard(
       "zc-toggle-usage",
       "Usage data",
       "Anonymized usage patterns. No personal information is shared.",
-      `${baseUrl}/consent/usage-data`,
+      `${zerocostBaseUrl}/docs/usage-data`,
       defaults.usageData
     ));
     toggles.appendChild(createToggleCard(
       "zc-toggle-ai",
       "AI interactions",
       "Anonymized conversation data used for AI research.",
-      `${baseUrl}/consent/ai-interactions`,
+      `${zerocostBaseUrl}/docs/ai-interactions`,
       defaults.aiInteractions
     ));
     card.appendChild(toggles);
     const footer = document.createElement("div");
     footer.className = "zc-consent-footer";
     const ppLink = document.createElement("a");
-    ppLink.href = privacyPolicyUrl || `${baseUrl}/privacy`;
+    ppLink.href = privacyPolicyUrl || `${zerocostBaseUrl}/docs/privacy`;
     ppLink.target = "_blank";
     ppLink.rel = "noopener noreferrer";
     ppLink.textContent = "Privacy Policy";
@@ -1677,7 +1730,7 @@ function showConsentUI(options) {
     sep1.textContent = "\xB7";
     footer.appendChild(sep1);
     const termsLink = document.createElement("a");
-    termsLink.href = `${baseUrl}/terms`;
+    termsLink.href = `${zerocostBaseUrl}/docs/terms`;
     termsLink.target = "_blank";
     termsLink.rel = "noopener noreferrer";
     termsLink.textContent = "Terms";
@@ -1687,7 +1740,7 @@ function showConsentUI(options) {
     sep2.textContent = "\xB7";
     footer.appendChild(sep2);
     const dnsLink = document.createElement("a");
-    dnsLink.href = `${baseUrl}/do-not-sell`;
+    dnsLink.href = `${zerocostBaseUrl}/docs/do-not-sell`;
     dnsLink.target = "_blank";
     dnsLink.rel = "noopener noreferrer";
     dnsLink.textContent = "Do Not Sell My Data";
@@ -1731,6 +1784,9 @@ var ConsentManager = class {
     this.appName = opts.appName ?? "";
     this.theme = opts.theme ?? "dark";
     this.hydrateFromStorage();
+    if (this.consentConfig.showSettingsButton) {
+      this.injectSettingsButton();
+    }
   }
   // ── Public API (per spec §6.3) ───────────────────────────────────
   /** Returns the current consent record, or null if none exists. */
@@ -1796,6 +1852,9 @@ var ConsentManager = class {
     };
     this.record = record;
     this.writeStorage(record);
+    if (this.consentConfig.showSettingsButton) {
+      this.injectSettingsButton();
+    }
     if (this.consentConfig.onConsentChange) {
       try {
         this.consentConfig.onConsentChange(record);
@@ -1874,6 +1933,23 @@ var ConsentManager = class {
       this.client.log(`Failed to submit consent to server: ${err}`);
     }
   }
+  injectSettingsButton() {
+    if (typeof document === "undefined") return;
+    const existing = document.getElementById("zerocost-privacy-settings-btn");
+    if (existing) return;
+    const btn = document.createElement("button");
+    btn.id = "zerocost-privacy-settings-btn";
+    btn.setAttribute("aria-label", "Privacy Settings");
+    btn.title = "Privacy Settings";
+    const pos = this.consentConfig.buttonPosition || "bottom-left";
+    btn.className = `zc-settings-btn zc-settings-${pos}`;
+    btn.innerHTML = `<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M12 22s8-4 8-10V5l-8-3-8 3v7c0 6 8 10 8 10z"/></svg>`;
+    btn.addEventListener("click", () => this.open());
+    document.body.appendChild(btn);
+  }
+  removeSettingsButton() {
+    document.getElementById("zerocost-privacy-settings-btn")?.remove();
+  }
 };
 
 // src/index.ts
@@ -1907,21 +1983,15 @@ var ZerocostSDK = class {
     });
   }
   async init() {
-    this.core.init();
     if (typeof document === "undefined") {
-      this.core.log("Running in non-browser environment; skipping DOM injection.");
       return;
     }
     if (window !== window.top) {
-      this.core.log("Running inside an iframe. Ads render if permissions allow.");
     }
-    this.core.log("Initializing Zerocost SDK.");
     if (this.consent.shouldPrompt()) {
-      this.core.log("Consent required \u2014 showing prompt.");
       await this.consent.promptAndWait();
     }
     if (!this.consent.has("ads")) {
-      this.core.log("Ads consent not granted \u2014 skipping ad injection.");
       return;
     }
     const cachedConfig = this.readCachedConfig();
@@ -1929,12 +1999,11 @@ var ZerocostSDK = class {
       this.lastConfigHash = this.configToHash(cachedConfig);
       this.syncDataCollection(cachedConfig.dataCollection);
       await this.widget.autoInjectWithConfig(cachedConfig.display, cachedConfig.widget);
-      this.core.log("Applied cached config immediately.");
     }
     this.startConfigSync();
     try {
       await this.refreshConfig({ force: true, reason: "init" });
-      this.core.log("SDK fully initialized. Ads are rendering automatically.");
+      this.core.log(`Zerocost SDK initialized (${this.core.getConfig().appId})`);
     } catch (err) {
       this.core.log(`Init error: ${err}. Attempting fallback ad injection.`);
       await this.widget.autoInject();
@@ -2108,6 +2177,10 @@ var ZerocostSDK = class {
       return { valid: false, error: err.message };
     }
   }
+  /** Open the consent/privacy settings popup. */
+  async showSettings() {
+    return this.consent.open();
+  }
 };
 export {
   ConsentManager,

package/dist/types/index.d.ts

@@ -11,6 +11,8 @@ export interface ZerocostConsentRecord {
 }
 export interface ConsentConfig {
     privacyPolicyUrl?: string;
+    showSettingsButton?: boolean;
+    buttonPosition?: 'bottom-left' | 'bottom-right' | 'top-left' | 'top-right';
     onConsentChange?: (preferences: ZerocostConsentRecord) => void;
 }
 export type ConsentFeature = 'ads' | 'usageData' | 'aiInteractions';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zerocost/sdk",
-  "version": "0.14.0",
+  "version": "0.16.0",
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.js",