ciphera-net/pulse
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 15 Wiki Activity

feat: update ScriptSetupBlock and script.js to support new visitor ID storage options

Browse Source
This commit is contained in:
Usman Baig
2026-02-11 11:06:27 +01:00
parent c827e82376
commit f1c27e458a
2 changed files with 8 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
components/sites/ScriptSetupBlock.tsx
View File

@@ -40,7 +40,7 @@ export default function ScriptSetupBlock({
const [scriptCopied, setScriptCopied] = useState(false) const [scriptCopied, setScriptCopied] = useState(false)
const copyScript = useCallback(() => { const copyScript = useCallback(() => {
const script = `<script defer data-domain="${site.domain}" data-api="${API_URL}" src="${APP_URL}/script.js"></script>` const script = `<script defer data-domain="${site.domain}" data-api="${API_URL}" data-storage="local" data-storage-ttl="24" src="${APP_URL}/script.js"></script>`
navigator.clipboard.writeText(script) navigator.clipboard.writeText(script)
setScriptCopied(true) setScriptCopied(true)
toast.success('Script copied to clipboard') toast.success('Script copied to clipboard')
@@ -87,10 +87,10 @@ export default function ScriptSetupBlock({
<div className="rounded-xl bg-neutral-100 dark:bg-neutral-800 p-4 relative group"> <div className="rounded-xl bg-neutral-100 dark:bg-neutral-800 p-4 relative group">
<code className="text-xs text-neutral-900 dark:text-white break-all font-mono block pr-10"> <code className="text-xs text-neutral-900 dark:text-white break-all font-mono block pr-10">
{`<script defer data-domain="${site.domain}" data-api="${API_URL}" src="${APP_URL}/script.js"></script>`} {`<script defer data-domain="${site.domain}" data-api="${API_URL}" data-storage="local" data-storage-ttl="24" src="${APP_URL}/script.js"></script>`}
</code> </code>
<p className="mt-2 text-xs text-neutral-500 dark:text-neutral-400"> <p className="mt-2 text-xs text-neutral-500 dark:text-neutral-400">
Optional: <code className="rounded px-1 bg-neutral-200 dark:bg-neutral-700">data-storage=&quot;local&quot;</code> for cross-tab unique visitors; <code className="rounded px-1 bg-neutral-200 dark:bg-neutral-700">data-storage-ttl=&quot;24&quot;</code> (hours) to expire the ID. Optional: <code className="rounded px-1 bg-neutral-200 dark:bg-neutral-700">data-storage=&quot;session&quot;</code> for per-tab (ephemeral) visitor counting.
</p> </p>
<button <button
type="button" type="button"

10
public/script.js
View File

@@ -1,8 +1,8 @@
/** /**
* Pulse - Privacy-First Tracking Script * Pulse - Privacy-First Tracking Script
* Lightweight, no cookies, GDPR compliant. * Lightweight, no cookies, GDPR compliant.
* Default: ephemeral session ID (sessionStorage, per-tab). Optional: data-storage="local" * Default: cross-tab visitor ID (localStorage, optional data-storage-ttl in hours).
* and data-storage-ttl (hours) for a persistent cross-tab visitor ID with optional expiry. * Optional: data-storage="session" for per-tab (ephemeral) counting.
*/ */
(function() { (function() {
@@ -21,8 +21,8 @@
const domain = script.getAttribute('data-domain'); const domain = script.getAttribute('data-domain');
const apiUrl = script.getAttribute('data-api') || 'https://pulse-api.ciphera.net'; const apiUrl = script.getAttribute('data-api') || 'https://pulse-api.ciphera.net';
// * Visitor ID storage: "session" (default, ephemeral per-tab) or "local" (persistent, cross-tab) // * Visitor ID storage: "local" (default, cross-tab) or "session" (ephemeral per-tab)
const storageMode = (script.getAttribute('data-storage') || 'session').toLowerCase() === 'local' ? 'local' : 'session'; const storageMode = (script.getAttribute('data-storage') || 'local').toLowerCase() === 'session' ? 'session' : 'local';
// * When storage is "local", optional TTL in hours; after TTL the ID is regenerated (e.g. 24 = one day) // * When storage is "local", optional TTL in hours; after TTL the ID is regenerated (e.g. 24 = one day)
const ttlHours = storageMode === 'local' ? parseFloat(script.getAttribute('data-storage-ttl') || '24', 10) : 0; const ttlHours = storageMode === 'local' ? parseFloat(script.getAttribute('data-storage-ttl') || '24', 10) : 0;
const ttlMs = ttlHours > 0 ? ttlHours * 60 * 60 * 1000 : 0; const ttlMs = ttlHours > 0 ? ttlHours * 60 * 60 * 1000 : 0;
@@ -151,7 +151,7 @@
return cachedSessionId; return cachedSessionId;
} }
// * Default: session storage (ephemeral, per-tab) // * data-storage="session": session storage (ephemeral, per-tab)
try { try {
cachedSessionId = sessionStorage.getItem(key); cachedSessionId = sessionStorage.getItem(key);
if (!cachedSessionId && legacyKey) { if (!cachedSessionId && legacyKey) {