@neopress/mcp 1.5.0 → 1.6.0

package/dist/index.js

@@ -173,6 +173,10 @@ var EntriesEndpoint = class {
 			collectionId
 		})).data;
 	}
+	/** Copy source content into a linked locale draft, or return its existing translation. */
+	async createTranslation(entryId, locale) {
+		return (await this.client.post(`${this.basePath}/${entryId}/translations`, { locale })).data;
+	}
 	async update(entryId, data) {
 		const payload = {};
 		for (const key of UPDATE_PASSTHROUGH_FIELDS) if (key in data) payload[key] = data[key];
@@ -450,8 +454,12 @@ function appendCommonAnalyticsParams(qs, params) {
 }
 var AnalyticsEndpoint = class {
 	client;
+	events;
+	funnels;
 	constructor(client) {
 		this.client = client;
+		this.events = new AnalyticsEventsEndpoint(client);
+		this.funnels = new AnalyticsFunnelsEndpoint(client);
 	}
 	get basePath() {
 		return `${this.client.siteBasePath}/analytics`;
@@ -508,6 +516,58 @@ var AnalyticsEndpoint = class {
 		if (params.rowLimit) qs.set("row_limit", String(params.rowLimit));
 		return (await this.client.get(`${this.basePath}/search-console?${qs.toString()}`)).data;
 	}
+	/** Page/form targets that can be referenced by an event definition. */
+	async targets() {
+		return (await this.client.get(`${this.basePath}/targets`)).data;
+	}
+};
+var AnalyticsEventsEndpoint = class {
+	client;
+	constructor(client) {
+		this.client = client;
+	}
+	get basePath() {
+		return `${this.client.siteBasePath}/analytics/events`;
+	}
+	async list() {
+		return (await this.client.get(this.basePath)).data;
+	}
+	async get(eventId) {
+		return (await this.client.get(`${this.basePath}/${eventId}`)).data.event;
+	}
+	async create(data) {
+		return (await this.client.post(this.basePath, data)).data.event;
+	}
+	async update(eventId, data) {
+		return (await this.client.patch(`${this.basePath}/${eventId}`, data)).data.event;
+	}
+	async delete(eventId) {
+		await this.client.delete(`${this.basePath}/${eventId}`);
+	}
+};
+var AnalyticsFunnelsEndpoint = class {
+	client;
+	constructor(client) {
+		this.client = client;
+	}
+	get basePath() {
+		return `${this.client.siteBasePath}/analytics/funnels`;
+	}
+	async list() {
+		return (await this.client.get(this.basePath)).data;
+	}
+	async get(funnelId) {
+		return (await this.client.get(`${this.basePath}/${funnelId}`)).data.funnel;
+	}
+	async create(data) {
+		return (await this.client.post(this.basePath, data)).data.funnel;
+	}
+	async update(funnelId, data) {
+		return (await this.client.patch(`${this.basePath}/${funnelId}`, data)).data.funnel;
+	}
+	async delete(funnelId) {
+		await this.client.delete(`${this.basePath}/${funnelId}`);
+	}
 };
 //#endregion
 //#region ../sdk/src/endpoints/templates.ts
@@ -1233,6 +1293,11 @@ const READ_ONLY_TOOLS = /* @__PURE__ */ new Set([
 	"neopress_analytics_traffic_sources",
 	"neopress_analytics_forms",
 	"neopress_analytics_crawler_summary",
+	"neopress_analytics_events_list",
+	"neopress_analytics_event_get",
+	"neopress_analytics_funnels_list",
+	"neopress_analytics_funnel_get",
+	"neopress_analytics_targets_list",
 	"neopress_search_console_query",
 	"neopress_assets_list",
 	"neopress_asset_get",
@@ -1256,7 +1321,13 @@ const DESTRUCTIVE_TOOLS = /* @__PURE__ */ new Set([
 	"neopress_form_delete",
 	"neopress_asset_delete",
 	"neopress_template_mark",
-	"neopress_publish_site"
+	"neopress_publish_site",
+	"neopress_analytics_event_create",
+	"neopress_analytics_event_update",
+	"neopress_analytics_event_delete",
+	"neopress_analytics_funnel_create",
+	"neopress_analytics_funnel_update",
+	"neopress_analytics_funnel_delete"
 ]);
 const PUBLICATION_TOOLS = /* @__PURE__ */ new Set([
 	"neopress_entry_publish",
@@ -1297,6 +1368,12 @@ function asOptionalNumber(input, key) {
 function asOptionalString(input, key) {
 	return input[key];
 }
+function asOptionalBoolean(input, key) {
+	return input[key];
+}
+function omitUndefined(value) {
+	return Object.fromEntries(Object.entries(value).filter(([, item]) => item !== void 0));
+}
 function siteId(input) {
 	return asOptionalNumber(input, "siteId");
 }
@@ -1523,10 +1600,11 @@ const toolDefinitions = [
 			title: z.string().optional(),
 			type: z.enum(["static", "dynamic"]).optional(),
 			status: z.enum(["draft", "published"]).optional(),
+			visibility: z.enum(["public", "hidden"]).optional(),
 			collectionId: z.number().int().positive().optional(),
 			draftTsx: z.string().optional(),
 			draftI18n: optionalJsonSchema,
-			draftPublicLocales: z.array(z.string()).nullable().optional(),
+			draftPublicLocales: z.array(z.string()).nullable().optional().describe("Draft public languages. null means default language only; [] means none. Publish to apply."),
 			draftMeta: optionalJsonSchema,
 			queryConfig: optionalJsonSchema,
 			metadata: optionalJsonSchema
@@ -1537,6 +1615,7 @@ const toolDefinitions = [
 				title: asOptionalString(input, "title"),
 				type: input.type,
 				status: input.status,
+				visibility: input.visibility,
 				collectionId: asOptionalNumber(input, "collectionId"),
 				draftTsx: asOptionalString(input, "draftTsx"),
 				draftI18n: input.draftI18n,
@@ -1557,27 +1636,29 @@ const toolDefinitions = [
 			title: z.string().optional(),
 			type: z.enum(["static", "dynamic"]).optional(),
 			status: z.string().optional(),
+			visibility: z.enum(["public", "hidden"]).optional(),
 			collectionId: z.number().int().positive().optional(),
 			draftTsx: z.string().optional(),
 			draftI18n: optionalJsonSchema,
-			draftPublicLocales: z.array(z.string()).nullable().optional(),
+			draftPublicLocales: z.array(z.string()).nullable().optional().describe("Draft public languages. null means default language only; [] means none. Publish to apply."),
 			draftMeta: optionalJsonSchema,
 			queryConfig: optionalJsonSchema,
 			metadata: optionalJsonSchema
 		},
 		handler: async (input, context, extra) => {
-			return (await context.createClient({ siteId: siteId(input) }, extra)).pages.update(asNumber(input, "pageId"), {
+			return (await context.createClient({ siteId: siteId(input) }, extra)).pages.update(asNumber(input, "pageId"), omitUndefined({
 				path: asOptionalString(input, "path"),
 				title: asOptionalString(input, "title"),
 				type: asOptionalString(input, "type"),
 				status: asOptionalString(input, "status"),
+				visibility: input.visibility,
 				collectionId: asOptionalNumber(input, "collectionId"),
 				draftTsx: asOptionalString(input, "draftTsx"),
 				draftI18n: input.draftI18n,
 				draftPublicLocales: input.draftPublicLocales,
 				draftMeta: mergeDraftMeta(input.draftMeta, input.queryConfig),
 				metadata: input.metadata
-			});
+			}));
 		}
 	},
 	{
@@ -1733,6 +1814,19 @@ const toolDefinitions = [
 			return entry;
 		}
 	},
+	{
+		name: "neopress_entry_create_translation",
+		title: "Create Entry Translation Draft",
+		description: "Create or return a linked locale row in the source entry's translation group. New drafts copy source content; translate the returned entry with entry_update, then publish it. Existing translations are preserved.",
+		inputSchema: {
+			...siteIdShape,
+			entryId: z.number().int().positive(),
+			locale: z.string().min(1)
+		},
+		handler: async (input, context, extra) => {
+			return (await context.createClient({ siteId: siteId(input) }, extra)).entries.createTranslation(asNumber(input, "entryId"), asString(input, "locale"));
+		}
+	},
 	{
 		name: "neopress_entry_update",
 		title: "Update Entry",
@@ -1749,14 +1843,14 @@ const toolDefinitions = [
 		},
 		handler: async (input, context, extra) => {
 			const client = await context.createClient({ siteId: siteId(input) }, extra);
-			const entry = await client.entries.update(asNumber(input, "entryId"), {
+			const entry = await client.entries.update(asNumber(input, "entryId"), omitUndefined({
 				slug: asOptionalString(input, "slug"),
 				title: asOptionalString(input, "title"),
 				locale: asOptionalString(input, "locale"),
 				data: input.data,
 				metadata: input.metadata,
 				status: asOptionalString(input, "status")
-			});
+			}));
 			await client.entries.revalidateReaderCache(asNumber(input, "entryId"));
 			return entry;
 		}
@@ -1921,14 +2015,14 @@ const toolDefinitions = [
 			settings: optionalJsonSchema
 		},
 		handler: async (input, context, extra) => {
-			return (await context.createClient({ siteId: siteId(input) }, extra)).forms.update(asNumber(input, "formId"), {
+			return (await context.createClient({ siteId: siteId(input) }, extra)).forms.update(asNumber(input, "formId"), omitUndefined({
 				name: asOptionalString(input, "name"),
-				draftSchema: input.draftSchema ?? input.schema,
+				draftSchema: input.draftSchema !== void 0 ? input.draftSchema : input.schema,
 				draftLayout: input.draftLayout,
 				draftStyle: input.draftStyle,
 				draftI18n: input.draftI18n,
 				settings: input.settings
-			});
+			}));
 		}
 	},
 	{
@@ -1972,6 +2066,235 @@ const toolDefinitions = [
 			});
 		}
 	},
+	{
+		name: "neopress_analytics_events_list",
+		title: "List Analytics Events",
+		description: "List saved analytics event definitions for the active site.",
+		inputSchema: siteIdShape,
+		handler: async (input, context, extra) => {
+			return (await context.createClient({ siteId: siteId(input) }, extra)).analytics.events.list();
+		}
+	},
+	{
+		name: "neopress_analytics_event_get",
+		title: "Get Analytics Event",
+		description: "Get a saved analytics event definition by UUID.",
+		inputSchema: {
+			...siteIdShape,
+			eventId: z.string().uuid()
+		},
+		handler: async (input, context, extra) => {
+			return (await context.createClient({ siteId: siteId(input) }, extra)).analytics.events.get(asString(input, "eventId"));
+		}
+	},
+	{
+		name: "neopress_analytics_event_create",
+		title: "Create Analytics Event",
+		description: "Create a saved analytics event definition. Discover pages/forms with neopress_analytics_targets_list. Click/visibility require an existing stable [data-np-track=\"...\"] selector; page views reuse PAGE_VIEW. Optional id is a client UUID: reuse the same id and payload after an uncertain response.",
+		inputSchema: {
+			...siteIdShape,
+			id: z.string().uuid().optional(),
+			name: z.string(),
+			eventType: z.enum([
+				"custom",
+				"page",
+				"click",
+				"form",
+				"scroll",
+				"visibility",
+				"dwell"
+			]),
+			eventName: z.string().optional(),
+			path: z.string().optional(),
+			selector: z.string().optional(),
+			formId: z.string().optional(),
+			scrollDepth: z.number().int().optional(),
+			dwellSeconds: z.number().int().optional()
+		},
+		handler: async (input, context, extra) => {
+			return (await context.createClient({ siteId: siteId(input) }, extra)).analytics.events.create({
+				id: asOptionalString(input, "id"),
+				name: asString(input, "name"),
+				eventType: input.eventType,
+				eventName: asOptionalString(input, "eventName"),
+				path: asOptionalString(input, "path"),
+				selector: asOptionalString(input, "selector"),
+				formId: asOptionalString(input, "formId"),
+				scrollDepth: asOptionalNumber(input, "scrollDepth"),
+				dwellSeconds: asOptionalNumber(input, "dwellSeconds")
+			});
+		}
+	},
+	{
+		name: "neopress_analytics_event_update",
+		title: "Update Analytics Event",
+		description: "Rename an analytics event with {name} while preserving tracking behavior, or update its display settings separately. Tracking identity cannot be changed after creation.",
+		inputSchema: {
+			...siteIdShape,
+			eventId: z.string().uuid(),
+			name: z.string().optional(),
+			eventType: z.enum([
+				"custom",
+				"page",
+				"click",
+				"form",
+				"scroll",
+				"visibility",
+				"dwell"
+			]).optional(),
+			eventName: z.string().optional(),
+			path: z.string().optional(),
+			selector: z.string().optional(),
+			formId: z.string().optional(),
+			scrollDepth: z.number().int().optional(),
+			dwellSeconds: z.number().int().optional(),
+			chartVisible: z.boolean().optional(),
+			pinned: z.boolean().optional(),
+			chartColor: z.string().optional()
+		},
+		handler: async (input, context, extra) => {
+			const client = await context.createClient({ siteId: siteId(input) }, extra);
+			if ([
+				"chartVisible",
+				"pinned",
+				"chartColor"
+			].some((key) => key in input)) {
+				if ([
+					"name",
+					"eventType",
+					"eventName",
+					"path",
+					"selector",
+					"formId",
+					"scrollDepth",
+					"dwellSeconds"
+				].some((key) => input[key] !== void 0)) throw new Error("Update the definition and display settings in separate calls.");
+				return client.analytics.events.update(asString(input, "eventId"), { display: {
+					chartVisible: asOptionalBoolean(input, "chartVisible"),
+					pinned: asOptionalBoolean(input, "pinned"),
+					chartColor: asOptionalString(input, "chartColor")
+				} });
+			}
+			const definition = {
+				name: asString(input, "name"),
+				...input.eventType !== void 0 ? { eventType: input.eventType } : {},
+				eventName: asOptionalString(input, "eventName"),
+				path: asOptionalString(input, "path"),
+				selector: asOptionalString(input, "selector"),
+				formId: asOptionalString(input, "formId"),
+				scrollDepth: asOptionalNumber(input, "scrollDepth"),
+				dwellSeconds: asOptionalNumber(input, "dwellSeconds")
+			};
+			return client.analytics.events.update(asString(input, "eventId"), definition);
+		}
+	},
+	{
+		name: "neopress_analytics_event_delete",
+		title: "Delete Analytics Event",
+		description: "Permanently delete a saved analytics event. Events referenced by a funnel cannot be deleted.",
+		inputSchema: {
+			...siteIdShape,
+			eventId: z.string().uuid()
+		},
+		handler: async (input, context, extra) => {
+			await (await context.createClient({ siteId: siteId(input) }, extra)).analytics.events.delete(asString(input, "eventId"));
+			return { ok: true };
+		}
+	},
+	{
+		name: "neopress_analytics_funnels_list",
+		title: "List Analytics Funnels",
+		description: "List saved analytics funnel definitions for the active site.",
+		inputSchema: siteIdShape,
+		handler: async (input, context, extra) => {
+			return (await context.createClient({ siteId: siteId(input) }, extra)).analytics.funnels.list();
+		}
+	},
+	{
+		name: "neopress_analytics_funnel_get",
+		title: "Get Analytics Funnel",
+		description: "Get a saved analytics funnel definition by UUID.",
+		inputSchema: {
+			...siteIdShape,
+			funnelId: z.string().uuid()
+		},
+		handler: async (input, context, extra) => {
+			return (await context.createClient({ siteId: siteId(input) }, extra)).analytics.funnels.get(asString(input, "funnelId"));
+		}
+	},
+	{
+		name: "neopress_analytics_funnel_create",
+		title: "Create Analytics Funnel",
+		description: "Create a funnel with 2 to 5 ordered saved event UUIDs. Optional id is a client UUID; reuse it and the same payload after an uncertain response. Step filter is {version:1,root:{kind:'group',op:'and'|'or',children:[groups or {kind:'condition',field,operator,value?,key?}]}}. Fields: event.path/url/referrer/referrer_source/property; session.referrer/referrer_source/traffic_category/utm_source/utm_medium/utm_campaign/utm_content/utm_term. event.property requires key. Operators: eq,neq,contains,not_contains,starts_with,ends_with,exists,not_exists; property also supports gt,gte,lt,lte. Server validates bounds and grouping.",
+		inputSchema: {
+			...siteIdShape,
+			id: z.string().uuid().optional(),
+			name: z.string(),
+			steps: z.array(z.object({
+				eventId: z.string().uuid(),
+				path: z.string().optional(),
+				filter: z.unknown().optional()
+			})),
+			windowMode: z.enum(["session", "time"]),
+			windowHours: z.number().int().nonnegative().optional()
+		},
+		handler: async (input, context, extra) => {
+			return (await context.createClient({ siteId: siteId(input) }, extra)).analytics.funnels.create({
+				id: asOptionalString(input, "id"),
+				name: asString(input, "name"),
+				steps: input.steps,
+				windowMode: input.windowMode,
+				windowHours: asOptionalNumber(input, "windowHours")
+			});
+		}
+	},
+	{
+		name: "neopress_analytics_funnel_update",
+		title: "Update Analytics Funnel",
+		description: "Replace a saved funnel definition with its ordered event steps and window semantics.",
+		inputSchema: {
+			...siteIdShape,
+			funnelId: z.string().uuid(),
+			name: z.string(),
+			steps: z.array(z.object({
+				eventId: z.string().uuid(),
+				path: z.string().optional(),
+				filter: z.unknown().optional()
+			})),
+			windowMode: z.enum(["session", "time"]),
+			windowHours: z.number().int().nonnegative().optional()
+		},
+		handler: async (input, context, extra) => {
+			return (await context.createClient({ siteId: siteId(input) }, extra)).analytics.funnels.update(asString(input, "funnelId"), {
+				name: asString(input, "name"),
+				steps: input.steps,
+				windowMode: input.windowMode,
+				windowHours: asOptionalNumber(input, "windowHours")
+			});
+		}
+	},
+	{
+		name: "neopress_analytics_funnel_delete",
+		title: "Delete Analytics Funnel",
+		description: "Permanently delete a saved analytics funnel.",
+		inputSchema: {
+			...siteIdShape,
+			funnelId: z.string().uuid()
+		},
+		handler: async (input, context, extra) => {
+			await (await context.createClient({ siteId: siteId(input) }, extra)).analytics.funnels.delete(asString(input, "funnelId"));
+			return { ok: true };
+		}
+	},
+	{
+		name: "neopress_analytics_targets_list",
+		title: "List Analytics Event Targets",
+		description: "List site pages and forms available as analytics event targets.",
+		inputSchema: siteIdShape,
+		handler: async (input, context, extra) => {
+			return (await context.createClient({ siteId: siteId(input) }, extra)).analytics.targets();
+		}
+	},
 	{
 		name: "neopress_analytics_query",
 		title: "Query Analytics Pipe",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neopress/mcp",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "Neopress MCP server for first-party AI agents",
   "type": "module",
   "bin": {