podscan 1.0.0

package/dist/index.d.cts

@@ -0,0 +1,849 @@
+interface HttpClientOptions {
+    apiKey: string;
+    baseUrl?: string;
+    timeout?: number;
+}
+interface RateLimitInfo {
+    limit: number;
+    remaining: number;
+    used: number;
+    resetsAt: string | null;
+}
+interface PodscanErrorDetails {
+    code: string;
+    message: string;
+    status: number;
+    details?: Record<string, unknown>;
+}
+declare class PodscanError extends Error {
+    readonly code: string;
+    readonly status: number;
+    readonly details?: Record<string, unknown>;
+    constructor({ code, message, status, details }: PodscanErrorDetails);
+}
+declare class HttpClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly timeout;
+    rateLimit: RateLimitInfo | null;
+    constructor(options: HttpClientOptions);
+    get<T>(path: string, params?: object): Promise<T>;
+    post<T>(path: string, body?: object): Promise<T>;
+    private buildUrl;
+    private request;
+    private parseRateLimitHeaders;
+}
+
+interface Pagination {
+    total: number;
+    per_page: number;
+    current_page: number;
+    last_page: number;
+    from: number | null;
+    to: number | null;
+}
+interface Quota {
+    daily_used: number;
+    daily_limit: number;
+    daily_remaining: number;
+    plan: string;
+    resets_at: string;
+}
+interface Sentiment {
+    label: string;
+    short: string;
+    score: number;
+}
+type SortDirection = 'asc' | 'desc';
+interface Category {
+    category_id: string;
+    category_name: string;
+}
+interface SearchHighlight {
+    transcription?: string;
+    description?: string;
+    title?: string;
+}
+interface PodcastRef {
+    podcast_id: string;
+    podcast_name: string;
+    podcast_url?: string;
+    podcast_reach_score?: number;
+}
+interface Podcast {
+    podcast_id: string;
+    podcast_guid: string;
+    podcast_name: string;
+    podcast_url: string;
+    podcast_description: string;
+    podcast_image_url: string | null;
+    podcast_categories: Category[];
+    podcast_iab_categories: string[] | null;
+    podcast_has_guests: boolean | null;
+    podcast_has_sponsors: boolean | null;
+    podcast_itunes_id: string | null;
+    podcast_spotify_id: string | null;
+    podcast_reach_score: number;
+    publisher_name: string | null;
+    publisher_ids: string[] | null;
+    brand_safety: string | null;
+    reach: Record<string, unknown> | null;
+    rss_url: string | null;
+    is_active: boolean;
+    episode_count: number;
+    episodes_in_database: number;
+    language: string | null;
+    region: string | null;
+    last_posted_at: string | null;
+    last_scanned_at: string | null;
+    created_at: string;
+    updated_at: string;
+    is_duplicate: boolean;
+    is_duplicate_of: string | null;
+    _search_highlight?: SearchHighlight;
+}
+interface HostInfo {
+    host_name: string;
+    host_company: string | null;
+    host_social_media_links: string[] | null;
+    speaker_label: string | null;
+}
+interface GuestInfo {
+    guest_name: string;
+    guest_company: string | null;
+    guest_social_media_links: string[] | null;
+    guest_industry: string | null;
+    guest_occupation: string | null;
+    speaker_label: string | null;
+}
+interface SponsorInfo {
+    sponsor_name: string;
+    sponsor_url: string | null;
+    sponsor_description: string | null;
+}
+interface FirstOccurrence {
+    type: 'host' | 'guest' | 'keyword' | 'sponsor';
+    value: string;
+    first_occurence: string;
+}
+interface EpisodeMetadata {
+    hosts: HostInfo[];
+    guests: GuestInfo[];
+    sponsors: SponsorInfo[];
+    /** Maps speaker labels (e.g. "SPEAKER_01") to real names. */
+    speakers: Record<string, string>;
+    has_hosts: boolean;
+    has_guests: boolean;
+    has_sponsors: boolean;
+    is_branded: boolean;
+    is_branded_confidence_score: number;
+    is_branded_confidence_reason: string | null;
+    summary_short: string | null;
+    summary_long: string | null;
+    summary_keywords: string[];
+    first_occurences: FirstOccurrence[];
+    brand_safety: string | null;
+}
+interface Episode {
+    episode_fully_processed: boolean;
+    episode_id: string;
+    episode_guid: string;
+    episode_title: string;
+    episode_url: string;
+    episode_audio_url: string | null;
+    episode_image_url: string | null;
+    episode_duration: number;
+    episode_word_count: number;
+    episode_categories: Category[];
+    episode_iab_category: string | null;
+    episode_has_guests: boolean | null;
+    episode_has_sponsors: boolean | null;
+    created_at: string;
+    updated_at: string;
+    posted_at: string;
+    episode_transcript: string | null;
+    episode_transcript_word_level_timestamps: unknown;
+    episode_description: string;
+    episode_permalink: string;
+    podcast: PodcastRef;
+    metadata: EpisodeMetadata | null;
+    topics: TopicOccurrence[];
+    _search_highlight?: SearchHighlight;
+}
+interface TopicSummary {
+    topic_id: string;
+    name: string;
+    occurrences_count?: number;
+    latest_occurrence?: string;
+}
+interface TopicOccurrence {
+    topic_id: string;
+    name?: string;
+    topic_name?: string;
+    topic_name_normalized?: string;
+    sentiment?: Sentiment;
+}
+interface TopicMomentum {
+    daily_growth: number;
+    weekly_growth: number;
+    is_trending: boolean;
+    current_velocity?: {
+        occurrences_last_hour: number;
+        occurrences_last_day: number;
+        occurrences_last_week: number;
+    };
+}
+interface Topic {
+    topic_id: string;
+    name: string;
+    occurrences_count: number;
+    latest_occurrence: string;
+    momentum?: TopicMomentum;
+    recent_occurrences?: TopicEpisodeOccurrence[];
+    related_topics?: TopicSummary[];
+    lists?: ListSummary[];
+}
+interface TopicEpisodeOccurrence {
+    episode_id: string;
+    episode_title: string;
+    podcast_id: string;
+    podcast_name: string;
+    posted_at: string;
+    sentiment?: Sentiment;
+}
+interface TrendingTopic {
+    topic_id: string;
+    name: string;
+    occurrences: number;
+    momentum?: TopicMomentum;
+    related_topics?: TopicSummary[];
+}
+interface EntityAppearanceCounts {
+    hosts_count: number;
+    guests_count: number;
+    sponsors_count: number;
+    producers_count: number;
+    mentions_count: number;
+    total_count: number;
+}
+interface Entity {
+    entity_id: string;
+    entity_name: string;
+    entity_type: 'person' | 'organization';
+    created_at: string;
+    updated_at: string;
+    company: string | null;
+    occupation: string | null;
+    industry: string | null;
+    url: string | null;
+    appearances: EntityAppearanceCounts;
+    _search_highlight?: SearchHighlight;
+}
+interface EntityAppearance {
+    appearance_id?: string;
+    role: string;
+    episode_id: string;
+    episode_title: string;
+    podcast_id: string;
+    podcast_name: string;
+    posted_at: string;
+}
+interface Alert {
+    alert_id: string;
+    alert_name: string;
+    filters: string;
+    enabled: boolean;
+    mention_count: number;
+    recent_mention_count: number;
+    created_at: string;
+}
+interface Mention {
+    mention_id: string;
+    detected_filter: string;
+    detected_excerpt: string;
+    detected_at: string;
+    sentiment?: Sentiment;
+    episode?: Episode;
+}
+interface ListSummary {
+    list_id: string;
+    list_name: string;
+    list_description?: string;
+    item_count: number;
+    created_at: string;
+    updated_at: string;
+}
+interface ListItem {
+    id: string;
+    type: 'podcast' | 'episode' | 'entity' | 'topic';
+    [key: string]: unknown;
+}
+interface Publisher {
+    publisher_id: string;
+    publisher_name: string;
+    website?: string;
+    podcasts?: Podcast[];
+}
+interface SearchEpisodesParams {
+    query: string;
+    search_fields?: string;
+    category_ids?: string;
+    podcast_ids?: string;
+    since?: string;
+    before?: string;
+    language?: string;
+    has_guests?: boolean;
+    has_sponsors?: boolean;
+    show_only_fully_processed?: boolean;
+    order_by?: 'posted_at' | 'relevance' | 'duration';
+    order_dir?: SortDirection;
+    page?: number;
+    per_page?: number;
+    exclude_transcript?: boolean;
+    show_full_podcast?: boolean;
+    remove_timestamps?: boolean;
+    remove_speaker_labels?: boolean;
+    transcript_formatter?: 'raw' | 'paragraphs';
+}
+interface GetEpisodeParams {
+    episode_id: string;
+    include_transcript?: boolean;
+    include_topics?: boolean;
+    include_entities?: boolean;
+}
+interface GetRecentEpisodesParams {
+    limit?: number;
+    since?: string;
+    before?: string;
+    category_ids?: string;
+    podcast_ids?: string;
+    language?: string;
+    has_guests?: boolean;
+    has_sponsors?: boolean;
+    show_only_fully_processed?: boolean;
+    exclude_transcript?: boolean;
+    show_full_podcast?: boolean;
+    remove_timestamps?: boolean;
+    remove_speaker_labels?: boolean;
+    transcript_formatter?: 'raw' | 'paragraphs';
+}
+interface GetPodcastEpisodesParams {
+    podcast_id: string;
+    per_page?: number;
+    page?: number;
+    order_by?: 'posted_at' | 'created_at' | 'title' | 'duration';
+    order_dir?: SortDirection;
+    since?: string;
+    before?: string;
+    has_guests?: boolean;
+    has_sponsors?: boolean;
+    title_contains?: string;
+    title_excludes?: string;
+    exclude_transcript?: boolean;
+    show_full_podcast?: boolean;
+    remove_timestamps?: boolean;
+    remove_speaker_labels?: boolean;
+    transcript_formatter?: 'raw' | 'paragraphs';
+}
+interface SearchPodcastsParams {
+    query: string;
+    search_fields?: string;
+    category_ids?: string;
+    language?: string;
+    region?: string;
+    min_audience_size?: number;
+    max_audience_size?: number;
+    min_episode_count?: number;
+    has_guests?: boolean;
+    has_sponsors?: boolean;
+    order_by?: 'rating' | 'audience_size' | 'episode_count';
+    order_dir?: SortDirection;
+    page?: number;
+    per_page?: number;
+}
+interface GetPodcastParams {
+    podcast_id: string;
+    include_episodes?: boolean;
+    episode_limit?: number;
+    include_demographics?: boolean;
+    include_reviews?: boolean;
+}
+interface SearchEntitiesParams {
+    query: string;
+    entity_type?: 'person' | 'organization';
+    min_appearances?: number;
+    order_by?: 'appearances' | 'name';
+    order_dir?: SortDirection;
+    page?: number;
+    per_page?: number;
+}
+interface GetEntityParams {
+    entity_id: string;
+    with_appearances?: boolean;
+    appearances_limit?: number;
+}
+interface GetEntityAppearancesParams {
+    entity_id: string;
+    per_page?: number;
+    page?: number;
+    role?: 'host' | 'guest' | 'sponsor' | 'producer' | 'mention';
+    podcast_id?: string;
+    from?: string;
+    to?: string;
+    order_by?: 'posted_at' | 'created_at';
+    order_dir?: SortDirection;
+}
+interface SearchTopicsParams {
+    query: string;
+    min_episodes?: number;
+    order_by?: 'relevance' | 'episode_count';
+    order_dir?: SortDirection;
+    page?: number;
+    per_page?: number;
+}
+interface GetTopicParams {
+    topic_id: string;
+    with_history?: boolean;
+}
+interface GetTopicEpisodesParams {
+    topic_id: string;
+    per_page?: number;
+    page?: number;
+    podcast_has_guests?: boolean;
+    podcast_has_sponsors?: boolean;
+    podcast_audience_min?: number;
+    podcast_audience_max?: number;
+    exclude_transcript?: boolean;
+    show_full_podcast?: boolean;
+    remove_timestamps?: boolean;
+    remove_speaker_labels?: boolean;
+    transcript_formatter?: 'raw' | 'paragraphs';
+}
+interface GetTrendingTopicsParams {
+    period?: '24h' | '7d' | '30d';
+    limit?: number;
+    category?: string;
+}
+interface ListAlertsParams {
+    enabled_only?: boolean;
+    page?: number;
+    per_page?: number;
+}
+interface GetAlertMentionsParams {
+    alert_id: string;
+    since?: string;
+    detected_type?: 'transcript' | 'title' | 'description';
+    page?: number;
+    per_page?: number;
+}
+interface CreateAlertParams {
+    name: string;
+    filters: string;
+    context_question?: string;
+    use_context_question?: boolean;
+    notification_email?: string;
+    webhook_url?: string;
+    webhook_active?: boolean;
+    enabled?: boolean;
+}
+interface ListUserListsParams {
+    page?: number;
+    per_page?: number;
+}
+interface GetListItemsParams {
+    list_id: string;
+    item_type?: 'podcasts' | 'episodes' | 'entities' | 'topics';
+    page?: number;
+    per_page?: number;
+}
+interface AddToListParams {
+    list_id: string;
+    item_ids: string;
+}
+interface GetPublisherParams {
+    publisher_id: string;
+    include_podcasts?: boolean;
+    podcast_limit?: number;
+}
+interface SearchEpisodesResponse {
+    episodes: Episode[];
+    pagination: Pagination;
+}
+interface GetEpisodeResponse {
+    episode: Episode;
+}
+interface GetRecentEpisodesResponse {
+    episodes: Episode[];
+}
+interface GetPodcastEpisodesResponse {
+    episodes: Episode[];
+    pagination: Pagination;
+}
+interface SearchPodcastsResponse {
+    podcasts: Podcast[];
+    pagination: Pagination;
+}
+interface GetPodcastResponse {
+    podcast: Podcast;
+}
+interface SearchEntitiesResponse {
+    entities: Entity[];
+    pagination: Pagination;
+    filters?: Record<string, unknown>;
+}
+interface GetEntityResponse {
+    entity: Entity;
+}
+interface GetEntityAppearancesResponse {
+    entity: Entity;
+    appearances: EntityAppearance[];
+    pagination: Pagination;
+}
+interface SearchTopicsResponse {
+    topics: TopicSummary[];
+    pagination: Pagination;
+}
+interface GetTopicResponse {
+    topic: Topic;
+}
+interface GetTopicEpisodesResponse {
+    episodes: Episode[];
+    pagination: Pagination;
+}
+interface GetTrendingTopicsResponse {
+    topics: TrendingTopic[];
+    timeframe?: string;
+}
+interface ListAlertsResponse {
+    alerts: Alert[];
+    pagination: Pagination;
+}
+interface GetAlertMentionsResponse {
+    mentions: Mention[];
+    pagination: Pagination;
+}
+interface CreateAlertResponse {
+    alert: Alert;
+}
+interface ListUserListsResponse {
+    lists: ListSummary[];
+    pagination: Pagination;
+}
+interface GetListItemsResponse {
+    items: ListItem[];
+    pagination: Pagination;
+}
+interface AddToListResponse {
+    success: boolean;
+    summary: {
+        added: number;
+        skipped: number;
+        failed: number;
+    };
+    added: string[];
+    skipped: string[];
+    failed: {
+        id: string;
+        reason: string;
+    }[];
+}
+interface GetPublisherResponse {
+    publisher: Publisher;
+}
+/** A date range that can be spread into any search params with `since`/`before`. */
+interface DateRange {
+    since: string;
+    before?: string;
+}
+/** Checkpoint for delta/incremental sync workflows. */
+interface Checkpoint {
+    /** ISO 8601 timestamp of the most recent item seen. */
+    lastSeenAt: string;
+    /** ID of the most recent item seen. */
+    lastSeenId: string;
+    /** Total number of items iterated. */
+    totalSeen: number;
+}
+
+/**
+ * A function that fetches one page of results.
+ * The paginator calls it with incrementing page numbers.
+ */
+type PageFetcher<T> = (page: number) => Promise<{
+    items: T[];
+    pagination: Pagination;
+}>;
+/**
+ * An async-iterable paginator that walks through all pages of a paginated
+ * API response, yielding individual items.
+ *
+ * ```ts
+ * const paginator = new Paginator(async (page) => {
+ *   const res = await client.episodes.search({ query: 'AI', page, per_page: 50 });
+ *   return { items: res.episodes, pagination: res.pagination };
+ * });
+ *
+ * for await (const episode of paginator) {
+ *   console.log(episode.episode_title);
+ * }
+ *
+ * console.log(paginator.checkpoint());
+ * ```
+ */
+declare class Paginator<T> implements AsyncIterable<T> {
+    private readonly fetcher;
+    private _totalSeen;
+    private _lastSeenAt;
+    private _lastSeenId;
+    constructor(fetcher: PageFetcher<T>);
+    [Symbol.asyncIterator](): AsyncIterator<T>;
+    /**
+     * Returns a checkpoint representing the sync position after iteration.
+     * Save this and pass `checkpoint.lastSeenAt` as `since` on the next run
+     * to only fetch new items.
+     */
+    checkpoint(): Checkpoint;
+    /** Total number of items yielded so far. */
+    get totalSeen(): number;
+}
+
+declare class EpisodesResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Full-text search across podcast episode transcripts, titles, and descriptions.
+     */
+    search(params: SearchEpisodesParams): Promise<SearchEpisodesResponse>;
+    /**
+     * Auto-paginating search that yields every matching episode across all pages.
+     *
+     * ```ts
+     * for await (const episode of client.episodes.searchAll({ query: 'AI', ...periods.thisWeek() })) {
+     *   console.log(episode.episode_title);
+     * }
+     * ```
+     */
+    searchAll(params: Omit<SearchEpisodesParams, 'page'>): Paginator<Episode>;
+    /**
+     * Get detailed information about a specific episode.
+     */
+    get(params: GetEpisodeParams): Promise<GetEpisodeResponse>;
+    /**
+     * Get the most recently published podcast episodes.
+     */
+    getRecent(params?: GetRecentEpisodesParams): Promise<GetRecentEpisodesResponse>;
+    /**
+     * List all episodes for a specific podcast.
+     */
+    getByPodcast(params: GetPodcastEpisodesParams): Promise<GetPodcastEpisodesResponse>;
+    /**
+     * Auto-paginating version of `getByPodcast()` that yields every episode.
+     *
+     * ```ts
+     * for await (const ep of client.episodes.getByPodcastAll({
+     *   podcast_id: 'pd_abc',
+     *   ...periods.thisMonth(),
+     * })) {
+     *   console.log(ep.episode_title);
+     * }
+     * ```
+     */
+    getByPodcastAll(params: Omit<GetPodcastEpisodesParams, 'page'>): Paginator<Episode>;
+}
+
+declare class PodcastsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Search podcasts by name, topic, or characteristics.
+     */
+    search(params: SearchPodcastsParams): Promise<SearchPodcastsResponse>;
+    /**
+     * Auto-paginating search that yields every matching podcast across all pages.
+     */
+    searchAll(params: Omit<SearchPodcastsParams, 'page'>): Paginator<Podcast>;
+    /**
+     * Get detailed information about a specific podcast.
+     */
+    get(params: GetPodcastParams): Promise<GetPodcastResponse>;
+}
+
+declare class AlertsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * List your team's content monitoring alerts.
+     */
+    list(params?: ListAlertsParams): Promise<ListAlertsResponse>;
+    /**
+     * Get mentions found by a specific alert.
+     */
+    getMentions(params: GetAlertMentionsParams): Promise<GetAlertMentionsResponse>;
+    /**
+     * Create a new content monitoring alert.
+     */
+    create(params: CreateAlertParams): Promise<CreateAlertResponse>;
+}
+
+declare class TopicsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Discover topics and subjects discussed across podcasts.
+     */
+    search(params: SearchTopicsParams): Promise<SearchTopicsResponse>;
+    /**
+     * Auto-paginating search that yields every matching topic across all pages.
+     */
+    searchAll(params: Omit<SearchTopicsParams, 'page'>): Paginator<TopicSummary>;
+    /**
+     * Get detailed information about a specific topic.
+     */
+    get(params: GetTopicParams): Promise<GetTopicResponse>;
+    /**
+     * Get episodes where a specific topic was mentioned.
+     */
+    getEpisodes(params: GetTopicEpisodesParams): Promise<GetTopicEpisodesResponse>;
+    /**
+     * Auto-paginating version of `getEpisodes()` that yields every episode for a topic.
+     */
+    getEpisodesAll(params: Omit<GetTopicEpisodesParams, 'page'>): Paginator<Episode>;
+    /**
+     * Get currently trending topics across podcasts.
+     */
+    getTrending(params?: GetTrendingTopicsParams): Promise<GetTrendingTopicsResponse>;
+}
+
+declare class EntitiesResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Search for people and organizations mentioned across podcasts.
+     */
+    search(params: SearchEntitiesParams): Promise<SearchEntitiesResponse>;
+    /**
+     * Auto-paginating search that yields every matching entity across all pages.
+     */
+    searchAll(params: Omit<SearchEntitiesParams, 'page'>): Paginator<Entity>;
+    /**
+     * Get detailed information about a person or organization.
+     */
+    get(params: GetEntityParams): Promise<GetEntityResponse>;
+    /**
+     * Get all podcast appearances for a specific entity.
+     */
+    getAppearances(params: GetEntityAppearancesParams): Promise<GetEntityAppearancesResponse>;
+}
+
+declare class ListsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Get all lists/collections for your team.
+     */
+    list(params?: ListUserListsParams): Promise<ListUserListsResponse>;
+    /**
+     * Get contents of a specific list.
+     */
+    getItems(params: GetListItemsParams): Promise<GetListItemsResponse>;
+    /**
+     * Add items to a list. Accepts mixed item types (podcasts, episodes, entities, topics).
+     */
+    addItems(params: AddToListParams): Promise<AddToListResponse>;
+}
+
+declare class PublishersResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Get publisher information with their podcast portfolio.
+     */
+    get(params: GetPublisherParams): Promise<GetPublisherResponse>;
+}
+
+interface PodscanClientOptions {
+    /** Your Podscan API key (Bearer token). */
+    apiKey: string;
+    /** Override the base URL (default: https://podscan.fm/api/v1). */
+    baseUrl?: string;
+    /** Request timeout in milliseconds (default: 30000). */
+    timeout?: number;
+}
+declare class PodscanClient {
+    private readonly http;
+    /** Search and retrieve podcast episodes and recent content. */
+    readonly episodes: EpisodesResource;
+    /** Search and retrieve podcast metadata. */
+    readonly podcasts: PodcastsResource;
+    /** Create and manage keyword monitoring alerts and their mentions. */
+    readonly alerts: AlertsResource;
+    /** Search, retrieve, and track trending topics across podcasts. */
+    readonly topics: TopicsResource;
+    /** Search and retrieve people and organizations mentioned in podcasts. */
+    readonly entities: EntitiesResource;
+    /** Manage curated collections of podcasts, episodes, entities, and topics. */
+    readonly lists: ListsResource;
+    /** Retrieve publisher information and podcast portfolios. */
+    readonly publishers: PublishersResource;
+    constructor(options: PodscanClientOptions);
+    /** Current rate-limit info from the most recent API response, or null if no request has been made. */
+    get rateLimit(): RateLimitInfo | null;
+}
+
+/**
+ * Time period helpers for the Podscan SDK.
+ *
+ * Each method returns a `{ since, before? }` object that can be spread
+ * directly into any search params:
+ *
+ * ```ts
+ * const results = await client.episodes.search({
+ *   query: 'AI',
+ *   ...periods.thisWeek(),
+ * });
+ * ```
+ */
+declare const periods: {
+    /**
+     * From midnight today (UTC) until now.
+     */
+    today(): DateRange;
+    /**
+     * From midnight yesterday (UTC) to midnight today (UTC).
+     */
+    yesterday(): DateRange;
+    /**
+     * Rolling window: now minus 24 hours.
+     */
+    last24Hours(): DateRange;
+    /**
+     * From Monday 00:00 UTC of the current week until now.
+     */
+    thisWeek(): DateRange;
+    /**
+     * From Monday 00:00 UTC of last week to Monday 00:00 UTC of this week.
+     */
+    lastWeek(): DateRange;
+    /**
+     * From the 1st of the current month (UTC) until now.
+     */
+    thisMonth(): DateRange;
+    /**
+     * From the 1st of last month to the 1st of this month (UTC).
+     */
+    lastMonth(): DateRange;
+    /**
+     * Rolling window: now minus N days.
+     */
+    lastNDays(n: number): DateRange;
+    /**
+     * Rolling window: now minus N hours.
+     */
+    lastNHours(n: number): DateRange;
+    /**
+     * Everything after a given date. Accepts an ISO string or Date object.
+     */
+    since(date: string | Date): DateRange;
+};
+
+export { type AddToListParams, type AddToListResponse, type Alert, AlertsResource, type Category, type Checkpoint, type CreateAlertParams, type CreateAlertResponse, type DateRange, EntitiesResource, type Entity, type EntityAppearance, type EntityAppearanceCounts, type Episode, type EpisodeMetadata, EpisodesResource, type FirstOccurrence, type GetAlertMentionsParams, type GetAlertMentionsResponse, type GetEntityAppearancesParams, type GetEntityAppearancesResponse, type GetEntityParams, type GetEntityResponse, type GetEpisodeParams, type GetEpisodeResponse, type GetListItemsParams, type GetListItemsResponse, type GetPodcastEpisodesParams, type GetPodcastEpisodesResponse, type GetPodcastParams, type GetPodcastResponse, type GetPublisherParams, type GetPublisherResponse, type GetRecentEpisodesParams, type GetRecentEpisodesResponse, type GetTopicEpisodesParams, type GetTopicEpisodesResponse, type GetTopicParams, type GetTopicResponse, type GetTrendingTopicsParams, type GetTrendingTopicsResponse, type GuestInfo, type HostInfo, type ListAlertsParams, type ListAlertsResponse, type ListItem, type ListSummary, type ListUserListsParams, type ListUserListsResponse, ListsResource, type Mention, type Pagination, Paginator, type Podcast, type PodcastRef, PodcastsResource, PodscanClient, type PodscanClientOptions, PodscanError, type Publisher, PublishersResource, type Quota, type RateLimitInfo, type SearchEntitiesParams, type SearchEntitiesResponse, type SearchEpisodesParams, type SearchEpisodesResponse, type SearchHighlight, type SearchPodcastsParams, type SearchPodcastsResponse, type SearchTopicsParams, type SearchTopicsResponse, type Sentiment, type SortDirection, type SponsorInfo, type Topic, type TopicEpisodeOccurrence, type TopicMomentum, type TopicOccurrence, type TopicSummary, TopicsResource, type TrendingTopic, periods };