diff --git a/src/lib/remote-mdx-files.mjs b/src/lib/remote-mdx-files.mjs
index e7c00106..6e86a100 100644
--- a/src/lib/remote-mdx-files.mjs
+++ b/src/lib/remote-mdx-files.mjs
@@ -1,3 +1,4 @@
+import { hash } from "node:crypto";
import path from "node:path";
import { env } from "node:process";
import { Octokit } from "@octokit/core";
@@ -158,3 +159,13 @@ export async function getParsedDoc(slug) {
return getSerializedContextFromMd(content, slug);
}
+
+/**
+ * Generates Document ID from a URI
+ *
+ * @param {string} uri
+ * @returns {string}
+ */
+export function generateDocIdFromUri(uri) {
+ return `mdx:${hash("sha-1", uri)}`;
+}
diff --git a/src/lib/smart-search.mjs b/src/lib/smart-search.mjs
new file mode 100644
index 00000000..7439492a
--- /dev/null
+++ b/src/lib/smart-search.mjs
@@ -0,0 +1,55 @@
+import { URL } from "node:url";
+
+function cleanPath(filePath) {
+ return (
+ filePath
+ .replace(/^\/?src\/pages/, "")
+ .replace(/^\/?pages/, "")
+ .replace(/\/index\.mdx$/, "")
+ .replace(/\.mdx$/, "") || "/"
+ );
+}
+
+export function normalizeSmartSearchResponse(results) {
+ if (!results || !Array.isArray(results)) {
+ throw new TypeError("An array of results was expected");
+ }
+
+ return results.map((result) => {
+ const { id, data } = result;
+ // console.log("Data:", result);
+ switch (data.post_type) {
+ case "mdx_doc": {
+ const path = data.post_url ? cleanPath(data.post_url) : "/";
+
+ return {
+ id,
+ title: data.post_title,
+ href: path,
+ type: data.post_type,
+ };
+ }
+
+ case "post":
+ case "page": {
+ return {
+ id,
+ title: data.post_title,
+ href: new URL(data.post_url).pathname,
+ type: data.post_type,
+ };
+ }
+
+ default: {
+ throw new TypeError(`Unknown content type: ${data.post_type}`);
+ }
+ }
+ });
+}
+
+export const smartSearchConfig = {
+ fields: ["post_title", "post_content"],
+ chunking: {
+ enabled: true,
+ },
+};
diff --git a/src/pages/api/recommend.js b/src/pages/api/recommend.js
new file mode 100644
index 00000000..f963a8d9
--- /dev/null
+++ b/src/pages/api/recommend.js
@@ -0,0 +1,71 @@
+import process from "node:process";
+import { ReasonPhrases, StatusCodes } from "http-status-codes";
+import { normalizeSmartSearchResponse } from "@/lib/smart-search.mjs";
+
+export default async function handler(req, res) {
+ const endpoint = process.env.NEXT_PUBLIC_SEARCH_ENDPOINT;
+ const accessToken = process.env.NEXT_SEARCH_ACCESS_TOKEN;
+ const { docID, count } = req.query;
+
+ if (req.method !== "GET") {
+ return res
+ .status(StatusCodes.METHOD_NOT_ALLOWED)
+ .json({ error: ReasonPhrases.METHOD_NOT_ALLOWED });
+ }
+
+ if (!docID) {
+ return res
+ .status(StatusCodes.BAD_REQUEST)
+ .json({ error: "Document ID (docID) is required." });
+ }
+
+ const graphqlQuery = `
+ query RelatedDocuments($docID: String!, $count: Int = 3) {
+ recommendations(count: $count) {
+ documents: relatedDocuments(docID: $docID, minScore: 0.7) {
+ id: docID
+ data: source
+ score
+ }
+ }
+ }`;
+
+ try {
+ const response = await fetch(endpoint, {
+ method: "POST",
+ headers: {
+ "Content-Type": "application/json",
+ Authorization: `Bearer ${accessToken}`,
+ },
+ body: JSON.stringify({
+ query: graphqlQuery,
+ variables: { docID, count },
+ }),
+ });
+
+ if (!response.ok) {
+ return res
+ .status(StatusCodes.SERVICE_UNAVAILABLE)
+ .json({ error: ReasonPhrases.SERVICE_UNAVAILABLE });
+ }
+
+ const result = await response.json();
+
+ if (result.errors) {
+ return res
+ .status(StatusCodes.INTERNAL_SERVER_ERROR)
+ .json({ errors: result.errors });
+ }
+
+ return res
+ .status(StatusCodes.OK)
+ .json(
+ normalizeSmartSearchResponse(result.data.recommendations.documents),
+ );
+ } catch (error) {
+ console.error("Error fetching search data:", error);
+ return res
+ .status(StatusCodes.Inter)
+ .json({ error: ReasonPhrases.INTERNAL_SERVER_ERROR });
+ }
+}
diff --git a/src/pages/api/search.js b/src/pages/api/search.js
index fdf11122..598aa58f 100644
--- a/src/pages/api/search.js
+++ b/src/pages/api/search.js
@@ -1,15 +1,6 @@
import process from "node:process";
import { ReasonPhrases, StatusCodes } from "http-status-codes";
-
-function cleanPath(filePath) {
- return (
- filePath
- .replace(/^\/?src\/pages/, "")
- .replace(/^\/?pages/, "")
- .replace(/\/index\.mdx$/, "")
- .replace(/\.mdx$/, "") || "/"
- );
-}
+import { normalizeSmartSearchResponse } from "@/lib/smart-search.mjs";
export default async function handler(req, res) {
const endpoint = process.env.NEXT_PUBLIC_SEARCH_ENDPOINT;
@@ -30,7 +21,13 @@ export default async function handler(req, res) {
const graphqlQuery = `
query FindDocuments($query: String!) {
- find(query: $query) {
+ find(
+ query: $query
+ semanticSearch: {
+ searchBias: 5,
+ fields: ["post_title", "post_content"]
+ }
+ ) {
total
documents {
id
@@ -67,51 +64,13 @@ export default async function handler(req, res) {
.json({ errors: result.errors });
}
- const seenIds = new Set();
- const formattedResults = [];
-
- for (const content of result.data.find.documents) {
- const contentType =
- content.data.content_type || content.data.post_type || "mdx_doc";
-
- let item = {};
-
- if (contentType === "mdx_doc" && content.data.title) {
- const path = content.data.path ? cleanPath(content.data.path) : "/";
- item = {
- id: content.id,
- title: content.data.title,
- path,
- type: "mdx_doc",
- };
- }
-
- if (
- (contentType === "wp_post" || contentType === "post") &&
- content.data.post_title &&
- content.data.post_name
- ) {
- item = {
- id: content.id,
- title: content.data.post_title,
- path: `/blog/${content.data.post_name}`,
- type: "post",
- };
- }
-
- if (seenIds.has(item.id)) {
- continue;
- }
-
- seenIds.add(item.id);
- formattedResults.push(item);
- }
-
- return res.status(StatusCodes.OK).json(formattedResults);
+ return res
+ .status(StatusCodes.OK)
+ .json(normalizeSmartSearchResponse(result.data.find.documents));
} catch (error) {
console.error("Error fetching search data:", error);
return res
- .status(StatusCodes.Inter)
+ .status(StatusCodes.INTERNAL_SERVER_ERROR)
.json({ error: ReasonPhrases.INTERNAL_SERVER_ERROR });
}
}
diff --git a/src/pages/blog/index.jsx b/src/pages/blog/index.jsx
index 9a7a49e7..62b0ec20 100644
--- a/src/pages/blog/index.jsx
+++ b/src/pages/blog/index.jsx
@@ -1,8 +1,8 @@
import { gql, useQuery } from "@apollo/client";
import { getNextStaticProps } from "@faustwp/core";
-import { ArrowPathIcon, ChevronDownIcon } from "@heroicons/react/24/outline";
import Link from "next/link";
import { useState } from "react";
+import { HiOutlineArrowPath, HiOutlineChevronDown } from "react-icons/hi2";
import Card from "@/components/card";
import Date from "@/components/date";
import Seo from "@/components/seo";
@@ -45,7 +45,7 @@ export default function BlogIndex() {
if (loading && !data)
return (
);
@@ -129,11 +129,11 @@ const LoadMoreButton = ({ onClick }) => {
>
{loading ? (
<>
- Loading
+ Loading
) : (
<>
- Load more
+ Load more
)}
diff --git a/src/pages/docs/[[...slug]].jsx b/src/pages/docs/[[...slug]].jsx
index 97cea921..2a654ddf 100644
--- a/src/pages/docs/[[...slug]].jsx
+++ b/src/pages/docs/[[...slug]].jsx
@@ -1,6 +1,11 @@
+import path from "node:path";
import { MDXClient } from "next-mdx-remote-client";
import { useMDXComponents } from "@/components/mdx-components";
-import { getParsedDoc, getDocsNav } from "@/lib/remote-mdx-files.mjs";
+import {
+ getParsedDoc,
+ getDocsNav,
+ generateDocIdFromUri,
+} from "@/lib/remote-mdx-files.mjs";
export default function Doc({ source }) {
return ;
@@ -13,6 +18,11 @@ export async function getStaticProps({ params }) {
return {
props: {
+ id: generateDocIdFromUri(
+ params.slug?.length > 1
+ ? path.join("/docs", ...params.slug, "/")
+ : "/docs/",
+ ),
source,
docsNavData,
},
diff --git a/src/pages/index.jsx b/src/pages/index.jsx
index e603c53d..8ff678dd 100644
--- a/src/pages/index.jsx
+++ b/src/pages/index.jsx
@@ -1,11 +1,11 @@
import {
- ArrowTopRightOnSquareIcon,
- ChevronRightIcon,
- CodeBracketIcon,
- CursorArrowRaysIcon,
- KeyIcon,
- RectangleGroupIcon,
-} from "@heroicons/react/24/outline";
+ HiOutlineArrowTopRightOnSquare,
+ HiOutlineChevronRight,
+ HiOutlineCodeBracket,
+ HiOutlineCursorArrowRays,
+ HiOutlineKey,
+ HiOutlineRectangleGroup,
+} from "react-icons/hi2";
import Card from "@/components/card";
import Link from "@/components/link";
import Seo from "@/components/seo";
@@ -35,7 +35,7 @@ export default function Index() {
noDefaultStyles
>
Read the Docs
-
@@ -47,7 +47,7 @@ export default function Index() {
noDefaultStyles
>
Join the Discord
-
@@ -67,7 +67,7 @@ export default function Index() {
className="bg-blue-1100/20 col-span-full flex flex-col overflow-hidden rounded-2xl p-4 ring-1 ring-blue-500/10 md:col-span-6 md:p-6 lg:col-span-7 lg:p-8"
>
-
+
Authentication
@@ -80,7 +80,7 @@ export default function Index() {
className="bg-blue-1100/20 col-span-full flex flex-col overflow-hidden rounded-2xl p-4 ring-1 ring-blue-500/10 md:col-span-6 md:p-6 lg:col-span-5 lg:p-8"
>
-
+
Post previews
@@ -94,7 +94,7 @@ export default function Index() {
className="bg-blue-1100/20 col-span-full flex flex-col overflow-hidden rounded-2xl p-4 ring-1 ring-blue-500/10 md:col-span-6 md:p-6 lg:col-span-5 lg:p-8"
>
-
+
Template hierarchy
@@ -115,7 +115,7 @@ export default function Index() {
className="bg-blue-1100/20 col-span-full flex flex-col overflow-hidden rounded-2xl p-4 ring-1 ring-blue-500/10 md:col-span-6 md:p-6 lg:col-span-7 lg:p-8"
>
-
+
Block editor support
@@ -135,7 +135,7 @@ export default function Index() {
noDefaultStyles
>
Get Started
-
diff --git a/src/pages/showcase/index.jsx b/src/pages/showcase/index.jsx
index 5627a1a6..581bf770 100644
--- a/src/pages/showcase/index.jsx
+++ b/src/pages/showcase/index.jsx
@@ -1,5 +1,5 @@
-import { ArrowTopRightOnSquareIcon } from "@heroicons/react/24/outline";
import Image from "next/image";
+import { HiOutlineArrowTopRightOnSquare } from "react-icons/hi2";
import Link from "@/components/link";
import Seo from "@/components/seo";
@@ -63,7 +63,7 @@ export default function Showcase() {
{/* Applying solid blue background with opacity and making it fit the card width */}
))}