Loading latest posts...
', LOAD_FAILED: 'Failed to load posts. Please try again later.
', NO_POSTS: 'No latest posts available at this time.
', ERROR: { - MISSING_CONTAINER: (id) => + MISSING_CONTAINER: (id: string) => `Feed container with ID '${id}' not found in the DOM.`, - MISSING_PARAMETER: (param) => `Missing required parameter(s): ${param}`, - MISSING_PARAMETER_DETAIL: (param, fn) => - `${PREFIX} Missing required parameter(s) for ${fn}: ${param}`, + MISSING_PARAMETER: (param: string) => + `Missing required parameter(s): ${param}`, INVALID_PROXY_URL: "Invalid 'proxyUrl'. Must be a valid URL string.", INVALID_CATEGORY_LABEL: "Invalid 'categoryLabel'. Must be a string.", LOAD_FEEDS_FAILED: 'Error initializing blogroll.', FETCH_FAILED: `${PREFIX} Failed to fetch data for some feeds:`, }, WARN: { - NO_POSTS_FOR_ID: (id) => `${PREFIX} No posts found for feed ID: ${id}`, - INVALID_DATE_FOR_ID: (id) => + NO_POSTS_FOR_ID: (id: string) => + `${PREFIX} No posts found for feed ID: ${id}`, + INVALID_DATE_FOR_ID: (id: string) => `${PREFIX} Invalid publish date for feed ID: ${id}`, }, }; diff --git a/src/types.d.ts b/src/types.d.ts new file mode 100644 index 0000000..14a3b65 --- /dev/null +++ b/src/types.d.ts @@ -0,0 +1,32 @@ +export interface AggregatorItem { + title: string; + published?: number; + alternate?: Array<{ href: string }>; + summary?: { content: string }; + feedId?: string; + feedTitle?: string; + feedHtmlUrl?: string; + feedIconUrl?: string; + author?: string; +} + +export interface AggregatorResponse { + items: AggregatorItem[]; + page: number; + limit: number; + totalItems: number; +} + +export interface SortableFeed { + pubDate: Date | null; + [key: string]: unknown; +} + +export interface TransformedFeed extends SortableFeed { + feedTitle: string; + feedUrl: string; + feedIcon?: string; + postTitle: string; + postUrl: string; + readingTime: string | null; +} diff --git a/src/utils/common.js b/src/utils/common.js deleted file mode 100644 index ffcfd93..0000000 --- a/src/utils/common.js +++ /dev/null @@ -1,70 +0,0 @@ -/** - * Estimates the average reading time of a text based on the word count. - * - * @param {string} content - The content to estimate reading time for (e.g., HTML or plain text). - * @param {number} [wordsPerMinute=250] - The average reading speed in words per minute. - * @returns {string} - A string representing the estimated reading time (e.g., "3 min read"). - */ -export function calculateReadingTime(content, wordsPerMinute = 250) { - if (typeof content !== 'string') { - throw new Error( - "Invalid content provided to 'calculateReadingTime'. Expected a string." - ); - } - if (typeof wordsPerMinute !== 'number' || wordsPerMinute <= 0) { - throw new Error( - "Invalid 'wordsPerMinute' value. Expected a positive number." - ); - } - - // Remove HTML tags and count words - const plainText = content - .replace(/<\/?[^>]+(>|$)/g, '') - .replace(/&[^;]+;/g, ' '); - const wordCount = plainText - .trim() - .split(/\s+/) - .filter((word) => word.length > 0).length; - - if (wordCount === 0) { - return '0 min read'; - } - - // Calculate and format reading time - const minutes = Math.ceil(wordCount / wordsPerMinute); - return `${minutes} min read`; -} - -/** - * Helper function to construct a URL with optional query parameters. - * - * @param {string} baseUrl - The base URL. - * @param {string} endpoint - The endpoint to append to the base URL. - * @param {Object} [queryParams] - Optional query parameters as key-value pairs. - * @returns {string} - The constructed URL. - */ -export function constructApiUrl(baseUrl, endpoint, queryParams = {}) { - const url = new URL(endpoint, baseUrl); - Object.keys(queryParams).forEach((key) => - url.searchParams.append(key, queryParams[key]) - ); - return url.toString(); -} - -/** - * Sort feeds by publication date in descending order. - * - * @param {Array} feeds - Array of feed data objects. - * @returns {Array} - Sorted feeds data. - */ -export function sortFeedsByDate(feeds) { - return feeds - .filter((feed) => { - if (!(feed.pubDate instanceof Date) || isNaN(feed.pubDate)) { - console.warn(`Invalid pubDate for feed: ${feed}`); - return false; - } - return true; - }) - .sort((a, b) => b.pubDate - a.pubDate); -} diff --git a/src/utils/common.ts b/src/utils/common.ts new file mode 100644 index 0000000..33cb3ff --- /dev/null +++ b/src/utils/common.ts @@ -0,0 +1,33 @@ +/** + * Estimates the average reading time of a text based on the word count. + * @param content - The text content (e.g., HTML or plain text). + * @param wordsPerMinute - The average reading speed in words per minute (defaults to 250). + * @returns A string representing the estimated reading time (e.g., "3 min read"). + */ +export function calculateReadingTime( + content: string, + wordsPerMinute: number = 250 +): string { + if (wordsPerMinute <= 0) { + throw new Error( + "Invalid 'wordsPerMinute' value. Expected a positive number." + ); + } + + // Remove HTML tags and count words + const plainText = content + .replace(/<\/?[^>]+(>|$)/g, '') + .replace(/&[^;]+;/g, ' '); + const wordCount = plainText + .trim() + .split(/\s+/) + .filter((word) => word.length > 0).length; + + if (wordCount === 0) { + return '0 min read'; + } + + // Calculate and format reading time + const minutes = Math.ceil(wordCount / wordsPerMinute); + return `${minutes} min read`; +} diff --git a/src/utils/date.js b/src/utils/date.js deleted file mode 100644 index 67d1fcb..0000000 --- a/src/utils/date.js +++ /dev/null @@ -1,72 +0,0 @@ -/** - * Calulates the time elapsed since a given date and formats it as a human-readable string. - * - * @param {Date} date - The date to calculate the elapsed time from. - * @param {Object} [labels] - Custom labels for intervals (e.g., { year: "año", second: "segundo" }). - * @param {number} [threshold=5] - Number of seconds under which to return "just now". - * @returns {string} - A string representing the relative time (e.g., "2 days ago"). - */ -function timeSince(date, labels = {}, threshold = 5) { - if (!(date instanceof Date)) { - throw new Error( - "Invalid date provided to 'timeSince'. Expected a Date object." - ); - } - - const seconds = Math.floor((Date.now() - date.getTime()) / 1000); - - if (seconds < 0) { - return 'in the future'; - } - - if (seconds < threshold) { - return 'just now'; - } - - const defaultLabels = { - year: 'year', - month: 'month', - day: 'day', - hour: 'hour', - minute: 'minute', - second: 'second', - }; - - const intervals = [ - { label: 'year', seconds: 31536000 }, - { label: 'month', seconds: 2592000 }, - { label: 'day', seconds: 86400 }, - { label: 'hour', seconds: 3600 }, - { label: 'minute', seconds: 60 }, - { label: 'second', seconds: 1 }, - ]; - - const finalLabels = { ...defaultLabels, ...labels }; - - for (const interval of intervals) { - const count = Math.floor(seconds / interval.seconds); - if (count >= 1) { - const label = finalLabels[interval.label] || interval.label; - return `${count} ${label}${count > 1 ? 's' : ''} ago`; - } - } - return 'just now'; -} - -/** - * Get the relative date string. - * - * @param {string|Date} pubDate - Publication date. - * @param {Object} [labels] - Custom labels for intervals (optional). - * @param {number} [threshold=5] - Seconds threshold for returning "just now". - * @returns {string} - Relative date string. - */ -export function getRelativeDate(pubDate, labels = {}, threshold = 5) { - if (pubDate) { - const parsedDate = new Date(pubDate); - if (!isNaN(parsedDate.getTime())) { - return timeSince(parsedDate, labels, threshold); - } - } - return 'Unknown Date'; -} diff --git a/src/utils/date.ts b/src/utils/date.ts new file mode 100644 index 0000000..ee268d8 --- /dev/null +++ b/src/utils/date.ts @@ -0,0 +1,82 @@ +type TimeIntervalLabel = + | 'year' + | 'month' + | 'day' + | 'hour' + | 'minute' + | 'second'; + +interface Interval { + label: TimeIntervalLabel; + seconds: number; +} + +const defaultLabels: RecordThis is a test sentence with ten words.
'; - expect(calculateReadingTime(html)).toBe('1 min read'); - }); - - test('should throw error for invalid input', () => { - expect(() => calculateReadingTime(12345)).toThrow( - "Invalid content provided to 'calculateReadingTime'. Expected a string." - ); - }); - - test('should throw an error for invalid wordsPerMinute value', () => { - expect(() => calculateReadingTime(content, 'invalid')).toThrow( - "Invalid 'wordsPerMinute' value. Expected a positive number." - ); - - expect(() => calculateReadingTime(content, -100)).toThrow( - "Invalid 'wordsPerMinute' value. Expected a positive number." - ); - - expect(() => calculateReadingTime(content, 0)).toThrow( - "Invalid 'wordsPerMinute' value. Expected a positive number." - ); - }); - - test('should calculate reading time for empty string', () => { - expect(calculateReadingTime('')).toBe('0 min read'); - }); - - test('should calculate reading time for very long content', () => { - const longContent = 'word '.repeat(1000); - expect(calculateReadingTime(longContent)).toBe('4 min read'); - }); - - test('should calculate reading time for HTML with nested elements', () => { - const nestedHtml = - 'This is a test sentence with ten words.
This is a test sentence with ten words.
'; + expect(calculateReadingTime(html)).toBe('1 min read'); + }); + + test('should throw an error for invalid wordsPerMinute value', () => { + expect(() => calculateReadingTime(content, -100)).toThrow( + "Invalid 'wordsPerMinute' value. Expected a positive number." + ); + + expect(() => calculateReadingTime(content, 0)).toThrow( + "Invalid 'wordsPerMinute' value. Expected a positive number." + ); + }); + + test('should calculate reading time for empty string', () => { + expect(calculateReadingTime('')).toBe('0 min read'); + }); + + test('should calculate reading time for very long content', () => { + const longContent = 'word '.repeat(1000); + expect(calculateReadingTime(longContent)).toBe('4 min read'); + }); + + test('should calculate reading time for HTML with nested elements', () => { + const nestedHtml = + 'This is a test sentence with ten words.