From c0dd5df415ed5e6dce5a0802a64ec42b47f4c583 Mon Sep 17 00:00:00 2001
From: Ebenezer Arthur <arthurebenezer@aol.com>
Date: Sun, 8 Jun 2025 09:36:20 +0000
Subject: [PATCH 1/3] pin tasks

---
 app/components/status-menu.tsx                | 24 ++++++++++-
 app/components/todo-item.tsx                  |  3 ++
 app/lib/send-discord.ts                       | 32 ++++++++++++++-
 app/lib/use-task-pin.ts                       | 41 +++++++++++++++++++
 app/lib/webhook-types.ts                      |  8 ++++
 app/routes/list.tsx                           | 21 ++++++++--
 .../20250608090308_pin_tasks/migration.sql    |  2 +
 prisma/schema.prisma                          |  1 +
 8 files changed, 126 insertions(+), 6 deletions(-)
 create mode 100644 app/lib/use-task-pin.ts
 create mode 100644 prisma/migrations/20250608090308_pin_tasks/migration.sql

diff --git a/app/components/status-menu.tsx b/app/components/status-menu.tsx
index 17cf3fe..09107c7 100644
--- a/app/components/status-menu.tsx
+++ b/app/components/status-menu.tsx
@@ -3,6 +3,7 @@ import clsx from "clsx";
 import React from "react";
 import { statuses } from "~/lib/statuses";
 import { useTaskDelete } from "~/lib/use-task-delete";
