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

package/dist/api/preview-types.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Shared types for Contentful Live Preview entry → URL resolution.
+ * Kept separate from preview.ts / helpers.ts to avoid circular imports and
+ * so {@link PreviewEntryResolver} can return {@link PreviewEntryInfo} cleanly.
+ */
+import type { UrlCalculators } from '../converters/helpers';
+/**
+ * Built-in content types handled by {@link getPreviewEntryInfo} without project resolvers.
+ */
+export type BuiltinPreviewContentType = 'page' | 'pageVariant' | 'pageTest' | 'article' | 'articleType' | 'tag' | 'person' | 'customType';
+/**
+ * Content type id for a preview entry.
+ * Built-ins plus customer-specific types registered via {@link PreviewEntryResolver}
+ * (e.g. HSD `location`).
+ */
+export type PreviewContentType = BuiltinPreviewContentType | (string & {});
+/**
+ * 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;
+}
+/**
+ * Linked entry shape passed to project preview resolvers (include depth 1).
+ * Compatible with Contentful include entries used by getPreviewEntryInfo.
+ */
+export interface PreviewEntryInclude {
+    sys: {
+        id: string;
+        contentType?: {
+            sys: {
+                id: string;
+            };
+        };
+    };
+    fields?: Record<string, unknown>;
+}
+/**
+ * Input for a project {@link PreviewEntryResolver}.
+ */
+export interface PreviewEntryResolveInput {
+    contentTypeId: string;
+    entryId: string;
+    /** Entry fields from the preview API (slug, links, …). */
+    fields: Record<string, unknown>;
+    /** Linked entries from include: 1. */
+    includes: PreviewEntryInclude[] | undefined;
+    urlCalculators: UrlCalculators;
+}
+/**
+ * Project-supplied resolver for page-like content types not handled by core
+ * {@link getPreviewEntryInfo}. Return preview info, or null if unhandled.
+ * Built-in switch runs first; extensions are only consulted on unknown types.
+ */
+export type PreviewEntryResolver = (input: PreviewEntryResolveInput) => PreviewEntryInfo | null;
+//# sourceMappingURL=preview-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preview-types.d.ts","sourceRoot":"","sources":["../../src/api/preview-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,yBAAyB,GACjC,MAAM,GACN,aAAa,GACb,UAAU,GACV,SAAS,GACT,aAAa,GACb,KAAK,GACL,QAAQ,GACR,YAAY,CAAC;AAEjB;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,yBAAyB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAE3E;;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;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE;QACH,EAAE,EAAE,MAAM,CAAC;QACX,WAAW,CAAC,EAAE;YACZ,GAAG,EAAE;gBACH,EAAE,EAAE,MAAM,CAAC;aACZ,CAAC;SACH,CAAC;KACH,CAAC;IACF,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,sCAAsC;IACtC,QAAQ,EAAE,mBAAmB,EAAE,GAAG,SAAS,CAAC;IAC5C,cAAc,EAAE,cAAc,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,wBAAwB,KAAK,gBAAgB,GAAG,IAAI,CAAC"}

package/dist/api/preview-types.js

@@ -0,0 +1,7 @@
+/**
+ * Shared types for Contentful Live Preview entry → URL resolution.
+ * Kept separate from preview.ts / helpers.ts to avoid circular imports and
+ * so {@link PreviewEntryResolver} can return {@link PreviewEntryInfo} cleanly.
+ */
+export {};
+//# sourceMappingURL=preview-types.js.map

