release v3.1.0 (#1049)

Author: ryanwaits

.env-example

@@ -1,2 +1,7 @@
 NEXT_PUBLIC_GTM_ID=
 LLMS_BASE_URL=
+GITHUB_APP_ID=
+GITHUB_APP_PRIVATE_KEY= # Base64 encoded GitHub App private key
+GITHUB_APP_INSTALLATION_ID=
+GITHUB_DISCUSSION_CATEGORY_ID=
+GITHUB_REPOSITORY=

app/(docs)/[...slug]/page.tsx

@@ -31,6 +31,7 @@ import { Mermaid } from "@/components/mdx/mermaid";
 import { Callout } from "@/components/callout";
 import * as customIcons from "@/components/ui/icon";
 import * as lucideIcons from "lucide-react";
+import { FeedbackWrapper } from "@/components/feedback/feedback-wrapper";
 
 export default async function Page(props: {
   params: Promise<{ slug?: string[] }>;
@@ -163,7 +164,7 @@ export default async function Page(props: {
                       />
                     ),
                     input: (
-                      props: React.InputHTMLAttributes<HTMLInputElement>
+                      props: React.InputHTMLAttributes<HTMLInputElement>,
                     ) => {
                       if (props.type === "checkbox") {
                         return (
@@ -189,6 +190,11 @@ export default async function Page(props: {
                   })}
                 />
               </DocsPageProse>
+              <div className="border-b border-border/50" />
+              <FeedbackWrapper
+                pageTitle={page.data.title}
+                pagePath={page.url}
+              />
             </DocsPageContent>
           </DocsPageContentWrapper>
         </DocsPageLayout>
@@ -261,7 +267,7 @@ export default async function Page(props: {
                       />
                     ),
                     input: (
-                      props: React.InputHTMLAttributes<HTMLInputElement>
+                      props: React.InputHTMLAttributes<HTMLInputElement>,
                     ) => {
                       if (props.type === "checkbox") {
                         return (
@@ -287,6 +293,11 @@ export default async function Page(props: {
                   })}
                 />
               </DocsPageProse>
+              <div className="border-b border-border/50" />
+              <FeedbackWrapper
+                pageTitle={page.data.title}
+                pagePath={page.url}
+              />
             </DocsPageContent>
           </DocsPageContentWrapper>
         </DocsPageLayout>
@@ -299,7 +310,7 @@ export async function generateStaticParams() {
   return source.generateParams().filter(
     (params) =>
       // Filter out empty slug arrays (root path)
-      params.slug && params.slug.length > 0
+      params.slug && params.slug.length > 0,
   );
 }
 

app/api/feedback/route.ts

@@ -0,0 +1,61 @@
+import { NextRequest, NextResponse } from 'next/server';
+import {
+  findDiscussionByTitle,
+  createDiscussion,
+  addDiscussionComment,
+  formatDiscussionTitle,
+  formatDiscussionBody,
+} from '@/lib/github-discussions';
+
+export const runtime = 'nodejs';
+
+interface FeedbackRequest {
+  pageTitle: string;
+  pagePath: string;
+  pageUrl: string;
+  helpful: boolean;
+  feedback?: string;
+}
+
+export async function POST(request: NextRequest) {
+  try {
+    const body: FeedbackRequest = await request.json();
+    const { pageTitle, pagePath, pageUrl, helpful, feedback } = body;
+    
+    if (!pageTitle || !pagePath || !pageUrl || helpful === undefined) {
+      return NextResponse.json(
+        { error: 'Missing required fields' },
+        { status: 400 }
+      );
+    }
+    
+    const discussionTitle = formatDiscussionTitle(pageTitle, pagePath);
+    
+    let discussion = await findDiscussionByTitle(discussionTitle);
+    
+    if (!discussion) {
+      const discussionBody = formatDiscussionBody(pageTitle, pageUrl);
+      discussion = await createDiscussion(discussionTitle, discussionBody);
+    }
+    
+    const emoji = helpful ? '👍' : '👎';
+    const commentBody = feedback 
+      ? `**Feedback**: ${emoji}\n\n${feedback}`
+      : `**Feedback**: ${emoji}`;
+    
+    await addDiscussionComment(discussion.id, commentBody);
+    
+    return NextResponse.json({
+      success: true,
+      discussionUrl: discussion.url,
+      discussionNumber: discussion.number,
+    });
+    
+  } catch (error) {
+    console.error('Error handling feedback:', error);
+    return NextResponse.json(
+      { error: 'Failed to submit feedback' },
+      { status: 500 }
+    );
+  }
+}