api.fluff4.me 1.0.1014 → 1.0.1016

package/index.d.ts

@@ -481,6 +481,27 @@ export interface CampaignTierSetBody {
 	chapters: string[]
 }
 
+export interface Comment {
+	comment_id: string
+	parent_id?: string | null
+	created_time?: string | null
+	edited_time?: string | null
+	author?: string | null
+	body?: TextBody | null
+	reactions?: number | null
+	reacted?: true | null
+	author_hearted?: true | null
+}
+
+export interface WorkRecommendationBody {
+	body: string
+}
+
+export interface CommentsResponse {
+	comments: Comment[]
+	authors: AuthorMetadata[]
+}
+
 export type Works = WorkMetadata[]
 
 export interface WorkResolveResponse {
@@ -540,18 +561,6 @@ export interface RoleReorderBody {
 	roles: string[]
 }
 
-export interface Comment {
-	comment_id: string
-	parent_id?: string | null
-	created_time?: string | null
-	edited_time?: string | null
-	author?: string | null
-	body?: TextBody | null
-	reactions?: number | null
-	reacted?: true | null
-	author_hearted?: true | null
-}
-
 export interface CommentCreateBody {
 	body: string
 	parent_id?: string | null
@@ -561,11 +570,6 @@ export interface CommentUpdateBody {
 	body: string
 }
 
-export interface CommentsResponse {
-	comments: Comment[]
-	authors: AuthorMetadata[]
-}
-
 export interface Tag {
 	name: string
 	description: TextBody
@@ -764,6 +768,8 @@ export interface ManifestNotificationTypes {
 	"work-censored": NotificationType
 	"chapter-censored": NotificationType
 	"patreon-needs-reauth": NotificationType
+	"work-recommendation": NotificationType
+	"recommendation-mention": NotificationType
 }
 
 export interface NotificationType {
@@ -1332,6 +1338,18 @@ export interface Paths {
 		search?: undefined
 		response: void | ErrorResponse
 	},
+	"/work/{author}/{vanity}/recommend": {
+		method: "post"
+		body: WorkRecommendationBody
+		search?: undefined
+		response: Response<Comment> | ErrorResponse
+	},
+	"/work/{author}/{vanity}/recommendations": {
+		method: "get"
+		body?: undefined
+		search: PaginationSearch
+		response: PaginatedResponse<CommentsResponse> | ErrorResponse
+	},
 	"/works/{author}": {
 		method: "get"
 		body?: undefined
@@ -1944,6 +1962,18 @@ export interface Paths {
 		search?: undefined
 		response: Response<Bookmarks> | ErrorResponse
 	},
+	"/recommendation/{comment_id}/react/{type}": {
+		method: "post"
+		body?: undefined
+		search?: undefined
+		response: void | ErrorResponse
+	},
+	"/recommendation/{comment_id}/unreact": {
+		method: "post"
+		body?: undefined
+		search?: undefined
+		response: void | ErrorResponse
+	},
 	"/supporter/status": {
 		method: "get"
 		body?: undefined

package/openapi.json

@@ -3029,6 +3029,140 @@
 					"chapters"
 				]
 			},
+			"Comment": {
+				"type": "object",
+				"properties": {
+					"comment_id": {
+						"type": "string",
+						"minLength": 36,
+						"maxLength": 36
+					},
+					"parent_id": {
+						"anyOf": [
+							{
+								"type": "string",
+								"minLength": 36,
+								"maxLength": 36
+							},
+							{
+								"type": "null"
+							}
+						]
+					},
+					"created_time": {
+						"anyOf": [
+							{
+								"type": "string"
+							},
+							{
+								"type": "null"
+							}
+						]
+					},
+					"edited_time": {
+						"anyOf": [
+							{
+								"type": "string"
+							},
+							{
+								"type": "null"
+							}
+						]
+					},
+					"author": {
+						"anyOf": [
+							{
+								"type": "string"
+							},
+							{
+								"type": "null"
+							}
+						]
+					},
+					"body": {
+						"anyOf": [
+							{
+								"$ref": "#/components/schema/TextBody"
+							},
+							{
+								"type": "null"
+							}
+						]
+					},
+					"reactions": {
+						"anyOf": [
+							{
+								"type": "number"
+							},
+							{
+								"type": "null"
+							}
+						]
+					},
+					"reacted": {
+						"anyOf": [
+							{
+								"type": "boolean",
+								"enum": [
+									true
+								]
+							},
+							{
+								"type": "null"
+							}
+						]
+					},
+					"author_hearted": {
+						"anyOf": [
+							{
+								"type": "boolean",
+								"enum": [
+									true
+								]
+							},
+							{
+								"type": "null"
+							}
+						]
+					}
+				},
+				"required": [
+					"comment_id"
+				]
+			},
+			"WorkRecommendationBody": {
+				"type": "object",
+				"properties": {
+					"body": {
+						"type": "string",
+						"maxLength": 1024
+					}
+				},
+				"required": [
+					"body"
+				]
+			},
+			"CommentsResponse": {
+				"type": "object",
+				"properties": {
+					"comments": {
+						"type": "array",
+						"items": {
+							"$ref": "#/components/schema/Comment"
+						}
+					},
+					"authors": {
+						"type": "array",
+						"items": {
+							"$ref": "#/components/schema/AuthorMetadata"
+						}
+					}
+				},
+				"required": [
+					"comments",
+					"authors"
+				]
+			},
 			"Works": {
 				"type": "array",
 				"items": {
@@ -3312,107 +3446,6 @@
 					"roles"
 				]
 			},
-			"Comment": {
-				"type": "object",
-				"properties": {
-					"comment_id": {
-						"type": "string",
-						"minLength": 36,
-						"maxLength": 36
-					},
-					"parent_id": {
-						"anyOf": [
-							{
-								"type": "string",
-								"minLength": 36,
-								"maxLength": 36
-							},
-							{
-								"type": "null"
-							}
-						]
-					},
-					"created_time": {
-						"anyOf": [
-							{
-								"type": "string"
-							},
-							{
-								"type": "null"
-							}
-						]
-					},
-					"edited_time": {
-						"anyOf": [
-							{
-								"type": "string"
-							},
-							{
-								"type": "null"
-							}
-						]
-					},
-					"author": {
-						"anyOf": [
-							{
-								"type": "string"
-							},
-							{
-								"type": "null"
-							}
-						]
-					},
-					"body": {
-						"anyOf": [
-							{
-								"$ref": "#/components/schema/TextBody"
-							},
-							{
-								"type": "null"
-							}
-						]
-					},
-					"reactions": {
-						"anyOf": [
-							{
-								"type": "number"
-							},
-							{
-								"type": "null"
-							}
-						]
-					},
-					"reacted": {
-						"anyOf": [
-							{
-								"type": "boolean",
-								"enum": [
-									true
-								]
-							},
-							{
-								"type": "null"
-							}
-						]
-					},
-					"author_hearted": {
-						"anyOf": [
-							{
-								"type": "boolean",
-								"enum": [
-									true
-								]
-							},
-							{
-								"type": "null"
-							}
-						]
-					}
-				},
-				"required": [
-					"comment_id"
-				]
-			},
 			"CommentCreateBody": {
 				"type": "object",
 				"properties": {
@@ -3447,27 +3480,6 @@
 					"body"
 				]
 			},
-			"CommentsResponse": {
-				"type": "object",
-				"properties": {
-					"comments": {
-						"type": "array",
-						"items": {
-							"$ref": "#/components/schema/Comment"
-						}
-					},
-					"authors": {
-						"type": "array",
-						"items": {
-							"$ref": "#/components/schema/AuthorMetadata"
-						}
-					}
-				},
-				"required": [
-					"comments",
-					"authors"
-				]
-			},
 			"Tag": {
 				"type": "object",
 				"properties": {
@@ -4362,6 +4374,12 @@
 					},
 					"patreon-needs-reauth": {
 						"$ref": "#/components/schema/NotificationType"
+					},
+					"work-recommendation": {
+						"$ref": "#/components/schema/NotificationType"
+					},
+					"recommendation-mention": {
+						"$ref": "#/components/schema/NotificationType"
 					}
 				},
 				"required": [
@@ -4384,7 +4402,9 @@
 					"author-censored",
 					"work-censored",
 					"chapter-censored",
-					"patreon-needs-reauth"
+					"patreon-needs-reauth",
+					"work-recommendation",
+					"recommendation-mention"
 				]
 			},
 			"NotificationType": {
@@ -7923,6 +7943,155 @@
 				}
 			}
 		},
+		"/work/{author}/{vanity}/recommend": {
+			"parameters": [
+				{
+					"name": "author",
+					"in": "path"
+				},
+				{
+					"name": "vanity",
+					"in": "path"
+				}
+			],
+			"post": {
+				"requestBody": {
+					"content": {
+						"application/json": {
+							"schema": {
+								"$ref": "#/components/schemas/WorkRecommendationBody"
+							}
+						}
+					}
+				},
+				"responses": {
+					"200": {
+						"description": "200 response",
+						"content": {
+							"application/json": {
+								"schema": {
+									"type": "object",
+									"properties": {
+										"data": {
+											"$ref": "#/components/schemas/Comment"
+										}
+									},
+									"required": [
+										"data"
+									]
+								}
+							}
+						}
+					},
+					"default": {
+						"description": "Error",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/ErrorResponse"
+								}
+							}
+						}
+					}
+				}
+			}
+		},
+		"/work/{author}/{vanity}/recommendations": {
+			"parameters": [
+				{
+					"name": "author",
+					"in": "path"
+				},
+				{
+					"name": "vanity",
+					"in": "path"
+				}
+			],
+			"get": {
+				"parameters": [
+					{
+						"name": "page",
+						"in": "query",
+						"description": "The page of data to query from. This endpoint uses a page size of 25 by default.",
+						"schema": {
+							"type": "integer",
+							"minimum": 0
+						}
+					},
+					{
+						"name": "page_size",
+						"in": "query",
+						"description": "The custom page size to return. This endpoint uses a page size of 25 by default. The custom page size cannot be raised above the default.",
+						"schema": {
+							"type": "integer",
+							"minimum": 1,
+							"maximum": 25
+						}
+					}
+				],
+				"responses": {
+					"200": {
+						"description": "200 response",
+						"content": {
+							"application/json": {
+								"schema": {
+									"type": "object",
+									"properties": {
+										"data": {
+											"$ref": "#/components/schemas/CommentsResponse"
+										},
+										"has_more": {
+											"type": "boolean"
+										},
+										"page": {
+											"type": "number",
+											"minimum": 0
+										},
+										"page_count": {
+											"type": [
+												"boolean",
+												"number"
+											],
+											"anyOf": [
+												{
+													"type": "boolean",
+													"enum": [
+														true
+													]
+												},
+												{
+													"type": "number",
+													"minimum": 0
+												}
+											]
+										}
+									},
+									"required": [
+										"data",
+										"has_more",
+										"page",
+										"page_count"
+									]
+								}
+							}
+						}
+					},
+					"304": {
+						"description": "304 response"
+					},
+					"default": {
+						"description": "Error",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/ErrorResponse"
+								}
+							}
+						}
+					}
+				}
+			}
+		},
 		"/works/{author}": {
 			"parameters": [
 				{
@@ -12725,6 +12894,60 @@
 				}
 			}
 		},
+		"/recommendation/{comment_id}/react/{type}": {
+			"parameters": [
+				{
+					"name": "comment_id",
+					"in": "path"
+				},
+				{
+					"name": "type",
+					"in": "path"
+				}
+			],
+			"post": {
+				"responses": {
+					"200": {
+						"description": "200 response"
+					},
+					"default": {
+						"description": "Error",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/ErrorResponse"
+								}
+							}
+						}
+					}
+				}
+			}
+		},
+		"/recommendation/{comment_id}/unreact": {
+			"parameters": [
+				{
+					"name": "comment_id",
+					"in": "path"
+				}
+			],
+			"post": {
+				"responses": {
+					"200": {
+						"description": "200 response"
+					},
+					"default": {
+						"description": "Error",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/ErrorResponse"
+								}
+							}
+						}
+					}
+				}
+			}
+		},
 		"/supporter/status": {
 			"get": {
 				"responses": {

package/package.json

@@ -1,5 +1,5 @@
 {
 	"name": "api.fluff4.me",
-	"version": "1.0.1014",
+	"version": "1.0.1016",
 	"types": "index.d.ts"
 }