Files
memind/mindspace-analytics.mjs
T

113 lines
6.0 KiB
JavaScript

import crypto from 'node:crypto';
const ANALYTICS_MARKER = 'data-memind-analytics="1"';
export function resolveMindSpaceAnalyticsConfig(env = process.env) {
const enabled = String(env.MEMIND_ANALYTICS_ENABLED ?? '').toLowerCase() === 'true';
const websiteId = String(env.MEMIND_ANALYTICS_WEBSITE_ID ?? '').trim();
const secret = String(env.MEMIND_ANALYTICS_ID_SECRET ?? '').trim();
return {
enabled: enabled && Boolean(websiteId) && Boolean(secret),
websiteId,
idSecret: secret,
analyticsUrl: String(env.MEMIND_ANALYTICS_URL ?? 'http://127.0.0.1:3100').trim() || 'http://127.0.0.1:3100',
scriptPath: String(env.MEMIND_ANALYTICS_SCRIPT_PATH ?? '/analytics/script.js').trim() || '/analytics/script.js',
hostPath: String(env.MEMIND_ANALYTICS_HOST_PATH ?? '/analytics').trim() || '/analytics',
domains: String(env.MEMIND_ANALYTICS_DOMAINS ?? '').trim(),
};
}
export function pseudonymizeAnalyticsId(value, secret) {
const normalized = String(value ?? '').trim();
const key = String(secret ?? '').trim();
if (!normalized || !key) return '';
return crypto.createHmac('sha256', key).update(normalized).digest('hex').slice(0, 32);
}
export function resolveAnalyticsOwnerSegment(user = {}) {
if (user?.role === 'admin') return 'admin';
const plan = String(user?.planType ?? user?.plan_type ?? 'free').trim().toLowerCase();
return `plan:${plan || 'free'}`;
}
export function resolveAnalyticsOwnerLabel(user = {}) {
const label = String(user?.displayName ?? user?.display_name ?? user?.username ?? '').trim();
return label.replace(/[\r\n\t]+/g, ' ').slice(0, 80) || '未命名用户';
}
export function sendMindSpaceAnalyticsEvent({
config,
eventName,
ownerId,
pageId = '',
publicationId = '',
agentRunId = '',
channel = 'h5',
ownerSegment = 'unknown',
ownerLabel = '未命名用户',
url = '',
} = {}) {
if (!config?.enabled || !config.websiteId || !config.idSecret || !eventName) return Promise.resolve(false);
const owner = pseudonymizeAnalyticsId(ownerId, config.idSecret);
if (!owner) return Promise.resolve(false);
const endpoint = `${String(config.analyticsUrl || 'http://127.0.0.1:3100').replace(/\/$/, '')}/api/send`;
const payload = {
website: config.websiteId,
hostname: '127.0.0.1',
url: url || '/',
name: String(eventName),
data: {
owner_id: owner,
page_id: String(pageId || ''),
publication_id: String(publicationId || ''),
agent_run_id: String(agentRunId || ''),
channel,
owner_segment: String(ownerSegment || 'unknown'),
owner_label: resolveAnalyticsOwnerLabel({ displayName: ownerLabel }),
},
};
return fetch(endpoint, {
method: 'POST',
headers: { 'content-type': 'application/json', 'user-agent': 'Memind/local-analytics' },
body: JSON.stringify({ type: 'event', payload }),
signal: AbortSignal.timeout(1500),
}).then((response) => response.ok).catch(() => false);
}
function jsonForInlineScript(value) {
return JSON.stringify(value)
.replaceAll('<', '\\u003c')
.replaceAll('>', '\\u003e')
.replaceAll('&', '\\u0026');
}
export function injectMindSpaceAnalytics(html, {
ownerId,
pageId = '',
publicationId = '',
ownerSegment = 'unknown',
ownerLabel = '未命名用户',
channel = 'h5',
config = resolveMindSpaceAnalyticsConfig(),
} = {}) {
const source = String(html ?? '');
if (!config?.enabled || !config.websiteId || !/^\s*(<!doctype html|<html\b)/i.test(source)) return source;
if (source.includes(ANALYTICS_MARKER)) return source;
const owner = pseudonymizeAnalyticsId(ownerId, config.idSecret);
if (!owner) return source;
// Public page source must not contain a readable account name. The stable
// pseudonym and coarse plan segment are sufficient for page analytics;
// readable labels are reserved for server-originated events only.
const metadata = { owner_id: owner, owner_segment: String(ownerSegment || 'unknown'), page_id: String(pageId || ''), publication_id: String(publicationId || ''), channel };
const attrs = [
ANALYTICS_MARKER,
`data-website-id="${config.websiteId.replaceAll('"', '&quot;')}"`,
'data-auto-track="false"',
`data-host-url="${config.hostPath}"`,
];
if (config.domains) attrs.push(`data-domains="${config.domains.replaceAll('"', '&quot;')}"`);
const block = `<script ${attrs.join(' ')} defer src="${config.scriptPath}"></script><script ${ANALYTICS_MARKER}>(function(){var d=${jsonForInlineScript(metadata)},seen={};function t(n,x){if(!window.umami||typeof window.umami.track!=='function')return;var p=Object.assign({},d,{page_url:location.href,page_title:document.title},x||{});window.umami.track(n,p);}function once(n,x){if(seen[n])return;seen[n]=1;t(n,x);}function ready(){t('page_view');document.addEventListener('click',function(e){var el=e.target&&e.target.closest?e.target.closest('a,button,[role="button"],[data-umami-event]'):null;if(!el)return;var custom=el.getAttribute('data-umami-event');var href=el.tagName==='A'?el.getAttribute('href')||'':'';t(custom||'page_click',{element:el.tagName.toLowerCase(),element_id:el.id||'',event_label:(custom||el.getAttribute('aria-label')||'').slice(0,100),target_url:href.slice(0,500)});},{passive:true});document.addEventListener('submit',function(e){var form=e.target;t('page_form_submit',{form_id:form&&form.id||'',form_action:form&&form.getAttribute('action')||''});},{passive:true});var marks=[25,50,75,90];function scroll(){var h=document.documentElement.scrollHeight-window.innerHeight;if(h<=0){once('page_scroll_100');return;}var pct=Math.round(window.scrollY/h*100);marks.forEach(function(m){if(pct>=m)once('page_scroll_'+m);});}window.addEventListener('scroll',scroll,{passive:true});setTimeout(function(){once('page_engaged_10s');},10000);setTimeout(function(){once('page_engaged_30s');},30000);scroll();}if(document.readyState==='loading'){document.addEventListener('DOMContentLoaded',ready,{once:true});}else{ready();}})();</script>`;
if (/<\/head>/i.test(source)) return source.replace(/<\/head>/i, `${block}</head>`);
return source.replace(/<body\b/i, `${block}<body`);
}