@se-studio/contentful-rest-api 1.0.45 → 1.0.47

package/dist/api/person.js.map

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

package/dist/api/preview.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Preview page utilities for Contentful
+ *
+ * Provides functionality to look up an entry by ID and calculate the
+ * appropriate URL for preview redirects.
+ */
+import type { BaseConverterContext } from '../converters/helpers';
+import type { ContentfulConfig, FetchOptions } from '../types';
+/**
+ * Supported content types for preview lookup
+ */
+export type PreviewContentType = 'page' | 'pageVariant' | 'article' | 'articleType' | 'tag' | 'person' | 'customType';
+/**
+ * Information about an entry for preview purposes
+ */
+export interface PreviewEntryInfo {
+    /** The content type of the entry */
+    contentType: PreviewContentType;
+    /** The Contentful entry ID */
+    entryId: string;
+    /** The slug of the entry */
+    slug: string;
+    /** For articles, the article type's slug (needed for URL calculation) */
+    articleTypeSlug?: string;
+    /** The calculated URL for this entry */
+    href: string;
+}
+/**
+ * Looks up a Contentful entry by ID and returns information needed for preview redirect.
+ *
+ * Makes a single API call to fetch the entry by ID, determines its content type,
+ * extracts the relevant slug fields, and calculates the URL using the context's
+ * URL calculators.
+ *
+ * @param context - Base converter context containing URL calculators
+ * @param config - Contentful configuration (spaceId, accessToken, etc.)
+ * @param entryId - The Contentful entry ID to look up
+ * @param options - Optional fetch options (preview mode is always enabled for this function)
+ * @returns PreviewEntryInfo with content type, slug, and calculated href, or null if not found
+ *
+ * @example
+ * ```ts
+ * const context = createBaseConverterContext();
+ * const info = await getPreviewEntryInfo(
+ *   context,
+ *   { spaceId: '...', accessToken: '...' },
+ *   'abc123'
+ * );
+ * if (info) {
+ *   redirect(info.href);
+ * }
+ * ```
+ */
+export declare function getPreviewEntryInfo(context: BaseConverterContext, config: ContentfulConfig, entryId: string, options?: Omit<FetchOptions, 'preview'>): Promise<PreviewEntryInfo | null>;
+//# sourceMappingURL=preview.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../src/api/preview.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B,MAAM,GACN,aAAa,GACb,SAAS,GACT,aAAa,GACb,KAAK,GACL,QAAQ,GACR,YAAY,CAAC;AAEjB;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oCAAoC;IACpC,WAAW,EAAE,kBAAkB,CAAC;IAChC,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;CACd;AA2BD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,GACtC,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CA8GlC"}

package/dist/api/preview.js

