@sitecore-content-sdk/nextjs 2.4.0 → 2.4.1-canary.20260910091702

package/dist/cjs/cache/sitecore-cache-tags.js

@@ -50,16 +50,13 @@ function buildSitecoreRouteCacheTag(params) {
 }
 /**
  * Tag for a layout/route item (and anything else keyed the same way). Use for item-level invalidation.
- * @param {BuildSitecoreItemCacheTagParams} params - Item id, locale, and optional published version.
+ * @param {BuildSitecoreItemCacheTagParams} params - Item id and locale.
  * @internal
  */
 function buildSitecoreItemCacheTag(params) {
     const id = normalizeSitecoreItemIdForCacheTag(params.itemId);
     const locale = sanitizeSitecoreCacheTagSegment(params.locale);
-    const ver = params.version !== undefined && Number.isFinite(params.version)
-        ? `v${Math.trunc(params.version)}`
-        : 'latest';
-    return `${exports.SITECORE_CONTENT_CACHE_TAG_PREFIX}:item:${id}:${locale}:${ver}`;
+    return `${exports.SITECORE_CONTENT_CACHE_TAG_PREFIX}:item:${id}:${locale}`;
 }
 /**
  * Tag for dictionary data scoped to site + locale.
@@ -97,7 +94,7 @@ function buildSitecoreDictionaryCacheTagsFromSites(params) {
  * Prefers `itemLanguage` from Sitecore when set; otherwise uses `fallbackLocale`.
  * Accepts the same `RouteData` shape returned by the layout service (e.g. `page.layout.sitecore.route`,
  * which is `RouteData | null`) or `undefined` when the page did not resolve.
- * @param {RouteData | null | undefined} route - Route node from layout (item id, language, version).
+ * @param {RouteData | null | undefined} route - Route node from layout (item id and language).
  * @param {string} fallbackLocale - Locale used when `route.itemLanguage` is not set.
  * @returns `null` when `route` is missing or `route.itemId` is not set.
  * @internal
@@ -110,10 +107,7 @@ function buildSitecoreItemCacheTagFromRouteData(route, fallbackLocale) {
         ? sanitizeSitecoreCacheTagSegment(route.itemLanguage)
         : sanitizeSitecoreCacheTagSegment(fallbackLocale);
     const id = normalizeSitecoreItemIdForCacheTag(route.itemId);
-    const ver = route.itemVersion !== undefined && Number.isFinite(route.itemVersion)
-        ? `v${Math.trunc(route.itemVersion)}`
-        : 'latest';
-    return `${exports.SITECORE_CONTENT_CACHE_TAG_PREFIX}:item:${id}:${locale}:${ver}`;
+    return `${exports.SITECORE_CONTENT_CACHE_TAG_PREFIX}:item:${id}:${locale}`;
 }
 /**
  * Deduplicates tag strings while preserving first-seen order.

package/dist/cjs/route-handler/sitecore-revalidate-route-handler.js

@@ -28,11 +28,11 @@ function resolveConfiguredRevalidateSecret(secretOption, envValue) {
  * The body is expected to be a JSON object that resolves to at least one Sitecore cache tag:
  *
  * - **`updates[]`** — Sitecore publish-event rows. Each row's `identifier` (with `-media` / `-layout`
- *   suffix stripped) maps to an `sc:item:<id>:<locale>:latest` tag, using `entity_culture` for locale
+ *   suffix stripped) maps to an `sc:item:<id>:<locale>` tag, using `entity_culture` for locale
  *   (falling back to the handler's `defaultLocale`).
  * - **`tags[]`** — pass-through and convenience array:
  *   - Strings already starting with `sc:` are used verbatim (e.g. `sc:route:...`, `sc:item:...`, `sc:dict:...`).
- *   - Bare values are treated as Sitecore item ids and mapped to `sc:item:<id>:<defaultLocale>:latest`.
+ *   - Bare values are treated as Sitecore item ids and mapped to `sc:item:<id>:<defaultLocale>`.
  *
  * When **`sites`** is configured, the handler also appends one `sc:dict:<site>:<locale>` tag per
  * site so dictionary updates flow through the same call.

package/dist/esm/cache/sitecore-cache-tags.js

@@ -39,16 +39,13 @@ export function buildSitecoreRouteCacheTag(params) {
 }
 /**
  * Tag for a layout/route item (and anything else keyed the same way). Use for item-level invalidation.
- * @param {BuildSitecoreItemCacheTagParams} params - Item id, locale, and optional published version.
+ * @param {BuildSitecoreItemCacheTagParams} params - Item id and locale.
  * @internal
  */
 export function buildSitecoreItemCacheTag(params) {
     const id = normalizeSitecoreItemIdForCacheTag(params.itemId);
     const locale = sanitizeSitecoreCacheTagSegment(params.locale);
-    const ver = params.version !== undefined && Number.isFinite(params.version)
-        ? `v${Math.trunc(params.version)}`
-        : 'latest';
-    return `${SITECORE_CONTENT_CACHE_TAG_PREFIX}:item:${id}:${locale}:${ver}`;
+    return `${SITECORE_CONTENT_CACHE_TAG_PREFIX}:item:${id}:${locale}`;
 }
 /**
  * Tag for dictionary data scoped to site + locale.
@@ -86,7 +83,7 @@ export function buildSitecoreDictionaryCacheTagsFromSites(params) {
  * Prefers `itemLanguage` from Sitecore when set; otherwise uses `fallbackLocale`.
  * Accepts the same `RouteData` shape returned by the layout service (e.g. `page.layout.sitecore.route`,
  * which is `RouteData | null`) or `undefined` when the page did not resolve.
- * @param {RouteData | null | undefined} route - Route node from layout (item id, language, version).
+ * @param {RouteData | null | undefined} route - Route node from layout (item id and language).
  * @param {string} fallbackLocale - Locale used when `route.itemLanguage` is not set.
  * @returns `null` when `route` is missing or `route.itemId` is not set.
  * @internal
@@ -99,10 +96,7 @@ export function buildSitecoreItemCacheTagFromRouteData(route, fallbackLocale) {
         ? sanitizeSitecoreCacheTagSegment(route.itemLanguage)
         : sanitizeSitecoreCacheTagSegment(fallbackLocale);
     const id = normalizeSitecoreItemIdForCacheTag(route.itemId);
-    const ver = route.itemVersion !== undefined && Number.isFinite(route.itemVersion)
-        ? `v${Math.trunc(route.itemVersion)}`
-        : 'latest';
-    return `${SITECORE_CONTENT_CACHE_TAG_PREFIX}:item:${id}:${locale}:${ver}`;
+    return `${SITECORE_CONTENT_CACHE_TAG_PREFIX}:item:${id}:${locale}`;
 }
 /**
  * Deduplicates tag strings while preserving first-seen order.

package/dist/esm/route-handler/sitecore-revalidate-route-handler.js

@@ -22,11 +22,11 @@ function resolveConfiguredRevalidateSecret(secretOption, envValue) {
  * The body is expected to be a JSON object that resolves to at least one Sitecore cache tag:
  *
  * - **`updates[]`** — Sitecore publish-event rows. Each row's `identifier` (with `-media` / `-layout`
- *   suffix stripped) maps to an `sc:item:<id>:<locale>:latest` tag, using `entity_culture` for locale
+ *   suffix stripped) maps to an `sc:item:<id>:<locale>` tag, using `entity_culture` for locale
  *   (falling back to the handler's `defaultLocale`).
  * - **`tags[]`** — pass-through and convenience array:
  *   - Strings already starting with `sc:` are used verbatim (e.g. `sc:route:...`, `sc:item:...`, `sc:dict:...`).
- *   - Bare values are treated as Sitecore item ids and mapped to `sc:item:<id>:<defaultLocale>:latest`.
+ *   - Bare values are treated as Sitecore item ids and mapped to `sc:item:<id>:<defaultLocale>`.
  *
  * When **`sites`** is configured, the handler also appends one `sc:dict:<site>:<locale>` tag per
  * site so dictionary updates flow through the same call.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sitecore-content-sdk/nextjs",
-  "version": "2.4.0",
+  "version": "2.4.1-canary.20260910091702",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
   "sideEffects": false,

package/types/cache/sitecore-cache-tags.d.ts

@@ -44,14 +44,10 @@ export declare function buildSitecoreRouteCacheTag(params: BuildSitecoreRouteCac
 export type BuildSitecoreItemCacheTagParams = {
     itemId: string;
     locale: string;
-    /**
-     * Published version number, or omit / `undefined` for "latest".
-     */
-    version?: number;
 };
 /**
  * Tag for a layout/route item (and anything else keyed the same way). Use for item-level invalidation.
- * @param {BuildSitecoreItemCacheTagParams} params - Item id, locale, and optional published version.
+ * @param {BuildSitecoreItemCacheTagParams} params - Item id and locale.
  * @internal
  */
 export declare function buildSitecoreItemCacheTag(params: BuildSitecoreItemCacheTagParams): string;