+import { useTaskPin } from "~/lib/use-task-pin";
 import { usePopoverContext } from "./popover";
 
 interface StatusMenuProps {
@@ -13,6 +14,7 @@ interface StatusMenuProps {
 export function StatusMenu({ task, onStatusUpdate }: StatusMenuProps) {
 	const [confirmingDelete, setConfirmingDelete] = React.useState(false);
 	const remove = useTaskDelete(task);
+	const pin = useTaskPin(task);
 
 	const popover = usePopoverContext();
 
@@ -36,7 +38,8 @@ export function StatusMenu({ task, onStatusUpdate }: StatusMenuProps) {
 						className={clsx(
 							"flex items-center pl-3 rounded-lg  hover:bg-neutral-200/80 dark:hover:bg-neutral-800/20",
 							{
-								"bg-neutral-200/80 dark:bg-neutral-800/20": s.id === task.status,
+								"bg-neutral-200/80 dark:bg-neutral-800/20":
+									s.id === task.status,
 							},
 						)}
 					>
@@ -59,11 +62,28 @@ export function StatusMenu({ task, onStatusUpdate }: StatusMenuProps) {
 			<div className="font-medium ms-3 px-1.5 text-secondary">Actions</div>
 
 			<ul className="space-y-1 p-1">
+				<li className="font-mono">
+					<button
+						type="button"
+						className="w-full rounded-lg flex gap-2 items-center bg-transparent py-2 px-3 hover:bg-neutral-200/80 dark:hover:bg-neutral-800/20"
+						onClick={() => {
+							pin.mutate();
+							popover.setOpen(false);
+						}}
+					>
+						<div
+							className={
+								task.pinned ? "i-solar-pin-broken" : "i-solar-pin-linear"
+							}
+						/>
+						{task.pinned ? "Unpin" : "Pin"}
+					</button>
+				</li>
 				<li className="font-mono">
 					{confirmingDelete ? (
 						<div className="flex justify-between items-center px-3 py-2 text-red-500 rounded-lg bg-red-100 dark:bg-red-800/10">
 							<span className="flex items-center gap-2">
-								<div className="i-solar-trash-bin-trash-linear " />
+								<div className="i-solar-trash-bin-trash-linear" />
 								Delete?
 							</span>
 							<div className="flex gap-2">
diff --git a/app/components/todo-item.tsx b/app/components/todo-item.tsx
index 7e8aec9..1815a9d 100644
--- a/app/components/todo-item.tsx
+++ b/app/components/todo-item.tsx
@@ -89,6 +89,9 @@ export function TodoItem({ task }: Props) {
 					</div>
 				</div>
 
+				{task.pinned && (
+					<div className="i-solar-pin-circle-broken text-lg text-secondary" />
+				)}
 				<div className="flex gap-3 items-center">
 					<Assignee task={task} />
 
diff --git a/app/lib/send-discord.ts b/app/lib/send-discord.ts
index 73a5ea2..20facc4 100644
--- a/app/lib/send-discord.ts
+++ b/app/lib/send-discord.ts
@@ -83,7 +83,7 @@ async function createWebhookPayload(
 
 	if (project) {
 		embed.footer = {
-			text: `📌 ${project?.name}`,
+			text: `📦 ${project?.name}`,
 		};
 	}
 
@@ -191,6 +191,34 @@ async function createWebhookPayload(
 			break;
 		}
 
+		case "task.pinned": {
+			const { task, user, pinned } = event as WebhookEvent<"task.pinned">;
+			if (!task) break;
+
+			embed.title = pinned ? "📌 Task Pinned" : "📌 Task Unpinned";
+			embed.description = `${task.title} \`#${task.id}\``;
+
+			if (projectUrl) {
+				embed.url = projectUrl;
+			}
+
+			embed.fields = [
+				{
+					name: "Status",
+					value: pinned ? "`Pinned`" : "`Unpinned`",
+					inline: true,
+				},
+			];
+
+			if (user) {
+				embed.author = {
+					name: `@${user.username}`,
+					icon_url: `https://api.dicebear.com/9.x/dylan/png?seed=${encodeURIComponent(user.username)}`,
+				};
+			}
+			break;
+		}
+
 		case "task.assigned": {
 			const { task, user } = event as WebhookEvent<"task.assigned">;
 			if (!task) break;
@@ -294,6 +322,8 @@ function getColorForEvent(eventType: EventType): number {
 			return 0x818cf8;
 		case "task.assigned":
 			return 0xa78bfa;
+		case "task.pinned":
+			return 0xf59e0b;
 		case "task.deleted":
 			return 0xf87171;
 		case "comment.created":
diff --git a/app/lib/use-task-pin.ts b/app/lib/use-task-pin.ts
new file mode 100644
index 0000000..6487b64
--- /dev/null
+++ b/app/lib/use-task-pin.ts
@@ -0,0 +1,41 @@
+import type { Task } from "@prisma/client";
+import { useMutation, useQueryClient } from "@tanstack/react-query";
+import { useRevalidator } from "react-router";
+
+export function useTaskPin(task: Task) {
+    const queryClient = useQueryClient();
+    const { revalidate } = useRevalidator();
+
+    const pin = useMutation({
+        mutationKey: ["pin", task.id],
+        mutationFn: async () => {
+            return await pinTaskRequest({ taskId: task.id, pinned: !task.pinned });
+        },
+        onSuccess: async () => {
+            return await Promise.all([
+                queryClient.invalidateQueries({ queryKey: ["tasks"] }),
+                revalidate(),
+            ]);
+        },
+    });
+
+    return pin;
+}
+
+export async function pinTaskRequest({
+    taskId,
+    pinned,
+}: {
+    taskId: number;
+    pinned: boolean;
+}): Promise<Task> {
+    const res = await fetch("/list", {
+        method: "PATCH",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ taskId, pinned }),
+    });
+
+    const data = await res.json();
+
+    return data.task;
+}
\ No newline at end of file
diff --git a/app/lib/webhook-types.ts b/app/lib/webhook-types.ts
index e38e5a1..24414c2 100644
--- a/app/lib/webhook-types.ts
+++ b/app/lib/webhook-types.ts
@@ -8,6 +8,7 @@ export type EventType =
 	| "task.deleted"
 	| "task.status_changed"
 	| "task.assigned"
+	| "task.pinned"
 	| "comment.created"
 	| "user.joined";
 
@@ -44,6 +45,13 @@ export type WebhookPayload = {
 		projectId: number;
 	};
 
+	"task.pinned": {
+		task: Task & { assignee?: SafeUser };
+		user?: SafeUser;
+		pinned: boolean;
+		projectId: number;
+	};
+
 	"comment.created": {
 		task: Task & { assignee?: SafeUser };
 		user?: SafeUser;
diff --git a/app/routes/list.tsx b/app/routes/list.tsx
index 6330bf6..37c89db 100644
--- a/app/routes/list.tsx
+++ b/app/routes/list.tsx
@@ -46,9 +46,14 @@ export const loader = async ({ request }: LoaderFunctionArgs) => {
 
 	const tasks = await prisma.task.findMany({
 		where,
-		orderBy: {
-			createdAt: "desc",
-		},
+		orderBy: [
+			{
+				pinned: "desc",
+			},
+			{
+				createdAt: "desc",
+			},
+		],
 		include: {
 			_count: { select: { Comment: true } },
 			assignee: { select: { username: true, id: true } },
@@ -117,6 +122,7 @@ export const action = async ({ request }: ActionFunctionArgs) => {
 
 		const previousAssigneeId = previous.assigneeId;
 		const previousStatus = previous.status;
+		const previousPinned = previous.pinned;
 
 		const task = await prisma.task.update({
 			where: { id },
@@ -142,6 +148,15 @@ export const action = async ({ request }: ActionFunctionArgs) => {
 			});
 		}
 
+		if (previousPinned !== updates.pinned) {
+			sendWebhook("task.pinned", {
+				task,
+				user,
+				pinned: updates.pinned,
+				projectId: task.projectId,
+			});
+		}
+
 		if (updates.assigneeId && previousAssigneeId !== updates.assigneeId) {
 			if (updates.assigneeId !== user.id) {
 				// don't notify self
diff --git a/prisma/migrations/20250608090308_pin_tasks/migration.sql b/prisma/migrations/20250608090308_pin_tasks/migration.sql
new file mode 100644
index 0000000..fbd8765
--- /dev/null
+++ b/prisma/migrations/20250608090308_pin_tasks/migration.sql
@@ -0,0 +1,2 @@
+-- AlterTable
+ALTER TABLE "Task" ADD COLUMN     "pinned" BOOLEAN NOT NULL DEFAULT false;
diff --git a/prisma/schema.prisma b/prisma/schema.prisma
index b7ae4b2..891c74d 100644
--- a/prisma/schema.prisma
+++ b/prisma/schema.prisma
@@ -40,6 +40,7 @@ model Task {
   id          Int       @id @default(autoincrement())
   title       String
   status      Status    @default(pending)
+  pinned      Boolean   @default(false)
   author      User      @relation("author", fields: [authorId], references: [id])
   assignee    User      @relation("assignee", fields: [assigneeId], references: [id])
   project     Project   @relation(fields: [projectId], references: [id], onDelete: Cascade)

From 204bb34411c104dc4b58d30543de8a236ede8530 Mon Sep 17 00:00:00 2001
From: Ebenezer Arthur <arthurebenezer@aol.com>
Date: Sun, 8 Jun 2025 09:37:56 +0000
Subject: [PATCH 2/3] update readme

---
 README.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/README.md b/README.md
index 997e180..e646c5d 100644
--- a/README.md
+++ b/README.md
@@ -38,6 +38,7 @@ If a `WEBHOOK_URL` is provided, the endpoint is called with the following events
 | `task.deleted` | Triggered when a task is deleted |
 | `task.status_changed` | Triggered when a task's status changes |
 | `task.assigned` | Triggered when a task is assigned to a user |
+| `task.pinned` | Triggered when a task is pinned or unpinned |
 | `comment.created` | Triggered when a comment is added to a task |
 | `user.joined` | Triggered when a new user joins the system |
 

From 37d317e296eb080c26f249fa3ddd7c3bd4350bbf Mon Sep 17 00:00:00 2001
From: Ebenezer Arthur <arthurebenezer@aol.com>
Date: Mon, 9 Jun 2025 06:21:57 +0000
Subject: [PATCH 3/3] add pinned field

---
 app/routes/list.tsx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/app/routes/list.tsx b/app/routes/list.tsx
index 37c89db..34e9590 100644
--- a/app/routes/list.tsx
+++ b/app/routes/list.tsx
@@ -115,6 +115,7 @@ export const action = async ({ request }: ActionFunctionArgs) => {
 				assigneeId: true,
 				status: true,
 				title: true,
+				pinned: true,
 			},
 		});