@se-studio/core-ui 0.0.0-next16-20260822103555

package/dist/utils/marketingSiteSitemap.js

@@ -0,0 +1,352 @@
+/**
+ * Marketing site sitemap entry generation.
+ * Used by createAppHelpers when marketingSiteSitemap config is provided.
+ */
+import { filterSitemapEntriesExcludingRedirects } from '@se-studio/contentful-rest-api';
+import { getLocalizedPath } from './buildPageMetadata';
+/**
+ * Expands a single sitemap entry into one entry per locale when localeConfig is provided.
+ * Each entry gets alternates.languages with all locale URLs (relative paths).
+ */
+function expandEntryForLocales(entry, localeConfig) {
+    const languages = {};
+    for (const locale of localeConfig.locales) {
+        languages[locale] = getLocalizedPath(entry.url, locale, localeConfig);
+    }
+    return localeConfig.locales.map((locale) => ({
+        ...entry,
+        url: getLocalizedPath(entry.url, locale, localeConfig),
+        alternates: { languages },
+    }));
+}
+function isExternalUrl(href) {
+    if (!href)
+        return false;
+    return href.startsWith('http://') || href.startsWith('https://');
+}
+function getArticlePageUrl(link, urlCalcs) {
+    if (link.href && !isExternalUrl(link.href))
+        return link.href;
+    const articleTypeSlug = link.articleType?.slug;
+    if (!articleTypeSlug)
+        return null;
+    return urlCalcs.article(articleTypeSlug, link.slug, link.primaryTag?.slug);
+}
+/**
+ * Determines whether an article should appear as a page URL entry in the sitemap.
+ * When skipIndexedCheck is true the indexed/hidden guards are omitted (used for the unindexed path).
+ */
+export function shouldIncludeArticlePageUrl(link, config, skipIndexedCheck = false) {
+    if (!skipIndexedCheck) {
+        if (link.indexed === false || link.hidden === true)
+            return false;
+        if (link.articleType?.indexed === false || link.articleType?.hidden === true)
+            return false;
+    }
+    if (link.hasBodyContent)
+        return true;
+    if (link.href && isExternalUrl(link.href))
+        return config.includeExternalHrefArticles === true;
+    if (link.download)
+        return config.includeDownloadArticles === true;
+    return true;
+}
+/**
+ * Builds (articleTypeSlug → tagSlug → latest lastModified) for article-type tag index sitemap URLs.
+ * Only considers articles that pass {@link shouldIncludeArticlePageUrl} and CMS-indexed, non-hidden tags.
+ */
+export function collectArticleTypeTagLastModified(articleLinks, config) {
+    const lastModifiedByTypeTopic = new Map();
+    for (const link of articleLinks) {
+        if (!shouldIncludeArticlePageUrl(link, config))
+            continue;
+        const typeSlug = typeof link.articleType?.slug === 'string' ? link.articleType.slug : null;
+        if (!typeSlug || isExternalUrl(link.href))
+            continue;
+        for (const tag of link.tags ?? []) {
+            const tagSlug = typeof tag.slug === 'string' ? tag.slug : null;
+            if (!tagSlug || tag.indexed === false || tag.hidden === true)
+                continue;
+            if (!lastModifiedByTypeTopic.has(typeSlug)) {
+                lastModifiedByTypeTopic.set(typeSlug, new Map());
+            }
+            const topicMap = lastModifiedByTypeTopic.get(typeSlug);
+            if (!topicMap)
+                continue;
+            const existing = topicMap.get(tagSlug);
+            if (!existing || link.lastModified > existing) {
+                topicMap.set(tagSlug, link.lastModified);
+            }
+        }
+    }
+    return lastModifiedByTypeTopic;
+}
+/** Returns the latest lastModified from an array of links, or undefined if empty. */
+function latestLastModified(links) {
+    const first = links[0];
+    if (!first)
+        return undefined;
+    let latest = first.lastModified;
+    for (let i = 1; i < links.length; i++) {
+        const link = links[i];
+        const d = link?.lastModified;
+        if (d && d > latest)
+            latest = d;
+    }
+    return latest;
+}
+const fetchOptions = {
+    cache: 'force-cache',
+    next: {
+        revalidate: 3600,
+        tags: ['sitemap'],
+    },
+};
+/**
+ * Creates a getSitemapEntries function for marketing sites with articles, tags, people.
+ * When includeUnindexed is true, returns only pages with indexed === false.
+ * When includeUnindexed is false, returns full sitemap and merges additionalSources.
+ *
+ * Heavily parameterized by MarketingSiteSitemapConfig (enables for indexes, include* for download/external articles,
+ * localeConfig, additionalSources). The injected urlCalculators from converterContext are used both for
+ * reconstructing some article hrefs and for emitting index / tag-type / people listing entries.
+ */
+export function createMarketingSiteSitemapEntries(deps, config) {
+    const { converterContext, 
+    // getConfig is no longer read here (we unified both paths to use the injected *Links getters)
+    buildOptions, getAllPageLinks, getAllArticleLinks, getAllArticleTypeLinks, getAllTagLinks, getAllPersonLinks, getCustomType, } = deps;
+    const { articlesSlug, tagsSlug, enableArticleTypeIndex, enableArticleTypeTagIndex, enablePeopleIndex, enablePerson, enableTag, enableTagsIndex, peopleSlug, additionalSources, } = config;
+    const isUnindexedWithHref = (link) => link.indexed === false && link.hidden !== true && !!link.href;
+    const toPageEntry = (link) => ({
+        url: link.href,
+        lastModified: link.lastModified,
+        changeFrequency: 'weekly',
+        priority: 0.8,
+    });
+    const toArticleTypeEntry = (link) => ({
+        url: link.href,
+        lastModified: link.lastModified,
+        changeFrequency: 'weekly',
+        priority: 0.7,
+    });
+    const toTagEntry = (link) => ({
+        url: link.href,
+        lastModified: link.lastModified,
+        changeFrequency: 'weekly',
+        priority: 0.6,
+    });
+    const toArticleEntry = (link) => ({
+        url: link.href,
+        lastModified: link.lastModified,
+        changeFrequency: 'monthly',
+        priority: 0.6,
+    });
+    const toPersonEntry = (link) => ({
+        url: link.href,
+        lastModified: link.lastModified,
+        changeFrequency: 'monthly',
+        priority: 0.6,
+    });
+    /**
+     * @param options.includeUnindexed - when true, return only unindexed entries
+     * @param options.redirectMap - when provided, entries whose URL matches a redirect source
+     *   (from the map) will be excluded. Use with `getRedirectMap()` at build time.
+     */
+    return async function getSitemapEntries(options) {
+        const { includeUnindexed = false } = options;
+        const linkFetchOptions = includeUnindexed
+            ? { ...buildOptions(fetchOptions), allowUnindexed: true }
+            : buildOptions(fetchOptions);
+        // Common fetch path for both indexed and unindexed (unifies the code paths).
+        // Pages now always come via the injected getAllPageLinks (same as articles etc.),
+        // removing the previous special case that went through getAllSitemapEntries only for the main path.
+        // Also fetch the people custom type (when configured) so we can apply the combined
+        // indexed/hidden gate (person + backing custom type) for #53.
+        const [pageRes, articleRes, articleTypeRes, tagRes, personRes, customTypeRes] = await Promise.all([
+            getAllPageLinks(linkFetchOptions),
+            getAllArticleLinks(linkFetchOptions),
+            getAllArticleTypeLinks(linkFetchOptions),
+            getAllTagLinks(linkFetchOptions),
+            getAllPersonLinks(linkFetchOptions),
+            enablePerson && peopleSlug && getCustomType
+                ? getCustomType(peopleSlug)
+                : Promise.resolve(null),
+        ]);
+        const peopleCustomType = customTypeRes?.data ?? null;
+        const peopleCustomAllowsIndexed = peopleCustomType == null ||
+            (peopleCustomType.indexed !== false && peopleCustomType.hidden !== true);
+        if (includeUnindexed) {
+            const unindexedPages = pageRes.data
+                .filter(isUnindexedWithHref)
+                .map(toPageEntry);
+            const unindexedArticles = articleRes.data
+                .filter((link) => link.indexed === false && link.hidden !== true)
+                .flatMap((link) => {
+                if (!shouldIncludeArticlePageUrl(link, config, true))
+                    return [];
+                const url = getArticlePageUrl(link, converterContext.urlCalculators);
+                if (!url)
+                    return [];
+                return [toArticleEntry({ href: url, lastModified: link.lastModified })];
+            });
+            const unindexedDownloads = articleRes.data
+                .filter((link) => !!link.download && link.indexed === false && link.hidden !== true)
+                .map((link) => ({
+                url: converterContext.urlCalculators.download(link.download.assetId, link.download.filename),
+                lastModified: link.lastModified,
+                changeFrequency: 'monthly',
+                priority: 0.6,
+                trailingSlash: false,
+            }));
+            const unindexedArticleTypes = articleTypeRes.data
+                .filter(isUnindexedWithHref)
+                .map(toArticleTypeEntry);
+            const unindexedTags = tagRes.data.filter(isUnindexedWithHref).map(toTagEntry);
+            const unindexedPeople = enablePerson
+                ? personRes.data.filter(isUnindexedWithHref).map(toPersonEntry)
+                : [];
+            // Note: unindexed path continues to key only off individual flags (consistent with prior
+            // article unindexed behavior when skipIndexedCheck=true). Main path below applies the
+            // combined custom-type gate.
+            let unindexedList = [
+                ...unindexedPages,
+                ...unindexedArticles,
+                ...unindexedDownloads,
+                ...unindexedArticleTypes,
+                ...unindexedTags,
+                ...unindexedPeople,
+            ];
+            if (options.redirectMap) {
+                unindexedList = filterSitemapEntriesExcludingRedirects(unindexedList, options.redirectMap);
+            }
+            return unindexedList;
+        }
+        // Main (indexed) path — now using the same injected getters as the unindexed path.
+        const pageLinks = pageRes.data;
+        const articleLinks = articleRes.data;
+        const articleTypeLinks = articleTypeRes.data;
+        const tagLinks = tagRes.data;
+        const personLinks = personRes.data;
+        const pageEntries = pageLinks
+            .filter((link) => link.indexed !== false && link.hidden !== true && !!link.href)
+            .map(toPageEntry);
+        const articleTypeEntries = articleTypeLinks
+            .filter((type) => !!type.href)
+            .map(toArticleTypeEntry);
+        const articleEntries = articleLinks.flatMap((link) => {
+            if (!shouldIncludeArticlePageUrl(link, config))
+                return [];
+            const url = getArticlePageUrl(link, converterContext.urlCalculators);
+            if (!url)
+                return [];
+            return [toArticleEntry({ href: url, lastModified: link.lastModified })];
+        });
+        const downloadEntries = articleLinks
+            .filter((link) => !!link.download &&
+            link.indexed !== false &&
+            link.hidden !== true &&
+            link.articleType?.indexed !== false &&
+            link.articleType?.hidden !== true)
+            .map((link) => ({
+            url: converterContext.urlCalculators.download(link.download.assetId, link.download.filename),
+            lastModified: link.lastModified,
+            changeFrequency: 'monthly',
+            priority: 0.6,
+            trailingSlash: false,
+        }));
+        const articleTypeTagEntries = [];
+        if (enableArticleTypeTagIndex) {
+            const lastModifiedByTypeTopic = collectArticleTypeTagLastModified(articleLinks, config);
+            for (const [resourceType, topicMap] of lastModifiedByTypeTopic.entries()) {
+                for (const [topic, lastModified] of topicMap.entries()) {
+                    articleTypeTagEntries.push({
+                        url: converterContext.urlCalculators.articleTypeTag(resourceType, topic),
+                        lastModified,
+                        changeFrequency: 'weekly',
+                        priority: 0.6,
+                    });
+                }
+            }
+        }
+        const peopleListingDate = latestLastModified(personLinks);
+        const peopleListingEntry = enablePeopleIndex
+            ? [
+                {
+                    url: converterContext.urlCalculators.team(),
+                    ...(peopleListingDate && { lastModified: peopleListingDate }),
+                    changeFrequency: 'weekly',
+                    priority: 0.7,
+                },
+            ]
+            : [];
+        const peopleEntries = enablePerson
+            ? personLinks
+                .filter((person) => !!person.slug &&
+                person.indexed !== false &&
+                person.hidden !== true &&
+                peopleCustomAllowsIndexed)
+                .map((person) => ({
+                url: converterContext.urlCalculators.person(person.slug),
+                lastModified: person.lastModified,
+                changeFrequency: 'monthly',
+                priority: 0.6,
+            }))
+            : [];
+        const tagsListingDate = latestLastModified(tagLinks);
+        const tagsListingEntry = enableTagsIndex
+            ? [
+                {
+                    url: converterContext.urlCalculators.customType(tagsSlug),
+                    ...(tagsListingDate && { lastModified: tagsListingDate }),
+                    changeFrequency: 'weekly',
+                    priority: 0.7,
+                },
+            ]
+            : [];
+        const tagEntries = enableTag
+            ? tagLinks
+                .filter((link) => !!link.href)
+                .map(toTagEntry)
+            : [];
+        const articleTypeIndexDate = latestLastModified(articleTypeLinks);
+        const articleTypeIndexEntry = enableArticleTypeIndex && articlesSlug
+            ? [
+                {
+                    url: converterContext.urlCalculators.customType(articlesSlug),
+                    ...(articleTypeIndexDate && { lastModified: articleTypeIndexDate }),
+                    changeFrequency: 'weekly',
+                    priority: 0.8,
+                },
+            ]
+            : [];
+        let baseEntries = [
+            ...pageEntries,
+            ...articleTypeIndexEntry,
+            ...articleTypeEntries,
+            ...articleTypeTagEntries,
+            ...articleEntries,
+            ...downloadEntries,
+            ...tagsListingEntry,
+            ...tagEntries,
+            ...peopleListingEntry,
+            ...peopleEntries,
+        ];
+        const localeConfig = config.localeConfig;
+        if (localeConfig && localeConfig.locales.length > 0) {
+            baseEntries = baseEntries.flatMap((entry) => expandEntryForLocales(entry, localeConfig));
+        }
+        if (options.redirectMap) {
+            baseEntries = filterSitemapEntriesExcludingRedirects(baseEntries, options.redirectMap);
+        }
+        if (!additionalSources?.length) {
+            return baseEntries;
+        }
+        const additionalResults = await Promise.all(additionalSources.map((source) => source()));
+        let merged = [...baseEntries, ...additionalResults.flat()];
+        if (options.redirectMap) {
+            merged = filterSitemapEntriesExcludingRedirects(merged, options.redirectMap);
+        }
+        return merged;
+    };
+}
+//# sourceMappingURL=marketingSiteSitemap.js.map

