@se-studio/ab-testing 18.0.30 → 18.0.32

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @se-studio/ab-testing
 
+## 18.0.32
+
+### Patch Changes
+
+- Map page-test homepage canonical paths (`/`) to CMS slug `index` so control `indexed` is used instead of the variant's `noindex`.
+- Updated dependencies
+  - @se-studio/core-ui@1.35.1
+
+## 18.0.31
+
+### Patch Changes
+
+- Updated dependencies [e746884]
+  - @se-studio/core-ui@1.35.0
+
 ## 18.0.30
 
 ### Patch Changes

package/README.md

@@ -159,9 +159,9 @@ export const config = {
 
 #### Page-test route (static rebuild pattern)
 
-When using `createStaticAbTestMiddleware` with `variantPathPrefix: '/page-test'`, add a `/page-test/[...slugs]` route that rewrites serve variant content on the control URL. Use `findCanonicalPath(testsByPath, variantSlug)` to resolve the user-facing path, then call the paired handlers from `@se-studio/core-ui/server`:
+When using `createStaticAbTestMiddleware` with `variantPathPrefix: '/page-test'`, add a `/page-test/[...slugs]` route that rewrites serve variant content on the control URL. Use `findCanonicalPath(testsByPath, variantSlug)` to resolve the user-facing path, then `controlSlugFromCanonicalPath(canonicalPath)` for the control CMS slug (`/` → `index`). Do **not** use `canonicalPath.replace(/^\/|\/$/g, '') || variantSlug` — that maps the homepage to the variant (`indexed: false`) and flip-flops robots. Then call the paired handlers from `@se-studio/core-ui/server`:
 
-- `generatePageTestMetadata` — control `indexed` and canonical path in `<head>`
+- `generatePageTestMetadata` — control `indexed` and canonical path in `<head>` (re-resolves `/` to `index` even if the caller still passes the variant slug)
 - `generatePageTest` — variant body with control identity for breadcrumbs, `href`, and JSON-LD
 
 See the `se-marketing-sites-create-page` skill for the full route template. Direct visits to a variant's own CMS URL (normal page route) should keep using `generatePage`.

package/dist/index.d.ts

@@ -11,7 +11,7 @@ export type { AbTestMiddlewareConfig, AbTestResult, CachedAbTest, StaticAbTestMi
 export { applyUrlParams, buildVariantId, clearTestCache, computeCachedTest, createAbTestMiddleware, createAssignment, createStaticAbTestMiddleware, DEFAULT_COOKIE_MAX_AGE, DEFAULT_COOKIE_NAME, getActiveTestIds, getAssignment, getCachedTests, getTestCacheState, isValidAssignment, normalizePath, parseCookie, processAbTestRequest, pruneStaleAssignments, readCookieFromDocument, selectVariant, serializeCookie, setAssignment, } from './middleware/index.js';
 export { buildExperimentImpression } from './reporting/buildExperimentImpression.js';
 export type { AbTest, AbTestAssignment, AbTestCookie, AbTestVariant, AbTestVariantConfig, IBlobStore, } from './types.js';
-export { findCanonicalPath } from './utils.js';
+export { CMS_HOMEPAGE_SLUG, controlSlugFromCanonicalPath, findCanonicalPath } from './utils.js';
 export type { RawPageTest, WebhookHandlerConfig, WebhookResult, } from './webhook/index.js';
 export { createWebhookHandler, normalizeVariantConfig, processAbTestWebhook, transformPageTest, } from './webhook/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EAAE,sBAAsB,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAE5F,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,YAAY,EACV,sBAAsB,EACtB,YAAY,EACZ,YAAY,EACZ,6BAA6B,EAC7B,UAAU,GACX,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,cAAc,EACd,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,4BAA4B,EAC5B,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,aAAa,EACb,eAAe,EACf,aAAa,GACd,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AAErF,YAAY,EACV,MAAM,EACN,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,YAAY,EACV,WAAW,EACX,oBAAoB,EACpB,aAAa,GACd,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EAAE,sBAAsB,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAE5F,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,YAAY,EACV,sBAAsB,EACtB,YAAY,EACZ,YAAY,EACZ,6BAA6B,EAC7B,UAAU,GACX,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,cAAc,EACd,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,4BAA4B,EAC5B,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,aAAa,EACb,eAAe,EACf,aAAa,GACd,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AAErF,YAAY,EACV,MAAM,EACN,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,iBAAiB,EAAE,4BAA4B,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAChG,YAAY,EACV,WAAW,EACX,oBAAoB,EACpB,aAAa,GACd,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -11,7 +11,7 @@ export { useAbTestAssignments } from './hooks/index.js';
 export { applyUrlParams, buildVariantId, clearTestCache, computeCachedTest, createAbTestMiddleware, createAssignment, createStaticAbTestMiddleware, DEFAULT_COOKIE_MAX_AGE, DEFAULT_COOKIE_NAME, getActiveTestIds, getAssignment, getCachedTests, getTestCacheState, isValidAssignment, normalizePath, parseCookie, processAbTestRequest, pruneStaleAssignments, readCookieFromDocument, selectVariant, serializeCookie, setAssignment, } from './middleware/index.js';
 export { buildExperimentImpression } from './reporting/buildExperimentImpression.js';
 // Utilities
-export { findCanonicalPath } from './utils.js';
+export { CMS_HOMEPAGE_SLUG, controlSlugFromCanonicalPath, findCanonicalPath } from './utils.js';
 // Re-export webhook utilities
 export { createWebhookHandler, normalizeVariantConfig, processAbTestWebhook, transformPageTest, } from './webhook/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,kBAAkB;AAClB,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAQxD,iCAAiC;AACjC,OAAO,EACL,cAAc,EACd,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,4BAA4B,EAC5B,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,aAAa,EACb,eAAe,EACf,aAAa,GACd,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AAUrF,YAAY;AACZ,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAM/C,8BAA8B;AAC9B,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,kBAAkB;AAClB,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAQxD,iCAAiC;AACjC,OAAO,EACL,cAAc,EACd,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,4BAA4B,EAC5B,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,aAAa,EACb,eAAe,EACf,aAAa,GACd,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AAUrF,YAAY;AACZ,OAAO,EAAE,iBAAiB,EAAE,4BAA4B,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAMhG,8BAA8B;AAC9B,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC"}

package/dist/utils.d.ts

@@ -1,4 +1,20 @@
 import type { CachedAbTest } from './middleware/types';
+/** CMS slug for the marketing homepage on SE Studio sites (public URL `/`). */
+export declare const CMS_HOMEPAGE_SLUG = "index";
+/**
+ * Map a public canonical path to the Contentful page slug used to fetch the
+ * PageTest **control**.
+ *
+ * Empty / root paths (`/`, `""`) map to {@link CMS_HOMEPAGE_SLUG} (`index`).
+ * Do **not** fall back to the variant slug: variants are `indexed: false`, so
+ * `canonicalPath.replace(/^\/|\/$/g, '') || variantSlug` noindexes `/`.
+ *
+ * Sites whose homepage CMS slug is not `index` (e.g. Pedestal `home`) should
+ * pass that slug as `homepageSlug`.
+ *
+ * Keep in sync with `@se-studio/core-ui` `controlSlugFromCanonicalPath`.
+ */
+export declare function controlSlugFromCanonicalPath(canonicalPath: string, homepageSlug?: string): string;
 /**
  * Given a testsByPath map and a variant slug, returns the canonical
  * (user-facing) path that owns the variant.

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,EAC3C,WAAW,EAAE,MAAM,GAClB,MAAM,GAAG,SAAS,CASpB"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,+EAA+E;AAC/E,eAAO,MAAM,iBAAiB,UAAU,CAAC;AAEzC;;;;;;;;;;;;GAYG;AACH,wBAAgB,4BAA4B,CAC1C,aAAa,EAAE,MAAM,EACrB,YAAY,GAAE,MAA0B,GACvC,MAAM,CAER;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,EAC3C,WAAW,EAAE,MAAM,GAClB,MAAM,GAAG,SAAS,CASpB"}

package/dist/utils.js

@@ -1,3 +1,21 @@
+/** CMS slug for the marketing homepage on SE Studio sites (public URL `/`). */
+export const CMS_HOMEPAGE_SLUG = 'index';
+/**
+ * Map a public canonical path to the Contentful page slug used to fetch the
+ * PageTest **control**.
+ *
+ * Empty / root paths (`/`, `""`) map to {@link CMS_HOMEPAGE_SLUG} (`index`).
+ * Do **not** fall back to the variant slug: variants are `indexed: false`, so
+ * `canonicalPath.replace(/^\/|\/$/g, '') || variantSlug` noindexes `/`.
+ *
+ * Sites whose homepage CMS slug is not `index` (e.g. Pedestal `home`) should
+ * pass that slug as `homepageSlug`.
+ *
+ * Keep in sync with `@se-studio/core-ui` `controlSlugFromCanonicalPath`.
+ */
+export function controlSlugFromCanonicalPath(canonicalPath, homepageSlug = CMS_HOMEPAGE_SLUG) {
+    return canonicalPath.replace(/^\/+|\/+$/g, '') || homepageSlug;
+}
 /**
  * Given a testsByPath map and a variant slug, returns the canonical
  * (user-facing) path that owns the variant.

package/dist/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAC/B,WAA2C,EAC3C,WAAmB;IAEnB,KAAK,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QAC/D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,EAAE,CAAC;gBACtD,OAAO,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW,GAAG,CAAC;YACrE,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAEA,+EAA+E;AAC/E,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAO,CAAC;AAEzC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,4BAA4B,CAC1C,aAAqB,EACrB,YAAY,GAAW,iBAAiB;IAExC,OAAO,aAAa,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,IAAI,YAAY,CAAC;AACjE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAC/B,WAA2C,EAC3C,WAAmB;IAEnB,KAAK,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QAC/D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,EAAE,CAAC;gBACtD,OAAO,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW,GAAG,CAAC;YACrE,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/docs/llms.md

@@ -96,11 +96,12 @@ import {
 
 ```ts
 import {
-  selectVariant,       // weighted random variant selection
-  getAssignment,       // read assignment from cookies
-  setAssignment,       // write assignment to response cookies
-  isValidAssignment,   // validate an assignment object
-  normalizePath,       // normalise URL paths for comparison
-  findCanonicalPath,   // resolve variant path back to canonical
+  selectVariant, // weighted random variant selection
+  getAssignment, // read assignment from cookies
+  setAssignment, // write assignment to response cookies
+  isValidAssignment, // validate an assignment object
+  normalizePath, // normalise URL paths for comparison
+  findCanonicalPath, // resolve variant path back to canonical
+  controlSlugFromCanonicalPath, // `/` → CMS slug `index` (never the variant)
 } from '@se-studio/ab-testing';
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@se-studio/ab-testing",
-  "version": "18.0.30",
+  "version": "18.0.32",
   "description": "Server-side A/B testing framework for Next.js applications with Contentful CMS",
   "repository": {
     "type": "git",
@@ -67,13 +67,13 @@
     "url": "https://github.com/Something-Else-Studio/se-core-product/issues"
   },
   "peerDependencies": {
-    "@se-studio/core-ui": "1.34.0",
+    "@se-studio/core-ui": "1.35.1",
     "next": ">=15.5.0 <17",
     "react": "^19.0.0"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.5.12",
-    "@se-studio/core-ui": "1.34.0",
+    "@se-studio/core-ui": "1.35.1",
     "@types/node": "^24.13.3",
     "@types/react": "^19.2.18",
     "next": "^16.3.4",