feat: implement submit-word script (#25)

This Pull request implements the `submit-word` script; this script takes
`projectRepoDetails` and `forkedRepoDetails`, more... and the `word` we
intended submit to dictionary; its leverages the github pull request api
and creates a pull request using the changes found on the
`forkedRepoDetails`.

### Changes Made

- Implemented the `submitWord` function in the `submit-word` script;
this function performs the operations creating a pull request to merge
changes from a forked Repo to the main project Repo with the
`projectRepoDetails` and `forkedRepoDetails` params, using the
`userOctokit` instance which must've been pre-authenticated from session
auth token.
- Integrated the `devJargons` app to perform the action of adding the
label `📖 new|edit word` and `💻 via word-editor` to the PR signifying
that the PR was generated from the jargon.dev word-editor.
- Added and integrated a `New word` and `Edit word` PR template into the
`submitWord`; this template added to the `src/lib/templates` dir Exports
2 String i.e. word `title` and `content` which carries placeholders that
are replaced with real `word` data received as params by the
`submitWord` function at point of PR creation via the GitHub rest API.

### Screencast/Screenshot


[screencast-bpconcjcammlapcogcnnelfmaeghhagj-2024.04.08-03_43_46.webm](https://github.com/babblebey/jargons.dev/assets/25631971/c39c0a16-9719-4749-99ad-bf66475d4d33)

📖

Author: babblebey

src/lib/submit-word.js

@@ -0,0 +1,53 @@
+import app from "./octokit/app.js";
+import { getRepoParts } from "./utils/index.js";
+import newWordPRTemp from "./templates/new-word-pr.md.js";
+import editWordPRTemp from "./templates/edit-word-pr.md.js";
+
+/**
+ * Submit word - create a Pull Request to add word to project repository
+ * @param {import("octokit").Octokit} userOctokit 
+ * @param {"new" | "edit"} action 
+ * @param {{ repoFullname: string, repoMainBranchRef: string }} projectRepoDetails 
+ * @param {{ repoFullname: string, repoChangeBranchRef: string }} forkedRepoDetails 
+ * @param {{ title: string, content: string }} word 
+ * 
+ * @todo implement (submit as) `draft` feature - [idea]
+ * @todo implement `maintainer_can_modify` toggle - [idea]
+ */
+export async function submitWord(userOctokit, action, projectRepoDetails, forkedRepoDetails, word) {
+  const { repoFullname, repoMainBranchRef } = projectRepoDetails;
+  const { repoName, repoOwner } = getRepoParts(repoFullname);
+  const { repoOwner: forkedRepoOwner } = getRepoParts(forkedRepoDetails.repoFullname);
+  const baseBranch = repoMainBranchRef.split("/").slice(2).join("/");
+  const headBranch = forkedRepoDetails.repoChangeBranchRef.split("/").slice(2).join("/");
+
+  const title = action === "new" 
+    ? newWordPRTemp.title.replace("$word_title", word.title)
+    : editWordPRTemp.title.replace("$word_title", word.title);
+
+  const body = action === "new"
+    ? newWordPRTemp.content.replace("$word_title", word.title).replace("$word_content", word.content)
+    : editWordPRTemp.content.replace("$word_title", word.title).replace("$word_content", word.content);
+
+  const response = await userOctokit.request("POST /repos/{owner}/{repo}/pulls", {
+    owner: repoOwner,
+    repo: repoName,
+    head: `${forkedRepoOwner}:${headBranch}`,
+    base: baseBranch,
+    title,
+    body
+  });
+
+  // DevJargons (bot) App adds related labels to PR
+  app.devJargonsOctokit.request("POST /repos/{owner}/{repo}/issues/{issue_number}/labels", {
+    owner: repoOwner,
+    repo: repoName,
+    issue_number: response.data.number,
+    labels: [
+      `:book: ${action} word`,
+      ":computer: via word-editor"
+    ]
+  });
+
+  return response.data;
+}

src/lib/templates/edit-word-pr.md.js

@@ -0,0 +1,11 @@
+const title = `Dictionary (Edit Word): $word_title`;
+
+const content = `### Word
+
+#### $word_title
+
+### Updated Meaning/Definition
+
+$word_content`;
+
+export default { title, content };

src/lib/templates/new-word-pr.md.js

@@ -0,0 +1,11 @@
+const title = `Dictionary (New Word): $word_title`;
+
+const content = `### Word
+
+#### $word_title
+
+### Meaning/Definition
+
+$word_content`;
+
+export default { title, content };

src/lib/template/word.md.js src/lib/templates/word.md.jssrc/lib/template/word.md.js renamed to src/lib/templates/word.md.js

@@ -1,5 +1,5 @@
+import wordFileTemplate from "./templates/word.md.js";
 import { getRepoParts, normalizeAsUrl } from "./utils/index.js";
-import wordFileTemplate from "./template/word.md.js";
 
 /**
  * Write and add a new word to user's forked dictionary