-
-
+
-
-
-
-
-
- The app stores Pvium OAuth access and refresh tokens on the GitHub
- user link so future merged PRs for the same contributor can create
- rewards without asking the contributor to authorize again. Treat these
- OAuth tokens as secrets; production deployments should encrypt them at
- rest and restrict database access.
-
-
+
);
}
-function Section({ title, children }: { title: string; children: ReactNode }) {
- return (
-
- );
-}
-
-function Endpoint({ label, value }: { label: string; value: string }) {
- return (
-
- {label}
- {value}
-
- );
-}
-
-function ListBlock({ title, items }: { title: string; items: string[] }) {
- return (
-
-
{title}
-
-
- );
-}
-
-function BulletList({ items }: { items: string[] }) {
- return (
-
- {items.map((item) => (
- -
- {item}
-
- ))}
-
- );
-}
-
-function NumberedList({ items }: { items: string[] }) {
- return (
-
- {items.map((item) => (
- -
- {item}
-
- ))}
-
- );
-}
-
-function CodeBlock({ value }: { value: string }) {
- return
{value};
+function formatDate(value: Date) {
+ return new Intl.DateTimeFormat("en", {
+ month: "short",
+ day: "numeric",
+ year: "numeric",
+ }).format(value);
}
const styles: Record
= {
page: {
minHeight: "100vh",
margin: 0,
- padding: "48px 20px",
+ padding: "40px 20px",
background: "#f7f8fb",
color: "#172033",
fontFamily:
'Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif',
},
hero: {
- maxWidth: 980,
+ maxWidth: 1080,
margin: "0 auto 24px",
- padding: "32px 0 8px",
},
- brandRow: {
+ nav: {
display: "flex",
- alignItems: "center",
- justifyContent: "space-between",
+ justifyContent: "flex-end",
gap: 12,
- marginBottom: 18,
- },
- topLinks: {
- display: "flex",
- alignItems: "center",
- flexWrap: "wrap",
- gap: 10,
- },
- logo: {
- width: 96,
- height: 96,
- borderRadius: 8,
- objectFit: "contain",
- },
- logoLink: {
- display: "inline-flex",
- lineHeight: 0,
+ marginBottom: 34,
},
- poweredBy: {
+ deployLink: {
display: "inline-flex",
alignItems: "center",
- padding: "9px 13px",
+ padding: "10px 14px",
border: "1px solid #c8d0df",
- borderRadius: 999,
+ borderRadius: 8,
background: "#ffffff",
color: "#172033",
fontSize: 14,
- fontWeight: 600,
+ fontWeight: 700,
textDecoration: "none",
},
installLink: {
@@ -360,107 +168,139 @@ const styles: Record = {
textDecoration: "none",
},
eyebrow: {
- margin: "0 0 12px",
+ margin: "0 0 10px",
color: "#52627a",
fontSize: 14,
fontWeight: 700,
textTransform: "uppercase",
},
title: {
- maxWidth: 820,
- margin: "0 0 18px",
+ maxWidth: 760,
+ margin: "0 0 16px",
fontSize: 48,
lineHeight: 1.08,
letterSpacing: 0,
},
lede: {
maxWidth: 760,
- margin: "0 0 24px",
+ margin: 0,
color: "#46556e",
fontSize: 18,
lineHeight: 1.65,
},
- endpointGrid: {
- display: "grid",
- gridTemplateColumns: "repeat(auto-fit, minmax(230px, 1fr))",
- gap: 12,
- maxWidth: 920,
- },
- endpoint: {
+ panel: {
+ maxWidth: 1080,
+ margin: "0 auto",
+ padding: 24,
border: "1px solid #d9deea",
borderRadius: 8,
background: "#ffffff",
- padding: 16,
},
- endpointLabel: {
- display: "block",
- marginBottom: 8,
- color: "#66748a",
+ controls: {
+ display: "grid",
+ gridTemplateColumns: "repeat(auto-fit, minmax(180px, 1fr)) auto",
+ alignItems: "end",
+ gap: 12,
+ },
+ control: {
+ display: "grid",
+ gap: 6,
+ },
+ label: {
+ color: "#52627a",
fontSize: 13,
fontWeight: 700,
},
- endpointCode: {
+ select: {
+ height: 42,
+ border: "1px solid #c8d0df",
+ borderRadius: 8,
+ background: "#ffffff",
color: "#172033",
+ padding: "0 10px",
fontSize: 14,
- wordBreak: "break-word",
},
- section: {
- maxWidth: 980,
- margin: "18px auto",
- padding: 24,
- border: "1px solid #d9deea",
+ input: {
+ height: 40,
+ border: "1px solid #c8d0df",
borderRadius: 8,
- background: "#ffffff",
+ color: "#172033",
+ padding: "0 10px",
+ fontSize: 14,
},
- sectionTitle: {
- margin: "0 0 16px",
- fontSize: 24,
- letterSpacing: 0,
+ button: {
+ height: 42,
+ border: 0,
+ borderRadius: 8,
+ background: "#172033",
+ color: "#ffffff",
+ padding: "0 18px",
+ fontSize: 14,
+ fontWeight: 700,
+ cursor: "pointer",
},
- paragraph: {
- margin: "0 0 14px",
- color: "#46556e",
- fontSize: 15,
- lineHeight: 1.7,
+ summary: {
+ margin: "20px 0 12px",
+ color: "#52627a",
+ fontSize: 14,
+ fontWeight: 700,
},
- columns: {
+ issueList: {
display: "grid",
- gridTemplateColumns: "repeat(auto-fit, minmax(250px, 1fr))",
- gap: 18,
+ gap: 12,
},
- listBlock: {
- minWidth: 0,
+ card: {
+ display: "block",
+ border: "1px solid #d9deea",
+ borderRadius: 8,
+ padding: 18,
+ color: "inherit",
+ textDecoration: "none",
},
- listTitle: {
- margin: "0 0 10px",
- color: "#263247",
- fontSize: 16,
+ cardHeader: {
+ display: "flex",
+ alignItems: "center",
+ justifyContent: "space-between",
+ gap: 12,
+ marginBottom: 10,
},
- list: {
- margin: 0,
- paddingLeft: 22,
- color: "#46556e",
- fontSize: 15,
- lineHeight: 1.7,
+ repo: {
+ color: "#52627a",
+ fontSize: 13,
+ fontWeight: 700,
},
- listItem: {
- marginBottom: 8,
+ amount: {
+ borderRadius: 999,
+ background: "#e8f6ef",
+ color: "#11633d",
+ padding: "5px 9px",
+ fontSize: 13,
+ fontWeight: 800,
},
- codeBlock: {
- margin: "14px 0 0",
- padding: 16,
- overflowX: "auto",
- borderRadius: 8,
- background: "#141925",
- color: "#eef3ff",
+ issueTitle: {
+ margin: "0 0 8px",
+ fontSize: 20,
+ lineHeight: 1.3,
+ letterSpacing: 0,
+ },
+ excerpt: {
+ margin: "0 0 12px",
+ color: "#46556e",
+ fontSize: 14,
+ lineHeight: 1.55,
+ },
+ meta: {
+ display: "flex",
+ flexWrap: "wrap",
+ gap: 10,
+ color: "#66748a",
fontSize: 13,
- lineHeight: 1.6,
},
- inlineCode: {
- padding: "2px 5px",
- borderRadius: 5,
- background: "#eef1f6",
- color: "#263247",
- fontSize: "0.92em",
+ empty: {
+ border: "1px dashed #c8d0df",
+ borderRadius: 8,
+ color: "#52627a",
+ padding: 24,
+ textAlign: "center",
},
};
diff --git a/src/lib/github/webhook-handler.ts b/src/lib/github/webhook-handler.ts
index 46a7c5e..21e1150 100644
--- a/src/lib/github/webhook-handler.ts
+++ b/src/lib/github/webhook-handler.ts
@@ -122,11 +122,13 @@ async function handleIssueLabeled(payload: GithubWebhookPayload) {
amount: parsed.amount,
currency: parsed.currency,
status: "OPEN",
+ ...getIssueDiscoveryFields(payload.issue),
},
create: {
repositoryId: repository.id,
issueNumber: payload.issue.number,
issueNodeId: payload.issue.node_id,
+ ...getIssueDiscoveryFields(payload.issue),
labelName: parsed.raw,
amount: parsed.amount,
currency: parsed.currency,
@@ -156,6 +158,28 @@ async function handleIssueLabeled(payload: GithubWebhookPayload) {
return { bountyId: bounty.id };
}
+function getIssueDiscoveryFields(issue: any) {
+ return {
+ issueTitle: issue?.title ?? null,
+ issueUrl: issue?.html_url ?? null,
+ issueState: issue?.state ?? null,
+ issueExcerpt: summarizeIssueBody(issue?.body),
+ issueCreatedAt: issue?.created_at ? new Date(issue.created_at) : null,
+ issueUpdatedAt: issue?.updated_at ? new Date(issue.updated_at) : null,
+ };
+}
+
+function summarizeIssueBody(body: unknown) {
+ if (typeof body !== "string") return null;
+ const summary = body
+ .replace(/```[\s\S]*?```/g, " ")
+ .replace(/<[^>]+>/g, " ")
+ .replace(/\s+/g, " ")
+ .trim();
+
+ return summary ? summary.slice(0, 220) : null;
+}
+
async function handlePullRequestClosed(payload: GithubWebhookPayload) {
const env = getEnv();
const pullRequest = payload.pull_request;
diff --git a/src/lib/issues/discovery-query.ts b/src/lib/issues/discovery-query.ts
new file mode 100644
index 0000000..2029c8d
--- /dev/null
+++ b/src/lib/issues/discovery-query.ts
@@ -0,0 +1,41 @@
+export type IssueSort = "recent" | "top";
+export type SortOrder = "asc" | "desc";
+
+export interface IssueDiscoveryQuery {
+ sort?: string | string[];
+ order?: string | string[];
+ minBounty?: string | string[];
+}
+
+export function normalizeIssueDiscoveryQuery(query: IssueDiscoveryQuery) {
+ const sort = first(query.sort);
+ const order = first(query.order);
+ const minBountyValue = Number(first(query.minBounty) ?? 0);
+
+ return {
+ sort: sort === "top" ? ("top" as const) : ("recent" as const),
+ order: order === "asc" ? ("asc" as const) : ("desc" as const),
+ minBounty:
+ Number.isFinite(minBountyValue) && minBountyValue > 0
+ ? minBountyValue
+ : 0,
+ };
+}
+
+export function sortIssueDiscoveryItemsForTest(
+ items: Array<{ amount: string; updatedAt: Date }>,
+ sort: IssueSort,
+ order: SortOrder,
+) {
+ const direction = order === "asc" ? 1 : -1;
+ return [...items].sort((a, b) => {
+ if (sort === "top") {
+ return (Number(a.amount) - Number(b.amount)) * direction;
+ }
+ return (a.updatedAt.getTime() - b.updatedAt.getTime()) * direction;
+ });
+}
+
+function first(value: string | string[] | undefined) {
+ return Array.isArray(value) ? value[0] : value;
+}
diff --git a/src/lib/issues/discovery.ts b/src/lib/issues/discovery.ts
new file mode 100644
index 0000000..7c31fd4
--- /dev/null
+++ b/src/lib/issues/discovery.ts
@@ -0,0 +1,59 @@
+import type { BountyStatus } from "@prisma/client";
+
+import { prisma } from "@/lib/db/prisma";
+import {
+ normalizeIssueDiscoveryQuery,
+ type IssueDiscoveryQuery,
+} from "@/lib/issues/discovery-query";
+
+export { normalizeIssueDiscoveryQuery };
+
+export interface IssueDiscoveryItem {
+ id: string;
+ title: string;
+ repository: string;
+ amount: string;
+ currency: string;
+ status: BountyStatus;
+ issueState: string;
+ issueNumber: number;
+ issueUrl: string;
+ excerpt: string;
+ updatedAt: Date;
+ createdAt: Date;
+}
+
+export async function listIssueDiscoveryItems(query: IssueDiscoveryQuery = {}) {
+ const normalized = normalizeIssueDiscoveryQuery(query);
+ const orderBy =
+ normalized.sort === "top"
+ ? [{ amount: normalized.order }, { updatedAt: "desc" as const }]
+ : [{ issueUpdatedAt: normalized.order }, { updatedAt: normalized.order }];
+
+ const bounties = await prisma.bounty.findMany({
+ where: {
+ amount: normalized.minBounty ? { gte: normalized.minBounty } : undefined,
+ },
+ include: {
+ repository: true,
+ },
+ orderBy,
+ });
+
+ return bounties.map((bounty): IssueDiscoveryItem => ({
+ id: bounty.id,
+ title: bounty.issueTitle ?? `Issue #${bounty.issueNumber}`,
+ repository: `${bounty.repository.owner}/${bounty.repository.repo}`,
+ amount: bounty.amount.toString(),
+ currency: bounty.currency,
+ status: bounty.status,
+ issueState: bounty.issueState ?? "unknown",
+ issueNumber: bounty.issueNumber,
+ issueUrl:
+ bounty.issueUrl ??
+ `https://github.com/${bounty.repository.owner}/${bounty.repository.repo}/issues/${bounty.issueNumber}`,
+ excerpt: bounty.issueExcerpt ?? "",
+ updatedAt: bounty.issueUpdatedAt ?? bounty.updatedAt,
+ createdAt: bounty.issueCreatedAt ?? bounty.createdAt,
+ }));
+}
diff --git a/tests/discovery.test.ts b/tests/discovery.test.ts
new file mode 100644
index 0000000..abd3a5d
--- /dev/null
+++ b/tests/discovery.test.ts
@@ -0,0 +1,73 @@
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+
+import {
+ normalizeIssueDiscoveryQuery,
+ sortIssueDiscoveryItemsForTest,
+} from "../src/lib/issues/discovery-query.ts";
+
+describe("normalizeIssueDiscoveryQuery", () => {
+ it("defaults to recent descending with no minimum bounty", () => {
+ assert.deepEqual(normalizeIssueDiscoveryQuery({}), {
+ sort: "recent",
+ order: "desc",
+ minBounty: 0,
+ });
+ });
+
+ it("accepts top sorting, ascending order, and minimum bounty", () => {
+ assert.deepEqual(
+ normalizeIssueDiscoveryQuery({
+ sort: "top",
+ order: "asc",
+ minBounty: "25",
+ }),
+ {
+ sort: "top",
+ order: "asc",
+ minBounty: 25,
+ },
+ );
+ });
+
+ it("sanitizes invalid query values", () => {
+ assert.deepEqual(
+ normalizeIssueDiscoveryQuery({
+ sort: "unknown",
+ order: "sideways",
+ minBounty: "-1",
+ }),
+ {
+ sort: "recent",
+ order: "desc",
+ minBounty: 0,
+ },
+ );
+ });
+});
+
+describe("sortIssueDiscoveryItemsForTest", () => {
+ const items = [
+ { amount: "25", updatedAt: new Date("2026-01-01T00:00:00Z") },
+ { amount: "5", updatedAt: new Date("2026-03-01T00:00:00Z") },
+ { amount: "100", updatedAt: new Date("2026-02-01T00:00:00Z") },
+ ];
+
+ it("sorts top issues by amount descending", () => {
+ assert.deepEqual(
+ sortIssueDiscoveryItemsForTest(items, "top", "desc").map(
+ (item) => item.amount,
+ ),
+ ["100", "25", "5"],
+ );
+ });
+
+ it("sorts recent issues by updated date descending", () => {
+ assert.deepEqual(
+ sortIssueDiscoveryItemsForTest(items, "recent", "desc").map(
+ (item) => item.amount,
+ ),
+ ["5", "100", "25"],
+ );
+ });
+});
+
+