package/dist/utils/marketingSiteSitemap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketingSiteSitemap.js","sourceRoot":"","sources":["../../src/utils/marketingSiteSitemap.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,EAAE,sCAAsC,EAAE,MAAM,gCAAgC,CAAC;AASxF,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AA2CvD;;;GAGG;AACH,SAAS,qBAAqB,CAAC,KAAmB,EAAE,YAA0B;IAC5E,MAAM,SAAS,GAA2B,EAAE,CAAC;IAC7C,KAAK,MAAM,MAAM,IAAI,YAAY,CAAC,OAAO,EAAE,CAAC;QAC1C,SAAS,CAAC,MAAM,CAAC,GAAG,gBAAgB,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC3C,GAAG,KAAK;QACR,GAAG,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC;QACtD,UAAU,EAAE,EAAE,SAAS,EAAE;KAC1B,CAAC,CAAC,CAAC;AACN,CAAC;AAED,SAAS,aAAa,CAAC,IAA+B;IACpD,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,OAAO,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;AACnE,CAAC;AAED,SAAS,iBAAiB,CACxB,IAAkB,EAClB,QAAiG;IAEjG,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC;IAC7D,MAAM,eAAe,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC;IAC/C,IAAI,CAAC,eAAe;QAAE,OAAO,IAAI,CAAC;IAClC,OAAO,QAAQ,CAAC,OAAO,CAAC,eAAe,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;AAC7E,CAAC;AAOD;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CACzC,IAAkB,EAClB,MAA8B,EAC9B,gBAAgB,GAAG,KAAK;IAExB,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QACjE,IAAI,IAAI,CAAC,WAAW,EAAE,OAAO,KAAK,KAAK,IAAI,IAAI,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;IAC7F,CAAC;IACD,IAAI,IAAI,CAAC,cAAc;QAAE,OAAO,IAAI,CAAC;IACrC,IAAI,IAAI,CAAC,IAAI,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC,2BAA2B,KAAK,IAAI,CAAC;IAC9F,IAAI,IAAI,CAAC,QAAQ;QAAE,OAAO,MAAM,CAAC,uBAAuB,KAAK,IAAI,CAAC;IAClE,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iCAAiC,CAC/C,YAA4B,EAC5B,MAA8B;IAE9B,MAAM,uBAAuB,GAAG,IAAI,GAAG,EAA6B,CAAC;IAErE,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,IAAI,CAAC,2BAA2B,CAAC,IAAI,EAAE,MAAM,CAAC;YAAE,SAAS;QAEzD,MAAM,QAAQ,GAAG,OAAO,IAAI,CAAC,WAAW,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3F,IAAI,CAAC,QAAQ,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,SAAS;QAEpD,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;YAClC,MAAM,OAAO,GAAG,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;YAC/D,IAAI,CAAC,OAAO,IAAI,GAAG,CAAC,OAAO,KAAK,KAAK,IAAI,GAAG,CAAC,MAAM,KAAK,IAAI;gBAAE,SAAS;YAEvE,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC3C,uBAAuB,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;YACnD,CAAC;YACD,MAAM,QAAQ,GAAG,uBAAuB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACvD,IAAI,CAAC,QAAQ;gBAAE,SAAS;YACxB,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACvC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,YAAY,GAAG,QAAQ,EAAE,CAAC;gBAC9C,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,uBAAuB,CAAC;AACjC,CAAC;AAED,qFAAqF;AACrF,SAAS,kBAAkB,CAAmC,KAAU;IACtE,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACvB,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,IAAI,MAAM,GAAG,KAAK,CAAC,YAAY,CAAC;IAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,CAAC,GAAG,IAAI,EAAE,YAAY,CAAC;QAC7B,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM;YAAE,MAAM,GAAG,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,YAAY,GAAG;IACnB,KAAK,EAAE,aAAsB;IAC7B,IAAI,EAAE;QACJ,UAAU,EAAE,IAAI;QAChB,IAAI,EAAE,CAAC,SAAS,CAAC;KAClB;CACF,CAAC;AAqBF;;;;;;;;GAQG;AACH,MAAM,UAAU,iCAAiC,CAC/C,IAA2C,EAC3C,MAAkC;IAElC,MAAM,EACJ,gBAAgB;IAChB,8FAA8F;IAC9F,YAAY,EACZ,eAAe,EACf,kBAAkB,EAClB,sBAAsB,EACtB,cAAc,EACd,iBAAiB,EACjB,aAAa,GACd,GAAG,IAAI,CAAC;IACT,MAAM,EACJ,YAAY,EACZ,QAAQ,EACR,sBAAsB,EACtB,yBAAyB,EACzB,iBAAiB,EACjB,YAAY,EACZ,SAAS,EACT,eAAe,EACf,UAAU,EACV,iBAAiB,GAClB,GAAG,MAAM,CAAC;IAEX,MAAM,mBAAmB,GAAG,CAAC,IAAmB,EAA4C,EAAE,CAC5F,IAAI,CAAC,OAAO,KAAK,KAAK,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IAEhE,MAAM,WAAW,GAAG,CAAC,IAA0C,EAAgB,EAAE,CAAC,CAAC;QACjF,GAAG,EAAE,IAAI,CAAC,IAAI;QACd,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,eAAe,EAAE,QAAQ;QACzB,QAAQ,EAAE,GAAG;KACd,CAAC,CAAC;IAEH,MAAM,kBAAkB,GAAG,CAAC,IAA0C,EAAgB,EAAE,CAAC,CAAC;QACxF,GAAG,EAAE,IAAI,CAAC,IAAI;QACd,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,eAAe,EAAE,QAAQ;QACzB,QAAQ,EAAE,GAAG;KACd,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,CAAC,IAA0C,EAAgB,EAAE,CAAC,CAAC;QAChF,GAAG,EAAE,IAAI,CAAC,IAAI;QACd,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,eAAe,EAAE,QAAQ;QACzB,QAAQ,EAAE,GAAG;KACd,CAAC,CAAC;IAEH,MAAM,cAAc,GAAG,CAAC,IAA0C,EAAgB,EAAE,CAAC,CAAC;QACpF,GAAG,EAAE,IAAI,CAAC,IAAI;QACd,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,eAAe,EAAE,SAAS;QAC1B,QAAQ,EAAE,GAAG;KACd,CAAC,CAAC;IAEH,MAAM,aAAa,GAAG,CAAC,IAA0C,EAAgB,EAAE,CAAC,CAAC;QACnF,GAAG,EAAE,IAAI,CAAC,IAAI;QACd,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,eAAe,EAAE,SAAS;QAC1B,QAAQ,EAAE,GAAG;KACd,CAAC,CAAC;IAEH;;;;OAIG;IACH,OAAO,KAAK,UAAU,iBAAiB,CAAC,OAGvC;QACC,MAAM,EAAE,gBAAgB,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;QAE7C,MAAM,gBAAgB,GAAG,gBAAgB;YACvC,CAAC,CAAC,EAAE,GAAG,YAAY,CAAC,YAAY,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE;YACzD,CAAC,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;QAE/B,6EAA6E;QAC7E,kFAAkF;QAClF,oGAAoG;QACpG,mFAAmF;QACnF,8DAA8D;QAC9D,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,CAAC,GAC3E,MAAM,OAAO,CAAC,GAAG,CAAC;YAChB,eAAe,CAAC,gBAAgB,CAAC;YACjC,kBAAkB,CAAC,gBAAgB,CAAC;YACpC,sBAAsB,CAAC,gBAAgB,CAAC;YACxC,cAAc,CAAC,gBAAgB,CAAC;YAChC,iBAAiB,CAAC,gBAAgB,CAAC;YACnC,YAAY,IAAI,UAAU,IAAI,aAAa;gBACzC,CAAC,CAAC,aAAa,CAAC,UAAU,CAAC;gBAC3B,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;SAC1B,CAAC,CAAC;QAEL,MAAM,gBAAgB,GAAG,aAAa,EAAE,IAAI,IAAI,IAAI,CAAC;QACrD,MAAM,yBAAyB,GAC7B,gBAAgB,IAAI,IAAI;YACxB,CAAC,gBAAgB,CAAC,OAAO,KAAK,KAAK,IAAI,gBAAgB,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC;QAE3E,IAAI,gBAAgB,EAAE,CAAC;YACrB,MAAM,cAAc,GAAmB,OAAO,CAAC,IAAI;iBAChD,MAAM,CAAC,mBAAmB,CAAC;iBAC3B,GAAG,CAAC,WAAW,CAAC,CAAC;YAEpB,MAAM,iBAAiB,GAAmB,UAAU,CAAC,IAAI;iBACtD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,KAAK,KAAK,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC;iBAChE,OAAO,CAAC,CAAC,IAAI,EAAkB,EAAE;gBAChC,IAAI,CAAC,2BAA2B,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC;oBAAE,OAAO,EAAE,CAAC;gBAChE,MAAM,GAAG,GAAG,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,CAAC,cAAc,CAAC,CAAC;gBACrE,IAAI,CAAC,GAAG;oBAAE,OAAO,EAAE,CAAC;gBACpB,OAAO,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;YAC1E,CAAC,CAAC,CAAC;YAEL,MAAM,kBAAkB,GAAmB,UAAU,CAAC,IAAI;iBACvD,MAAM,CACL,CAAC,IAAI,EAAyE,EAAE,CAC9E,CAAC,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,CACpE;iBACA,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBACd,GAAG,EAAE,gBAAgB,CAAC,cAAc,CAAC,QAAQ,CAC3C,IAAI,CAAC,QAAQ,CAAC,OAAO,EACrB,IAAI,CAAC,QAAQ,CAAC,QAAQ,CACvB;gBACD,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,eAAe,EAAE,SAAkB;gBACnC,QAAQ,EAAE,GAAG;gBACb,aAAa,EAAE,KAAK;aACrB,CAAC,CAAC,CAAC;YAEN,MAAM,qBAAqB,GAAmB,cAAc,CAAC,IAAI;iBAC9D,MAAM,CAAC,mBAAmB,CAAC;iBAC3B,GAAG,CAAC,kBAAkB,CAAC,CAAC;YAE3B,MAAM,aAAa,GAAmB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YAE9F,MAAM,eAAe,GAAmB,YAAY;gBAClD,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC;gBAC/D,CAAC,CAAC,EAAE,CAAC;YACP,yFAAyF;YACzF,sFAAsF;YACtF,6BAA6B;YAE7B,IAAI,aAAa,GAAG;gBAClB,GAAG,cAAc;gBACjB,GAAG,iBAAiB;gBACpB,GAAG,kBAAkB;gBACrB,GAAG,qBAAqB;gBACxB,GAAG,aAAa;gBAChB,GAAG,eAAe;aACnB,CAAC;YAEF,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;gBACxB,aAAa,GAAG,sCAAsC,CAAC,aAAa,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;YAC7F,CAAC;YAED,OAAO,aAAa,CAAC;QACvB,CAAC;QAED,mFAAmF;QACnF,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;QAC/B,MAAM,YAAY,GAAG,UAAU,CAAC,IAAI,CAAC;QACrC,MAAM,gBAAgB,GAAG,cAAc,CAAC,IAAI,CAAC;QAC7C,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC;QAC7B,MAAM,WAAW,GAAG,SAAS,CAAC,IAAI,CAAC;QAEnC,MAAM,WAAW,GAAmB,SAAS;aAC1C,MAAM,CACL,CAAC,IAAI,EAA0C,EAAE,CAC/C,IAAI,CAAC,OAAO,KAAK,KAAK,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAChE;aACA,GAAG,CAAC,WAAW,CAAC,CAAC;QAEpB,MAAM,kBAAkB,GAAmB,gBAAgB;aACxD,MAAM,CAAC,CAAC,IAAI,EAA0C,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;aACrE,GAAG,CAAC,kBAAkB,CAAC,CAAC;QAE3B,MAAM,cAAc,GAAmB,YAAY,CAAC,OAAO,CAAC,CAAC,IAAI,EAAkB,EAAE;YACnF,IAAI,CAAC,2BAA2B,CAAC,IAAI,EAAE,MAAM,CAAC;gBAAE,OAAO,EAAE,CAAC;YAC1D,MAAM,GAAG,GAAG,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,CAAC,cAAc,CAAC,CAAC;YACrE,IAAI,CAAC,GAAG;gBAAE,OAAO,EAAE,CAAC;YACpB,OAAO,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;QAC1E,CAAC,CAAC,CAAC;QAEH,MAAM,eAAe,GAAmB,YAAY;aACjD,MAAM,CACL,CAAC,IAAI,EAAyE,EAAE,CAC9E,CAAC,CAAC,IAAI,CAAC,QAAQ;YACf,IAAI,CAAC,OAAO,KAAK,KAAK;YACtB,IAAI,CAAC,MAAM,KAAK,IAAI;YACpB,IAAI,CAAC,WAAW,EAAE,OAAO,KAAK,KAAK;YACnC,IAAI,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CACpC;aACA,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACd,GAAG,EAAE,gBAAgB,CAAC,cAAc,CAAC,QAAQ,CAC3C,IAAI,CAAC,QAAQ,CAAC,OAAO,EACrB,IAAI,CAAC,QAAQ,CAAC,QAAQ,CACvB;YACD,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,eAAe,EAAE,SAAkB;YACnC,QAAQ,EAAE,GAAG;YACb,aAAa,EAAE,KAAK;SACrB,CAAC,CAAC,CAAC;QAEN,MAAM,qBAAqB,GAAmB,EAAE,CAAC;QACjD,IAAI,yBAAyB,EAAE,CAAC;YAC9B,MAAM,uBAAuB,GAAG,iCAAiC,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;YACxF,KAAK,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,IAAI,uBAAuB,CAAC,OAAO,EAAE,EAAE,CAAC;gBACzE,KAAK,MAAM,CAAC,KAAK,EAAE,YAAY,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;oBACvD,qBAAqB,CAAC,IAAI,CAAC;wBACzB,GAAG,EAAE,gBAAgB,CAAC,cAAc,CAAC,cAAc,CAAC,YAAY,EAAE,KAAK,CAAC;wBACxE,YAAY;wBACZ,eAAe,EAAE,QAAiB;wBAClC,QAAQ,EAAE,GAAG;qBACd,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,iBAAiB,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;QAC1D,MAAM,kBAAkB,GAAmB,iBAAiB;YAC1D,CAAC,CAAC;gBACE;oBACE,GAAG,EAAE,gBAAgB,CAAC,cAAc,CAAC,IAAI,EAAE;oBAC3C,GAAG,CAAC,iBAAiB,IAAI,EAAE,YAAY,EAAE,iBAAiB,EAAE,CAAC;oBAC7D,eAAe,EAAE,QAAiB;oBAClC,QAAQ,EAAE,GAAG;iBACd;aACF;YACH,CAAC,CAAC,EAAE,CAAC;QAEP,MAAM,aAAa,GAAmB,YAAY;YAChD,CAAC,CAAC,WAAW;iBACR,MAAM,CACL,CAAC,MAAM,EAA8C,EAAE,CACrD,CAAC,CAAC,MAAM,CAAC,IAAI;gBACb,MAAM,CAAC,OAAO,KAAK,KAAK;gBACxB,MAAM,CAAC,MAAM,KAAK,IAAI;gBACtB,yBAAyB,CAC5B;iBACA,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;gBAChB,GAAG,EAAE,gBAAgB,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;gBACxD,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,eAAe,EAAE,SAAkB;gBACnC,QAAQ,EAAE,GAAG;aACd,CAAC,CAAC;YACP,CAAC,CAAC,EAAE,CAAC;QAEP,MAAM,eAAe,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QACrD,MAAM,gBAAgB,GAAmB,eAAe;YACtD,CAAC,CAAC;gBACE;oBACE,GAAG,EAAE,gBAAgB,CAAC,cAAc,CAAC,UAAU,CAAC,QAAQ,CAAC;oBACzD,GAAG,CAAC,eAAe,IAAI,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC;oBACzD,eAAe,EAAE,QAAiB;oBAClC,QAAQ,EAAE,GAAG;iBACd;aACF;YACH,CAAC,CAAC,EAAE,CAAC;QAEP,MAAM,UAAU,GAAmB,SAAS;YAC1C,CAAC,CAAC,QAAQ;iBACL,MAAM,CAAC,CAAC,IAAI,EAA0C,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;iBACrE,GAAG,CAAC,UAAU,CAAC;YACpB,CAAC,CAAC,EAAE,CAAC;QAEP,MAAM,oBAAoB,GAAG,kBAAkB,CAAC,gBAAgB,CAAC,CAAC;QAClE,MAAM,qBAAqB,GACzB,sBAAsB,IAAI,YAAY;YACpC,CAAC,CAAC;gBACE;oBACE,GAAG,EAAE,gBAAgB,CAAC,cAAc,CAAC,UAAU,CAAC,YAAY,CAAC;oBAC7D,GAAG,CAAC,oBAAoB,IAAI,EAAE,YAAY,EAAE,oBAAoB,EAAE,CAAC;oBACnE,eAAe,EAAE,QAAiB;oBAClC,QAAQ,EAAE,GAAG;iBACd;aACF;YACH,CAAC,CAAC,EAAE,CAAC;QAET,IAAI,WAAW,GAAmB;YAChC,GAAG,WAAW;YACd,GAAG,qBAAqB;YACxB,GAAG,kBAAkB;YACrB,GAAG,qBAAqB;YACxB,GAAG,cAAc;YACjB,GAAG,eAAe;YAClB,GAAG,gBAAgB;YACnB,GAAG,UAAU;YACb,GAAG,kBAAkB;YACrB,GAAG,aAAa;SACjB,CAAC;QAEF,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;QACzC,IAAI,YAAY,IAAI,YAAY,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpD,WAAW,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,qBAAqB,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC;QAC3F,CAAC;QAED,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YACxB,WAAW,GAAG,sCAAsC,CAAC,WAAW,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QACzF,CAAC;QAED,IAAI,CAAC,iBAAiB,EAAE,MAAM,EAAE,CAAC;YAC/B,OAAO,WAAW,CAAC;QACrB,CAAC;QAED,MAAM,iBAAiB,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACzF,IAAI,MAAM,GAAG,CAAC,GAAG,WAAW,EAAE,GAAG,iBAAiB,CAAC,IAAI,EAAE,CAAC,CAAC;QAE3D,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YACxB,MAAM,GAAG,sCAAsC,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QAC/E,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC"}

