Files
blog/frontend/server/utils/pocketbase.ts
T
davide 49c42ecc96 Replace Strapi CMS with PocketBase
Strapi + Postgres are gone in favor of PocketBase: a single Go binary
with embedded SQLite, built-in admin UI and per-collection API rules.
No content existed yet, so this is a clean swap with no data migration.

Collections and rules are defined as code in pocketbase/pb_migrations/
and applied automatically on first boot. Draft & Publish has no native
PocketBase equivalent, so it's reproduced with a nullable `publishedAt`
field enforced by listRule/viewRule, matching the old Strapi semantics.

Routing flips: PocketBase's admin UI and REST/file API are hardwired to
`/_/` and `/api/*` at the domain root (its own dashboard assets and API
calls reference those paths directly, so a stripped path prefix like
`/admin/*` would break them). `/api` is therefore reserved for
PocketBase now, and the frontend's Nitro endpoints move to `/content/*`
(frontend/server/routes/content/, not server/api/). A `/admin` vanity
route in Nitro (not Caddy) redirects to `/_/`, so it works the same in
dev, where Caddy isn't part of the stack, and in production.

frontend/server/utils/strapi.ts becomes pocketbase.ts; queries.ts is
rewritten for PocketBase's filter/sort/fields/expand query syntax.
StrapiImage becomes MediaImage (no width/height — PocketBase file
fields don't store dimensions, and the cover images already reserve
their aspect ratio via CSS, so this is not a regression).

docs/*.md, CLAUDE.md and README.md are updated in the same commit.
2026-09-11 11:25:14 +02:00

70 lines
2.1 KiB
TypeScript

import { marked } from 'marked'
import type { MediaImage } from '#shared/types/blog'
/**
* Calls the PocketBase REST API from the server only, so the internal URL
* never reaches the browser.
*/
export async function pbFetch<T>(path: string): Promise<T> {
const { pocketbaseUrl } = useRuntimeConfig()
try {
return (await $fetch(path, { baseURL: pocketbaseUrl })) as T
} catch (error) {
console.error(`PocketBase request failed: ${path}`, error)
throw createError({ statusCode: 502, statusMessage: 'Content service unavailable' })
}
}
/**
* Renders the Markdown body server-side, so the HTML is crawlable and `marked`
* stays out of the client bundle.
*
* ponytail: no HTML sanitisation — article bodies come from authenticated
* editors only. Add DOMPurify here if authoring is ever opened up further.
*/
export function renderMarkdown(source: string | null | undefined): string {
return source ? (marked.parse(source, { async: false }) as string) : ''
}
/**
* There is no excerpt field: the meta description is the opening of the body,
* stripped of Markdown syntax and clipped on a word boundary.
*/
export function summarise(source: string | null | undefined, maxLength = 155): string {
const text = (source ?? '')
.replace(/```[\s\S]*?```/g, ' ')
.replace(/!\[[^\]]*\]\([^)]*\)/g, ' ')
.replace(/\[([^\]]*)\]\([^)]*\)/g, '$1')
.replace(/[#>*_`~-]/g, ' ')
.replace(/\s+/g, ' ')
.trim()
if (text.length <= maxLength) return text
const clipped = text.slice(0, maxLength)
return `${clipped.slice(0, clipped.lastIndexOf(' ')).trimEnd()}…`
}
export interface PbList<T> {
page: number
perPage: number
totalItems: number
totalPages: number
items: T[]
}
/**
* Builds a PocketBase file URL, relative to its own origin — PocketBase file
* fields store only a filename, not a full path or dimensions.
*/
export function toMediaImage(
collection: string,
id: string,
filename: string | null | undefined,
alt: string | null | undefined
): MediaImage | null {
if (!filename) return null
return { url: `/api/files/${collection}/${id}/${filename}`, alt: alt || null }
}