— Add a field to embed (admin)\n * /template remove-field

— Remove a field (admin)\n * /template allow-role — Grant role send permission (admin)\n * /template deny-role — Revoke role send permission (admin)\n * /template allow-user — Grant user send permission (admin)\n * /template deny-user — Revoke user send permission (admin)\n * /template preview — Show embed privately (anyone)\n * /template send [channel] — Post embed to channel (role/user-gated)\n * /template list — Show all templates (anyone)\n * /template delete — Remove a template (admin)\n *\n * File: discord/interactions/commands/template.ts\n */\n\nimport { defineCommand, OptionTypes } from \"../define-command.ts\";\nimport { EmbedColors, isGuildAdmin } from \"../../constants.ts\";\nimport { blob } from \"../../persistence/blob.ts\";\nimport { discordBotFetch } from \"../../discord-api.ts\";\nimport { createAutocompleteResponse } from \"../patterns.ts\";\nimport { ExpiringCache } from \"../../helpers/cache.ts\";\nimport { checkEntityAccess, blobAllow, blobDeny } from \"../../helpers/permissions.ts\";\nimport { formatPermissionInfo } from \"../../helpers/format.ts\";\n\nexport interface TemplateEntry {\n title: string;\n description: string;\n color?: number;\n footer?: string;\n imageUrl?: string;\n fields?: Array<{ name: string; value: string; inline?: boolean }>;\n allowedRoles?: string[];\n allowedUsers?: string[];\n createdBy: string;\n createdAt: string;\n updatedAt: string;\n}\n\nconst MAX_TEMPLATES = 25;\nconst MAX_NAME_LENGTH = 32;\n\nfunction blobKey(guildId: string, name: string): string {\n return `template:${guildId}:${name}`;\n}\n\nfunction blobPrefix(guildId: string): string {\n return `template:${guildId}:`;\n}\n\n/** Sanitize name: lowercase, alphanumeric + hyphens, max 32 chars. */\nfunction sanitizeName(raw: string): string {\n return raw.toLowerCase().replace(/[^a-z0-9-]/g, \"\").slice(0, MAX_NAME_LENGTH);\n}\n\ninterface TemplateListItem {\n name: string;\n entry: TemplateEntry;\n}\n\nasync function listTemplates(guildId: string): Promise {\n const prefix = blobPrefix(guildId);\n const entries = await blob.list(prefix);\n const items: TemplateListItem[] = [];\n for (const e of entries) {\n const name = e.key.slice(prefix.length);\n const entry = await blob.getJSON(e.key);\n if (entry) items.push({ name, entry });\n }\n return items;\n}\n\nconst listCache = new ExpiringCache(30_000, 500);\n\nfunction invalidateCache(guildId: string): void {\n listCache.delete(blobPrefix(guildId));\n}\n\n/** Check if user has permission to send a template. Closed by default (admin-only when no restrictions). */\nasync function canSend(\n entry: TemplateEntry,\n guildId: string,\n userId: string,\n memberRoles: string[],\n memberPermissions?: string,\n): Promise {\n return checkEntityAccess(entry, guildId, userId, memberRoles, memberPermissions, { defaultOpen: false });\n}\n\nexport const _internals = { sanitizeName, blobKey, blobPrefix, canSend };\n\nexport default defineCommand({\n name: \"template\",\n description: \"Build and post reusable embed templates\",\n\n options: [\n {\n name: \"create\",\n description: \"Create a new embed template (admin)\",\n type: OptionTypes.SUB_COMMAND,\n required: false,\n options: [\n {\n name: \"name\",\n description: \"Template name (lowercase, alphanumeric + hyphens)\",\n type: OptionTypes.STRING,\n required: true,\n min_length: 1,\n max_length: MAX_NAME_LENGTH,\n },\n ],\n },\n {\n name: \"edit\",\n description: \"Edit an existing template (admin)\",\n type: OptionTypes.SUB_COMMAND,\n required: false,\n options: [\n {\n name: \"name\",\n description: \"Template name\",\n type: OptionTypes.STRING,\n required: true,\n autocomplete: true,\n },\n ],\n },\n {\n name: \"add-field\",\n description: \"Add a field to a template (admin)\",\n type: OptionTypes.SUB_COMMAND,\n required: false,\n options: [\n {\n name: \"name\",\n description: \"Template name\",\n type: OptionTypes.STRING,\n required: true,\n autocomplete: true,\n },\n {\n name: \"field-name\",\n description: \"Field title\",\n type: OptionTypes.STRING,\n required: true,\n max_length: 256,\n },\n {\n name: \"field-value\",\n description: \"Field content\",\n type: OptionTypes.STRING,\n required: true,\n max_length: 1024,\n },\n {\n name: \"inline\",\n description: \"Display field inline (default: false)\",\n type: OptionTypes.BOOLEAN,\n required: false,\n },\n ],\n },\n {\n name: \"remove-field\",\n description: \"Remove a field from a template (admin)\",\n type: OptionTypes.SUB_COMMAND,\n required: false,\n options: [\n {\n name: \"name\",\n description: \"Template name\",\n type: OptionTypes.STRING,\n required: true,\n autocomplete: true,\n },\n {\n name: \"field-name\",\n description: \"Field title to remove\",\n type: OptionTypes.STRING,\n required: true,\n },\n ],\n },\n {\n name: \"allow-role\",\n description: \"Grant a role permission to send this template (admin)\",\n type: OptionTypes.SUB_COMMAND,\n required: false,\n options: [\n {\n name: \"name\",\n description: \"Template name\",\n type: OptionTypes.STRING,\n required: true,\n autocomplete: true,\n },\n {\n name: \"role\",\n description: \"Role to allow\",\n type: OptionTypes.ROLE,\n required: true,\n },\n ],\n },\n {\n name: \"deny-role\",\n description: \"Revoke a role's send permission (admin)\",\n type: OptionTypes.SUB_COMMAND,\n required: false,\n options: [\n {\n name: \"name\",\n description: \"Template name\",\n type: OptionTypes.STRING,\n required: true,\n autocomplete: true,\n },\n {\n name: \"role\",\n description: \"Role to deny\",\n type: OptionTypes.ROLE,\n required: true,\n },\n ],\n },\n {\n name: \"allow-user\",\n description: \"Grant a user permission to send this template (admin)\",\n type: OptionTypes.SUB_COMMAND,\n required: false,\n options: [\n {\n name: \"name\",\n description: \"Template name\",\n type: OptionTypes.STRING,\n required: true,\n autocomplete: true,\n },\n {\n name: \"user\",\n description: \"User to allow\",\n type: OptionTypes.USER,\n required: true,\n },\n ],\n },\n {\n name: \"deny-user\",\n description: \"Revoke a user's send permission (admin)\",\n type: OptionTypes.SUB_COMMAND,\n required: false,\n options: [\n {\n name: \"name\",\n description: \"Template name\",\n type: OptionTypes.STRING,\n required: true,\n autocomplete: true,\n },\n {\n name: \"user\",\n description: \"User to deny\",\n type: OptionTypes.USER,\n required: true,\n },\n ],\n },\n {\n name: \"preview\",\n description: \"Preview an embed template privately\",\n type: OptionTypes.SUB_COMMAND,\n required: false,\n options: [\n {\n name: \"name\",\n description: \"Template name\",\n type: OptionTypes.STRING,\n required: true,\n autocomplete: true,\n },\n ],\n },\n {\n name: \"send\",\n description: \"Post an embed template to a channel\",\n type: OptionTypes.SUB_COMMAND,\n required: false,\n options: [\n {\n name: \"name\",\n description: \"Template name\",\n type: OptionTypes.STRING,\n required: true,\n autocomplete: true,\n },\n {\n name: \"channel\",\n description: \"Target channel (admin only, defaults to current)\",\n type: OptionTypes.CHANNEL,\n required: false,\n },\n ],\n },\n {\n name: \"list\",\n description: \"Show all templates\",\n type: OptionTypes.SUB_COMMAND,\n required: false,\n },\n {\n name: \"delete\",\n description: \"Remove a template (admin)\",\n type: OptionTypes.SUB_COMMAND,\n required: false,\n options: [\n {\n name: \"name\",\n description: \"Template name\",\n type: OptionTypes.STRING,\n required: true,\n autocomplete: true,\n },\n ],\n },\n ],\n\n registration: { type: \"guild\" },\n deferred: false,\n ephemeral: true,\n\n autocomplete(body, _config) {\n const guildId = body.guild_id;\n const options = body.data.options?.[0];\n const focused = options?.options?.find((o: any) => o.focused);\n const query = (focused?.value as string || \"\").toLowerCase();\n\n return (async () => {\n const items = await listCache.getOrFetch(blobPrefix(guildId), () => listTemplates(guildId));\n const filtered = query ? items.filter((i) => i.name.includes(query)) : items;\n return createAutocompleteResponse(\n filtered.map((i) => ({ name: i.name, value: i.name })),\n );\n })();\n },\n\n async execute({ guildId, userId, options, memberRoles, memberPermissions }) {\n const sub = options?.subcommand as string | undefined;\n const roles = memberRoles ?? [];\n\n if (sub === \"create\") {\n if (!(await isGuildAdmin(guildId, userId, roles, memberPermissions))) {\n return { success: false, error: \"You need admin permissions to create templates.\" };\n }\n\n const name = sanitizeName(options.name as string);\n if (!name) {\n return { success: false, error: \"Invalid name. Use lowercase letters, numbers, and hyphens.\" };\n }\n\n const existing = await blob.getJSON(blobKey(guildId, name));\n if (existing) {\n return { success: false, error: `Template \\`${name}\\` already exists. Use \\`/template edit\\` to modify it.` };\n }\n\n // Check limit\n const all = await blob.list(blobPrefix(guildId));\n if (all.length >= MAX_TEMPLATES) {\n return { success: false, error: `Maximum of ${MAX_TEMPLATES} templates reached.` };\n }\n\n return {\n success: true,\n modal: {\n title: `Create Template: ${name.slice(0, 20)}`,\n custom_id: `template-modal:create:${guildId}:${name}`,\n components: buildModalComponents(),\n },\n };\n }\n\n if (sub === \"edit\") {\n if (!(await isGuildAdmin(guildId, userId, roles, memberPermissions))) {\n return { success: false, error: \"You need admin permissions to edit templates.\" };\n }\n\n const name = sanitizeName(options.name as string);\n const entry = await blob.getJSON(blobKey(guildId, name));\n if (!entry) {\n return { success: false, error: `Template \\`${name}\\` not found.` };\n }\n\n return {\n success: true,\n modal: {\n title: `Edit Template: ${name.slice(0, 22)}`,\n custom_id: `template-modal:edit:${guildId}:${name}`,\n components: buildModalComponents(entry),\n },\n };\n }\n\n if (sub === \"add-field\") {\n if (!(await isGuildAdmin(guildId, userId, roles, memberPermissions))) {\n return { success: false, error: \"You need admin permissions to modify templates.\" };\n }\n\n const name = sanitizeName(options.name as string);\n const fieldName = options[\"field-name\"] as string;\n const fieldValue = options[\"field-value\"] as string;\n const inline = (options.inline as boolean) ?? false;\n\n const entry = await blob.getJSON(blobKey(guildId, name));\n if (!entry) {\n return { success: false, error: `Template \\`${name}\\` not found.` };\n }\n\n entry.fields = entry.fields ?? [];\n if (entry.fields.length >= 25) {\n return { success: false, error: \"Maximum of 25 fields per embed.\" };\n }\n\n entry.fields.push({ name: fieldName, value: fieldValue, inline });\n entry.updatedAt = new Date().toISOString();\n\n await blob.setJSON(blobKey(guildId, name), entry);\n invalidateCache(guildId);\n\n return { success: true, message: `Field \\`${fieldName}\\` added to template \\`${name}\\`.` };\n }\n\n if (sub === \"remove-field\") {\n if (!(await isGuildAdmin(guildId, userId, roles, memberPermissions))) {\n return { success: false, error: \"You need admin permissions to modify templates.\" };\n }\n\n const name = sanitizeName(options.name as string);\n const fieldName = options[\"field-name\"] as string;\n\n const entry = await blob.getJSON(blobKey(guildId, name));\n if (!entry) {\n return { success: false, error: `Template \\`${name}\\` not found.` };\n }\n\n const before = entry.fields?.length ?? 0;\n entry.fields = (entry.fields ?? []).filter((f) => f.name !== fieldName);\n if (entry.fields.length === before) {\n return { success: false, error: `Field \\`${fieldName}\\` not found in template \\`${name}\\`.` };\n }\n\n entry.updatedAt = new Date().toISOString();\n await blob.setJSON(blobKey(guildId, name), entry);\n invalidateCache(guildId);\n\n return { success: true, message: `Field \\`${fieldName}\\` removed from template \\`${name}\\`.` };\n }\n\n if (sub === \"allow-role\" || sub === \"deny-role\" || sub === \"allow-user\" || sub === \"deny-user\") {\n const name = sanitizeName(options.name as string);\n const isRole = sub.endsWith(\"-role\");\n const isAllow = sub.startsWith(\"allow\");\n const targetId = isRole ? (options.role as string) : (options.user as string);\n const handler = isAllow ? blobAllow : blobDeny;\n\n return handler({\n guildId, userId, memberRoles: roles, memberPermissions,\n entityName: name, entityLabel: \"template\", verb: \"send\",\n targetId, targetType: isRole ? \"role\" : \"user\",\n getEntry: () => blob.getJSON(blobKey(guildId, name)),\n saveEntry: async (e) => {\n (e as TemplateEntry).updatedAt = new Date().toISOString();\n await blob.setJSON(blobKey(guildId, name), e);\n },\n invalidateCache: () => invalidateCache(guildId),\n });\n }\n\n if (sub === \"preview\") {\n const name = sanitizeName(options.name as string);\n const entry = await blob.getJSON(blobKey(guildId, name));\n if (!entry) {\n return { success: false, error: `Template \\`${name}\\` not found.` };\n }\n\n return {\n success: true,\n message: \"\",\n embed: buildEmbed(entry),\n };\n }\n\n if (sub === \"send\") {\n const name = sanitizeName(options.name as string);\n const entry = await blob.getJSON(blobKey(guildId, name));\n if (!entry) {\n return { success: false, error: `Template \\`${name}\\` not found.` };\n }\n\n if (!(await canSend(entry, guildId, userId, roles, memberPermissions))) {\n return { success: false, error: \"You don't have permission to send this template.\" };\n }\n\n const isAdmin = await isGuildAdmin(guildId, userId, roles, memberPermissions);\n const channelId = (isAdmin && options.channel) ? (options.channel as string) : (options.channelId as string);\n\n const result = await discordBotFetch(\"POST\", `channels/${channelId}/messages`, {\n embeds: [buildEmbed(entry)],\n });\n\n if (!result.ok) {\n return { success: false, error: `Failed to send embed: ${result.error}` };\n }\n\n return { success: true, message: `Template **${name}** sent to <#${channelId}>.` };\n }\n\n if (sub === \"list\") {\n const items = await listTemplates(guildId);\n\n if (items.length === 0) {\n return { success: true, message: \"No templates found. Use `/template create` to create one.\" };\n }\n\n const lines = items.map((i) => {\n return `\\`${i.name}\\` — ${i.entry.title}${formatPermissionInfo(i.entry, \"admin-only\")}`;\n });\n\n return {\n success: true,\n message: \"\",\n embed: {\n title: \"Embed Templates\",\n description: lines.join(\"\\n\"),\n color: EmbedColors.INFO,\n footer: { text: `${items.length}/${MAX_TEMPLATES} templates` },\n },\n };\n }\n\n if (sub === \"delete\") {\n if (!(await isGuildAdmin(guildId, userId, roles, memberPermissions))) {\n return { success: false, error: \"You need admin permissions to delete templates.\" };\n }\n\n const name = sanitizeName(options.name as string);\n const entry = await blob.getJSON(blobKey(guildId, name));\n if (!entry) {\n return { success: false, error: `Template \\`${name}\\` not found.` };\n }\n\n await blob.delete(blobKey(guildId, name));\n invalidateCache(guildId);\n\n return { success: true, message: `Template \\`${name}\\` deleted.` };\n }\n\n return { success: false, error: \"Please use a subcommand.\" };\n },\n});\n\n/** Build the 5-field modal for create/edit. */\nfunction buildModalComponents(existing?: TemplateEntry): any[] {\n return [\n {\n type: 1,\n components: [{\n type: 4,\n custom_id: \"template_title\",\n label: \"Title\",\n style: 1,\n required: true,\n max_length: 256,\n value: existing?.title,\n }],\n },\n {\n type: 1,\n components: [{\n type: 4,\n custom_id: \"template_description\",\n label: \"Description\",\n style: 2,\n required: true,\n max_length: 4000,\n value: existing?.description,\n }],\n },\n {\n type: 1,\n components: [{\n type: 4,\n custom_id: \"template_color\",\n label: \"Color\",\n style: 1,\n required: false,\n placeholder: \"#5865f2\",\n value: existing?.color !== undefined ? `#${existing.color.toString(16).padStart(6, \"0\")}` : undefined,\n }],\n },\n {\n type: 1,\n components: [{\n type: 4,\n custom_id: \"template_footer\",\n label: \"Footer\",\n style: 1,\n required: false,\n max_length: 2048,\n value: existing?.footer,\n }],\n },\n {\n type: 1,\n components: [{\n type: 4,\n custom_id: \"template_image_url\",\n label: \"Image URL\",\n style: 1,\n required: false,\n value: existing?.imageUrl,\n }],\n },\n ];\n}\n\n/** Build a Discord embed from a template entry. */\nfunction buildEmbed(entry: TemplateEntry): Record {\n const embed: Record = {\n title: entry.title,\n description: entry.description,\n };\n if (entry.color !== undefined) embed.color = entry.color;\n if (entry.footer) embed.footer = { text: entry.footer };\n if (entry.imageUrl) embed.image = { url: entry.imageUrl };\n if (entry.fields?.length) embed.fields = entry.fields;\n return embed;\n}\n","deleted","label",[183,184,185,165],"discord","interactions","commands","permalink","https://www.val.town/x/catalloc/catnip/code/discord/interactions/commands/template.ts","extension","actionData","errors"]