This repository has no description
Something went wrong. Try again.
8.1 kB · 212 lines
TypeScript
at main
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213// SPDX-License-Identifier: AGPL-3.0-or-later
import { GuildIdParam, GuildIdStickerIdParam, StickerIdParam,} from '@fluxer/schema/src/domains/common/CommonParamSchemas';import {PurgeQuery} from '@fluxer/schema/src/domains/common/CommonQuerySchemas';import { GuildStickerBulkCreateResponse, GuildStickerMetadataResponse, GuildStickerResponse, GuildStickerWithUserListResponse,} from '@fluxer/schema/src/domains/guild/GuildEmojiSchemas';import { GuildStickerBulkCreateRequest, GuildStickerCloneRequest, GuildStickerCreateRequest, GuildStickerUpdateRequest,} from '@fluxer/schema/src/domains/guild/GuildRequestSchemas';import {createGuildID, createStickerID} from '../../BrandedTypes';import {LoginRequired} from '../../middleware/AuthMiddleware';import {RateLimitMiddleware} from '../../middleware/RateLimitMiddleware';import {OpenAPI} from '../../middleware/ResponseTypeMiddleware';import {RateLimitConfigs} from '../../RateLimitConfig';import type {HonoApp} from '../../types/HonoEnv';import {Validator} from '../../Validator';
export function GuildStickerController(app: HonoApp) { app.post( '/guilds/:guild_id/stickers', RateLimitMiddleware(RateLimitConfigs.GUILD_STICKER_CREATE), LoginRequired, Validator('param', GuildIdParam), Validator('json', GuildStickerCreateRequest), OpenAPI({ operationId: 'create_guild_sticker', summary: 'Create guild sticker', responseSchema: GuildStickerResponse, statusCode: 200, security: ['botToken', 'bearerToken', 'sessionToken'], tags: ['Guilds'], description: 'Create guild sticker. Requires manage_emojis permission. Uploads a new sticker with name, description, and tags.', }), async (ctx) => { const user = ctx.get('user'); const guildId = createGuildID(ctx.req.valid('param').guild_id); const {name, description, tags, image} = ctx.req.valid('json'); const auditLogReason = ctx.get('auditLogReason') ?? null; const sticker = await ctx .get('guildService') .content.createSticker({user, guildId, name, description, tags, image}, auditLogReason); return ctx.json(sticker); }, ); app.post( '/guilds/:guild_id/stickers/bulk', RateLimitMiddleware(RateLimitConfigs.GUILD_STICKER_BULK_CREATE), LoginRequired, Validator('param', GuildIdParam), Validator('json', GuildStickerBulkCreateRequest), OpenAPI({ operationId: 'bulk_create_guild_stickers', summary: 'Bulk create guild stickers', responseSchema: GuildStickerBulkCreateResponse, statusCode: 200, security: ['botToken', 'bearerToken', 'sessionToken'], tags: ['Guilds'], description: 'Bulk create guild stickers. Requires manage_emojis permission. Creates multiple stickers in a single request for efficiency.', }), async (ctx) => { const user = ctx.get('user'); const guildId = createGuildID(ctx.req.valid('param').guild_id); const {stickers} = ctx.req.valid('json'); const auditLogReason = ctx.get('auditLogReason') ?? null; const result = await ctx .get('guildService') .content.bulkCreateStickers({user, guildId, stickers}, auditLogReason); return ctx.json(result); }, ); app.post( '/guilds/:guild_id/stickers/clone', RateLimitMiddleware(RateLimitConfigs.GUILD_STICKER_CLONE), LoginRequired, Validator('param', GuildIdParam), Validator('json', GuildStickerCloneRequest), OpenAPI({ operationId: 'clone_guild_sticker', summary: 'Clone guild sticker', responseSchema: GuildStickerResponse, statusCode: 200, security: ['botToken', 'bearerToken', 'sessionToken'], tags: ['Guilds'], description: 'Clone an existing sticker into this guild by referencing its id. Copies the source image server-side, so the client does not need to re-upload it. Requires manage_emojis permission in the target guild, and the source guild must permit cloning.', }), async (ctx) => { const user = ctx.get('user'); const guildId = createGuildID(ctx.req.valid('param').guild_id); const {source_sticker_id} = ctx.req.valid('json'); const sourceStickerId = createStickerID(source_sticker_id); const auditLogReason = ctx.get('auditLogReason') ?? null; const sticker = await ctx .get('guildService') .content.cloneSticker({user, guildId, sourceStickerId}, auditLogReason); return ctx.json(sticker); }, ); app.get( '/guilds/:guild_id/stickers', RateLimitMiddleware(RateLimitConfigs.GUILD_STICKERS_LIST), LoginRequired, Validator('param', GuildIdParam), OpenAPI({ operationId: 'list_guild_stickers', summary: 'List guild stickers', responseSchema: GuildStickerWithUserListResponse, statusCode: 200, security: ['botToken', 'bearerToken', 'sessionToken'], tags: ['Guilds'], description: 'List guild stickers. Returns all custom stickers for the guild including metadata about creators, descriptions, and tags.', }), async (ctx) => { const {guild_id} = ctx.req.valid('param'); const userId = ctx.get('user').id; const guildId = createGuildID(guild_id); const requestCache = ctx.get('requestCache'); return ctx.json(await ctx.get('guildService').content.getStickers({userId, guildId, requestCache})); }, ); app.patch( '/guilds/:guild_id/stickers/:sticker_id', RateLimitMiddleware(RateLimitConfigs.GUILD_STICKER_UPDATE), LoginRequired, Validator('param', GuildIdStickerIdParam), Validator('json', GuildStickerUpdateRequest), OpenAPI({ operationId: 'update_guild_sticker', summary: 'Update guild sticker', responseSchema: GuildStickerResponse, statusCode: 200, security: ['botToken', 'bearerToken', 'sessionToken'], tags: ['Guilds'], description: 'Update guild sticker. Requires manage_emojis permission. Updates sticker name, description, or tags.', }), async (ctx) => { const {guild_id, sticker_id} = ctx.req.valid('param'); const userId = ctx.get('user').id; const guildId = createGuildID(guild_id); const stickerId = createStickerID(sticker_id); const {name, description, tags} = ctx.req.valid('json'); const auditLogReason = ctx.get('auditLogReason') ?? null; return ctx.json( await ctx .get('guildService') .content.updateSticker({userId, guildId, stickerId, name, description, tags}, auditLogReason), ); }, ); app.delete( '/guilds/:guild_id/stickers/:sticker_id', RateLimitMiddleware(RateLimitConfigs.GUILD_STICKER_DELETE), LoginRequired, Validator('param', GuildIdStickerIdParam), Validator('query', PurgeQuery), OpenAPI({ operationId: 'delete_guild_sticker', summary: 'Delete guild sticker', responseSchema: null, statusCode: 204, security: ['botToken', 'bearerToken', 'sessionToken'], tags: ['Guilds'], description: 'Delete guild sticker. Requires manage_emojis permission. Removes a sticker from the guild; optionally purges all references.', }), async (ctx) => { const {guild_id, sticker_id} = ctx.req.valid('param'); const userId = ctx.get('user').id; const guildId = createGuildID(guild_id); const stickerId = createStickerID(sticker_id); const auditLogReason = ctx.get('auditLogReason') ?? null; const {purge = false} = ctx.req.valid('query'); await ctx.get('guildService').content.deleteSticker({userId, guildId, stickerId, purge}, auditLogReason); return ctx.body(null, 204); }, ); app.get( '/stickers/:sticker_id/metadata', RateLimitMiddleware(RateLimitConfigs.GUILD_STICKER_METADATA), LoginRequired, Validator('param', StickerIdParam), OpenAPI({ operationId: 'get_sticker_metadata', summary: 'Get sticker metadata', description: 'Lookup minimal metadata for a custom sticker by id, including whether the source guild allows the in-app one-click clone shortcut. Does not require membership in the source guild.', responseSchema: GuildStickerMetadataResponse, statusCode: 200, security: ['botToken', 'bearerToken', 'sessionToken'], tags: ['Stickers'], }), async (ctx) => { const stickerId = createStickerID(ctx.req.valid('param').sticker_id); return ctx.json(await ctx.get('guildService').getStickerMetadata(stickerId)); }, );}