@@ -0,0 +1,160 @@
+/**
+ * Preview page utilities for Contentful
+ *
+ * Provides functionality to look up an entry by ID and calculate the
+ * appropriate URL for preview redirects.
+ */
+import { getContentfulClient } from '../client';
+/**
+ * Looks up a Contentful entry by ID and returns information needed for preview redirect.
+ *
+ * Makes a single API call to fetch the entry by ID, determines its content type,
+ * extracts the relevant slug fields, and calculates the URL using the context's
+ * URL calculators.
+ *
+ * @param context - Base converter context containing URL calculators
+ * @param config - Contentful configuration (spaceId, accessToken, etc.)
+ * @param entryId - The Contentful entry ID to look up
+ * @param options - Optional fetch options (preview mode is always enabled for this function)
+ * @returns PreviewEntryInfo with content type, slug, and calculated href, or null if not found
+ *
+ * @example
+ * ```ts
+ * const context = createBaseConverterContext();
+ * const info = await getPreviewEntryInfo(
+ *   context,
+ *   { spaceId: '...', accessToken: '...' },
+ *   'abc123'
+ * );
+ * if (info) {
+ *   redirect(info.href);
+ * }
+ * ```
+ */
+export async function getPreviewEntryInfo(context, config, entryId, options) {
+    // Always use preview API for preview lookups
+    const client = getContentfulClient(config, true);
+    const response = await client.getEntries({
+        'sys.id': entryId,
+        include: 1, // Need 1 level for Article → ArticleType slug
+    }, {
+        ...options,
+        preview: true,
+    });
+    const entry = response.items[0];
+    if (!entry) {
+        return null;
+    }
+    const contentTypeId = entry.sys.contentType.sys.id;
+    const { fields } = entry;
+    // Map Contentful content type ID to our PreviewContentType
+    // and extract the relevant slug and calculate href
+    switch (contentTypeId) {
+        case 'page': {
+            const slug = fields.slug;
+            if (!slug)
+                return null;
+            return {
+                contentType: 'page',
+                entryId,
+                slug,
+                href: context.urlCalculators.page(slug),
+            };
+        }
+        case 'pageVariant': {
+            const slug = fields.slug;
+            if (!slug)
+                return null;
+            return {
+                contentType: 'pageVariant',
+                entryId,
+                slug,
+                href: context.urlCalculators.pageVariant(slug),
+            };
+        }
+        case 'article': {
+            const slug = fields.slug;
+            // For articles, we need the articleType's slug from the included entry
+            const articleTypeSlug = getArticleTypeSlug(entry, response.includes?.Entry);
+            if (!slug || !articleTypeSlug)
+                return null;
+            return {
+                contentType: 'article',
+                entryId,
+                slug,
+                articleTypeSlug,
+                href: context.urlCalculators.article(articleTypeSlug, slug),
+            };
+        }
+        case 'articleType': {
+            const slug = fields.slug;
+            if (!slug)
+                return null;
+            return {
+                contentType: 'articleType',
+                entryId,
+                slug,
+                href: context.urlCalculators.articleType(slug),
+            };
+        }
+        case 'tag': {
+            const slug = fields.slug;
+            if (!slug)
+                return null;
+            return {
+                contentType: 'tag',
+                entryId,
+                slug,
+                href: context.urlCalculators.tag(slug),
+            };
+        }
+        case 'person': {
+            const slug = fields.slug;
+            if (!slug)
+                return null;
+            return {
+                contentType: 'person',
+                entryId,
+                slug,
+                href: context.urlCalculators.person(slug),
+            };
+        }
+        case 'customType': {
+            const slug = fields.slug;
+            if (!slug)
+                return null;
+            return {
+                contentType: 'customType',
+                entryId,
+                slug,
+                href: context.urlCalculators.customType(slug),
+            };
+        }
+        default:
+            // Unknown content type - not supported for preview
+            return null;
+    }
+}
+/**
+ * Extracts the article type slug from an article entry.
+ * Looks in the entry's articleType field, falling back to includes if needed.
+ */
+function getArticleTypeSlug(entry, includes) {
+    // First, check if articleType is resolved in the entry
+    const articleTypeField = entry.fields.articleType;
+    if (!articleTypeField) {
+        return undefined;
+    }
+    // If the articleType has fields (resolved), get slug from there
+    if (articleTypeField.fields?.slug) {
+        return articleTypeField.fields.slug;
+    }
+    // Otherwise, look it up in includes
+    const articleTypeId = articleTypeField.sys?.id;
+    if (!articleTypeId || !includes) {
+        return undefined;
+    }
+    const articleTypeEntry = includes.find((inc) => inc.sys.id === articleTypeId);
+    return articleTypeEntry?.fields?.slug;
+}
+//# sourceMappingURL=preview.js.map

package/dist/api/preview.js.map

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

package/dist/api/related-articles.d.ts

