Arsitektur Dokumentasi

type TulisClientOptions = {
  apiKey: ***
  workspaceId: string;
  host: string;
};

function createTulisClient({ apiKey, workspaceId, host }: TulisClientOptions) {
  const base = `${host.replace(/\/$/, "")}/v1`;

  async function request<T>(path: string, init: RequestInit = {}): Promise<T> {
    const res = await fetch(`${base}${path}`, {
      ...init,
      headers: {
        "Authorization": `Bearer ${apiKey}`,
        "X-Workspace-ID": workspaceId,
        ...(init.headers ?? {}),
      },
    });

    if (!res.ok) {
      throw new Error(`Tulis API error ${res.status}: ${res.statusText}`);
    }

    return (await res.json()) as T;
  }

  return {
    listPosts(opts: { page?: number; perPage?: number } = {}) {
      const params = new URLSearchParams();
      if (opts.page) params.set("page", String(opts.page));
      if (opts.perPage) params.set("per_page", String(opts.perPage));
      const qs = params.toString();
      return request<{
        status: string;
        message: string;
        data: any[];
        meta: { Page: number; PerPage: number; Total: number; TotalPages: number; HasNext: boolean; HasPrev: boolean };
      }>(`/posts${qs ? `?${qs}` : ""}`);
    },

    getPost(slugOrId: string) {
      return request<{ status: string; message: string; data: any; json_ld: object }>(
        `/posts/${encodeURIComponent(slugOrId)}`
      );
    },

    listTaxonomies(type: "category" | "tag") {
      return request<{ status: string; message: string; data: any[] }>(
        `/taxonomies?type=${encodeURIComponent(type)}`
      );
    },

    listComments(postId: string) {
      return request<{ status: string; message: string; data: any[] }>(
        `/posts/${encodeURIComponent(postId)}/comments`
      );
    },

    createComment(payload: { name: string; email: string; post_id: string; content: string }) {
      return request<{ status: string; message: string; data: any }>(`/comments`, {
        method: "POST",
        headers: { "Content-Type": "application/json" },
        body: JSON.stringify(payload),
      });
    },
  };
}

export { createTulisClient };
export type { TulisClientOptions };

import { createTulisClient } from "./tulis-client.js";

// PENTING: jalankan ini hanya di server di mana kunci tidak terekspos ke browser.
const tulis = createTulisClient({
  apiKey: process.env.TULIS_API_KEY,
  workspaceId: process.env.TULIS_WORKSPACE_ID,
  host: process.env.TULIS_HOST,
});

async function renderPostList() {
  const { data: posts, meta } = await tulis.listPosts({ page: 1, perPage: 10 });

  for (const post of posts) {
    console.log(`- ${post.title} (${post.slug})`);
  }

  console.log(`Halaman ${meta.Page}/${meta.TotalPages}, total: ${meta.Total}`);
}

renderPostList().catch((err) => console.error(err));