@farming-labs/theme 0.1.134 → 0.1.136

package/dist/client-analytics.mjs

@@ -1,15 +1,105 @@
 "use client";
 
 //#region src/client-analytics.ts
+const VISITOR_ID_STORAGE_KEY = "fd:analytics:visitor-id";
+const SESSION_ID_STORAGE_KEY = "fd:analytics:session-id";
+function createAnalyticsId(prefix) {
+	return `${prefix}_${typeof crypto !== "undefined" && typeof crypto.randomUUID === "function" ? crypto.randomUUID() : `${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 12)}`}`;
+}
+function readStorage(storage, key) {
+	try {
+		return storage?.getItem(key)?.trim() || void 0;
+	} catch {
+		return;
+	}
+}
+function writeStorage(storage, key, value) {
+	try {
+		storage?.setItem(key, value);
+	} catch {}
+}
+function getBrowserStorage(target, key) {
+	try {
+		return target[key];
+	} catch {
+		return;
+	}
+}
+function getOrCreateClientId({ cachedValue, create, storage, storageKey }) {
+	const stored = readStorage(storage, storageKey);
+	const value = stored ?? cachedValue ?? create();
+	if (!stored) writeStorage(storage, storageKey, value);
+	return value;
+}
+function getDocsClientAnalyticsIdentity() {
+	if (typeof window === "undefined") return null;
+	const target = window;
+	const visitorId = getOrCreateClientId({
+		cachedValue: target.__fdAnalyticsVisitorId__,
+		create: () => createAnalyticsId("visitor"),
+		storage: getBrowserStorage(target, "localStorage"),
+		storageKey: VISITOR_ID_STORAGE_KEY
+	});
+	const sessionId = getOrCreateClientId({
+		cachedValue: target.__fdAnalyticsSessionId__,
+		create: () => createAnalyticsId("session"),
+		storage: getBrowserStorage(target, "sessionStorage"),
+		storageKey: SESSION_ID_STORAGE_KEY
+	});
+	target.__fdAnalyticsVisitorId__ = visitorId;
+	target.__fdAnalyticsSessionId__ = sessionId;
+	return {
+		anonymousId: visitorId,
+		visitorId,
+		sessionId,
+		visitor: { id: visitorId },
+		session: { id: sessionId }
+	};
+}
+function asRecord(value) {
+	return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function asString(value) {
+	return typeof value === "string" && value.trim() ? value.trim() : void 0;
+}
+function normalizeClientAnalyticsProperties(identity, properties) {
+	const provided = properties ?? {};
+	const visitorId = asString(provided.visitorId) ?? asString(asRecord(provided.visitor).id) ?? asString(provided.anonymousId) ?? identity?.visitorId;
+	const sessionId = asString(provided.sessionId) ?? asString(asRecord(provided.session).id) ?? identity?.sessionId;
+	const merged = {
+		...identity ?? {},
+		...provided
+	};
+	return {
+		...merged,
+		...visitorId ? {
+			anonymousId: asString(provided.anonymousId) ?? visitorId,
+			visitorId,
+			visitor: {
+				...asRecord(merged.visitor),
+				id: visitorId
+			}
+		} : {},
+		...sessionId ? {
+			sessionId,
+			session: {
+				...asRecord(merged.session),
+				id: sessionId
+			}
+		} : {}
+	};
+}
 function emitClientAnalyticsEvent(event) {
 	if (typeof window === "undefined") return;
+	const identity = getDocsClientAnalyticsIdentity();
 	const normalized = {
 		...event,
 		source: "client",
-		path: window.location.pathname,
-		url: window.location.href,
-		referrer: document.referrer || void 0,
-		timestamp: (/* @__PURE__ */ new Date()).toISOString()
+		path: event.path ?? window.location.pathname,
+		url: event.url ?? window.location.href,
+		referrer: event.referrer ?? (document.referrer || void 0),
+		timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+		properties: normalizeClientAnalyticsProperties(identity, event.properties)
 	};
 	const target = window;
 	try {

package/dist/docs-client-hooks.d.mts

@@ -5,6 +5,7 @@ type CopyHandler = (data: CodeBlockCopyData) => void;
 type FeedbackHandler = (data: DocsFeedbackData) => void | Promise<void>;
 type AIActionHandler = (data: DocsAskAIActionData) => void | Promise<void>;
 type AIFeedbackHandler = (data: DocsAskAIFeedbackData) => void | Promise<void>;
+declare function isDocsClientAnalyticsEnabled(analytics?: boolean | DocsAnalyticsConfig): boolean;
 declare function DocsClientHooks({
   onCopyClick,
   onFeedback,
@@ -19,4 +20,4 @@ declare function DocsClientHooks({
   analytics?: boolean | DocsAnalyticsConfig;
 }): null;
 //#endregion
-export { DocsClientHooks };
+export { DocsClientHooks, isDocsClientAnalyticsEnabled };

package/dist/docs-client-hooks.mjs

@@ -2,7 +2,7 @@
 
 import { emitClientAnalyticsEvent } from "./client-analytics.mjs";
 import { useEffect } from "react";
-import { emitDocsAnalyticsEvent } from "@farming-labs/docs";
+import { emitDocsAnalyticsEvent, resolveDocsAnalyticsConfig } from "@farming-labs/docs";
 
 //#region src/docs-client-hooks.tsx
 function useWindowHook(key, handler) {
@@ -18,10 +18,13 @@ function useWindowHook(key, handler) {
 		};
 	}, [handler, key]);
 }
+function isDocsClientAnalyticsEnabled(analytics) {
+	return resolveDocsAnalyticsConfig(analytics).enabled;
+}
 function useAnalyticsHook(analytics) {
 	useEffect(() => {
 		if (typeof window === "undefined") return;
-		if (!analytics) return;
+		if (!isDocsClientAnalyticsEnabled(analytics)) return;
 		const target = window;
 		const handler = (event) => {
 			emitDocsAnalyticsEvent(analytics, event);
@@ -40,7 +43,7 @@ function useAnalyticsHook(analytics) {
 function useCodeCopyAnalytics(analytics) {
 	useEffect(() => {
 		if (typeof window === "undefined") return;
-		if (!analytics) return;
+		if (!isDocsClientAnalyticsEnabled(analytics)) return;
 		const handleClick = (event) => {
 			const target = event.target;
 			if (!target.closest?.("button")) return;
@@ -76,4 +79,4 @@ function DocsClientHooks({ onCopyClick, onFeedback, onAIActions, onAIFeedback, a
 }
 
 //#endregion
-export { DocsClientHooks };
+export { DocsClientHooks, isDocsClientAnalyticsEnabled };

package/dist/index.d.mts

@@ -1,13 +1,13 @@
 import { CommandGridUIDefaults, commandGrid } from "./command-grid/index.mjs";
 import { ConcreteUIDefaults, concrete } from "./concrete/index.mjs";
 import { DefaultUIDefaults, fumadocs } from "./default/index.mjs";
+import { DocsClientHooks } from "./docs-client-hooks.mjs";
 import { DocsCommandSearch } from "./docs-command-search.mjs";
 import { createDocsLayout, createDocsMetadata, createPageMetadata } from "./docs-layout.mjs";
 import { DocsPageClient } from "./docs-page-client.mjs";
 import { HardlineUIDefaults, hardline } from "./hardline/index.mjs";
 import { RootProvider } from "./provider.mjs";
 import { LedgerUIDefaults, ledger } from "./ledger/index.mjs";
-import { DocsClientHooks } from "./docs-client-hooks.mjs";
 import { DocsFeedback, DocsFeedbackProps } from "./docs-feedback.mjs";
 import { PageActions } from "./page-actions.mjs";
 import { withLangInUrl } from "./i18n.mjs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/theme",
-  "version": "0.1.134",
+  "version": "0.1.136",
   "description": "Theme package for @farming-labs/docs — layout, provider, MDX components, and styles",
   "keywords": [
     "docs",
@@ -139,7 +139,7 @@
     "tsdown": "^0.20.3",
     "typescript": "^5.9.3",
     "vitest": "^3.2.4",
-    "@farming-labs/docs": "0.1.134"
+    "@farming-labs/docs": "0.1.136"
   },
   "peerDependencies": {
     "@farming-labs/docs": ">=0.0.1",