@sockethub/platform-metadata 1.0.1-beta.0 → 1.0.1-beta.2

package/dist/resolvers.d.ts

@@ -1,21 +1,4 @@
-/**
- * Site-specific URL resolution for pages that don't serve useful Open Graph
- * data to scrapers.
- *
- * Some large platforms return a generic banner image (X/Twitter), serve
- * their Open Graph data only to recognized embed crawlers (Reddit), or
- * hide post media behind a login (Facebook):
- *
- * - X/Twitter → FxTwitter's JSON API (api.fxtwitter.com), built for embed
- *   previews, returns the tweet text plus direct photo/video URLs.
- * - Reddit → the regular scrape works, but only when presented with an
- *   embed-crawler user agent (see COMPAT_USER_AGENT in index.ts).
- * - Facebook → same crawler-UA gating as Reddit, plus its video titles
- *   arrive polluted with localized engagement stats that need stripping.
- *
- * These are pure URL matchers/mappers — the platform decides what to do
- * with the resolution (call a JSON API vs. pick a scrape user agent).
- */
+import type { PageEvent } from "./event";
 /**
  * Match an X/Twitter status URL and return the FxTwitter API URL for it,
  * or null when the URL isn't a status page (profiles, search, home feed —
@@ -56,10 +39,32 @@ export declare function isFacebookUrl(url: string): boolean;
  * Remove the engagement-stats segment Facebook prepends to video titles:
  * "2.2M views · 21K reactions | <video title> | <author>". The stats are
  * localized to the *scraping server's* geo-IP language, so match their
- * shape — a leading pipe-delimited segment containing a digit and the "·"
- * separator — rather than any particular wording.
+ * shape rather than any particular wording: a leading pipe-delimited
+ * segment that either contains a digit and the "·" separator, or — when
+ * Facebook reports a single count, e.g. "330.213 Aufrufe | Reel by X",
+ * "347K views | …" or "2,2 mil. zhlédnutí | …" — is a count-shaped number
+ * (grouping or decimal separator, magnitude suffix, or at least four
+ * digits), an optional abbreviation, and one word. The view label itself
+ * cannot be matched: it is whatever Facebook's geo-IP locale produces. The
+ * count shape keeps a caption that merely starts with a small number
+ * ("10 Goals | Author") intact; only counts below 1,000 with no suffix
+ * would leak into the title.
  */
 export declare function stripFacebookEngagement(title: string | undefined): string | undefined;
+/**
+ * Facebook's public embed plugin for a post. Unlike the post page, it is
+ * meant to be rendered by third-party sites, so it still carries the
+ * media thumbnail when the post page withholds its Open Graph image from
+ * an unrecognized or datacenter client. Video posts (reels, watch) use
+ * the video plugin; everything else the post plugin.
+ */
+export declare function resolveFacebookEmbed(url: string, ogType: string | undefined): string | null;
+/**
+ * The media thumbnail from a Facebook embed-plugin page: the first `<img>`
+ * served from Facebook's CDN. The plugin renders the post media before
+ * the author avatar, so the first CDN image is the thumbnail.
+ */
+export declare function extractFacebookEmbedImage(html: string): string | undefined;
 /**
  * True for Reddit URLs (including redd.it short links). Reddit serves its
  * Open Graph tags — with the post's real preview image — only to
@@ -199,6 +204,7 @@ export interface PageObject {
     url?: string;
     favicon?: string;
     charset?: string;
+    event?: PageEvent;
 }
 /**
  * Map an FxTwitter API response onto the platform's page object. The

package/dist/schema.d.ts

@@ -107,6 +107,31 @@ export declare const PlatformMetadataSchema: {
                         charset: {
                             type: string;
                         };
+                        event: {
+                            type: string;
+                            required: string[];
+                            additionalProperties: boolean;
+                            properties: {
+                                name: {
+                                    type: string;
+                                };
+                                startDate: {
+                                    type: string;
+                                };
+                                endDate: {
+                                    type: string;
+                                };
+                                location: {
+                                    type: string;
+                                };
+                                url: {
+                                    type: string;
+                                };
+                                status: {
+                                    enum: string[];
+                                };
+                            };
+                        };
                     };
                 };
                 ogImage: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sockethub/platform-metadata",
-  "version": "1.0.1-beta.0",
+  "version": "1.0.1-beta.2",
   "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.0",
+    "@sockethub/util": "^1.0.0-beta.2",
     "open-graph-scraper": "^6.11.0",
     "undici": "^7.30.0"
   },
   "devDependencies": {
-    "@sockethub/schemas": "^3.0.0-beta.0"
+    "@sockethub/schemas": "^3.0.0-beta.2"
   },
   "peerDependencies": {
-    "@sockethub/server": "^5.0.0-beta.0"
+    "@sockethub/server": "^5.0.0-beta.2"
   },
-  "gitHead": "a17e337ee7d2dd496d225c0d6e8ae48f4f4ce73c",
+  "gitHead": "d241420f9743f66a15ed083a1390595b331a96ac",
   "types": "./dist/index.d.ts"
 }