@atproto/bsky 0.0.232 → 0.0.233

package/dist/stash.d.ts

@@ -2,13 +2,13 @@ import { LexMap, TypedObjectSchema } from '@atproto/lex';
 import { BsyncClient } from './bsync.js';
 import { app } from './lexicons/index.js';
 export declare const Namespaces: {
-    readonly AppBskyAgeassuranceDefsEvent: TypedObjectSchema<"app.bsky.ageassurance.defs#event", import("@atproto/lex").Validator<app.bsky.ageassurance.defs.$defs.Event, app.bsky.ageassurance.defs.$defs.Event>>;
-    readonly AppBskyBookmarkDefsBookmark: TypedObjectSchema<"app.bsky.bookmark.defs#bookmark", import("@atproto/lex").Validator<app.bsky.bookmark.defs.$defs.Bookmark, app.bsky.bookmark.defs.$defs.Bookmark>>;
-    readonly AppBskyContactDefsNotification: TypedObjectSchema<"app.bsky.contact.defs#notification", import("@atproto/lex").Validator<app.bsky.contact.defs.$defs.Notification, app.bsky.contact.defs.$defs.Notification>>;
-    readonly AppBskyDraftDefsDraftWithId: TypedObjectSchema<"app.bsky.draft.defs#draftWithId", import("@atproto/lex").Validator<app.bsky.draft.defs.$defs.DraftWithId, app.bsky.draft.defs.$defs.DraftWithId>>;
-    readonly AppBskyNotificationDefsPreferences: TypedObjectSchema<"app.bsky.notification.defs#preferences", import("@atproto/lex").Validator<app.bsky.notification.defs.$defs.Preferences, app.bsky.notification.defs.$defs.Preferences>>;
-    readonly AppBskyNotificationDefsSubjectActivitySubscription: TypedObjectSchema<"app.bsky.notification.defs#subjectActivitySubscription", import("@atproto/lex").Validator<app.bsky.notification.defs.$defs.SubjectActivitySubscription, app.bsky.notification.defs.$defs.SubjectActivitySubscription>>;
-    readonly AppBskyUnspeccedDefsAgeAssuranceEvent: TypedObjectSchema<"app.bsky.unspecced.defs#ageAssuranceEvent", import("@atproto/lex").Validator<app.bsky.unspecced.defs.$defs.AgeAssuranceEvent, app.bsky.unspecced.defs.$defs.AgeAssuranceEvent>>;
+    readonly AppBskyAgeassuranceDefsEvent: TypedObjectSchema<"app.bsky.ageassurance.defs#event", import("@atproto/lex").Validator<app.bsky.ageassurance.defs.Event, app.bsky.ageassurance.defs.Event>>;
+    readonly AppBskyBookmarkDefsBookmark: TypedObjectSchema<"app.bsky.bookmark.defs#bookmark", import("@atproto/lex").Validator<app.bsky.bookmark.defs.Bookmark, app.bsky.bookmark.defs.Bookmark>>;
+    readonly AppBskyContactDefsNotification: TypedObjectSchema<"app.bsky.contact.defs#notification", import("@atproto/lex").Validator<app.bsky.contact.defs.Notification, app.bsky.contact.defs.Notification>>;
+    readonly AppBskyDraftDefsDraftWithId: TypedObjectSchema<"app.bsky.draft.defs#draftWithId", import("@atproto/lex").Validator<app.bsky.draft.defs.DraftWithId, app.bsky.draft.defs.DraftWithId>>;
+    readonly AppBskyNotificationDefsPreferences: TypedObjectSchema<"app.bsky.notification.defs#preferences", import("@atproto/lex").Validator<app.bsky.notification.defs.Preferences, app.bsky.notification.defs.Preferences>>;
+    readonly AppBskyNotificationDefsSubjectActivitySubscription: TypedObjectSchema<"app.bsky.notification.defs#subjectActivitySubscription", import("@atproto/lex").Validator<app.bsky.notification.defs.SubjectActivitySubscription, app.bsky.notification.defs.SubjectActivitySubscription>>;
+    readonly AppBskyUnspeccedDefsAgeAssuranceEvent: TypedObjectSchema<"app.bsky.unspecced.defs#ageAssuranceEvent", import("@atproto/lex").Validator<app.bsky.unspecced.defs.AgeAssuranceEvent, app.bsky.unspecced.defs.AgeAssuranceEvent>>;
 };
 export declare const createStashClient: (bsyncClient: BsyncClient) => StashClient;
 export declare class StashClient {

package/dist/util/standard-site.d.ts

@@ -0,0 +1,66 @@
+import { AtUriString } from '@atproto/syntax';
+export declare const SITE_STANDARD_NSID_PREFIX = "site.standard.";
+/**
+ * Composes a stable map key from an `(uri, cid)` pair. A single hydration
+ * batch can pull more than one version of the same SS record URI (different
+ * posts pinning different cids), so the composite is needed for O(1)
+ * version-exact lookups.
+ */
+export declare const siteStandardRecordKey: (uri: string, cid: string) => string;
+export declare const parseSiteStandardRecordKey: (key: string) => {
+    uri: AtUriString;
+    cid: string;
+};
+/**
+ * Confirm that the supplied SS records actually back `assumedUrl`. URL
+ * comparison parses both sides via the WHATWG URL constructor (resolving
+ * the document's `path` against the publication or site as a base) and
+ * compares the canonical `protocol://host/path` forms — host case is
+ * ignored, query/fragment are dropped, trailing slashes stripped.
+ *
+ * Structural validation of the doc/pub pair (matching `site` ↔ pub URI,
+ * no orphan docs that claim a missing publication) happens upstream in
+ * `getSiteStandardRecordsFromHydrationMapsByRefs` /
+ * `…ByDocumentUri` (see `hydration/external.ts`); by the time this
+ * function runs the pair is already known to be structurally consistent,
+ * so we only check whether the records back the URL.
+ *
+ * Cases:
+ * - Document + publication: `publication.url + document.path` must
+ *   canonicalize to `assumedUrl`.
+ * - Loose document (web-URL `site`): `document.site + document.path`
+ *   must canonicalize to `assumedUrl`. (Doc with at-uri `site` but no
+ *   publication can't reach this function — the lookups reject it.)
+ * - Publication only: `publication.url` must canonicalize to
+ *   `assumedUrl`.
+ * - Neither: vacuously valid; the caller short-circuits before we get
+ *   here.
+ */
+export declare const validateStandardSiteForUrl: (document: {
+    ref: {
+        uri: string;
+    };
+    info: {
+        record: {
+            site: string;
+            path?: string;
+        };
+    };
+} | undefined, publication: {
+    ref: {
+        uri: string;
+    };
+    info: {
+        record: {
+            url: string;
+        };
+    };
+} | undefined, assumedUrl: string) => boolean;
+/**
+ * Estimate reading time in minutes from a plaintext document body. Returns
+ * `undefined` when the input has no countable words. Uses a coarse
+ * `WORDS_PER_MINUTE` heuristic; swap in a more accurate library here if
+ * needed (e.g. `reading-time`).
+ */
+export declare const estimateReadingTimeMinutes: (text: string) => number | undefined;
+//# sourceMappingURL=standard-site.d.ts.map

package/dist/util/standard-site.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-site.d.ts","sourceRoot":"","sources":["../../src/util/standard-site.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAE7C,eAAO,MAAM,yBAAyB,mBAAmB,CAAA;AAEzD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,KAAK,MAAM,EAAE,KAAK,MAAM,WAC7C,CAAA;AAEjB,eAAO,MAAM,0BAA0B,GACrC,KAAK,MAAM,KACV;IAAE,GAAG,EAAE,WAAW,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAMjC,CAAA;AAoBD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,0BAA0B,GACrC,UACI;IACE,GAAG,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;IACpB,IAAI,EAAE;QAAE,MAAM,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAA;CAClD,GACD,SAAS,EACb,aACI;IAAE,GAAG,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,IAAI,EAAE;QAAE,MAAM,EAAE;YAAE,GAAG,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAA;CAAE,GAC3D,SAAS,EACb,YAAY,MAAM,KACjB,OAsBF,CAAA;AAID;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,GACrC,MAAM,MAAM,KACX,MAAM,GAAG,SAIX,CAAA"}

package/dist/util/standard-site.js

@@ -0,0 +1,90 @@
+export const SITE_STANDARD_NSID_PREFIX = 'site.standard.';
+/**
+ * Composes a stable map key from an `(uri, cid)` pair. A single hydration
+ * batch can pull more than one version of the same SS record URI (different
+ * posts pinning different cids), so the composite is needed for O(1)
+ * version-exact lookups.
+ */
+export const siteStandardRecordKey = (uri, cid) => `${uri}@${cid}`;
+export const parseSiteStandardRecordKey = (key) => {
+    const at = key.lastIndexOf('@');
+    return {
+        uri: key.slice(0, at),
+        cid: key.slice(at + 1),
+    };
+};
+/**
+ * Parse `url` as HTTP(S) and reduce it to a canonical
+ * `protocol://host/path` string for equality comparison: lowercases host,
+ * strips a trailing slash from the path, and drops query/fragment. Returns
+ * `null` when the input isn't a valid HTTP(S) URL.
+ */
+const canonicalizeHttpUrl = (url, base) => {
+    let parsed;
+    try {
+        parsed = new URL(url, base);
+    }
+    catch {
+        return null;
+    }
+    if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:')
+        return null;
+    const path = parsed.pathname === '/' ? '' : parsed.pathname.replace(/\/$/, '');
+    return `${parsed.protocol}//${parsed.host}${path}`;
+};
+/**
+ * Confirm that the supplied SS records actually back `assumedUrl`. URL
+ * comparison parses both sides via the WHATWG URL constructor (resolving
+ * the document's `path` against the publication or site as a base) and
+ * compares the canonical `protocol://host/path` forms — host case is
+ * ignored, query/fragment are dropped, trailing slashes stripped.
+ *
+ * Structural validation of the doc/pub pair (matching `site` ↔ pub URI,
+ * no orphan docs that claim a missing publication) happens upstream in
+ * `getSiteStandardRecordsFromHydrationMapsByRefs` /
+ * `…ByDocumentUri` (see `hydration/external.ts`); by the time this
+ * function runs the pair is already known to be structurally consistent,
+ * so we only check whether the records back the URL.
+ *
+ * Cases:
+ * - Document + publication: `publication.url + document.path` must
+ *   canonicalize to `assumedUrl`.
+ * - Loose document (web-URL `site`): `document.site + document.path`
+ *   must canonicalize to `assumedUrl`. (Doc with at-uri `site` but no
+ *   publication can't reach this function — the lookups reject it.)
+ * - Publication only: `publication.url` must canonicalize to
+ *   `assumedUrl`.
+ * - Neither: vacuously valid; the caller short-circuits before we get
+ *   here.
+ */
+export const validateStandardSiteForUrl = (document, publication, assumedUrl) => {
+    const canonicalAssumed = canonicalizeHttpUrl(assumedUrl);
+    if (canonicalAssumed === null)
+        return false;
+    if (document && publication) {
+        const joined = canonicalizeHttpUrl(document.info.record.path ?? '', publication.info.record.url);
+        return joined === canonicalAssumed;
+    }
+    if (document) {
+        const joined = canonicalizeHttpUrl(document.info.record.path ?? '', document.info.record.site);
+        return joined === canonicalAssumed;
+    }
+    if (publication) {
+        return canonicalizeHttpUrl(publication.info.record.url) === canonicalAssumed;
+    }
+    return true;
+};
+const WORDS_PER_MINUTE = 200;
+/**
+ * Estimate reading time in minutes from a plaintext document body. Returns
+ * `undefined` when the input has no countable words. Uses a coarse
+ * `WORDS_PER_MINUTE` heuristic; swap in a more accurate library here if
+ * needed (e.g. `reading-time`).
+ */
+export const estimateReadingTimeMinutes = (text) => {
+    const words = text.trim().split(/\s+/).filter(Boolean).length;
+    if (!words)
+        return undefined;
+    return Math.max(1, Math.ceil(words / WORDS_PER_MINUTE));
+};
+//# sourceMappingURL=standard-site.js.map

package/dist/util/standard-site.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-site.js","sourceRoot":"","sources":["../../src/util/standard-site.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,yBAAyB,GAAG,gBAAgB,CAAA;AAEzD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,GAAW,EAAE,GAAW,EAAE,EAAE,CAChE,GAAG,GAAG,IAAI,GAAG,EAAE,CAAA;AAEjB,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACxC,GAAW,EACwB,EAAE;IACrC,MAAM,EAAE,GAAG,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;IAC/B,OAAO;QACL,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAgB;QACpC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC;KACvB,CAAA;AACH,CAAC,CAAA;AAED;;;;;GAKG;AACH,MAAM,mBAAmB,GAAG,CAAC,GAAW,EAAE,IAAa,EAAiB,EAAE;IACxE,IAAI,MAAW,CAAA;IACf,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAA;IAC5E,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;IAC9E,OAAO,GAAG,MAAM,CAAC,QAAQ,KAAK,MAAM,CAAC,IAAI,GAAG,IAAI,EAAE,CAAA;AACpD,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACxC,QAKa,EACb,WAEa,EACb,UAAkB,EACT,EAAE;IACX,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAA;IACxD,IAAI,gBAAgB,KAAK,IAAI;QAAE,OAAO,KAAK,CAAA;IAE3C,IAAI,QAAQ,IAAI,WAAW,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,mBAAmB,CAChC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,EAC/B,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAC5B,CAAA;QACD,OAAO,MAAM,KAAK,gBAAgB,CAAA;IACpC,CAAC;IACD,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,mBAAmB,CAChC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,EAC/B,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAC1B,CAAA;QACD,OAAO,MAAM,KAAK,gBAAgB,CAAA;IACpC,CAAC;IACD,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,mBAAmB,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,gBAAgB,CAAA;IAC9E,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC,CAAA;AAED,MAAM,gBAAgB,GAAG,GAAG,CAAA;AAE5B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACxC,IAAY,EACQ,EAAE;IACtB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAA;IAC7D,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAA;IAC5B,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,gBAAgB,CAAC,CAAC,CAAA;AACzD,CAAC,CAAA","sourcesContent":["import { AtUriString } from '@atproto/syntax'\n\nexport const SITE_STANDARD_NSID_PREFIX = 'site.standard.'\n\n/**\n * Composes a stable map key from an `(uri, cid)` pair. A single hydration\n * batch can pull more than one version of the same SS record URI (different\n * posts pinning different cids), so the composite is needed for O(1)\n * version-exact lookups.\n */\nexport const siteStandardRecordKey = (uri: string, cid: string) =>\n  `${uri}@${cid}`\n\nexport const parseSiteStandardRecordKey = (\n  key: string,\n): { uri: AtUriString; cid: string } => {\n  const at = key.lastIndexOf('@')\n  return {\n    uri: key.slice(0, at) as AtUriString,\n    cid: key.slice(at + 1),\n  }\n}\n\n/**\n * Parse `url` as HTTP(S) and reduce it to a canonical\n * `protocol://host/path` string for equality comparison: lowercases host,\n * strips a trailing slash from the path, and drops query/fragment. Returns\n * `null` when the input isn't a valid HTTP(S) URL.\n */\nconst canonicalizeHttpUrl = (url: string, base?: string): string | null => {\n  let parsed: URL\n  try {\n    parsed = new URL(url, base)\n  } catch {\n    return null\n  }\n  if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') return null\n  const path = parsed.pathname === '/' ? '' : parsed.pathname.replace(/\\/$/, '')\n  return `${parsed.protocol}//${parsed.host}${path}`\n}\n\n/**\n * Confirm that the supplied SS records actually back `assumedUrl`. URL\n * comparison parses both sides via the WHATWG URL constructor (resolving\n * the document's `path` against the publication or site as a base) and\n * compares the canonical `protocol://host/path` forms — host case is\n * ignored, query/fragment are dropped, trailing slashes stripped.\n *\n * Structural validation of the doc/pub pair (matching `site` ↔ pub URI,\n * no orphan docs that claim a missing publication) happens upstream in\n * `getSiteStandardRecordsFromHydrationMapsByRefs` /\n * `…ByDocumentUri` (see `hydration/external.ts`); by the time this\n * function runs the pair is already known to be structurally consistent,\n * so we only check whether the records back the URL.\n *\n * Cases:\n * - Document + publication: `publication.url + document.path` must\n *   canonicalize to `assumedUrl`.\n * - Loose document (web-URL `site`): `document.site + document.path`\n *   must canonicalize to `assumedUrl`. (Doc with at-uri `site` but no\n *   publication can't reach this function — the lookups reject it.)\n * - Publication only: `publication.url` must canonicalize to\n *   `assumedUrl`.\n * - Neither: vacuously valid; the caller short-circuits before we get\n *   here.\n */\nexport const validateStandardSiteForUrl = (\n  document:\n    | {\n        ref: { uri: string }\n        info: { record: { site: string; path?: string } }\n      }\n    | undefined,\n  publication:\n    | { ref: { uri: string }; info: { record: { url: string } } }\n    | undefined,\n  assumedUrl: string,\n): boolean => {\n  const canonicalAssumed = canonicalizeHttpUrl(assumedUrl)\n  if (canonicalAssumed === null) return false\n\n  if (document && publication) {\n    const joined = canonicalizeHttpUrl(\n      document.info.record.path ?? '',\n      publication.info.record.url,\n    )\n    return joined === canonicalAssumed\n  }\n  if (document) {\n    const joined = canonicalizeHttpUrl(\n      document.info.record.path ?? '',\n      document.info.record.site,\n    )\n    return joined === canonicalAssumed\n  }\n  if (publication) {\n    return canonicalizeHttpUrl(publication.info.record.url) === canonicalAssumed\n  }\n  return true\n}\n\nconst WORDS_PER_MINUTE = 200\n\n/**\n * Estimate reading time in minutes from a plaintext document body. Returns\n * `undefined` when the input has no countable words. Uses a coarse\n * `WORDS_PER_MINUTE` heuristic; swap in a more accurate library here if\n * needed (e.g. `reading-time`).\n */\nexport const estimateReadingTimeMinutes = (\n  text: string,\n): number | undefined => {\n  const words = text.trim().split(/\\s+/).filter(Boolean).length\n  if (!words) return undefined\n  return Math.max(1, Math.ceil(words / WORDS_PER_MINUTE))\n}\n"]}

package/dist/views/index.d.ts

@@ -1,12 +1,13 @@
 import { $Typed, Un$Typed, Unknown$TypedObject, UriString } from '@atproto/lex';
 import { AtUriString, DidString } from '@atproto/syntax';
 import { Actor, ProfileViewerState } from '../hydration/actor.js';
+import { AssociatedSiteStandardRecord, SiteStandardDocument, SiteStandardPublication } from '../hydration/external.js';
 import { FeedItem, Repost } from '../hydration/feed.js';
 import { HydrationState } from '../hydration/hydrator.js';
 import { Label } from '../hydration/label.js';
 import { ImageUriBuilder } from '../image/uri.js';
 import { Notification } from '../proto/bsky_pb.js';
-import { ActivitySubscription, BlockedPost, BookmarkView, Embed, EmbedView, ExternalEmbed, ExternalEmbedView, FeedViewPost, FollowRecord, GeneratorView, GetPostThreadV2QueryParams, ImagesEmbed, ImagesEmbedView, KnownFollowers, LabelerRecord, LabelerView, LabelerViewDetailed, LikeRecord, ListItemView, ListView, ListViewBasic, MaybePostView, NotFoundPost, NotificationRecordDeleted, NotificationView, PostEmbedView, PostRecord, PostView, ProfileAssociatedActivitySubscription, ProfileAssociatedChat, ProfileRecord, ProfileView, ProfileViewBasic, ProfileViewDetailed, ProfileViewer, ReasonPin, ReasonRepost, RecordEmbed, RecordEmbedView, RecordWithMedia, RecordWithMediaView, ReplyRef, RepostRecord, StarterPackView, StarterPackViewBasic, StatusView, ThreadItem, ThreadOtherItem, ThreadViewPost, ThreadgateView, VerificationRecord, VerificationState, VideoEmbed, VideoEmbedView } from './types.js';
+import { ActivitySubscription, BlockedPost, BookmarkView, Embed, EmbedView, ExternalEmbed, ExternalEmbedSourceView, ExternalEmbedView, FeedViewPost, FollowRecord, GeneratorView, GetPostThreadV2QueryParams, ImagesEmbed, ImagesEmbedView, KnownFollowers, LabelerRecord, LabelerView, LabelerViewDetailed, LikeRecord, ListItemView, ListView, ListViewBasic, MaybePostView, NotFoundPost, NotificationRecordDeleted, NotificationView, PostEmbedView, PostRecord, PostView, ProfileAssociatedActivitySubscription, ProfileAssociatedChat, ProfileRecord, ProfileView, ProfileViewBasic, ProfileViewDetailed, ProfileViewer, ReasonPin, ReasonRepost, RecordEmbed, RecordEmbedView, RecordWithMedia, RecordWithMediaView, ReplyRef, RepostRecord, StarterPackView, StarterPackViewBasic, StatusView, ThreadItem, ThreadOtherItem, ThreadViewPost, ThreadgateView, VerificationRecord, VerificationState, VideoEmbed, VideoEmbedView } from './types.js';
 import { VideoUriBuilder } from './util.js';
 export declare class Views {
     private opts;
@@ -127,7 +128,55 @@ export declare class Views {
     embed(postUri: AtUriString, embed: $Typed<Embed> | Unknown$TypedObject, state: HydrationState, depth: number): $Typed<EmbedView> | undefined;
     imagesEmbed(did: DidString, embed: ImagesEmbed): $Typed<ImagesEmbedView>;
     videoEmbed(did: DidString, embed: VideoEmbed): $Typed<VideoEmbedView>;
-    externalEmbed(did: DidString, embed: ExternalEmbed): $Typed<ExternalEmbedView>;
+    externalEmbed(did: DidString, embed: ExternalEmbed, state: HydrationState): $Typed<ExternalEmbedView>;
+    /**
+     * Read-path entry point: caller has the post's `external.associatedRefs[]`
+     * and the global hydration state, and we resolve the matching SS records
+     * by ref. Used by `externalEmbed`.
+     *
+     * Returns a fully-populated `viewExternal['external']` shape (including
+     * the required `uri`/`title`/`description`), or `undefined` if the
+     * records didn't hydrate, didn't pass URL validation, or couldn't
+     * supply the required fields. Callers spread the result over a base
+     * view to layer SS-derived fields on top of post-author-supplied ones.
+     *
+     * `assumedUrl` is the canonical web URL the embed claims to represent
+     * (the post's `external.uri` on the read path, the request's `url` on
+     * compose). Validation logic uses it to confirm the SS records actually
+     * back that URL, and the same value is echoed back as `uri` on the
+     * returned overlay.
+     */
+    externalEmbedFromStandardSite({ associatedRefs, state, assumedUrl, }: {
+        associatedRefs: ExternalEmbed['external']['associatedRefs'];
+        state: HydrationState;
+        assumedUrl: string;
+    }): ExternalEmbedView['external'] | undefined;
+    /**
+     * Compose-path entry point: caller already knows which document and
+     * publication backed the request and has them in hand (e.g. from
+     * iterating the SS hydration maps directly). Skips the by-ref lookup
+     * that `externalEmbedFromStandardSite` does. Used by
+     * `getEmbedExternalView`.
+     *
+     * Returns a fully-populated `viewExternal['external']` shape (including
+     * the required `uri`/`title`/`description`), or `undefined` if any of
+     * the validation gates rejected the pair or the records couldn't
+     * supply the required fields.
+     *
+     * `state` is still needed for label hydration. `assumedUrl` is the
+     * canonical web URL the embed claims to represent (the post's
+     * `external.uri` on the read path, the request's `url` on compose);
+     * validation logic uses it to confirm the SS records actually back that
+     * URL, and the same value is echoed back as `uri` on the returned
+     * overlay.
+     */
+    externalEmbedFromStandardSiteRecords({ document, publication, state, assumedUrl, }: {
+        document: AssociatedSiteStandardRecord<SiteStandardDocument> | undefined;
+        publication: AssociatedSiteStandardRecord<SiteStandardPublication> | undefined;
+        state: HydrationState;
+        assumedUrl: string;
+    }): ExternalEmbedView['external'] | undefined;
+    externalEmbedSource(publication: AssociatedSiteStandardRecord<SiteStandardPublication>): $Typed<ExternalEmbedSourceView>;
     embedNotFound(uri: AtUriString): $Typed<RecordEmbedView>;
     embedDetached(uri: AtUriString): $Typed<RecordEmbedView>;
     embedBlocked(uri: AtUriString, state: HydrationState): $Typed<RecordEmbedView>;

package/dist/views/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/views/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/views/index.ts"],"names":[],"mappings":"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"}

package/dist/views/index.js

@@ -1,8 +1,10 @@
 import { HOUR, MINUTE, mapDefined } from '@atproto/common';
 import { getBlobCidString, } from '@atproto/lex';
 import { AtUri, INVALID_HANDLE, normalizeDatetimeAlways, } from '@atproto/syntax';
+import { getSiteStandardRecordsFromHydrationMapsByRefs, } from '../hydration/external.js';
 import { parseString } from '../hydration/util.js';
-import { app } from '../lexicons/index.js';
+import { app, site } from '../lexicons/index.js';
+import { estimateReadingTimeMinutes, validateStandardSiteForUrl, } from '../util/standard-site.js';
 import { postUriToPostgateUri, postUriToThreadgateUri, safePinnedPost, uriToDid, uriToDid as creatorFromUri, } from '../util/uris.js';
 import { sortTrimFlattenThreadTree, } from './threads-v2.js';
 import { isExternalEmbedType, isImagesEmbedType, isLabelerRecordType, isListRuleType, isPostRecordType, isPostViewType, isProfileRecordType, isRecordEmbedType, isRecordWithMediaType, isSelfLabelsType, isVideoEmbedType, } from './types.js';
@@ -384,7 +386,7 @@ export class Views {
             record: record,
             status: record.status,
             embed: record.embed && isExternalEmbedType(record.embed)
-                ? this.externalEmbed(did, record.embed)
+                ? this.externalEmbed(did, record.embed, state)
                 : undefined,
             labels,
             expiresAt,
@@ -1436,7 +1438,7 @@ export class Views {
             return this.videoEmbed(creatorFromUri(postUri), embed);
         }
         else if (isExternalEmbedType(embed)) {
-            return this.externalEmbed(creatorFromUri(postUri), embed);
+            return this.externalEmbed(creatorFromUri(postUri), embed, state);
         }
         else if (isRecordEmbedType(embed)) {
             return this.recordEmbed(postUri, embed, state, depth);
@@ -1470,19 +1472,172 @@ export class Views {
             presentation: embed.presentation,
         });
     }
-    externalEmbed(did, embed) {
-        const { uri, title, description, thumb } = embed.external;
+    externalEmbed(did, embed, state) {
+        // Start from the post-author-supplied embed values, then spread the
+        // SS-derived view on top so any field the hydrated doc/publication
+        // supplies wins (title, description, thumb, source, etc). When no SS
+        // records were hydrated `ssView` is `undefined` and the spread is a
+        // no-op, leaving the base values in place. `associatedRefs` is set
+        // last because the post is authoritative about what was pinned.
+        const ssView = this.externalEmbedFromStandardSite({
+            associatedRefs: embed.external.associatedRefs,
+            state,
+            assumedUrl: embed.external.uri,
+        });
         return app.bsky.embed.external.view.$build({
             external: {
-                uri,
-                title,
-                description,
-                thumb: thumb
-                    ? this.imgUriBuilder.getPresetUri('feed_thumbnail', did, getBlobCidString(thumb))
+                uri: embed.external.uri,
+                title: embed.external.title,
+                description: embed.external.description,
+                thumb: embed.external.thumb
+                    ? this.imgUriBuilder.getPresetUri('feed_thumbnail', did, getBlobCidString(embed.external.thumb))
                     : undefined,
+                ...ssView,
+                associatedRefs: embed.external.associatedRefs,
             },
         });
     }
+    /**
+     * Read-path entry point: caller has the post's `external.associatedRefs[]`
+     * and the global hydration state, and we resolve the matching SS records
+     * by ref. Used by `externalEmbed`.
+     *
+     * Returns a fully-populated `viewExternal['external']` shape (including
+     * the required `uri`/`title`/`description`), or `undefined` if the
+     * records didn't hydrate, didn't pass URL validation, or couldn't
+     * supply the required fields. Callers spread the result over a base
+     * view to layer SS-derived fields on top of post-author-supplied ones.
+     *
+     * `assumedUrl` is the canonical web URL the embed claims to represent
+     * (the post's `external.uri` on the read path, the request's `url` on
+     * compose). Validation logic uses it to confirm the SS records actually
+     * back that URL, and the same value is echoed back as `uri` on the
+     * returned overlay.
+     */
+    externalEmbedFromStandardSite({ associatedRefs, state, assumedUrl, }) {
+        const { document, publication } = getSiteStandardRecordsFromHydrationMapsByRefs(associatedRefs, state.siteStandardDocuments, state.siteStandardPublications);
+        return this.externalEmbedFromStandardSiteRecords({
+            document,
+            publication,
+            state,
+            assumedUrl,
+        });
+    }
+    /**
+     * Compose-path entry point: caller already knows which document and
+     * publication backed the request and has them in hand (e.g. from
+     * iterating the SS hydration maps directly). Skips the by-ref lookup
+     * that `externalEmbedFromStandardSite` does. Used by
+     * `getEmbedExternalView`.
+     *
+     * Returns a fully-populated `viewExternal['external']` shape (including
+     * the required `uri`/`title`/`description`), or `undefined` if any of
+     * the validation gates rejected the pair or the records couldn't
+     * supply the required fields.
+     *
+     * `state` is still needed for label hydration. `assumedUrl` is the
+     * canonical web URL the embed claims to represent (the post's
+     * `external.uri` on the read path, the request's `url` on compose);
+     * validation logic uses it to confirm the SS records actually back that
+     * URL, and the same value is echoed back as `uri` on the returned
+     * overlay.
+     */
+    externalEmbedFromStandardSiteRecords({ document, publication, state, assumedUrl, }) {
+        // Three layers of validation gate this overlay:
+        //
+        //  1. Hydrator nulls taken-down records and mirrors the null across
+        //     doc/pub pairs (see `actionSiteStandardTakedownLabels` in
+        //     `hydration/hydrator.ts`).
+        //  2. The lookups guarantee structural agreement between doc and pub
+        //     — matching `site`/`uri`, no orphan doc claiming a missing
+        //     publication (see `getSiteStandardRecordsFromHydrationMapsByRefs`
+        //     and `…ByDocumentUri` in `hydration/external.ts`).
+        //  3. `validateStandardSiteForUrl` below checks that the records back
+        //     the URL the embed claims (see `util/standard-site.ts`).
+        //
+        // If any layer rejected, callers see `undefined` and fall back to the
+        // bare embed rather than render partial / disagreeing enrichment.
+        if (!document && !publication)
+            return undefined;
+        if (!validateStandardSiteForUrl(document, publication, assumedUrl)) {
+            return undefined;
+        }
+        // viewExternal requires `title` and `description`. If neither side of
+        // the pair supplies usable values for both, there's no enrichment to
+        // render — return undefined and let the caller fall back.
+        let title;
+        let description;
+        if (document?.info.record) {
+            // Treat the document as authoritative for both fields as a unit, so
+            // we never blend a doc's title with a publication's description.
+            title = document.info.record.title;
+            description = document.info.record.description ?? '';
+        }
+        else if (publication) {
+            title = publication.info.record.name;
+            description = publication.info.record.description ?? '';
+        }
+        else {
+            return undefined;
+        }
+        // if we don't have a title at this point, something is wrong with the SS
+        // record (it's a required field) and therefore the enrichment isn't worth
+        // showing
+        if (!title)
+            return undefined;
+        const overlay = {
+            // @ts-ignore this is mis-typed
+            uri: assumedUrl,
+            title,
+            description,
+        };
+        const docCover = document?.info.record.coverImage;
+        if (docCover) {
+            overlay.thumb = this.imgUriBuilder.getPresetUri('feed_thumbnail', creatorFromUri(document.ref.uri), getBlobCidString(docCover));
+        }
+        if (document?.info.record.publishedAt) {
+            overlay.createdAt = document.info.record.publishedAt;
+        }
+        if (document?.info.record.updatedAt) {
+            overlay.updatedAt = document.info.record.updatedAt;
+        }
+        const readingTime = document?.info.record.textContent
+            ? estimateReadingTimeMinutes(document.info.record.textContent)
+            : undefined;
+        if (readingTime !== undefined)
+            overlay.readingTime = readingTime;
+        // Merge labels applied to either the document or the publication onto the
+        // same `viewExternal.labels` array — clients moderate the embed as single
+        // unit, so doc-scoped and publication-scoped labels end up in the same
+        // bucket.
+        const labels = [
+            ...(document ? state.labels?.getBySubject(document.ref.uri) ?? [] : []),
+            ...(publication
+                ? state.labels?.getBySubject(publication.ref.uri) ?? []
+                : []),
+        ];
+        if (labels.length)
+            overlay.labels = labels;
+        if (publication) {
+            overlay.source = this.externalEmbedSource(publication);
+        }
+        return overlay;
+    }
+    externalEmbedSource(publication) {
+        const { record } = publication.info;
+        const pubDid = creatorFromUri(publication.ref.uri);
+        return app.bsky.embed.external.viewExternalSource.$build({
+            uri: record.url,
+            icon: record.icon
+                ? this.imgUriBuilder.getPresetUri('avatar', pubDid, getBlobCidString(record.icon))
+                : undefined,
+            title: record.name,
+            description: record.description,
+            theme: record.basicTheme
+                ? externalEmbedSourceTheme(record.basicTheme)
+                : undefined,
+        });
+    }
     embedNotFound(uri) {
         return app.bsky.embed.record.view.$build({
             record: app.bsky.embed.record.viewNotFound.$build({
@@ -1593,7 +1748,7 @@ export class Views {
             mediaEmbed = this.videoEmbed(creator, embed.media);
         }
         else if (isExternalEmbedType(embed.media)) {
-            mediaEmbed = this.externalEmbed(creator, embed.media);
+            mediaEmbed = this.externalEmbed(creator, embed.media, state);
         }
         else {
             return;
@@ -1737,4 +1892,32 @@ export class Views {
 const getRootUri = (uri, post) => {
     return post.record.reply?.root.uri ?? uri;
 };
+const externalEmbedSourceTheme = (theme) => {
+    if (!theme)
+        return undefined;
+    const view = {};
+    const background = colorRGB(theme.background);
+    const foreground = colorRGB(theme.foreground);
+    const accent = colorRGB(theme.accent);
+    const accentForeground = colorRGB(theme.accentForeground);
+    if (background)
+        view.backgroundRGB = background;
+    if (foreground)
+        view.foregroundRGB = foreground;
+    if (accent)
+        view.accentRGB = accent;
+    if (accentForeground)
+        view.accentForegroundRGB = accentForeground;
+    // No fields set -> don't decorate the view at all.
+    return Object.keys(view).length === 0 ? undefined : view;
+};
+const colorRGB = (color) => {
+    if (!color || !site.standard.theme.color.rgb.isTypeOf(color))
+        return undefined;
+    // `isTypeOf` narrows $type but not the shape; pull rgb fields off the
+    // unchecked input. Records that fail full validation are dropped above
+    // by the SS record parser, so by the time we get here the shape matches.
+    const { r, g, b } = color;
+    return app.bsky.embed.external.colorRGB.$build({ r, g, b });
+};
 //# sourceMappingURL=index.js.map