@@ -0,0 +1,22 @@
+import type { IArticleLink } from '@se-studio/core-data-types';
+import type { RelatedArticlesOptions } from './types';
+/**
+ * Filters and ranks articles based on related article criteria.
+ * Articles with more matching tags are ranked higher.
+ *
+ * @param articles - Array of article links with metadata
+ * @param options - Filtering options
+ * @returns Filtered and ranked array of article links
+ *
+ * @example
+ * ```ts
+ * const relatedArticles = filterRelatedArticles(allArticles, {
+ *   articleTypeIds: ['blog-type-id'],
+ *   tagIds: ['tag-1', 'tag-2'],
+ *   excludeArticleIds: [currentArticle.id],
+ *   count: 3,
+ * });
+ * ```
+ */
+export declare function filterRelatedArticles(articles: IArticleLink[], options: RelatedArticlesOptions): IArticleLink[];
+//# sourceMappingURL=related-articles.d.ts.map

package/dist/api/related-articles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"related-articles.d.ts","sourceRoot":"","sources":["../../src/api/related-articles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEtD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,YAAY,EAAE,EACxB,OAAO,EAAE,sBAAsB,GAC9B,YAAY,EAAE,CAiFhB"}

package/dist/api/related-articles.js

@@ -0,0 +1,82 @@
+/**
+ * Filters and ranks articles based on related article criteria.
+ * Articles with more matching tags are ranked higher.
+ *
+ * @param articles - Array of article links with metadata
+ * @param options - Filtering options
+ * @returns Filtered and ranked array of article links
+ *
+ * @example
+ * ```ts
+ * const relatedArticles = filterRelatedArticles(allArticles, {
+ *   articleTypeIds: ['blog-type-id'],
+ *   tagIds: ['tag-1', 'tag-2'],
+ *   excludeArticleIds: [currentArticle.id],
+ *   count: 3,
+ * });
+ * ```
+ */
+export function filterRelatedArticles(articles, options) {
+    const { excludeArticleIds, articleTypeIds: rawArticleTypeIds, tagIds: rawTagIds, authorIds: rawAuthorIds, before, after, count, } = options;
+    // Extract and deduplicate IDs from link objects
+    const excludeIds = excludeArticleIds ? [...new Set(excludeArticleIds)] : [];
+    const articleTypeIds = rawArticleTypeIds ? [...new Set(rawArticleTypeIds)] : [];
+    const tagIds = rawTagIds ? [...new Set(rawTagIds)] : [];
+    const authorIds = rawAuthorIds ? [...new Set(rawAuthorIds)] : [];
+    // Score and filter articles
+    const scoredArticles = articles
+        .map((article) => {
+        let score = 0;
+        // Filter: Exclude specific articles
+        if (excludeIds.length > 0 && excludeIds.includes(article.id)) {
+            return null;
+        }
+        // Filter: Article type (match any of the provided types)
+        if (articleTypeIds.length > 0) {
+            if (!article.articleType?.id || !articleTypeIds.includes(article.articleType.id)) {
+                return null;
+            }
+        }
+        // Filter: Date range
+        if (article.date) {
+            const articleDate = new Date(article.date);
+            if (before && articleDate > before) {
+                return null;
+            }
+            if (after && articleDate < after) {
+                return null;
+            }
+        }
+        // Score: Tag matching (more matches = higher score)
+        if (tagIds.length > 0 && article.tags) {
+            const articleTagIds = article.tags.map((tag) => tag.id);
+            const matchingTags = tagIds.filter((tagId) => articleTagIds.includes(tagId));
+            score += matchingTags.length * 10; // Each matching tag adds 10 points
+        }
+        // Score: Author matching (match any of the provided authors)
+        if (authorIds.length > 0 && article.author?.id) {
+            if (authorIds.includes(article.author.id)) {
+                score += 5; // Matching author adds 5 points
+            }
+        }
+        return { article, score };
+    })
+        .filter((item) => item !== null);
+    // Sort by score (descending), then by date (descending)
+    scoredArticles.sort((a, b) => {
+        if (b.score !== a.score) {
+            return b.score - a.score;
+        }
+        // If scores are equal, sort by date (newest first)
+        if (a.article.date && b.article.date) {
+            const articleDateA = new Date(a.article.date);
+            const articleDateB = new Date(b.article.date);
+            return articleDateB.getTime() - articleDateA.getTime();
+        }
+        return 0;
+    });
+    // Take top N articles (or all if count is undefined)
+    const topArticles = count !== undefined ? scoredArticles.slice(0, count) : scoredArticles;
+    return topArticles.map(({ article }) => article);
+}
+//# sourceMappingURL=related-articles.js.map