package/dist/utils/previewPageUtils.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Preview page utilities for Next.js applications.
+ *
+ * These utilities help with implementing Contentful preview pages that
+ * redirect editors from `/preview?id={entryId}` to the appropriate content URL.
+ *
+ * @example
+ * ```ts
+ * // app/preview/page.tsx
+ * import { validatePreviewSecret } from '@se-studio/core-ui';
+ * import { createBaseConverterContext, getPreviewEntryInfo } from '@se-studio/contentful-rest-api';
+ * import { notFound, redirect } from 'next/navigation';
+ *
+ * export default async function PreviewPage({ searchParams }) {
+ *   const { id, secret } = await searchParams;
+ *
+ *   const validation = validatePreviewSecret(secret, process.env.PREVIEW_SECRET);
+ *   if (!validation.valid) throw new Error(validation.error);
+ *   if (!id) throw new Error('Preview ID is required');
+ *
+ *   const context = createBaseConverterContext();
+ *   const info = await getPreviewEntryInfo(context, contentfulConfig, id);
+ *   if (!info) return notFound();
+ *
+ *   redirect(info.href);
+ * }
+ * ```
+ */
+/**
+ * Result of preview secret validation
+ */
+export interface PreviewSecretValidation {
+    /** Whether the secret is valid */
+    valid: boolean;
+    /** Error message if validation failed */
+    error?: string;
+}
+/**
+ * Validates the preview secret against the environment variable.
+ *
+ * If no environment secret is configured, all requests are allowed.
+ * If an environment secret is configured, the provided secret must match.
+ *
+ * @param providedSecret - The secret provided in the request (from query params)
+ * @param envSecret - The expected secret from environment variable (PREVIEW_SECRET)
+ * @returns Validation result with valid flag and optional error message
+ *
+ * @example
+ * ```ts
+ * const validation = validatePreviewSecret(
+ *   searchParams.secret,
+ *   process.env.PREVIEW_SECRET
+ * );
+ *
+ * if (!validation.valid) {
+ *   throw new Error(validation.error);
+ * }
+ * ```
+ */
+export declare function validatePreviewSecret(providedSecret: string | undefined, envSecret: string | undefined): PreviewSecretValidation;
+//# sourceMappingURL=previewPageUtils.d.ts.map

