feat: setup actions (#1)

### Explanation

_No response_

### 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: #1
Co-authored-by: Naomi Carrigan <commits@nhcarrigan.com>
Co-committed-by: Naomi Carrigan <commits@nhcarrigan.com>

src/lib/posts.ts

@@ -10,49 +10,71 @@ import matter from "gray-matter";
 
 const postsDirectory = join(process.cwd(), "posts");
 
-export const getSortedPostsData = () => {
+/**
+ * Reads the posts directory and returns an array of post data.
+ * @returns An array of parsed frontmatter and file contents.
+ */
+const getSortedPostsData = (): Array<{
+  content: string;
+  data:    { date: Date; summary: string; title: string };
+  slug:    string;
+}> => {
   const fileNames = readdirSync(postsDirectory);
   const allPostsData = fileNames.map((fileName) => {
     const slug = fileName.replace(/\.md$/, "");
     const fullPath = join(postsDirectory, fileName);
     const fileContents = readFileSync(fullPath, "utf8");
+    // eslint-disable-next-line @typescript-eslint/consistent-type-assertions -- matter doesn't take a generic I guess?
     const matterResult = matter(fileContents) as unknown as {
       content: string;
-      data: { title: string; date: string; summary: string };
+      data:    { title: string; date: string; summary: string };
     };
     return {
-      slug: slug,
-      data: {
-        title: matterResult.data.title,
-        date: new Date(matterResult.data.date),
-        summary: matterResult.data.summary,
-      },
       content: matterResult.content,
+      data:    {
+        date:    new Date(matterResult.data.date),
+        summary: matterResult.data.summary,
+        title:   matterResult.data.title,
+      },
+      slug: slug,
     };
   });
   return allPostsData.sort((a, b) => {
     if (a.data.date < b.data.date) {
       return 1;
-    } else {
-      return -1;
     }
+    return -1;
   });
 };
 
-export const getPostData = (slug: string) => {
-    const fullPath = join(postsDirectory, slug + ".md");
-    const fileContents = readFileSync(fullPath, "utf8");
-    const matterResult = matter(fileContents) as unknown as {
-        content: string;
-        data: { title: string; date: string; summary: string };
-      };
-      return {
-        slug: slug,
-        data: {
-          title: matterResult.data.title,
-          date: new Date(matterResult.data.date),
-          summary: matterResult.data.summary,
-        },
-        content: matterResult.content,
-      };
-}
+/**
+ * Reads a single post file.
+ * @param slug - The slug of the post to read.
+ * @returns The parsed frontmatter and file contents.
+ */
+const getPostData = (
+  slug: string,
+): {
+  content: string;
+  data:    { date: Date; summary: string; title: string };
+  slug:    string;
+} => {
+  const fullPath = join(postsDirectory, `${slug}.md`);
+  const fileContents = readFileSync(fullPath, "utf8");
+  // eslint-disable-next-line @typescript-eslint/consistent-type-assertions -- matter doesn't take a generic I guess?
+  const matterResult = matter(fileContents) as unknown as {
+    content: string;
+    data:    { title: string; date: string; summary: string };
+  };
+  return {
+    content: matterResult.content,
+    data:    {
+      date:    new Date(matterResult.data.date),
+      summary: matterResult.data.summary,
+      title:   matterResult.data.title,
+    },
+    slug: slug,
+  };
+};
+
+export { getSortedPostsData, getPostData };