@sitecore-content-sdk/nextjs 2.4.1-canary.20260910100657 → 2.4.1

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

@@ -6,7 +6,6 @@ exports.normalizeSitecoreItemIdForCacheTag = normalizeSitecoreItemIdForCacheTag;
 exports.buildSitecoreRouteCacheTag = buildSitecoreRouteCacheTag;
 exports.buildSitecoreItemCacheTag = buildSitecoreItemCacheTag;
 exports.buildSitecoreDictionaryCacheTag = buildSitecoreDictionaryCacheTag;
-exports.buildSitecoreDictionaryCacheTagsFromSites = buildSitecoreDictionaryCacheTagsFromSites;
 exports.buildSitecoreItemCacheTagFromRouteData = buildSitecoreItemCacheTagFromRouteData;
 exports.dedupeSitecoreCacheTags = dedupeSitecoreCacheTags;
 /**
@@ -28,12 +27,20 @@ function sanitizeSitecoreCacheTagSegment(value) {
         .replace(/[/:\s]+/g, '_');
 }
 /**
- * Normalizes a Sitecore item GUID for use in cache tags (lowercase, no braces).
+ * Normalizes a Sitecore item GUID for use in cache tags.
+ * Lowercases, strips braces, and canonicalizes 32-character hex GUIDs to hyphenated form
+ * so layout-service ids (`{guid}`) and Experience Edge identifiers (`GUID` without hyphens)
+ * produce the same `sc:item:` tag.
  * @param {string} itemId - Sitecore item id or GUID string.
  * @internal
  */
 function normalizeSitecoreItemIdForCacheTag(itemId) {
-    return itemId.trim().toLowerCase().replace(/[{}]/g, '');
+    const cleaned = itemId.trim().toLowerCase().replace(/[{}]/g, '');
+    const hex = cleaned.replace(/-/g, '');
+    if (/^[0-9a-f]{32}$/.test(hex)) {
+        return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+    }
+    return cleaned;
 }
 /**
  * Tag for a resolved route (site + language + logical path). Use for URL-level invalidation.
@@ -68,27 +75,6 @@ function buildSitecoreDictionaryCacheTag(params) {
     const locale = sanitizeSitecoreCacheTagSegment(params.locale);
     return `${exports.SITECORE_CONTENT_CACHE_TAG_PREFIX}:dict:${site}:${locale}`;
 }
-/**
- * Builds deduplicated dictionary cache tags from a sites list.
- * @param {BuildSitecoreDictionaryCacheTagsFromSitesParams} params - Sites list and fallback locale.
- * @internal
- */
-function buildSitecoreDictionaryCacheTagsFromSites(params) {
-    var _a;
-    const seen = new Set();
-    const out = [];
-    const push = (tag) => {
-        if (!seen.has(tag)) {
-            seen.add(tag);
-            out.push(tag);
-        }
-    };
-    for (const site of params.sites) {
-        const locale = ((_a = site.language) === null || _a === void 0 ? void 0 : _a.trim()) ? site.language : params.baseLocale;
-        push(buildSitecoreDictionaryCacheTag({ site: site.name, locale }));
-    }
-    return out;
-}
 /**
  * Builds an item cache tag from Sitecore layout route data when `itemId` is present.
  * Prefers `itemLanguage` from Sitecore when set; otherwise uses `fallbackLocale`.

package/dist/cjs/cache/sitecore-edge-webhook-revalidation.js

@@ -1,8 +1,14 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.extractSitecoreEdgeContentId = extractSitecoreEdgeContentId;
+exports.isSitecoreDictionaryEntryUpdate = isSitecoreDictionaryEntryUpdate;
+exports.resolveSitecoreDictionarySiteNameFromIdentifier = resolveSitecoreDictionarySiteNameFromIdentifier;
 exports.collectSitecoreTagsFromEdgeRevalidateRequestBody = collectSitecoreTagsFromEdgeRevalidateRequestBody;
 const sitecore_cache_tags_1 = require("./sitecore-cache-tags");
+const debug_1 = __importDefault(require("../debug"));
 /**
  * Strips Experience Edge style suffixes from an `identifier` so the value can be used as an item id in cache tags.
  * Handles `{GUID}`, `{GUID}-media`, `{GUID}-layout` style strings.
@@ -16,51 +22,99 @@ function extractSitecoreEdgeContentId(identifier) {
     const trimmed = identifier.trim();
     return trimmed.replace(/-(?:media|layout)$/i, '');
 }
-const FULL_TAG_PREFIX = `${sitecore_cache_tags_1.SITECORE_CONTENT_CACHE_TAG_PREFIX}:`;
 /**
- * @param {string} value - Candidate tag string from a webhook body.
- * @returns True when `value` is already a full `sc:` content cache tag.
+ * `entity_definition` value Experience Edge sends for Dictionary entry updates. This is the literal value Experience Edge sends.
+ * @internal
+ */
+const DICTIONARY_ENTRY_ENTITY_DEFINITION = 'DictionaryEntry';
+/**
+ * Whether a webhook update row is a Dictionary entry change (`entity_definition: "DictionaryEntry"`).
+ * @param {string} [entityDefinition] - `entity_definition` from a webhook update row.
+ * @internal
+ */
+function isSitecoreDictionaryEntryUpdate(entityDefinition) {
+    return entityDefinition === DICTIONARY_ENTRY_ENTITY_DEFINITION;
+}
+/**
+ * Resolves which configured site a Dictionary entry webhook `identifier` belongs to.
+ *
+ * Dictionary identifiers follow `<site name>-<dictionary folder id>-<value>-<language>`, but the
+ * folder id, value, and language segments can themselves contain hyphens (and the value can contain
+ * spaces), so splitting the identifier on `-` is not reliable. Instead this matches the identifier
+ * against the known configured site names, preferring the longest name so a more specific name wins
+ * over a shorter overlapping one (e.g. `my-site-2` over `my-site`).
+ * @param {string} identifier - Raw `identifier` from a Dictionary entry update row.
+ * @param {string[]} siteNames - Configured site names (e.g. from `.sitecore/sites.json`).
+ * @returns The matched site name, or `undefined` when no configured site name prefixes `identifier`.
+ * @internal
+ */
+function resolveSitecoreDictionarySiteNameFromIdentifier(identifier, siteNames) {
+    const normalized = identifier.trim().toLowerCase();
+    if (!normalized) {
+        return undefined;
+    }
+    return matchSitecoreDictionarySiteName(normalized, sortSiteNamesByLengthDesc(siteNames));
+}
+/**
+ * Sorts site names longest-first, for {@link matchSitecoreDictionarySiteName}.
+ * @param {string[]} siteNames - Configured site names.
+ * @internal
  */