package/dist/utils/previewPageUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"previewPageUtils.d.ts","sourceRoot":"","sources":["../../src/utils/previewPageUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,kCAAkC;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,qBAAqB,CACnC,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,uBAAuB,CAuBzB"}

package/dist/utils/previewPageUtils.js

@@ -0,0 +1,72 @@
+/**
+ * Preview page utilities for Next.js applications.
+ *
+ * These utilities help with implementing Contentful preview pages that
+ * redirect editors from `/preview?id={entryId}` to the appropriate content URL.
+ *
+ * @example
+ * ```ts
+ * // app/preview/page.tsx
+ * import { validatePreviewSecret } from '@se-studio/core-ui';
+ * import { createBaseConverterContext, getPreviewEntryInfo } from '@se-studio/contentful-rest-api';
+ * import { notFound, redirect } from 'next/navigation';
+ *
+ * export default async function PreviewPage({ searchParams }) {
+ *   const { id, secret } = await searchParams;
+ *
+ *   const validation = validatePreviewSecret(secret, process.env.PREVIEW_SECRET);
+ *   if (!validation.valid) throw new Error(validation.error);
+ *   if (!id) throw new Error('Preview ID is required');
+ *
+ *   const context = createBaseConverterContext();
+ *   const info = await getPreviewEntryInfo(context, contentfulConfig, id);
+ *   if (!info) return notFound();
+ *
+ *   redirect(info.href);
+ * }
+ * ```
+ */
+/**
+ * Validates the preview secret against the environment variable.
+ *
+ * If no environment secret is configured, all requests are allowed.
+ * If an environment secret is configured, the provided secret must match.
+ *
+ * @param providedSecret - The secret provided in the request (from query params)
+ * @param envSecret - The expected secret from environment variable (PREVIEW_SECRET)
+ * @returns Validation result with valid flag and optional error message
+ *
+ * @example
+ * ```ts
+ * const validation = validatePreviewSecret(
+ *   searchParams.secret,
+ *   process.env.PREVIEW_SECRET
+ * );
+ *
+ * if (!validation.valid) {
+ *   throw new Error(validation.error);
+ * }
+ * ```
+ */
+export function validatePreviewSecret(providedSecret, envSecret) {
+    // If no secret is configured in the environment, allow all requests
+    if (!envSecret) {
+        return { valid: true };
+    }
+    // If a secret is configured but not provided in the request, reject
+    if (!providedSecret) {
+        return {
+            valid: false,
+            error: 'Preview secret is required',
+        };
+    }
+    // Check if the provided secret matches the configured secret
+    if (providedSecret !== envSecret) {
+        return {
+            valid: false,
+            error: 'Invalid preview secret',
+        };
+    }
+    return { valid: true };
+}
+//# sourceMappingURL=previewPageUtils.js.map

