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

package/dist/resolvers.d.ts

@@ -30,6 +30,45 @@ export declare function resolveTwitterStatus(url: string): string | null;
  * no OG data (or an outright 403 from datacenter addresses).
  */
 export declare function isRedditUrl(url: string): boolean;
+/** Map a canonical Reddit post URL to Reddit's official media-enabled embed. */
+export declare function resolveRedditEmbed(url: string): string | null;
+/** Map a canonical Reddit post URL to old.reddit.com's public JSON endpoint. */
+export declare function resolveRedditJson(url: string): string | null;
+export interface RedditPost {
+    title: string;
+    selftext?: string;
+    url?: string;
+    url_overridden_by_dest?: string;
+}
+/** Validate and extract the post object from Reddit's listing response. */
+export declare function parseRedditPost(value: unknown): RedditPost | null;
+/** Select only a direct Reddit-hosted image belonging to the post. */
+export declare function redditPostImage(post: RedditPost): PageObject["image"];
+/** Subset of Reddit's oEmbed response used for link previews. */
+export interface RedditOEmbed {
+    title?: string;
+    author_name?: string;
+    provider_name?: string;
+    thumbnail_url?: string;
+    thumbnail_width?: number;
+    thumbnail_height?: number;
+}
+/** Validate the subset of Reddit's untrusted oEmbed JSON that we consume. */
+export declare function parseRedditOEmbed(value: unknown): RedditOEmbed | null;
+/**
+ * Convert Reddit's optional oEmbed thumbnail into the platform image shape.
+ * A missing or malformed thumbnail deliberately means "no image": Reddit's
+ * scraped Open Graph image may be a generic site hero rather than post media.
+ */
+export declare function redditOEmbedImage(embed: RedditOEmbed): PageObject["image"] | undefined;
+/** Keep only Reddit-hosted post media, excluding branding/share-card images. */
+export declare function redditPostImages(images: PageObject["image"]): PageObject["image"] | undefined;
+/**
+ * Make scraped plain text readable without flattening intentional structure.
+ * Preserve line breaks and paragraphs, but remove HTML indentation and cap
+ * excessive vertical whitespace at one blank line.
+ */
+export declare function normalizeDescription(value: string): string;
 /** Subset of the FxTwitter status API response the platform consumes. */
 export interface FxTwitterStatus {
     code: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sockethub/platform-metadata",
-  "version": "1.0.1-alpha.14",
+  "version": "1.0.1-alpha.16",
   "description": "Fetch metadata from a given URL",
   "author": "Nick Jennings <nick@silverbucket.net>",
   "license": "LGPL-3.0+",
@@ -42,15 +42,16 @@
     "clean:deps": "rm -rf node_modules"
   },
   "dependencies": {
-    "@sockethub/util": "^1.0.0-alpha.7",
-    "open-graph-scraper": "^6.11.0"
+    "@sockethub/util": "^1.0.0-alpha.9",
+    "open-graph-scraper": "^6.11.0",
+    "undici": "^7.16.0"
   },
   "devDependencies": {
-    "@sockethub/schemas": "^3.0.0-alpha.19"
+    "@sockethub/schemas": "^3.0.0-alpha.21"
   },
   "peerDependencies": {
-    "@sockethub/server": "^5.0.0-alpha.19"
+    "@sockethub/server": "^5.0.0-alpha.21"
   },
-  "gitHead": "8e315bd27fbf9324079f2a5a4a09f3c6057c6500",
+  "gitHead": "1d87ef9d415159ef624e86e929ef2a2fb7a4b50e",
   "types": "./dist/index.d.ts"
 }