@rapthi/podca-ts 1.0.1 → 1.0.4

package/dist/index.cjs

@@ -0,0 +1,160 @@
+'use strict';
+
+var podcastParser = require('@sesamy/podcast-parser');
+
+// src/itunes-search/itunes-search.ts
+var _ItunesSearch = class _ItunesSearch {
+  constructor() {
+  }
+  async search(option) {
+    const searchUrlWithParams = this.buildSearchUrl(option);
+    try {
+      const response = await fetch(searchUrlWithParams);
+      if (!response.ok) {
+        throw new Error(
+          `Failed to fetch data from iTunes Search API: ${response.status}}`
+        );
+      }
+      return await response.json();
+    } catch (error) {
+      if (error instanceof Error) {
+        throw new Error(`Fetch failed: ${error.message}`);
+      }
+      throw error;
+    }
+  }
+  buildSearchUrl(option) {
+    const url = new URL(_ItunesSearch.ITUNES_SEARCH_URL);
+    for (const [key, value] of Object.entries(option)) {
+      if (value !== void 0) {
+        url.searchParams.append(key, String(value));
+      }
+    }
+    return url.toString();
+  }
+};
+_ItunesSearch.ITUNES_SEARCH_URL = "https://itunes.apple.com/search";
+var ItunesSearch = _ItunesSearch;
+var PodcastLoader = class {
+  constructor() {
+    this.FETCH_TIMEOUT_MS = 3e4;
+  }
+  /**
+   * Fetches and parses a podcast feed from the given URL
+   * @param feedUrl - The URL of the podcast feed
+   * @returns A Promise resolving to the parsed Podcast
+   * @throws Error if the feed is invalid or the fetch fails
+   */
+  async getPodcastFromFeed(feedUrl) {
+    this.validateUrl(feedUrl);
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.FETCH_TIMEOUT_MS);
+    try {
+      const response = await fetch(feedUrl, { signal: controller.signal });
+      if (!response.ok) {
+        throw new Error(
+          `Failed to fetch podcast feed: ${response.status} ${response.statusText}`
+        );
+      }
+      const xmlString = await response.text();
+      if (!xmlString.trim()) {
+        throw new Error("Podcast feed is empty");
+      }
+      const podcastFromXml = await podcastParser.parseFeedToJson(xmlString);
+      const channel = this.extractChannel(podcastFromXml);
+      this.validateChannel(channel);
+      return this.mapChannel(channel);
+    } catch (error) {
+      if (error instanceof Error && error.name === "AbortError") {
+        throw new Error(`Podcast feed request timeout after ${this.FETCH_TIMEOUT_MS}ms`);
+      }
+      if (error instanceof Error) {
+        throw new Error(`Failed to load podcast feed: ${error.message}`);
+      }
+      throw error;
+    } finally {
+      clearTimeout(timeoutId);
+    }
+  }
+  validateUrl(feedUrl) {
+    try {
+      new URL(feedUrl);
+    } catch {
+      throw new Error(`Invalid feed URL: ${feedUrl}`);
+    }
+  }
+  extractChannel(podcastFromXml) {
+    const channel = podcastFromXml?.rss?.channel;
+    if (!channel) {
+      throw new Error("Invalid podcast feed: missing channel data");
+    }
+    return channel;
+  }
+  validateChannel(channel) {
+    if (!channel.title) {
+      throw new Error('Invalid podcast feed: missing required field "title"');
+    }
+    if (!channel.link) {
+      throw new Error('Invalid podcast feed: missing required field "link"');
+    }
+  }
+  mapChannel(channel) {
+    return {
+      title: channel.title,
+      description: channel.description,
+      link: channel.link,
+      language: channel.language,
+      categories: this.mapCategories(channel["itunes:category"]),
+      explicit: channel["itunes:explicit"] === "true",
+      imageUrl: channel["itunes:image"]?.["@_href"],
+      author: channel["itunes:author"],
+      copyright: channel["copyright"],
+      fundingUrl: channel["podcast:funding"]?.["@_url"],
+      type: channel["itunes:type"],
+      episodes: this.mapEpisodes(channel.item)
+    };
+  }
+  mapCategories(categories) {
+    if (!categories) {
+      return [];
+    }
+    return categories.flatMap((category) => [
+      { name: category["@_text"] },
+      ...category["itunes:category"]?.map((sub) => ({ name: sub["@_text"] })) || []
+    ]);
+  }
+  mapEpisodes(items) {
+    if (!items) {
+      return [];
+    }
+    return items.map((item) => ({
+      title: item.title,
+      enclosure: this.mapEnclosure(item.enclosure),
+      guid: item.guid["#text"],
+      linkUrl: item.link,
+      pubDate: item.pubDate,
+      description: item.description,
+      durationInSeconds: item["itunes:duration"],
+      imageUrl: item["itunes:image"]?.["@_href"],
+      explicit: item["itunes:explicit"] === "yes",
+      number: item["itunes:episode"],
+      season: item["itunes:season"],
+      type: item["itunes:episodeType"]
+    }));
+  }
+  mapEnclosure(enclosure) {
+    if (!enclosure?.[0]) {
+      return void 0;
+    }
+    return {
+      url: enclosure[0]["@_url"],
+      type: enclosure[0]["@_type"],
+      length: enclosure[0]["@_length"]
+    };
+  }
+};
+
+exports.ItunesSearch = ItunesSearch;
+exports.PodcastLoader = PodcastLoader;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/itunes-search/itunes-search.ts","../src/podcast/podcast.ts"],"names":["parseFeedToJson"],"mappings":"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","file":"index.cjs","sourcesContent":["import type { ITunesSearchParams, MediaType } from './itunes-search-options.js';\nimport type { ITunesSearchResponse } from './itunes-search-result.js';\n\nexport class ItunesSearch {\n  private static readonly ITUNES_SEARCH_URL = 'https://itunes.apple.com/search';\n\n  constructor() {}\n\n  async search<T extends MediaType>(option: ITunesSearchParams<T>): Promise<ITunesSearchResponse> {\n    const searchUrlWithParams = this.buildSearchUrl(option);\n\n    try {\n      const response = await fetch(searchUrlWithParams);\n\n      if (!response.ok) {\n        // noinspection ExceptionCaughtLocallyJS\n        throw new Error(\n          `Failed to fetch data from iTunes Search API: ${response.status}}`,\n        );\n      }\n\n      return await response.json() as ITunesSearchResponse;\n    } catch (error) {\n      if (error instanceof Error) {\n        throw new Error(`Fetch failed: ${error.message}`);\n      }\n\n      throw error;\n    }\n  }\n\n  private buildSearchUrl<T extends MediaType>(option: ITunesSearchParams<T>): string {\n    const url = new URL(ItunesSearch.ITUNES_SEARCH_URL);\n\n    for (const [key, value] of Object.entries(option)) {\n      if (value !== undefined) {\n        url.searchParams.append(key, String(value));\n      }\n    }\n\n    return url.toString();\n  }\n}\n","import { parseFeedToJson } from '@sesamy/podcast-parser';\n\ninterface RawCategory {\n  '@_text': string;\n  'itunes:category'?: RawCategory[];\n}\n\ninterface RawEnclosure {\n  '@_url': string;\n  '@_type': string;\n  '@_length': string;\n}\n\ninterface RawEpisode {\n  title?: string;\n  guid: { '#text': string };\n  link?: string;\n  pubDate?: string;\n  description?: string;\n  'itunes:duration'?: string | number;\n  'itunes:image'?: { '@_href': string };\n  'itunes:explicit'?: 'yes' | 'no';\n  'itunes:episode'?: number;\n  'itunes:season'?: number;\n  'itunes:episodeType'?: string;\n  enclosure?: RawEnclosure[];\n}\n\ninterface RawChannel {\n  title: string;\n  description?: string;\n  link: string;\n  language?: string;\n  'itunes:category'?: RawCategory[];\n  'itunes:explicit'?: 'true' | 'false';\n  'itunes:image'?: { '@_href': string };\n  'itunes:author'?: string;\n  copyright?: string;\n  'podcast:funding'?: { '@_url': string };\n  'itunes:type'?: string;\n  item?: RawEpisode[];\n}\n\ninterface RawPodcastFeed {\n  rss?: {\n    channel?: RawChannel;\n  };\n}\n\nexport class PodcastLoader {\n  private readonly FETCH_TIMEOUT_MS = 30000;\n\n  /**\n   * Fetches and parses a podcast feed from the given URL\n   * @param feedUrl - The URL of the podcast feed\n   * @returns A Promise resolving to the parsed Podcast\n   * @throws Error if the feed is invalid or the fetch fails\n   */\n  async getPodcastFromFeed(feedUrl: string): Promise<Podcast> {\n    this.validateUrl(feedUrl);\n\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this.FETCH_TIMEOUT_MS);\n\n    try {\n      const response = await fetch(feedUrl, { signal: controller.signal });\n\n      if (!response.ok) {\n        throw new Error(\n          `Failed to fetch podcast feed: ${response.status} ${response.statusText}`,\n        );\n      }\n\n      const xmlString = await response.text();\n\n      if (!xmlString.trim()) {\n        throw new Error('Podcast feed is empty');\n      }\n\n      const podcastFromXml = await parseFeedToJson(xmlString) as RawPodcastFeed;\n      const channel = this.extractChannel(podcastFromXml);\n\n      this.validateChannel(channel);\n\n      return this.mapChannel(channel);\n    } catch (error) {\n      if (error instanceof Error && error.name === 'AbortError') {\n        throw new Error(`Podcast feed request timeout after ${this.FETCH_TIMEOUT_MS}ms`);\n      }\n\n      if (error instanceof Error) {\n        throw new Error(`Failed to load podcast feed: ${error.message}`);\n      }\n\n      throw error;\n    } finally {\n      clearTimeout(timeoutId);\n    }\n  }\n\n  private validateUrl(feedUrl: string): void {\n    try {\n      new URL(feedUrl);\n    } catch {\n      throw new Error(`Invalid feed URL: ${feedUrl}`);\n    }\n  }\n\n  private extractChannel(podcastFromXml: RawPodcastFeed): RawChannel {\n    const channel = podcastFromXml?.rss?.channel;\n\n    if (!channel) {\n      throw new Error('Invalid podcast feed: missing channel data');\n    }\n\n    return channel;\n  }\n\n  private validateChannel(channel: RawChannel): void {\n    if (!channel.title) {\n      throw new Error('Invalid podcast feed: missing required field \"title\"');\n    }\n\n    if (!channel.link) {\n      throw new Error('Invalid podcast feed: missing required field \"link\"');\n    }\n  }\n\n  private mapChannel(channel: RawChannel): Podcast {\n    return {\n      title: channel.title,\n      description: channel.description,\n      link: channel.link,\n      language: channel.language,\n      categories: this.mapCategories(channel['itunes:category']),\n      explicit: channel['itunes:explicit'] === 'true',\n      imageUrl: channel['itunes:image']?.['@_href'],\n      author: channel['itunes:author'],\n      copyright: channel['copyright'],\n      fundingUrl: channel['podcast:funding']?.['@_url'],\n      type: channel['itunes:type'],\n      episodes: this.mapEpisodes(channel.item),\n    };\n  }\n\n  private mapCategories(categories: RawCategory[] | undefined): Category[] {\n    if (!categories) {return [];}\n\n    return categories.flatMap((category) => [\n      { name: category['@_text'] },\n      ...(category['itunes:category']?.map((sub) => ({ name: sub['@_text'] })) || []),\n    ]);\n  }\n\n  private mapEpisodes(items: RawEpisode[] | undefined): Episode[] {\n    if (!items) {return [];}\n\n    return items.map((item) => ({\n      title: item.title,\n      enclosure: this.mapEnclosure(item.enclosure),\n      guid: item.guid['#text'],\n      linkUrl: item.link,\n      pubDate: item.pubDate,\n      description: item.description,\n      durationInSeconds: item['itunes:duration'],\n      imageUrl: item['itunes:image']?.['@_href'],\n      explicit: item['itunes:explicit'] === 'yes',\n      number: item['itunes:episode'],\n      season: item['itunes:season'],\n      type: item['itunes:episodeType'],\n    }));\n  }\n\n  private mapEnclosure(enclosure: RawEnclosure[] | undefined): Enclosure | undefined {\n    if (!enclosure?.[0]) {return undefined;}\n\n    return {\n      url: enclosure[0]['@_url'],\n      type: enclosure[0]['@_type'],\n      length: enclosure[0]['@_length'],\n    };\n  }\n}\n\nexport interface Category {\n  name: string;\n}\n\nexport interface Episode {\n  title: string | undefined;\n  enclosure: Enclosure | undefined;\n  guid: string;\n  linkUrl?: string;\n  pubDate?: string;\n  description?: string;\n  durationInSeconds?: string | number | undefined;\n  imageUrl?: string;\n  explicit?: boolean;\n  number?: number;\n  season?: number;\n  type?: string | undefined;\n}\n\nexport interface Enclosure {\n  length: string;\n  type: string;\n  url: string;\n}\n\nexport interface Podcast {\n  title: string;\n  description: string | undefined;\n  link: string;\n  language: string | undefined;\n  categories: Category[];\n  explicit: boolean;\n  imageUrl?: string;\n  author?: string;\n  copyright?: string;\n  fundingUrl?: string;\n  type?: string;\n  complete?: boolean;\n  episodes?: Episode[];\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,118 @@
+type MediaType = 'movie' | 'podcast' | 'music' | 'musicVideo' | 'audiobook' | 'shortFilm' | 'tvShow' | 'software' | 'ebook' | 'all';
+type Entity = 'movieArtist' | 'movie' | 'podcastAuthor' | 'podcast' | 'musicArtist' | 'musicTrack' | 'album' | 'musicVideo' | 'mix' | 'song' | 'audiobookAuthor' | 'audiobook' | 'shortFilmArtist' | 'shortFilm' | 'tvEpisode' | 'tvSeason' | 'software' | 'iPadSoftware' | 'macSoftware' | 'ebook' | 'allArtist' | 'allTrack';
+type EntityForMediaType<T extends MediaType> = T extends 'movie' ? 'movieArtist' | 'movie' : T extends 'podcast' ? 'podcastAuthor' | 'podcast' : T extends 'music' ? 'musicArtist' | 'musicTrack' | 'album' | 'musicVideo' | 'mix' | 'song' : T extends 'musicVideo' ? 'musicArtist' | 'musicVideo' : T extends 'audiobook' ? 'audiobookAuthor' | 'audiobook' : T extends 'shortFilm' ? 'shortFilmArtist' | 'shortFilm' : T extends 'tvShow' ? 'tvEpisode' | 'tvSeason' : T extends 'software' ? 'software' | 'iPadSoftware' | 'macSoftware' : T extends 'ebook' ? 'ebook' : T extends 'all' ? 'movie' | 'album' | 'allArtist' | 'podcast' | 'musicVideo' | 'mix' | 'audiobook' | 'tvSeason' | 'allTrack' : never;
+interface ITunesSearchParams<T extends MediaType> {
+    media: T;
+    entity?: EntityForMediaType<T>;
+    term: string;
+    country?: string;
+    limit?: number;
+    lang?: string;
+    version?: number;
+    explicit?: 'Yes' | 'No';
+}
+
+type WrapperType = 'track' | 'collection' | 'artist';
+type Explicitness = 'explicit' | 'cleaned' | 'notExplicit';
+type Kind = 'book' | 'album' | 'coached-audio' | 'feature-movie' | 'interactive-booklet' | 'music-video' | 'pdf' | 'podcast' | 'podcast-episode' | 'software-package' | 'song' | 'tv-episode' | 'artist';
+interface ITunesSearchResult {
+    wrapperType: WrapperType;
+    kind: Kind;
+    artistId?: number;
+    collectionId?: number;
+    trackId?: number;
+    artistName?: string;
+    collectionName?: string;
+    trackName?: string;
+    collectionCensoredName?: string;
+    trackCensoredName?: string;
+    artistViewUrl?: string;
+    collectionViewUrl?: string;
+    trackViewUrl?: string;
+    previewUrl?: string;
+    artworkUrl30?: string;
+    artworkUrl60?: string;
+    artworkUrl100?: string;
+    collectionPrice?: number;
+    trackPrice?: number;
+    collectionExplicitness?: Explicitness;
+    trackExplicitness?: Explicitness;
+    discCount?: number;
+    discNumber?: number;
+    trackCount?: number;
+    trackNumber?: number;
+    trackTimeMillis?: number;
+    country?: string;
+    currency?: string;
+    primaryGenreName?: string;
+    releaseDate?: string;
+    feedUrl?: string;
+}
+interface ITunesSearchResponse {
+    resultCount: number;
+    results: ITunesSearchResult[];
+}
+
+declare class ItunesSearch {
+    private static readonly ITUNES_SEARCH_URL;
+    constructor();
+    search<T extends MediaType>(option: ITunesSearchParams<T>): Promise<ITunesSearchResponse>;
+    private buildSearchUrl;
+}
+
+declare class PodcastLoader {
+    private readonly FETCH_TIMEOUT_MS;
+    /**
+     * Fetches and parses a podcast feed from the given URL
+     * @param feedUrl - The URL of the podcast feed
+     * @returns A Promise resolving to the parsed Podcast
+     * @throws Error if the feed is invalid or the fetch fails
+     */
+    getPodcastFromFeed(feedUrl: string): Promise<Podcast>;
+    private validateUrl;
+    private extractChannel;
+    private validateChannel;
+    private mapChannel;
+    private mapCategories;
+    private mapEpisodes;
+    private mapEnclosure;
+}
+interface Category {
+    name: string;
+}
+interface Episode {
+    title: string | undefined;
+    enclosure: Enclosure | undefined;
+    guid: string;
+    linkUrl?: string;
+    pubDate?: string;
+    description?: string;
+    durationInSeconds?: string | number | undefined;
+    imageUrl?: string;
+    explicit?: boolean;
+    number?: number;
+    season?: number;
+    type?: string | undefined;
+}
+interface Enclosure {
+    length: string;
+    type: string;
+    url: string;
+}
+interface Podcast {
+    title: string;
+    description: string | undefined;
+    link: string;
+    language: string | undefined;
+    categories: Category[];
+    explicit: boolean;
+    imageUrl?: string;
+    author?: string;
+    copyright?: string;
+    fundingUrl?: string;
+    type?: string;
+    complete?: boolean;
+    episodes?: Episode[];
+}
+
+export { type Category, type Enclosure, type Entity, type Episode, type Explicitness, type ITunesSearchParams, type ITunesSearchResponse, type ITunesSearchResult, ItunesSearch, type Kind, type MediaType, type Podcast, PodcastLoader, type WrapperType };

package/dist/index.d.ts

@@ -1,5 +1,118 @@
-export type * from './itunes-search/itunes-search-options.js';
-export type * from './itunes-search/itunes-search-result.js';
-export * from './itunes-search/itunes-search.js';
-export * from './podcast/podcast.js';
-//# sourceMappingURL=index.d.ts.map
+type MediaType = 'movie' | 'podcast' | 'music' | 'musicVideo' | 'audiobook' | 'shortFilm' | 'tvShow' | 'software' | 'ebook' | 'all';
+type Entity = 'movieArtist' | 'movie' | 'podcastAuthor' | 'podcast' | 'musicArtist' | 'musicTrack' | 'album' | 'musicVideo' | 'mix' | 'song' | 'audiobookAuthor' | 'audiobook' | 'shortFilmArtist' | 'shortFilm' | 'tvEpisode' | 'tvSeason' | 'software' | 'iPadSoftware' | 'macSoftware' | 'ebook' | 'allArtist' | 'allTrack';
+type EntityForMediaType<T extends MediaType> = T extends 'movie' ? 'movieArtist' | 'movie' : T extends 'podcast' ? 'podcastAuthor' | 'podcast' : T extends 'music' ? 'musicArtist' | 'musicTrack' | 'album' | 'musicVideo' | 'mix' | 'song' : T extends 'musicVideo' ? 'musicArtist' | 'musicVideo' : T extends 'audiobook' ? 'audiobookAuthor' | 'audiobook' : T extends 'shortFilm' ? 'shortFilmArtist' | 'shortFilm' : T extends 'tvShow' ? 'tvEpisode' | 'tvSeason' : T extends 'software' ? 'software' | 'iPadSoftware' | 'macSoftware' : T extends 'ebook' ? 'ebook' : T extends 'all' ? 'movie' | 'album' | 'allArtist' | 'podcast' | 'musicVideo' | 'mix' | 'audiobook' | 'tvSeason' | 'allTrack' : never;
+interface ITunesSearchParams<T extends MediaType> {
+    media: T;
+    entity?: EntityForMediaType<T>;
+    term: string;
+    country?: string;
+    limit?: number;
+    lang?: string;
+    version?: number;
+    explicit?: 'Yes' | 'No';
+}
+
+type WrapperType = 'track' | 'collection' | 'artist';
+type Explicitness = 'explicit' | 'cleaned' | 'notExplicit';
+type Kind = 'book' | 'album' | 'coached-audio' | 'feature-movie' | 'interactive-booklet' | 'music-video' | 'pdf' | 'podcast' | 'podcast-episode' | 'software-package' | 'song' | 'tv-episode' | 'artist';
+interface ITunesSearchResult {
+    wrapperType: WrapperType;
+    kind: Kind;
+    artistId?: number;
+    collectionId?: number;
+    trackId?: number;
+    artistName?: string;
+    collectionName?: string;
+    trackName?: string;
+    collectionCensoredName?: string;
+    trackCensoredName?: string;
+    artistViewUrl?: string;
+    collectionViewUrl?: string;
+    trackViewUrl?: string;
+    previewUrl?: string;
+    artworkUrl30?: string;
+    artworkUrl60?: string;
+    artworkUrl100?: string;
+    collectionPrice?: number;
+    trackPrice?: number;
+    collectionExplicitness?: Explicitness;
+    trackExplicitness?: Explicitness;
+    discCount?: number;
+    discNumber?: number;
+    trackCount?: number;
+    trackNumber?: number;
+    trackTimeMillis?: number;
+    country?: string;
+    currency?: string;
+    primaryGenreName?: string;
+    releaseDate?: string;
+    feedUrl?: string;
+}
+interface ITunesSearchResponse {
+    resultCount: number;
+    results: ITunesSearchResult[];
+}
+
+declare class ItunesSearch {
+    private static readonly ITUNES_SEARCH_URL;
+    constructor();
+    search<T extends MediaType>(option: ITunesSearchParams<T>): Promise<ITunesSearchResponse>;
+    private buildSearchUrl;
+}
+
+declare class PodcastLoader {
+    private readonly FETCH_TIMEOUT_MS;
+    /**
+     * Fetches and parses a podcast feed from the given URL
+     * @param feedUrl - The URL of the podcast feed
+     * @returns A Promise resolving to the parsed Podcast
+     * @throws Error if the feed is invalid or the fetch fails
+     */
+    getPodcastFromFeed(feedUrl: string): Promise<Podcast>;
+    private validateUrl;
+    private extractChannel;
+    private validateChannel;
+    private mapChannel;
+    private mapCategories;
+    private mapEpisodes;
+    private mapEnclosure;
+}
+interface Category {
+    name: string;
+}
+interface Episode {
+    title: string | undefined;
+    enclosure: Enclosure | undefined;
+    guid: string;
+    linkUrl?: string;
+    pubDate?: string;
+    description?: string;
+    durationInSeconds?: string | number | undefined;
+    imageUrl?: string;
+    explicit?: boolean;
+    number?: number;
+    season?: number;
+    type?: string | undefined;
+}
+interface Enclosure {
+    length: string;
+    type: string;
+    url: string;
+}
+interface Podcast {
+    title: string;
+    description: string | undefined;
+    link: string;
+    language: string | undefined;
+    categories: Category[];
+    explicit: boolean;
+    imageUrl?: string;
+    author?: string;
+    copyright?: string;
+    fundingUrl?: string;
+    type?: string;
+    complete?: boolean;
+    episodes?: Episode[];
+}
+
+export { type Category, type Enclosure, type Entity, type Episode, type Explicitness, type ITunesSearchParams, type ITunesSearchResponse, type ITunesSearchResult, ItunesSearch, type Kind, type MediaType, type Podcast, PodcastLoader, type WrapperType };

package/dist/index.js

@@ -1,2 +1,157 @@
-export * from './itunes-search/itunes-search.js';
-export * from './podcast/podcast.js';
+import { parseFeedToJson } from '@sesamy/podcast-parser';
+
+// src/itunes-search/itunes-search.ts
+var _ItunesSearch = class _ItunesSearch {
+  constructor() {
+  }
+  async search(option) {
+    const searchUrlWithParams = this.buildSearchUrl(option);
+    try {
+      const response = await fetch(searchUrlWithParams);
+      if (!response.ok) {
+        throw new Error(
+          `Failed to fetch data from iTunes Search API: ${response.status}}`
+        );
+      }
+      return await response.json();
+    } catch (error) {
+      if (error instanceof Error) {
+        throw new Error(`Fetch failed: ${error.message}`);
+      }
+      throw error;
+    }
+  }
+  buildSearchUrl(option) {
+    const url = new URL(_ItunesSearch.ITUNES_SEARCH_URL);
+    for (const [key, value] of Object.entries(option)) {
+      if (value !== void 0) {
+        url.searchParams.append(key, String(value));
+      }
+    }
+    return url.toString();
+  }
+};
+_ItunesSearch.ITUNES_SEARCH_URL = "https://itunes.apple.com/search";
+var ItunesSearch = _ItunesSearch;
+var PodcastLoader = class {
+  constructor() {
+    this.FETCH_TIMEOUT_MS = 3e4;
+  }
+  /**
+   * Fetches and parses a podcast feed from the given URL
+   * @param feedUrl - The URL of the podcast feed
+   * @returns A Promise resolving to the parsed Podcast
+   * @throws Error if the feed is invalid or the fetch fails
+   */
+  async getPodcastFromFeed(feedUrl) {
+    this.validateUrl(feedUrl);
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.FETCH_TIMEOUT_MS);
+    try {
+      const response = await fetch(feedUrl, { signal: controller.signal });
+      if (!response.ok) {
+        throw new Error(
+          `Failed to fetch podcast feed: ${response.status} ${response.statusText}`
+        );
+      }
+      const xmlString = await response.text();
+      if (!xmlString.trim()) {
+        throw new Error("Podcast feed is empty");
+      }
+      const podcastFromXml = await parseFeedToJson(xmlString);
+      const channel = this.extractChannel(podcastFromXml);
+      this.validateChannel(channel);
+      return this.mapChannel(channel);
+    } catch (error) {
+      if (error instanceof Error && error.name === "AbortError") {
+        throw new Error(`Podcast feed request timeout after ${this.FETCH_TIMEOUT_MS}ms`);
+      }
+      if (error instanceof Error) {
+        throw new Error(`Failed to load podcast feed: ${error.message}`);
+      }
+      throw error;
+    } finally {
+      clearTimeout(timeoutId);
+    }
+  }
+  validateUrl(feedUrl) {
+    try {
+      new URL(feedUrl);
+    } catch {
+      throw new Error(`Invalid feed URL: ${feedUrl}`);
+    }
+  }
+  extractChannel(podcastFromXml) {
+    const channel = podcastFromXml?.rss?.channel;
+    if (!channel) {
+      throw new Error("Invalid podcast feed: missing channel data");
+    }
+    return channel;
+  }
+  validateChannel(channel) {
+    if (!channel.title) {
+      throw new Error('Invalid podcast feed: missing required field "title"');
+    }
+    if (!channel.link) {
+      throw new Error('Invalid podcast feed: missing required field "link"');
+    }
+  }
+  mapChannel(channel) {
+    return {
+      title: channel.title,
+      description: channel.description,
+      link: channel.link,
+      language: channel.language,
+      categories: this.mapCategories(channel["itunes:category"]),
+      explicit: channel["itunes:explicit"] === "true",
+      imageUrl: channel["itunes:image"]?.["@_href"],
+      author: channel["itunes:author"],
+      copyright: channel["copyright"],
+      fundingUrl: channel["podcast:funding"]?.["@_url"],
+      type: channel["itunes:type"],
+      episodes: this.mapEpisodes(channel.item)
+    };
+  }
+  mapCategories(categories) {
+    if (!categories) {
+      return [];
+    }
+    return categories.flatMap((category) => [
+      { name: category["@_text"] },
+      ...category["itunes:category"]?.map((sub) => ({ name: sub["@_text"] })) || []
+    ]);
+  }
+  mapEpisodes(items) {
+    if (!items) {
+      return [];
+    }
+    return items.map((item) => ({
+      title: item.title,
+      enclosure: this.mapEnclosure(item.enclosure),
+      guid: item.guid["#text"],
+      linkUrl: item.link,
+      pubDate: item.pubDate,
+      description: item.description,
+      durationInSeconds: item["itunes:duration"],
+      imageUrl: item["itunes:image"]?.["@_href"],
+      explicit: item["itunes:explicit"] === "yes",
+      number: item["itunes:episode"],
+      season: item["itunes:season"],
+      type: item["itunes:episodeType"]
+    }));
+  }
+  mapEnclosure(enclosure) {
+    if (!enclosure?.[0]) {
+      return void 0;
+    }
+    return {
+      url: enclosure[0]["@_url"],
+      type: enclosure[0]["@_type"],
+      length: enclosure[0]["@_length"]
+    };
+  }
+};
+
+export { ItunesSearch, PodcastLoader };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAC;AAChD,cAAc,0CAA0C,CAAC"}
+{"version":3,"sources":["../src/itunes-search/itunes-search.ts","../src/podcast/podcast.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { ITunesSearchParams, MediaType } from './itunes-search-options.js';\nimport type { ITunesSearchResponse } from './itunes-search-result.js';\n\nexport class ItunesSearch {\n  private static readonly ITUNES_SEARCH_URL = 'https://itunes.apple.com/search';\n\n  constructor() {}\n\n  async search<T extends MediaType>(option: ITunesSearchParams<T>): Promise<ITunesSearchResponse> {\n    const searchUrlWithParams = this.buildSearchUrl(option);\n\n    try {\n      const response = await fetch(searchUrlWithParams);\n\n      if (!response.ok) {\n        // noinspection ExceptionCaughtLocallyJS\n        throw new Error(\n          `Failed to fetch data from iTunes Search API: ${response.status}}`,\n        );\n      }\n\n      return await response.json() as ITunesSearchResponse;\n    } catch (error) {\n      if (error instanceof Error) {\n        throw new Error(`Fetch failed: ${error.message}`);\n      }\n\n      throw error;\n    }\n  }\n\n  private buildSearchUrl<T extends MediaType>(option: ITunesSearchParams<T>): string {\n    const url = new URL(ItunesSearch.ITUNES_SEARCH_URL);\n\n    for (const [key, value] of Object.entries(option)) {\n      if (value !== undefined) {\n        url.searchParams.append(key, String(value));\n      }\n    }\n\n    return url.toString();\n  }\n}\n","import { parseFeedToJson } from '@sesamy/podcast-parser';\n\ninterface RawCategory {\n  '@_text': string;\n  'itunes:category'?: RawCategory[];\n}\n\ninterface RawEnclosure {\n  '@_url': string;\n  '@_type': string;\n  '@_length': string;\n}\n\ninterface RawEpisode {\n  title?: string;\n  guid: { '#text': string };\n  link?: string;\n  pubDate?: string;\n  description?: string;\n  'itunes:duration'?: string | number;\n  'itunes:image'?: { '@_href': string };\n  'itunes:explicit'?: 'yes' | 'no';\n  'itunes:episode'?: number;\n  'itunes:season'?: number;\n  'itunes:episodeType'?: string;\n  enclosure?: RawEnclosure[];\n}\n\ninterface RawChannel {\n  title: string;\n  description?: string;\n  link: string;\n  language?: string;\n  'itunes:category'?: RawCategory[];\n  'itunes:explicit'?: 'true' | 'false';\n  'itunes:image'?: { '@_href': string };\n  'itunes:author'?: string;\n  copyright?: string;\n  'podcast:funding'?: { '@_url': string };\n  'itunes:type'?: string;\n  item?: RawEpisode[];\n}\n\ninterface RawPodcastFeed {\n  rss?: {\n    channel?: RawChannel;\n  };\n}\n\nexport class PodcastLoader {\n  private readonly FETCH_TIMEOUT_MS = 30000;\n\n  /**\n   * Fetches and parses a podcast feed from the given URL\n   * @param feedUrl - The URL of the podcast feed\n   * @returns A Promise resolving to the parsed Podcast\n   * @throws Error if the feed is invalid or the fetch fails\n   */\n  async getPodcastFromFeed(feedUrl: string): Promise<Podcast> {\n    this.validateUrl(feedUrl);\n\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this.FETCH_TIMEOUT_MS);\n\n    try {\n      const response = await fetch(feedUrl, { signal: controller.signal });\n\n      if (!response.ok) {\n        throw new Error(\n          `Failed to fetch podcast feed: ${response.status} ${response.statusText}`,\n        );\n      }\n\n      const xmlString = await response.text();\n\n      if (!xmlString.trim()) {\n        throw new Error('Podcast feed is empty');\n      }\n\n      const podcastFromXml = await parseFeedToJson(xmlString) as RawPodcastFeed;\n      const channel = this.extractChannel(podcastFromXml);\n\n      this.validateChannel(channel);\n\n      return this.mapChannel(channel);\n    } catch (error) {\n      if (error instanceof Error && error.name === 'AbortError') {\n        throw new Error(`Podcast feed request timeout after ${this.FETCH_TIMEOUT_MS}ms`);\n      }\n\n      if (error instanceof Error) {\n        throw new Error(`Failed to load podcast feed: ${error.message}`);\n      }\n\n      throw error;\n    } finally {\n      clearTimeout(timeoutId);\n    }\n  }\n\n  private validateUrl(feedUrl: string): void {\n    try {\n      new URL(feedUrl);\n    } catch {\n      throw new Error(`Invalid feed URL: ${feedUrl}`);\n    }\n  }\n\n  private extractChannel(podcastFromXml: RawPodcastFeed): RawChannel {\n    const channel = podcastFromXml?.rss?.channel;\n\n    if (!channel) {\n      throw new Error('Invalid podcast feed: missing channel data');\n    }\n\n    return channel;\n  }\n\n  private validateChannel(channel: RawChannel): void {\n    if (!channel.title) {\n      throw new Error('Invalid podcast feed: missing required field \"title\"');\n    }\n\n    if (!channel.link) {\n      throw new Error('Invalid podcast feed: missing required field \"link\"');\n    }\n  }\n\n  private mapChannel(channel: RawChannel): Podcast {\n    return {\n      title: channel.title,\n      description: channel.description,\n      link: channel.link,\n      language: channel.language,\n      categories: this.mapCategories(channel['itunes:category']),\n      explicit: channel['itunes:explicit'] === 'true',\n      imageUrl: channel['itunes:image']?.['@_href'],\n      author: channel['itunes:author'],\n      copyright: channel['copyright'],\n      fundingUrl: channel['podcast:funding']?.['@_url'],\n      type: channel['itunes:type'],\n      episodes: this.mapEpisodes(channel.item),\n    };\n  }\n\n  private mapCategories(categories: RawCategory[] | undefined): Category[] {\n    if (!categories) {return [];}\n\n    return categories.flatMap((category) => [\n      { name: category['@_text'] },\n      ...(category['itunes:category']?.map((sub) => ({ name: sub['@_text'] })) || []),\n    ]);\n  }\n\n  private mapEpisodes(items: RawEpisode[] | undefined): Episode[] {\n    if (!items) {return [];}\n\n    return items.map((item) => ({\n      title: item.title,\n      enclosure: this.mapEnclosure(item.enclosure),\n      guid: item.guid['#text'],\n      linkUrl: item.link,\n      pubDate: item.pubDate,\n      description: item.description,\n      durationInSeconds: item['itunes:duration'],\n      imageUrl: item['itunes:image']?.['@_href'],\n      explicit: item['itunes:explicit'] === 'yes',\n      number: item['itunes:episode'],\n      season: item['itunes:season'],\n      type: item['itunes:episodeType'],\n    }));\n  }\n\n  private mapEnclosure(enclosure: RawEnclosure[] | undefined): Enclosure | undefined {\n    if (!enclosure?.[0]) {return undefined;}\n\n    return {\n      url: enclosure[0]['@_url'],\n      type: enclosure[0]['@_type'],\n      length: enclosure[0]['@_length'],\n    };\n  }\n}\n\nexport interface Category {\n  name: string;\n}\n\nexport interface Episode {\n  title: string | undefined;\n  enclosure: Enclosure | undefined;\n  guid: string;\n  linkUrl?: string;\n  pubDate?: string;\n  description?: string;\n  durationInSeconds?: string | number | undefined;\n  imageUrl?: string;\n  explicit?: boolean;\n  number?: number;\n  season?: number;\n  type?: string | undefined;\n}\n\nexport interface Enclosure {\n  length: string;\n  type: string;\n  url: string;\n}\n\nexport interface Podcast {\n  title: string;\n  description: string | undefined;\n  link: string;\n  language: string | undefined;\n  categories: Category[];\n  explicit: boolean;\n  imageUrl?: string;\n  author?: string;\n  copyright?: string;\n  fundingUrl?: string;\n  type?: string;\n  complete?: boolean;\n  episodes?: Episode[];\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rapthi/podca-ts",
-  "version": "1.0.1",
+  "version": "1.0.4",
   "description": "A TypeScript library for parsing and managing podcast feeds from RSS/iTunes feeds",
   "author": "Thierry Rapillard <rapthi@gmail.com>",
   "license": "MIT",
@@ -22,7 +22,8 @@
     "xml"
   ],
   "type": "module",
-  "main": "./dist/index.js",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
@@ -38,7 +39,7 @@
     "CHANGELOG.md"
   ],
   "scripts": {
-    "build": "tsc",
+    "build": "tsup",
     "test": "vitest run",
     "test:watch": "vitest --watch",
     "test:coverage": "vitest --coverage",
@@ -61,6 +62,7 @@
     "@vitest/coverage-v8": "^4.0.16",
     "eslint": "^9.39.2",
     "prettier": "^3.7.4",
+    "tsup": "^8.5.1",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.51.0",
     "vitest": "^4.0.16"

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,0CAA0C,CAAC;AAC9D,mBAAmB,yCAAyC,CAAC;AAC7D,cAAc,kCAAkC,CAAC;AACjD,cAAc,sBAAsB,CAAC"}

package/dist/itunes-search/iTunesSearch.d.ts

@@ -1,6 +0,0 @@
-import type { ITunesSearchParams, MediaType } from './itunes-search-options.js';
-export declare class iTunesSearch {
-    constructor();
-    search<T extends MediaType>(option: ITunesSearchParams<T>): void;
-}
-//# sourceMappingURL=iTunesSearch.d.ts.map

package/dist/itunes-search/iTunesSearch.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"iTunesSearch.d.ts","sourceRoot":"","sources":["../../src/itunes-search/iTunesSearch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAEhF,qBAAa,YAAY;;IAGvB,MAAM,CAAC,CAAC,SAAS,SAAS,EAAE,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC;CAG1D"}