8 Commits

Author SHA1 Message Date
hikari 1fa793935f chore: disable message create event handler 2026-03-11 08:55:27 -07:00
hikari f3197245db fix: safely extract first chunk to satisfy noUncheckedIndexedAccess
Node.js CI / CI (pull_request) Successful in 48s
Security Scan and Upload / Security & DefectDojo Upload (pull_request) Successful in 1m14s
2026-03-03 18:03:53 -08:00
hikari 2ebeddd890 fix: remove stale eslint-disable directive in announcement route
Node.js CI / CI (pull_request) Failing after 1m12s
Security Scan and Upload / Security & DefectDojo Upload (pull_request) Successful in 1m37s
2026-03-03 17:59:00 -08:00
hikari c6de6c9591 fix: resolve lint errors across bot, client, and server packages
Node.js CI / CI (pull_request) Failing after 50s
Security Scan and Upload / Security & DefectDojo Upload (pull_request) Successful in 1m42s
2026-03-03 17:56:42 -08:00
hikari d6ad6375b2 chore: add workspace packages to pnpm-workspace.yaml
Node.js CI / CI (pull_request) Failing after 31s
Security Scan and Upload / Security & DefectDojo Upload (pull_request) Successful in 57s
2026-03-03 17:39:16 -08:00
hikari 10a2f3dcd5 fix: make announcement route resilient to platform failures
Node.js CI / CI (pull_request) Failing after 32s
Security Scan and Upload / Security & DefectDojo Upload (pull_request) Successful in 1m53s
 This commit was made with love from Hikari~ 🌸
2026-03-03 17:03:49 -08:00
hikari f25163096b feat: chunk long announcements for Discord, Reddit, and Discourse
 This commit was made with love from Hikari~ 🌸
2026-03-03 16:56:15 -08:00
hikari 4437047543 feat: announce on discourse support forum
 This commit was made with love from Hikari~ 🌸
