@postfetch/core 0.12.5 → 0.13.1

package/README.md

@@ -1,6 +1,6 @@
 # @postfetch/core
 
-Zero-dependency typed core that turns Facebook, Instagram, LinkedIn, Pinterest, Reddit, SoundCloud, TikTok, X and YouTube post URLs into media files. Part of [postfetch](https://github.com/chelokot/postfetch).
+Zero-dependency typed core that turns Facebook, Instagram, LinkedIn, Pinterest, Reddit, SoundCloud, Spotify, TikTok, X and YouTube post URLs into media files. Part of [postfetch](https://github.com/chelokot/postfetch).
 
 ```ts
 import { postfetch, download, downloadBlob, archive, toResponse, PostfetchError } from "@postfetch/core";
@@ -13,6 +13,15 @@ for (const item of result.items) {
 
 `postfetch(url, options?)` detects the platform and resolves its media into a typed `PostfetchResult` (URLs plus the headers needed to fetch them). It performs no side effects beyond the lookup — `download`, `downloadBlob`, `archive` and `toResponse` materialize the result.
 
+Spotify track URLs are matched to YouTube by artist, title and duration, preferring
+artist uploads and rejecting recognizable alternate versions unless requested.
+Results have `platform: "spotify"`, Spotify metadata and
+`metadata.extra.youtubeUrl` with the exact matched watch URL. Media items remain
+YouTube videos and use the existing video + audio download path and HLS fallback.
+`toResponse` also exposes the URL as `x-media-youtube-url`. Matching is heuristic;
+no match throws a `404` `PostfetchError`. Spotify albums, playlists and shortlinks
+are not supported.
+
 `downloadBlob(itemOrUrl, options?)` materializes resolved media for clients that
 need an uploadable `Blob`. Prefer `downloadBlob(item, { remux: true })` to
 include separate audio, assemble HLS playlists and use the item's headers.

package/dist/hls.d.ts

@@ -1,4 +1,4 @@
-import type { Net } from "./internal";
+import { type Net } from "./internal";
 export type HlsVariant = {
     width: number;
     height: number;

package/dist/index.d.ts

@@ -1,8 +1,9 @@
 /**
  * Turn a public social post URL into its media.
  *
- * {@link postfetch} resolves Instagram, LinkedIn, TikTok, YouTube, Facebook and X (Twitter)
- * URLs to typed {@link MediaItem}s. Zero dependencies, only Web-standard APIs
+ * {@link postfetch} resolves public social post and Spotify track URLs to typed
+ * {@link MediaItem}s. Spotify tracks are matched to YouTube videos.
+ * Zero dependencies, only Web-standard APIs
  * (`fetch`, `Response`, `URL`, `crypto`) — so it runs on Deno, Node, Bun,
  * Cloudflare Workers and browsers alike. It only resolves the media; the
  * {@link download}, {@link downloadBlob}, {@link archive} and {@link toResponse}
@@ -23,4 +24,4 @@ export { postfetch, detect, type PostfetchOptions } from "./postfetch";
 export { buildAudioSliderVideo, type AudioSliderVideoOptions } from "./audio-slider";
 export { download, downloadBlob, archive, toResponse, type Archive, type DownloadBlobOptions, type DownloadOptions, type RemuxedVideo, } from "./download";
 export { PostfetchError } from "./internal";
-export type { InstagramExtra, MediaItem, MediaKind, PinterestExtra, Platform, PlatformResult, PostAuthor, PostComment, PostfetchReason, PostfetchResult, PostMetadata, RedditExtra, SoundcloudExtra, TiktokExtra, TwitterExtra, TwitterQuotedTweet, YoutubeExtra, } from "./internal";
+export type { InstagramExtra, MediaItem, MediaKind, PinterestExtra, Platform, PlatformResult, PostAuthor, PostComment, PostfetchReason, PostfetchResult, PostMetadata, RedditExtra, SoundcloudExtra, SpotifyExtra, TiktokExtra, TwitterExtra, TwitterQuotedTweet, YoutubeExtra, } from "./internal";