package/dist/utils/previewPageUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"previewPageUtils.js","sourceRoot":"","sources":["../../src/utils/previewPageUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAYH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,qBAAqB,CACnC,cAAkC,EAClC,SAA6B;IAE7B,oEAAoE;IACpE,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IAED,oEAAoE;IACpE,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,4BAA4B;SACpC,CAAC;IACJ,CAAC;IAED,6DAA6D;IAC7D,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,wBAAwB;SAChC,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC"}

package/dist/utils/previewUtils.d.ts

@@ -0,0 +1,59 @@
+import type { CmsRendererConfig, PreviewDataAttributes } from '../CmsRendererConfig';
+export interface IContent {
+    parentId?: string;
+    parentFieldId?: string;
+}
+export declare function coreGetPreviewProps({ entryId, assetId, fieldId, }: {
+    entryId?: string;
+    assetId?: string;
+    fieldId?: string;
+}, draftOnly: boolean): {
+    'data-contentful-entry-id': string | undefined;
+    'data-contentful-asset-id': string | undefined;
+    'data-contentful-field-id': string | undefined;
+} | undefined;
+export declare function coreGetPreviewFieldIdProps(id: string | undefined, fieldId: string | undefined, draftOnly: boolean): {
+    'data-contentful-entry-id': string | undefined;
+    'data-contentful-asset-id': string | undefined;
+    'data-contentful-field-id': string | undefined;
+} | undefined;
+export declare function coreGetPreviewAssetIdProps(assetId: string | undefined, draftOnly: boolean): {
+    'data-contentful-entry-id': string | undefined;
+    'data-contentful-asset-id': string | undefined;
+    'data-contentful-field-id': string | undefined;
+} | undefined;
+export declare function coreGetPreviewParentProps(information: IContent | null | undefined, draftOnly: boolean): {
+    'data-contentful-entry-id': string | undefined;
+    'data-contentful-asset-id': string | undefined;
+    'data-contentful-field-id': string | undefined;
+} | undefined;
+/**
+ * Returns preview props for a field from rendererConfig.
+ * Use in components instead of rendererConfig?.previewHelpers?.getPreviewFieldIdProps?.(id, fieldId) ?? {}
+ * to avoid circular imports from cms-server.
+ *
+ * @example
+ * ```tsx
+ * import { getPreviewFieldProps } from '@se-studio/core-ui';
+ * <Element {...getPreviewFieldProps(rendererConfig, id, 'heading')}>
+ * ```
+ */
+export declare function getPreviewFieldProps(rendererConfig: CmsRendererConfig | undefined, id: string | undefined, fieldId: string): Record<string, string | undefined>;
+/**
+ * Returns preview props for a responsive visual (visual + mobileVisual) from rendererConfig.
+ * Use in components instead of inline rendererConfig?.previewHelpers?.getPreviewResponsiveVisualFieldIdProps calls.
+ *
+ * @example
+ * ```tsx
+ * import { getPreviewResponsiveVisualFieldProps } from '@se-studio/core-ui';
+ * const { visualPreviewProps, mobileVisualPreviewProps } = getPreviewResponsiveVisualFieldProps(
+ *   rendererConfig, id, 'visual', 'mobileVisual'
+ * );
+ * <ResponsiveVisual {...visualPreviewProps} mobileVisualPreviewProps={mobileVisualPreviewProps} />
+ * ```
+ */
+export declare function getPreviewResponsiveVisualFieldProps(rendererConfig: CmsRendererConfig | undefined, id: string | undefined, visualFieldId?: string, mobileVisualFieldId?: string): {
+    visualPreviewProps: PreviewDataAttributes;
+    mobileVisualPreviewProps: PreviewDataAttributes;
+};
+//# sourceMappingURL=previewUtils.d.ts.map

