import type { ReferralItem } from './types';
/**
 * Environment gate for the live fetch. The Reuters.com referral API is only
 * same-origin — and therefore CORS-accessible — on production, so by default we
 * only fetch when running on www.reuters.com. Stories and tests can override
 * `enabled` to feed mocked data through the real fetch/transform path without
 * loosening this guard for real, non-production environments.
 */
export declare const referralsApi: {
    enabled: () => boolean;
};
interface FetchReferralsOptions {
    /** Section ID/path passed to the recent-stories-by-section API. */
    section?: string;
    /** Collection alias passed to the articles-by-collection API. */
    collection?: string;
    /** Maximum number of referrals to return. */
    number?: number;
}
/**
 * Fetch recent Reuters.com stories for a section or collection and map them
 * into referral items. Returns an empty array when fetching is disabled (see
 * `referralsApi`) or the request fails.
 */
export declare const fetchReferrals: ({ section, collection, number, }: FetchReferralsOptions) => Promise<ReferralItem[]>;
export {};