@se-studio/contentful-rest-api 0.0.0-next16-20260822103555

package/dist/api/helpers.js

@@ -0,0 +1,313 @@
+import { getContentfulClient } from '../client.js';
+import { convertAssetToVisual } from '../converters/asset.js';
+import { finalizeModelIconsAndNavigation, } from '../navigation/enrichModelNavigation.js';
+import { getCacheTags } from '../revalidation/utils.js';
+import { allLinksOperationLabel, operationLabel } from '../telemetry/deriveOperation.js';
+import { withCmsQueryContext } from '../telemetry/queryContext.js';
+import { withRetry } from '../utils/index.js';
+import { ARTICLE_LISTING_FIELDS, getResolutionScopeFromOptions, getSingleEntityListingSelect, resolveIncludeDepth, } from './listing-fetch-params.js';
+export { allLinksOperationLabel, operationLabel } from '../telemetry/deriveOperation.js';
+export { withCmsQueryContext } from '../telemetry/queryContext.js';
+async function enrichAssetsForFetch(assets, includes, options) {
+    const { enrichAllAssets } = await import('../converters/enrichAssets.js');
+    return enrichAllAssets(assets, includes, options);
+}
+// ============================================================================
+// CMS Configuration and Options
+// ============================================================================
+/**
+ * Build fetch options with defaults.
+ *
+ * @param options - Provided fetch options
+ * @param defaultDraftOnly - Default value for preview if not specified
+ * @returns Combined fetch options
+ */
+export function buildFetchOptions(options, defaultPreview) {
+    const preview = options?.preview ?? defaultPreview;
+    return {
+        preview,
+        cache: 'force-cache',
+        ...options,
+        ...options?.next, // merge next options if provided to top level for some clients
+    };
+}
+/**
+ * Get Contentful configuration from environment variables.
+ *
+ * Supports CONTENTFUL_SPACE_ID, CONTENTFUL_ENVIRONMENT (or CONTENTFUL_ENVIRONMENT_NAME),
+ * and access tokens for both delivery and preview.
+ *
+ * @param preview - Whether to get the preview access token
+ * @returns Contentful configuration object
+ * @throws Error if required environment variables are missing
+ */
+export function coreGetContentfulConfig(preview) {
+    const spaceId = process.env.CONTENTFUL_SPACE_ID;
+    const environment = process.env.CONTENTFUL_ENVIRONMENT || process.env.CONTENTFUL_ENVIRONMENT_NAME;
+    const accessToken = preview
+        ? process.env.CONTENTFUL_PREVIEW_ACCESS_TOKEN
+        : process.env.CONTENTFUL_ACCESS_TOKEN;
+    if (!spaceId) {
+        throw new Error('CONTENTFUL_SPACE_ID environment variable is required');
+    }
+    if (!accessToken) {
+        if (preview) {
+            throw new Error('CONTENTFUL_PREVIEW_ACCESS_TOKEN environment variable is required');
+        }
+        throw new Error('CONTENTFUL_ACCESS_TOKEN environment variable is required');
+    }
+    if (!environment) {
+        throw new Error('CONTENTFUL_ENVIRONMENT or CONTENTFUL_ENVIRONMENT_NAME environment variable is required');
+    }
+    return {
+        spaceId,
+        accessToken,
+        environment,
+    };
+}
+// ============================================================================
+// Field Selection Constants (re-exported from listing-fetch-params)
+// ============================================================================
+export { ARTICLE_LINK_FIELDS, ARTICLE_LISTING_FIELDS, ARTICLE_TYPE_LINK_FIELDS, CUSTOM_TYPE_LINK_FIELDS, getDefaultInclude, getListingLinkFetchParams, getResolutionScope as getFetchResolutionScope, getSingleEntityListingSelect, PAGE_BUNDLED_CUSTOM_TYPE_INCLUDE, PAGE_LINK_FIELDS, PERSON_LINK_FIELDS, resolveIncludeDepth, TAG_LINK_FIELDS, TAG_TYPE_LINK_FIELDS, } from './listing-fetch-params.js';
+/** @deprecated Use ARTICLE_LISTING_FIELDS */
+export const ARTICLE_LINK_FIELDS_LIGHT = ARTICLE_LISTING_FIELDS;
+export function createFullConverterContext(base, includes, assets, rawAssets, externalVideoEmbeds, options) {
+    return {
+        ...base,
+        includes,
+        assets,
+        rawAssets,
+        errors: [],
+        externalVideoEmbeds,
+        resolutionScope: getResolutionScopeFromOptions(options),
+    };
+}
+/** Merge parent `options.next.tags` with content-type tags (flat-nav passes collection tags down). */
+export function mergeFetchCacheTags(options, contentTags) {
+    const parentNext = options?.next ?? {};
+    return {
+        ...parentNext,
+        tags: [...new Set([...(parentNext.tags ?? []), ...contentTags])],
+    };
+}
+// ============================================================================
+// Asset and Include Conversion
+// ============================================================================
+export function convertAllAssets(response, context) {
+    const visuals = new Map();
+    const assets = response.includes?.Asset;
+    if (assets && assets.length > 0) {
+        for (const asset of assets) {
+            const visual = convertAssetToVisual(context, asset);
+            if (visual) {
+                visuals.set(visual.id, visual);
+            }
+        }
+    }
+    return visuals;
+}
+export function convertAllRawAssets(response) {
+    const rawAssets = new Map();
+    const assets = response.includes?.Asset;
+    if (assets && assets.length > 0) {
+        for (const asset of assets) {
+            rawAssets.set(asset.sys.id, asset);
+        }
+    }
+    return rawAssets;
+}
+export function convertAllIncludes(response) {
+    const includes = new Map();
+    const entries = [...response.items, ...(response.includes?.Entry || [])];
+    if (entries && entries.length > 0) {
+        for (const entry of entries) {
+            if (entry?.sys && entry.fields) {
+                includes.set(entry.sys.id, {
+                    id: entry.sys.id,
+                    type: entry.sys.contentType.sys.id,
+                    entry,
+                });
+            }
+        }
+    }
+    return includes;
+}
+// ============================================================================
+// Generic Single Entity Fetcher
+// ============================================================================
+/**
+ * Generic helper for fetching a single entity from Contentful.
+ * Handles caching, error handling, retry logic, and conversion consistently.
+ *
+ * @param context - Base converter context for content transformation
+ * @param config - Contentful configuration (spaceId, accessToken, environment)
+ * @param fetchConfig - Configuration for this specific fetch
+ * @param options - Optional fetch options (locale, preview, caching, retry)
+ * @returns Promise resolving to the entity or null if not found, with any conversion errors
+ */
+export async function fetchSingleEntity(context, config, fetchConfig, options) {
+    const client = getContentfulClient(config, options.preview);
+    // Set cache tags for this request
+    const cacheTags = getCacheTags(fetchConfig.cacheTagType, fetchConfig.cacheTagIdentifier, options?.preview);
+    const requestOptions = {
+        ...options,
+        next: {
+            ...options?.next,
+            tags: cacheTags,
+        },
+    };
+    const queryContext = {
+        operation: fetchConfig.logOperation ?? operationLabel(fetchConfig.contentType),
+        identifier: fetchConfig.cacheTagIdentifier,
+    };
+    const fetchFn = async () => withCmsQueryContext(queryContext, async () => {
+        const contentType = fetchConfig.contentType;
+        const include = resolveIncludeDepth(contentType, options);
+        const listingSelect = options.fetchProfile === 'listing' ? getSingleEntityListingSelect(contentType) : undefined;
+        const response = await client.getEntries({
+            content_type: fetchConfig.contentType,
+            ...fetchConfig.query,
+            include,
+            locale: options?.locale,
+            limit: 1,
+            ...(listingSelect && { select: listingSelect }),
+        }, requestOptions);
+        if (process.env.LOG_CMS) {
+            const entryCount = (response.includes?.Entry?.length ?? 0) + response.items.length;
+            console.debug(`[CMS] ${fetchConfig.contentType} fetch: include=${include}, entries in includes=${entryCount}`);
+        }
+        const entry = response.items[0];
+        if (!entry?.fields) {
+            return { data: null, errors: [] };
+        }
+        try {
+            const assets = convertAllAssets(response, context);
+            const rawAssets = convertAllRawAssets(response);
+            const includes = convertAllIncludes(response);
+            const externalVideoEmbeds = options.skipAssetEnrichment
+                ? new Map()
+                : await enrichAssetsForFetch(assets, includes, options);
+            const fullContext = createFullConverterContext(context, includes, assets, rawAssets, externalVideoEmbeds, options);
+            let converted = fetchConfig.resolver(fullContext, entry);
+            if (converted &&
+                typeof converted === 'object' &&
+                ('menu' in converted || 'icons' in converted)) {
+                converted = (await finalizeModelIconsAndNavigation(converted, context, config, options));
+            }
+            if (fullContext.errors.length > 0) {
+                console.error(`CMS conversion errors for ${fetchConfig.contentType}:`, {
+                    entryId: entry.sys.id,
+                    ...fetchConfig.errorLogContext,
+                    errors: fullContext.errors,
+                });
+            }
+            if (process.env.LOG_CMS) {
+                const r = converted;
+                if (r && ('contents' in r || 'contentCount' in r)) {
+                    console.debug(`[CMS] ${fetchConfig.contentType} result: contentCount=${r['contentCount']}, contents.length=${r['contents']?.length ?? 'n/a'}`);
+                }
+            }
+            return { data: converted, errors: fullContext.errors };
+        }
+        catch (error) {
+            const entryId = entry.sys.id;
+            const entryType = entry.sys.contentType?.sys?.id;
+            const errorMessage = error instanceof Error ? error.message : 'Unknown conversion error';
+            console.error(`[CMS] ${fetchConfig.contentType} conversion threw:`, errorMessage, {
+                entryId,
+                entryType,
+                ...fetchConfig.errorLogContext,
+            });
+            const cmsError = {
+                entryId,
+                entryType,
+                message: errorMessage,
+                error,
+            };
+            return { data: null, errors: [cmsError] };
+        }
+    });
+    // Apply retry logic if configured
+    if (options?.retry) {
+        return await withRetry(fetchFn, options.retry);
+    }
+    return await fetchFn();
+}
+// ============================================================================
+// Generic All Links Fetcher
+// ============================================================================
+/**
+ * Shared helper function for paginated Contentful link fetching.
+ * Returns links with lastModified metadata from sys.updatedAt.
+ */
+export async function fetchAllLinks(contentType, client, requestOptions, converter, context, pageSize = 100, select, include = 2) {
+    const allLinks = [];
+    const errors = [];
+    let skip = 0;
+    let hasMore = true;
+    const fetchFn = async () => {
+        while (hasMore) {
+            try {
+                const page = Math.floor(skip / pageSize) + 1;
+                const response = await withCmsQueryContext({ operation: allLinksOperationLabel(contentType, page) }, () => client.getEntries({
+                    content_type: contentType,
+                    order: 'sys.createdAt',
+                    include, // Default 2 for tag→tagType resolution on article link lists
+                    locale: requestOptions?.locale,
+                    limit: pageSize,
+                    skip,
+                    ...(select && { select }),
+                }, requestOptions));
+                if (response.items.length === 0) {
+                    hasMore = false;
+                    break;
+                }
+                // Convert entries to links
+                const includes = convertAllIncludes(response);
+                const assets = convertAllAssets(response, context);
+                const rawAssets = convertAllRawAssets(response);
+                const externalVideoEmbeds = requestOptions?.skipAssetEnrichment
+                    ? new Map()
+                    : await enrichAssetsForFetch(assets, includes, requestOptions);
+                const fullContext = createFullConverterContext(context, includes, assets, rawAssets, externalVideoEmbeds, {
+                    preview: requestOptions?.preview ?? false,
+                    ...requestOptions,
+                    fetchProfile: requestOptions?.fetchProfile ?? 'listing',
+                });
+                for (const entry of response.items) {
+                    if (!entry.fields)
+                        continue;
+                    try {
+                        const converted = converter(fullContext, entry);
+                        // Add lastModified from sys.updatedAt
+                        converted.lastModified = new Date(entry.sys.updatedAt);
+                        allLinks.push(converted);
+                    }
+                    catch (error) {
+                        const entryId = entry.sys.id;
+                        const entryType = entry.sys.contentType?.sys?.id;
+                        const errorMessage = error instanceof Error ? error.message : 'Unknown conversion error';
+                        errors.push({
+                            entryId,
+                            entryType,
+                            message: errorMessage,
+                            error,
+                        });
+                    }
+                }
+                skip += pageSize;
+                // Check if we've fetched all items
+                if (skip >= response.total) {
+                    hasMore = false;
+                }
+            }
+            catch (error) {
+                console.error('Error fetching links', typeof error, error, JSON.stringify(error, null, 2));
+                throw error;
+            }
+        }
+        return { data: allLinks, errors };
+    };
+    return await fetchFn();
+}
+//# sourceMappingURL=helpers.js.map

