JavaScript SDK

const butter = Butter("your_api_token", {
  testMode: true,          // Enable preview mode for draft content
  timeout: 5000,           // Request timeout in milliseconds (default: 3000)
  cache: "only-if-cached", // Cache strategy (default: "default")
  onRequest: (resource, config) => {
    // Pre-request hook - modify headers or params
  },
  onResponse: (response, config) => {
    // Post-response hook - process responses
  },
  onError: (errors, config) => {
    // Error handling hook
  }
});

// Retrieve a single page
const page = await butter.page.retrieve("page_type", "page_slug", {
  locale: "en",
  preview: 1,     // Include draft content
  levels: 2       // Depth of nested references
});
console.log(page.data);

// List all pages of a type
const pages = await butter.page.list("page_type", {
  page: 1,
  page_size: 10,
  locale: "en",
  order: "-published"  // Sort by published date descending
});
console.log(pages.data);

// Search pages
const results = await butter.page.search("search query", {
  page: 1,
  page_size: 10
});

// Retrieve collection content
const content = await butter.content.retrieve(["faq", "navigation"], {
  locale: "en",
  levels: 2
});
console.log(content.data.faq);
console.log(content.data.navigation);

// List blog posts
const posts = await butter.post.list({
  page: 1,
  page_size: 10,
  exclude_body: true,  // Exclude body for faster response
  category_slug: "news",
  tag_slug: "featured"
});

// Retrieve a single post
const post = await butter.post.retrieve("post-slug");
console.log(post.data.title);
console.log(post.data.body);

// Search posts
const searchResults = await butter.post.search("search query", {
  page: 1,
  page_size: 10
});

// List all authors
const authors = await butter.author.list({
  include: "recent_posts"
});

// Retrieve a single author
const author = await butter.author.retrieve("jennifer-smith", {
  include: "recent_posts"
});

// List all categories
const categories = await butter.category.list({
  include: "recent_posts"
});

// Retrieve a single category
const category = await butter.category.retrieve("news", {
  include: "recent_posts"
});

// List all tags
const tags = await butter.tag.list({
  include: "recent_posts"
});

// Retrieve a single tag
const tag = await butter.tag.retrieve("featured", {
  include: "recent_posts"
});

// Get RSS feed
const rss = await butter.feed.retrieve("rss");

// Get Atom feed
const atom = await butter.feed.retrieve("atom");

// Get Sitemap
const sitemap = await butter.feed.retrieve("sitemap");

// Cancel all pending post requests
butter.post.cancelRequest();

// Cancel all pending page requests
butter.page.cancelRequest();

import Butter from "buttercms";

const butter = Butter(process.env.BUTTER_API_TOKEN);

async function fetchHomePage() {
  try {
    // Fetch the home page
    const page = await butter.page.retrieve("landing_page", "home", {
      locale: "en"
    });

    // Fetch navigation from collection
    const navigation = await butter.content.retrieve(["main_navigation"]);

    // Fetch recent blog posts
    const posts = await butter.post.list({
      page: 1,
      page_size: 3,
      exclude_body: true
    });

    return {
      page: page.data,
      navigation: navigation.data.main_navigation,
      recentPosts: posts.data
    };
  } catch (error) {
    console.error("Error fetching content:", error);
    throw error;
  }
}

// Usage
fetchHomePage().then(data => {
  console.log("Home page:", data.page);
  console.log("Navigation:", data.navigation);
  console.log("Recent posts:", data.recentPosts);
});