package/dist/utils/previewUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"previewUtils.d.ts","sourceRoot":"","sources":["../../src/utils/previewUtils.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAErF,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,mBAAmB,CACjC,EACE,OAAO,EACP,OAAO,EACP,OAAO,GACR,EAAE;IACD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,EACD,SAAS,EAAE,OAAO;;;;cASnB;AAED,wBAAgB,0BAA0B,CACxC,EAAE,EAAE,MAAM,GAAG,SAAS,EACtB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,SAAS,EAAE,OAAO;;;;cAGnB;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,EAAE,OAAO;;;;cAEzF;AAED,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,EACxC,SAAS,EAAE,OAAO;;;;cAUnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,cAAc,EAAE,iBAAiB,GAAG,SAAS,EAC7C,EAAE,EAAE,MAAM,GAAG,SAAS,EACtB,OAAO,EAAE,MAAM,GACd,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAKpC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oCAAoC,CAClD,cAAc,EAAE,iBAAiB,GAAG,SAAS,EAC7C,EAAE,EAAE,MAAM,GAAG,SAAS,EACtB,aAAa,CAAC,EAAE,MAAM,EACtB,mBAAmB,CAAC,EAAE,MAAM,GAC3B;IACD,kBAAkB,EAAE,qBAAqB,CAAC;IAC1C,wBAAwB,EAAE,qBAAqB,CAAC;CACjD,CAUA"}