-function isFullSitecoreContentCacheTag(value) {
-    return value.startsWith(FULL_TAG_PREFIX);
+function sortSiteNamesByLengthDesc(siteNames) {
+    return [...siteNames].sort((a, b) => b.length - a.length);
+}
+/**
+ * Matches a normalized (trimmed, lowercased) identifier against site names already sorted
+ * longest-first. Split out of {@link resolveSitecoreDictionarySiteNameFromIdentifier} so a request
+ * with many Dictionary entry updates in one payload sorts `siteNames` once instead of per update.
+ * @param {string} normalizedIdentifier - Identifier, already trimmed and lowercased.
+ * @param {string[]} siteNamesByLengthDesc - Site names sorted longest-first.
+ * @internal
+ */
+function matchSitecoreDictionarySiteName(normalizedIdentifier, siteNamesByLengthDesc) {
+    for (const siteName of siteNamesByLengthDesc) {
+        const prefix = `${siteName.trim().toLowerCase()}-`;
+        if (prefix.length > 1 && normalizedIdentifier.startsWith(prefix)) {
+            return siteName;
+        }
+    }
+    return undefined;
 }
 /**
  * Maps an Experience Edge webhook JSON body to Content SDK cache tag strings used by
  * {@link collectSitecorePageCacheTags} / {@link buildSitecoreItemCacheTag} (`sc:item:...`), so
  * `revalidateTag` matches tags registered during cached reads.
- * **`updates`** rows resolve to **`sc:item:…`** (locale from `entity_culture` or `defaultLocale`). **`tags`**: full `sc:` strings pass through; bare ids become **`sc:item:…`** with `defaultLocale`. Route/variant tags are not inferred.
- * @param {SitecoreEdgeRevalidateRequestBody | null | undefined} body - Webhook JSON body (tags and/or updates).
- * @param {CollectSitecoreTagsFromEdgeBodyOptions} options - Default locale when culture is missing on an update or bare tag.
+ * **`updates`** rows resolve to **`sc:item:…`** (locale from `entity_culture` or `defaultLocale`), except
+ * rows where `entity_definition` is `"DictionaryEntry"`, which resolve to **`sc:dict:…`** scoped to the
+ * site resolved from the identifier (see {@link resolveSitecoreDictionarySiteNameFromIdentifier}) and the
+ * same locale. Route/variant tags are not inferred.
+ * @param {SitecoreEdgeRevalidateRequestBody | null | undefined} body - Webhook JSON body (updates).
+ * @param {CollectSitecoreTagsFromEdgeBodyOptions} options - Default locale, and site names for Dictionary entry updates.
  * @internal
  */
 function collectSitecoreTagsFromEdgeRevalidateRequestBody(body, options) {
     var _a, _b, _c, _d;
-    const { defaultLocale } = options;
+    const { defaultLocale, siteNames = [] } = options;
+    const siteNamesByLengthDesc = sortSiteNamesByLengthDesc(siteNames);
     const out = [];
-    for (const raw of (_a = body === null || body === void 0 ? void 0 : body.tags) !== null && _a !== void 0 ? _a : []) {
-        if (typeof raw !== 'string') {
-            continue;
-        }
-        const s = raw.trim();
-        if (!s) {
-            continue;
-        }
-        if (isFullSitecoreContentCacheTag(s)) {
-            out.push(s);
-        }
-        else {
-            const id = extractSitecoreEdgeContentId(s);
-            if (id) {
-                out.push((0, sitecore_cache_tags_1.buildSitecoreItemCacheTag)({ itemId: id, locale: defaultLocale }));
+    for (const u of (_a = body === null || body === void 0 ? void 0 : body.updates) !== null && _a !== void 0 ? _a : []) {
+        const locale = ((_b = u === null || u === void 0 ? void 0 : u.entity_culture) === null || _b === void 0 ? void 0 : _b.trim()) || defaultLocale;
+        if (isSitecoreDictionaryEntryUpdate(u === null || u === void 0 ? void 0 : u.entity_definition)) {
+            const identifier = ((_c = u === null || u === void 0 ? void 0 : u.identifier) !== null && _c !== void 0 ? _c : '').trim().toLowerCase();
+            const site = identifier
+                ? matchSitecoreDictionarySiteName(identifier, siteNamesByLengthDesc)
+                : undefined;
+            if (!site) {
+                debug_1.default.revalidate('could not resolve site for Dictionary entry identifier %o, skipping', identifier);
+                continue;
             }
+            out.push((0, sitecore_cache_tags_1.buildSitecoreDictionaryCacheTag)({ site, locale }));
+            continue;
         }
-    }
-    for (const u of (_b = body === null || body === void 0 ? void 0 : body.updates) !== null && _b !== void 0 ? _b : []) {
-        const id = extractSitecoreEdgeContentId((_c = u === null || u === void 0 ? void 0 : u.identifier) !== null && _c !== void 0 ? _c : '');
+        const id = extractSitecoreEdgeContentId((_d = u === null || u === void 0 ? void 0 : u.identifier) !== null && _d !== void 0 ? _d : '');
         if (!id) {
             continue;
         }
-        const locale = ((_d = u === null || u === void 0 ? void 0 : u.entity_culture) === null || _d === void 0 ? void 0 : _d.trim()) || defaultLocale;
         out.push((0, sitecore_cache_tags_1.buildSitecoreItemCacheTag)({ itemId: id, locale }));
     }
     return (0, sitecore_cache_tags_1.dedupeSitecoreCacheTags)(out).filter(Boolean);

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

@@ -27,8 +27,8 @@ function routeSegmentsFromPathname(pathname) {
  * `buildSitecoreDictionaryCacheTag` on a dedicated `use cache` helper).
  *
  * Registers **`sc:route:…`** and **`sc:item:…`** (when layout has `itemId`). Edge-style webhooks emit
- * item ids, which the Sitecore revalidate route handler maps to **`sc:item:…`**; route tags are only
- * invalidated when callers send the full `sc:route:…` strings in the `tags[]` array of the same revalidate request.
+ * item ids, which the Sitecore revalidate route handler maps to **`sc:item:…`**; route tags are not
+ * invalidated by that webhook flow.
  *
  * Personalization variants are isolated naturally by URL path (each variant rewrite yields a distinct
  * Cache Components key) so no `sc:pvv:…` tag is added here. If a personalize-specific webhook is wired

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

@@ -29,27 +29,21 @@ function resolveConfiguredRevalidateSecret(secretOption, envValue) {
  *
  * - **`updates[]`** — Sitecore publish-event rows. Each row's `identifier` (with `-media` / `-layout`
  *   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>`.
- *
- * When **`sites`** is configured, the handler also appends one `sc:dict:<site>:<locale>` tag per
- * site so dictionary updates flow through the same call.
+ *   (falling back to the handler's `defaultLocale`) — except rows where `entity_definition` is
+ *   `"DictionaryEntry"`, which map to `sc:dict:<site>:<locale>` for the site resolved from the
+ *   identifier via the configured **`sites`** option (skipped, with a debug log, when no configured
+ *   site matches). Only updates that are actually Dictionary changes revalidate dictionary tags — a
+ *   webhook for an unrelated item never touches them.
  *
  * Auth (optional): when `SITECORE_REVALIDATE_SECRET` (or the `secret` option) is non-empty, callers must
  * send the same value in the **`x-revalidate-secret`** header. When unset or blank, no header is required.
- * @param {SitecoreRevalidateRouteHandlerOptions} [options] - Optional inline `secret`, `cacheProfile`, locale, sites, and dictionary options.
+ * @param {SitecoreRevalidateRouteHandlerOptions} [options] - Optional inline `secret`, `cacheProfile`, locale, and sites options.
  * @public
  */
 function createSitecoreRevalidateRouteHandler(options = {}) {
+    var _a;
     const { defaultLocale = 'en', sites, secret, cacheProfile = 'max' } = options;
-    const dictionaryTags = sites !== undefined
-        ? (0, sitecore_cache_tags_1.buildSitecoreDictionaryCacheTagsFromSites)({
-            sites,
-            baseLocale: defaultLocale,
-        })
-        : [];
+    const siteNames = (_a = sites === null || sites === void 0 ? void 0 : sites.map((site) => site.name)) !== null && _a !== void 0 ? _a : [];
     const POST = async (req) => {
         var _a, _b, _c, _d, _e, _f, _g, _h;
         const startTimestamp = Date.now();
@@ -82,18 +76,13 @@ function createSitecoreRevalidateRouteHandler(options = {}) {
                 invocation_id: (_a = webhookBody.invocation_id) !== null && _a !== void 0 ? _a : null,
                 continues: (_b = webhookBody.continues) !== null && _b !== void 0 ? _b : false,
                 updatesCount: (_d = (_c = webhookBody.updates) === null || _c === void 0 ? void 0 : _c.length) !== null && _d !== void 0 ? _d : 0,
-                tagsCount: Array.isArray(webhookBody.tags) ? webhookBody.tags.length : 0,
-                dictionaryTagsCount: dictionaryTags.length,
                 defaultLocale,
             });
-            const tags = (0, sitecore_cache_tags_1.dedupeSitecoreCacheTags)([
-                ...(0, sitecore_edge_webhook_revalidation_1.collectSitecoreTagsFromEdgeRevalidateRequestBody)(webhookBody, { defaultLocale }),
-                ...dictionaryTags,
-            ]);
+            const tags = (0, sitecore_cache_tags_1.dedupeSitecoreCacheTags)((0, sitecore_edge_webhook_revalidation_1.collectSitecoreTagsFromEdgeRevalidateRequestBody)(webhookBody, { defaultLocale, siteNames }));
             if (tags.length === 0) {
                 debug_1.default.revalidate('sitecore revalidate: no tags resolved in %dms', Date.now() - startTimestamp);
                 return server_1.NextResponse.json({
-                    error: 'Provide non-empty `updates` (with identifiers) and/or `tags` that resolve to at least one cache tag.',
+                    error: 'Provide non-empty `updates` (with identifiers) that resolve to at least one cache tag.',
                 }, { status: 400 });
             }
             for (const tag of tags) {

package/dist/cjs/tools/generate-map.js

@@ -35,6 +35,7 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateMap = exports.defaultClientMapTemplate = exports.defaultServerMapTemplate = void 0;
 const tools_1 = require("@sitecore-content-sdk/content/tools");
+const node_tools_1 = require("@sitecore-content-sdk/content/node-tools");
 const path = __importStar(require("path"));
 const fs = __importStar(require("fs"));
 const utils_1 = require("./templating/utils");
@@ -74,10 +75,10 @@ const isComponentMapTemplate = (fn) => fn.length === 2;
 // Default App Router (server) component map template
 const defaultServerMapTemplate = (components, componentImports, ctx) => {
     var _a, _b;
-    const entries = (_a = ctx === null || ctx === void 0 ? void 0 : ctx.entries) !== null && _a !== void 0 ? _a : (0, tools_1.prepareComponentsForMap)(components, {
+    const entries = (_a = ctx === null || ctx === void 0 ? void 0 : ctx.entries) !== null && _a !== void 0 ? _a : (0, node_tools_1.prepareComponentsForMap)(components, {
         includeVariants: (_b = ctx === null || ctx === void 0 ? void 0 : ctx.includeVariants) !== null && _b !== void 0 ? _b : true,
     });
-    return (0, tools_1.buildComponentMapContent)(entries, componentImports, {
+    return (0, node_tools_1.buildComponentMapContent)(entries, componentImports, {
         framework: 'nextjs',
         isClientMap: false,
         builtInImports: APP_ROUTER_BUILTIN_IMPORTS,
@@ -88,11 +89,11 @@ exports.defaultServerMapTemplate = defaultServerMapTemplate;
 // Default client-safe component map template for App Router
 const defaultClientMapTemplate = (components, componentImports, ctx) => {
     var _a, _b;
-    const entries = (_a = ctx === null || ctx === void 0 ? void 0 : ctx.entries) !== null && _a !== void 0 ? _a : (0, tools_1.prepareComponentsForMap)(components, {
+    const entries = (_a = ctx === null || ctx === void 0 ? void 0 : ctx.entries) !== null && _a !== void 0 ? _a : (0, node_tools_1.prepareComponentsForMap)(components, {
         includeVariants: (_b = ctx === null || ctx === void 0 ? void 0 : ctx.includeVariants) !== null && _b !== void 0 ? _b : true,
         shouldAnnotateClient: true,
     });
-    return (0, tools_1.buildComponentMapContent)(entries, componentImports, {
+    return (0, node_tools_1.buildComponentMapContent)(entries, componentImports, {
         framework: 'nextjs',
         headerComment: 'Client-safe component map for App Router',
         isClientMap: true,
@@ -112,7 +113,7 @@ const collectComponents = (opts) => {
     }
     return {
         raw: filtered,
-        entries: (0, tools_1.prepareComponentsForMap)(filtered, {
+        entries: (0, node_tools_1.prepareComponentsForMap)(filtered, {
             includeVariants: opts.includeVariants,
             shouldAnnotateClient: true,
         }),
@@ -153,7 +154,7 @@ const generateMap = ({ paths, destination = '.sitecore', exclude, componentImpor
                 includeVariants,
                 isClientMap: false,
             })
-            : (0, tools_1.buildComponentMapContent)(allComponents.entries, componentImports, {
+            : (0, node_tools_1.buildComponentMapContent)(allComponents.entries, componentImports, {
                 framework: 'nextjs',
                 isClientMap: false,
                 builtInImports: PAGES_ROUTER_BUILTIN_IMPORTS,

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

@@ -17,12 +17,20 @@ export function sanitizeSitecoreCacheTagSegment(value) {
         .replace(/[/:\s]+/g, '_');
 }
 /**
- * Normalizes a Sitecore item GUID for use in cache tags (lowercase, no braces).
+ * Normalizes a Sitecore item GUID for use in cache tags.
+ * Lowercases, strips braces, and canonicalizes 32-character hex GUIDs to hyphenated form
+ * so layout-service ids (`{guid}`) and Experience Edge identifiers (`GUID` without hyphens)
+ * produce the same `sc:item:` tag.
  * @param {string} itemId - Sitecore item id or GUID string.
  * @internal
  */
 export function normalizeSitecoreItemIdForCacheTag(itemId) {
-    return itemId.trim().toLowerCase().replace(/[{}]/g, '');
+    const cleaned = itemId.trim().toLowerCase().replace(/[{}]/g, '');
+    const hex = cleaned.replace(/-/g, '');
+    if (/^[0-9a-f]{32}$/.test(hex)) {
+        return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+    }
+    return cleaned;
 }
 /**
  * Tag for a resolved route (site + language + logical path). Use for URL-level invalidation.
@@ -57,27 +65,6 @@ export function buildSitecoreDictionaryCacheTag(params) {
     const locale = sanitizeSitecoreCacheTagSegment(params.locale);
     return `${SITECORE_CONTENT_CACHE_TAG_PREFIX}:dict:${site}:${locale}`;
 }
-/**
- * Builds deduplicated dictionary cache tags from a sites list.
- * @param {BuildSitecoreDictionaryCacheTagsFromSitesParams} params - Sites list and fallback locale.
- * @internal
- */
-export function buildSitecoreDictionaryCacheTagsFromSites(params) {
-    var _a;
-    const seen = new Set();
-    const out = [];
-    const push = (tag) => {
-        if (!seen.has(tag)) {
-            seen.add(tag);
-            out.push(tag);
-        }
-    };
-    for (const site of params.sites) {
-        const locale = ((_a = site.language) === null || _a === void 0 ? void 0 : _a.trim()) ? site.language : params.baseLocale;
-        push(buildSitecoreDictionaryCacheTag({ site: site.name, locale }));
-    }
-    return out;
-}
 /**
  * Builds an item cache tag from Sitecore layout route data when `itemId` is present.
  * Prefers `itemLanguage` from Sitecore when set; otherwise uses `fallbackLocale`.

package/dist/esm/cache/sitecore-edge-webhook-revalidation.js

@@ -1,4 +1,5 @@
-import { SITECORE_CONTENT_CACHE_TAG_PREFIX, buildSitecoreItemCacheTag, dedupeSitecoreCacheTags, } from './sitecore-cache-tags';
+import { buildSitecoreDictionaryCacheTag, buildSitecoreItemCacheTag, dedupeSitecoreCacheTags, } from './sitecore-cache-tags';
+import debug from '../debug';
 /**
  * Strips Experience Edge style suffixes from an `identifier` so the value can be used as an item id in cache tags.
  * Handles `{GUID}`, `{GUID}-media`, `{GUID}-layout` style strings.
@@ -12,51 +13,99 @@ export function extractSitecoreEdgeContentId(identifier) {
     const trimmed = identifier.trim();
     return trimmed.replace(/-(?:media|layout)$/i, '');
 }
-const FULL_TAG_PREFIX = `${SITECORE_CONTENT_CACHE_TAG_PREFIX}:`;
 /**
- * @param {string} value - Candidate tag string from a webhook body.
- * @returns True when `value` is already a full `sc:` content cache tag.
+ * `entity_definition` value Experience Edge sends for Dictionary entry updates. This is the literal value Experience Edge sends.
+ * @internal
+ */
+const DICTIONARY_ENTRY_ENTITY_DEFINITION = 'DictionaryEntry';
+/**
+ * Whether a webhook update row is a Dictionary entry change (`entity_definition: "DictionaryEntry"`).
+ * @param {string} [entityDefinition] - `entity_definition` from a webhook update row.
+ * @internal
+ */
+export function isSitecoreDictionaryEntryUpdate(entityDefinition) {
+    return entityDefinition === DICTIONARY_ENTRY_ENTITY_DEFINITION;
+}
+/**
+ * Resolves which configured site a Dictionary entry webhook `identifier` belongs to.
+ *
+ * Dictionary identifiers follow `<site name>-<dictionary folder id>-<value>-<language>`, but the
+ * folder id, value, and language segments can themselves contain hyphens (and the value can contain
+ * spaces), so splitting the identifier on `-` is not reliable. Instead this matches the identifier
+ * against the known configured site names, preferring the longest name so a more specific name wins
+ * over a shorter overlapping one (e.g. `my-site-2` over `my-site`).
+ * @param {string} identifier - Raw `identifier` from a Dictionary entry update row.
+ * @param {string[]} siteNames - Configured site names (e.g. from `.sitecore/sites.json`).
+ * @returns The matched site name, or `undefined` when no configured site name prefixes `identifier`.
+ * @internal
+ */
+export function resolveSitecoreDictionarySiteNameFromIdentifier(identifier, siteNames) {
+    const normalized = identifier.trim().toLowerCase();
+    if (!normalized) {
+        return undefined;
+    }
+    return matchSitecoreDictionarySiteName(normalized, sortSiteNamesByLengthDesc(siteNames));
+}
+/**
+ * Sorts site names longest-first, for {@link matchSitecoreDictionarySiteName}.
+ * @param {string[]} siteNames - Configured site names.
+ * @internal
  */
-function isFullSitecoreContentCacheTag(value) {
-    return value.startsWith(FULL_TAG_PREFIX);
+function sortSiteNamesByLengthDesc(siteNames) {
+    return [...siteNames].sort((a, b) => b.length - a.length);
+}
+/**
+ * Matches a normalized (trimmed, lowercased) identifier against site names already sorted
+ * longest-first. Split out of {@link resolveSitecoreDictionarySiteNameFromIdentifier} so a request
+ * with many Dictionary entry updates in one payload sorts `siteNames` once instead of per update.
+ * @param {string} normalizedIdentifier - Identifier, already trimmed and lowercased.
+ * @param {string[]} siteNamesByLengthDesc - Site names sorted longest-first.
+ * @internal
+ */
+function matchSitecoreDictionarySiteName(normalizedIdentifier, siteNamesByLengthDesc) {
+    for (const siteName of siteNamesByLengthDesc) {
+        const prefix = `${siteName.trim().toLowerCase()}-`;
+        if (prefix.length > 1 && normalizedIdentifier.startsWith(prefix)) {
+            return siteName;
+        }
+    }
+    return undefined;
 }
 /**
  * Maps an Experience Edge webhook JSON body to Content SDK cache tag strings used by
  * {@link collectSitecorePageCacheTags} / {@link buildSitecoreItemCacheTag} (`sc:item:...`), so
  * `revalidateTag` matches tags registered during cached reads.
- * **`updates`** rows resolve to **`sc:item:…`** (locale from `entity_culture` or `defaultLocale`). **`tags`**: full `sc:` strings pass through; bare ids become **`sc:item:…`** with `defaultLocale`. Route/variant tags are not inferred.
- * @param {SitecoreEdgeRevalidateRequestBody | null | undefined} body - Webhook JSON body (tags and/or updates).
- * @param {CollectSitecoreTagsFromEdgeBodyOptions} options - Default locale when culture is missing on an update or bare tag.
+ * **`updates`** rows resolve to **`sc:item:…`** (locale from `entity_culture` or `defaultLocale`), except
+ * rows where `entity_definition` is `"DictionaryEntry"`, which resolve to **`sc:dict:…`** scoped to the
+ * site resolved from the identifier (see {@link resolveSitecoreDictionarySiteNameFromIdentifier}) and the
+ * same locale. Route/variant tags are not inferred.
+ * @param {SitecoreEdgeRevalidateRequestBody | null | undefined} body - Webhook JSON body (updates).
+ * @param {CollectSitecoreTagsFromEdgeBodyOptions} options - Default locale, and site names for Dictionary entry updates.
  * @internal
  */
 export function collectSitecoreTagsFromEdgeRevalidateRequestBody(body, options) {
     var _a, _b, _c, _d;
-    const { defaultLocale } = options;
+    const { defaultLocale, siteNames = [] } = options;
+    const siteNamesByLengthDesc = sortSiteNamesByLengthDesc(siteNames);
     const out = [];
-    for (const raw of (_a = body === null || body === void 0 ? void 0 : body.tags) !== null && _a !== void 0 ? _a : []) {
-        if (typeof raw !== 'string') {
-            continue;
-        }
-        const s = raw.trim();
-        if (!s) {
-            continue;
-        }
-        if (isFullSitecoreContentCacheTag(s)) {
-            out.push(s);
-        }
-        else {
-            const id = extractSitecoreEdgeContentId(s);
-            if (id) {
-                out.push(buildSitecoreItemCacheTag({ itemId: id, locale: defaultLocale }));
+    for (const u of (_a = body === null || body === void 0 ? void 0 : body.updates) !== null && _a !== void 0 ? _a : []) {
+        const locale = ((_b = u === null || u === void 0 ? void 0 : u.entity_culture) === null || _b === void 0 ? void 0 : _b.trim()) || defaultLocale;
+        if (isSitecoreDictionaryEntryUpdate(u === null || u === void 0 ? void 0 : u.entity_definition)) {
+            const identifier = ((_c = u === null || u === void 0 ? void 0 : u.identifier) !== null && _c !== void 0 ? _c : '').trim().toLowerCase();
+            const site = identifier
+                ? matchSitecoreDictionarySiteName(identifier, siteNamesByLengthDesc)
+                : undefined;
+            if (!site) {
+                debug.revalidate('could not resolve site for Dictionary entry identifier %o, skipping', identifier);
+                continue;
             }
+            out.push(buildSitecoreDictionaryCacheTag({ site, locale }));
+            continue;
         }
-    }
-    for (const u of (_b = body === null || body === void 0 ? void 0 : body.updates) !== null && _b !== void 0 ? _b : []) {
-        const id = extractSitecoreEdgeContentId((_c = u === null || u === void 0 ? void 0 : u.identifier) !== null && _c !== void 0 ? _c : '');
+        const id = extractSitecoreEdgeContentId((_d = u === null || u === void 0 ? void 0 : u.identifier) !== null && _d !== void 0 ? _d : '');
         if (!id) {
             continue;
         }
-        const locale = ((_d = u === null || u === void 0 ? void 0 : u.entity_culture) === null || _d === void 0 ? void 0 : _d.trim()) || defaultLocale;
         out.push(buildSitecoreItemCacheTag({ itemId: id, locale }));
     }
     return dedupeSitecoreCacheTags(out).filter(Boolean);

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

@@ -24,8 +24,8 @@ function routeSegmentsFromPathname(pathname) {
  * `buildSitecoreDictionaryCacheTag` on a dedicated `use cache` helper).
  *
  * Registers **`sc:route:…`** and **`sc:item:…`** (when layout has `itemId`). Edge-style webhooks emit
- * item ids, which the Sitecore revalidate route handler maps to **`sc:item:…`**; route tags are only
- * invalidated when callers send the full `sc:route:…` strings in the `tags[]` array of the same revalidate request.
+ * item ids, which the Sitecore revalidate route handler maps to **`sc:item:…`**; route tags are not
+ * invalidated by that webhook flow.
  *
  * Personalization variants are isolated naturally by URL path (each variant rewrite yields a distinct
  * Cache Components key) so no `sc:pvv:…` tag is added here. If a personalize-specific webhook is wired

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

@@ -1,5 +1,5 @@
 import { collectSitecoreTagsFromEdgeRevalidateRequestBody, } from '../cache/sitecore-edge-webhook-revalidation';
-import { buildSitecoreDictionaryCacheTagsFromSites, dedupeSitecoreCacheTags } from '../cache/sitecore-cache-tags';
+import { dedupeSitecoreCacheTags } from '../cache/sitecore-cache-tags';
 import debug from '../debug';
 import { revalidateTag } from 'next/cache';
 import { NextResponse } from 'next/server';
@@ -23,27 +23,21 @@ function resolveConfiguredRevalidateSecret(secretOption, envValue) {
  *
  * - **`updates[]`** — Sitecore publish-event rows. Each row's `identifier` (with `-media` / `-layout`
  *   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>`.
- *
- * When **`sites`** is configured, the handler also appends one `sc:dict:<site>:<locale>` tag per
- * site so dictionary updates flow through the same call.
+ *   (falling back to the handler's `defaultLocale`) — except rows where `entity_definition` is
+ *   `"DictionaryEntry"`, which map to `sc:dict:<site>:<locale>` for the site resolved from the
+ *   identifier via the configured **`sites`** option (skipped, with a debug log, when no configured
+ *   site matches). Only updates that are actually Dictionary changes revalidate dictionary tags — a
+ *   webhook for an unrelated item never touches them.
  *
  * Auth (optional): when `SITECORE_REVALIDATE_SECRET` (or the `secret` option) is non-empty, callers must
  * send the same value in the **`x-revalidate-secret`** header. When unset or blank, no header is required.
- * @param {SitecoreRevalidateRouteHandlerOptions} [options] - Optional inline `secret`, `cacheProfile`, locale, sites, and dictionary options.
+ * @param {SitecoreRevalidateRouteHandlerOptions} [options] - Optional inline `secret`, `cacheProfile`, locale, and sites options.
  * @public
  */
 export function createSitecoreRevalidateRouteHandler(options = {}) {
+    var _a;
     const { defaultLocale = 'en', sites, secret, cacheProfile = 'max' } = options;
-    const dictionaryTags = sites !== undefined
-        ? buildSitecoreDictionaryCacheTagsFromSites({
-            sites,
-            baseLocale: defaultLocale,
-        })
-        : [];
+    const siteNames = (_a = sites === null || sites === void 0 ? void 0 : sites.map((site) => site.name)) !== null && _a !== void 0 ? _a : [];
     const POST = async (req) => {
         var _a, _b, _c, _d, _e, _f, _g, _h;
         const startTimestamp = Date.now();
@@ -76,18 +70,13 @@ export function createSitecoreRevalidateRouteHandler(options = {}) {
                 invocation_id: (_a = webhookBody.invocation_id) !== null && _a !== void 0 ? _a : null,
                 continues: (_b = webhookBody.continues) !== null && _b !== void 0 ? _b : false,
                 updatesCount: (_d = (_c = webhookBody.updates) === null || _c === void 0 ? void 0 : _c.length) !== null && _d !== void 0 ? _d : 0,
-                tagsCount: Array.isArray(webhookBody.tags) ? webhookBody.tags.length : 0,
-                dictionaryTagsCount: dictionaryTags.length,
                 defaultLocale,
             });
-            const tags = dedupeSitecoreCacheTags([
-                ...collectSitecoreTagsFromEdgeRevalidateRequestBody(webhookBody, { defaultLocale }),
-                ...dictionaryTags,
-            ]);
+            const tags = dedupeSitecoreCacheTags(collectSitecoreTagsFromEdgeRevalidateRequestBody(webhookBody, { defaultLocale, siteNames }));
             if (tags.length === 0) {
                 debug.revalidate('sitecore revalidate: no tags resolved in %dms', Date.now() - startTimestamp);
                 return NextResponse.json({
-                    error: 'Provide non-empty `updates` (with identifiers) and/or `tags` that resolve to at least one cache tag.',
+                    error: 'Provide non-empty `updates` (with identifiers) that resolve to at least one cache tag.',
                 }, { status: 400 });
             }
             for (const tag of tags) {

package/dist/esm/tools/generate-map.js

@@ -1,4 +1,5 @@
-import { filterComponentsByType, prepareComponentsForMap, buildComponentMapContent, } from '@sitecore-content-sdk/content/tools';
+import { filterComponentsByType, } from '@sitecore-content-sdk/content/tools';
+import { prepareComponentsForMap, buildComponentMapContent, } from '@sitecore-content-sdk/content/node-tools';
 import * as path from 'path';
 import * as fs from 'fs';
 import { detectRouterType, getComponentListWithTypes, ROUTER_TYPE } from './templating/utils';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sitecore-content-sdk/nextjs",
-  "version": "2.4.1-canary.20260910100657",
+  "version": "2.4.1",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
   "sideEffects": false,
@@ -90,10 +90,10 @@
   },
   "dependencies": {
     "@babel/parser": "^7.27.2",
-    "@sitecore-content-sdk/content": "2.3.1-canary.20260910100657",
+    "@sitecore-content-sdk/content": "^2.3.1",
     "@sitecore-content-sdk/core": "^2.1.4",
     "@sitecore-content-sdk/events": "^2.1.2",
-    "@sitecore-content-sdk/react": "2.4.1-canary.20260910100657",
+    "@sitecore-content-sdk/react": "^2.4.0",
     "recast": "^0.23.11",
     "regex-parser": "^2.3.1"
   },

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

@@ -13,7 +13,10 @@ export declare const SITECORE_CONTENT_CACHE_TAG_PREFIX = "sc";
  */
 export declare function sanitizeSitecoreCacheTagSegment(value: string): string;
 /**
- * Normalizes a Sitecore item GUID for use in cache tags (lowercase, no braces).
+ * Normalizes a Sitecore item GUID for use in cache tags.
+ * Lowercases, strips braces, and canonicalizes 32-character hex GUIDs to hyphenated form
+ * so layout-service ids (`{guid}`) and Experience Edge identifiers (`GUID` without hyphens)
+ * produce the same `sc:item:` tag.
  * @param {string} itemId - Sitecore item id or GUID string.
  * @internal
  */
@@ -65,25 +68,6 @@ export type BuildSitecoreDictionaryCacheTagParams = {
  * @public
  */
 export declare function buildSitecoreDictionaryCacheTag(params: BuildSitecoreDictionaryCacheTagParams): string;
-/**
- * Parameters for buildSitecoreDictionaryCacheTagsFromSites.
- * @internal
- */
-export type BuildSitecoreDictionaryCacheTagsFromSitesParams = {
-    /** Sites list (e.g. from generated multisite JSON). */
-    sites: readonly {
-        name: string;
-        language?: string;
-    }[];
-    /** Locale used when a site has no `language` value. */
-    baseLocale: string;
-};
-/**
- * Builds deduplicated dictionary cache tags from a sites list.
- * @param {BuildSitecoreDictionaryCacheTagsFromSitesParams} params - Sites list and fallback locale.
- * @internal
- */
-export declare function buildSitecoreDictionaryCacheTagsFromSites(params: BuildSitecoreDictionaryCacheTagsFromSitesParams): string[];
 /**
  * Builds an item cache tag from Sitecore layout route data when `itemId` is present.
  * Prefers `itemLanguage` from Sitecore when set; otherwise uses `fallbackLocale`.

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;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"}
+{"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;;;;;;;GAOG;AACH,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAOzE;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;;;;;;;;;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-edge-webhook-revalidation.d.ts

@@ -17,12 +17,6 @@ export type SitecoreEdgeRevalidateRequestBody = {
     invocation_id?: string;
     updates?: SitecoreEdgeRevalidateUpdate[];
     continues?: boolean;
-    /**
-     * Extra tag strings. Values starting with the Sitecore cache prefix (`sc:`) are used as-is.
-     * Bare values are treated as Sitecore item ids (with optional `-media` / `-layout` suffix stripped)
-     * and mapped to {@link buildSitecoreItemCacheTag} using the handler default locale when culture is missing.
-     */
-    tags?: string[];
 };
 /**
  * Strips Experience Edge style suffixes from an `identifier` so the value can be used as an item id in cache tags.
@@ -31,23 +25,52 @@ export type SitecoreEdgeRevalidateRequestBody = {
  * @internal
  */
 export declare function extractSitecoreEdgeContentId(identifier: string): string;
+/**
+ * Whether a webhook update row is a Dictionary entry change (`entity_definition: "DictionaryEntry"`).
+ * @param {string} [entityDefinition] - `entity_definition` from a webhook update row.
+ * @internal
+ */
+export declare function isSitecoreDictionaryEntryUpdate(entityDefinition?: string): boolean;
+/**
+ * Resolves which configured site a Dictionary entry webhook `identifier` belongs to.
+ *
+ * Dictionary identifiers follow `<site name>-<dictionary folder id>-<value>-<language>`, but the
+ * folder id, value, and language segments can themselves contain hyphens (and the value can contain
+ * spaces), so splitting the identifier on `-` is not reliable. Instead this matches the identifier
+ * against the known configured site names, preferring the longest name so a more specific name wins
+ * over a shorter overlapping one (e.g. `my-site-2` over `my-site`).
+ * @param {string} identifier - Raw `identifier` from a Dictionary entry update row.
+ * @param {string[]} siteNames - Configured site names (e.g. from `.sitecore/sites.json`).
+ * @returns The matched site name, or `undefined` when no configured site name prefixes `identifier`.
+ * @internal
+ */
+export declare function resolveSitecoreDictionarySiteNameFromIdentifier(identifier: string, siteNames: readonly string[]): string | undefined;
 /**
  * Options for {@link collectSitecoreTagsFromEdgeRevalidateRequestBody}.
  * @internal
  */
 export type CollectSitecoreTagsFromEdgeBodyOptions = {
     /**
-     * Used when an update omits `entity_culture`, and when mapping bare item ids in `tags`.
+     * Used when an update omits `entity_culture`.
      */
     defaultLocale: string;
+    /**
+     * Configured site names (e.g. from `.sitecore/sites.json`), used only to resolve which site a
+     * Dictionary entry update (`entity_definition: "DictionaryEntry"`) belongs to. When omitted (or when
+     * an identifier matches none of them), that update's Dictionary tag is skipped rather than guessed.
+     */
+    siteNames?: readonly string[];
 };
 /**
  * Maps an Experience Edge webhook JSON body to Content SDK cache tag strings used by
  * {@link collectSitecorePageCacheTags} / {@link buildSitecoreItemCacheTag} (`sc:item:...`), so
  * `revalidateTag` matches tags registered during cached reads.
- * **`updates`** rows resolve to **`sc:item:…`** (locale from `entity_culture` or `defaultLocale`). **`tags`**: full `sc:` strings pass through; bare ids become **`sc:item:…`** with `defaultLocale`. Route/variant tags are not inferred.
- * @param {SitecoreEdgeRevalidateRequestBody | null | undefined} body - Webhook JSON body (tags and/or updates).
- * @param {CollectSitecoreTagsFromEdgeBodyOptions} options - Default locale when culture is missing on an update or bare tag.
+ * **`updates`** rows resolve to **`sc:item:…`** (locale from `entity_culture` or `defaultLocale`), except
+ * rows where `entity_definition` is `"DictionaryEntry"`, which resolve to **`sc:dict:…`** scoped to the
+ * site resolved from the identifier (see {@link resolveSitecoreDictionarySiteNameFromIdentifier}) and the
+ * same locale. Route/variant tags are not inferred.
+ * @param {SitecoreEdgeRevalidateRequestBody | null | undefined} body - Webhook JSON body (updates).
+ * @param {CollectSitecoreTagsFromEdgeBodyOptions} options - Default locale, and site names for Dictionary entry updates.
  * @internal
  */
 export declare function collectSitecoreTagsFromEdgeRevalidateRequestBody(body: SitecoreEdgeRevalidateRequestBody | null | undefined, options: CollectSitecoreTagsFromEdgeBodyOptions): string[];

package/types/cache/sitecore-edge-webhook-revalidation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sitecore-edge-webhook-revalidation.d.ts","sourceRoot":"","sources":["../../src/cache/sitecore-edge-webhook-revalidation.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,MAAM,MAAM,4BAA4B,GAAG;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,iCAAiC,GAAG;IAC9C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,4BAA4B,EAAE,CAAC;IACzC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAMvE;AAYD;;;GAGG;AACH,MAAM,MAAM,sCAAsC,GAAG;IACnD;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,gDAAgD,CAC9D,IAAI,EAAE,iCAAiC,GAAG,IAAI,GAAG,SAAS,EAC1D,OAAO,EAAE,sCAAsC,GAC9C,MAAM,EAAE,CAgCV"}
+{"version":3,"file":"sitecore-edge-webhook-revalidation.d.ts","sourceRoot":"","sources":["../../src/cache/sitecore-edge-webhook-revalidation.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,MAAM,MAAM,4BAA4B,GAAG;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,iCAAiC,GAAG;IAC9C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,4BAA4B,EAAE,CAAC;IACzC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAMvE;AAQD;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,CAElF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,+CAA+C,CAC7D,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,SAAS,MAAM,EAAE,GAC3B,MAAM,GAAG,SAAS,CAMpB;AAgCD;;;GAGG;AACH,MAAM,MAAM,sCAAsC,GAAG;IACnD;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/B,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,gDAAgD,CAC9D,IAAI,EAAE,iCAAiC,GAAG,IAAI,GAAG,SAAS,EAC1D,OAAO,EAAE,sCAAsC,GAC9C,MAAM,EAAE,CAoCV"}

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

@@ -23,8 +23,8 @@ export type CollectSitecorePageCacheTagsParams = {
  * `buildSitecoreDictionaryCacheTag` on a dedicated `use cache` helper).
  *
  * Registers **`sc:route:…`** and **`sc:item:…`** (when layout has `itemId`). Edge-style webhooks emit
- * item ids, which the Sitecore revalidate route handler maps to **`sc:item:…`**; route tags are only
- * invalidated when callers send the full `sc:route:…` strings in the `tags[]` array of the same revalidate request.
+ * item ids, which the Sitecore revalidate route handler maps to **`sc:item:…`**; route tags are not
+ * invalidated by that webhook flow.
  *
  * Personalization variants are isolated naturally by URL path (each variant rewrite yields a distinct
  * Cache Components key) so no `sc:pvv:…` tag is added here. If a personalize-specific webhook is wired

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

@@ -24,13 +24,15 @@ export type SitecoreRevalidateRouteHandlerOptions = {
      */
     cacheProfile?: RevalidateTagCacheProfile;
     /**
-     * Locale for item tags when culture is missing, and for dictionary tags when a site has no language.
+     * Locale for item and dictionary tags when an update omits `entity_culture`.
      * Defaults to `'en'` when omitted.
      */
     defaultLocale?: string;
     /**
-     * Sites list (e.g. from `.sitecore/sites.json`). Adds one `sc:dict:<site>:<locale>` tag per
-     * site on every revalidation call. `generateSites` always includes the configured default site.
+     * Sites list (e.g. from `.sitecore/sites.json`), used to resolve which site a Dictionary entry
+     * update (`entity_definition: "DictionaryEntry"`) belongs to, so only that site's
+     * `sc:dict:<site>:<locale>` tag is revalidated instead of every configured site's. `generateSites`
+     * always includes the configured default site.
      */
     sites?: SiteInfo[];
 };
@@ -42,17 +44,15 @@ export type SitecoreRevalidateRouteHandlerOptions = {
  *
  * - **`updates[]`** — Sitecore publish-event rows. Each row's `identifier` (with `-media` / `-layout`
  *   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>`.
- *
- * When **`sites`** is configured, the handler also appends one `sc:dict:<site>:<locale>` tag per
- * site so dictionary updates flow through the same call.
+ *   (falling back to the handler's `defaultLocale`) — except rows where `entity_definition` is
+ *   `"DictionaryEntry"`, which map to `sc:dict:<site>:<locale>` for the site resolved from the
+ *   identifier via the configured **`sites`** option (skipped, with a debug log, when no configured
+ *   site matches). Only updates that are actually Dictionary changes revalidate dictionary tags — a
+ *   webhook for an unrelated item never touches them.
  *
  * Auth (optional): when `SITECORE_REVALIDATE_SECRET` (or the `secret` option) is non-empty, callers must
  * send the same value in the **`x-revalidate-secret`** header. When unset or blank, no header is required.
- * @param {SitecoreRevalidateRouteHandlerOptions} [options] - Optional inline `secret`, `cacheProfile`, locale, sites, and dictionary options.
+ * @param {SitecoreRevalidateRouteHandlerOptions} [options] - Optional inline `secret`, `cacheProfile`, locale, and sites options.
  * @public
  */
 export declare function createSitecoreRevalidateRouteHandler(options?: SitecoreRevalidateRouteHandlerOptions): {

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

@@ -1 +1 @@
-{"version":3,"file":"sitecore-revalidate-route-handler.d.ts","sourceRoot":"","sources":["../../src/route-handler/sitecore-revalidate-route-handler.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAmBnE;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;AAE5E;;;GAGG;AACH,MAAM,MAAM,qCAAqC,GAAG;IAClD;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,YAAY,CAAC,EAAE,yBAAyB,CAAC;IACzC;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;CACpB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,oCAAoC,CAClD,OAAO,GAAE,qCAA0C;gBAY1B,WAAW;;;;;;;;EA0FrC"}
+{"version":3,"file":"sitecore-revalidate-route-handler.d.ts","sourceRoot":"","sources":["../../src/route-handler/sitecore-revalidate-route-handler.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAmBnE;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;AAE5E;;;GAGG;AACH,MAAM,MAAM,qCAAqC,GAAG;IAClD;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,YAAY,CAAC,EAAE,yBAAyB,CAAC;IACzC;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;CACpB,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,oCAAoC,CAClD,OAAO,GAAE,qCAA0C;gBAK1B,WAAW;;;;;;;;EAsFrC"}

package/types/tools/generate-map.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-map.d.ts","sourceRoot":"","sources":["../../src/tools/generate-map.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,mBAAmB,EAGnB,4BAA4B,EAK7B,MAAM,qCAAqC,CAAC;AAgD7C,eAAO,MAAM,wBAAwB,EAAE,4BAiBtC,CAAC;AAGF,eAAO,MAAM,wBAAwB,EAAE,4BAmBtC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;AAgCtE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,WAAW,EAAE,mBAkGzB,CAAC"}
+{"version":3,"file":"generate-map.d.ts","sourceRoot":"","sources":["../../src/tools/generate-map.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,mBAAmB,EAGnB,4BAA4B,EAG7B,MAAM,qCAAqC,CAAC;AAoD7C,eAAO,MAAM,wBAAwB,EAAE,4BAiBtC,CAAC;AAGF,eAAO,MAAM,wBAAwB,EAAE,4BAmBtC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;AAgCtE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,WAAW,EAAE,mBAkGzB,CAAC"}