@postfetch/core 0.13.1 → 0.13.3

package/README.md

@@ -13,6 +13,8 @@ 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.
 
+LinkedIn public posts also accept `lnkd.in` shortlinks, including `https://lnkd.in/p/…`.
+
 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

package/dist/index.js

@@ -796,21 +796,10 @@ function randomToken(length = 8) {
 
 // src/linkedin.ts
 async function resolveLinkedin(input) {
-  const reference = postReference(input.url);
+  const reference = await postReference(input);
   const pageUrl = `https://www.linkedin.com/feed/update/urn:li:${reference.kind}:${reference.id}`;
   const response = await input.net(pageUrl, { headers: navigationHeaders() });
-  if (response.status === 404) {
-    throw new PostfetchError(404, "LinkedIn post not found", "notFound");
-  }
-  if (response.status === 429 || response.status === 999) {
-    throw new PostfetchError(429, "LinkedIn rate limit reached", "rateLimited");
-  }
-  if (!response.ok) {
-    throw new PostfetchError(response.status, "LinkedIn post unavailable", "unavailable");
-  }
-  if (response.url.includes("/signup/") || response.url.includes("/login")) {
-    throw new PostfetchError(401, "LinkedIn login required", "loginRequired");
-  }
+  checkResponse(response);
   const html = await response.text();
   const post = linkedinPost(html);
   if (!post) {
@@ -846,8 +835,31 @@ function linkedinMetadata(post) {
     commentCount: count(post.commentCount) ?? interactionCount(post.interactionStatistic, "CommentAction")
   };
 }
-function postReference(input) {
-  const reference = postReferenceOrNull(input);
+function checkResponse(response) {
+  if (response.status === 404) {
+    throw new PostfetchError(404, "LinkedIn post not found", "notFound");
+  }
+  if (response.status === 429 || response.status === 999) {
+    throw new PostfetchError(429, "LinkedIn rate limit reached", "rateLimited");
+  }
+  if (!response.ok) {
+    throw new PostfetchError(response.status, "LinkedIn post unavailable", "unavailable");
+  }
+  if (response.url.includes("/signup/") || response.url.includes("/login")) {
+    throw new PostfetchError(401, "LinkedIn login required", "loginRequired");
+  }
+}
+async function postReference(input) {
+  let url = input.url;
+  if (new URL(url).hostname === "lnkd.in") {
+    const response = await input.net(url, { headers: navigationHeaders(), redirect: "manual" });
+    await response.body?.cancel();
+    if (![301, 302, 303, 307, 308].includes(response.status)) {
+      checkResponse(response);
+    }
+    url = response.headers.get("location") ?? "";
+  }
+  const reference = postReferenceOrNull(url);
   if (!reference) {
     throw new PostfetchError(400, "LinkedIn post id not found");
   }
@@ -856,7 +868,11 @@ function postReference(input) {
 function postReferenceOrNull(input) {
   let pathname;
   try {
-    pathname = new URL(input).pathname.replace(/%3A/gi, ":");
+    const url = new URL(input);
+    if (url.hostname !== "linkedin.com" && !url.hostname.endsWith(".linkedin.com")) {
+      return null;
+    }
+    pathname = url.pathname.replace(/%3A/gi, ":");
   } catch {
     return null;
   }
@@ -1626,14 +1642,17 @@ async function appToken(net) {
   return token;
 }
 async function fetchPost(net, token, id) {
-  const response = await net(`https://oauth.reddit.com/comments/${id}?raw_json=1&limit=1`, {
-    headers: { authorization: `Bearer ${token}`, "user-agent": browserUserAgent() }
-  });
+  const headers = { authorization: `Bearer ${token}`, "user-agent": browserUserAgent() };
+  let response = await net(`https://oauth.reddit.com/comments/${id}?raw_json=1&limit=1`, { headers });
+  if (response.status === 403) {
+    await response.body?.cancel();
+    response = await net(`https://oauth.reddit.com/by_id/t3_${id}?raw_json=1`, { headers });
+  }
   if (!response.ok) {
     throw new Error(`Reddit post failed: ${response.status}`);
   }
   const payload = await response.json().catch(() => null);
-  const listing = Array.isArray(payload) ? payload[0] : null;
+  const listing = Array.isArray(payload) ? payload[0] : payload;
   const children = object(listing) && object(listing.data) && Array.isArray(listing.data.children) ? listing.data.children : [];
   const first = children[0];
   const post = object(first) && object(first.data) ? first.data : null;
@@ -3348,7 +3367,7 @@ function detect(url) {
   if (host.includes("instagram.com")) {
     return "instagram";
   }
-  if (host === "linkedin.com" || host.endsWith(".linkedin.com")) {
+  if (host === "linkedin.com" || host.endsWith(".linkedin.com") || host === "lnkd.in") {
     return "linkedin";
   }
   if (host.includes("pinterest.") || host === "pin.it") {

package/package.json

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

package/src/linkedin.ts

@@ -21,21 +21,10 @@ type LinkedinPostReference = {
 };
 
 export async function resolveLinkedin(input: ResolveContext): Promise<PostfetchResult> {
-  const reference = postReference(input.url);
+  const reference = await postReference(input);
   const pageUrl = `https://www.linkedin.com/feed/update/urn:li:${reference.kind}:${reference.id}`;
   const response = await input.net(pageUrl, { headers: navigationHeaders() });
-  if (response.status === 404) {
-    throw new PostfetchError(404, "LinkedIn post not found", "notFound");
-  }
-  if (response.status === 429 || response.status === 999) {
-    throw new PostfetchError(429, "LinkedIn rate limit reached", "rateLimited");
-  }
-  if (!response.ok) {
-    throw new PostfetchError(response.status, "LinkedIn post unavailable", "unavailable");
-  }
-  if (response.url.includes("/signup/") || response.url.includes("/login")) {
-    throw new PostfetchError(401, "LinkedIn login required", "loginRequired");
-  }
+  checkResponse(response);
 
   const html = await response.text();
   const post = linkedinPost(html);
@@ -76,8 +65,33 @@ export function linkedinMetadata(post: Json): PostMetadata {
   };
 }
 
-function postReference(input: string): LinkedinPostReference {
-  const reference = postReferenceOrNull(input);
+function checkResponse(response: Response): void {
+  if (response.status === 404) {
+    throw new PostfetchError(404, "LinkedIn post not found", "notFound");
+  }
+  if (response.status === 429 || response.status === 999) {
+    throw new PostfetchError(429, "LinkedIn rate limit reached", "rateLimited");
+  }
+  if (!response.ok) {
+    throw new PostfetchError(response.status, "LinkedIn post unavailable", "unavailable");
+  }
+  if (response.url.includes("/signup/") || response.url.includes("/login")) {
+    throw new PostfetchError(401, "LinkedIn login required", "loginRequired");
+  }
+}
+
+async function postReference(input: ResolveContext): Promise<LinkedinPostReference> {
+  let url = input.url;
+  if (new URL(url).hostname === "lnkd.in") {
+    // Read the destination without fetching the post twice or following outbound links.
+    const response = await input.net(url, { headers: navigationHeaders(), redirect: "manual" });
+    await response.body?.cancel();
+    if (![301, 302, 303, 307, 308].includes(response.status)) {
+      checkResponse(response);
+    }
+    url = response.headers.get("location") ?? "";
+  }
+  const reference = postReferenceOrNull(url);
   if (!reference) {
     throw new PostfetchError(400, "LinkedIn post id not found");
   }
@@ -87,7 +101,11 @@ function postReference(input: string): LinkedinPostReference {
 function postReferenceOrNull(input: string): LinkedinPostReference | null {
   let pathname: string;
   try {
-    pathname = new URL(input).pathname.replace(/%3A/gi, ":");
+    const url = new URL(input);
+    if (url.hostname !== "linkedin.com" && !url.hostname.endsWith(".linkedin.com")) {
+      return null;
+    }
+    pathname = url.pathname.replace(/%3A/gi, ":");
   } catch {
     return null;
   }

package/src/postfetch.ts

@@ -171,7 +171,7 @@ export function detect(url: string): Platform {
   if (host.includes("instagram.com")) {
     return "instagram";
   }
-  if (host === "linkedin.com" || host.endsWith(".linkedin.com")) {
+  if (host === "linkedin.com" || host.endsWith(".linkedin.com") || host === "lnkd.in") {
     return "linkedin";
   }
   if (host.includes("pinterest.") || host === "pin.it") {

package/src/reddit.ts

@@ -100,14 +100,19 @@ async function appToken(net: Net): Promise<string> {
 }
 
 async function fetchPost(net: Net, token: string, id: string): Promise<Json> {
-  const response = await net(`https://oauth.reddit.com/comments/${id}?raw_json=1&limit=1`, {
-    headers: { authorization: `Bearer ${token}`, "user-agent": browserUserAgent() },
-  });
+  const headers = { authorization: `Bearer ${token}`, "user-agent": browserUserAgent() };
+  let response = await net(`https://oauth.reddit.com/comments/${id}?raw_json=1&limit=1`, { headers });
+  // Reddit can block the comments route while still allowing direct post
+  // listings with the same token. This route returns the post, not its replies.
+  if (response.status === 403) {
+    await response.body?.cancel();
+    response = await net(`https://oauth.reddit.com/by_id/t3_${id}?raw_json=1`, { headers });
+  }
   if (!response.ok) {
     throw new Error(`Reddit post failed: ${response.status}`);
   }
   const payload = await response.json().catch(() => null);
-  const listing = Array.isArray(payload) ? payload[0] : null;
+  const listing = Array.isArray(payload) ? payload[0] : payload;
   const children = object(listing) && object(listing.data) && Array.isArray(listing.data.children) ? listing.data.children : [];
   const first = children[0];
   const post = object(first) && object(first.data) ? first.data : null;