@sockethub/platform-metadata 1.0.1-beta.3 → 1.0.1-beta.5

package/dist/resolvers.d.ts

@@ -35,6 +35,31 @@ export declare function extractYouTubeDescription(html: string): string | undefi
  * with COMPAT_USER_AGENT (see index.ts), like Reddit.
  */
 export declare function isFacebookUrl(url: string): boolean;
+/**
+ * True for Amazon storefront URLs and their short links. Amazon answers
+ * unrecognized scrapers (our own UA, and the Discordbot compat UA) with a
+ * captcha page or a generic "Amazon" share card; it serves the product's
+ * Open Graph title and image to WhatsApp's link-preview crawler.
+ */
+export declare function isAmazonUrl(url: string): boolean;
+/**
+ * Amazon's mobile-app share links (`/gp/aw/d/<ASIN>`) get a generic "Amazon"
+ * card even for WhatsApp's crawler, while `/dp/<ASIN>` on the same host gets
+ * the product. Returns the `/dp/` URL, or null for any other URL.
+ */
+export declare function resolveAmazonAppLink(url: string): string | null;
+/**
+ * Product image from an Amazon desktop product page. Amazon randomly serves
+ * the crawler that page (no product Open Graph tags, only its logo) instead
+ * of the share-card one; the main image is still in `#landingImage`.
+ */
+export declare function extractAmazonImage(html: string | undefined): string | undefined;
+/**
+ * Summary from schema.org JSON-LD for pages without a meta description: a
+ * `description`, else a `headline` that isn't just the page title (Wikipedia
+ * puts its short description there, e.g. "1979 studio album by Brian Eno").
+ */
+export declare function schemaOrgSummary(jsonLD: unknown, title?: string): string | undefined;
 /**
  * Remove the engagement-stats segment Facebook prepends to video titles:
  * "2.2M views · 21K reactions | <video title> | <author>". The stats are
@@ -105,6 +130,20 @@ export interface RedditPost {
             };
         }>;
     };
+    /** Gallery posts carry no `preview`; their images live here instead. */
+    gallery_data?: {
+        items?: Array<{
+            media_id?: string;
+        }>;
+    };
+    media_metadata?: Record<string, {
+        s?: {
+            u?: string;
+            gif?: string;
+            x?: number;
+            y?: number;
+        };
+    }>;
 }
 /** Validate and extract the post object from Reddit's listing response. */
 export declare function parseRedditPost(value: unknown): RedditPost | null;
@@ -137,6 +176,21 @@ export declare function redditPostImages(images: PageObject["image"]): PageObjec
  * excessive vertical whitespace at one blank line.
  */
 export declare function normalizeDescription(value: string): string;
+/** Media attached to an FxTwitter status (or to the status it quotes). */
+interface FxTwitterMedia {
+    photos?: Array<{
+        url?: string;
+        width?: number;
+        height?: number;
+    }>;
+    videos?: Array<{
+        url?: string;
+        thumbnail_url?: string;
+        width?: number;
+        height?: number;
+        duration?: number;
+    }>;
+}
 /** Subset of the FxTwitter status API response the platform consumes. */
 export interface FxTwitterStatus {
     code: number;
@@ -147,21 +201,19 @@ export interface FxTwitterStatus {
         author?: {
             name?: string;
             screen_name?: string;
+            avatar_url?: string;
         };
-        media?: {
-            photos?: Array<{
-                url?: string;
-                width?: number;
-                height?: number;
-            }>;
-            videos?: Array<{
+        card?: {
+            image?: {
                 url?: string;
-                thumbnail_url?: string;
                 width?: number;
                 height?: number;
-                duration?: number;
-            }>;
+            };
+        };
+        quote?: {
+            media?: FxTwitterMedia;
         };
+        media?: FxTwitterMedia;
         article?: {
             title?: string;
             preview_text?: string;
@@ -213,3 +265,4 @@ export interface PageObject {
  * reports anything but success (the caller falls back to the OG scrape).
  */
 export declare function tweetToPageObject(status: FxTwitterStatus): PageObject | null;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sockethub/platform-metadata",
-  "version": "1.0.1-beta.3",
+  "version": "1.0.1-beta.5",
   "description": "Fetch metadata from a given URL",
   "author": "Nick Jennings <nick@silverbucket.net>",
   "license": "LGPL-3.0+",
@@ -42,16 +42,16 @@
     "clean:deps": "rm -rf node_modules"
   },
   "dependencies": {
-    "@sockethub/util": "^1.0.0-beta.3",
+    "@sockethub/util": "^1.0.0-beta.5",
     "open-graph-scraper": "^6.11.0",
     "undici": "^7.30.0"
   },
   "devDependencies": {
-    "@sockethub/schemas": "^3.0.0-beta.3"
+    "@sockethub/schemas": "^3.0.0-beta.5"
   },
   "peerDependencies": {
-    "@sockethub/server": "^5.0.0-beta.3"
+    "@sockethub/server": "^5.0.0-beta.5"
   },
-  "gitHead": "603d4edd90e1f0f0b70c4ab759be5f70b24020ea",
+  "gitHead": "2dffe4cc1bea5375e38531b1012b56bcbab93569",
   "types": "./dist/index.d.ts"
 }