package/dist/api/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/api/helpers.ts"],"names":[],"mappings":"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"}

package/dist/api/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Contentful REST API Module
+ *
+ * Provides type-safe functions for fetching content from Contentful
+ * with support for caching, retry logic, and error handling.
+ */
+export type { CmsFetchProfile } from '../types';
+export { buildRedirectMap, filterSitemapEntriesExcludingRedirects, type RedirectMap, type RedirectMapEntry, } from '../utils/redirectMap';
+export { contentfulArticleRest } from './article';
+export { type ArticleTypeFetchOptions, contentfulArticleTypeRest } from './article-type';
+export { assetToMediaLibraryItem, buildAssetThumbUrl, clampMediaLibraryLimit, clampMediaLibraryPage, contentfulAssetRest, contentfulAssetsPageRest, isAnimationAsset, isBrowserViewable, isMediaLibraryKind, listAnimationsPage, listMediaLibraryPage, MEDIA_LIBRARY_DEFAULT_LIMIT, MEDIA_LIBRARY_KINDS, MEDIA_LIBRARY_MAX_LIMIT, MEDIA_LIBRARY_THUMB_WIDTH, type MediaLibraryItem, type MediaLibraryKind, type MediaLibraryPage, mediaLibraryKindForAsset, mediaLibraryPageToMarkdown, } from './asset';
+export { contentfulBannerRest } from './banner';
+export { type BreadcrumbLookup, type BreadcrumbLookupEntry, getBreadcrumbLookup, } from './breadcrumb';
+export { type AnyEntryRestResult, contentfulAnyEntryRest, contentfulComponentRest, } from './componentPreview';
+export { createBaseConverterContext } from './context';
+export { contentfulCustomTypeRest } from './custom-type';
+export { contentfulDocumentsRest } from './document';
+export { ARTICLE_LINK_FIELDS, ARTICLE_LINK_FIELDS_LIGHT, ARTICLE_LISTING_FIELDS, buildFetchOptions, coreGetContentfulConfig, getDefaultInclude, getListingLinkFetchParams, resolveIncludeDepth, } from './helpers';
+export { contentfulAllArticleLinks, contentfulAllArticleLinksForIntegrity, contentfulAllArticleTypeLinks, contentfulAllCustomTypeLinks, contentfulAllPageLinks, contentfulAllPersonLinks, contentfulAllTagLinks, contentfulAllTagTypeLinks, } from './links';
+export type { CmsContentType, ConverterResolutionScope } from './listing-fetch-params';
+export { getResolutionScope, getResolutionScopeFromOptions, LISTING_RESOLUTION_SCOPE, PAGE_CONTENT_SCOPE, PAGE_RESOLUTION_SCOPE, } from './listing-fetch-params';
+export { buildFlatNavigationCacheOptions, FLAT_NAV_CACHE_TAGS, FLAT_NAV_TIME_REVALIDATE_SECONDS, getNavigation, withFlatNavRequestCache, } from './navigation';
+export { contentfulPageRest } from './page';
+export { contentfulPersonRest, type PersonFetchOptions } from './person';
+export { type BuiltinPreviewContentType, getPreviewEntryInfo, type PreviewContentType, type PreviewEntryInclude, type PreviewEntryInfo, type PreviewEntryResolveInput, type PreviewEntryResolver, slugPreviewResolver, } from './preview';
+export { contentfulRedirectsRest } from './redirects';
+export { filterRelatedArticles } from './related-articles';
+export { contentfulArticleSitemapEntries, contentfulArticleTypeSitemapEntries, contentfulPageSitemapEntries, contentfulPersonSitemapEntries, contentfulTagSitemapEntries, createSitemapProvider, getAllSitemapEntries, } from './sitemap';
+export { contentfulTagRest, type TagFetchOptions } from './tag';
+export { contentfulTagTypeRest, type TagTypeFetchOptions } from './tag-type';
+export { contentfulTemplateRest, type IFetchedTemplate } from './template';
+export type { DefaultChainModifier, IContentfulRichText, ISitemapEntry, PossibleResolvedEntry, RelatedArticlesOptions, SitemapChangeFrequency, SitemapConfig, SitemapContentTypeConfig, SitemapEntryProvider, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"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"}

