feat: add spire blog app with overrideSections support

deco.ts

@@ -61,6 +61,7 @@ const config = {
     app("implementation"),
     app("weather"),
     app("blog"),
+    app("spire"),
     app("analytics"),
     app("sourei"),
     app("typesense"),

spire/loaders/BlogPostPage.ts

@@ -0,0 +1,91 @@
+import { logger } from "@deco/deco/o11y";
+import { AppContext } from "../mod.ts";
+import { BlogPost, BlogPostPage, SpirePost } from "../types.ts";
+import { blocksToSections } from "../utils/blocksToSections.ts";
+import type { RequestURLParam } from "../../website/functions/requestToParam.ts";
+import { Resolved } from "@deco/deco";
+import { Section } from "@deco/deco/blocks";
+
+export interface Props {
+  slug: RequestURLParam;
+}
+
+/**
+ * @title BlogPostPage
+ * @description Fetches a specific Spire blog post page by its slug.
+ */
+export const cache = {
+  maxAge: 60 * 60 * 24, // 24 hours
+};
+
+export const cacheKey = (props: Props, _req: Request, ctx: AppContext) => {
+  return `spire-post-${ctx.account}-${props.slug}`;
+};
+
+export default async function BlogPostPageLoader(
+  { slug }: Props,
+  req: Request,
+  ctx: AppContext,
+): Promise<BlogPostPage | null> {
+  const { account, api } = ctx;
+  const url = new URL(req.url);
+
+  const response = await api["GET /blog/:account/posts/:slug"](
+    { account, slug },
+  );
+
+  if (!response.ok) {
+    logger.error(
+      `BlogPostPage: fetch failed for slug "${slug}" — ${response.status} ${response.statusText}`,
+    );
+    return null;
+  }
+
+  const { post } = await response.json();
+
+  if (!post) {
+    logger.error(`BlogPostPage: no post found for slug "${slug}"`);
+    return null;
+  }
+
+  const blogPost = spirePostToBlogPost(post, ctx.overrideMap);
+
+  return {
+    "@type": "BlogPostPage",
+    post: blogPost,
+    seo: {
+      title: post.version.metaTitle || post.version.title,
+      description: post.version.metaDescription || post.version.description,
+      image: post.version.imageUrl,
+      canonical: url.href,
+      noIndexing: false,
+    },
+  };
+}
+
+export function spirePostToBlogPost(
+  post: SpirePost,
+  overrides: Record<string, Resolved<Section>> = {},
+): BlogPost {
+  return {
+    id: post.id,
+    title: post.version.title,
+    excerpt: post.version.description,
+    image: post.version.imageUrl,
+    alt: post.version.title,
+    authors: post.authors.map((a) => ({
+      name: a.name,
+      email: "",
+      avatar: a.avatarUrl ?? undefined,
+    })),
+    categories: [],
+    date: post.publishedAt ?? "",
+    slug: post.slug,
+    seo: {
+      title: post.version.metaTitle,
+      description: post.version.metaDescription,
+      image: post.version.imageUrl,
+    },
+    sections: blocksToSections(post.version.blocks, overrides),
+  };
+}

spire/loaders/BlogpostList.ts

@@ -0,0 +1,93 @@
+import { logger } from "@deco/deco/o11y";
+import { AppContext } from "../mod.ts";
+import { BlogPost, SpirePostSummary } from "../types.ts";
+
+export interface Props {
+  /**
+   * @title Items per page
+   * @description Number of posts per page to display.
+   */
+  count?: number;
+  /**
+   * @title Page number
+   * @description The current page number. Defaults to 1.
+   */
+  page?: number;
+}
+
+/**
+ * @title BlogpostList
+ * @description Retrieves a list of Spire blog posts.
+ */
+export const cache = {
+  maxAge: 60 * 60 * 24, // 24 hours
+};
+
+const MAX_COUNT = 100;
+
+/** Parse an integer from a value that may be a number, string, or null. Falls back to `fallback` on NaN/null. */
+function parseIntParam(
+  value: number | string | null | undefined,
+  fallback: number,
+): number {
+  const n = parseInt(String(value ?? ""), 10);
+  return Number.isFinite(n) && n > 0 ? n : fallback;
+}
+
+export const cacheKey = (props: Props, req: Request, ctx: AppContext) => {
+  const url = new URL(req.url);
+  const page = parseIntParam(props.page ?? url.searchParams.get("page"), 1);
+  const count = Math.min(
+    parseIntParam(props.count ?? url.searchParams.get("count"), 12),
+    MAX_COUNT,
+  );
+  return `spire-list-${ctx.account}-page${page}-count${count}`;
+};
+
+export default async function BlogpostList(
+  { page, count }: Props,
+  req: Request,
+  ctx: AppContext,
+): Promise<BlogPost[]> {
+  const { account, api } = ctx;
+  const url = new URL(req.url);
+  const perPage = Math.min(
+    parseIntParam(count ?? url.searchParams.get("count"), 12),
+    MAX_COUNT,
+  );
+  const pageNumber = parseIntParam(page ?? url.searchParams.get("page"), 1);
+
+  try {
+    const response = await api["GET /blog/:account"](
+      { account, page: pageNumber, perPage },
+    );
+
+    if (!response.ok) {
+      return [];
+    }
+
+    const { posts } = await response.json();
+    const blogPosts = (posts ?? []).map(spirePostSummaryToBlogPost);
+
+    return blogPosts.length > 0 ? blogPosts : [];
+  } catch (e) {
+    logger.error(e);
+    return [];
+  }
+}
+
+export function spirePostSummaryToBlogPost(
+  summary: SpirePostSummary,
+): BlogPost {
+  return {
+    id: summary.id,
+    title: summary.title,
+    excerpt: summary.description,
+    image: summary.imageUrl,
+    alt: summary.title,
+    authors: [],
+    categories: [],
+    date: summary.publishedAt ?? "",
+    slug: summary.slug,
+  };
+}

spire/loaders/BlogpostListing.ts

@@ -0,0 +1,102 @@
+import { logger } from "@deco/deco/o11y";
+import { PageInfo } from "../../commerce/types.ts";
+import { AppContext } from "../mod.ts";
+import { BlogPost, BlogPostListingPage, SpirePagination } from "../types.ts";
+import { spirePostSummaryToBlogPost } from "./BlogpostList.ts";
+
+export interface Props {
+  /**
+   * @title Items per page
+   * @description Number of posts per page to display.
+   */
+  count?: number;
+  /**
+   * @title Page number
+   * @description The current page number. Defaults to 1.
+   */
+  page?: number;
+}
+
+/**
+ * @title BlogpostListing
+ * @description Retrieves a paginated listing page of Spire blog posts.
+ */
+export const cache = {
+  maxAge: 60 * 60 * 24, // 24 hours
+};
+
+/** Parse an integer from a value that may be a number, string, or null. Falls back to `fallback` on NaN/null. */
+function parseIntParam(
+  value: number | string | null | undefined,
+  fallback: number,
+): number {
+  const n = parseInt(String(value ?? ""), 10);
+  return Number.isFinite(n) && n > 0 ? n : fallback;
+}
+
+export const cacheKey = (props: Props, req: Request, ctx: AppContext) => {
+  const url = new URL(req.url);
+  const page = parseIntParam(props.page ?? url.searchParams.get("page"), 1);
+  const count = parseIntParam(props.count ?? url.searchParams.get("count"), 12);
+  return `spire-listing-${ctx.account}-page${page}-count${count}`;
+};
+
+export default async function BlogpostListing(
+  { page, count }: Props,
+  req: Request,
+  ctx: AppContext,
+): Promise<BlogPostListingPage | null> {
+  const { account, api } = ctx;
+  const url = new URL(req.url);
+  const params = url.searchParams;
+  const perPage = parseIntParam(count ?? params.get("count"), 12);
+  const pageNumber = parseIntParam(page ?? params.get("page"), 1);
+
+  try {
+    const response = await api["GET /blog/:account"](
+      { account, page: pageNumber, perPage },
+    );
+
+    if (!response.ok) {
+      return null;
+    }
+
+    const { posts: rawPosts, pagination, blog } = await response.json();
+    const posts: BlogPost[] = (rawPosts ?? []).map(spirePostSummaryToBlogPost);
+
+    return {
+      posts,
+      pageInfo: toPageInfo(pagination, params),
+      seo: {
+        title: blog?.name || "Blog",
+        canonical: new URL(url.pathname, url.origin).href,
+      },
+    };
+  } catch (e) {
+    logger.error(e);
+    return null;
+  }
+}
+
+function toPageInfo(
+  pagination: SpirePagination,
+  params: URLSearchParams,
+): PageInfo {
+  const { page, totalPages, total, perPage } = pagination;
+  const hasNextPage = page < totalPages;
+  const hasPrevPage = page > 1;
+
+  const nextPageParams = new URLSearchParams(params);
+  const prevPageParams = new URLSearchParams(params);
+
+  if (hasNextPage) nextPageParams.set("page", String(page + 1));
+  if (hasPrevPage) prevPageParams.set("page", String(page - 1));
+
+  return {
+    nextPage: hasNextPage ? `?${nextPageParams}` : undefined,
+    previousPage: hasPrevPage ? `?${prevPageParams}` : undefined,
+    currentPage: page,
+    records: total,
+    recordPerPage: perPage,
+  };
+}

spire/manifest.gen.ts

@@ -0,0 +1,61 @@
+// DO NOT EDIT. This file is generated by deco.
+// This file SHOULD be checked into source version control.
+// This file is automatically updated during development when running `dev.ts`.
+
+import * as $$$1 from "./loaders/BlogpostList.ts";
+import * as $$$2 from "./loaders/BlogpostListing.ts";
+import * as $$$0 from "./loaders/BlogPostPage.ts";
+import * as $$$$$$3 from "./sections/blocks/BlockImage.tsx";
+import * as $$$$$$4 from "./sections/blocks/Callout.tsx";
+import * as $$$$$$5 from "./sections/blocks/CardGroup.tsx";
+import * as $$$$$$6 from "./sections/blocks/Checklist.tsx";
+import * as $$$$$$7 from "./sections/blocks/Code.tsx";
+import * as $$$$$$8 from "./sections/blocks/Comparison.tsx";
+import * as $$$$$$9 from "./sections/blocks/Cta.tsx";
+import * as $$$$$$10 from "./sections/blocks/Divider.tsx";
+import * as $$$$$$11 from "./sections/blocks/Heading.tsx";
+import * as $$$$$$12 from "./sections/blocks/List.tsx";
+import * as $$$$$$13 from "./sections/blocks/Paragraph.tsx";
+import * as $$$$$$14 from "./sections/blocks/Quote.tsx";
+import * as $$$$$$15 from "./sections/blocks/Stat.tsx";
+import * as $$$$$$16 from "./sections/blocks/StatGroup.tsx";
+import * as $$$$$$17 from "./sections/blocks/Steps.tsx";
+import * as $$$$$$18 from "./sections/blocks/Video.tsx";
+import * as $$$$$$0 from "./sections/Seo/SeoBlogPost.tsx";
+import * as $$$$$$1 from "./sections/Seo/SeoBlogPostListing.tsx";
+import * as $$$$$$2 from "./sections/Template.tsx";
+
+const manifest = {
+  "loaders": {
+    "spire/loaders/BlogpostList.ts": $$$1,
+    "spire/loaders/BlogpostListing.ts": $$$2,
+    "spire/loaders/BlogPostPage.ts": $$$0,
+  },
+  "sections": {
+    "spire/sections/blocks/BlockImage.tsx": $$$$$$3,
+    "spire/sections/blocks/Callout.tsx": $$$$$$4,
+    "spire/sections/blocks/CardGroup.tsx": $$$$$$5,
+    "spire/sections/blocks/Checklist.tsx": $$$$$$6,
+    "spire/sections/blocks/Code.tsx": $$$$$$7,
+    "spire/sections/blocks/Comparison.tsx": $$$$$$8,
+    "spire/sections/blocks/Cta.tsx": $$$$$$9,
+    "spire/sections/blocks/Divider.tsx": $$$$$$10,
+    "spire/sections/blocks/Heading.tsx": $$$$$$11,
+    "spire/sections/blocks/List.tsx": $$$$$$12,
+    "spire/sections/blocks/Paragraph.tsx": $$$$$$13,
+    "spire/sections/blocks/Quote.tsx": $$$$$$14,
+    "spire/sections/blocks/Stat.tsx": $$$$$$15,
+    "spire/sections/blocks/StatGroup.tsx": $$$$$$16,
+    "spire/sections/blocks/Steps.tsx": $$$$$$17,
+    "spire/sections/blocks/Video.tsx": $$$$$$18,
+    "spire/sections/Seo/SeoBlogPost.tsx": $$$$$$0,
+    "spire/sections/Seo/SeoBlogPostListing.tsx": $$$$$$1,
+    "spire/sections/Template.tsx": $$$$$$2,
+  },
+  "name": "spire",
+  "baseUrl": import.meta.url,
+};
+
+export type Manifest = typeof manifest;
+
+export default manifest;