Articles API

import { SimplistClient } from "@simplist.blog/sdk"

// Uses SIMPLIST_API_KEY from environment variables
const client = new SimplistClient()

const response = await client.articles.get('my-article-slug')

if (response.data) {
  const article = response.data
  console.log(article.title)
  console.log(article.content)
  console.log(article.author.name)
  console.log(`${article.readTimeMinutes} min read`)
}

const response = await client.articles.list({
  page: 1,
  limit: 20,
  sort: 'createdAt',
  order: 'desc',
  published: true
})

if (response.data) {
  const articles = response.data
  const { page, limit, total, totalPages } = response.meta

  console.log(`Page ${page} of ${totalPages}`)
  console.log(`Showing ${articles.length} of ${total} articles`)
}

{
  page: 1,           // Current page
  limit: 20,         // Items per page
  total: 157,        // Total items
  totalPages: 8      // Total pages
}

// Get 10 latest articles
const response = await client.articles.latest(10)

// Custom limit
const response = await client.articles.latest(25)

const response = await client.articles.published({
  page: 1,
  limit: 20,
  sort: 'title',
  order: 'asc'
})

// All parameters are optional
const response = await client.articles.published()

// Get 10 most popular articles
const response = await client.articles.popular(10)

// Custom limit
const response = await client.articles.popular(20)

// Simple search
const results = await client.articles.search('React hooks')

// Search with filters
const results = await client.articles.search('React hooks', {
  page: 1,
  limit: 10,
  sort: 'createdAt',
  order: 'desc'
})

const xml = await client.articles.rss({
  hostname: 'https://myblog.com',
  title: 'My Blog',
  description: 'Latest articles from my blog',
  limit: 50
})

// In Next.js API route
export async function GET() {
  const xml = await client.articles.rss({
    hostname: process.env.NEXT_PUBLIC_URL
  })

  return new Response(xml, {
    headers: {
      'Content-Type': 'application/xml',
      'Cache-Control': 'public, max-age=3600'
    }
  })
}

try {
  const response = await client.articles.get('article-slug')

  if (response.data) {
    console.log(response.data.title)
  }
} catch (error) {
  if (error instanceof SimplistApiError) {
    console.error(`API Error [${error.statusCode}]: ${error.message}`)
  } else {
    console.error('Unexpected error:', error)
  }
}

import { SimplistClient } from "@simplist.blog/sdk"

const client = new SimplistClient({
  apiKey: process.env.SIMPLIST_API_KEY
})

// Fetch latest articles for homepage
async function getHomepageArticles() {
  const response = await client.articles.latest(6)
  return response.data || []
}

// Fetch article for blog post page
async function getArticle(slug: string) {
  const response = await client.articles.get(slug)

  if (!response.data) {
    return null
  }

  return response.data
}

// Paginated article list
async function getArticlePage(page: number = 1) {
  const response = await client.articles.published({
    page,
    limit: 12,
    sort: 'publishedAt',
    order: 'desc'
  })

  return {
    articles: response.data || [],
    pagination: response.meta
  }
}

// Search functionality
async function searchArticles(query: string) {
  if (!query.trim()) {
    return []
  }

  const response = await client.articles.search(query, {
    limit: 20
  })

  return response.data || []
}