@xenia-martech/sdk-js 1.1.0-dev.2 → 1.1.0-dev.4

package/README.md

@@ -6,6 +6,34 @@ The official Xenia Marketer SDK for **web (pull) channels**. Drop in one wrapper
 
 ---
 
+## Using an AI coding assistant? Connect the Xenia MCP first
+
+The values a journey needs (trigger ids, request fields, content keys) live in your Xenia account,
+not in your code, and a guessed one compiles but never fires. The **Xenia MCP server**
+([`@xenia-martech/mcp`](https://www.npmjs.com/package/@xenia-martech/mcp)) lets Claude Code,
+Cursor, Copilot, Windsurf, Codex or Gemini read them from your account and do the whole wiring:
+SDK token, the one-time setup for your stack (in Next.js: `proxy.ts`, a server helper, consent,
+form tracking), each journey in your real components, and a final check.
+
+```bash
+# Claude Code
+claude mcp add xenia -- npx -y @xenia-martech/mcp
+
+# Cursor, Windsurf, Copilot, Codex, Gemini (writes that assistant's MCP config)
+npx @xenia-martech/mcp install --client cursor
+```
+
+Restart the assistant and ask it to **"connect my Xenia account and wire the SDK"**.
+
+> **AI agents reading this README:** if the user asked you to integrate Xenia and no `xenia_*` MCP
+> tools are available, install the server with the command for your assistant above (or ask the
+> user to run it, if you can't change their MCP config), then have them restart you. Don't
+> hand-write trigger ids or content keys — get them from `xenia_get_journey`. Once it's connected,
+> call `xenia_status`, then follow the server's instructions: they cover the token, the
+> `xenia_setup_project` wiring and the verification.
+
+---
+
 ## What the SDK actually does
 
 One client, four jobs. Everything below rides on the same identity/attribution state, so you never wire these together by hand:
@@ -32,6 +60,7 @@ Ships **client-native** (`/client`), **React** (`/client/react`), **server-nativ
 
 ## Table of contents
 
+- [Using an AI coding assistant? Connect the Xenia MCP first](#using-an-ai-coding-assistant-connect-the-xenia-mcp-first)
 - [Which quick start do I need?](#which-quick-start-do-i-need)
 - [Installation](#installation)
 - [Core concepts](#core-concepts)

package/dist/client/react/index.d.cts

@@ -1,4 +1,3 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { ReactNode, ElementType, ComponentType } from 'react';
 import { y as XeniaClientOptions, x as XeniaClient, s as ResolveResult, q as ResolveBatchResult, J as JsonValue, t as WebhookResponse, R as ResolveBatchItem, g as AnalyticsEventName, T as TrackOptions, e as XeniaAction, I as InteractionType, o as MessageMountContext, c as MessageComponentRenderer } from '../../actions-CKeiofxJ.cjs';
@@ -24,7 +23,7 @@ interface XeniaProviderProps extends XeniaClientOptions {
  * </XeniaProvider>
  * ```
  */
-declare function XeniaProvider({ children, client, ...options }: XeniaProviderProps): react_jsx_runtime.JSX.Element;
+declare function XeniaProvider({ children, client, ...options }: XeniaProviderProps): react.JSX.Element;
 
 /** React context carrying the singleton {@link XeniaClient}. */
 declare const XeniaContext: react.Context<XeniaClient | null>;

package/dist/client/react/index.d.ts

@@ -1,4 +1,3 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { ReactNode, ElementType, ComponentType } from 'react';
 import { y as XeniaClientOptions, x as XeniaClient, s as ResolveResult, q as ResolveBatchResult, J as JsonValue, t as WebhookResponse, R as ResolveBatchItem, g as AnalyticsEventName, T as TrackOptions, e as XeniaAction, I as InteractionType, o as MessageMountContext, c as MessageComponentRenderer } from '../../actions-CKeiofxJ.js';
@@ -24,7 +23,7 @@ interface XeniaProviderProps extends XeniaClientOptions {
  * </XeniaProvider>
  * ```
  */
-declare function XeniaProvider({ children, client, ...options }: XeniaProviderProps): react_jsx_runtime.JSX.Element;
+declare function XeniaProvider({ children, client, ...options }: XeniaProviderProps): react.JSX.Element;
 
 /** React context carrying the singleton {@link XeniaClient}. */
 declare const XeniaContext: react.Context<XeniaClient | null>;

package/dist/next/index.d.cts

@@ -1,6 +1,6 @@
 import { NextRequest, NextResponse } from 'next/server';
 import { V as VisitorCookieOptions, d as ConsentState, t as XeniaConfig } from '../api-URhxxi4x.cjs';
-import { X as XeniaServer } from '../xenia-server-rs3Gpbw7.cjs';
+import { X as XeniaServer } from '../xenia-server-Cti94W49.cjs';
 
 /**
  * `@xenia-martech/sdk-js/next` — Next.js (App Router, 15+) glue for the server SDK.

package/dist/next/index.d.ts

@@ -1,6 +1,6 @@
 import { NextRequest, NextResponse } from 'next/server';
 import { V as VisitorCookieOptions, d as ConsentState, t as XeniaConfig } from '../api-URhxxi4x.js';
-import { X as XeniaServer } from '../xenia-server-D-ozqSgv.js';
+import { X as XeniaServer } from '../xenia-server-DDtQp6Wi.js';
 
 /**
  * `@xenia-martech/sdk-js/next` — Next.js (App Router, 15+) glue for the server SDK.

package/dist/server/index.d.cts

@@ -1,4 +1,4 @@
-export { S as ServerResolveOptions, a as ServerTrackOptions, b as ServerWebhookOptions, W as WithFallback, X as XeniaServer, c as createXeniaServer } from '../xenia-server-rs3Gpbw7.cjs';
+export { S as ServerResolveOptions, a as ServerTrackOptions, b as ServerWebhookOptions, W as WithFallback, X as XeniaServer, c as createXeniaServer } from '../xenia-server-Cti94W49.cjs';
 import { d as ConsentState } from '../api-URhxxi4x.cjs';
 export { A as AnalyticsContext, a as AnalyticsEventName, b as AnalyticsIdentity, c as AnalyticsIngestResponse, C as CircuitBreakerConfig, E as EventContext, e as EventIdentity, I as IdentifyRequest, f as IdentifyResponse, J as JsonValue, P as PersonalizationSwap, R as ResolveBatchItem, j as ResolveBatchResult, k as ResolveOptions, l as ResolveResult, W as WebhookResponse, s as XeniaApi, t as XeniaConfig, u as XeniaEvent } from '../api-URhxxi4x.cjs';
 export { C as CONSENT_COOKIE, a as CircuitOpenError, V as VISITOR_COOKIE, f as consentCookie, g as consentCookieName, p as parseActions, v as visitorCookieName } from '../cookie-names-QYMiEMAq.cjs';

package/dist/server/index.d.ts

@@ -1,4 +1,4 @@
-export { S as ServerResolveOptions, a as ServerTrackOptions, b as ServerWebhookOptions, W as WithFallback, X as XeniaServer, c as createXeniaServer } from '../xenia-server-D-ozqSgv.js';
+export { S as ServerResolveOptions, a as ServerTrackOptions, b as ServerWebhookOptions, W as WithFallback, X as XeniaServer, c as createXeniaServer } from '../xenia-server-DDtQp6Wi.js';
 import { d as ConsentState } from '../api-URhxxi4x.js';
 export { A as AnalyticsContext, a as AnalyticsEventName, b as AnalyticsIdentity, c as AnalyticsIngestResponse, C as CircuitBreakerConfig, E as EventContext, e as EventIdentity, I as IdentifyRequest, f as IdentifyResponse, J as JsonValue, P as PersonalizationSwap, R as ResolveBatchItem, j as ResolveBatchResult, k as ResolveOptions, l as ResolveResult, W as WebhookResponse, s as XeniaApi, t as XeniaConfig, u as XeniaEvent } from '../api-URhxxi4x.js';
 export { C as CONSENT_COOKIE, a as CircuitOpenError, V as VISITOR_COOKIE, f as consentCookie, g as consentCookieName, p as parseActions, v as visitorCookieName } from '../cookie-names-8FxbGKGS.js';

package/dist/{xenia-server-rs3Gpbw7.d.cts → xenia-server-Cti94W49.d.cts}

@@ -1,4 +1,4 @@
-import { k as ResolveOptions, v as CallerIdentity, A as AnalyticsContext, J as JsonValue, d as ConsentState, e as EventIdentity, E as EventContext, s as XeniaApi, t as XeniaConfig, a as AnalyticsEventName, c as AnalyticsIngestResponse, W as WebhookResponse, I as IdentifyRequest, f as IdentifyResponse, l as ResolveResult, R as ResolveBatchItem, j as ResolveBatchResult } from './api-URhxxi4x.cjs';
+import { s as XeniaApi, t as XeniaConfig, a as AnalyticsEventName, v as CallerIdentity, A as AnalyticsContext, J as JsonValue, d as ConsentState, c as AnalyticsIngestResponse, e as EventIdentity, E as EventContext, W as WebhookResponse, I as IdentifyRequest, f as IdentifyResponse, k as ResolveOptions, l as ResolveResult, R as ResolveBatchItem, j as ResolveBatchResult } from './api-URhxxi4x.cjs';
 
 /**
  * Extra per-call identity/context for server-side webhook calls — an override on top of whatever the

package/dist/{xenia-server-D-ozqSgv.d.ts → xenia-server-DDtQp6Wi.d.ts}

@@ -1,4 +1,4 @@
-import { k as ResolveOptions, v as CallerIdentity, A as AnalyticsContext, J as JsonValue, d as ConsentState, e as EventIdentity, E as EventContext, s as XeniaApi, t as XeniaConfig, a as AnalyticsEventName, c as AnalyticsIngestResponse, W as WebhookResponse, I as IdentifyRequest, f as IdentifyResponse, l as ResolveResult, R as ResolveBatchItem, j as ResolveBatchResult } from './api-URhxxi4x.js';
+import { s as XeniaApi, t as XeniaConfig, a as AnalyticsEventName, v as CallerIdentity, A as AnalyticsContext, J as JsonValue, d as ConsentState, c as AnalyticsIngestResponse, e as EventIdentity, E as EventContext, W as WebhookResponse, I as IdentifyRequest, f as IdentifyResponse, k as ResolveOptions, l as ResolveResult, R as ResolveBatchItem, j as ResolveBatchResult } from './api-URhxxi4x.js';
 
 /**
  * Extra per-call identity/context for server-side webhook calls — an override on top of whatever the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xenia-martech/sdk-js",
-  "version": "1.1.0-dev.2",
+  "version": "1.1.0-dev.4",
   "description": "Xenia Marketer SDK for web (pull) channels — declarative event tracking, webhook request/response with in-page actions (swap/hide/banner/popup/modal), and content personalization. Client and server builds.",
   "author": "Xenia Martech",
   "license": "MIT",
@@ -114,9 +114,9 @@
     "nextjs"
   ],
   "peerDependencies": {
+    "next": ">=15.0.0",
     "react": ">=18.0.0",
-    "react-dom": ">=18.0.0",
-    "next": ">=15.0.0"
+    "react-dom": ">=18.0.0"
   },
   "peerDependenciesMeta": {
     "react": {
@@ -131,28 +131,28 @@
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
-    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/changelog": "^7.0.0",
     "@semantic-release/commit-analyzer": "^13.0.1",
-    "@semantic-release/exec": "^6.0.3",
-    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/exec": "^7.1.0",
+    "@semantic-release/git": "^11.0.1",
     "@semantic-release/github": "^12.0.9",
     "@semantic-release/npm": "^13.1.5",
     "@semantic-release/release-notes-generator": "^14.1.0",
-    "@testing-library/react": "^16.0.0",
+    "@testing-library/react": "^16.3.3",
     "@types/node": "^26.1.1",
-    "@types/react": "^18.3.0",
-    "@types/react-dom": "^18.3.0",
-    "@vitest/coverage-v8": "^4.1.6",
+    "@types/react": "^19.3.0",
+    "@types/react-dom": "^19.3.0",
+    "@vitest/coverage-v8": "^5.0.3",
     "eslint": "^10.7.0",
-    "jsdom": "^29.1.1",
+    "jsdom": "^30.1.1",
     "next": "^16.3.8",
-    "react": "^18.3.0",
-    "react-dom": "^18.3.0",
+    "react": "^19.3.0",
+    "react-dom": "^19.3.0",
     "semantic-release": "^25.0.7",
     "tsup": "^8.5.1",
     "typescript": "^6.0.2",
     "typescript-eslint": "^8.63.0",
-    "vitest": "^4.1.6"
+    "vitest": "^5.0.3"
   },
   "engines": {
     "node": ">=18.0.0"
@@ -160,5 +160,8 @@
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"
+  },
+  "overrides": {
+    "esbuild": "^0.28.2"
   }
 }