@brandfine/client-astro

Astro adapter for @brandfine/client. Two thin helpers:

• createBrandfineWebhookRoute — wraps the framework-agnostic webhook handler in Astro's APIRoute shape.
• readBrandfineEnv — reads BRANDFINE_API_URL, BRANDFINE_API_KEY, and BRANDFINE_WEBHOOK_SECRET from Vite's import.meta.env with a process.env fallback.

Status: early development (0.x.y). API may change in minor bumps before 1.0.

The actual SDK (client, caches, resolvers) lives in @brandfine/client and is framework-agnostic. Install both:

npm install @brandfine/client @brandfine/client-astro

Webhook route

// src/pages/api/brandfine-webhook.ts
import { createBrandfineWebhookRoute, readBrandfineEnv } from '@brandfine/client-astro'
import { postsCache, navigationsCache, workspaceCache } from '@/lib/bf'

export const prerender = false

export const POST = createBrandfineWebhookRoute({
  secret: readBrandfineEnv().webhookSecret,
  onEvent: ({ event, key }) => {
    postsCache.invalidate()
    workspaceCache.invalidate()
    if (event.startsWith('navigation.')) navigationsCache.invalidate(key ?? undefined)
  },
})

Client construction

// src/lib/bf.ts
import { createBrandfineClient } from '@brandfine/client'
import { readBrandfineEnv } from '@brandfine/client-astro'

const env = readBrandfineEnv()
export const bf = createBrandfineClient({
  baseUrl: env.apiUrl,
  apiKey: env.apiKey,
  // Optional: locales, defaultLocale, fetch
})

Peer requirements

• astro >= 4.0.0 (uses the modern APIRoute shape with Request)
• @brandfine/client (workspace dep — installed automatically)

License

MIT