feat: Support new accounts field in PreviewCard of status introduced by Mastodon 4.3.0

shuuji3 · shuuji3 · commit 96a84f2c0f66 · 2024-10-21T19:34:48.000+09:00
Here's Mastodon documentation page for new `authors` field: https://docs.joinmastodon.org/entities/PreviewCard/#authors
diff --git a/src/mastodon/entities/v1/preview-card.ts b/src/mastodon/entities/v1/preview-card.ts
@@ -1,7 +1,21 @@
 import { type TagHistory } from "./tag";
+import { Account } from "./account";
 
 export type PreviewCardType = "link" | "photo" | "video" | "rich";
 
+/**
+ * Represents an author in a rich preview card.
+ * @see https://docs.joinmastodon.org/entities/PreviewCardAuthor/
+ */
+export interface PreviewCardAuthor {
+  /** The original resource author’s name. Replaces the deprecated author_name attribute of the preview card. */
+  name: string;
+  /** A link to the author of the original resource. Replaces the deprecated author_url attribute of the preview card. */
+  url: string;
+  /** The fediverse account of the author. */
+  account: Account | null;
+}
+
 /**
  * Represents a rich preview card that is generated using OpenGraph tags from a URL.
  * @see https://docs.joinmastodon.org/entities/PreviewCard
@@ -17,10 +31,17 @@ export interface PreviewCard {
   type: PreviewCardType;
   /** Blurhash */
   blurhash: string;
-
-  /** The author of the original resource. */
+  /** Fediverse account of the authors of the original resource. */
+  authors: PreviewCardAuthor[];
+  /**
+   * The author of the original resource.
+   * @deprecated Use `authors` instead
+   */
   authorName?: string | null;
-  /** A link to the author of the original resource. */
+  /**
+   * A link to the author of the original resource.
+   * @deprecated Use `authors` instead
+   */
   authorUrl?: string | null;
   /** The provider of the original resource. */
   providerName?: string | null;