package/dist/api/index.js

@@ -0,0 +1,37 @@
+/**
+ * Contentful REST API Module
+ *
+ * Provides type-safe functions for fetching content from Contentful
+ * with support for caching, retry logic, and error handling.
+ */
+export { buildRedirectMap, filterSitemapEntriesExcludingRedirects, } from '../utils/redirectMap.js';
+// Single entity fetchers
+export { contentfulArticleRest } from './article.js';
+export { contentfulArticleTypeRest } from './article-type.js';
+export { assetToMediaLibraryItem, buildAssetThumbUrl, clampMediaLibraryLimit, clampMediaLibraryPage, contentfulAssetRest, contentfulAssetsPageRest, isAnimationAsset, isBrowserViewable, isMediaLibraryKind, listAnimationsPage, listMediaLibraryPage, MEDIA_LIBRARY_DEFAULT_LIMIT, MEDIA_LIBRARY_KINDS, MEDIA_LIBRARY_MAX_LIMIT, MEDIA_LIBRARY_THUMB_WIDTH, mediaLibraryKindForAsset, mediaLibraryPageToMarkdown, } from './asset.js';
+export { contentfulBannerRest } from './banner.js';
+export { getBreadcrumbLookup, } from './breadcrumb.js';
+export { contentfulAnyEntryRest, contentfulComponentRest, } from './componentPreview.js';
+// Context
+export { createBaseConverterContext } from './context.js';
+export { contentfulCustomTypeRest } from './custom-type.js';
+export { contentfulDocumentsRest } from './document.js';
+// Internal helpers (exported for extension by projects)
+export { ARTICLE_LINK_FIELDS, ARTICLE_LINK_FIELDS_LIGHT, ARTICLE_LISTING_FIELDS, buildFetchOptions, coreGetContentfulConfig, getDefaultInclude, getListingLinkFetchParams, resolveIncludeDepth, } from './helpers.js';
+// All links fetchers
+export { contentfulAllArticleLinks, contentfulAllArticleLinksForIntegrity, contentfulAllArticleTypeLinks, contentfulAllCustomTypeLinks, contentfulAllPageLinks, contentfulAllPersonLinks, contentfulAllTagLinks, contentfulAllTagTypeLinks, } from './links.js';
+export { getResolutionScope, getResolutionScopeFromOptions, LISTING_RESOLUTION_SCOPE, PAGE_CONTENT_SCOPE, PAGE_RESOLUTION_SCOPE, } from './listing-fetch-params.js';
+export { buildFlatNavigationCacheOptions, FLAT_NAV_CACHE_TAGS, FLAT_NAV_TIME_REVALIDATE_SECONDS, getNavigation, withFlatNavRequestCache, } from './navigation.js';
+export { contentfulPageRest } from './page.js';
+export { contentfulPersonRest } from './person.js';
+// Preview
+export { getPreviewEntryInfo, slugPreviewResolver, } from './preview.js';
+export { contentfulRedirectsRest } from './redirects.js';
+// Related articles
+export { filterRelatedArticles } from './related-articles.js';
+// Sitemap
+export { contentfulArticleSitemapEntries, contentfulArticleTypeSitemapEntries, contentfulPageSitemapEntries, contentfulPersonSitemapEntries, contentfulTagSitemapEntries, createSitemapProvider, getAllSitemapEntries, } from './sitemap.js';
+export { contentfulTagRest } from './tag.js';
+export { contentfulTagTypeRest } from './tag-type.js';
+export { contentfulTemplateRest } from './template.js';
+//# sourceMappingURL=index.js.map

