fix: Deprecate API related to guild ownership (#1316)

Author: Jiralite

deno/rest/v10/guild.ts

@@ -97,7 +97,8 @@ export interface RESTAPIGuildCreateRole extends RESTPostAPIGuildRoleJSONBody {
 export type APIGuildCreateRole = RESTAPIGuildCreateRole;
 
 /**
- * @see {@link https://discord.com/developers/docs/resources/guild#create-guild}
+ * @see {@link https://discord.com/developers/docs/change-log#guild-create-deprecation}
+ * @deprecated
  */
 export interface RESTPostAPIGuildsJSONBody {
 	/**
@@ -185,12 +186,14 @@ export interface RESTPostAPIGuildsJSONBody {
 }
 
 /**
- * @see {@link https://discord.com/developers/docs/resources/guild#create-guild}
+ * @see {@link https://discord.com/developers/docs/change-log#guild-create-deprecation}
+ * @deprecated
  */
 export type RESTPostAPIGuildsResult = APIGuild;
 
 /**
- * @see {@link https://discord.com/developers/docs/resources/guild#modify-guild-mfa-level}
+ * @see {@link https://discord.com/developers/docs/change-log#guild-create-deprecation}
+ * @deprecated
  */
 export interface RESTPostAPIGuildsMFAJSONBody {
 	/**
@@ -202,7 +205,8 @@ export interface RESTPostAPIGuildsMFAJSONBody {
 }
 
 /**
- * @see {@link https://discord.com/developers/docs/resources/guild#modify-guild-mfa-level}
+ * @see {@link https://discord.com/developers/docs/change-log#guild-create-deprecation}
+ * @deprecated
  */
 export type RESTPostAPIGuildsMFAResult = RESTPostAPIGuildsMFAJSONBody;
 
@@ -276,6 +280,8 @@ export interface RESTPatchAPIGuildJSONBody {
 	icon?: string | null | undefined;
 	/**
 	 * User id to transfer guild ownership to (must be owner)
+	 *
+	 * @deprecated
 	 */
 	owner_id?: Snowflake | undefined;
 	/**
@@ -342,7 +348,8 @@ export interface RESTPatchAPIGuildJSONBody {
 export type RESTPatchAPIGuildResult = APIGuild;
 
 /**
- * @see {@link https://discord.com/developers/docs/resources/guild#delete-guild}
+ * @see {@link https://discord.com/developers/docs/change-log#guild-create-deprecation}
+ * @deprecated
  */
 export type RESTDeleteAPIGuildResult = never;
 

deno/rest/v10/mod.ts

@@ -250,6 +250,8 @@ export const Routes = {
 	/**
 	 * Route for:
 	 * - POST `/guilds`
+	 *
+	 * @deprecated {@link https://discord.com/developers/docs/change-log#guild-create-deprecation}
 	 */
 	guilds() {
 		return '/guilds' as const;
@@ -259,7 +261,7 @@ export const Routes = {
 	 * Route for:
 	 * - GET    `/guilds/{guild.id}`
 	 * - PATCH  `/guilds/{guild.id}`
-	 * - DELETE `/guilds/{guild.id}`
+	 * - DELETE `/guilds/{guild.id}` (**deprecated**)
 	 */
 	guild(guildId: Snowflake) {
 		return `/guilds/${guildId}` as const;
@@ -333,6 +335,8 @@ export const Routes = {
 	/**
 	 * Route for:
 	 * - POST `/guilds/{guild.id}/mfa`
+	 *
+	 * @deprecated
 	 */
 	guildMFA(guildId: Snowflake) {
 		return `/guilds/${guildId}/mfa` as const;
@@ -462,7 +466,7 @@ export const Routes = {
 	/**
 	 * Route for:
 	 * - GET  `/guilds/templates/{template.code}`
-	 * - POST `/guilds/templates/{template.code}`
+	 * - POST `/guilds/templates/{template.code}` (**deprecated**)
 	 */
 	template(code: string) {
 		return `/guilds/templates/${code}` as const;

deno/rest/v10/template.ts

@@ -7,7 +7,8 @@ import type { _StrictPartial } from '../../utils/internals';
 export type RESTGetAPITemplateResult = APITemplate;
 
 /**
- * @see {@link https://discord.com/developers/docs/resources/guild-template#create-guild-from-guild-template}
+ * @see {@link https://discord.com/developers/docs/change-log#guild-create-deprecation}
+ * @deprecated
  */
 export interface RESTPostAPITemplateCreateGuildJSONBody {
 	/**
@@ -23,7 +24,8 @@ export interface RESTPostAPITemplateCreateGuildJSONBody {
 }
 
 /**
- * @see {@link https://discord.com/developers/docs/resources/guild-template#create-guild-from-guild-template}
+ * @see {@link https://discord.com/developers/docs/change-log#guild-create-deprecation}
+ * @deprecated
  */
 export type RESTPostAPITemplateCreateGuildResult = APIGuild;
 

deno/rest/v9/guild.ts

@@ -98,6 +98,7 @@ export type APIGuildCreateRole = RESTAPIGuildCreateRole;
 
 /**
  * @see {@link https://discord.com/developers/docs/resources/guild#create-guild}
+ * @deprecated {@link https://discord.com/developers/docs/change-log#guild-create-deprecation}
  */
 export interface RESTPostAPIGuildsJSONBody {
 	/**
@@ -185,12 +186,14 @@ export interface RESTPostAPIGuildsJSONBody {
 }
 
 /**
- * @see {@link https://discord.com/developers/docs/resources/guild#create-guild}
+ * @see {@link https://discord.com/developers/docs/change-log#guild-create-deprecation}
+ * @deprecated
  */
 export type RESTPostAPIGuildsResult = APIGuild;
 
 /**
- * @see {@link https://discord.com/developers/docs/resources/guild#modify-guild-mfa-level}
+ * @see {@link https://discord.com/developers/docs/change-log#guild-create-deprecation}
+ * @deprecated
  */
 export interface RESTPostAPIGuildsMFAJSONBody {
 	/**
@@ -202,7 +205,8 @@ export interface RESTPostAPIGuildsMFAJSONBody {
 }
 
 /**
- * @see {@link https://discord.com/developers/docs/resources/guild#modify-guild-mfa-level}
+ * @see {@link https://discord.com/developers/docs/change-log#guild-create-deprecation}
+ * @deprecated
  */
 export type RESTPostAPIGuildsMFAResult = RESTPostAPIGuildsMFAJSONBody;
 
@@ -276,6 +280,8 @@ export interface RESTPatchAPIGuildJSONBody {
 	icon?: string | null | undefined;
 	/**
 	 * User id to transfer guild ownership to (must be owner)
+	 *
+	 * @deprecated
 	 */
 	owner_id?: Snowflake | undefined;
 	/**
@@ -342,7 +348,8 @@ export interface RESTPatchAPIGuildJSONBody {
 export type RESTPatchAPIGuildResult = APIGuild;
 
 /**
- * @see {@link https://discord.com/developers/docs/resources/guild#delete-guild}
+ * @see {@link https://discord.com/developers/docs/change-log#guild-create-deprecation}
+ * @deprecated
  */
 export type RESTDeleteAPIGuildResult = never;