package/dist/api/related-articles.js.map

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

package/dist/api/server-asset.d.ts

@@ -0,0 +1,40 @@
+import 'server-only';
+import type { NextRequest } from 'next/server';
+import type { ContentfulConfig } from '../types';
+/**
+ * Configuration for creating a download handler
+ */
+export interface DownloadHandlerConfig {
+    /**
+     * Function to get the Contentful configuration.
+     * Called on each request to allow for dynamic config.
+     */
+    getConfig: (preview?: boolean) => ContentfulConfig;
+    /**
+     * Default cache revalidation time in seconds.
+     * Defaults to 86400 (24 hours).
+     */
+    revalidate?: number;
+    /**
+     * Whether to use preview API.
+     * Defaults to false.
+     */
+    preview?: boolean;
+}
+/**
+ * Route params structure for Next.js App Router
+ */
+export interface DownloadRouteParams {
+    params: Promise<{
+        assetId: string;
+        filename: string;
+    }>;
+}
+/**
+ * Creates a Next.js App Router GET handler for downloading/viewing Contentful assets.
+ *
+ * @param config - Download handler configuration
+ * @returns GET handler function for Next.js route
+ */
+export declare function createDownloadHandler(config: DownloadHandlerConfig): (_request: NextRequest, { params }: DownloadRouteParams) => Promise<Response>;
+//# sourceMappingURL=server-asset.d.ts.map

package/dist/api/server-asset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-asset.d.ts","sourceRoot":"","sources":["../../src/api/server-asset.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAGjD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,SAAS,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,KAAK,gBAAgB,CAAC;IAEnD;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,OAAO,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;CACJ;AAYD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,IAI/D,UAAU,WAAW,EACrB,YAAY,mBAAmB,KAC9B,OAAO,CAAC,QAAQ,CAAC,CAkErB"}

package/dist/api/server-asset.js

@@ -0,0 +1,65 @@
+import 'server-only';
+import { getCacheTags } from '../revalidation/utils';
+import { contentfulAssetRest, isBrowserViewable } from './asset';
+/**
+ * Creates a Next.js App Router GET handler for downloading/viewing Contentful assets.
+ *
+ * @param config - Download handler configuration
+ * @returns GET handler function for Next.js route
+ */
+export function createDownloadHandler(config) {
+    const { getConfig, revalidate = 86400, preview = false } = config;
+    return async function GET(_request, { params }) {
+        const { assetId, filename } = await params;
+        // Decode the filename (in case it was URL-encoded)
+        const decodedFilename = decodeURIComponent(filename);
+        try {
+            // Get Contentful config
+            const contentfulConfig = getConfig(preview);
+            // Fetch asset metadata from Contentful (uses client with rate limiting)
+            const asset = await contentfulAssetRest(contentfulConfig, assetId, {
+                preview,
+                next: { revalidate },
+            });
+            if (!asset?.fields?.file) {
+                return Response.json({ error: 'Asset not found' }, { status: 404 });
+            }
+            const { file } = asset.fields;
+            const assetUrl = `https:${file.url}`;
+            // Fetch the actual file from Contentful CDN
+            const cacheTags = getCacheTags('asset', assetId, preview);
+            const fileFetchOptions = {
+                next: {
+                    revalidate,
+                    tags: cacheTags,
+                },
+            };
+            const fileResponse = await fetch(assetUrl, fileFetchOptions);
+            if (!fileResponse.ok) {
+                return Response.json({ error: 'Failed to fetch file' }, { status: 502 });
+            }
+            // Build response headers
+            const headers = new Headers();
+            // Content type from Contentful
+            headers.set('Content-Type', file.contentType);
+            // Content-Disposition: inline opens in browser, attachment forces download
+            const disposition = isBrowserViewable(file.contentType) ? 'inline' : 'attachment';
+            headers.set('Content-Disposition', `${disposition}; filename="${decodedFilename}"`);
+            // Set content length if available
+            if (file.details?.size) {
+                headers.set('Content-Length', String(file.details.size));
+            }
+            // Cache control
+            headers.set('Cache-Control', `public, max-age=${revalidate}, s-maxage=${revalidate}`);
+            return new Response(fileResponse.body, {
+                status: 200,
+                headers,
+            });
+        }
+        catch (error) {
+            console.error('[Download] Error proxying file:', error);
+            return Response.json({ error: 'Internal server error' }, { status: 500 });
+        }
+    };
+}
+//# sourceMappingURL=server-asset.js.map

