@sockethub/platform-metadata 1.0.1-alpha.14 → 1.0.1-alpha.16

package/README.md

@@ -96,11 +96,11 @@ so those URLs are resolved through preview services built for this purpose:
   thumbnail), and the canonical `x.com` URL. If the API is unavailable or the
   post can't be resolved, the platform falls back to the regular scrape
   (which still yields the post text).
-* **Reddit URLs** (`reddit.com` hosts and `redd.it` short links) are scraped
-  directly, but with a *compatibility user agent* — Reddit serves its Open
-  Graph data (including the post's real preview image) only to recognized
-  embed crawlers, and returns a page with no OG tags (or a 403) to anything
-  else. See `compatUserAgent` below.
+* **Reddit post URLs** use `old.reddit.com`'s structured JSON response, avoiding
+  Reddit's unreliable HTML and Open Graph crawler behavior. The post title,
+  self-text, and direct `i.redd.it` image are mapped into the preview; text posts
+  intentionally have no image. oEmbed remains a title-only failure fallback.
+  See `compatUserAgent` below.
 * **Facebook** remains best-effort: post text usually comes through, but
   media requires authentication and no public preview service exists.
 
@@ -124,7 +124,7 @@ default UA. Override per deployment via `packageConfig`:
 
 ### `compatUserAgent`
 
-Sites that only serve Open Graph data to *recognized* embed crawlers (Reddit)
+Sites that only serve metadata to *recognized* embed crawlers (Reddit)
 are fetched with a link-preview crawler user agent instead — the established
 practice for self-hosted preview fetchers. Defaults to
 `Mozilla/5.0 (compatible; Discordbot/2.0; +https://discordapp.com)`;

package/dist/index.d.ts

@@ -1,6 +1,9 @@
 import type { ActivityStream, PlatformCallback, PlatformConfig, PlatformInterface, PlatformSession } from "@sockethub/schemas";
+/** Enforce a deadline independently of a dependency's AbortSignal handling. */
+export declare function withDeadline<T>(promise: Promise<T>, timeoutMs: number): Promise<T>;
 export default class Metadata implements PlatformInterface {
     private readonly log;
+    private readonly fetchImpl;
     private dispatcher?;
     config: PlatformConfig;
     constructor(session: PlatformSession);
@@ -158,6 +161,15 @@ export default class Metadata implements PlatformInterface {
     private compatUserAgent;
     fetch(job: ActivityStream, cb: PlatformCallback): void;
     private fetchTweet;
+    private fetchReddit;
+    /**
+     * Fetch Reddit's fixed-host JSON endpoint without the Undici dispatcher.
+     * The platform child runtime has exhibited stuck Undici requests even when
+     * AbortSignal fires. node:https gives us an independently enforced socket
+     * timeout; the outer withDeadline still guarantees callback completion.
+     */
+    private fetchRedditJson;
+    private fetchRedditEmbed;
     private scrape;
     cleanup(cb: PlatformCallback): void;
 }