feat: incorporate more socials (#6)

### Explanation We can automate the heck out of announcements everywhere. Except LinkedIn, because that API looks agonising. ### Issue _No response_ ### Attestations - [ ] I have read and agree to the [Code of Conduct](https://docs.nhcarrigan.com/community/coc/) - [ ] I have read and agree to the [Community Guidelines](https://docs.nhcarrigan.com/community/guide/). - [ ] My contribution complies with the [Contributor Covenant](https://docs.nhcarrigan.com/dev/covenant/). ### Dependencies - [ ] I have pinned the dependencies to a specific patch version. ### Style - [ ] I have run the linter and resolved any errors. - [ ] My pull request uses an appropriate title, matching the conventional commit standards. - [ ] My scope of feat/fix/chore/etc. correctly matches the nature of changes in my pull request. ### Tests - [ ] My contribution adds new code, and I have added tests to cover it. - [ ] My contribution modifies existing code, and I have updated the tests to reflect these changes. - [ ] All new and existing tests pass locally with my changes. - [ ] Code coverage remains at or above the configured threshold. ### Documentation _No response_ ### Versioning _No response_ Reviewed-on: #6 Co-authored-by: Naomi Carrigan <commits@nhcarrigan.com> Co-committed-by: Naomi Carrigan <commits@nhcarrigan.com>
2025-07-19 18:16:41 -07:00
parent 99bd8c69cd
commit b8b17b72a3
10 changed files with 355 additions and 8 deletions
@@ -0,0 +1,41 @@
+/**
+ * @copyright nhcarrigan
+ * @license Naomi's Public License
+ * @author Naomi Carrigan
+ */
+
+import { TwitterApi } from "twitter-api-v2";
+
+/**
+ * Forwards an announcement to our Twitter account.
+ * @param content - The main body of the announcement.
+ * @returns A message indicating the success or failure of the operation.
+ */
+export const announceOnTwitter = async(content: string): Promise<string> => {
+  if (
+    process.env.TWITTER_CONSUMER_KEY === undefined
+    || process.env.TWITTER_CONSUMER_SECRET === undefined
+    || process.env.TWITTER_TOKEN === undefined
+    || process.env.TWITTER_SECRET === undefined
+  ) {
+    return "Twitter credentials are not set.";
+  }
+  const twitterClient = new TwitterApi({
+    accessSecret: process.env.TWITTER_SECRET,
+    accessToken:  process.env.TWITTER_TOKEN,
+    appKey:       process.env.TWITTER_CONSUMER_KEY,
+    appSecret:    process.env.TWITTER_CONSUMER_SECRET,
+  });
+
+  const result = await twitterClient.v2.
+    tweet(content).
+    catch((error: unknown) => {
+      return error instanceof Error
+        ? error.message
+        : String(error);
+    });
+  if (typeof result === "string") {
+    return `Failed to send message to Twitter. ${result}`;
+  }
+  return "Successfully sent message to Twitter.";
+};