package/dist/utils/previewUtils.js

@@ -0,0 +1,60 @@
+// Contentful preview utilities
+// These utilities help with Contentful live preview by adding data attributes
+export function coreGetPreviewProps({ entryId, assetId, fieldId, }, draftOnly) {
+    if (!draftOnly)
+        return undefined;
+    return {
+        'data-contentful-entry-id': entryId,
+        'data-contentful-asset-id': assetId,
+        'data-contentful-field-id': fieldId,
+    };
+}
+export function coreGetPreviewFieldIdProps(id, fieldId, draftOnly) {
+    return coreGetPreviewProps({ entryId: id, fieldId }, draftOnly);
+}
+export function coreGetPreviewAssetIdProps(assetId, draftOnly) {
+    return coreGetPreviewProps({ assetId }, draftOnly);
+}
+export function coreGetPreviewParentProps(information, draftOnly) {
+    if (!information)
+        return undefined;
+    return coreGetPreviewProps({
+        entryId: information.parentId,
+        fieldId: information.parentFieldId,
+    }, draftOnly);
+}
+/**
+ * Returns preview props for a field from rendererConfig.
+ * Use in components instead of rendererConfig?.previewHelpers?.getPreviewFieldIdProps?.(id, fieldId) ?? {}
+ * to avoid circular imports from cms-server.
+ *
+ * @example
+ * ```tsx
+ * import { getPreviewFieldProps } from '@se-studio/core-ui';
+ * <Element {...getPreviewFieldProps(rendererConfig, id, 'heading')}>
+ * ```
+ */
+export function getPreviewFieldProps(rendererConfig, id, fieldId) {
+    return (rendererConfig?.previewHelpers?.getPreviewFieldIdProps?.(id, fieldId) ?? {});
+}
+/**
+ * Returns preview props for a responsive visual (visual + mobileVisual) from rendererConfig.
+ * Use in components instead of inline rendererConfig?.previewHelpers?.getPreviewResponsiveVisualFieldIdProps calls.
+ *
+ * @example
+ * ```tsx
+ * import { getPreviewResponsiveVisualFieldProps } from '@se-studio/core-ui';
+ * const { visualPreviewProps, mobileVisualPreviewProps } = getPreviewResponsiveVisualFieldProps(
+ *   rendererConfig, id, 'visual', 'mobileVisual'
+ * );
+ * <ResponsiveVisual {...visualPreviewProps} mobileVisualPreviewProps={mobileVisualPreviewProps} />
+ * ```
+ */
+export function getPreviewResponsiveVisualFieldProps(rendererConfig, id, visualFieldId, mobileVisualFieldId) {
+    const result = rendererConfig?.previewHelpers?.getPreviewResponsiveVisualFieldIdProps?.(id, visualFieldId, mobileVisualFieldId);
+    return {
+        visualPreviewProps: result?.visualPreviewProps ?? undefined,
+        mobileVisualPreviewProps: result?.mobileVisualPreviewProps ?? undefined,
+    };
+}
+//# sourceMappingURL=previewUtils.js.map