package/dist/api/server-asset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-asset.js","sourceRoot":"","sources":["../../src/api/server-asset.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,CAAC;AAErB,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AA6CjE;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAA6B;IACjE,MAAM,EAAE,SAAS,EAAE,UAAU,GAAG,KAAK,EAAE,OAAO,GAAG,KAAK,EAAE,GAAG,MAAM,CAAC;IAElE,OAAO,KAAK,UAAU,GAAG,CACvB,QAAqB,EACrB,EAAE,MAAM,EAAuB;QAE/B,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC;QAE3C,mDAAmD;QACnD,MAAM,eAAe,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QAErD,IAAI,CAAC;YACH,wBAAwB;YACxB,MAAM,gBAAgB,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;YAE5C,wEAAwE;YACxE,MAAM,KAAK,GAAG,MAAM,mBAAmB,CAAC,gBAAgB,EAAE,OAAO,EAAE;gBACjE,OAAO;gBACP,IAAI,EAAE,EAAE,UAAU,EAAE;aACrB,CAAC,CAAC;YAEH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;gBACzB,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,iBAAiB,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YACtE,CAAC;YAED,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC;YAC9B,MAAM,QAAQ,GAAG,SAAS,IAAI,CAAC,GAAG,EAAE,CAAC;YAErC,4CAA4C;YAC5C,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAE1D,MAAM,gBAAgB,GAAyB;gBAC7C,IAAI,EAAE;oBACJ,UAAU;oBACV,IAAI,EAAE,SAAS;iBAChB;aACF,CAAC;YAEF,MAAM,YAAY,GAAG,MAAM,KAAK,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;YAE7D,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,CAAC;gBACrB,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,sBAAsB,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YAC3E,CAAC;YAED,yBAAyB;YACzB,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;YAE9B,+BAA+B;YAC/B,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;YAE9C,2EAA2E;YAC3E,MAAM,WAAW,GAAG,iBAAiB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC;YAClF,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,GAAG,WAAW,eAAe,eAAe,GAAG,CAAC,CAAC;YAEpF,kCAAkC;YAClC,IAAI,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;gBACvB,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;YAC3D,CAAC;YAED,gBAAgB;YAChB,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,mBAAmB,UAAU,cAAc,UAAU,EAAE,CAAC,CAAC;YAEtF,OAAO,IAAI,QAAQ,CAAC,YAAY,CAAC,IAAI,EAAE;gBACrC,MAAM,EAAE,GAAG;gBACX,OAAO;aACR,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,iCAAiC,EAAE,KAAK,CAAC,CAAC;YACxD,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,uBAAuB,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/api/sitemap.d.ts

