JavaScript SDK

npm install @octavia/cms-sdk

import { CMS } from "@octavia/cms-sdk";

const cms = CMS.init("sk_live_...", {
  baseUrl: "https://api.octaviatech.app/cms",
  timeoutMs: 30_000,
  throwOnError: false,
});

const res = await cms.article.getAll({ page: 1, limit: 10, categoryId: "..." });

if (res.ok) {
  console.log(res.data);   // the envelope's `data`
  console.log(res.meta);   // pagination metadata
} else {
  console.error(res.error.status, res.error.message);
}

const one  = await cms.article.getById("6810f2c3a1b2c3d4e5f60718");
const hits = await cms.article.search({ query: "typescript", limit: 5 });
const bySlug = await cms.article.getBySlug("hello-world");

const created = await cms.article.create({
  title: "Hello world",
  body: "...",
  categoryId: "6810f2c3a1b2c3d4e5f60712",
  authorId: "6810f2c3a1b2c3d4e5f60719",
});

const updated = await cms.article.update(created.data.id, { title: "Updated" });
await cms.article.delete(created.data.id);

const res = await cms.article.getById("does-not-exist");

if (!res.ok) {
  console.log(res.error.status);   // 404
  console.log(res.error.message);  // human readable
  console.log(res.error.payload);  // full API body
  console.log(res.error.headers);  // response headers, e.g. retry-after
}

import { CMS, ApiError } from "@octavia/cms-sdk";

const cms = CMS.init(key, { throwOnError: true });

try {
  await cms.article.getById("does-not-exist");
} catch (err) {
  if (err instanceof ApiError) {
    console.log(err.status, err.payload);
  }
}

const cms = CMS.init(key, { timeoutMs: 5_000 });

const ac = new AbortController();
setTimeout(() => ac.abort(), 3_000);

const res = await cms.article.getAll({}, { signal: ac.signal });

const res = await cms.raw.request("GET", "/articles/advancedSearch", {
  query: { body: { minWords: 500 } },
});