feat: Add quote entities and attach to statuses (#1324)

TylerFisher · web-flow · commit be42256f1f07 · 2025-07-13T10:04:38.000+09:00
* add quote entities and attach to statuses

* Fix linting
diff --git a/src/mastodon/entities/v1/quote.ts b/src/mastodon/entities/v1/quote.ts
@@ -0,0 +1,23 @@
+import { type Status } from "./status.js";
+
+export interface QuoteStateRegistry {
+  pending: never;
+  accepted: never;
+  rejected: never;
+  revoked: never;
+  deleted: never;
+  unauthorized: never;
+}
+
+export type QuoteState = keyof QuoteStateRegistry;
+
+/**
+ * Represents a quote or a quote placeholder, with the current authorization status.
+ * @see https://docs.joinmastodon.org/entities/Quote
+ */
+export interface Quote {
+  /* The state of the quote */
+  state: QuoteState;
+  /* The status being quoted, if the quote has been accepted. This will be null, unless the state attribute is accepted. */
+  quotedStatus: Status | null;
+}
diff --git a/src/mastodon/entities/v1/shallow-quote.ts b/src/mastodon/entities/v1/shallow-quote.ts
@@ -0,0 +1,12 @@
+import { type QuoteState } from "./quote.js";
+
+/**
+ * Represents a quote or a quote placeholder, with the current authorization status.
+ * @see https://docs.joinmastodon.org/entities/ShallowQuote/
+ */
+export interface ShallowQuote {
+  /* The state of the quote. */
+  state: QuoteState;
+  /* The identifier of the status being quoted, if the quote has been accepted. This will be null, unless the state attribute is accepted. */
+  quotedStatusId: string | null;
+}
diff --git a/src/mastodon/entities/v1/status-edit.ts b/src/mastodon/entities/v1/status-edit.ts
@@ -9,4 +9,6 @@ export type StatusEdit = Pick<
   | "account"
   | "mediaAttachments"
   | "emojis"
->;
+> & {
+  quote?: Status["quote"];
+};
diff --git a/src/mastodon/entities/v1/status.ts b/src/mastodon/entities/v1/status.ts
@@ -5,6 +5,8 @@ import { type FilterResult } from "./filter-result.js";
 import { type MediaAttachment } from "./media-attachment.js";
 import { type Poll } from "./poll.js";
 import { type PreviewCard } from "./preview-card.js";
+import { type Quote } from "./quote.js";
+import { type ShallowQuote } from "./shallow-quote.js";
 import { type Tag } from "./tag.js";
 
 /**
@@ -77,6 +79,8 @@ export interface Status {
   filtered?: FilterResult[];
   /** How many replies this status has received. */
   repliesCount: number;
+  /** Information about the status being quoted, if any */
+  quote: Quote | ShallowQuote | null;
 
   /** A link to the status's HTML representation. */
   url?: string | null;