@@ -93,7 +89,7 @@ export declare function buildSitecoreDictionaryCacheTagsFromSites(params: BuildS
  * Prefers `itemLanguage` from Sitecore when set; otherwise uses `fallbackLocale`.
  * Accepts the same `RouteData` shape returned by the layout service (e.g. `page.layout.sitecore.route`,
  * which is `RouteData | null`) or `undefined` when the page did not resolve.
- * @param {RouteData | null | undefined} route - Route node from layout (item id, language, version).
+ * @param {RouteData | null | undefined} route - Route node from layout (item id and language).
  * @param {string} fallbackLocale - Locale used when `route.itemLanguage` is not set.
  * @returns `null` when `route` is missing or `route.itemId` is not set.
  * @internal

package/types/cache/sitecore-cache-tags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sitecore-cache-tags.d.ts","sourceRoot":"","sources":["../../src/cache/sitecore-cache-tags.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AAEtE;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,OAAO,CAAC;AAEtD;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKrE;AAED;;;;GAIG;AACH,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED;;;GAGG;AACH,MAAM,MAAM,gCAAgC,GAAG;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,gCAAgC,GAAG,MAAM,CAM3F;AAED;;;GAGG;AACH,MAAM,MAAM,+BAA+B,GAAG;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,+BAA+B,GAAG,MAAM,CAQzF;AAED;;;GAGG;AACH,MAAM,MAAM,qCAAqC,GAAG;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,qCAAqC,GAC5C,MAAM,CAIR;AAED;;;GAGG;AACH,MAAM,MAAM,+CAA+C,GAAG;IAC5D,uDAAuD;IACvD,KAAK,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACtD,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,yCAAyC,CACvD,MAAM,EAAE,+CAA+C,GACtD,MAAM,EAAE,CAcV;AAED;;;;;;;;;GASG;AACH,wBAAgB,sCAAsC,CACpD,KAAK,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,EACnC,cAAc,EAAE,MAAM,GACrB,MAAM,GAAG,IAAI,CAaf;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAUhE"}
+{"version":3,"file":"sitecore-cache-tags.d.ts","sourceRoot":"","sources":["../../src/cache/sitecore-cache-tags.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AAEtE;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,OAAO,CAAC;AAEtD;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKrE;AAED;;;;GAIG;AACH,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED;;;GAGG;AACH,MAAM,MAAM,gCAAgC,GAAG;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,gCAAgC,GAAG,MAAM,CAM3F;AAED;;;GAGG;AACH,MAAM,MAAM,+BAA+B,GAAG;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,+BAA+B,GAAG,MAAM,CAIzF;AAED;;;GAGG;AACH,MAAM,MAAM,qCAAqC,GAAG;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,qCAAqC,GAC5C,MAAM,CAIR;AAED;;;GAGG;AACH,MAAM,MAAM,+CAA+C,GAAG;IAC5D,uDAAuD;IACvD,KAAK,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACtD,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,yCAAyC,CACvD,MAAM,EAAE,+CAA+C,GACtD,MAAM,EAAE,CAcV;AAED;;;;;;;;;GASG;AACH,wBAAgB,sCAAsC,CACpD,KAAK,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,EACnC,cAAc,EAAE,MAAM,GACrB,MAAM,GAAG,IAAI,CASf;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAUhE"}

package/types/cache/sitecore-page-cache-tags.d.ts

@@ -12,8 +12,8 @@ export type CollectSitecorePageCacheTagsParams = {
     path?: string;
     /**
      * Route node from a Sitecore layout response (e.g. `page.layout.sitecore.route`, which is
-     * `RouteData | null`). Optional because the page may not resolve; only `itemId`, `itemLanguage`,
-     * and `itemVersion` are read when present.
+     * `RouteData | null`). Optional because the page may not resolve; only `itemId` and `itemLanguage`
+     * are read when present.
      */
     route?: RouteData | null;
 };

package/types/route-handler/sitecore-revalidate-route-handler.d.ts

@@ -41,11 +41,11 @@ export type SitecoreRevalidateRouteHandlerOptions = {
  * The body is expected to be a JSON object that resolves to at least one Sitecore cache tag:
  *
  * - **`updates[]`** — Sitecore publish-event rows. Each row's `identifier` (with `-media` / `-layout`
- *   suffix stripped) maps to an `sc:item:<id>:<locale>:latest` tag, using `entity_culture` for locale
+ *   suffix stripped) maps to an `sc:item:<id>:<locale>` tag, using `entity_culture` for locale
  *   (falling back to the handler's `defaultLocale`).
  * - **`tags[]`** — pass-through and convenience array:
  *   - Strings already starting with `sc:` are used verbatim (e.g. `sc:route:...`, `sc:item:...`, `sc:dict:...`).
- *   - Bare values are treated as Sitecore item ids and mapped to `sc:item:<id>:<defaultLocale>:latest`.
+ *   - Bare values are treated as Sitecore item ids and mapped to `sc:item:<id>:<defaultLocale>`.
  *
  * When **`sites`** is configured, the handler also appends one `sc:dict:<site>:<locale>` tag per
  * site so dictionary updates flow through the same call.