@taisan11/zenn.js 0.1.0

package/README.md

@@ -0,0 +1,15 @@
+# zenn.js
+
+To install dependencies:
+
+```bash
+bun install
+```
+
+To run:
+
+```bash
+bun run index.ts
+```
+
+This project was created using `bun init` in bun v1.3.14. [Bun](https://bun.com) is a fast all-in-one JavaScript runtime.

package/dist/client.d.ts

@@ -0,0 +1,40 @@
+import type { ArticleDetail, ArticleResponse, ArticlesResponse, BookResponse, BooksResponse, ChapterResponse, ClientOptions, ListArticlesOptions, ListBooksOptions, ListFollowersOptions, ListScrapsOptions, ListUsersCommentsOptions, PublicationMini, PublicationResponse, ScrapsResponse, ScrapResponse, SearchOptions, SearchResponse, SearchSource, TopicResponse, TopicsResponse, UserCommentsResponse, UserResponse, UsersResponse, Event } from "./types";
+export declare class ZennApiError extends Error {
+    status: number;
+    body: unknown;
+    constructor(status: number, body: unknown, message: string);
+}
+export interface PublicationsMiniResponse {
+    publications: PublicationMini[];
+    next_page: number | null;
+}
+export declare class ZennClient {
+    private readonly baseUrl;
+    private readonly fetcher;
+    private readonly headers;
+    constructor(options?: ClientOptions);
+    private request;
+    listArticles(options?: ListArticlesOptions): Promise<ArticlesResponse>;
+    getArticle(slug: string): Promise<ArticleResponse>;
+    getArticleById(id: number): Promise<ArticleResponse>;
+    iterArticles(options?: Omit<ListArticlesOptions, "page">): AsyncGenerator<ArticleDetail, void, void>;
+    listBooks(options?: ListBooksOptions): Promise<BooksResponse>;
+    getBook(slug: string): Promise<BookResponse>;
+    getChapter(id: number): Promise<ChapterResponse>;
+    listScraps(options?: ListScrapsOptions): Promise<ScrapsResponse>;
+    getScrap(slug: string): Promise<ScrapResponse>;
+    getUser(username: string): Promise<UserResponse>;
+    getCurrentUser(): Promise<UserResponse>;
+    getUserFollowers(username: string, options?: ListFollowersOptions): Promise<UsersResponse>;
+    getUserFollowingsUsers(username: string, options?: ListFollowersOptions): Promise<UsersResponse>;
+    getUserFollowingsPublications(username: string, options?: ListFollowersOptions): Promise<PublicationsMiniResponse>;
+    getUserComments(username: string, options?: ListUsersCommentsOptions): Promise<UserCommentsResponse>;
+    getPublication(name: string): Promise<PublicationResponse>;
+    getPublicationFollowers(name: string, options?: ListFollowersOptions): Promise<UsersResponse>;
+    listTopics(): Promise<TopicsResponse>;
+    getTopic(name: string): Promise<TopicResponse>;
+    search<TSource extends SearchSource>(options: SearchOptions & {
+        source: TSource;
+    }): Promise<SearchResponse<TSource>>;
+    listEvents(): Promise<Event[]>;
+}

package/dist/index.cjs

@@ -0,0 +1,172 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toCommonJS = (from) => {
+  var entry = (__moduleCache ??= new WeakMap).get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (var key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(entry, key))
+        __defProp(entry, key, {
+          get: __accessProp.bind(from, key),
+          enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+        });
+  }
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __moduleCache;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+
+// src/index.ts
+var exports_src = {};
+__export(exports_src, {
+  ZennClient: () => ZennClient,
+  ZennApiError: () => ZennApiError
+});
+module.exports = __toCommonJS(exports_src);
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://zenn.dev";
+
+class ZennApiError extends Error {
+  status;
+  body;
+  constructor(status, body, message) {
+    super(message);
+    this.name = "ZennApiError";
+    this.status = status;
+    this.body = body;
+  }
+}
+function buildQuery(params) {
+  if (!params)
+    return "";
+  const search = new URLSearchParams;
+  for (const [k, v] of Object.entries(params)) {
+    if (v === undefined || v === null || v === "")
+      continue;
+    search.set(k, String(v));
+  }
+  const qs = search.toString();
+  return qs.length > 0 ? `?${qs}` : "";
+}
+
+class ZennClient {
+  baseUrl;
+  fetcher;
+  headers;
+  constructor(options = {}) {
+    this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+    this.fetcher = options.fetch ?? fetch;
+    this.headers = options.headers ?? {};
+  }
+  async request(path, params) {
+    const url = `${this.baseUrl}${path}${buildQuery(params)}`;
+    const res = await this.fetcher(url, {
+      headers: {
+        Accept: "application/json",
+        ...this.headers
+      }
+    });
+    const text = await res.text();
+    const data = text.length > 0 ? JSON.parse(text) : null;
+    if (!res.ok) {
+      throw new ZennApiError(res.status, data, `Zenn API request failed: ${res.status} ${res.statusText} (${url})`);
+    }
+    return data;
+  }
+  listArticles(options = {}) {
+    return this.request("/api/articles", options);
+  }
+  getArticle(slug) {
+    return this.request(`/api/articles/${encodeURIComponent(slug)}`);
+  }
+  getArticleById(id) {
+    return this.request("/api/articles", { id });
+  }
+  async* iterArticles(options = {}) {
+    let page = 1;
+    while (true) {
+      const res = await this.listArticles({ ...options, page });
+      for (const item of res.articles) {
+        const detail = await this.getArticle(item.slug);
+        yield detail.article;
+      }
+      if (res.next_page === null || res.next_page === undefined)
+        break;
+      page = res.next_page;
+    }
+  }
+  listBooks(options = {}) {
+    return this.request("/api/books", options);
+  }
+  getBook(slug) {
+    return this.request(`/api/books/${encodeURIComponent(slug)}`);
+  }
+  getChapter(id) {
+    return this.request(`/api/chapters/${id}`);
+  }
+  listScraps(options = {}) {
+    return this.request("/api/scraps", options);
+  }
+  getScrap(slug) {
+    return this.request(`/api/scraps/${encodeURIComponent(slug)}`);
+  }
+  getUser(username) {
+    return this.request(`/api/users/${encodeURIComponent(username)}`);
+  }
+  getCurrentUser() {
+    return this.request("/api/users/current");
+  }
+  getUserFollowers(username, options = {}) {
+    return this.request(`/api/users/${encodeURIComponent(username)}/followers`, options);
+  }
+  getUserFollowingsUsers(username, options = {}) {
+    return this.request(`/api/users/${encodeURIComponent(username)}/followings/users`, options);
+  }
+  getUserFollowingsPublications(username, options = {}) {
+    return this.request(`/api/users/${encodeURIComponent(username)}/followings/publications`, options);
+  }
+  getUserComments(username, options = {}) {
+    return this.request(`/api/users/${encodeURIComponent(username)}/comments`, options);
+  }
+  getPublication(name) {
+    return this.request(`/api/publications/${encodeURIComponent(name)}`);
+  }
+  getPublicationFollowers(name, options = {}) {
+    return this.request(`/api/publications/${encodeURIComponent(name)}/followers`, options);
+  }
+  listTopics() {
+    return this.request("/api/topics");
+  }
+  getTopic(name) {
+    return this.request(`/api/topics/${encodeURIComponent(name)}`);
+  }
+  search(options) {
+    return this.request("/api/search", options);
+  }
+  listEvents() {
+    return this.request("/api/events");
+  }
+}
+
+//# debugId=A4B2F835B9C68E8564756E2164756E21

package/dist/index.cjs.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/client.ts"],
+  "sourcesContent": [
+    "import type {\n  ArticleDetail,\n  ArticleResponse,\n  ArticlesResponse,\n  BookResponse,\n  BooksResponse,\n  ChapterResponse,\n  ClientOptions,\n  ListArticlesOptions,\n  ListBooksOptions,\n  ListFollowersOptions,\n  ListScrapsOptions,\n  ListUsersCommentsOptions,\n  PublicationMini,\n  PublicationResponse,\n  ScrapsResponse,\n  ScrapResponse,\n  SearchOptions,\n  SearchResponse,\n  SearchSource,\n  TopicResponse,\n  TopicsResponse,\n  UserCommentsResponse,\n  UserResponse,\n  UsersResponse,\n  Event,\n} from \"./types.ts\";\n\nconst DEFAULT_BASE_URL = \"https://zenn.dev\";\n\nexport class ZennApiError extends Error {\n  status: number;\n  body: unknown;\n\n  constructor(status: number, body: unknown, message: string) {\n    super(message);\n    this.name = \"ZennApiError\";\n    this.status = status;\n    this.body = body;\n  }\n}\n\nexport interface PublicationsMiniResponse {\n  publications: PublicationMini[];\n  next_page: number | null;\n}\n\nfunction buildQuery(params: object | undefined): string {\n  if (!params) return \"\";\n  const search = new URLSearchParams();\n  for (const [k, v] of Object.entries(params)) {\n    if (v === undefined || v === null || v === \"\") continue;\n    search.set(k, String(v));\n  }\n  const qs = search.toString();\n  return qs.length > 0 ? `?${qs}` : \"\";\n}\n\nexport class ZennClient {\n  private readonly baseUrl: string;\n  private readonly fetcher: typeof fetch;\n  private readonly headers: HeadersInit;\n\n  constructor(options: ClientOptions = {}) {\n    this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\n    this.fetcher = options.fetch ?? fetch;\n    this.headers = options.headers ?? {};\n  }\n\n  private async request<T>(path: string, params?: object): Promise<T> {\n    const url = `${this.baseUrl}${path}${buildQuery(params)}`;\n    const res = await this.fetcher(url, {\n      headers: {\n        Accept: \"application/json\",\n        ...this.headers,\n      },\n    });\n    const text = await res.text();\n    const data: unknown = text.length > 0 ? JSON.parse(text) : null;\n    if (!res.ok) {\n      throw new ZennApiError(res.status, data, `Zenn API request failed: ${res.status} ${res.statusText} (${url})`);\n    }\n    return data as T;\n  }\n\n  // ---------- Articles ----------\n\n  listArticles(options: ListArticlesOptions = {}): Promise<ArticlesResponse> {\n    return this.request<ArticlesResponse>(\"/api/articles\", options);\n  }\n\n  getArticle(slug: string): Promise<ArticleResponse> {\n    return this.request<ArticleResponse>(`/api/articles/${encodeURIComponent(slug)}`);\n  }\n\n  getArticleById(id: number): Promise<ArticleResponse> {\n    return this.request<ArticleResponse>(\"/api/articles\", { id });\n  }\n\n  async *iterArticles(options: Omit<ListArticlesOptions, \"page\"> = {}): AsyncGenerator<ArticleDetail, void, void> {\n    let page = 1;\n    while (true) {\n      const res = await this.listArticles({ ...options, page });\n      for (const item of res.articles) {\n        const detail = await this.getArticle(item.slug);\n        yield detail.article;\n      }\n      if (res.next_page === null || res.next_page === undefined) break;\n      page = res.next_page;\n    }\n  }\n\n  // ---------- Books ----------\n\n  listBooks(options: ListBooksOptions = {}): Promise<BooksResponse> {\n    return this.request<BooksResponse>(\"/api/books\", options);\n  }\n\n  getBook(slug: string): Promise<BookResponse> {\n    return this.request<BookResponse>(`/api/books/${encodeURIComponent(slug)}`);\n  }\n\n  getChapter(id: number): Promise<ChapterResponse> {\n    return this.request<ChapterResponse>(`/api/chapters/${id}`);\n  }\n\n  // ---------- Scraps ----------\n\n  listScraps(options: ListScrapsOptions = {}): Promise<ScrapsResponse> {\n    return this.request<ScrapsResponse>(\"/api/scraps\", options);\n  }\n\n  getScrap(slug: string): Promise<ScrapResponse> {\n    return this.request<ScrapResponse>(`/api/scraps/${encodeURIComponent(slug)}`);\n  }\n\n  // ---------- Users ----------\n\n  getUser(username: string): Promise<UserResponse> {\n    return this.request<UserResponse>(`/api/users/${encodeURIComponent(username)}`);\n  }\n\n  getCurrentUser(): Promise<UserResponse> {\n    return this.request<UserResponse>(\"/api/users/current\");\n  }\n\n  getUserFollowers(username: string, options: ListFollowersOptions = {}): Promise<UsersResponse> {\n    return this.request<UsersResponse>(`/api/users/${encodeURIComponent(username)}/followers`, options);\n  }\n\n  getUserFollowingsUsers(username: string, options: ListFollowersOptions = {}): Promise<UsersResponse> {\n    return this.request<UsersResponse>(`/api/users/${encodeURIComponent(username)}/followings/users`, options);\n  }\n\n  getUserFollowingsPublications(\n    username: string,\n    options: ListFollowersOptions = {},\n  ): Promise<PublicationsMiniResponse> {\n    return this.request<PublicationsMiniResponse>(\n      `/api/users/${encodeURIComponent(username)}/followings/publications`,\n      options,\n    );\n  }\n\n  getUserComments(username: string, options: ListUsersCommentsOptions = {}): Promise<UserCommentsResponse> {\n    return this.request<UserCommentsResponse>(`/api/users/${encodeURIComponent(username)}/comments`, options);\n  }\n\n  // ---------- Publications ----------\n\n  getPublication(name: string): Promise<PublicationResponse> {\n    return this.request<PublicationResponse>(`/api/publications/${encodeURIComponent(name)}`);\n  }\n\n  getPublicationFollowers(name: string, options: ListFollowersOptions = {}): Promise<UsersResponse> {\n    return this.request<UsersResponse>(`/api/publications/${encodeURIComponent(name)}/followers`, options);\n  }\n\n  // ---------- Topics ----------\n\n  listTopics(): Promise<TopicsResponse> {\n    return this.request<TopicsResponse>(\"/api/topics\");\n  }\n\n  getTopic(name: string): Promise<TopicResponse> {\n    return this.request<TopicResponse>(`/api/topics/${encodeURIComponent(name)}`);\n  }\n\n  // ---------- Search ----------\n\n  search<TSource extends SearchSource>(\n    options: SearchOptions & { source: TSource },\n  ): Promise<SearchResponse<TSource>> {\n    return this.request<SearchResponse<TSource>>(\"/api/search\", options);\n  }\n\n  // ---------- Events ----------\n\n  listEvents(): Promise<Event[]> {\n    return this.request<Event[]>(\"/api/events\");\n  }\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "A4B2F835B9C68E8564756E2164756E21",
+  "names": []
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./types";
+export { ZennClient, ZennApiError } from "./client";

package/dist/index.js

@@ -0,0 +1,130 @@
+// src/client.ts
+var DEFAULT_BASE_URL = "https://zenn.dev";
+
+class ZennApiError extends Error {
+  status;
+  body;
+  constructor(status, body, message) {
+    super(message);
+    this.name = "ZennApiError";
+    this.status = status;
+    this.body = body;
+  }
+}
+function buildQuery(params) {
+  if (!params)
+    return "";
+  const search = new URLSearchParams;
+  for (const [k, v] of Object.entries(params)) {
+    if (v === undefined || v === null || v === "")
+      continue;
+    search.set(k, String(v));
+  }
+  const qs = search.toString();
+  return qs.length > 0 ? `?${qs}` : "";
+}
+
+class ZennClient {
+  baseUrl;
+  fetcher;
+  headers;
+  constructor(options = {}) {
+    this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+    this.fetcher = options.fetch ?? fetch;
+    this.headers = options.headers ?? {};
+  }
+  async request(path, params) {
+    const url = `${this.baseUrl}${path}${buildQuery(params)}`;
+    const res = await this.fetcher(url, {
+      headers: {
+        Accept: "application/json",
+        ...this.headers
+      }
+    });
+    const text = await res.text();
+    const data = text.length > 0 ? JSON.parse(text) : null;
+    if (!res.ok) {
+      throw new ZennApiError(res.status, data, `Zenn API request failed: ${res.status} ${res.statusText} (${url})`);
+    }
+    return data;
+  }
+  listArticles(options = {}) {
+    return this.request("/api/articles", options);
+  }
+  getArticle(slug) {
+    return this.request(`/api/articles/${encodeURIComponent(slug)}`);
+  }
+  getArticleById(id) {
+    return this.request("/api/articles", { id });
+  }
+  async* iterArticles(options = {}) {
+    let page = 1;
+    while (true) {
+      const res = await this.listArticles({ ...options, page });
+      for (const item of res.articles) {
+        const detail = await this.getArticle(item.slug);
+        yield detail.article;
+      }
+      if (res.next_page === null || res.next_page === undefined)
+        break;
+      page = res.next_page;
+    }
+  }
+  listBooks(options = {}) {
+    return this.request("/api/books", options);
+  }
+  getBook(slug) {
+    return this.request(`/api/books/${encodeURIComponent(slug)}`);
+  }
+  getChapter(id) {
+    return this.request(`/api/chapters/${id}`);
+  }
+  listScraps(options = {}) {
+    return this.request("/api/scraps", options);
+  }
+  getScrap(slug) {
+    return this.request(`/api/scraps/${encodeURIComponent(slug)}`);
+  }
+  getUser(username) {
+    return this.request(`/api/users/${encodeURIComponent(username)}`);
+  }
+  getCurrentUser() {
+    return this.request("/api/users/current");
+  }
+  getUserFollowers(username, options = {}) {
+    return this.request(`/api/users/${encodeURIComponent(username)}/followers`, options);
+  }
+  getUserFollowingsUsers(username, options = {}) {
+    return this.request(`/api/users/${encodeURIComponent(username)}/followings/users`, options);
+  }
+  getUserFollowingsPublications(username, options = {}) {
+    return this.request(`/api/users/${encodeURIComponent(username)}/followings/publications`, options);
+  }
+  getUserComments(username, options = {}) {
+    return this.request(`/api/users/${encodeURIComponent(username)}/comments`, options);
+  }
+  getPublication(name) {
+    return this.request(`/api/publications/${encodeURIComponent(name)}`);
+  }
+  getPublicationFollowers(name, options = {}) {
+    return this.request(`/api/publications/${encodeURIComponent(name)}/followers`, options);
+  }
+  listTopics() {
+    return this.request("/api/topics");
+  }
+  getTopic(name) {
+    return this.request(`/api/topics/${encodeURIComponent(name)}`);
+  }
+  search(options) {
+    return this.request("/api/search", options);
+  }
+  listEvents() {
+    return this.request("/api/events");
+  }
+}
+export {
+  ZennClient,
+  ZennApiError
+};
+
+//# debugId=5FC52C405406CC4064756E2164756E21

package/dist/index.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/client.ts"],
+  "sourcesContent": [
+    "import type {\n  ArticleDetail,\n  ArticleResponse,\n  ArticlesResponse,\n  BookResponse,\n  BooksResponse,\n  ChapterResponse,\n  ClientOptions,\n  ListArticlesOptions,\n  ListBooksOptions,\n  ListFollowersOptions,\n  ListScrapsOptions,\n  ListUsersCommentsOptions,\n  PublicationMini,\n  PublicationResponse,\n  ScrapsResponse,\n  ScrapResponse,\n  SearchOptions,\n  SearchResponse,\n  SearchSource,\n  TopicResponse,\n  TopicsResponse,\n  UserCommentsResponse,\n  UserResponse,\n  UsersResponse,\n  Event,\n} from \"./types.ts\";\n\nconst DEFAULT_BASE_URL = \"https://zenn.dev\";\n\nexport class ZennApiError extends Error {\n  status: number;\n  body: unknown;\n\n  constructor(status: number, body: unknown, message: string) {\n    super(message);\n    this.name = \"ZennApiError\";\n    this.status = status;\n    this.body = body;\n  }\n}\n\nexport interface PublicationsMiniResponse {\n  publications: PublicationMini[];\n  next_page: number | null;\n}\n\nfunction buildQuery(params: object | undefined): string {\n  if (!params) return \"\";\n  const search = new URLSearchParams();\n  for (const [k, v] of Object.entries(params)) {\n    if (v === undefined || v === null || v === \"\") continue;\n    search.set(k, String(v));\n  }\n  const qs = search.toString();\n  return qs.length > 0 ? `?${qs}` : \"\";\n}\n\nexport class ZennClient {\n  private readonly baseUrl: string;\n  private readonly fetcher: typeof fetch;\n  private readonly headers: HeadersInit;\n\n  constructor(options: ClientOptions = {}) {\n    this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\n    this.fetcher = options.fetch ?? fetch;\n    this.headers = options.headers ?? {};\n  }\n\n  private async request<T>(path: string, params?: object): Promise<T> {\n    const url = `${this.baseUrl}${path}${buildQuery(params)}`;\n    const res = await this.fetcher(url, {\n      headers: {\n        Accept: \"application/json\",\n        ...this.headers,\n      },\n    });\n    const text = await res.text();\n    const data: unknown = text.length > 0 ? JSON.parse(text) : null;\n    if (!res.ok) {\n      throw new ZennApiError(res.status, data, `Zenn API request failed: ${res.status} ${res.statusText} (${url})`);\n    }\n    return data as T;\n  }\n\n  // ---------- Articles ----------\n\n  listArticles(options: ListArticlesOptions = {}): Promise<ArticlesResponse> {\n    return this.request<ArticlesResponse>(\"/api/articles\", options);\n  }\n\n  getArticle(slug: string): Promise<ArticleResponse> {\n    return this.request<ArticleResponse>(`/api/articles/${encodeURIComponent(slug)}`);\n  }\n\n  getArticleById(id: number): Promise<ArticleResponse> {\n    return this.request<ArticleResponse>(\"/api/articles\", { id });\n  }\n\n  async *iterArticles(options: Omit<ListArticlesOptions, \"page\"> = {}): AsyncGenerator<ArticleDetail, void, void> {\n    let page = 1;\n    while (true) {\n      const res = await this.listArticles({ ...options, page });\n      for (const item of res.articles) {\n        const detail = await this.getArticle(item.slug);\n        yield detail.article;\n      }\n      if (res.next_page === null || res.next_page === undefined) break;\n      page = res.next_page;\n    }\n  }\n\n  // ---------- Books ----------\n\n  listBooks(options: ListBooksOptions = {}): Promise<BooksResponse> {\n    return this.request<BooksResponse>(\"/api/books\", options);\n  }\n\n  getBook(slug: string): Promise<BookResponse> {\n    return this.request<BookResponse>(`/api/books/${encodeURIComponent(slug)}`);\n  }\n\n  getChapter(id: number): Promise<ChapterResponse> {\n    return this.request<ChapterResponse>(`/api/chapters/${id}`);\n  }\n\n  // ---------- Scraps ----------\n\n  listScraps(options: ListScrapsOptions = {}): Promise<ScrapsResponse> {\n    return this.request<ScrapsResponse>(\"/api/scraps\", options);\n  }\n\n  getScrap(slug: string): Promise<ScrapResponse> {\n    return this.request<ScrapResponse>(`/api/scraps/${encodeURIComponent(slug)}`);\n  }\n\n  // ---------- Users ----------\n\n  getUser(username: string): Promise<UserResponse> {\n    return this.request<UserResponse>(`/api/users/${encodeURIComponent(username)}`);\n  }\n\n  getCurrentUser(): Promise<UserResponse> {\n    return this.request<UserResponse>(\"/api/users/current\");\n  }\n\n  getUserFollowers(username: string, options: ListFollowersOptions = {}): Promise<UsersResponse> {\n    return this.request<UsersResponse>(`/api/users/${encodeURIComponent(username)}/followers`, options);\n  }\n\n  getUserFollowingsUsers(username: string, options: ListFollowersOptions = {}): Promise<UsersResponse> {\n    return this.request<UsersResponse>(`/api/users/${encodeURIComponent(username)}/followings/users`, options);\n  }\n\n  getUserFollowingsPublications(\n    username: string,\n    options: ListFollowersOptions = {},\n  ): Promise<PublicationsMiniResponse> {\n    return this.request<PublicationsMiniResponse>(\n      `/api/users/${encodeURIComponent(username)}/followings/publications`,\n      options,\n    );\n  }\n\n  getUserComments(username: string, options: ListUsersCommentsOptions = {}): Promise<UserCommentsResponse> {\n    return this.request<UserCommentsResponse>(`/api/users/${encodeURIComponent(username)}/comments`, options);\n  }\n\n  // ---------- Publications ----------\n\n  getPublication(name: string): Promise<PublicationResponse> {\n    return this.request<PublicationResponse>(`/api/publications/${encodeURIComponent(name)}`);\n  }\n\n  getPublicationFollowers(name: string, options: ListFollowersOptions = {}): Promise<UsersResponse> {\n    return this.request<UsersResponse>(`/api/publications/${encodeURIComponent(name)}/followers`, options);\n  }\n\n  // ---------- Topics ----------\n\n  listTopics(): Promise<TopicsResponse> {\n    return this.request<TopicsResponse>(\"/api/topics\");\n  }\n\n  getTopic(name: string): Promise<TopicResponse> {\n    return this.request<TopicResponse>(`/api/topics/${encodeURIComponent(name)}`);\n  }\n\n  // ---------- Search ----------\n\n  search<TSource extends SearchSource>(\n    options: SearchOptions & { source: TSource },\n  ): Promise<SearchResponse<TSource>> {\n    return this.request<SearchResponse<TSource>>(\"/api/search\", options);\n  }\n\n  // ---------- Events ----------\n\n  listEvents(): Promise<Event[]> {\n    return this.request<Event[]>(\"/api/events\");\n  }\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "5FC52C405406CC4064756E2164756E21",
+  "names": []
+}

package/dist/types.d.ts

@@ -0,0 +1,468 @@
+/**
+ * Type definitions for the public Zenn API (https://zenn.dev/api/*).
+ *
+ * All payloads are returned as snake_case keys from the server, so the
+ * types below mirror that wire format. Optional fields are flagged with
+ * `?` only when the server has been observed to omit them.
+ */
+export type Iso8601 = string;
+export type ArticleType = "tech" | "idea";
+export type PostType = "Article" | "Book" | "Scrap" | "Comment" | "Chapter";
+export type PrincipalType = "User" | "Publication";
+export type CommentableType = "Article" | "Scrap";
+export type EventType = "contest" | "hackathon" | "event";
+export type PrizeRank = "grand_prize" | "winner" | "runner_up" | "participant" | (string & {});
+export interface UserMini {
+    id: number;
+    username: string;
+    name: string;
+    avatar_small_url: string;
+    avatar_url?: string;
+}
+export interface PublicationMini {
+    id: number;
+    name: string;
+    display_name: string;
+    avatar_small_url: string;
+    avatar_url: string;
+    pro: boolean;
+    avatar_registered: boolean;
+}
+export interface PublicationArticleOverride {
+    publication_id: number;
+    pathname: string;
+    title: string;
+    author_type: "Publication" | "User";
+    publication_avatar_registered?: boolean;
+}
+export interface Topic {
+    id: number;
+    name: string;
+    taggings_count: number;
+    image_url: string;
+    display_name: string;
+}
+export interface TocItem {
+    id: string;
+    text: string;
+    level: number;
+    children: TocItem[];
+}
+export interface UserAward {
+    event_slug: string;
+    event_title: string;
+    event_type: EventType;
+    prize_rank: PrizeRank;
+    prize_display_name: string;
+    article: ArticleListItem;
+}
+export interface User {
+    id: number;
+    username: string;
+    name: string;
+    avatar_small_url: string;
+    avatar_url: string;
+    bio: string;
+    autolinked_bio: string;
+    github_username: string | null;
+    twitter_username: string | null;
+    is_support_open: boolean;
+    tokusyo_contact: string | null;
+    tokusyo_name: string | null;
+    website_url: string | null;
+    website_domain: string | null;
+    total_liked_count: number;
+    ga_tracking_id: string | null;
+    hatena_id: string | null;
+    is_invoice_issuer: boolean;
+    follower_count: number;
+    following_count: number;
+    following_user_count: number;
+    following_publication_count: number;
+    badge_count: number;
+    articles_count: number;
+    books_count: number;
+    scraps_count: number;
+    awards: UserAward[];
+}
+export interface PublicationNavigation {
+    id: number;
+    position: number;
+    label: string;
+    url: string;
+}
+export interface PublicationArticleList {
+    id: number;
+    name: string;
+    slug: string;
+    description: string;
+    articles_count: number;
+    position: number;
+}
+export interface Publication {
+    id: number;
+    name: string;
+    display_name: string;
+    avatar_small_url: string;
+    avatar_url: string;
+    pro: boolean;
+    avatar_registered: boolean;
+    description: string;
+    autolinked_description: string;
+    twitter_username: string | null;
+    github_username: string | null;
+    cover_image_url: string;
+    fixed_sentences_html: string;
+    is_support_open: boolean;
+    is_article_comment_open: boolean;
+    ga_tracking_id: string | null;
+    follower_count: number;
+    sponsor_count: number;
+    navigations: PublicationNavigation[];
+    article_lists: PublicationArticleList[];
+    has_recent_article_lists: boolean;
+}
+export interface GitHubRepository {
+    id: number;
+    owner_name: string;
+    repo_name: string;
+}
+export interface ArticleListItem {
+    id: number;
+    post_type: "Article";
+    slug: string;
+    comments_count: number;
+    liked_count: number;
+    bookmarked_count: number;
+    body_letters_count: number;
+    article_type: ArticleType;
+    emoji: string;
+    is_suspending_private: boolean;
+    published_at: Iso8601;
+    body_updated_at: Iso8601;
+    source_repo_updated_at: Iso8601 | null;
+    pinned: boolean;
+    path: string;
+    principal_type: PrincipalType;
+    title: string;
+    user: UserMini;
+    publication: PublicationMini | null;
+    publication_article_override: PublicationArticleOverride | null;
+}
+export interface ArticlesResponse {
+    articles: ArticleListItem[];
+    next_page: number | null;
+    total_count?: number;
+}
+export interface ArticleDetail extends ArticleListItem {
+    toc_enabled: boolean;
+    should_noindex: boolean;
+    scheduled_publish_at: Iso8601 | null;
+    can_send_badge: boolean;
+    status: "published" | "draft" | (string & {});
+    og_image_url: string;
+    body_html: string;
+    toc: TocItem[];
+    badges: ArticleBadge[];
+    is_mine: boolean;
+    is_preview: boolean;
+    draft_reveal_scope: string | null;
+    current_user_liked: boolean;
+    current_user_bookmarked: boolean;
+    github_repository: GitHubRepository | null;
+    publication_article_override: PublicationArticleOverride | null;
+    contest: ArticleContest | null;
+    topics: Topic[];
+    top_article_list: unknown;
+    comments: ArticleComment[];
+    positive_comments_count: number;
+    commented_users: UserMini[];
+}
+export interface ArticleResponse {
+    article: ArticleDetail;
+}
+export interface ArticleBadge {
+    badge_type: string;
+    rank: string | null;
+    created_at: Iso8601;
+}
+export interface ArticleContest {
+    slug: string;
+    title: string;
+    emoji: string;
+    icon_url: string;
+    description: string;
+    short_title: string;
+    url: string;
+    started_at: Iso8601;
+    ended_at: Iso8601;
+}
+export interface BookListItem {
+    id: number;
+    post_type: "Book";
+    title: string;
+    slug: string;
+    published: boolean;
+    price: number;
+    is_suspending_private: boolean;
+    liked_count: number;
+    published_at: Iso8601;
+    body_updated_at: Iso8601;
+    source_repo_updated_at: Iso8601;
+    cover_image_small_url: string;
+    path: string;
+    user: UserMini;
+}
+export interface BooksResponse {
+    books: BookListItem[];
+    next_page: number | null;
+}
+export interface BookChapter {
+    id: number;
+    post_type: "Chapter";
+    is_free: boolean;
+    slug: string;
+    body_letters_count: number;
+    source_repo_updated_at: Iso8601;
+    body_updated_at: Iso8601;
+    filename: string;
+    position: number;
+    path: string;
+    title: string;
+}
+export interface BookBadge {
+    badge_type: string;
+    rank: string | null;
+    created_at: Iso8601;
+}
+export interface BookContact {
+    url: string;
+    label: string;
+}
+export interface BookDetail {
+    id: number;
+    post_type: "Book";
+    title: string;
+    slug: string;
+    published: boolean;
+    price: number;
+    is_suspending_private: boolean;
+    liked_count: number;
+    published_at: Iso8601;
+    body_updated_at: Iso8601;
+    source_repo_updated_at: Iso8601;
+    cover_image_small_url: string;
+    path: string;
+    summary: string;
+    autolinked_summary: string;
+    og_image_url: string;
+    toc_enabled: boolean;
+    cover_image_url: string;
+    should_noindex: boolean;
+    total_letters_count: number;
+    badges: BookBadge[];
+    toc_depth: number;
+    require_additional_settings: boolean;
+    is_mine: boolean;
+    is_preview: boolean;
+    draft_reveal_scope: string | null;
+    current_user_liked: boolean;
+    purchase_in_progress: boolean;
+    can_read_all_chapters: boolean;
+    contact: BookContact | null;
+    user: User;
+    topics: Topic[];
+    chapters: BookChapter[];
+    github_repository: GitHubRepository | null;
+    cross_references: unknown[];
+}
+export interface BookResponse {
+    book: BookDetail;
+}
+export interface ChapterDetail {
+    id: number;
+    post_type: "Chapter";
+    is_free: boolean;
+    slug: string;
+    body_letters_count: number;
+    source_repo_updated_at: Iso8601;
+    body_updated_at: Iso8601;
+    filename: string;
+    position: number;
+    path: string;
+    title: string;
+    body_html: string;
+    toc: TocItem[];
+}
+export interface ChapterResponse {
+    chapter: ChapterDetail;
+}
+export interface ScrapListItem {
+    id: number;
+    post_type: "Scrap";
+    user_id: number;
+    slug: string;
+    title: string;
+    closed: boolean;
+    closed_at: Iso8601 | null;
+    archived: boolean;
+    liked_count: number;
+    can_others_post: boolean;
+    comments_count: number;
+    created_at: Iso8601;
+    last_comment_created_at: Iso8601;
+    should_noindex: boolean;
+    path: string;
+    unlisted: boolean;
+    topics: Topic[];
+    user: UserMini;
+}
+export interface ScrapsResponse {
+    scraps: ScrapListItem[];
+    next_page: number | null;
+}
+export interface ScrapCommentable {
+    id: number;
+    post_type: "Scrap" | "Article";
+    user_id: number;
+    slug: string;
+    title: string;
+    closed: boolean;
+    closed_at: Iso8601 | null;
+    archived: boolean;
+    liked_count: number;
+    can_others_post: boolean;
+    comments_count: number;
+    created_at: Iso8601;
+    last_comment_created_at: Iso8601;
+    should_noindex: boolean;
+    path: string;
+    unlisted: boolean;
+}
+export interface ScrapDetail extends ScrapListItem {
+    current_user_liked: boolean;
+    is_mine: boolean;
+    comments: ArticleComment[];
+    positive_comments_count: number;
+    commented_users: UserMini[];
+}
+export interface ScrapResponse {
+    scrap: ScrapDetail;
+}
+export interface ArticleComment {
+    id: number;
+    post_type: "Comment";
+    slug: string;
+    user_id: number;
+    liked_count: number;
+    body_updated_at: Iso8601 | null;
+    created_at: Iso8601;
+    pinned: boolean;
+    body_html: string;
+    hidden_reason: string | null;
+    current_user_liked: boolean;
+    is_mine: boolean;
+    user: UserMini;
+    children: ArticleComment[];
+}
+export interface UserCommentItem {
+    id: number;
+    post_type: "Comment";
+    parent_id: number | null;
+    slug: string;
+    commentable_type: CommentableType;
+    user_id: number;
+    liked_count: number;
+    body_updated_at: Iso8601 | null;
+    created_at: Iso8601;
+    reply: boolean;
+    title: string;
+    commentable: ScrapCommentable;
+}
+export interface UserCommentsResponse {
+    comments: UserCommentItem[];
+    next_page: number | null;
+}
+export interface UsersResponse {
+    users: UserMini[];
+    next_page: number | null;
+}
+export interface UserResponse {
+    user: User;
+}
+export interface PublicationResponse {
+    publication: Publication;
+}
+export interface TopicsResponse {
+    topics: Topic[];
+}
+export interface TopicResponse {
+    topic: Topic;
+}
+export interface Event {
+    slug: string;
+    event_type: EventType;
+    emoji: string;
+    icon_url: string;
+    title: string;
+    description: string;
+    short_title: string;
+    url: string;
+    target_blank: boolean;
+    promotion_started_at: Iso8601;
+    promotion_ended_at: Iso8601;
+    started_at: Iso8601;
+    ended_at: Iso8601;
+}
+export type SearchSource = "articles" | "users" | "topics" | "publications" | "scraps" | "books";
+export interface SearchResponse<TKey extends SearchSource> {
+    articles?: ArticleListItem[];
+    users?: UserMini[];
+    topics?: Topic[];
+    publications?: PublicationMini[];
+    scraps?: ScrapListItem[];
+    books?: BookListItem[];
+    next_page: number | null;
+}
+export type ArticleListOrder = "latest" | "liked" | "trending" | "new" | "weekly_liked" | "monthly_liked" | "liked_daily" | "liked_weekly" | "liked_monthly" | "liked_alltime" | "daily_tech" | "daily_idea" | "daily_books" | "weekly_tech" | "weekly_idea" | "alltime_tech" | "alltime_idea" | "weekly_liked_tech" | "monthly_liked_tech" | "alltime_liked_tech" | (string & {});
+export type BookListOrder = ArticleListOrder;
+export type ScrapListOrder = ArticleListOrder;
+export interface ListArticlesOptions {
+    order?: ArticleListOrder;
+    page?: number;
+    username?: string;
+    publication_name?: string;
+    topicname?: string;
+    article_type?: ArticleType;
+}
+export interface ListBooksOptions {
+    order?: BookListOrder;
+    page?: number;
+    username?: string;
+    publication_name?: string;
+    topicname?: string;
+}
+export interface ListScrapsOptions {
+    order?: ScrapListOrder;
+    page?: number;
+    username?: string;
+    publication_name?: string;
+    topicname?: string;
+}
+export interface ListUsersCommentsOptions {
+    page?: number;
+    commentable_type?: CommentableType;
+}
+export interface ListFollowersOptions {
+    page?: number;
+}
+export interface SearchOptions {
+    q: string;
+    source: SearchSource;
+    page?: number;
+}
+export interface ClientOptions {
+    baseUrl?: string;
+    fetch?: typeof fetch;
+    headers?: HeadersInit;
+}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@taisan11/zenn.js",
+  "version": "0.1.0",
+  "description": "Typed client for the public Zenn API.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "bun run scripts/build.ts",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "bun run build"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5.9.3"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  }
+}