@postfetch/core 0.4.1 → 0.5.0

package/dist/index.js

@@ -266,12 +266,16 @@ async function instagramUnavailable(net, code) {
   const response = await net(url.href, { headers: mobileHeaders() }, 1).catch(() => null);
   const body = response ? await response.text().catch(() => "") : "";
   const reason = instagramUnavailableReason(response?.status ?? 0, body);
-  return new PostfetchError(reasonStatus(reason), `Instagram post unavailable: ${reason}`, reason);
+  const probe = response ? `oembed ${response.status}` : "oembed unreachable";
+  return new PostfetchError(reasonStatus(reason), `Instagram post unavailable: ${reason} (${probe})`, reason);
 }
 function instagramUnavailableReason(status, body) {
   if (status === 404) {
     return "notFound";
   }
+  if (status === 429) {
+    return "rateLimited";
+  }
   if (status !== 0 && status < 400) {
     return "unavailable";
   }
@@ -1008,9 +1012,6 @@ async function resolveReddit(input) {
   const token = await appToken(input.net);
   const post = await fetchPost(input.net, token, id);
   const items = await mediaItems3(input, post, id);
-  if (items.length === 0) {
-    throw new Error("Reddit media not found");
-  }
   return { archiveFilename: filename(`reddit_${id}.zip`), id, items, metadata: redditMetadata(post), platform: "reddit" };
 }
 function redditMetadata(post) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@postfetch/core",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "Zero-dependency typed core that turns Facebook, Instagram, Pinterest, Reddit, SoundCloud, TikTok, X and YouTube post URLs into media files.",
   "license": "MIT",
   "type": "module",

package/src/instagram.ts

@@ -79,16 +79,23 @@ async function instagramUnavailable(net: Net, code: string): Promise<PostfetchEr
   const response = await net(url.href, { headers: mobileHeaders() }, 1).catch(() => null);
   const body = response ? await response.text().catch(() => "") : "";
   const reason = instagramUnavailableReason(response?.status ?? 0, body);
-  return new PostfetchError(reasonStatus(reason), `Instagram post unavailable: ${reason}`, reason);
+  // Carry the oembed status so an unclassified failure still leaves a raw clue
+  // (200 = post is public but no media could be parsed; 429 = throttled; …).
+  const probe = response ? `oembed ${response.status}` : "oembed unreachable";
+  return new PostfetchError(reasonStatus(reason), `Instagram post unavailable: ${reason} (${probe})`, reason);
 }
 
 // Classifies why the post is gone from the oembed endpoint, which returns a
-// telling status and body (404 when removed; 400 with a MIN_AGE_ACCOUNT block
-// for 18+ accounts) while the media endpoints just come back empty.
+// telling status and body (404 when removed; 429 when throttled; 400 with a
+// MIN_AGE_ACCOUNT block for 18+ accounts) while the media endpoints just come
+// back empty.
 export function instagramUnavailableReason(status: number, body: string): PostfetchReason {
   if (status === 404) {
     return "notFound";
   }
+  if (status === 429) {
+    return "rateLimited";
+  }
   if (status !== 0 && status < 400) {
     return "unavailable";
   }

package/src/reddit.ts

@@ -27,10 +27,10 @@ export async function resolveReddit(input: ResolveContext): Promise<PostfetchRes
   const id = await postId(input.net, input.url);
   const token = await appToken(input.net);
   const post = await fetchPost(input.net, token, id);
+  // A text post is a valid result with metadata and no media — fetchPost has
+  // already thrown if the post itself is missing, so empty items here mean a
+  // self/text post, not a failure.
   const items = await mediaItems(input, post, id);
-  if (items.length === 0) {
-    throw new Error("Reddit media not found");
-  }
   return { archiveFilename: filename(`reddit_${id}.zip`), id, items, metadata: redditMetadata(post), platform: "reddit" };
 }