@@ -0,0 +1,131 @@
+import type { BaseConverterContext } from '../converters/helpers';
+import type { CmsResponse, ContentfulConfig, FetchOptions } from '../types';
+import type { ISitemapEntry, SitemapConfig, SitemapContentTypeConfig, SitemapEntryProvider } from './types';
+/**
+ * Fetches all page sitemap entries from Contentful.
+ * Only includes pages that are indexed and not hidden.
+ *
+ * @param context - Converter context
+ * @param config - Contentful configuration
+ * @param sitemapConfig - Optional sitemap configuration (priority, changeFrequency)
+ * @param options - Fetch options (locale, preview, caching, etc.)
+ * @returns Promise resolving to CmsResponse with array of sitemap entries
+ *
+ * @example
+ * ```ts
+ * const { data: entries } = await contentfulPageSitemapEntries(
+ *   context,
+ *   config,
+ *   { priority: 0.8, changeFrequency: 'weekly' },
+ *   { next: { revalidate: 3600 } }
+ * );
+ * ```
+ */
+export declare function contentfulPageSitemapEntries(context: BaseConverterContext, config: ContentfulConfig, sitemapConfig: SitemapContentTypeConfig, options: FetchOptions): Promise<CmsResponse<ISitemapEntry[]>>;
+/**
+ * Fetches all article sitemap entries from Contentful.
+ * Only includes articles that are indexed and not hidden.
+ *
+ * @param context - Converter context
+ * @param config - Contentful configuration
+ * @param sitemapConfig - Optional sitemap configuration (priority, changeFrequency)
+ * @param options - Fetch options (locale, preview, caching, etc.)
+ * @returns Promise resolving to CmsResponse with array of sitemap entries
+ *
+ * @example
+ * ```ts
+ * const { data: entries } = await contentfulArticleSitemapEntries(
+ *   context,
+ *   config,
+ *   { priority: 0.6, changeFrequency: 'monthly' },
+ *   { next: { revalidate: 3600 } }
+ * );
+ * ```
+ */
+export declare function contentfulArticleSitemapEntries(context: BaseConverterContext, config: ContentfulConfig, sitemapConfig: SitemapContentTypeConfig, options: FetchOptions): Promise<CmsResponse<ISitemapEntry[]>>;
+/**
+ * Fetches all article type sitemap entries from Contentful.
+ * Only includes article types that are indexed and not hidden.
+ *
+ * @param context - Converter context
+ * @param config - Contentful configuration
+ * @param sitemapConfig - Optional sitemap configuration (priority, changeFrequency)
+ * @param options - Fetch options (locale, preview, caching, etc.)
+ * @returns Promise resolving to CmsResponse with array of sitemap entries
+ */
+export declare function contentfulArticleTypeSitemapEntries(context: BaseConverterContext, config: ContentfulConfig, sitemapConfig: SitemapContentTypeConfig, options: FetchOptions): Promise<CmsResponse<ISitemapEntry[]>>;
+/**
+ * Fetches all tag sitemap entries from Contentful.
+ * Only includes tags that are indexed and not hidden.
+ *
+ * @param context - Converter context
+ * @param config - Contentful configuration
+ * @param sitemapConfig - Optional sitemap configuration (priority, changeFrequency)
+ * @param options - Fetch options (locale, preview, caching, etc.)
+ * @returns Promise resolving to CmsResponse with array of sitemap entries
+ */
+export declare function contentfulTagSitemapEntries(context: BaseConverterContext, config: ContentfulConfig, sitemapConfig: SitemapContentTypeConfig, options: FetchOptions): Promise<CmsResponse<ISitemapEntry[]>>;
+/**
+ * Fetches all person sitemap entries from Contentful.
+ * Only includes people that are indexed and not hidden.
+ *
+ * @param context - Converter context
+ * @param config - Contentful configuration
+ * @param sitemapConfig - Optional sitemap configuration (priority, changeFrequency)
+ * @param options - Fetch options (locale, preview, caching, etc.)
+ * @returns Promise resolving to CmsResponse with array of sitemap entries
+ */
+export declare function contentfulPersonSitemapEntries(context: BaseConverterContext, config: ContentfulConfig, sitemapConfig: SitemapContentTypeConfig, options: FetchOptions): Promise<CmsResponse<ISitemapEntry[]>>;
+/**
+ * Collects sitemap entries from multiple providers.
+ * This allows projects to register custom content types for sitemap generation.
+ *
+ * @param context - Converter context
+ * @param config - Contentful configuration
+ * @param sitemapConfig - Configuration with array of provider functions
+ * @param options - Fetch options (locale, preview, caching, etc.)
+ * @returns Promise resolving to CmsResponse with all sitemap entries combined
+ *
+ * @example
+ * ```ts
+ * const { data: entries, errors } = await getAllSitemapEntries(
+ *   context,
+ *   config,
+ *   {
+ *     providers: [
+ *       (ctx, cfg, opts) => contentfulPageSitemapEntries(ctx, cfg, { priority: 0.8 }, opts),
+ *       (ctx, cfg, opts) => contentfulArticleSitemapEntries(ctx, cfg, { priority: 0.6 }, opts),
+ *       // Custom content type provider
+ *       async (ctx, cfg, opts) => {
+ *         const links = await fetchCustomContentLinks(ctx, cfg, opts);
+ *         return { data: links.map(l => ({ url: l.href, lastModified: l.lastModified })), errors: [] };
+ *       },
+ *     ],
+ *   },
+ *   { next: { revalidate: 3600 } }
+ * );
+ * ```
+ */
+export declare function getAllSitemapEntries(context: BaseConverterContext, config: ContentfulConfig, sitemapConfig: SitemapConfig, options: FetchOptions): Promise<CmsResponse<ISitemapEntry[]>>;
+/**
+ * Creates a sitemap entry provider with pre-configured options.
+ * Useful for creating providers with specific priority and changeFrequency settings.
+ *
+ * @param fetcher - The sitemap entry fetcher function to wrap
+ * @param sitemapConfig - Configuration for priority and change frequency
+ * @returns A sitemap entry provider function
+ *
+ * @example
+ * ```ts
+ * const pageProvider = createSitemapProvider(
+ *   contentfulPageSitemapEntries,
+ *   { priority: 0.8, changeFrequency: 'weekly' }
+ * );
+ *
+ * const { data: entries } = await getAllSitemapEntries(context, config, {
+ *   providers: [pageProvider, articleProvider],
+ * });
+ * ```
+ */
+export declare function createSitemapProvider(fetcher: (context: BaseConverterContext, config: ContentfulConfig, sitemapConfig: SitemapContentTypeConfig, options: FetchOptions) => Promise<CmsResponse<ISitemapEntry[]>>, sitemapConfig: SitemapContentTypeConfig): SitemapEntryProvider;
+//# sourceMappingURL=sitemap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sitemap.d.ts","sourceRoot":"","sources":["../../src/api/sitemap.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAAY,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAQtF,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,wBAAwB,EACxB,oBAAoB,EACrB,MAAM,SAAS,CAAC;AAgCjB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,gBAAgB,EACxB,aAAa,EAAE,wBAAwB,EACvC,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC,CAAC,CAMvC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,+BAA+B,CACnD,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,gBAAgB,EACxB,aAAa,EAAE,wBAAwB,EACvC,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC,CAAC,CAMvC;AAED;;;;;;;;;GASG;AACH,wBAAsB,mCAAmC,CACvD,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,gBAAgB,EACxB,aAAa,EAAE,wBAAwB,EACvC,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC,CAAC,CAMvC;AAED;;;;;;;;;GASG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,gBAAgB,EACxB,aAAa,EAAE,wBAAwB,EACvC,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC,CAAC,CAMvC;AAED;;;;;;;;;GASG;AACH,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,gBAAgB,EACxB,aAAa,EAAE,wBAAwB,EACvC,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC,CAAC,CAMvC;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,gBAAgB,EACxB,aAAa,EAAE,aAAa,EAC5B,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC,CAAC,CAgBvC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,CACP,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,gBAAgB,EACxB,aAAa,EAAE,wBAAwB,EACvC,OAAO,EAAE,YAAY,KAClB,OAAO,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC,CAAC,EAC1C,aAAa,EAAE,wBAAwB,GACtC,oBAAoB,CAEtB"}