package/dist/api/preview-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-types.js","sourceRoot":"","sources":["../../src/api/preview-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/api/preview.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 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';
+import type { PreviewEntryInfo, PreviewEntryResolver } from './preview-types';
+export type { BuiltinPreviewContentType, PreviewContentType, PreviewEntryInclude, PreviewEntryInfo, PreviewEntryResolveInput, PreviewEntryResolver, } from './preview-types';
+/**
+ * Convenience resolver for content types that only need `fields.slug` → href.
+ *
+ * @example
+ * ```ts
+ * previewEntryResolvers: {
+ *   location: slugPreviewResolver('location', (slug) => `/drive/${slug}/`),
+ * }
+ * ```
+ */
+export declare function slugPreviewResolver(contentType: string, toHref: (slug: string) => string): PreviewEntryResolver;
+/**
+ * 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(urlCalculators);
+ * 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;AAElE,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC/D,OAAO,KAAK,EAAuB,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEnG,YAAY,EACV,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAC/B,oBAAoB,CAatB;AAwCD;;;;;;;;;;;;;;;;;;;;;;;;;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,CA6JlC"}

package/dist/api/preview.js

@@ -0,0 +1,261 @@
+/**
+ * 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.js';
+import { GlobalTag } from '../revalidation/tags.js';
+/**
+ * Convenience resolver for content types that only need `fields.slug` → href.
+ *
+ * @example
+ * ```ts
+ * previewEntryResolvers: {
+ *   location: slugPreviewResolver('location', (slug) => `/drive/${slug}/`),
+ * }
+ * ```
+ */
+export function slugPreviewResolver(contentType, toHref) {
+    return ({ entryId, fields }) => {
+        const slug = readStringField(fields, 'slug');
+        if (!slug) {
+            return null;
+        }
+        return {
+            contentType,
+            entryId,
+            slug,
+            href: toHref(slug),
+        };
+    };
+}
+function readStringField(fields, key) {
+    if (!fields) {
+        return undefined;
+    }
+    const value = fields[key];
+    return typeof value === 'string' ? value : undefined;
+}
+function asEntryLink(value) {
+    if (!value || typeof value !== 'object') {
+        return undefined;
+    }
+    const link = value;
+    if (!link.sys?.id) {
+        return undefined;
+    }
+    return link;
+}
+/**
+ * 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(urlCalculators);
+ * 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);
+    // Tag with GlobalTag so DRAFT_ONLY / revalidate-all can clear stale entry-id → slug maps
+    // (force-cache without tags cannot be invalidated).
+    const response = await client.getEntries({
+        'sys.id': entryId,
+        include: 1, // Resolve linked entries: Article → ArticleType, pageTest → control
+    }, {
+        cache: 'force-cache',
+        ...options,
+        preview: true,
+        next: {
+            ...options?.next,
+            tags: [...(options?.next?.tags ?? []), GlobalTag],
+        },
+    });
+    const entry = response.items[0];
+    if (!entry) {
+        return null;
+    }
+    const contentTypeId = entry.sys.contentType.sys.id;
+    const fields = entry.fields;
+    const includes = response.includes?.Entry;
+    // Map Contentful content type ID to our PreviewContentType
+    // and extract the relevant slug and calculate href
+    switch (contentTypeId) {
+        case 'page': {
+            const slug = readStringField(fields, 'slug');
+            if (!slug)
+                return null;
+            return {
+                contentType: 'page',
+                entryId,
+                slug,
+                href: context.urlCalculators.page(slug),
+            };
+        }
+        case 'pageVariant': {
+            const slug = readStringField(fields, 'slug');
+            if (!slug)
+                return null;
+            return {
+                contentType: 'pageVariant',
+                entryId,
+                slug,
+                href: context.urlCalculators.pageVariant(slug),
+            };
+        }
+        case 'article': {
+            const slug = readStringField(fields, 'slug');
+            // For articles, we need the articleType's slug from the included entry
+            const articleTypeSlug = getArticleTypeSlug(fields, includes);
+            if (!slug || !articleTypeSlug)
+                return null;
+            return {
+                contentType: 'article',
+                entryId,
+                slug,
+                articleTypeSlug,
+                href: context.urlCalculators.article(articleTypeSlug, slug),
+            };
+        }
+        case 'articleType': {
+            const slug = readStringField(fields, 'slug');
+            if (!slug)
+                return null;
+            return {
+                contentType: 'articleType',
+                entryId,
+                slug,
+                href: context.urlCalculators.articleType(slug),
+            };
+        }
+        case 'tag': {
+            const slug = readStringField(fields, 'slug');
+            if (!slug)
+                return null;
+            return {
+                contentType: 'tag',
+                entryId,
+                slug,
+                href: context.urlCalculators.tag(slug),
+            };
+        }
+        case 'person': {
+            const slug = readStringField(fields, 'slug');
+            if (!slug)
+                return null;
+            return {
+                contentType: 'person',
+                entryId,
+                slug,
+                href: context.urlCalculators.person(slug),
+            };
+        }
+        case 'customType': {
+            const slug = readStringField(fields, 'slug');
+            if (!slug)
+                return null;
+            return {
+                contentType: 'customType',
+                entryId,
+                slug,
+                href: context.urlCalculators.customType(slug),
+            };
+        }
+        case 'pageTest': {
+            const controlEntry = getPageTestControlEntry(fields, includes);
+            if (!controlEntry)
+                return null;
+            const controlContentType = controlEntry.sys.contentType?.sys.id;
+            const slug = readStringField(controlEntry.fields, 'slug');
+            if (!slug)
+                return null;
+            if (controlContentType === 'page') {
+                return {
+                    contentType: 'pageTest',
+                    entryId,
+                    slug,
+                    href: context.urlCalculators.page(slug),
+                };
+            }
+            if (controlContentType === 'pageVariant') {
+                return {
+                    contentType: 'pageTest',
+                    entryId,
+                    slug,
+                    href: context.urlCalculators.pageVariant(slug),
+                };
+            }
+            return null;
+        }
+        default: {
+            const resolver = context.previewEntryResolvers?.[contentTypeId];
+            if (!resolver) {
+                return null;
+            }
+            return resolver({
+                contentTypeId,
+                entryId,
+                fields,
+                includes,
+                urlCalculators: context.urlCalculators,
+            });
+        }
+    }
+}
+/**
+ * Resolves the control page entry linked from a pageTest entry.
+ */
+function getPageTestControlEntry(fields, includes) {
+    const controlField = asEntryLink(fields.control);
+    if (!controlField) {
+        return undefined;
+    }
+    if (controlField.sys.contentType?.sys.id && readStringField(controlField.fields, 'slug')) {
+        return controlField;
+    }
+    const controlId = controlField.sys.id;
+    if (!controlId || !includes) {
+        return undefined;
+    }
+    return includes.find((inc) => inc.sys.id === controlId);
+}
+/**
+ * Extracts the article type slug from an article entry.
+ * Looks in the entry's articleType field, falling back to includes if needed.
+ */
+function getArticleTypeSlug(fields, includes) {
+    const articleTypeField = asEntryLink(fields.articleType);
+    if (!articleTypeField) {
+        return undefined;
+    }
+    const resolvedSlug = readStringField(articleTypeField.fields, 'slug');
+    if (resolvedSlug) {
+        return resolvedSlug;
+    }
+    const articleTypeId = articleTypeField.sys.id;
+    if (!articleTypeId || !includes) {
+        return undefined;
+    }
+    const articleTypeEntry = includes.find((inc) => inc.sys.id === articleTypeId);
+    return readStringField(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/redirects.d.ts

@@ -0,0 +1,16 @@
+import type { IRedirect } from '@se-studio/core-data-types';
+import type { BaseConverterContext } from '../converters/helpers';
+import type { CmsResponse, ContentfulConfig, FetchOptions } from '../types';
+export { buildRedirectMap, type RedirectMap, type RedirectMapEntry } from '../utils/redirectMap';
+/**
+ * Fetches all redirects from Contentful.
+ *
+ * Returns published redirects (when not in preview). The list is small by design
+ * (typically < a few hundred rules) so a full enumeration with pagination is fine.
+ *
+ * The converter resolves any fromInternal / toInternal reference into
+ * concrete fromPath / to strings (using the project's urlCalculators) so callers
+ * (build-time bake or future sync) only ever see simple path → target maps.
+ */
+export declare function contentfulRedirectsRest(context: BaseConverterContext, config: ContentfulConfig, options: FetchOptions): Promise<CmsResponse<IRedirect[] | null>>;
+//# sourceMappingURL=redirects.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"redirects.d.ts","sourceRoot":"","sources":["../../src/api/redirects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAG5D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAGlE,OAAO,KAAK,EAAY,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAWtF,OAAO,EAAE,gBAAgB,EAAE,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAEjG;;;;;;;;;GASG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,WAAW,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,CAAC,CA4G1C"}

package/dist/api/redirects.js

@@ -0,0 +1,110 @@
+import { getContentfulClient } from '../client.js';
+import { getCacheTags } from '../revalidation/index.js';
+import { withCmsQueryContext } from '../telemetry/queryContext.js';
+import { withRetry } from '../utils/index.js';
+import { convertAllAssets, convertAllIncludes, convertAllRawAssets, } from './helpers.js';
+// Re-export the pure map builder (implemented in utils so it has zero server-only deps
+// and can be used in build scripts / edge / tests without pulling Next.js server boundaries).
+export { buildRedirectMap } from '../utils/redirectMap.js';
+/**
+ * Fetches all redirects from Contentful.
+ *
+ * Returns published redirects (when not in preview). The list is small by design
+ * (typically < a few hundred rules) so a full enumeration with pagination is fine.
+ *
+ * The converter resolves any fromInternal / toInternal reference into
+ * concrete fromPath / to strings (using the project's urlCalculators) so callers
+ * (build-time bake or future sync) only ever see simple path → target maps.
+ */
+export async function contentfulRedirectsRest(context, config, options) {
+    const client = getContentfulClient(config, options.preview);
+    const redirectCacheTags = getCacheTags('redirect', undefined, options.preview);
+    const requestOptions = {
+        ...options,
+        next: {
+            ...options?.next,
+            tags: redirectCacheTags,
+        },
+    };
+    const allRedirects = [];
+    const errors = [];
+    const pageSize = 100;
+    let skip = 0;
+    let hasMore = true;
+    const fetchFn = async () => {
+        while (hasMore) {
+            try {
+                const page = Math.floor(skip / pageSize) + 1;
+                const operation = page > 1 ? `Reading all redirects (page ${page})` : 'Reading all redirects';
+                const redirectResponse = await withCmsQueryContext({ operation }, () => client.getEntries({
+                    content_type: 'redirect',
+                    include: 2, // enough to resolve the link targets we care about for hrefs
+                    locale: options?.locale,
+                    limit: pageSize,
+                    skip,
+                }, requestOptions));
+                if (!redirectResponse.items.length) {
+                    hasMore = false;
+                    break;
+                }
+                const includes = convertAllIncludes(redirectResponse);
+                const assets = convertAllAssets(redirectResponse, context);
+                const rawAssets = convertAllRawAssets(redirectResponse);
+                const fullContext = {
+                    ...context,
+                    includes,
+                    assets,
+                    rawAssets,
+                    errors: [],
+                    externalVideoEmbeds: new Map(),
+                };
+                for (const redirectEntry of redirectResponse.items) {
+                    if (!redirectEntry.fields)
+                        continue;
+                    try {
+                        const converted = context.redirectResolver(fullContext, redirectEntry);
+                        allRedirects.push(converted);
+                    }
+                    catch (error) {
+                        const entryId = redirectEntry.sys.id;
+                        const entryType = redirectEntry.sys.contentType?.sys?.id;
+                        const errorMessage = error instanceof Error ? error.message : 'Unknown conversion error';
+                        errors.push({
+                            entryId,
+                            entryType,
+                            message: errorMessage,
+                            error,
+                        });
+                    }
+                }
+                if (fullContext.errors.length > 0 &&
+                    typeof process !== 'undefined' &&
+                    process.env?.NODE_ENV === 'production') {
+                    console.error(`CMS conversion errors for redirect:`, {
+                        errors: fullContext.errors,
+                    });
+                }
+            }
+            catch (error) {
+                const entryId = 'unknown';
+                const entryType = 'redirect';
+                const errorMessage = error instanceof Error ? error.message : 'Unknown conversion error';
+                const cmsError = {
+                    entryId,
+                    entryType,
+                    message: errorMessage,
+                    error,
+                };
+                errors.push(cmsError);
+                hasMore = false;
+            }
+            skip += pageSize;
+        }
+        return { data: allRedirects, errors };
+    };
+    if (options.retry) {
+        return await withRetry(fetchFn, options.retry);
+    }
+    return await fetchFn();
+}
+//# sourceMappingURL=redirects.js.map

package/dist/api/redirects.js.map

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

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

@@ -0,0 +1,28 @@
+import { type IArticleLink } from '@se-studio/core-data-types';
+import type { RelatedArticlesOptions } from './types';
+/**
+ * Filters and ranks articles based on related article criteria.
+ * When tagIds are provided, articles must match at least one tag (OR semantics).
+ * 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'],
+ *   articleTypeSlugs: ['resources/news'],
+ *   tagIds: ['tag-1'],
+ *   tagSlugs: ['tag-2'],
+ *   tagTypeSlugs: ['condition'],
+ *   authorSlugs: ['alice'],
+ *   strictAuthorMatch: true,
+ *   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,EAAqB,KAAK,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAClF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,YAAY,EAAE,EACxB,OAAO,EAAE,sBAAsB,GAC9B,YAAY,EAAE,CA6JhB"}