bsmnt 0.2.11 → 0.3.0

package/src/templates/next-pagebuilder/lib/integrations/sanity/markdown-proxy.config.ts

@@ -0,0 +1,50 @@
+export interface MarkdownRoute {
+  /** Regex to match the public-facing URL */
+  regex: RegExp
+  /** API route path template (under /api/) */
+  apiPath: string
+  /** Public markdown URL template (for Link headers) */
+  publicPath: string
+}
+
+/**
+ * Routes that serve markdown versions for AI agents.
+ * All pages are backed by the shared `page` document type and resolved
+ * through the catch-all route handlers.
+ *
+ * How it works:
+ * - `regex`: match the public-facing URL (e.g. /about.md or /about)
+ * - `apiPath`: the internal API route that serves the markdown (e.g. /api/about.md)
+ * - Proxy rewrites .md URLs and Accept: text/markdown requests to the API route
+ * - Route handlers live under /api/ so page.tsx can coexist at the public path
+ */
+
+/** .md extension routes -- rewrite to API endpoints */
+export const mdExtensionRoutes: MarkdownRoute[] = [
+  {
+    regex: /^\/(.+)\.md$/,
+    apiPath: "/api/[slug].md",
+    publicPath: "/[slug].md",
+  },
+]
+
+/** Accept: text/markdown routes -- content negotiation for HTML pages */
+export const acceptHeaderRoutes: MarkdownRoute[] = [
+  {
+    regex: /^\/(.+)$/,
+    apiPath: "/api/[slug].md",
+    publicPath: "/[slug].md",
+  },
+]
+
+/**
+ * Paths the proxy should never process.
+ * Studio, static files, Next.js internals.
+ */
+export const ignoredPaths = [
+  "/studio",
+  "/api/",
+  "/_next/",
+  "/favicon.ico",
+  "/sitemap.md",
+]

package/src/templates/next-pagebuilder/lib/integrations/sanity/page-builder-config.ts

@@ -0,0 +1,132 @@
+import { contentIcon, pageIcon, type SanityStudioIcon } from "./icons"
+import { singletonComponents } from "./singletons"
+
+export type PageBuilderDocumentType =
+  | "hero"
+  | "description"
+  | "blogContent"
+  | (typeof singletonComponents)[number]["schemaType"]
+
+type PageBuilderReferenceMember = {
+  documentType: PageBuilderDocumentType
+  name: string
+  title: string
+  documentId?: string
+  groups: PageBuilderGroupName[]
+}
+
+export type PageBuilderGroupName =
+  | "generic"
+  | "blogEntry"
+
+export const pageBuilderPageTypes: Array<{
+  title: string
+  value: PageBuilderGroupName
+}> = [
+  { title: "Generic", value: "generic" },
+  { title: "Blog Entry", value: "blogEntry" },
+]
+
+const pageCategoryIcons: Record<PageBuilderGroupName, SanityStudioIcon> = {
+  generic: pageIcon,
+  blogEntry: contentIcon,
+}
+
+export const getPageCategoryIcon = (
+  pageType: PageBuilderGroupName | undefined | null
+) => pageCategoryIcons[pageType ?? "generic"]
+
+const reusablePageBuilderReferenceMembers: PageBuilderReferenceMember[] = [
+  {
+    documentType: "hero",
+    name: "heroReference",
+    title: "Heading",
+    groups: ["generic"],
+  },
+  {
+    documentType: "description",
+    name: "descriptionReference",
+    title: "Description",
+    groups: ["generic"],
+  },
+  {
+    documentType: "blogContent",
+    name: "blogContentReference",
+    title: "Blog Content",
+    groups: ["blogEntry"],
+  },
+]
+
+const singletonPageBuilderReferenceMembers: PageBuilderReferenceMember[] =
+  singletonComponents.map((component) => ({
+    documentType: component.schemaType,
+    name: `${component.schemaType}Reference`,
+    title: component.title,
+    documentId: component.documentId,
+    groups: ["generic"],
+  }))
+
+export const pageBuilderReferenceMembers: PageBuilderReferenceMember[] = [
+  ...reusablePageBuilderReferenceMembers,
+  ...singletonPageBuilderReferenceMembers,
+]
+
+export const getPageBuilderReferenceMember = (name: string) =>
+  pageBuilderReferenceMembers.find((member) => member.name === name)
+
+export const getPageBuilderReferenceMemberByDocumentType = (
+  documentType: PageBuilderDocumentType
+) =>
+  pageBuilderReferenceMembers.find(
+    (member) => member.documentType === documentType
+  )
+
+const isPageBuilderGroupVisible = (
+  pageType: PageBuilderGroupName | undefined,
+  group: PageBuilderGroupName
+) => (pageType ?? "generic") === group
+
+export const getVisiblePageBuilderReferenceMembers = (
+  pageType: PageBuilderGroupName | undefined
+) =>
+  pageBuilderReferenceMembers.filter((member) =>
+    member.groups.some((group) => isPageBuilderGroupVisible(pageType, group))
+  )
+
+export const getVisiblePageBuilderInsertMenuGroups = (
+  pageType: PageBuilderGroupName | undefined
+) =>
+  pageBuilderInsertMenuGroups.filter(
+    (group) => group.name === (pageType ?? "generic")
+  )
+
+export const getInvalidPageBuilderDocumentTypes = (
+  pageType: PageBuilderGroupName | undefined,
+  documentTypes: PageBuilderDocumentType[]
+) =>
+  documentTypes.filter((documentType) => {
+    const member = getPageBuilderReferenceMemberByDocumentType(documentType)
+
+    if (!member) return false
+
+    return !member.groups.some((group) =>
+      isPageBuilderGroupVisible(pageType, group)
+    )
+  })
+
+export const pageBuilderInsertMenuGroups = [
+  {
+    name: "generic",
+    title: "Generic",
+    of: pageBuilderReferenceMembers
+      .filter((member) => member.groups.includes("generic"))
+      .map((member) => member.name),
+  },
+  {
+    name: "blogEntry",
+    title: "Blog Entry",
+    of: pageBuilderReferenceMembers
+      .filter((member) => member.groups.includes("blogEntry"))
+      .map((member) => member.name),
+  },
+]