2026-03-03 16:44:13 -08:00
9 changed files with 1253 additions and 952 deletions
+16 -11
View File
@@ -7,12 +7,15 @@
import { DiscordAnalytics } from "@nhcarrigan/discord-analytics";
import { Client, Events, GatewayIntentBits, Partials } from "discord.js";
import { chatInputInteractionCreate } from "./events/interactionCreate.js";
import {
guildMessageCreate,
directMessageCreate,
} from "./events/messageCreate.js";
import { logger } from "./utils/logger.js";
/*
* Import {
* guildMessageCreate,
* directMessageCreate,
* } from "./events/messageCreate.js";
*/
const hikari = new Client({
intents: [
GatewayIntentBits.Guilds,
@@ -35,13 +38,15 @@ hikari.once(Events.ClientReady, () => {
analytics.startCron();
});
hikari.on(Events.MessageCreate, (message) => {
if (!message.inGuild()) {
void directMessageCreate(hikari, message);
return;
}
void guildMessageCreate(hikari, message);
});
/*
* Hikari.on(Events.MessageCreate, (message) => {
* if (!message.inGuild()) {
* void directMessageCreate(hikari, message);
* return;
* }
* void guildMessageCreate(hikari, message);
* });
*/
hikari.on(Events.InteractionCreate, (interaction) => {
if (interaction.isChatInputCommand()) {
+3
View File
@@ -14,6 +14,9 @@ export default [
"@typescript-eslint/no-empty-function": "off",
"@typescript-eslint/consistent-type-assertions": "off",
"@typescript-eslint/no-extraneous-class": "off",
"@typescript-eslint/no-unsafe-call": "off",
"@typescript-eslint/no-unsafe-assignment": "off",
"@typescript-eslint/no-unsafe-member-access": "off",
"stylistic/no-multi-spaces": "off",
"unicorn/filename-case": "off",
"@typescript-eslint/consistent-type-imports": "off",
+924 -918
View File
File diff suppressed because it is too large Load Diff
+5
View File
@@ -1,3 +1,8 @@
packages:
- bot
- client
- server
# Security
# Do not execute any scripts of installed packages (project scripts still run)
+46 -3
View File
@@ -4,9 +4,15 @@
* @author Naomi Carrigan
*/
/* eslint-disable @typescript-eslint/naming-convention -- we are making raw API calls. */
/* eslint-disable max-lines-per-function -- Chunked sending requires more logic. */
/* eslint-disable max-statements -- Chunked sending requires more statements. */
/* eslint-disable no-await-in-loop -- Sequential chunk posting requires awaiting each request. */
import { chunkContent } from "../utils/chunkContent.js";
import type { AnnouncementType } from "../interfaces/announcementType.js";
const discordLimit = 2000;
const channelIds: Record<AnnouncementType, string> = {
community: "1386105484313886820",
company: "1422472775695728661",
@@ -25,6 +31,7 @@ const getAnnouncementPing = (type: AnnouncementType): string => {
/**
* Forwards an announcement to our Discord server.
* Sends content in sequential messages if it exceeds the 2000 character limit.
* @param title - The title of the announcement.
* @param content - The main body of the announcement.
* @param type - Whether the announcement is for a product or community.
@@ -35,12 +42,23 @@ export const announceOnDiscord = async(
content: string,
type: AnnouncementType,
): Promise<string> => {
const channelId = channelIds[type];
const ping = getAnnouncementPing(type);
const firstMessagePrefix = `# ${title}\n\n`;
const firstMessageSuffix = `\n-# ${ping}`;
const firstChunkLimit
= discordLimit - firstMessagePrefix.length - firstMessageSuffix.length;
const chunks = chunkContent(content, firstChunkLimit);
const firstChunk = chunks[0] ?? "";
const remainingChunks = chunks.slice(1);
const messageRequest = await fetch(
`https://discord.com/api/v10/channels/${channelIds[type]}/messages`,
`https://discord.com/api/v10/channels/${channelId}/messages`,
{
body: JSON.stringify({
allowed_mentions: { parse: [ "users", "roles" ] },
content: `# ${title}\n\n${content}\n-# ${getAnnouncementPing(type)}`,
content: `${firstMessagePrefix}${firstChunk}${firstMessageSuffix}`,
}),
headers: {
"Authorization": `Bot ${process.env.DISCORD_TOKEN ?? ""}`,
@@ -49,16 +67,19 @@ export const announceOnDiscord = async(
method: "POST",
},
);
if (messageRequest.status !== 200) {
return `Failed to send message to Discord. Status: ${messageRequest.status.toString()} ${messageRequest.statusText}`;
}
// eslint-disable-next-line @typescript-eslint/consistent-type-assertions -- fetch does not accept generics.
const message = await messageRequest.json() as { id?: string };
if (message.id === undefined) {
return `Failed to parse message ID, cannot crosspost. ${JSON.stringify(message)}`;
}
const crosspostRequest = await fetch(
`https://discord.com/api/v10/channels/${channelIds[type]}/messages/${message.id}/crosspost`,
`https://discord.com/api/v10/channels/${channelId}/messages/${message.id}/crosspost`,
{
headers: {
"Authorization": `Bot ${process.env.DISCORD_TOKEN ?? ""}`,
@@ -67,8 +88,30 @@ export const announceOnDiscord = async(
method: "POST",
},
);
if (!crosspostRequest.ok) {
return `Failed to crosspost message to Discord. Status: ${crosspostRequest.status.toString()} ${crosspostRequest.statusText}`;
}
for (const chunk of remainingChunks) {
const chunkRequest = await fetch(
`https://discord.com/api/v10/channels/${channelId}/messages`,
{
body: JSON.stringify({
content: chunk,
}),
headers: {
"Authorization": `Bot ${process.env.DISCORD_TOKEN ?? ""}`,
"Content-Type": "application/json",
},
method: "POST",
},
);
if (!chunkRequest.ok) {
return `Failed to send continuation chunk to Discord. Status: ${chunkRequest.status.toString()} ${chunkRequest.statusText}`;
}
}
return "Successfully sent and published message to Discord.";
};
+92
View File
@@ -0,0 +1,92 @@
/**
* @copyright nhcarrigan
* @license Naomi's Public License
* @author Naomi Carrigan
*/
/* eslint-disable @typescript-eslint/naming-convention -- we are making raw API calls. */
/* eslint-disable no-await-in-loop -- Sequential chunk posting requires awaiting each request. */
/* eslint-disable max-lines-per-function -- Chunked posting requires more logic. */
import { chunkContent } from "../utils/chunkContent.js";
import type { AnnouncementType } from "../interfaces/announcementType.js";
const announcementCategoryId = 16;
const discourseLimit = 32_000;
const tags: Record<AnnouncementType, string> = {
community: "Community",
company: "Company",
products: "Products",
};
/**
* Posts an announcement to the NHCarrigan Discourse support forum.
* Sends overflow content as sequential replies if it exceeds the 32,000 character limit.
* @param title - The title of the announcement.
* @param content - The main body of the announcement in markdown.
* @param type - Whether the announcement is for a product, community, or company.
* @returns A message indicating the success or failure of the operation.
*/
export const announceOnDiscourse = async(
title: string,
content: string,
type: AnnouncementType,
): Promise<string> => {
if (process.env.FORUM_API_KEY === undefined) {
return "Discourse API key is not set.";
}
const chunks = chunkContent(content, discourseLimit);
const firstChunk = chunks[0] ?? "";
const remainingChunks = chunks.slice(1);
const response = await fetch("https://support.nhcarrigan.com/posts.json", {
body: JSON.stringify({
category: announcementCategoryId,
raw: firstChunk,
tags: [ tags[type] ],
title: title,
}),
headers: {
"Api-Key": process.env.FORUM_API_KEY,
"Api-Username": "hikari",
"Content-Type": "application/json",
},
method: "POST",
});
if (!response.ok) {
return `Failed to post to Discourse. Status: ${response.status.toString()} ${response.statusText}`;
}
// eslint-disable-next-line @typescript-eslint/consistent-type-assertions -- Fetch does not accept generic.
const data = (await response.json()) as { topic_id?: number };
for (const chunk of remainingChunks) {
if (data.topic_id === undefined) {
return "Failed to retrieve Discourse topic ID for continuation posts.";
}
const replyResponse = await fetch(
"https://support.nhcarrigan.com/posts.json",
{
body: JSON.stringify({
raw: chunk,
topic_id: data.topic_id,
}),
headers: {
"Api-Key": process.env.FORUM_API_KEY,
"Api-Username": "hikari",
"Content-Type": "application/json",
},
method: "POST",
},
);
if (!replyResponse.ok) {
return `Failed to post continuation chunk to Discourse. Status: ${replyResponse.status.toString()} ${replyResponse.statusText}`;
}
}
return "Successfully posted announcement to Discourse~! ✨";
};
+53 -1
View File
@@ -5,9 +5,15 @@
*/
/* eslint-disable @typescript-eslint/naming-convention -- we are making raw API calls. */
/* eslint-disable max-lines-per-function -- Big logic here. */
/* eslint-disable max-statements -- Complex Reddit posting flow with many steps. */
/* eslint-disable complexity -- Chunked reply chaining requires multiple branches. */
/* eslint-disable no-await-in-loop -- Sequential chunk posting requires awaiting each request. */
import { chunkContent } from "../utils/chunkContent.js";
import type { AnnouncementType } from "../interfaces/announcementType.js";
const redditLimit = 40_000;
const flairIds: Record<AnnouncementType, string> = {
community: "7a01a5a6-0f29-11ef-a0c4-c6fb085f7c8f",
company: "dd8057c0-9e30-11f0-b321-d683551dcb2b",
@@ -16,6 +22,7 @@ const flairIds: Record<AnnouncementType, string> = {
/**
* Posts an announcement to a specific subreddit as a self-post.
* Sends overflow content as nested replies if it exceeds the 40,000 character limit.
* @param title - The title of the announcement.
* @param content - The main body of the announcement.
* @param type - Whether the announcement is for a product or community.
@@ -34,6 +41,11 @@ export const announceOnReddit = async(
) {
return "Reddit credentials are not set.";
}
const chunks = chunkContent(content, redditLimit);
const firstChunk = chunks[0] ?? "";
const remainingChunks = chunks.slice(1);
const tokenResponse = await fetch(
"https://www.reddit.com/api/v1/access_token",
{
@@ -71,7 +83,7 @@ export const announceOnReddit = async(
flair_text: type,
kind: "self",
sr: "nhcarrigan",
text: content,
text: firstChunk,
title: title,
}),
headers: {
@@ -85,6 +97,7 @@ export const announceOnReddit = async(
// eslint-disable-next-line @typescript-eslint/consistent-type-assertions -- Fetch does not accept generic.
const redditData = (await redditPost.json()) as {
json: {
data?: { name?: string };
errors: Array<unknown>;
};
};
@@ -95,5 +108,44 @@ export const announceOnReddit = async(
)}`;
}
let parentName = redditData.json.data?.name;
for (const chunk of remainingChunks) {
if (parentName === undefined) {
return "Failed to get Reddit post fullname for chaining replies.";
}
const commentResponse = await fetch(
"https://oauth.reddit.com/api/comment",
{
body: new URLSearchParams({
api_type: "json",
text: chunk,
thing_id: parentName,
}),
headers: {
"Authorization": `bearer ${tokenData.access_token}`,
"Content-Type": "application/x-www-form-urlencoded",
"User-Agent": "HikariBot/1.0 by nhcarrigan",
},
method: "POST",
},
);
// eslint-disable-next-line @typescript-eslint/consistent-type-assertions -- Fetch does not accept generic.
const commentData = (await commentResponse.json()) as {
json: {
data?: { things?: Array<{ data?: { name?: string } }> };
errors: Array<unknown>;
};
};
if (commentData.json.errors.length > 0) {
return `Failed to post reply chunk to Reddit: ${JSON.stringify(commentData.json.errors)}`;
}
parentName = commentData.json.data?.things?.[0]?.data?.name;
}
return "Successfully posted announcement to Reddit~! ✨";
};
+30 -19
View File
@@ -8,6 +8,7 @@ import { blockedIps } from "../cache/blockedIps.js";
import { database } from "../db/database.js";
import { announceOnBluesky } from "../modules/announceOnBluesky.js";
import { announceOnDiscord } from "../modules/announceOnDiscord.js";
import { announceOnDiscourse } from "../modules/announceOnDiscourse.js";
import { announceOnFacebook } from "../modules/announceOnFacebook.js";
import { announceOnMastodon } from "../modules/announceOnMastodon.js";
import { announceOnReddit } from "../modules/announceOnReddit.js";
@@ -20,6 +21,12 @@ import type { FastifyPluginAsync } from "fastify";
const oneDay = 24 * 60 * 60 * 1000;
const getPlatformResult = (result: PromiseSettledResult<string>): string => {
return result.status === "fulfilled"
? result.value
: `Unexpected error: ${String(result.reason)}`;
};
/**
* Mounts the entry routes for the application. These routes
* should not require CORS, as they are used by external services
@@ -53,7 +60,6 @@ export const announcementRoutes: FastifyPluginAsync = async(server) => {
server.post<{ Body: { content: string; type: string } }>(
"/announcement",
// eslint-disable-next-line max-statements -- This is a long function.
async(request, reply) => {
const token = request.headers.authorization;
if (token === undefined || token !== process.env.ANNOUNCEMENT_TOKEN) {
@@ -84,8 +90,8 @@ export const announcementRoutes: FastifyPluginAsync = async(server) => {
const announcement = await generateAnnouncements(content);
if (announcement === null) {
return await reply.status(201).send({
message: `Failed to generate announcements.`,
return await reply.status(500).send({
error: `Failed to generate announcements.`,
});
}
@@ -104,25 +110,30 @@ export const announcementRoutes: FastifyPluginAsync = async(server) => {
},
});
const discordPost = await announceOnDiscord(
markdownTitle,
markdownContent,
type,
);
const redditPost = await announceOnReddit(
markdownTitle,
markdownContent,
type,
);
const blueskyPost = await announceOnBluesky(threaded);
const twitterPost = await announceOnTwitter(threaded);
const facebookPost = await announceOnFacebook(plaintext);
const threadsPost = await announceOnThreads(threaded);
const mastodonPost = await announceOnMastodon(threaded);
const [
discordResult,
redditResult,
blueskyResult,
twitterResult,
facebookResult,
threadsResult,
mastodonResult,
discourseResult,
] = await Promise.allSettled([
announceOnDiscord(markdownTitle, markdownContent, type),
announceOnReddit(markdownTitle, markdownContent, type),
announceOnBluesky(threaded),
announceOnTwitter(threaded),
announceOnFacebook(plaintext),
announceOnThreads(threaded),
announceOnMastodon(threaded),
announceOnDiscourse(markdownTitle, markdownContent, type),
]);
return await reply.status(201).send({
alert: `Please remember to manually post to: LinkedIn, Peerlist, Ko-fi, and Patreon.`,
cost: announcement.cost,
message: `Announcement processed. Discord: ${discordPost}, Reddit: ${redditPost}, Bluesky: ${blueskyPost}, Twitter: ${twitterPost}, Facebook: ${facebookPost}, Threads: ${threadsPost}, Mastodon: ${mastodonPost}`,
message: `Announcement processed. Discord: ${getPlatformResult(discordResult)}, Reddit: ${getPlatformResult(redditResult)}, Bluesky: ${getPlatformResult(blueskyResult)}, Twitter: ${getPlatformResult(twitterResult)}, Facebook: ${getPlatformResult(facebookResult)}, Threads: ${getPlatformResult(threadsResult)}, Mastodon: ${getPlatformResult(mastodonResult)}, Discourse: ${getPlatformResult(discourseResult)}`,
rawPost: announcement.response,
});
},
+84
View File
@@ -0,0 +1,84 @@
/**
* @copyright nhcarrigan
* @license Naomi's Public License
* @author Naomi Carrigan
*/
/* eslint-disable max-lines-per-function -- Multi-level split logic requires many lines. */
/* eslint-disable max-statements -- Multi-level split logic requires many statements. */
/* eslint-disable complexity -- Multi-level split logic has inherent branching complexity. */
/**
* Splits content into chunks that do not exceed the given character limit.
* Splits preferably at paragraph boundaries, then line boundaries,
* then hard-cuts at the limit as a last resort.
* @param content - The content to chunk.
* @param limit - The maximum character count per chunk.
* @returns An array of content chunks.
*/
export const chunkContent = (content: string, limit: number): Array<string> => {
if (content.length <= limit) {
return [ content ];
}
const chunks: Array<string> = [];
const paragraphs = content.split("\n\n");
let current = "";
for (const paragraph of paragraphs) {
const separator = current.length > 0
? "\n\n"
: "";
const combined = `${current}${separator}${paragraph}`;
if (combined.length <= limit) {
current = combined;
continue;
}
if (current.length > 0) {
chunks.push(current);
current = "";
}
if (paragraph.length <= limit) {
current = paragraph;
continue;
}
// Paragraph itself exceeds the limit — split by lines
const lines = paragraph.split("\n");
for (const line of lines) {
const lineSeparator = current.length > 0
? "\n"
: "";
const combinedLine = `${current}${lineSeparator}${line}`;
if (combinedLine.length <= limit) {
current = combinedLine;
continue;
}
if (current.length > 0) {
chunks.push(current);
current = "";
}
if (line.length <= limit) {
current = line;
continue;
}
// Single line exceeds limit — hard-cut
for (let index = 0; index < line.length; index = index + limit) {
chunks.push(line.slice(index, index + limit));
}
}
}
if (current.length > 0) {
chunks.push(current);
}
return chunks;
};