package/dist/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,gBAAgB,EAChB,sCAAsC,GAGvC,MAAM,sBAAsB,CAAC;AAC9B,yBAAyB;AACzB,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAgC,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AACzF,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,EACnB,wBAAwB,EACxB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,2BAA2B,EAC3B,mBAAmB,EACnB,uBAAuB,EACvB,yBAAyB,EAIzB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAGL,mBAAmB,GACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EAEL,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,UAAU;AACV,OAAO,EAAE,0BAA0B,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACrD,wDAAwD;AACxD,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,sBAAsB,EACtB,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EACjB,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,WAAW,CAAC;AACnB,qBAAqB;AACrB,OAAO,EACL,yBAAyB,EACzB,qCAAqC,EACrC,6BAA6B,EAC7B,4BAA4B,EAC5B,sBAAsB,EACtB,wBAAwB,EACxB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,kBAAkB,EAClB,6BAA6B,EAC7B,wBAAwB,EACxB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,+BAA+B,EAC/B,mBAAmB,EACnB,gCAAgC,EAChC,aAAa,EACb,uBAAuB,GACxB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAA2B,MAAM,UAAU,CAAC;AACzE,UAAU;AACV,OAAO,EAEL,mBAAmB,EAMnB,mBAAmB,GACpB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,mBAAmB;AACnB,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,UAAU;AACV,OAAO,EACL,+BAA+B,EAC/B,mCAAmC,EACnC,4BAA4B,EAC5B,8BAA8B,EAC9B,2BAA2B,EAC3B,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,iBAAiB,EAAwB,MAAM,OAAO,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAA4B,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAyB,MAAM,YAAY,CAAC"}

