@farming-labs/theme 0.2.4 → 0.2.6

package/dist/docs-api.mjs

@@ -429,6 +429,35 @@ async function parseAgentFeedbackData(request) {
 		}
 	};
 }
+function buildAgentFeedbackAnalyticsProperties(data, options = {}) {
+	const payloadKeys = Object.keys(data.payload);
+	const context = data.context;
+	return {
+		...options.requestProperties,
+		feedbackKind: "agent",
+		agentFeedbackContext: context,
+		contextPage: context?.page,
+		contextUrl: context?.url,
+		contextSlug: context?.slug,
+		contextLocale: context?.locale,
+		contextSource: context?.source,
+		payloadKeys,
+		payloadFieldCount: payloadKeys.length,
+		hasContext: Boolean(data.context),
+		hasPayload: payloadKeys.length > 0,
+		...typeof options.handled === "boolean" ? { handled: options.handled } : {},
+		...options.reason ? { reason: options.reason } : {},
+		...options.error ? { error: options.error } : {}
+	};
+}
+function buildAgentFeedbackAnalyticsInput(data) {
+	return {
+		feedbackContext: data.context,
+		feedbackPayload: data.payload,
+		agentFeedbackContext: data.context,
+		agentFeedbackPayload: data.payload
+	};
+}
 function validateAgentFeedbackPayload(value, schema, valuePath = "payload") {
 	const schemaType = typeof schema.type === "string" ? schema.type : void 0;
 	if (Array.isArray(schema.enum) && !schema.enum.some((entry) => Object.is(entry, value))) return `${valuePath} must be one of the configured enum values`;
@@ -2845,6 +2874,7 @@ function createDocsAPI(options) {
 						path: url.pathname,
 						properties: {
 							...requestAnalyticsProperties,
+							feedbackKind: "agent",
 							reason: "invalid_body"
 						}
 					});
@@ -2857,11 +2887,12 @@ function createDocsAPI(options) {
 						source: "server",
 						url: request.url,
 						path: url.pathname,
-						properties: {
-							...requestAnalyticsProperties,
+						input: buildAgentFeedbackAnalyticsInput(parsed.data),
+						properties: buildAgentFeedbackAnalyticsProperties(parsed.data, {
+							requestProperties: requestAnalyticsProperties,
 							reason: "invalid_payload",
 							error: payloadError
-						}
+						})
 					});
 					return Response.json({ error: payloadError }, { status: 400 });
 				}
@@ -2871,12 +2902,11 @@ function createDocsAPI(options) {
 						source: "server",
 						url: request.url,
 						path: url.pathname,
-						properties: {
-							...requestAnalyticsProperties,
-							handled: false,
-							payloadKeys: Object.keys(parsed.data.payload),
-							hasContext: Boolean(parsed.data.context)
-						}
+						input: buildAgentFeedbackAnalyticsInput(parsed.data),
+						properties: buildAgentFeedbackAnalyticsProperties(parsed.data, {
+							requestProperties: requestAnalyticsProperties,
+							handled: false
+						})
 					});
 					return Response.json({
 						ok: true,
@@ -2889,12 +2919,11 @@ function createDocsAPI(options) {
 					source: "server",
 					url: request.url,
 					path: url.pathname,
-					properties: {
-						...requestAnalyticsProperties,
-						handled: true,
-						payloadKeys: Object.keys(parsed.data.payload),
-						hasContext: Boolean(parsed.data.context)
-					}
+					input: buildAgentFeedbackAnalyticsInput(parsed.data),
+					properties: buildAgentFeedbackAnalyticsProperties(parsed.data, {
+						requestProperties: requestAnalyticsProperties,
+						handled: true
+					})
 				});
 				return Response.json({
 					ok: true,

package/dist/docs-feedback.mjs

@@ -52,6 +52,22 @@ function buildFeedbackPayload(value, pathname, entry, comment, locale) {
 		locale
 	};
 }
+function buildFeedbackAnalyticsProperties(data) {
+	return {
+		feedbackKind: "page",
+		value: data.value,
+		feedbackValue: data.value,
+		hasComment: Boolean(data.comment),
+		commentLength: data.comment?.length ?? 0,
+		title: data.title,
+		description: data.description,
+		url: data.url,
+		pathname: data.pathname,
+		path: data.path,
+		entry: data.entry,
+		slug: data.slug
+	};
+}
 function ThumbUpIcon() {
 	return /* @__PURE__ */ jsx("svg", {
 		width: "14",
@@ -115,32 +131,40 @@ function DocsFeedback({ pathname, entry, locale, question = "How is this guide?"
 	function handleSelect(value) {
 		setSelected(value);
 		if (status !== "idle") setStatus("idle");
-		if (analytics) emitClientAnalyticsEvent({
-			type: "feedback_select",
-			locale,
-			path: normalizedPathname,
-			properties: {
-				value,
-				slug: resolveSlug(entry, normalizedPathname)
-			}
-		});
+		if (analytics) {
+			const slug = resolveSlug(entry, normalizedPathname);
+			emitClientAnalyticsEvent({
+				type: "feedback_select",
+				locale,
+				path: normalizedPathname,
+				input: { feedbackValue: value },
+				properties: {
+					feedbackKind: "page",
+					value,
+					feedbackValue: value,
+					entry,
+					pathname: normalizedPathname,
+					path: normalizedPathname,
+					slug
+				}
+			});
+		}
 	}
 	async function handleSubmit() {
 		if (!selected || status === "submitting") return;
 		setStatus("submitting");
+		const payload = buildFeedbackPayload(selected, normalizedPathname, entry, comment, locale);
 		try {
-			const payload = buildFeedbackPayload(selected, normalizedPathname, entry, comment, locale);
 			await emitFeedback(payload, onFeedback);
 			if (analytics) emitClientAnalyticsEvent({
 				type: "feedback_submit",
 				locale,
 				path: normalizedPathname,
-				properties: {
-					value: payload.value,
-					slug: payload.slug,
-					hasComment: Boolean(payload.comment),
-					commentLength: payload.comment?.length ?? 0
-				}
+				input: {
+					feedbackValue: payload.value,
+					feedbackComment: payload.comment
+				},
+				properties: buildFeedbackAnalyticsProperties(payload)
 			});
 			setStatus("submitted");
 		} catch {
@@ -148,12 +172,11 @@ function DocsFeedback({ pathname, entry, locale, question = "How is this guide?"
 				type: "feedback_error",
 				locale,
 				path: normalizedPathname,
-				properties: {
-					value: selected,
-					slug: resolveSlug(entry, normalizedPathname),
-					hasComment: Boolean(comment.trim()),
-					commentLength: comment.trim().length
-				}
+				input: {
+					feedbackValue: payload.value,
+					feedbackComment: payload.comment
+				},
+				properties: buildFeedbackAnalyticsProperties(payload)
 			});
 			setStatus("error");
 		}

package/package.json

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