trending-news-api 0.1.9 → 0.1.11

package/dist/api/trending.d.ts

@@ -0,0 +1,8 @@
+import type { TrendingNewsData, TrendingNewsOptions, TrendingNewsTopicData } from '../types';
+/**
+ * Fetches trending topics (or, when `options.topic` is set, news for a
+ * single topic) from a deployed instance of `worker/index.ts`.
+ */
+export declare function getTrendingNews(options: TrendingNewsOptions): Promise<TrendingNewsData>;
+/** Fetches news articles for a single topic. */
+export declare function getTrendingNewsForTopic(topic: string, options: Omit<TrendingNewsOptions, 'topic'>): Promise<TrendingNewsTopicData>;

package/dist/components/TrendingNews.d.ts

@@ -0,0 +1,28 @@
+import React from 'react';
+import type { TrendingNewsOptions } from '../types';
+type Props = TrendingNewsOptions & {
+    className?: string;
+    style?: React.CSSProperties;
+    compact?: boolean;
+    /** Max trending topics to render (default 8). */
+    maxTopics?: number;
+    /**
+     * When set on a `compact` card, a chevron toggles between the compact
+     * topic row and a full topic-by-topic article list, without leaving the
+     * card's layout. Ignored outside `compact` mode, which already shows the
+     * full list.
+     */
+    expandable?: boolean;
+    /** Max topics to render once expanded (default 15). */
+    expandedMaxTopics?: number;
+    /** Show each topic's lead article thumbnail image, when available (default true). */
+    showImages?: boolean;
+};
+/**
+ * Trending news widget. Requires `apiEndpoint` pointing at a deployed
+ * instance of the bundled Cloudflare Worker (`worker/index.ts`) — renders
+ * nothing when it's not configured, still loading, or errored, so it never
+ * disrupts the layout it's dropped into.
+ */
+export declare function TrendingNews(props: Props): React.JSX.Element | null;
+export {};

package/dist/hooks/useTrendingNews.d.ts

@@ -0,0 +1,6 @@
+import type { TrendingNewsData, TrendingNewsOptions } from '../types';
+export declare function useTrendingNews(options?: TrendingNewsOptions): {
+    data: TrendingNewsData | null;
+    error: Error | null;
+    loading: boolean;
+};

package/dist/index.d.ts

@@ -1,78 +1,5 @@
-import React from 'react';
-
-type NewsArticle = {
-    title: string;
-    url?: string;
-    source?: string;
-    publishedAt?: string;
-    imageUrl?: string;
-};
-type TrendingTopic = {
-    topic: string;
-    wikiRank?: number;
-    wikiViews?: number;
-    newsCount: number;
-    articles: NewsArticle[];
-};
-type TrendingNewsData = {
-    date?: string;
-    topics: TrendingTopic[];
-};
-type TrendingNewsTopicData = {
-    topic: string;
-    newsCount: number;
-    articles: NewsArticle[];
-};
-type TrendingNewsOptions = {
-    /** URL of a deployed instance of the bundled Cloudflare Worker (`worker/index.ts`). */
-    apiEndpoint?: string;
-    /** When set, fetches news for this single topic instead of the daily trending list. */
-    topic?: string;
-    /** Max trending topics to request from the worker (default 25). */
-    limit?: number;
-};
-
-/** Clears all cached trending news responses. Mainly useful for tests/debugging. */
-declare function clearTrendingNewsCache(): void;
-
-/**
- * Fetches trending topics (or, when `options.topic` is set, news for a
- * single topic) from a deployed instance of `worker/index.ts`.
- */
-declare function getTrendingNews(options: TrendingNewsOptions): Promise<TrendingNewsData>;
-/** Fetches news articles for a single topic. */
-declare function getTrendingNewsForTopic(topic: string, options: Omit<TrendingNewsOptions, 'topic'>): Promise<TrendingNewsTopicData>;
-
-declare function useTrendingNews(options?: TrendingNewsOptions): {
-    data: TrendingNewsData | null;
-    error: Error | null;
-    loading: boolean;
-};
-
-type Props = TrendingNewsOptions & {
-    className?: string;
-    style?: React.CSSProperties;
-    compact?: boolean;
-    /** Max trending topics to render (default 8). */
-    maxTopics?: number;
-    /**
-     * When set on a `compact` card, a chevron toggles between the compact
-     * topic row and a full topic-by-topic article list, without leaving the
-     * card's layout. Ignored outside `compact` mode, which already shows the
-     * full list.
-     */
-    expandable?: boolean;
-    /** Max topics to render once expanded (default 15). */
-    expandedMaxTopics?: number;
-    /** Show each topic's lead article thumbnail image, when available (default true). */
-    showImages?: boolean;
-};
-/**
- * Trending news widget. Requires `apiEndpoint` pointing at a deployed
- * instance of the bundled Cloudflare Worker (`worker/index.ts`) — renders
- * nothing when it's not configured, still loading, or errored, so it never
- * disrupts the layout it's dropped into.
- */
-declare function TrendingNews(props: Props): React.JSX.Element | null;
-
-export { type NewsArticle, TrendingNews, type TrendingNewsData, type TrendingNewsOptions, type TrendingNewsTopicData, type TrendingTopic, clearTrendingNewsCache, getTrendingNews, getTrendingNewsForTopic, useTrendingNews };
+export * from './types';
+export { clearTrendingNewsCache } from './lib/cache';
+export * from './api/trending';
+export * from './hooks/useTrendingNews';
+export * from './components/TrendingNews';

package/dist/lib/cache.d.ts

@@ -0,0 +1,5 @@
+/** Returns the cached value for `key` if it was written within the last 10 minutes. */
+export declare function readCachedTrendingNews<T>(key: string): T | null;
+export declare function writeCachedTrendingNews<T>(key: string, data: T): void;
+/** Clears all cached trending news responses. Mainly useful for tests/debugging. */
+export declare function clearTrendingNewsCache(): void;