package/src/templates/next-pagebuilder/lib/integrations/sanity/page-category.ts

@@ -0,0 +1,28 @@
+import type { PageBuilderGroupName } from "@/lib/integrations/sanity/page-builder-config"
+
+type PageCategoryParams = {
+  slug?: string | null
+  folder?: string | null
+}
+
+export const isEmptyPageSlug = (slug?: string | null) =>
+  slug == null || slug === "" || slug === "/"
+
+export const getGeneratedPageCategory = ({
+  slug,
+  folder,
+}: PageCategoryParams): PageBuilderGroupName => {
+  if (!isEmptyPageSlug(slug) && folder === "blog") return "blogEntry"
+
+  return "generic"
+}
+
+export const pageCategoryExpression = `
+  select(
+    defined(slug.current) &&
+      slug.current != "" &&
+      slug.current != "/" &&
+      pageFolder->slug.current == "blog" => "blogEntry",
+    "generic"
+  )
+`

package/src/templates/next-pagebuilder/lib/integrations/sanity/queries.ts

@@ -0,0 +1,281 @@
+import { defineQuery } from "next-sanity"
+
+const pageResolvedSlugExpression = `
+  select(
+    defined(pageFolder->parentFolder->parentFolder->parentFolder->parentFolder->parentFolder->slug.current) && defined(pageFolder->parentFolder->parentFolder->parentFolder->parentFolder->slug.current) && defined(pageFolder->parentFolder->parentFolder->parentFolder->slug.current) && defined(pageFolder->parentFolder->parentFolder->slug.current) && defined(pageFolder->parentFolder->slug.current) && defined(pageFolder->slug.current) && (!defined(slug.current) || slug.current == "" || slug.current == "/") => pageFolder->parentFolder->parentFolder->parentFolder->parentFolder->parentFolder->slug.current + "/" + pageFolder->parentFolder->parentFolder->parentFolder->parentFolder->slug.current + "/" + pageFolder->parentFolder->parentFolder->parentFolder->slug.current + "/" + pageFolder->parentFolder->parentFolder->slug.current + "/" + pageFolder->parentFolder->slug.current + "/" + pageFolder->slug.current,
+    defined(pageFolder->parentFolder->parentFolder->parentFolder->parentFolder->slug.current) && defined(pageFolder->parentFolder->parentFolder->parentFolder->slug.current) && defined(pageFolder->parentFolder->parentFolder->slug.current) && defined(pageFolder->parentFolder->slug.current) && defined(pageFolder->slug.current) && (!defined(slug.current) || slug.current == "" || slug.current == "/") => pageFolder->parentFolder->parentFolder->parentFolder->parentFolder->slug.current + "/" + pageFolder->parentFolder->parentFolder->parentFolder->slug.current + "/" + pageFolder->parentFolder->parentFolder->slug.current + "/" + pageFolder->parentFolder->slug.current + "/" + pageFolder->slug.current,
+    defined(pageFolder->parentFolder->parentFolder->parentFolder->slug.current) && defined(pageFolder->parentFolder->parentFolder->slug.current) && defined(pageFolder->parentFolder->slug.current) && defined(pageFolder->slug.current) && (!defined(slug.current) || slug.current == "" || slug.current == "/") => pageFolder->parentFolder->parentFolder->parentFolder->slug.current + "/" + pageFolder->parentFolder->parentFolder->slug.current + "/" + pageFolder->parentFolder->slug.current + "/" + pageFolder->slug.current,
+    defined(pageFolder->parentFolder->parentFolder->slug.current) && defined(pageFolder->parentFolder->slug.current) && defined(pageFolder->slug.current) && (!defined(slug.current) || slug.current == "" || slug.current == "/") => pageFolder->parentFolder->parentFolder->slug.current + "/" + pageFolder->parentFolder->slug.current + "/" + pageFolder->slug.current,
+    defined(pageFolder->parentFolder->slug.current) && defined(pageFolder->slug.current) && (!defined(slug.current) || slug.current == "" || slug.current == "/") => pageFolder->parentFolder->slug.current + "/" + pageFolder->slug.current,
+    defined(pageFolder->slug.current) && (!defined(slug.current) || slug.current == "" || slug.current == "/") => pageFolder->slug.current,
+    defined(pageFolder->parentFolder->parentFolder->parentFolder->parentFolder->parentFolder->slug.current) && defined(pageFolder->parentFolder->parentFolder->parentFolder->parentFolder->slug.current) && defined(pageFolder->parentFolder->parentFolder->parentFolder->slug.current) && defined(pageFolder->parentFolder->parentFolder->slug.current) && defined(pageFolder->parentFolder->slug.current) && defined(pageFolder->slug.current) && defined(slug.current) && slug.current != "" && slug.current != "/" => pageFolder->parentFolder->parentFolder->parentFolder->parentFolder->parentFolder->slug.current + "/" + pageFolder->parentFolder->parentFolder->parentFolder->parentFolder->slug.current + "/" + pageFolder->parentFolder->parentFolder->parentFolder->slug.current + "/" + pageFolder->parentFolder->parentFolder->slug.current + "/" + pageFolder->parentFolder->slug.current + "/" + pageFolder->slug.current + "/" + slug.current,
+    defined(pageFolder->parentFolder->parentFolder->parentFolder->parentFolder->slug.current) && defined(pageFolder->parentFolder->parentFolder->parentFolder->slug.current) && defined(pageFolder->parentFolder->parentFolder->slug.current) && defined(pageFolder->parentFolder->slug.current) && defined(pageFolder->slug.current) && defined(slug.current) && slug.current != "" && slug.current != "/" => pageFolder->parentFolder->parentFolder->parentFolder->parentFolder->slug.current + "/" + pageFolder->parentFolder->parentFolder->parentFolder->slug.current + "/" + pageFolder->parentFolder->parentFolder->slug.current + "/" + pageFolder->parentFolder->slug.current + "/" + pageFolder->slug.current + "/" + slug.current,
+    defined(pageFolder->parentFolder->parentFolder->parentFolder->slug.current) && defined(pageFolder->parentFolder->parentFolder->slug.current) && defined(pageFolder->parentFolder->slug.current) && defined(pageFolder->slug.current) && defined(slug.current) && slug.current != "" && slug.current != "/" => pageFolder->parentFolder->parentFolder->parentFolder->slug.current + "/" + pageFolder->parentFolder->parentFolder->slug.current + "/" + pageFolder->parentFolder->slug.current + "/" + pageFolder->slug.current + "/" + slug.current,
+    defined(pageFolder->parentFolder->parentFolder->slug.current) && defined(pageFolder->parentFolder->slug.current) && defined(pageFolder->slug.current) && defined(slug.current) && slug.current != "" && slug.current != "/" => pageFolder->parentFolder->parentFolder->slug.current + "/" + pageFolder->parentFolder->slug.current + "/" + pageFolder->slug.current + "/" + slug.current,
+    defined(pageFolder->parentFolder->slug.current) && defined(pageFolder->slug.current) && defined(slug.current) && slug.current != "" && slug.current != "/" => pageFolder->parentFolder->slug.current + "/" + pageFolder->slug.current + "/" + slug.current,
+    defined(pageFolder->slug.current) && defined(slug.current) && slug.current != "" && slug.current != "/" => pageFolder->slug.current + "/" + slug.current,
+    slug.current
+  )
+`
+
+const linkItemProjection = `
+  ...,
+  _type == "pageReference" => {
+    page->{
+      _id,
+      _type,
+      slug,
+      title,
+      "resolvedSlug": select(
+        _type == "page" => ${pageResolvedSlugExpression},
+        slug.current
+      )
+    }
+  }
+`
+
+// Helper for rich text link projections (expandable inside any array field)
+const richTextLinkProjection = `
+  ...,
+  markDefs[]{
+    ...,
+    _type == "pageReference" => {
+      page->{
+        _id,
+        _type,
+        slug,
+        title,
+        "resolvedSlug": select(
+          _type == "page" => ${pageResolvedSlugExpression},
+          slug.current
+        )
+      }
+    }
+  }
+`
+
+const pageBuilderProjection = `
+  pageBuilder[]{
+    _key,
+    ...@->{
+      ...,
+      _type == "blogContent" => {
+        ...,
+        categories[]->{
+          _id,
+          title,
+          slug
+        },
+        author->{
+          _id,
+          name,
+          avatar,
+          role
+        },
+        body[]{
+          ${richTextLinkProjection}
+        },
+        relatedPosts[]->{
+          _id,
+          title,
+          "resolvedSlug": ${pageResolvedSlugExpression},
+          metadata
+        }
+      }
+    }
+  }
+`
+
+const pageProjection = `
+  _id,
+  _type,
+  title,
+  slug,
+  "resolvedSlug": ${pageResolvedSlugExpression},
+  ${pageBuilderProjection},
+  metadata,
+  _updatedAt
+`
+
+export const PAGE_QUERY = defineQuery(`
+  *[
+    _type == "page" &&
+    (
+      ($slug == null && !defined(pageFolder._ref) && (!defined(slug.current) || slug.current == "" || slug.current == "/")) ||
+      ${pageResolvedSlugExpression} == $slug
+    )
+  ][0] {
+    ${pageProjection}
+  }
+`)
+
+export const ALL_PAGE_SLUGS_QUERY = defineQuery(`
+  *[_type == "page" && (defined(pageFolder->slug.current) || defined(slug.current))] | order(title asc) {
+    title,
+    "slug": ${pageResolvedSlugExpression},
+    _updatedAt
+  }
+`)
+
+export const P_REV_SLUGS_QUERY = defineQuery(`
+  *[
+    _type == "page" &&
+    _id in $documentIds
+  ] | order(_updatedAt desc) {
+    "slug": ${pageResolvedSlugExpression}
+  }
+`)
+
+export const P_REF_PB_COMP_QUERY = defineQuery(`
+  *[
+    _type == "page" &&
+    count(pageBuilder[_ref == $documentId]) > 0
+  ] | order(title asc) {
+    _id,
+    title,
+    "slug": ${pageResolvedSlugExpression}
+  }
+`)
+
+export const PAGE_SITEMAP_QUERY = defineQuery(`
+  *[
+    _type == "page" &&
+    (
+      _id == "page-homepage" ||
+      defined(pageFolder->slug.current) ||
+      defined(slug.current)
+    )
+  ] | order(title asc) {
+    title,
+    "slug": ${pageResolvedSlugExpression},
+    _updatedAt,
+    "noIndex": select(
+      defined(metadata.index) => !metadata.index,
+      defined(metadata.noIndex) => metadata.noIndex,
+      false
+    )
+  }
+`)
+
+// Blog collection -- fetches pages under a "blog" folder
+// Reaches into the blogContent page-builder block for article-level fields
+export const ALL_BLOG_ARTICLES_QUERY = defineQuery(`
+  *[
+    _type == "page" &&
+    pageFolder->slug.current == "blog" &&
+    defined(slug.current) &&
+    slug.current != "" &&
+    slug.current != "/"
+  ] | order(_updatedAt desc) {
+    _id,
+    title,
+    "slug": slug,
+    "resolvedSlug": ${pageResolvedSlugExpression},
+    "blogContent": pageBuilder[_ref in *[_type == "blogContent"]._id][0]->{
+      thumbnail{
+        ...,
+        alt
+      },
+      categories[]->{
+        _id,
+        title,
+        slug
+      },
+      date,
+      author->{
+        _id,
+        name,
+        avatar
+      }
+    },
+    metadata,
+    _updatedAt
+  }
+`)
+
+// Company Data
+export const COMPANY_DATA_QUERY = defineQuery(`
+  *[_type == "companyData"][0]{
+    socialLinks[]{
+      _key,
+      name,
+      icon,
+      url,
+      label
+    }
+  }
+`)
+
+// Navbar
+// Shared link projection for navbar -- flattens array-of-one to single object
+const navLinkProjection = `
+  "link": link[0]{
+    ${linkItemProjection}
+  }
+`
+
+const navLeafItemProjection = `
+  _key,
+  title,
+  ${navLinkProjection}
+`
+
+const navColumnProjection = `
+  _key,
+  title,
+  ${navLinkProjection},
+  items[]{
+    ${navLeafItemProjection}
+  }
+`
+
+const navMegaMenuProjection = `
+  columns[]{
+    ${navColumnProjection}
+  }
+`
+
+export const NAVBAR_QUERY = defineQuery(`
+  *[_type == "navbar"][0]{
+    logo{
+      ...,
+      asset->{
+        _id,
+        url,
+        metadata { dimensions }
+      }
+    },
+    navigationItems[]{
+      _key,
+      title,
+      itemType,
+      ${navLinkProjection},
+      megaMenu{
+        ${navMegaMenuProjection}
+      }
+    },
+    ctaButtons[]{
+      _key,
+      label,
+      "link": link[0]{
+        ${linkItemProjection}
+      },
+      variant
+    }
+  }
+`)
+
+// Footer
+export const FOOTER_QUERY = defineQuery(`
+  *[_type == "footer"][0]{
+    links[]{
+      _key,
+      title,
+      items[]{
+        _key,
+        label,
+        href
+      }
+    }
+  }
+`)

package/src/templates/next-pagebuilder/lib/integrations/sanity/sanity.cli.ts

@@ -0,0 +1,29 @@
+/**
+ * This configuration file lets you run `$ sanity [command]` in this folder
+ * Go to https://www.sanity.io/docs/cli to learn more.
+ **/
+import path from "node:path"
+import { fileURLToPath } from "node:url"
+import { defineCliConfig } from "sanity/cli"
+import { dataset, projectId } from "./env"
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+
+export default defineCliConfig({
+  api: { projectId, dataset },
+  project: {
+    basePath: "/studio",
+  },
+  typegen: {
+    path: "./queries.ts",
+    schema: "./schema.json",
+    generates: "./sanity.types.ts",
+  },
+  vite: {
+    resolve: {
+      alias: {
+        "~": __dirname,
+      },
+    },
+  },
+})