package/dist/utils/previewUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"previewUtils.js","sourceRoot":"","sources":["../../src/utils/previewUtils.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,8EAA8E;AAS9E,MAAM,UAAU,mBAAmB,CACjC,EACE,OAAO,EACP,OAAO,EACP,OAAO,GAKR,EACD,SAAkB;IAElB,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IAEjC,OAAO;QACL,0BAA0B,EAAE,OAAO;QACnC,0BAA0B,EAAE,OAAO;QACnC,0BAA0B,EAAE,OAAO;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,EAAsB,EACtB,OAA2B,EAC3B,SAAkB;IAElB,OAAO,mBAAmB,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,OAA2B,EAAE,SAAkB;IACxF,OAAO,mBAAmB,CAAC,EAAE,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,WAAwC,EACxC,SAAkB;IAElB,IAAI,CAAC,WAAW;QAAE,OAAO,SAAS,CAAC;IACnC,OAAO,mBAAmB,CACxB;QACE,OAAO,EAAE,WAAW,CAAC,QAAQ;QAC7B,OAAO,EAAE,WAAW,CAAC,aAAa;KACnC,EACD,SAAS,CACV,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAClC,cAA6C,EAC7C,EAAsB,EACtB,OAAe;IAEf,OAAO,CAAC,cAAc,EAAE,cAAc,EAAE,sBAAsB,EAAE,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,EAAE,CAGlF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,oCAAoC,CAClD,cAA6C,EAC7C,EAAsB,EACtB,aAAsB,EACtB,mBAA4B;IAK5B,MAAM,MAAM,GAAG,cAAc,EAAE,cAAc,EAAE,sCAAsC,EAAE,CACrF,EAAE,EACF,aAAa,EACb,mBAAmB,CACpB,CAAC;IACF,OAAO;QACL,kBAAkB,EAAE,MAAM,EAAE,kBAAkB,IAAI,SAAS;QAC3D,wBAAwB,EAAE,MAAM,EAAE,wBAAwB,IAAI,SAAS;KACxE,CAAC;AACJ,CAAC"}

package/dist/utils/processCollectionLinks.d.ts

@@ -0,0 +1,11 @@
+import { type IContentContext, type ILinkProps } from '@se-studio/core-data-types';
+/**
+ * Automatically configures links with no target based on context.
+ * If on an article page, blank/empty links will be configured using the provided callback.
+ *
+ * @param links - Array of links to process
+ * @param contentContext - Context containing page information
+ * @returns Processed array of links
+ */
+export declare function processCollectionLinks(links: ReadonlyArray<ILinkProps>, contentContext: IContentContext): ReadonlyArray<ILinkProps>;
+//# sourceMappingURL=processCollectionLinks.d.ts.map

package/dist/utils/processCollectionLinks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processCollectionLinks.d.ts","sourceRoot":"","sources":["../../src/utils/processCollectionLinks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,UAAU,EAAe,MAAM,4BAA4B,CAAC;AAEhG;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,EAChC,cAAc,EAAE,eAAe,GAC9B,aAAa,CAAC,UAAU,CAAC,CA+B3B"}