package/dist/types.d.ts

@@ -0,0 +1,31 @@
+export type NewsArticle = {
+    title: string;
+    url?: string;
+    source?: string;
+    publishedAt?: string;
+    imageUrl?: string;
+};
+export type TrendingTopic = {
+    topic: string;
+    wikiRank?: number;
+    wikiViews?: number;
+    newsCount: number;
+    articles: NewsArticle[];
+};
+export type TrendingNewsData = {
+    date?: string;
+    topics: TrendingTopic[];
+};
+export type TrendingNewsTopicData = {
+    topic: string;
+    newsCount: number;
+    articles: NewsArticle[];
+};
+export type TrendingNewsOptions = {
+    /** URL of a deployed instance of the bundled Cloudflare Worker (`worker/index.ts`). */
+    apiEndpoint?: string;
+    /** When set, fetches news for this single topic instead of the daily trending list. */
+    topic?: string;
+    /** Max trending topics to request from the worker (default 25). */
+    limit?: number;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trending-news-api",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "React trending news widget backed by Wikipedia pageviews and The News API, via a Cloudflare Worker proxy",
   "keywords": [
     "react",
@@ -37,22 +37,22 @@
     "react-dom": "^18 || ^19"
   },
   "devDependencies": {
-    "@cloudflare/workers-types": "^4.20250115.0",
-    "@testing-library/react": "^16.1.0",
-    "@types/react": "^19.0.0",
-    "@types/react-dom": "^19.0.0",
-    "@vitejs/plugin-react": "^6.0.3",
-    "@vitest/coverage-v8": "^4.0.18",
-    "jsdom": "^28.1.0",
-    "react": "^19.2.7",
-    "react-dom": "^19.2.7",
-    "tsup": "^8.2.4",
-    "typescript": "^5.6.3",
-    "vitest": "^4.0.18",
-    "wrangler": "^3.88.0"
+    "@cloudflare/workers-types": "^5.20260908.1",
+    "@testing-library/react": "^16.3.3",
+    "@types/react": "^19.2.18",
+    "@types/react-dom": "^19.2.7",
+    "@vitejs/plugin-react": "^6.1.1",
+    "@vitest/coverage-v8": "^5.0.0",
+    "jsdom": "^30.0.1",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
+    "tsup": "^8.5.1",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.0",
+    "wrangler": "^4.130.0"
   },
   "scripts": {
-    "build": "tsup",
+    "build": "tsup && tsc --project tsconfig.build.json",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
     "test:coverage": "vitest run --coverage",

package/dist/index.d.cts

@@ -1,78 +0,0 @@
-import React from 'react';
-
-type NewsArticle = {
-    title: string;
-    url?: string;
-    source?: string;
-    publishedAt?: string;
-    imageUrl?: string;
-};
-type TrendingTopic = {
-    topic: string;
-    wikiRank?: number;
-    wikiViews?: number;
-    newsCount: number;
-    articles: NewsArticle[];
-};
-type TrendingNewsData = {
-    date?: string;
-    topics: TrendingTopic[];
-};
-type TrendingNewsTopicData = {
-    topic: string;
-    newsCount: number;
-    articles: NewsArticle[];
-};
-type TrendingNewsOptions = {
-    /** URL of a deployed instance of the bundled Cloudflare Worker (`worker/index.ts`). */
-    apiEndpoint?: string;
-    /** When set, fetches news for this single topic instead of the daily trending list. */
-    topic?: string;
-    /** Max trending topics to request from the worker (default 25). */
-    limit?: number;
-};
-
-/** Clears all cached trending news responses. Mainly useful for tests/debugging. */
-declare function clearTrendingNewsCache(): void;
-
-/**
- * Fetches trending topics (or, when `options.topic` is set, news for a
- * single topic) from a deployed instance of `worker/index.ts`.
- */
-declare function getTrendingNews(options: TrendingNewsOptions): Promise<TrendingNewsData>;
-/** Fetches news articles for a single topic. */
-declare function getTrendingNewsForTopic(topic: string, options: Omit<TrendingNewsOptions, 'topic'>): Promise<TrendingNewsTopicData>;
-
-declare function useTrendingNews(options?: TrendingNewsOptions): {
-    data: TrendingNewsData | null;
-    error: Error | null;
-    loading: boolean;
-};
-
-type Props = TrendingNewsOptions & {
-    className?: string;
-    style?: React.CSSProperties;
-    compact?: boolean;
-    /** Max trending topics to render (default 8). */
-    maxTopics?: number;
-    /**
-     * When set on a `compact` card, a chevron toggles between the compact
-     * topic row and a full topic-by-topic article list, without leaving the
-     * card's layout. Ignored outside `compact` mode, which already shows the
-     * full list.
-     */
-    expandable?: boolean;
-    /** Max topics to render once expanded (default 15). */
-    expandedMaxTopics?: number;
-    /** Show each topic's lead article thumbnail image, when available (default true). */
-    showImages?: boolean;
-};
-/**
- * Trending news widget. Requires `apiEndpoint` pointing at a deployed
- * instance of the bundled Cloudflare Worker (`worker/index.ts`) — renders
- * nothing when it's not configured, still loading, or errored, so it never
- * disrupts the layout it's dropped into.
- */
-declare function TrendingNews(props: Props): React.JSX.Element | null;
-
-export { type NewsArticle, TrendingNews, type TrendingNewsData, type TrendingNewsOptions, type TrendingNewsTopicData, type TrendingTopic, clearTrendingNewsCache, getTrendingNews, getTrendingNewsForTopic, useTrendingNews };