package/dist/api/links.d.ts

@@ -0,0 +1,124 @@
+import type { IArticleTypeLink, IInternalLink, IPersonLink } from '@se-studio/core-data-types';
+import { type IContentfulArticleLink } from '../converters/article';
+import type { BaseConverterContext } from '../converters/helpers';
+import type { CmsResponse, ContentfulConfig, FetchOptions } from '../types';
+/**
+ * Fetches all page links from Contentful for static params generation.
+ * Includes lastModified metadata from sys.updatedAt for sitemap generation.
+ *
+ * @param context - Converter context
+ * @param config - Contentful configuration
+ * @param options - Fetch options (locale, preview, caching, etc.)
+ * @returns Promise resolving to CmsResponse with array of page links (with metadata) and any errors
+ *
+ * @example
+ * ```ts
+ * const response = await contentfulAllPageLinks(
+ *   context,
+ *   config,
+ *   { preview: false }
+ * );
+ * console.log(response.data); // successful page links with lastModified
+ * console.log(response.errors); // any conversion errors
+ * ```
+ */
+export declare function contentfulAllPageLinks(context: BaseConverterContext, config: ContentfulConfig, options: FetchOptions): Promise<CmsResponse<IInternalLink[]>>;
+/**
+ * Fetches all article links from Contentful for static params generation.
+ * Includes lastModified metadata from sys.updatedAt for sitemap generation.
+ *
+ * @param context - Converter context
+ * @param config - Contentful configuration
+ * @param options - Fetch options (locale, preview, caching, etc.)
+ * @returns Promise resolving to CmsResponse with array of article links (with metadata) and any errors
+ *
+ * @example
+ * ```ts
+ * const response = await contentfulAllArticleLinks(
+ *   context,
+ *   config,
+ *   { preview: false }
+ * );
+ * console.log(response.data); // successful article links with lastModified
+ * console.log(response.errors); // any conversion errors
+ * ```
+ */
+export declare function contentfulAllArticleLinks(context: BaseConverterContext, config: ContentfulConfig, options: FetchOptions): Promise<CmsResponse<IContentfulArticleLink[]>>;
+/**
+ * Fetches all article links with body-content fields for smoke/integrity checks.
+ * Uses {@link ARTICLE_LINK_FIELDS} so `hasBodyContent` and href rules match production
+ * without a second presence query.
+ */
+export declare function contentfulAllArticleLinksForIntegrity(context: BaseConverterContext, config: ContentfulConfig, options: FetchOptions): Promise<CmsResponse<IContentfulArticleLink[]>>;
+/**
+ * Fetches all tag links from Contentful for static params generation.
+ * Includes lastModified metadata from sys.updatedAt for sitemap generation.
+ *
+ * @param context - Converter context
+ * @param config - Contentful configuration
+ * @param options - Fetch options (locale, preview, caching, etc.)
+ * @returns Promise resolving to CmsResponse with array of tag links (with metadata) and any errors
+ *
+ * @example
+ * ```ts
+ * const response = await contentfulAllTagLinks(
+ *   context,
+ *   config,
+ *   { preview: false }
+ * );
+ * console.log(response.data); // successful tag links with lastModified
+ * console.log(response.errors); // any conversion errors
+ * ```
+ */
+export declare function contentfulAllTagLinks(context: BaseConverterContext, config: ContentfulConfig, options: FetchOptions): Promise<CmsResponse<IInternalLink[]>>;
+/**
+ * Fetches all person links from Contentful for static params generation.
+ * Includes lastModified metadata from sys.updatedAt for sitemap generation.
+ *
+ * @param context - Converter context
+ * @param config - Contentful configuration
+ * @param options - Fetch options (locale, preview, caching, etc.)
+ * @returns Promise resolving to CmsResponse with array of person links (with metadata) and any errors
+ *
+ * @example
+ * ```ts
+ * const response = await contentfulAllPersonLinks(
+ *   context,
+ *   config,
+ *   { preview: false }
+ * );
+ * console.log(response.data); // successful person links with lastModified
+ * console.log(response.errors); // any conversion errors
+ * ```
+ */
+export declare function contentfulAllPersonLinks(context: BaseConverterContext, config: ContentfulConfig, options: FetchOptions): Promise<CmsResponse<IPersonLink[]>>;
+/**
+ * Fetches all article type links from Contentful for static params generation.
+ * Includes lastModified metadata from sys.updatedAt for sitemap generation.
+ *
+ * @param context - Converter context
+ * @param config - Contentful configuration
+ * @param options - Fetch options (locale, preview, caching, etc.)
+ * @returns Promise resolving to CmsResponse with array of article type links (with metadata) and any errors
+ *
+ * @example
+ * ```ts
+ * const response = await contentfulAllArticleTypeLinks(
+ *   context,
+ *   config,
+ *   { preview: false }
+ * );
+ * console.log(response.data); // successful article type links with lastModified
+ * console.log(response.errors); // any conversion errors
+ * ```
+ */
+export declare function contentfulAllArticleTypeLinks(context: BaseConverterContext, config: ContentfulConfig, options: FetchOptions): Promise<CmsResponse<IArticleTypeLink[]>>;
+/**
+ * Fetches all custom type links from Contentful for static params generation.
+ */
+export declare function contentfulAllCustomTypeLinks(context: BaseConverterContext, config: ContentfulConfig, options: FetchOptions): Promise<CmsResponse<IInternalLink[]>>;
+/**
+ * Fetches all tag type links from Contentful for static params generation.
+ */
+export declare function contentfulAllTagTypeLinks(context: BaseConverterContext, config: ContentfulConfig, options: FetchOptions): Promise<CmsResponse<IInternalLink[]>>;
+//# sourceMappingURL=links.d.ts.map

package/dist/api/links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"links.d.ts","sourceRoot":"","sources":["../../src/api/links.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAG/F,OAAO,EAGL,KAAK,sBAAsB,EAC5B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAQlE,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAqB5E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC,CAAC,CAIvC;AA6DD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,WAAW,CAAC,sBAAsB,EAAE,CAAC,CAAC,CAIhD;AAsCD;;;;GAIG;AACH,wBAAsB,qCAAqC,CACzD,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,WAAW,CAAC,sBAAsB,EAAE,CAAC,CAAC,CA4BhD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC,CAAC,CAIvC;AAsCD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC,CAIrC;AAsCD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,WAAW,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAI1C;AAsCD;;GAEG;AACH,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC,CAAC,CAIvC;AAsCD;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC,CAAC,CAIvC"}