@kookee/sdk 0.0.36 → 0.0.38

package/README.md

@@ -360,11 +360,18 @@ const posts = await kookee.blog.list({ locale: 'de' });
 const post = await kookee.blog.getBySlug('hello-world', { locale: 'de', fallback: true });
 ```
 
-Translation endpoints return a `Record<string, T>` keyed by locale code:
+Translation endpoints return a narrow `EntryTranslationsMap` keyed by locale code. Each value is a lightweight summary (`id`, `slug`, `locale`, `title`) — **not** a full entry. To load the full body of a translation, fetch it with `getBySlug` / `getById` using the target locale:
 
 ```typescript
 const translations = await kookee.blog.getTranslationsBySlug('hello-world');
-// { en: BlogEntry, de: BlogEntry, fr: BlogEntry, ... }
+// {
+//   en: { id, slug, locale: 'en', title },
+//   de: { id, slug, locale: 'de', title },
+//   ...
+// }
+
+// To load the full German version:
+const germanPost = await kookee.blog.getBySlug('hello-world', { locale: 'de' });
 ```
 
 ## Paginated Response
@@ -376,12 +383,53 @@ interface PaginatedResponse<T> {
   data: T[];
   total: number;
   limit: number;
-  offset: number;
   page: number;
   totalPages: number;
 }
 ```
 
+## List vs. Detail Responses
+
+Entry endpoints come in two flavours with **different shapes**:
+
+- **List responses** (`blog.list()`, `help.search()`, `entries.list()`, …) return `*ListItem` types — these do **not** include `contentHtml`. Use `excerptHtml` instead for previews.
+- **Detail responses** (`blog.getBySlug()`, `help.getById()`, …) return `*Detail` types — these include `contentHtml` for full content rendering.
+
+```typescript
+// List: no contentHtml, only excerptHtml
+const posts = await kookee.blog.list({ limit: 10 });
+for (const post of posts.data) {
+  renderPreview(post.excerptHtml); // ✅ available on list
+  // renderFull(post.contentHtml);  // ❌ type error — not on list
+}
+
+// Detail: contentHtml is available
+const post = await kookee.blog.getBySlug('hello-world');
+renderFull(post.contentHtml); // ✅ available on detail
+```
+
+## Categories on entries
+
+Every entry response (list *and* detail) includes both `categoryId: string | null` **and** a resolved `category: EntryCategoryRef | null`. No client-side join required:
+
+```typescript
+const results = await kookee.help.search({ query: 'how to reset password' });
+for (const result of results) {
+  // result.category is already populated by the server
+  console.log(result.title, '→', result.category?.name);
+}
+
+type EntryCategoryRef = {
+  id: string;
+  slug: string;
+  name: string;
+  icon: string | null;
+  description: string | null;
+};
+```
+
+When an entry has no category assigned, `category` is `null` and `categoryId` is `null` — guard accordingly.
+
 ## Error Handling
 
 ```typescript
@@ -423,23 +471,47 @@ The SDK is written in TypeScript and provides full type definitions:
 
 ```typescript
 import type {
-  // Entry types
+  // Entry base & shared
   BaseEntry,
-  GenericEntry,
-  BlogEntry,
-  PageEntry,
-  HelpArticleEntry,
-  ChangelogEntry,
-  AnnouncementEntry,
-  TypedEntry,
-  AnyEntry,
+  EntryDetailFields,
   EntryType,
   EntryStatus,
   EntryAuthor,
   EntryTag,
   EntryTagWithCount,
   EntryCategory,
+  EntryCategoryRef,
   EntryComment,
+  EntryTranslationSummary,
+  EntryTranslationsMap,
+
+  // Entry variants — LIST responses (no contentHtml)
+  GenericEntryListItem,
+  BlogEntryListItem,
+  PageEntryListItem,
+  HelpArticleListItem,
+  ChangelogEntryListItem,
+  AnnouncementListItem,
+  TypedEntryListItem,
+  AnyEntryListItem,
+
+  // Entry variants — DETAIL responses (with contentHtml)
+  GenericEntryDetail,
+  BlogEntryDetail,
+  PageEntryDetail,
+  HelpArticleDetail,
+  ChangelogEntryDetail,
+  AnnouncementDetail,
+  TypedEntryDetail,
+  AnyEntryDetail,
+
+  // Type-specific metadata
+  TypeSpecific,
+  BlogTypeSpecific,
+  PageTypeSpecific,
+  HelpArticleTypeSpecific,
+  ChangelogTypeSpecific,
+  AnnouncementTypeSpecific,
 
   // Changelog & Announcement specific
   ChangelogType,

package/dist/index.cjs

@@ -1,2 +1,2 @@
-'use strict';var k="https://api.kookee.dev",B="Kookee-API-Key",I="Kookee-Project-Id",i=class s extends Error{constructor(t,r,o){super(r);this.code=t;this.status=o;this.name="KookeeApiError",Object.setPrototypeOf(this,s.prototype);}},C=class{baseUrl;apiKey;projectId;constructor(e){this.apiKey=e.apiKey,this.projectId=e.projectId,this.baseUrl=e.baseUrl??k;}getHeaders(){let e={"Content-Type":"application/json"};return this.apiKey&&(e[B]=this.apiKey),this.projectId&&(e[I]=this.projectId),e}async get(e,t){let r=new URL(`${this.baseUrl}${e}`);if(t){for(let[h,n]of Object.entries(t))if(n!=null)if(Array.isArray(n))for(let a of n)r.searchParams.append(h,String(a));else r.searchParams.set(h,String(n));}let o=await fetch(r.toString(),{method:"GET",headers:this.getHeaders()});return this.handleResponse(o)}async post(e,t){let r=await fetch(`${this.baseUrl}${e}`,{method:"POST",headers:this.getHeaders(),body:t?JSON.stringify(t):void 0});return this.handleResponse(r)}async delete(e,t){let r=await fetch(`${this.baseUrl}${e}`,{method:"DELETE",headers:this.getHeaders(),body:t?JSON.stringify(t):void 0});return this.handleResponse(r)}async*streamPost(e,t){let r=await fetch(`${this.baseUrl}${e}`,{method:"POST",headers:{...this.getHeaders(),Accept:"text/event-stream"},body:t?JSON.stringify(t):void 0});if(!r.ok){let a=null;try{a=await r.json();}catch{}throw new i(a?.code??"UNKNOWN_ERROR",a?.message??`Request failed with status ${r.status}`,r.status)}if(!r.body)return;let o=r.body.getReader(),h=new TextDecoder,n="";try{for(;;){let{done:a,value:b}=await o.read();if(a)break;n+=h.decode(b,{stream:!0});let E=n.split(`
-`);n=E.pop()??"";for(let x of E){let u=x.trim();if(!(!u||u.startsWith(":"))&&u.startsWith("data: ")){let R=u.slice(6);if(R==="[DONE]")return;yield JSON.parse(R);}}}}finally{o.releaseLock();}}async handleResponse(e){if(!e.ok){let t=null;try{t=await e.json();}catch{}throw new i(t?.code??"UNKNOWN_ERROR",t?.message??`Request failed with status ${e.status}`,e.status)}return e.json()}};var m=class{constructor(e){this.entries=e;}async list(e){return this.entries.list({type:"announcement",...e})}async getById(e,t){return this.entries.getById(e,t)}async getTranslationsById(e){return this.entries.getTranslationsById(e)}async getComments(e,t){return this.entries.getComments(e,t)}};var p=class{constructor(e){this.entries=e;}async list(e){return this.entries.list({type:"blog",...e})}async getBySlug(e,t){return this.entries.getBySlug(e,{type:"blog",...t})}async getById(e,t){return this.entries.getById(e,t)}async getTags(){return this.entries.getTags("blog")}async getTranslationsById(e){return this.entries.getTranslationsById(e)}async getTranslationsBySlug(e){return this.entries.getTranslationsBySlug(e)}async getComments(e,t){return this.entries.getComments(e,t)}async react(e,t){return this.entries.react(e,t)}};var c=class{constructor(e){this.entries=e;}async list(e){return this.entries.list({type:"changelog",...e})}async getBySlug(e,t){return this.entries.getBySlug(e,{type:"changelog",...t})}async getById(e,t){return this.entries.getById(e,t)}async getTranslationsById(e){return this.entries.getTranslationsById(e)}async getTranslationsBySlug(e){return this.entries.getTranslationsBySlug(e)}async getComments(e,t){return this.entries.getComments(e,t)}async react(e,t){return this.entries.react(e,t)}};var g=class{constructor(e){this.http=e;}async getByKey(e){return this.http.get(`/v1/config/${encodeURIComponent(e)}`)}async list(e){return this.http.get("/v1/config",e)}};var l=class{constructor(e){this.http=e;}async list(e){return this.http.get("/v1/entries",e)}async getById(e,t){return this.http.get(`/v1/entries/by-id/${encodeURIComponent(e)}`,t)}async getBySlug(e,t){return this.http.get(`/v1/entries/${encodeURIComponent(e)}`,t)}async getTranslationsById(e){return this.http.get(`/v1/entries/by-id/${encodeURIComponent(e)}/translations`)}async getTranslationsBySlug(e){return this.http.get(`/v1/entries/${encodeURIComponent(e)}/translations`)}async getComments(e,t){return this.http.get(`/v1/entries/${encodeURIComponent(e)}/comments`,t)}async react(e,t){return this.http.post(`/v1/entries/${encodeURIComponent(e)}/reactions`,t)}async getTags(e){return this.http.get("/v1/tags",{type:e})}async getCategories(e,t){return this.http.get("/v1/categories",{type:e,...t})}};var y=class{constructor(e,t){this.http=e;this.getUserContext=t;}async getColumns(){return this.http.get("/v1/feedback/columns")}async list(e){return this.http.get("/v1/feedback",e)}async getById(e){return this.http.get(`/v1/feedback/by-id/${encodeURIComponent(e)}`)}async vote(e,t){return this.http.post(`/v1/feedback/${encodeURIComponent(e)}/vote`,t)}async getTopContributors(e){return this.http.get("/v1/feedback/top-contributors",e)}async createPost(e){let t=e.externalUser??this.getUserContext();if(!t)throw new Error("No user identified. Call kookee.identify() first or pass externalUser in params.");return this.http.post("/v1/feedback",{...e,externalUser:t})}async createComment(e,t){let r=t.externalUser??this.getUserContext();if(!r)throw new Error("No user identified. Call kookee.identify() first or pass externalUser in params.");return this.http.post(`/v1/feedback/${encodeURIComponent(e)}/comments`,{...t,externalUser:r})}async listMyPosts(e){let t=e?.externalId??this.getUserContext()?.externalId;if(!t)throw new Error("No user identified. Call kookee.identify() first or pass externalId in params.");return this.http.get("/v1/feedback/mine",{...e,externalId:t})}async deletePost(e,t){let r=t?.externalId??this.getUserContext()?.externalId;if(!r)throw new Error("No user identified. Call kookee.identify() first or pass externalId in params.");return this.http.delete(`/v1/feedback/${encodeURIComponent(e)}`,{externalId:r})}async deleteComment(e,t){let r=t?.externalId??this.getUserContext()?.externalId;if(!r)throw new Error("No user identified. Call kookee.identify() first or pass externalId in params.");return this.http.delete(`/v1/feedback/comments/${encodeURIComponent(e)}`,{externalId:r})}};var d=class{http;entries;constructor(e,t){this.http=e,this.entries=t;}async categories(e){return this.entries.getCategories("help_article",e)}async list(e){return this.entries.list({type:"help_article",...e})}async getBySlug(e,t){return this.entries.getBySlug(e,{type:"help_article",...t})}async getById(e,t){return this.entries.getById(e,t)}async search(e){return this.http.get("/v1/help/search",e)}async getTranslationsById(e){return this.entries.getTranslationsById(e)}async getTranslationsBySlug(e){return this.entries.getTranslationsBySlug(e)}async getComments(e,t){return this.entries.getComments(e,t)}async react(e,t){return this.entries.react(e,t)}async chat(e){return this.http.post("/v1/help/chat",e)}chatStream(e){return this.http.streamPost("/v1/help/chat/stream",e)}};var P=class{constructor(e){this.entries=e;}async list(e){return this.entries.list({type:"page",...e})}async getBySlug(e,t){return this.entries.getBySlug(e,{type:"page",...t})}async getById(e,t){return this.entries.getById(e,t)}async getTranslationsById(e){return this.entries.getTranslationsById(e)}async getTranslationsBySlug(e){return this.entries.getTranslationsBySlug(e)}async getComments(e,t){return this.entries.getComments(e,t)}};var f=class{http;user=null;entries;announcements;blog;changelog;config;feedback;help;pages;constructor(e){if(!e.apiKey&&!e.projectId)throw new Error("Either apiKey or projectId is required");this.http=new C({apiKey:e.apiKey,projectId:e.projectId,baseUrl:e.baseUrl}),this.entries=new l(this.http),this.announcements=new m(this.entries),this.blog=new p(this.entries),this.changelog=new c(this.entries),this.config=new g(this.http),this.feedback=new y(this.http,()=>this.user),this.help=new d(this.http,this.entries),this.pages=new P(this.entries);}identify(e){this.user=e;}reset(){this.user=null;}getUser(){return this.user}async health(){return this.http.get("/v1/health")}};exports.AnnouncementModule=m;exports.BlogModule=p;exports.ChangelogModule=c;exports.ConfigModule=g;exports.EntriesModule=l;exports.FeedbackModule=y;exports.HelpModule=d;exports.Kookee=f;exports.KookeeApiError=i;exports.PagesModule=P;
+'use strict';var R="https://api.kookee.dev",I="Kookee-API-Key",B="Kookee-Project-Id",i=class n extends Error{constructor(t,s,o){super(s);this.code=t;this.status=o;this.name="KookeeApiError",Object.setPrototypeOf(this,n.prototype);}},C=class{baseUrl;apiKey;projectId;constructor(e){this.apiKey=e.apiKey,this.projectId=e.projectId,this.baseUrl=e.baseUrl??R;}getHeaders(){let e={"Content-Type":"application/json"};return this.apiKey&&(e[I]=this.apiKey),this.projectId&&(e[B]=this.projectId),e}async get(e,t){let s=new URL(`${this.baseUrl}${e}`);if(t){for(let[h,r]of Object.entries(t))if(r!=null)if(Array.isArray(r))for(let a of r)s.searchParams.append(h,String(a));else s.searchParams.set(h,String(r));}let o=await fetch(s.toString(),{method:"GET",headers:this.getHeaders()});return this.handleResponse(o)}async post(e,t){let s=await fetch(`${this.baseUrl}${e}`,{method:"POST",headers:this.getHeaders(),body:t?JSON.stringify(t):void 0});return this.handleResponse(s)}async delete(e,t){let s=await fetch(`${this.baseUrl}${e}`,{method:"DELETE",headers:this.getHeaders(),body:t?JSON.stringify(t):void 0});return this.handleResponse(s)}async*streamPost(e,t){let s=await fetch(`${this.baseUrl}${e}`,{method:"POST",headers:{...this.getHeaders(),Accept:"text/event-stream"},body:t?JSON.stringify(t):void 0});if(!s.ok){let a=null;try{a=await s.json();}catch{}throw new i(a?.code??"UNKNOWN_ERROR",a?.message??`Request failed with status ${s.status}`,s.status)}if(!s.body)return;let o=s.body.getReader(),h=new TextDecoder,r="";try{for(;;){let{done:a,value:k}=await o.read();if(a)break;r+=h.decode(k,{stream:!0});let E=r.split(`
+`);r=E.pop()??"";for(let x of E){let u=x.trim();if(!(!u||u.startsWith(":"))&&u.startsWith("data: ")){let b=u.slice(6);if(b==="[DONE]")return;yield JSON.parse(b);}}}}finally{o.releaseLock();}}async handleResponse(e){if(!e.ok){let t=null;try{t=await e.json();}catch{}throw new i(t?.code??"UNKNOWN_ERROR",t?.message??`Request failed with status ${e.status}`,e.status)}return e.json()}};var m=class{constructor(e){this.entries=e;}async list(e){return this.entries.list({type:"announcement",...e})}async getById(e,t){return this.entries.getById(e,t)}async getTranslationsById(e){return this.entries.getTranslationsById(e)}async getComments(e,t){return this.entries.getComments(e,t)}};var p=class{constructor(e){this.entries=e;}async list(e){return this.entries.list({type:"blog",...e})}async getBySlug(e,t){return this.entries.getBySlug(e,{type:"blog",...t})}async getById(e,t){return this.entries.getById(e,t)}async getTags(){return this.entries.getTags("blog")}async getTranslationsById(e){return this.entries.getTranslationsById(e)}async getTranslationsBySlug(e){return this.entries.getTranslationsBySlug(e)}async getComments(e,t){return this.entries.getComments(e,t)}async react(e,t){return this.entries.react(e,t)}};var l=class{constructor(e){this.entries=e;}async list(e){return this.entries.list({type:"changelog",...e})}async getBySlug(e,t){return this.entries.getBySlug(e,{type:"changelog",...t})}async getById(e,t){return this.entries.getById(e,t)}async getTranslationsById(e){return this.entries.getTranslationsById(e)}async getTranslationsBySlug(e){return this.entries.getTranslationsBySlug(e)}async getComments(e,t){return this.entries.getComments(e,t)}async react(e,t){return this.entries.react(e,t)}};var c=class{constructor(e){this.http=e;}async getByKey(e){return this.http.get(`/v1/config/${encodeURIComponent(e)}`)}async list(e){return this.http.get("/v1/config",e)}};var g=class{constructor(e){this.http=e;}async list(e){return this.http.get("/v1/entries",e)}async getById(e,t){return this.http.get(`/v1/entries/by-id/${encodeURIComponent(e)}`,t)}async getBySlug(e,t){return this.http.get(`/v1/entries/${encodeURIComponent(e)}`,t)}async getTranslationsById(e){return this.http.get(`/v1/entries/by-id/${encodeURIComponent(e)}/translations`)}async getTranslationsBySlug(e){return this.http.get(`/v1/entries/${encodeURIComponent(e)}/translations`)}async getComments(e,t){return this.http.get(`/v1/entries/${encodeURIComponent(e)}/comments`,t)}async react(e,t){return this.http.post(`/v1/entries/${encodeURIComponent(e)}/reactions`,t)}async getTags(e){return this.http.get("/v1/tags",{type:e})}async getCategories(e,t){return this.http.get("/v1/categories",{type:e,...t})}};var y=class{constructor(e,t){this.http=e;this.getUserContext=t;}async getColumns(){return this.http.get("/v1/feedback/columns")}async list(e){return this.http.get("/v1/feedback",e)}async getById(e){return this.http.get(`/v1/feedback/by-id/${encodeURIComponent(e)}`)}async vote(e,t){return this.http.post(`/v1/feedback/${encodeURIComponent(e)}/vote`,t)}async getTopContributors(e){return this.http.get("/v1/feedback/top-contributors",e)}async createPost(e){let t=e.externalUser??this.getUserContext();if(!t)throw new Error("No user identified. Call kookee.identify() first or pass externalUser in params.");return this.http.post("/v1/feedback",{...e,externalUser:t})}async createComment(e,t){let s=t.externalUser??this.getUserContext();if(!s)throw new Error("No user identified. Call kookee.identify() first or pass externalUser in params.");return this.http.post(`/v1/feedback/${encodeURIComponent(e)}/comments`,{...t,externalUser:s})}async listMyPosts(e){let t=e?.externalId??this.getUserContext()?.externalId;if(!t)throw new Error("No user identified. Call kookee.identify() first or pass externalId in params.");return this.http.get("/v1/feedback/mine",{...e,externalId:t})}async deletePost(e,t){let s=t?.externalId??this.getUserContext()?.externalId;if(!s)throw new Error("No user identified. Call kookee.identify() first or pass externalId in params.");return this.http.delete(`/v1/feedback/${encodeURIComponent(e)}`,{externalId:s})}async deleteComment(e,t){let s=t?.externalId??this.getUserContext()?.externalId;if(!s)throw new Error("No user identified. Call kookee.identify() first or pass externalId in params.");return this.http.delete(`/v1/feedback/comments/${encodeURIComponent(e)}`,{externalId:s})}};var d=class{http;entries;constructor(e,t){this.http=e,this.entries=t;}async categories(e){return this.entries.getCategories("help_article",e)}async list(e){return this.entries.list({type:"help_article",...e})}async getBySlug(e,t){return this.entries.getBySlug(e,{type:"help_article",...t})}async getById(e,t){return this.entries.getById(e,t)}async search(e){return this.http.get("/v1/help/search",e)}async getTranslationsById(e){return this.entries.getTranslationsById(e)}async getTranslationsBySlug(e){return this.entries.getTranslationsBySlug(e)}async getComments(e,t){return this.entries.getComments(e,t)}async react(e,t){return this.entries.react(e,t)}async chat(e){return this.http.post("/v1/help/chat",e)}chatStream(e){return this.http.streamPost("/v1/help/chat/stream",e)}};var P=class{constructor(e){this.entries=e;}async list(e){return this.entries.list({type:"page",...e})}async getBySlug(e,t){return this.entries.getBySlug(e,{type:"page",...t})}async getById(e,t){return this.entries.getById(e,t)}async getTranslationsById(e){return this.entries.getTranslationsById(e)}async getTranslationsBySlug(e){return this.entries.getTranslationsBySlug(e)}async getComments(e,t){return this.entries.getComments(e,t)}};var f=class{http;user=null;entries;announcements;blog;changelog;config;feedback;help;pages;constructor(e){if(!e.apiKey&&!e.projectId)throw new Error("Either apiKey or projectId is required");this.http=new C({apiKey:e.apiKey,projectId:e.projectId,baseUrl:e.baseUrl}),this.entries=new g(this.http),this.announcements=new m(this.entries),this.blog=new p(this.entries),this.changelog=new l(this.entries),this.config=new c(this.http),this.feedback=new y(this.http,()=>this.user),this.help=new d(this.http,this.entries),this.pages=new P(this.entries);}identify(e){this.user=e;}reset(){this.user=null;}getUser(){return this.user}async health(){return this.http.get("/v1/health")}};exports.AnnouncementModule=m;exports.BlogModule=p;exports.ChangelogModule=l;exports.ConfigModule=c;exports.EntriesModule=g;exports.FeedbackModule=y;exports.HelpModule=d;exports.Kookee=f;exports.KookeeApiError=i;exports.PagesModule=P;

package/dist/index.d.cts

@@ -15,7 +15,6 @@ interface PaginatedResponse<T> {
     data: T[];
     total: number;
     limit: number;
-    offset: number;
     page: number;
     totalPages: number;
 }
@@ -61,11 +60,11 @@ interface HelpChatSourceCategory {
 }
 interface HelpChatSource {
     id: string;
-    slug: string;
+    slug: string | null;
     title: string;
-    visibility: HelpArticleVisibility;
+    visibility: string | null;
     metadata: Record<string, NonNullable<unknown>> | null;
-    category: HelpChatSourceCategory;
+    category: HelpChatSourceCategory | null;
 }
 type HelpChatStreamChunk = {
     type: 'delta';
@@ -79,18 +78,6 @@ type HelpChatStreamChunk = {
     type: 'error';
     message: string;
 };
-interface HelpSearchResult {
-    id: string;
-    slug: string;
-    title: string;
-    excerptHtml: string | null;
-    category: {
-        name: string;
-        slug: string;
-    };
-    locale: string;
-    matchedChunk?: string;
-}
 type FeedbackColumnType = 'open' | 'closed';
 interface FeedbackKanbanColumn {
     id: string;
@@ -104,7 +91,7 @@ type FeedbackPostCategory = 'feature' | 'improvement' | 'bug' | 'other';
 type FeedbackSortOption = 'newest' | 'top' | 'trending';
 interface FeedbackAuthor {
     id: string;
-    name: string;
+    name: string | null;
     image: string | null;
     isTeamMember?: boolean;
     externalId?: string | null;
@@ -130,6 +117,7 @@ interface FeedbackPostListItem {
     columnName: string | null;
     columnColor: string | null;
     columnType: FeedbackColumnType | null;
+    kanbanPosition: number;
     category: FeedbackPostCategory;
     voteCount: number;
     commentCount: number;
@@ -143,7 +131,7 @@ interface FeedbackPost extends FeedbackPostListItem {
 }
 interface FeedbackTopContributor {
     id: string;
-    name: string;
+    name: string | null;
     image: string | null;
     totalVotes: number;
 }
@@ -214,12 +202,21 @@ type EntryType = 'blog' | 'page' | 'help_article' | 'changelog' | 'announcement'
 type EntryStatus = 'draft' | 'published' | 'archived';
 type ChangelogType = 'feature' | 'fix' | 'improvement' | 'breaking' | 'security' | 'deprecated' | 'other';
 type AnnouncementType = 'info' | 'warning' | 'critical' | 'promotion' | 'maintenance' | 'newFeature';
+/**
+ * Author shape returned on public entry responses.
+ *
+ * NOTE: `name` and `image` can be `null` on the server side.
+ */
 interface EntryAuthor {
-    name: string;
+    id: string;
+    name: string | null;
+    image: string | null;
 }
 interface EntryTag {
+    id: string;
     name: string;
     slug: string;
+    color: string | null;
 }
 interface EntryTagWithCount extends EntryTag {
     count: number;
@@ -239,33 +236,52 @@ interface EntryComment {
     updatedAt: string;
     author: EntryAuthor;
 }
+/**
+ * Resolved category attached to a public entry response.
+ *
+ * This is the server's `EntryCategory` row projected down to the fields
+ * that are safe/useful to expose publicly.
+ */
+interface EntryCategoryRef {
+    id: string;
+    slug: string;
+    name: string;
+    icon: string | null;
+    description: string | null;
+}
+/**
+ * Fields that appear on BOTH list and detail entry responses.
+ */
 interface BaseEntry {
     id: string;
     type: string;
     slug: string | null;
     title: string;
     excerptHtml: string | null;
-    contentHtml: string;
-    status: EntryStatus;
     publishedAt: string | null;
     locale: string;
     translationGroupId: string;
     categoryId: string | null;
+    category: EntryCategoryRef | null;
     coverImageUrl: string | null;
     position: number;
     views: number;
     metaTitle: string | null;
     metaDescription: string | null;
     metadata: Record<string, NonNullable<unknown>> | null;
+    reactions: Record<string, number>;
     createdAt: string;
     updatedAt: string;
     author: EntryAuthor;
     tags: EntryTag[];
-    reactions: Record<string, number>;
-    category: {
-        name: string;
-        slug: string;
-    } | null;
+}
+/**
+ * Fields added on entry DETAIL responses only.
+ *
+ * `contentHtml` is NOT returned on list endpoints.
+ */
+interface EntryDetailFields {
+    contentHtml: string;
 }
 interface BlogTypeSpecific {
     _type: 'blog';
@@ -289,31 +305,79 @@ interface AnnouncementTypeSpecific {
     unpublishAt: string | null;
 }
 type TypeSpecific = BlogTypeSpecific | PageTypeSpecific | HelpArticleTypeSpecific | ChangelogTypeSpecific | AnnouncementTypeSpecific;
-interface GenericEntry extends BaseEntry {
+interface GenericEntryListItem extends BaseEntry {
     typeSpecific: unknown;
 }
-interface BlogEntry extends BaseEntry {
+interface GenericEntryDetail extends BaseEntry, EntryDetailFields {
+    typeSpecific: unknown;
+}
+interface BlogEntryListItem extends BaseEntry {
     type: 'blog';
     typeSpecific: BlogTypeSpecific;
 }
-interface PageEntry extends BaseEntry {
+interface BlogEntryDetail extends BaseEntry, EntryDetailFields {
+    type: 'blog';
+    typeSpecific: BlogTypeSpecific;
+}
+interface PageEntryListItem extends BaseEntry {
+    type: 'page';
+    typeSpecific: PageTypeSpecific;
+}
+interface PageEntryDetail extends BaseEntry, EntryDetailFields {
     type: 'page';
     typeSpecific: PageTypeSpecific;
 }
-interface HelpArticleEntry extends BaseEntry {
+interface HelpArticleListItem extends BaseEntry {
+    type: 'help_article';
+    typeSpecific: HelpArticleTypeSpecific;
+}
+interface HelpArticleDetail extends BaseEntry, EntryDetailFields {
     type: 'help_article';
     typeSpecific: HelpArticleTypeSpecific;
 }
-interface ChangelogEntry extends BaseEntry {
+interface ChangelogEntryListItem extends BaseEntry {
     type: 'changelog';
     typeSpecific: ChangelogTypeSpecific;
 }
-interface AnnouncementEntry extends BaseEntry {
+interface ChangelogEntryDetail extends BaseEntry, EntryDetailFields {
+    type: 'changelog';
+    typeSpecific: ChangelogTypeSpecific;
+}
+interface AnnouncementListItem extends BaseEntry {
     type: 'announcement';
     typeSpecific: AnnouncementTypeSpecific;
 }
-type TypedEntry = BlogEntry | PageEntry | HelpArticleEntry | ChangelogEntry | AnnouncementEntry;
-type AnyEntry = TypedEntry | GenericEntry;
+interface AnnouncementDetail extends BaseEntry, EntryDetailFields {
+    type: 'announcement';
+    typeSpecific: AnnouncementTypeSpecific;
+}
+type TypedEntryListItem = BlogEntryListItem | PageEntryListItem | HelpArticleListItem | ChangelogEntryListItem | AnnouncementListItem;
+type TypedEntryDetail = BlogEntryDetail | PageEntryDetail | HelpArticleDetail | ChangelogEntryDetail | AnnouncementDetail;
+type AnyEntryListItem = TypedEntryListItem | GenericEntryListItem;
+type AnyEntryDetail = TypedEntryDetail | GenericEntryDetail;
+/**
+ * Help search result — returned by `GET /v1/help/search`.
+ *
+ * The server returns the exact same shape as a help article list response,
+ * so we alias it to `HelpArticleListItem`. There is no nested `category`
+ * object or `matchedChunk` field on this response (SDK <= 0.0.36 lied
+ * about both).
+ */
+type HelpSearchResult = HelpArticleListItem;
+/**
+ * Translation summary returned by the translations endpoints.
+ *
+ * The server returns a narrow { id, slug, locale, title } shape keyed by
+ * locale — NOT a full entry. Consumers that need the full body should
+ * fetch each translation individually via getBySlug / getById.
+ */
+interface EntryTranslationSummary {
+    id: string;
+    slug: string | null;
+    locale: string;
+    title: string;
+}
+type EntryTranslationsMap = Record<string, EntryTranslationSummary>;
 
 declare class KookeeApiError extends Error {
     readonly code: string;
@@ -355,11 +419,11 @@ interface EntriesGetCategoriesParams extends LocaleOptions {
 declare class EntriesModule {
     private readonly http;
     constructor(http: HttpClient);
-    list(params: EntriesListParams): Promise<PaginatedResponse<GenericEntry>>;
-    getById(id: string, params?: EntriesGetByIdParams): Promise<GenericEntry>;
-    getBySlug(slug: string, params: EntriesGetBySlugParams): Promise<GenericEntry>;
-    getTranslationsById(id: string): Promise<Record<string, GenericEntry>>;
-    getTranslationsBySlug(slug: string): Promise<Record<string, GenericEntry>>;
+    list(params: EntriesListParams): Promise<PaginatedResponse<GenericEntryListItem>>;
+    getById(id: string, params?: EntriesGetByIdParams): Promise<GenericEntryDetail>;
+    getBySlug(slug: string, params: EntriesGetBySlugParams): Promise<GenericEntryDetail>;
+    getTranslationsById(id: string): Promise<EntryTranslationsMap>;
+    getTranslationsBySlug(slug: string): Promise<EntryTranslationsMap>;
     getComments(entryId: string, params?: EntriesGetCommentsParams): Promise<PaginatedResponse<EntryComment>>;
     react(entryId: string, params: ReactParams): Promise<ReactResponse>;
     getTags(type: string): Promise<EntryTagWithCount[]>;
@@ -375,9 +439,9 @@ interface AnnouncementGetCommentsParams extends PaginationParams {
 declare class AnnouncementModule {
     private readonly entries;
     constructor(entries: EntriesModule);
-    list(params?: AnnouncementListParams): Promise<PaginatedResponse<AnnouncementEntry>>;
-    getById(id: string, params?: AnnouncementGetByIdParams): Promise<AnnouncementEntry>;
-    getTranslationsById(id: string): Promise<Record<string, AnnouncementEntry>>;
+    list(params?: AnnouncementListParams): Promise<PaginatedResponse<AnnouncementListItem>>;
+    getById(id: string, params?: AnnouncementGetByIdParams): Promise<AnnouncementDetail>;
+    getTranslationsById(id: string): Promise<EntryTranslationsMap>;
     getComments(entryId: string, params?: AnnouncementGetCommentsParams): Promise<PaginatedResponse<EntryComment>>;
 }
 
@@ -394,12 +458,12 @@ interface BlogGetCommentsParams extends PaginationParams {
 declare class BlogModule {
     private readonly entries;
     constructor(entries: EntriesModule);
-    list(params?: BlogListParams): Promise<PaginatedResponse<BlogEntry>>;
-    getBySlug(slug: string, params?: BlogGetBySlugParams): Promise<BlogEntry>;
-    getById(id: string, params?: BlogGetByIdParams): Promise<BlogEntry>;
+    list(params?: BlogListParams): Promise<PaginatedResponse<BlogEntryListItem>>;
+    getBySlug(slug: string, params?: BlogGetBySlugParams): Promise<BlogEntryDetail>;
+    getById(id: string, params?: BlogGetByIdParams): Promise<BlogEntryDetail>;
     getTags(): Promise<EntryTagWithCount[]>;
-    getTranslationsById(postId: string): Promise<Record<string, BlogEntry>>;
-    getTranslationsBySlug(slug: string): Promise<Record<string, BlogEntry>>;
+    getTranslationsById(postId: string): Promise<EntryTranslationsMap>;
+    getTranslationsBySlug(slug: string): Promise<EntryTranslationsMap>;
     getComments(entryId: string, params?: BlogGetCommentsParams): Promise<PaginatedResponse<EntryComment>>;
     react(postId: string, params: ReactParams): Promise<ReactResponse>;
 }
@@ -416,11 +480,11 @@ interface ChangelogGetCommentsParams extends PaginationParams {
 declare class ChangelogModule {
     private readonly entries;
     constructor(entries: EntriesModule);
-    list(params?: ChangelogListParams): Promise<PaginatedResponse<ChangelogEntry>>;
-    getBySlug(slug: string, params?: ChangelogGetBySlugParams): Promise<ChangelogEntry>;
-    getById(id: string, params?: ChangelogGetByIdParams): Promise<ChangelogEntry>;
-    getTranslationsById(id: string): Promise<Record<string, ChangelogEntry>>;
-    getTranslationsBySlug(slug: string): Promise<Record<string, ChangelogEntry>>;
+    list(params?: ChangelogListParams): Promise<PaginatedResponse<ChangelogEntryListItem>>;
+    getBySlug(slug: string, params?: ChangelogGetBySlugParams): Promise<ChangelogEntryDetail>;
+    getById(id: string, params?: ChangelogGetByIdParams): Promise<ChangelogEntryDetail>;
+    getTranslationsById(id: string): Promise<EntryTranslationsMap>;
+    getTranslationsBySlug(slug: string): Promise<EntryTranslationsMap>;
     getComments(entryId: string, params?: ChangelogGetCommentsParams): Promise<PaginatedResponse<EntryComment>>;
     react(changelogId: string, params: ReactParams): Promise<ReactResponse>;
 }
@@ -485,12 +549,12 @@ declare class HelpModule {
     private readonly entries;
     constructor(http: HttpClient, entries: EntriesModule);
     categories(params?: HelpCategoriesParams): Promise<EntryCategory[]>;
-    list(params?: HelpListParams): Promise<PaginatedResponse<HelpArticleEntry>>;
-    getBySlug(slug: string, params?: HelpGetBySlugParams): Promise<HelpArticleEntry>;
-    getById(id: string, params?: HelpGetByIdParams): Promise<HelpArticleEntry>;
+    list(params?: HelpListParams): Promise<PaginatedResponse<HelpArticleListItem>>;
+    getBySlug(slug: string, params?: HelpGetBySlugParams): Promise<HelpArticleDetail>;
+    getById(id: string, params?: HelpGetByIdParams): Promise<HelpArticleDetail>;
     search(params: HelpSearchParams): Promise<HelpSearchResult[]>;
-    getTranslationsById(articleId: string): Promise<Record<string, HelpArticleEntry>>;
-    getTranslationsBySlug(slug: string): Promise<Record<string, HelpArticleEntry>>;
+    getTranslationsById(articleId: string): Promise<EntryTranslationsMap>;
+    getTranslationsBySlug(slug: string): Promise<EntryTranslationsMap>;
     getComments(entryId: string, params?: HelpGetCommentsParams): Promise<PaginatedResponse<EntryComment>>;
     react(articleId: string, params: ReactParams): Promise<ReactResponse>;
     chat(params: HelpChatParams): Promise<HelpChatResponse>;
@@ -509,11 +573,11 @@ interface PagesGetCommentsParams extends PaginationParams {
 declare class PagesModule {
     private readonly entries;
     constructor(entries: EntriesModule);
-    list(params?: PagesListParams): Promise<PaginatedResponse<PageEntry>>;
-    getBySlug(slug: string, params?: PagesGetBySlugParams): Promise<PageEntry>;
-    getById(id: string, params?: PagesGetByIdParams): Promise<PageEntry>;
-    getTranslationsById(pageId: string): Promise<Record<string, PageEntry>>;
-    getTranslationsBySlug(slug: string): Promise<Record<string, PageEntry>>;
+    list(params?: PagesListParams): Promise<PaginatedResponse<PageEntryListItem>>;
+    getBySlug(slug: string, params?: PagesGetBySlugParams): Promise<PageEntryDetail>;
+    getById(id: string, params?: PagesGetByIdParams): Promise<PageEntryDetail>;
+    getTranslationsById(pageId: string): Promise<EntryTranslationsMap>;
+    getTranslationsBySlug(slug: string): Promise<EntryTranslationsMap>;
     getComments(entryId: string, params?: PagesGetCommentsParams): Promise<PaginatedResponse<EntryComment>>;
 }
 
@@ -535,4 +599,4 @@ declare class Kookee {
     health(): Promise<HealthCheckResponse>;
 }
 
-export { type AnnouncementEntry, type AnnouncementGetByIdParams, type AnnouncementGetCommentsParams, type AnnouncementListParams, AnnouncementModule, type AnnouncementType, type AnnouncementTypeSpecific, type AnyEntry, type ApiError, type BaseEntry, type BlogEntry, type BlogGetByIdParams, type BlogGetBySlugParams, type BlogGetCommentsParams, type BlogListParams, BlogModule, type BlogTypeSpecific, type ChangelogEntry, type ChangelogGetByIdParams, type ChangelogGetBySlugParams, type ChangelogGetCommentsParams, type ChangelogListParams, ChangelogModule, type ChangelogType, type ChangelogTypeSpecific, type ConfigListParams, ConfigModule, type CreateFeedbackCommentParams, type CreateFeedbackPostParams, type CreatedFeedbackComment, type CreatedFeedbackPost, type DeleteFeedbackCommentParams, type DeleteFeedbackCommentResponse, type DeleteFeedbackPostParams, type DeleteFeedbackPostResponse, type EntriesGetByIdParams, type EntriesGetBySlugParams, type EntriesGetCategoriesParams, type EntriesGetCommentsParams, type EntriesListParams, EntriesModule, type EntryAuthor, type EntryCategory, type EntryComment, type EntryStatus, type EntryTag, type EntryTagWithCount, type EntryType, type ExternalUser, type FeedbackAssignee, type FeedbackAuthor, type FeedbackColumnType, type FeedbackComment, type FeedbackKanbanColumn, type FeedbackListParams, FeedbackModule, type FeedbackPost, type FeedbackPostCategory, type FeedbackPostListItem, type FeedbackSortOption, type FeedbackTopContributor, type FeedbackTopContributorsParams, type FeedbackVoteParams, type FeedbackVoteResponse, type GenericEntry, type HealthCheckResponse, type HelpArticleEntry, type HelpArticleTypeSpecific, type HelpArticleVisibility, type HelpCategoriesParams, type HelpChatMessage, type HelpChatParams, type HelpChatResponse, type HelpChatSource, type HelpChatSourceCategory, type HelpChatStreamChunk, type HelpGetByIdParams, type HelpGetBySlugParams, type HelpGetCommentsParams, type HelpListParams, HelpModule, type HelpSearchParams, type HelpSearchResult, Kookee, KookeeApiError, type KookeeConfig, type KookeeUser, type ListMyFeedbackPostsParams, type LocaleOptions, type OrderDirection, type PageEntry, type PageTypeSpecific, type PagesGetByIdParams, type PagesGetBySlugParams, type PagesGetCommentsParams, type PagesListParams, PagesModule, type PaginatedResponse, type PaginationParams, type PublicConfig, type ReactParams, type ReactResponse, type ReactionType, type TypeSpecific, type TypedEntry };
+export { type AnnouncementDetail, type AnnouncementGetByIdParams, type AnnouncementGetCommentsParams, type AnnouncementListItem, type AnnouncementListParams, AnnouncementModule, type AnnouncementType, type AnnouncementTypeSpecific, type AnyEntryDetail, type AnyEntryListItem, type ApiError, type BaseEntry, type BlogEntryDetail, type BlogEntryListItem, type BlogGetByIdParams, type BlogGetBySlugParams, type BlogGetCommentsParams, type BlogListParams, BlogModule, type BlogTypeSpecific, type ChangelogEntryDetail, type ChangelogEntryListItem, type ChangelogGetByIdParams, type ChangelogGetBySlugParams, type ChangelogGetCommentsParams, type ChangelogListParams, ChangelogModule, type ChangelogType, type ChangelogTypeSpecific, type ConfigListParams, ConfigModule, type CreateFeedbackCommentParams, type CreateFeedbackPostParams, type CreatedFeedbackComment, type CreatedFeedbackPost, type DeleteFeedbackCommentParams, type DeleteFeedbackCommentResponse, type DeleteFeedbackPostParams, type DeleteFeedbackPostResponse, type EntriesGetByIdParams, type EntriesGetBySlugParams, type EntriesGetCategoriesParams, type EntriesGetCommentsParams, type EntriesListParams, EntriesModule, type EntryAuthor, type EntryCategory, type EntryCategoryRef, type EntryComment, type EntryDetailFields, type EntryStatus, type EntryTag, type EntryTagWithCount, type EntryTranslationSummary, type EntryTranslationsMap, type EntryType, type ExternalUser, type FeedbackAssignee, type FeedbackAuthor, type FeedbackColumnType, type FeedbackComment, type FeedbackKanbanColumn, type FeedbackListParams, FeedbackModule, type FeedbackPost, type FeedbackPostCategory, type FeedbackPostListItem, type FeedbackSortOption, type FeedbackTopContributor, type FeedbackTopContributorsParams, type FeedbackVoteParams, type FeedbackVoteResponse, type GenericEntryDetail, type GenericEntryListItem, type HealthCheckResponse, type HelpArticleDetail, type HelpArticleListItem, type HelpArticleTypeSpecific, type HelpArticleVisibility, type HelpCategoriesParams, type HelpChatMessage, type HelpChatParams, type HelpChatResponse, type HelpChatSource, type HelpChatSourceCategory, type HelpChatStreamChunk, type HelpGetByIdParams, type HelpGetBySlugParams, type HelpGetCommentsParams, type HelpListParams, HelpModule, type HelpSearchParams, type HelpSearchResult, Kookee, KookeeApiError, type KookeeConfig, type KookeeUser, type ListMyFeedbackPostsParams, type LocaleOptions, type OrderDirection, type PageEntryDetail, type PageEntryListItem, type PageTypeSpecific, type PagesGetByIdParams, type PagesGetBySlugParams, type PagesGetCommentsParams, type PagesListParams, PagesModule, type PaginatedResponse, type PaginationParams, type PublicConfig, type ReactParams, type ReactResponse, type ReactionType, type TypeSpecific, type TypedEntryDetail, type TypedEntryListItem };

package/dist/index.d.ts

@@ -15,7 +15,6 @@ interface PaginatedResponse<T> {
     data: T[];
     total: number;
     limit: number;
-    offset: number;
     page: number;
     totalPages: number;
 }
@@ -61,11 +60,11 @@ interface HelpChatSourceCategory {
 }
 interface HelpChatSource {
     id: string;
-    slug: string;
+    slug: string | null;
     title: string;
-    visibility: HelpArticleVisibility;
+    visibility: string | null;
     metadata: Record<string, NonNullable<unknown>> | null;
-    category: HelpChatSourceCategory;
+    category: HelpChatSourceCategory | null;
 }
 type HelpChatStreamChunk = {
     type: 'delta';
@@ -79,18 +78,6 @@ type HelpChatStreamChunk = {
     type: 'error';
     message: string;
 };
-interface HelpSearchResult {
-    id: string;
-    slug: string;
-    title: string;
-    excerptHtml: string | null;
-    category: {
-        name: string;
-        slug: string;
-    };
-    locale: string;
-    matchedChunk?: string;
-}
 type FeedbackColumnType = 'open' | 'closed';
 interface FeedbackKanbanColumn {
     id: string;
@@ -104,7 +91,7 @@ type FeedbackPostCategory = 'feature' | 'improvement' | 'bug' | 'other';
 type FeedbackSortOption = 'newest' | 'top' | 'trending';
 interface FeedbackAuthor {
     id: string;
-    name: string;
+    name: string | null;
     image: string | null;
     isTeamMember?: boolean;
     externalId?: string | null;
@@ -130,6 +117,7 @@ interface FeedbackPostListItem {
     columnName: string | null;
     columnColor: string | null;
     columnType: FeedbackColumnType | null;
+    kanbanPosition: number;
     category: FeedbackPostCategory;
     voteCount: number;
     commentCount: number;
@@ -143,7 +131,7 @@ interface FeedbackPost extends FeedbackPostListItem {
 }
 interface FeedbackTopContributor {
     id: string;
-    name: string;
+    name: string | null;
     image: string | null;
     totalVotes: number;
 }
@@ -214,12 +202,21 @@ type EntryType = 'blog' | 'page' | 'help_article' | 'changelog' | 'announcement'
 type EntryStatus = 'draft' | 'published' | 'archived';
 type ChangelogType = 'feature' | 'fix' | 'improvement' | 'breaking' | 'security' | 'deprecated' | 'other';
 type AnnouncementType = 'info' | 'warning' | 'critical' | 'promotion' | 'maintenance' | 'newFeature';
+/**
+ * Author shape returned on public entry responses.
+ *
+ * NOTE: `name` and `image` can be `null` on the server side.
+ */
 interface EntryAuthor {
-    name: string;
+    id: string;
+    name: string | null;
+    image: string | null;
 }
 interface EntryTag {
+    id: string;
     name: string;
     slug: string;
+    color: string | null;
 }
 interface EntryTagWithCount extends EntryTag {
     count: number;
@@ -239,33 +236,52 @@ interface EntryComment {
     updatedAt: string;
     author: EntryAuthor;
 }
+/**
+ * Resolved category attached to a public entry response.
+ *
+ * This is the server's `EntryCategory` row projected down to the fields
+ * that are safe/useful to expose publicly.
+ */
+interface EntryCategoryRef {
+    id: string;
+    slug: string;
+    name: string;
+    icon: string | null;
+    description: string | null;
+}
+/**
+ * Fields that appear on BOTH list and detail entry responses.
+ */
 interface BaseEntry {
     id: string;
     type: string;
     slug: string | null;
     title: string;
     excerptHtml: string | null;
-    contentHtml: string;
-    status: EntryStatus;
     publishedAt: string | null;
     locale: string;
     translationGroupId: string;
     categoryId: string | null;
+    category: EntryCategoryRef | null;
     coverImageUrl: string | null;
     position: number;
     views: number;
     metaTitle: string | null;
     metaDescription: string | null;
     metadata: Record<string, NonNullable<unknown>> | null;
+    reactions: Record<string, number>;
     createdAt: string;
     updatedAt: string;
     author: EntryAuthor;
     tags: EntryTag[];
-    reactions: Record<string, number>;
-    category: {
-        name: string;
-        slug: string;
-    } | null;
+}
+/**
+ * Fields added on entry DETAIL responses only.
+ *
+ * `contentHtml` is NOT returned on list endpoints.
+ */
+interface EntryDetailFields {
+    contentHtml: string;
 }
 interface BlogTypeSpecific {
     _type: 'blog';
@@ -289,31 +305,79 @@ interface AnnouncementTypeSpecific {
     unpublishAt: string | null;
 }
 type TypeSpecific = BlogTypeSpecific | PageTypeSpecific | HelpArticleTypeSpecific | ChangelogTypeSpecific | AnnouncementTypeSpecific;
-interface GenericEntry extends BaseEntry {
+interface GenericEntryListItem extends BaseEntry {
     typeSpecific: unknown;
 }
-interface BlogEntry extends BaseEntry {
+interface GenericEntryDetail extends BaseEntry, EntryDetailFields {
+    typeSpecific: unknown;
+}
+interface BlogEntryListItem extends BaseEntry {
     type: 'blog';
     typeSpecific: BlogTypeSpecific;
 }
-interface PageEntry extends BaseEntry {
+interface BlogEntryDetail extends BaseEntry, EntryDetailFields {
+    type: 'blog';
+    typeSpecific: BlogTypeSpecific;
+}
+interface PageEntryListItem extends BaseEntry {
+    type: 'page';
+    typeSpecific: PageTypeSpecific;
+}
+interface PageEntryDetail extends BaseEntry, EntryDetailFields {
     type: 'page';
     typeSpecific: PageTypeSpecific;
 }
-interface HelpArticleEntry extends BaseEntry {
+interface HelpArticleListItem extends BaseEntry {
+    type: 'help_article';
+    typeSpecific: HelpArticleTypeSpecific;
+}
+interface HelpArticleDetail extends BaseEntry, EntryDetailFields {
     type: 'help_article';
     typeSpecific: HelpArticleTypeSpecific;
 }
-interface ChangelogEntry extends BaseEntry {
+interface ChangelogEntryListItem extends BaseEntry {
     type: 'changelog';
     typeSpecific: ChangelogTypeSpecific;
 }
-interface AnnouncementEntry extends BaseEntry {
+interface ChangelogEntryDetail extends BaseEntry, EntryDetailFields {
+    type: 'changelog';
+    typeSpecific: ChangelogTypeSpecific;
+}
+interface AnnouncementListItem extends BaseEntry {
     type: 'announcement';
     typeSpecific: AnnouncementTypeSpecific;
 }
-type TypedEntry = BlogEntry | PageEntry | HelpArticleEntry | ChangelogEntry | AnnouncementEntry;
-type AnyEntry = TypedEntry | GenericEntry;
+interface AnnouncementDetail extends BaseEntry, EntryDetailFields {
+    type: 'announcement';
+    typeSpecific: AnnouncementTypeSpecific;
+}
+type TypedEntryListItem = BlogEntryListItem | PageEntryListItem | HelpArticleListItem | ChangelogEntryListItem | AnnouncementListItem;
+type TypedEntryDetail = BlogEntryDetail | PageEntryDetail | HelpArticleDetail | ChangelogEntryDetail | AnnouncementDetail;
+type AnyEntryListItem = TypedEntryListItem | GenericEntryListItem;
+type AnyEntryDetail = TypedEntryDetail | GenericEntryDetail;
+/**
+ * Help search result — returned by `GET /v1/help/search`.
+ *
+ * The server returns the exact same shape as a help article list response,
+ * so we alias it to `HelpArticleListItem`. There is no nested `category`
+ * object or `matchedChunk` field on this response (SDK <= 0.0.36 lied
+ * about both).
+ */
+type HelpSearchResult = HelpArticleListItem;
+/**
+ * Translation summary returned by the translations endpoints.
+ *
+ * The server returns a narrow { id, slug, locale, title } shape keyed by
+ * locale — NOT a full entry. Consumers that need the full body should
+ * fetch each translation individually via getBySlug / getById.
+ */
+interface EntryTranslationSummary {
+    id: string;
+    slug: string | null;
+    locale: string;
+    title: string;
+}
+type EntryTranslationsMap = Record<string, EntryTranslationSummary>;
 
 declare class KookeeApiError extends Error {
     readonly code: string;
@@ -355,11 +419,11 @@ interface EntriesGetCategoriesParams extends LocaleOptions {
 declare class EntriesModule {
     private readonly http;
     constructor(http: HttpClient);
-    list(params: EntriesListParams): Promise<PaginatedResponse<GenericEntry>>;
-    getById(id: string, params?: EntriesGetByIdParams): Promise<GenericEntry>;
-    getBySlug(slug: string, params: EntriesGetBySlugParams): Promise<GenericEntry>;
-    getTranslationsById(id: string): Promise<Record<string, GenericEntry>>;
-    getTranslationsBySlug(slug: string): Promise<Record<string, GenericEntry>>;
+    list(params: EntriesListParams): Promise<PaginatedResponse<GenericEntryListItem>>;
+    getById(id: string, params?: EntriesGetByIdParams): Promise<GenericEntryDetail>;
+    getBySlug(slug: string, params: EntriesGetBySlugParams): Promise<GenericEntryDetail>;
+    getTranslationsById(id: string): Promise<EntryTranslationsMap>;
+    getTranslationsBySlug(slug: string): Promise<EntryTranslationsMap>;
     getComments(entryId: string, params?: EntriesGetCommentsParams): Promise<PaginatedResponse<EntryComment>>;
     react(entryId: string, params: ReactParams): Promise<ReactResponse>;
     getTags(type: string): Promise<EntryTagWithCount[]>;
@@ -375,9 +439,9 @@ interface AnnouncementGetCommentsParams extends PaginationParams {
 declare class AnnouncementModule {
     private readonly entries;
     constructor(entries: EntriesModule);
-    list(params?: AnnouncementListParams): Promise<PaginatedResponse<AnnouncementEntry>>;
-    getById(id: string, params?: AnnouncementGetByIdParams): Promise<AnnouncementEntry>;
-    getTranslationsById(id: string): Promise<Record<string, AnnouncementEntry>>;
+    list(params?: AnnouncementListParams): Promise<PaginatedResponse<AnnouncementListItem>>;
+    getById(id: string, params?: AnnouncementGetByIdParams): Promise<AnnouncementDetail>;
+    getTranslationsById(id: string): Promise<EntryTranslationsMap>;
     getComments(entryId: string, params?: AnnouncementGetCommentsParams): Promise<PaginatedResponse<EntryComment>>;
 }
 
@@ -394,12 +458,12 @@ interface BlogGetCommentsParams extends PaginationParams {
 declare class BlogModule {
     private readonly entries;
     constructor(entries: EntriesModule);
-    list(params?: BlogListParams): Promise<PaginatedResponse<BlogEntry>>;
-    getBySlug(slug: string, params?: BlogGetBySlugParams): Promise<BlogEntry>;
-    getById(id: string, params?: BlogGetByIdParams): Promise<BlogEntry>;
+    list(params?: BlogListParams): Promise<PaginatedResponse<BlogEntryListItem>>;
+    getBySlug(slug: string, params?: BlogGetBySlugParams): Promise<BlogEntryDetail>;
+    getById(id: string, params?: BlogGetByIdParams): Promise<BlogEntryDetail>;
     getTags(): Promise<EntryTagWithCount[]>;
-    getTranslationsById(postId: string): Promise<Record<string, BlogEntry>>;
-    getTranslationsBySlug(slug: string): Promise<Record<string, BlogEntry>>;
+    getTranslationsById(postId: string): Promise<EntryTranslationsMap>;
+    getTranslationsBySlug(slug: string): Promise<EntryTranslationsMap>;
     getComments(entryId: string, params?: BlogGetCommentsParams): Promise<PaginatedResponse<EntryComment>>;
     react(postId: string, params: ReactParams): Promise<ReactResponse>;
 }
@@ -416,11 +480,11 @@ interface ChangelogGetCommentsParams extends PaginationParams {
 declare class ChangelogModule {
     private readonly entries;
     constructor(entries: EntriesModule);
-    list(params?: ChangelogListParams): Promise<PaginatedResponse<ChangelogEntry>>;
-    getBySlug(slug: string, params?: ChangelogGetBySlugParams): Promise<ChangelogEntry>;
-    getById(id: string, params?: ChangelogGetByIdParams): Promise<ChangelogEntry>;
-    getTranslationsById(id: string): Promise<Record<string, ChangelogEntry>>;
-    getTranslationsBySlug(slug: string): Promise<Record<string, ChangelogEntry>>;
+    list(params?: ChangelogListParams): Promise<PaginatedResponse<ChangelogEntryListItem>>;
+    getBySlug(slug: string, params?: ChangelogGetBySlugParams): Promise<ChangelogEntryDetail>;
+    getById(id: string, params?: ChangelogGetByIdParams): Promise<ChangelogEntryDetail>;
+    getTranslationsById(id: string): Promise<EntryTranslationsMap>;
+    getTranslationsBySlug(slug: string): Promise<EntryTranslationsMap>;
     getComments(entryId: string, params?: ChangelogGetCommentsParams): Promise<PaginatedResponse<EntryComment>>;
     react(changelogId: string, params: ReactParams): Promise<ReactResponse>;
 }
@@ -485,12 +549,12 @@ declare class HelpModule {
     private readonly entries;
     constructor(http: HttpClient, entries: EntriesModule);
     categories(params?: HelpCategoriesParams): Promise<EntryCategory[]>;
-    list(params?: HelpListParams): Promise<PaginatedResponse<HelpArticleEntry>>;
-    getBySlug(slug: string, params?: HelpGetBySlugParams): Promise<HelpArticleEntry>;
-    getById(id: string, params?: HelpGetByIdParams): Promise<HelpArticleEntry>;
+    list(params?: HelpListParams): Promise<PaginatedResponse<HelpArticleListItem>>;
+    getBySlug(slug: string, params?: HelpGetBySlugParams): Promise<HelpArticleDetail>;
+    getById(id: string, params?: HelpGetByIdParams): Promise<HelpArticleDetail>;
     search(params: HelpSearchParams): Promise<HelpSearchResult[]>;
-    getTranslationsById(articleId: string): Promise<Record<string, HelpArticleEntry>>;
-    getTranslationsBySlug(slug: string): Promise<Record<string, HelpArticleEntry>>;
+    getTranslationsById(articleId: string): Promise<EntryTranslationsMap>;
+    getTranslationsBySlug(slug: string): Promise<EntryTranslationsMap>;
     getComments(entryId: string, params?: HelpGetCommentsParams): Promise<PaginatedResponse<EntryComment>>;
     react(articleId: string, params: ReactParams): Promise<ReactResponse>;
     chat(params: HelpChatParams): Promise<HelpChatResponse>;
@@ -509,11 +573,11 @@ interface PagesGetCommentsParams extends PaginationParams {
 declare class PagesModule {
     private readonly entries;
     constructor(entries: EntriesModule);
-    list(params?: PagesListParams): Promise<PaginatedResponse<PageEntry>>;
-    getBySlug(slug: string, params?: PagesGetBySlugParams): Promise<PageEntry>;
-    getById(id: string, params?: PagesGetByIdParams): Promise<PageEntry>;
-    getTranslationsById(pageId: string): Promise<Record<string, PageEntry>>;
-    getTranslationsBySlug(slug: string): Promise<Record<string, PageEntry>>;
+    list(params?: PagesListParams): Promise<PaginatedResponse<PageEntryListItem>>;
+    getBySlug(slug: string, params?: PagesGetBySlugParams): Promise<PageEntryDetail>;
+    getById(id: string, params?: PagesGetByIdParams): Promise<PageEntryDetail>;
+    getTranslationsById(pageId: string): Promise<EntryTranslationsMap>;
+    getTranslationsBySlug(slug: string): Promise<EntryTranslationsMap>;
     getComments(entryId: string, params?: PagesGetCommentsParams): Promise<PaginatedResponse<EntryComment>>;
 }
 
@@ -535,4 +599,4 @@ declare class Kookee {
     health(): Promise<HealthCheckResponse>;
 }
 
-export { type AnnouncementEntry, type AnnouncementGetByIdParams, type AnnouncementGetCommentsParams, type AnnouncementListParams, AnnouncementModule, type AnnouncementType, type AnnouncementTypeSpecific, type AnyEntry, type ApiError, type BaseEntry, type BlogEntry, type BlogGetByIdParams, type BlogGetBySlugParams, type BlogGetCommentsParams, type BlogListParams, BlogModule, type BlogTypeSpecific, type ChangelogEntry, type ChangelogGetByIdParams, type ChangelogGetBySlugParams, type ChangelogGetCommentsParams, type ChangelogListParams, ChangelogModule, type ChangelogType, type ChangelogTypeSpecific, type ConfigListParams, ConfigModule, type CreateFeedbackCommentParams, type CreateFeedbackPostParams, type CreatedFeedbackComment, type CreatedFeedbackPost, type DeleteFeedbackCommentParams, type DeleteFeedbackCommentResponse, type DeleteFeedbackPostParams, type DeleteFeedbackPostResponse, type EntriesGetByIdParams, type EntriesGetBySlugParams, type EntriesGetCategoriesParams, type EntriesGetCommentsParams, type EntriesListParams, EntriesModule, type EntryAuthor, type EntryCategory, type EntryComment, type EntryStatus, type EntryTag, type EntryTagWithCount, type EntryType, type ExternalUser, type FeedbackAssignee, type FeedbackAuthor, type FeedbackColumnType, type FeedbackComment, type FeedbackKanbanColumn, type FeedbackListParams, FeedbackModule, type FeedbackPost, type FeedbackPostCategory, type FeedbackPostListItem, type FeedbackSortOption, type FeedbackTopContributor, type FeedbackTopContributorsParams, type FeedbackVoteParams, type FeedbackVoteResponse, type GenericEntry, type HealthCheckResponse, type HelpArticleEntry, type HelpArticleTypeSpecific, type HelpArticleVisibility, type HelpCategoriesParams, type HelpChatMessage, type HelpChatParams, type HelpChatResponse, type HelpChatSource, type HelpChatSourceCategory, type HelpChatStreamChunk, type HelpGetByIdParams, type HelpGetBySlugParams, type HelpGetCommentsParams, type HelpListParams, HelpModule, type HelpSearchParams, type HelpSearchResult, Kookee, KookeeApiError, type KookeeConfig, type KookeeUser, type ListMyFeedbackPostsParams, type LocaleOptions, type OrderDirection, type PageEntry, type PageTypeSpecific, type PagesGetByIdParams, type PagesGetBySlugParams, type PagesGetCommentsParams, type PagesListParams, PagesModule, type PaginatedResponse, type PaginationParams, type PublicConfig, type ReactParams, type ReactResponse, type ReactionType, type TypeSpecific, type TypedEntry };
+export { type AnnouncementDetail, type AnnouncementGetByIdParams, type AnnouncementGetCommentsParams, type AnnouncementListItem, type AnnouncementListParams, AnnouncementModule, type AnnouncementType, type AnnouncementTypeSpecific, type AnyEntryDetail, type AnyEntryListItem, type ApiError, type BaseEntry, type BlogEntryDetail, type BlogEntryListItem, type BlogGetByIdParams, type BlogGetBySlugParams, type BlogGetCommentsParams, type BlogListParams, BlogModule, type BlogTypeSpecific, type ChangelogEntryDetail, type ChangelogEntryListItem, type ChangelogGetByIdParams, type ChangelogGetBySlugParams, type ChangelogGetCommentsParams, type ChangelogListParams, ChangelogModule, type ChangelogType, type ChangelogTypeSpecific, type ConfigListParams, ConfigModule, type CreateFeedbackCommentParams, type CreateFeedbackPostParams, type CreatedFeedbackComment, type CreatedFeedbackPost, type DeleteFeedbackCommentParams, type DeleteFeedbackCommentResponse, type DeleteFeedbackPostParams, type DeleteFeedbackPostResponse, type EntriesGetByIdParams, type EntriesGetBySlugParams, type EntriesGetCategoriesParams, type EntriesGetCommentsParams, type EntriesListParams, EntriesModule, type EntryAuthor, type EntryCategory, type EntryCategoryRef, type EntryComment, type EntryDetailFields, type EntryStatus, type EntryTag, type EntryTagWithCount, type EntryTranslationSummary, type EntryTranslationsMap, type EntryType, type ExternalUser, type FeedbackAssignee, type FeedbackAuthor, type FeedbackColumnType, type FeedbackComment, type FeedbackKanbanColumn, type FeedbackListParams, FeedbackModule, type FeedbackPost, type FeedbackPostCategory, type FeedbackPostListItem, type FeedbackSortOption, type FeedbackTopContributor, type FeedbackTopContributorsParams, type FeedbackVoteParams, type FeedbackVoteResponse, type GenericEntryDetail, type GenericEntryListItem, type HealthCheckResponse, type HelpArticleDetail, type HelpArticleListItem, type HelpArticleTypeSpecific, type HelpArticleVisibility, type HelpCategoriesParams, type HelpChatMessage, type HelpChatParams, type HelpChatResponse, type HelpChatSource, type HelpChatSourceCategory, type HelpChatStreamChunk, type HelpGetByIdParams, type HelpGetBySlugParams, type HelpGetCommentsParams, type HelpListParams, HelpModule, type HelpSearchParams, type HelpSearchResult, Kookee, KookeeApiError, type KookeeConfig, type KookeeUser, type ListMyFeedbackPostsParams, type LocaleOptions, type OrderDirection, type PageEntryDetail, type PageEntryListItem, type PageTypeSpecific, type PagesGetByIdParams, type PagesGetBySlugParams, type PagesGetCommentsParams, type PagesListParams, PagesModule, type PaginatedResponse, type PaginationParams, type PublicConfig, type ReactParams, type ReactResponse, type ReactionType, type TypeSpecific, type TypedEntryDetail, type TypedEntryListItem };

package/dist/index.global.js

@@ -1,2 +1,2 @@
-(function(exports){'use strict';var k="https://api.kookee.dev",B="Kookee-API-Key",I="Kookee-Project-Id",i=class s extends Error{constructor(t,r,o){super(r);this.code=t;this.status=o;this.name="KookeeApiError",Object.setPrototypeOf(this,s.prototype);}},C=class{baseUrl;apiKey;projectId;constructor(e){this.apiKey=e.apiKey,this.projectId=e.projectId,this.baseUrl=e.baseUrl??k;}getHeaders(){let e={"Content-Type":"application/json"};return this.apiKey&&(e[B]=this.apiKey),this.projectId&&(e[I]=this.projectId),e}async get(e,t){let r=new URL(`${this.baseUrl}${e}`);if(t){for(let[h,n]of Object.entries(t))if(n!=null)if(Array.isArray(n))for(let a of n)r.searchParams.append(h,String(a));else r.searchParams.set(h,String(n));}let o=await fetch(r.toString(),{method:"GET",headers:this.getHeaders()});return this.handleResponse(o)}async post(e,t){let r=await fetch(`${this.baseUrl}${e}`,{method:"POST",headers:this.getHeaders(),body:t?JSON.stringify(t):void 0});return this.handleResponse(r)}async delete(e,t){let r=await fetch(`${this.baseUrl}${e}`,{method:"DELETE",headers:this.getHeaders(),body:t?JSON.stringify(t):void 0});return this.handleResponse(r)}async*streamPost(e,t){let r=await fetch(`${this.baseUrl}${e}`,{method:"POST",headers:{...this.getHeaders(),Accept:"text/event-stream"},body:t?JSON.stringify(t):void 0});if(!r.ok){let a=null;try{a=await r.json();}catch{}throw new i(a?.code??"UNKNOWN_ERROR",a?.message??`Request failed with status ${r.status}`,r.status)}if(!r.body)return;let o=r.body.getReader(),h=new TextDecoder,n="";try{for(;;){let{done:a,value:b}=await o.read();if(a)break;n+=h.decode(b,{stream:!0});let E=n.split(`
-`);n=E.pop()??"";for(let x of E){let u=x.trim();if(!(!u||u.startsWith(":"))&&u.startsWith("data: ")){let R=u.slice(6);if(R==="[DONE]")return;yield JSON.parse(R);}}}}finally{o.releaseLock();}}async handleResponse(e){if(!e.ok){let t=null;try{t=await e.json();}catch{}throw new i(t?.code??"UNKNOWN_ERROR",t?.message??`Request failed with status ${e.status}`,e.status)}return e.json()}};var m=class{constructor(e){this.entries=e;}async list(e){return this.entries.list({type:"announcement",...e})}async getById(e,t){return this.entries.getById(e,t)}async getTranslationsById(e){return this.entries.getTranslationsById(e)}async getComments(e,t){return this.entries.getComments(e,t)}};var p=class{constructor(e){this.entries=e;}async list(e){return this.entries.list({type:"blog",...e})}async getBySlug(e,t){return this.entries.getBySlug(e,{type:"blog",...t})}async getById(e,t){return this.entries.getById(e,t)}async getTags(){return this.entries.getTags("blog")}async getTranslationsById(e){return this.entries.getTranslationsById(e)}async getTranslationsBySlug(e){return this.entries.getTranslationsBySlug(e)}async getComments(e,t){return this.entries.getComments(e,t)}async react(e,t){return this.entries.react(e,t)}};var c=class{constructor(e){this.entries=e;}async list(e){return this.entries.list({type:"changelog",...e})}async getBySlug(e,t){return this.entries.getBySlug(e,{type:"changelog",...t})}async getById(e,t){return this.entries.getById(e,t)}async getTranslationsById(e){return this.entries.getTranslationsById(e)}async getTranslationsBySlug(e){return this.entries.getTranslationsBySlug(e)}async getComments(e,t){return this.entries.getComments(e,t)}async react(e,t){return this.entries.react(e,t)}};var g=class{constructor(e){this.http=e;}async getByKey(e){return this.http.get(`/v1/config/${encodeURIComponent(e)}`)}async list(e){return this.http.get("/v1/config",e)}};var l=class{constructor(e){this.http=e;}async list(e){return this.http.get("/v1/entries",e)}async getById(e,t){return this.http.get(`/v1/entries/by-id/${encodeURIComponent(e)}`,t)}async getBySlug(e,t){return this.http.get(`/v1/entries/${encodeURIComponent(e)}`,t)}async getTranslationsById(e){return this.http.get(`/v1/entries/by-id/${encodeURIComponent(e)}/translations`)}async getTranslationsBySlug(e){return this.http.get(`/v1/entries/${encodeURIComponent(e)}/translations`)}async getComments(e,t){return this.http.get(`/v1/entries/${encodeURIComponent(e)}/comments`,t)}async react(e,t){return this.http.post(`/v1/entries/${encodeURIComponent(e)}/reactions`,t)}async getTags(e){return this.http.get("/v1/tags",{type:e})}async getCategories(e,t){return this.http.get("/v1/categories",{type:e,...t})}};var y=class{constructor(e,t){this.http=e;this.getUserContext=t;}async getColumns(){return this.http.get("/v1/feedback/columns")}async list(e){return this.http.get("/v1/feedback",e)}async getById(e){return this.http.get(`/v1/feedback/by-id/${encodeURIComponent(e)}`)}async vote(e,t){return this.http.post(`/v1/feedback/${encodeURIComponent(e)}/vote`,t)}async getTopContributors(e){return this.http.get("/v1/feedback/top-contributors",e)}async createPost(e){let t=e.externalUser??this.getUserContext();if(!t)throw new Error("No user identified. Call kookee.identify() first or pass externalUser in params.");return this.http.post("/v1/feedback",{...e,externalUser:t})}async createComment(e,t){let r=t.externalUser??this.getUserContext();if(!r)throw new Error("No user identified. Call kookee.identify() first or pass externalUser in params.");return this.http.post(`/v1/feedback/${encodeURIComponent(e)}/comments`,{...t,externalUser:r})}async listMyPosts(e){let t=e?.externalId??this.getUserContext()?.externalId;if(!t)throw new Error("No user identified. Call kookee.identify() first or pass externalId in params.");return this.http.get("/v1/feedback/mine",{...e,externalId:t})}async deletePost(e,t){let r=t?.externalId??this.getUserContext()?.externalId;if(!r)throw new Error("No user identified. Call kookee.identify() first or pass externalId in params.");return this.http.delete(`/v1/feedback/${encodeURIComponent(e)}`,{externalId:r})}async deleteComment(e,t){let r=t?.externalId??this.getUserContext()?.externalId;if(!r)throw new Error("No user identified. Call kookee.identify() first or pass externalId in params.");return this.http.delete(`/v1/feedback/comments/${encodeURIComponent(e)}`,{externalId:r})}};var d=class{http;entries;constructor(e,t){this.http=e,this.entries=t;}async categories(e){return this.entries.getCategories("help_article",e)}async list(e){return this.entries.list({type:"help_article",...e})}async getBySlug(e,t){return this.entries.getBySlug(e,{type:"help_article",...t})}async getById(e,t){return this.entries.getById(e,t)}async search(e){return this.http.get("/v1/help/search",e)}async getTranslationsById(e){return this.entries.getTranslationsById(e)}async getTranslationsBySlug(e){return this.entries.getTranslationsBySlug(e)}async getComments(e,t){return this.entries.getComments(e,t)}async react(e,t){return this.entries.react(e,t)}async chat(e){return this.http.post("/v1/help/chat",e)}chatStream(e){return this.http.streamPost("/v1/help/chat/stream",e)}};var P=class{constructor(e){this.entries=e;}async list(e){return this.entries.list({type:"page",...e})}async getBySlug(e,t){return this.entries.getBySlug(e,{type:"page",...t})}async getById(e,t){return this.entries.getById(e,t)}async getTranslationsById(e){return this.entries.getTranslationsById(e)}async getTranslationsBySlug(e){return this.entries.getTranslationsBySlug(e)}async getComments(e,t){return this.entries.getComments(e,t)}};var f=class{http;user=null;entries;announcements;blog;changelog;config;feedback;help;pages;constructor(e){if(!e.apiKey&&!e.projectId)throw new Error("Either apiKey or projectId is required");this.http=new C({apiKey:e.apiKey,projectId:e.projectId,baseUrl:e.baseUrl}),this.entries=new l(this.http),this.announcements=new m(this.entries),this.blog=new p(this.entries),this.changelog=new c(this.entries),this.config=new g(this.http),this.feedback=new y(this.http,()=>this.user),this.help=new d(this.http,this.entries),this.pages=new P(this.entries);}identify(e){this.user=e;}reset(){this.user=null;}getUser(){return this.user}async health(){return this.http.get("/v1/health")}};exports.AnnouncementModule=m;exports.BlogModule=p;exports.ChangelogModule=c;exports.ConfigModule=g;exports.EntriesModule=l;exports.FeedbackModule=y;exports.HelpModule=d;exports.Kookee=f;exports.KookeeApiError=i;exports.PagesModule=P;return exports;})({});
+(function(exports){'use strict';var R="https://api.kookee.dev",I="Kookee-API-Key",B="Kookee-Project-Id",i=class n extends Error{constructor(t,s,o){super(s);this.code=t;this.status=o;this.name="KookeeApiError",Object.setPrototypeOf(this,n.prototype);}},C=class{baseUrl;apiKey;projectId;constructor(e){this.apiKey=e.apiKey,this.projectId=e.projectId,this.baseUrl=e.baseUrl??R;}getHeaders(){let e={"Content-Type":"application/json"};return this.apiKey&&(e[I]=this.apiKey),this.projectId&&(e[B]=this.projectId),e}async get(e,t){let s=new URL(`${this.baseUrl}${e}`);if(t){for(let[h,r]of Object.entries(t))if(r!=null)if(Array.isArray(r))for(let a of r)s.searchParams.append(h,String(a));else s.searchParams.set(h,String(r));}let o=await fetch(s.toString(),{method:"GET",headers:this.getHeaders()});return this.handleResponse(o)}async post(e,t){let s=await fetch(`${this.baseUrl}${e}`,{method:"POST",headers:this.getHeaders(),body:t?JSON.stringify(t):void 0});return this.handleResponse(s)}async delete(e,t){let s=await fetch(`${this.baseUrl}${e}`,{method:"DELETE",headers:this.getHeaders(),body:t?JSON.stringify(t):void 0});return this.handleResponse(s)}async*streamPost(e,t){let s=await fetch(`${this.baseUrl}${e}`,{method:"POST",headers:{...this.getHeaders(),Accept:"text/event-stream"},body:t?JSON.stringify(t):void 0});if(!s.ok){let a=null;try{a=await s.json();}catch{}throw new i(a?.code??"UNKNOWN_ERROR",a?.message??`Request failed with status ${s.status}`,s.status)}if(!s.body)return;let o=s.body.getReader(),h=new TextDecoder,r="";try{for(;;){let{done:a,value:k}=await o.read();if(a)break;r+=h.decode(k,{stream:!0});let E=r.split(`
+`);r=E.pop()??"";for(let x of E){let u=x.trim();if(!(!u||u.startsWith(":"))&&u.startsWith("data: ")){let b=u.slice(6);if(b==="[DONE]")return;yield JSON.parse(b);}}}}finally{o.releaseLock();}}async handleResponse(e){if(!e.ok){let t=null;try{t=await e.json();}catch{}throw new i(t?.code??"UNKNOWN_ERROR",t?.message??`Request failed with status ${e.status}`,e.status)}return e.json()}};var m=class{constructor(e){this.entries=e;}async list(e){return this.entries.list({type:"announcement",...e})}async getById(e,t){return this.entries.getById(e,t)}async getTranslationsById(e){return this.entries.getTranslationsById(e)}async getComments(e,t){return this.entries.getComments(e,t)}};var p=class{constructor(e){this.entries=e;}async list(e){return this.entries.list({type:"blog",...e})}async getBySlug(e,t){return this.entries.getBySlug(e,{type:"blog",...t})}async getById(e,t){return this.entries.getById(e,t)}async getTags(){return this.entries.getTags("blog")}async getTranslationsById(e){return this.entries.getTranslationsById(e)}async getTranslationsBySlug(e){return this.entries.getTranslationsBySlug(e)}async getComments(e,t){return this.entries.getComments(e,t)}async react(e,t){return this.entries.react(e,t)}};var l=class{constructor(e){this.entries=e;}async list(e){return this.entries.list({type:"changelog",...e})}async getBySlug(e,t){return this.entries.getBySlug(e,{type:"changelog",...t})}async getById(e,t){return this.entries.getById(e,t)}async getTranslationsById(e){return this.entries.getTranslationsById(e)}async getTranslationsBySlug(e){return this.entries.getTranslationsBySlug(e)}async getComments(e,t){return this.entries.getComments(e,t)}async react(e,t){return this.entries.react(e,t)}};var c=class{constructor(e){this.http=e;}async getByKey(e){return this.http.get(`/v1/config/${encodeURIComponent(e)}`)}async list(e){return this.http.get("/v1/config",e)}};var g=class{constructor(e){this.http=e;}async list(e){return this.http.get("/v1/entries",e)}async getById(e,t){return this.http.get(`/v1/entries/by-id/${encodeURIComponent(e)}`,t)}async getBySlug(e,t){return this.http.get(`/v1/entries/${encodeURIComponent(e)}`,t)}async getTranslationsById(e){return this.http.get(`/v1/entries/by-id/${encodeURIComponent(e)}/translations`)}async getTranslationsBySlug(e){return this.http.get(`/v1/entries/${encodeURIComponent(e)}/translations`)}async getComments(e,t){return this.http.get(`/v1/entries/${encodeURIComponent(e)}/comments`,t)}async react(e,t){return this.http.post(`/v1/entries/${encodeURIComponent(e)}/reactions`,t)}async getTags(e){return this.http.get("/v1/tags",{type:e})}async getCategories(e,t){return this.http.get("/v1/categories",{type:e,...t})}};var y=class{constructor(e,t){this.http=e;this.getUserContext=t;}async getColumns(){return this.http.get("/v1/feedback/columns")}async list(e){return this.http.get("/v1/feedback",e)}async getById(e){return this.http.get(`/v1/feedback/by-id/${encodeURIComponent(e)}`)}async vote(e,t){return this.http.post(`/v1/feedback/${encodeURIComponent(e)}/vote`,t)}async getTopContributors(e){return this.http.get("/v1/feedback/top-contributors",e)}async createPost(e){let t=e.externalUser??this.getUserContext();if(!t)throw new Error("No user identified. Call kookee.identify() first or pass externalUser in params.");return this.http.post("/v1/feedback",{...e,externalUser:t})}async createComment(e,t){let s=t.externalUser??this.getUserContext();if(!s)throw new Error("No user identified. Call kookee.identify() first or pass externalUser in params.");return this.http.post(`/v1/feedback/${encodeURIComponent(e)}/comments`,{...t,externalUser:s})}async listMyPosts(e){let t=e?.externalId??this.getUserContext()?.externalId;if(!t)throw new Error("No user identified. Call kookee.identify() first or pass externalId in params.");return this.http.get("/v1/feedback/mine",{...e,externalId:t})}async deletePost(e,t){let s=t?.externalId??this.getUserContext()?.externalId;if(!s)throw new Error("No user identified. Call kookee.identify() first or pass externalId in params.");return this.http.delete(`/v1/feedback/${encodeURIComponent(e)}`,{externalId:s})}async deleteComment(e,t){let s=t?.externalId??this.getUserContext()?.externalId;if(!s)throw new Error("No user identified. Call kookee.identify() first or pass externalId in params.");return this.http.delete(`/v1/feedback/comments/${encodeURIComponent(e)}`,{externalId:s})}};var d=class{http;entries;constructor(e,t){this.http=e,this.entries=t;}async categories(e){return this.entries.getCategories("help_article",e)}async list(e){return this.entries.list({type:"help_article",...e})}async getBySlug(e,t){return this.entries.getBySlug(e,{type:"help_article",...t})}async getById(e,t){return this.entries.getById(e,t)}async search(e){return this.http.get("/v1/help/search",e)}async getTranslationsById(e){return this.entries.getTranslationsById(e)}async getTranslationsBySlug(e){return this.entries.getTranslationsBySlug(e)}async getComments(e,t){return this.entries.getComments(e,t)}async react(e,t){return this.entries.react(e,t)}async chat(e){return this.http.post("/v1/help/chat",e)}chatStream(e){return this.http.streamPost("/v1/help/chat/stream",e)}};var P=class{constructor(e){this.entries=e;}async list(e){return this.entries.list({type:"page",...e})}async getBySlug(e,t){return this.entries.getBySlug(e,{type:"page",...t})}async getById(e,t){return this.entries.getById(e,t)}async getTranslationsById(e){return this.entries.getTranslationsById(e)}async getTranslationsBySlug(e){return this.entries.getTranslationsBySlug(e)}async getComments(e,t){return this.entries.getComments(e,t)}};var f=class{http;user=null;entries;announcements;blog;changelog;config;feedback;help;pages;constructor(e){if(!e.apiKey&&!e.projectId)throw new Error("Either apiKey or projectId is required");this.http=new C({apiKey:e.apiKey,projectId:e.projectId,baseUrl:e.baseUrl}),this.entries=new g(this.http),this.announcements=new m(this.entries),this.blog=new p(this.entries),this.changelog=new l(this.entries),this.config=new c(this.http),this.feedback=new y(this.http,()=>this.user),this.help=new d(this.http,this.entries),this.pages=new P(this.entries);}identify(e){this.user=e;}reset(){this.user=null;}getUser(){return this.user}async health(){return this.http.get("/v1/health")}};exports.AnnouncementModule=m;exports.BlogModule=p;exports.ChangelogModule=l;exports.ConfigModule=c;exports.EntriesModule=g;exports.FeedbackModule=y;exports.HelpModule=d;exports.Kookee=f;exports.KookeeApiError=i;exports.PagesModule=P;return exports;})({});

package/dist/index.js

@@ -1,2 +1,2 @@
-var k="https://api.kookee.dev",B="Kookee-API-Key",I="Kookee-Project-Id",i=class s extends Error{constructor(t,r,o){super(r);this.code=t;this.status=o;this.name="KookeeApiError",Object.setPrototypeOf(this,s.prototype);}},C=class{baseUrl;apiKey;projectId;constructor(e){this.apiKey=e.apiKey,this.projectId=e.projectId,this.baseUrl=e.baseUrl??k;}getHeaders(){let e={"Content-Type":"application/json"};return this.apiKey&&(e[B]=this.apiKey),this.projectId&&(e[I]=this.projectId),e}async get(e,t){let r=new URL(`${this.baseUrl}${e}`);if(t){for(let[h,n]of Object.entries(t))if(n!=null)if(Array.isArray(n))for(let a of n)r.searchParams.append(h,String(a));else r.searchParams.set(h,String(n));}let o=await fetch(r.toString(),{method:"GET",headers:this.getHeaders()});return this.handleResponse(o)}async post(e,t){let r=await fetch(`${this.baseUrl}${e}`,{method:"POST",headers:this.getHeaders(),body:t?JSON.stringify(t):void 0});return this.handleResponse(r)}async delete(e,t){let r=await fetch(`${this.baseUrl}${e}`,{method:"DELETE",headers:this.getHeaders(),body:t?JSON.stringify(t):void 0});return this.handleResponse(r)}async*streamPost(e,t){let r=await fetch(`${this.baseUrl}${e}`,{method:"POST",headers:{...this.getHeaders(),Accept:"text/event-stream"},body:t?JSON.stringify(t):void 0});if(!r.ok){let a=null;try{a=await r.json();}catch{}throw new i(a?.code??"UNKNOWN_ERROR",a?.message??`Request failed with status ${r.status}`,r.status)}if(!r.body)return;let o=r.body.getReader(),h=new TextDecoder,n="";try{for(;;){let{done:a,value:b}=await o.read();if(a)break;n+=h.decode(b,{stream:!0});let E=n.split(`
-`);n=E.pop()??"";for(let x of E){let u=x.trim();if(!(!u||u.startsWith(":"))&&u.startsWith("data: ")){let R=u.slice(6);if(R==="[DONE]")return;yield JSON.parse(R);}}}}finally{o.releaseLock();}}async handleResponse(e){if(!e.ok){let t=null;try{t=await e.json();}catch{}throw new i(t?.code??"UNKNOWN_ERROR",t?.message??`Request failed with status ${e.status}`,e.status)}return e.json()}};var m=class{constructor(e){this.entries=e;}async list(e){return this.entries.list({type:"announcement",...e})}async getById(e,t){return this.entries.getById(e,t)}async getTranslationsById(e){return this.entries.getTranslationsById(e)}async getComments(e,t){return this.entries.getComments(e,t)}};var p=class{constructor(e){this.entries=e;}async list(e){return this.entries.list({type:"blog",...e})}async getBySlug(e,t){return this.entries.getBySlug(e,{type:"blog",...t})}async getById(e,t){return this.entries.getById(e,t)}async getTags(){return this.entries.getTags("blog")}async getTranslationsById(e){return this.entries.getTranslationsById(e)}async getTranslationsBySlug(e){return this.entries.getTranslationsBySlug(e)}async getComments(e,t){return this.entries.getComments(e,t)}async react(e,t){return this.entries.react(e,t)}};var c=class{constructor(e){this.entries=e;}async list(e){return this.entries.list({type:"changelog",...e})}async getBySlug(e,t){return this.entries.getBySlug(e,{type:"changelog",...t})}async getById(e,t){return this.entries.getById(e,t)}async getTranslationsById(e){return this.entries.getTranslationsById(e)}async getTranslationsBySlug(e){return this.entries.getTranslationsBySlug(e)}async getComments(e,t){return this.entries.getComments(e,t)}async react(e,t){return this.entries.react(e,t)}};var g=class{constructor(e){this.http=e;}async getByKey(e){return this.http.get(`/v1/config/${encodeURIComponent(e)}`)}async list(e){return this.http.get("/v1/config",e)}};var l=class{constructor(e){this.http=e;}async list(e){return this.http.get("/v1/entries",e)}async getById(e,t){return this.http.get(`/v1/entries/by-id/${encodeURIComponent(e)}`,t)}async getBySlug(e,t){return this.http.get(`/v1/entries/${encodeURIComponent(e)}`,t)}async getTranslationsById(e){return this.http.get(`/v1/entries/by-id/${encodeURIComponent(e)}/translations`)}async getTranslationsBySlug(e){return this.http.get(`/v1/entries/${encodeURIComponent(e)}/translations`)}async getComments(e,t){return this.http.get(`/v1/entries/${encodeURIComponent(e)}/comments`,t)}async react(e,t){return this.http.post(`/v1/entries/${encodeURIComponent(e)}/reactions`,t)}async getTags(e){return this.http.get("/v1/tags",{type:e})}async getCategories(e,t){return this.http.get("/v1/categories",{type:e,...t})}};var y=class{constructor(e,t){this.http=e;this.getUserContext=t;}async getColumns(){return this.http.get("/v1/feedback/columns")}async list(e){return this.http.get("/v1/feedback",e)}async getById(e){return this.http.get(`/v1/feedback/by-id/${encodeURIComponent(e)}`)}async vote(e,t){return this.http.post(`/v1/feedback/${encodeURIComponent(e)}/vote`,t)}async getTopContributors(e){return this.http.get("/v1/feedback/top-contributors",e)}async createPost(e){let t=e.externalUser??this.getUserContext();if(!t)throw new Error("No user identified. Call kookee.identify() first or pass externalUser in params.");return this.http.post("/v1/feedback",{...e,externalUser:t})}async createComment(e,t){let r=t.externalUser??this.getUserContext();if(!r)throw new Error("No user identified. Call kookee.identify() first or pass externalUser in params.");return this.http.post(`/v1/feedback/${encodeURIComponent(e)}/comments`,{...t,externalUser:r})}async listMyPosts(e){let t=e?.externalId??this.getUserContext()?.externalId;if(!t)throw new Error("No user identified. Call kookee.identify() first or pass externalId in params.");return this.http.get("/v1/feedback/mine",{...e,externalId:t})}async deletePost(e,t){let r=t?.externalId??this.getUserContext()?.externalId;if(!r)throw new Error("No user identified. Call kookee.identify() first or pass externalId in params.");return this.http.delete(`/v1/feedback/${encodeURIComponent(e)}`,{externalId:r})}async deleteComment(e,t){let r=t?.externalId??this.getUserContext()?.externalId;if(!r)throw new Error("No user identified. Call kookee.identify() first or pass externalId in params.");return this.http.delete(`/v1/feedback/comments/${encodeURIComponent(e)}`,{externalId:r})}};var d=class{http;entries;constructor(e,t){this.http=e,this.entries=t;}async categories(e){return this.entries.getCategories("help_article",e)}async list(e){return this.entries.list({type:"help_article",...e})}async getBySlug(e,t){return this.entries.getBySlug(e,{type:"help_article",...t})}async getById(e,t){return this.entries.getById(e,t)}async search(e){return this.http.get("/v1/help/search",e)}async getTranslationsById(e){return this.entries.getTranslationsById(e)}async getTranslationsBySlug(e){return this.entries.getTranslationsBySlug(e)}async getComments(e,t){return this.entries.getComments(e,t)}async react(e,t){return this.entries.react(e,t)}async chat(e){return this.http.post("/v1/help/chat",e)}chatStream(e){return this.http.streamPost("/v1/help/chat/stream",e)}};var P=class{constructor(e){this.entries=e;}async list(e){return this.entries.list({type:"page",...e})}async getBySlug(e,t){return this.entries.getBySlug(e,{type:"page",...t})}async getById(e,t){return this.entries.getById(e,t)}async getTranslationsById(e){return this.entries.getTranslationsById(e)}async getTranslationsBySlug(e){return this.entries.getTranslationsBySlug(e)}async getComments(e,t){return this.entries.getComments(e,t)}};var f=class{http;user=null;entries;announcements;blog;changelog;config;feedback;help;pages;constructor(e){if(!e.apiKey&&!e.projectId)throw new Error("Either apiKey or projectId is required");this.http=new C({apiKey:e.apiKey,projectId:e.projectId,baseUrl:e.baseUrl}),this.entries=new l(this.http),this.announcements=new m(this.entries),this.blog=new p(this.entries),this.changelog=new c(this.entries),this.config=new g(this.http),this.feedback=new y(this.http,()=>this.user),this.help=new d(this.http,this.entries),this.pages=new P(this.entries);}identify(e){this.user=e;}reset(){this.user=null;}getUser(){return this.user}async health(){return this.http.get("/v1/health")}};export{m as AnnouncementModule,p as BlogModule,c as ChangelogModule,g as ConfigModule,l as EntriesModule,y as FeedbackModule,d as HelpModule,f as Kookee,i as KookeeApiError,P as PagesModule};
+var R="https://api.kookee.dev",I="Kookee-API-Key",B="Kookee-Project-Id",i=class n extends Error{constructor(t,s,o){super(s);this.code=t;this.status=o;this.name="KookeeApiError",Object.setPrototypeOf(this,n.prototype);}},C=class{baseUrl;apiKey;projectId;constructor(e){this.apiKey=e.apiKey,this.projectId=e.projectId,this.baseUrl=e.baseUrl??R;}getHeaders(){let e={"Content-Type":"application/json"};return this.apiKey&&(e[I]=this.apiKey),this.projectId&&(e[B]=this.projectId),e}async get(e,t){let s=new URL(`${this.baseUrl}${e}`);if(t){for(let[h,r]of Object.entries(t))if(r!=null)if(Array.isArray(r))for(let a of r)s.searchParams.append(h,String(a));else s.searchParams.set(h,String(r));}let o=await fetch(s.toString(),{method:"GET",headers:this.getHeaders()});return this.handleResponse(o)}async post(e,t){let s=await fetch(`${this.baseUrl}${e}`,{method:"POST",headers:this.getHeaders(),body:t?JSON.stringify(t):void 0});return this.handleResponse(s)}async delete(e,t){let s=await fetch(`${this.baseUrl}${e}`,{method:"DELETE",headers:this.getHeaders(),body:t?JSON.stringify(t):void 0});return this.handleResponse(s)}async*streamPost(e,t){let s=await fetch(`${this.baseUrl}${e}`,{method:"POST",headers:{...this.getHeaders(),Accept:"text/event-stream"},body:t?JSON.stringify(t):void 0});if(!s.ok){let a=null;try{a=await s.json();}catch{}throw new i(a?.code??"UNKNOWN_ERROR",a?.message??`Request failed with status ${s.status}`,s.status)}if(!s.body)return;let o=s.body.getReader(),h=new TextDecoder,r="";try{for(;;){let{done:a,value:k}=await o.read();if(a)break;r+=h.decode(k,{stream:!0});let E=r.split(`
+`);r=E.pop()??"";for(let x of E){let u=x.trim();if(!(!u||u.startsWith(":"))&&u.startsWith("data: ")){let b=u.slice(6);if(b==="[DONE]")return;yield JSON.parse(b);}}}}finally{o.releaseLock();}}async handleResponse(e){if(!e.ok){let t=null;try{t=await e.json();}catch{}throw new i(t?.code??"UNKNOWN_ERROR",t?.message??`Request failed with status ${e.status}`,e.status)}return e.json()}};var m=class{constructor(e){this.entries=e;}async list(e){return this.entries.list({type:"announcement",...e})}async getById(e,t){return this.entries.getById(e,t)}async getTranslationsById(e){return this.entries.getTranslationsById(e)}async getComments(e,t){return this.entries.getComments(e,t)}};var p=class{constructor(e){this.entries=e;}async list(e){return this.entries.list({type:"blog",...e})}async getBySlug(e,t){return this.entries.getBySlug(e,{type:"blog",...t})}async getById(e,t){return this.entries.getById(e,t)}async getTags(){return this.entries.getTags("blog")}async getTranslationsById(e){return this.entries.getTranslationsById(e)}async getTranslationsBySlug(e){return this.entries.getTranslationsBySlug(e)}async getComments(e,t){return this.entries.getComments(e,t)}async react(e,t){return this.entries.react(e,t)}};var l=class{constructor(e){this.entries=e;}async list(e){return this.entries.list({type:"changelog",...e})}async getBySlug(e,t){return this.entries.getBySlug(e,{type:"changelog",...t})}async getById(e,t){return this.entries.getById(e,t)}async getTranslationsById(e){return this.entries.getTranslationsById(e)}async getTranslationsBySlug(e){return this.entries.getTranslationsBySlug(e)}async getComments(e,t){return this.entries.getComments(e,t)}async react(e,t){return this.entries.react(e,t)}};var c=class{constructor(e){this.http=e;}async getByKey(e){return this.http.get(`/v1/config/${encodeURIComponent(e)}`)}async list(e){return this.http.get("/v1/config",e)}};var g=class{constructor(e){this.http=e;}async list(e){return this.http.get("/v1/entries",e)}async getById(e,t){return this.http.get(`/v1/entries/by-id/${encodeURIComponent(e)}`,t)}async getBySlug(e,t){return this.http.get(`/v1/entries/${encodeURIComponent(e)}`,t)}async getTranslationsById(e){return this.http.get(`/v1/entries/by-id/${encodeURIComponent(e)}/translations`)}async getTranslationsBySlug(e){return this.http.get(`/v1/entries/${encodeURIComponent(e)}/translations`)}async getComments(e,t){return this.http.get(`/v1/entries/${encodeURIComponent(e)}/comments`,t)}async react(e,t){return this.http.post(`/v1/entries/${encodeURIComponent(e)}/reactions`,t)}async getTags(e){return this.http.get("/v1/tags",{type:e})}async getCategories(e,t){return this.http.get("/v1/categories",{type:e,...t})}};var y=class{constructor(e,t){this.http=e;this.getUserContext=t;}async getColumns(){return this.http.get("/v1/feedback/columns")}async list(e){return this.http.get("/v1/feedback",e)}async getById(e){return this.http.get(`/v1/feedback/by-id/${encodeURIComponent(e)}`)}async vote(e,t){return this.http.post(`/v1/feedback/${encodeURIComponent(e)}/vote`,t)}async getTopContributors(e){return this.http.get("/v1/feedback/top-contributors",e)}async createPost(e){let t=e.externalUser??this.getUserContext();if(!t)throw new Error("No user identified. Call kookee.identify() first or pass externalUser in params.");return this.http.post("/v1/feedback",{...e,externalUser:t})}async createComment(e,t){let s=t.externalUser??this.getUserContext();if(!s)throw new Error("No user identified. Call kookee.identify() first or pass externalUser in params.");return this.http.post(`/v1/feedback/${encodeURIComponent(e)}/comments`,{...t,externalUser:s})}async listMyPosts(e){let t=e?.externalId??this.getUserContext()?.externalId;if(!t)throw new Error("No user identified. Call kookee.identify() first or pass externalId in params.");return this.http.get("/v1/feedback/mine",{...e,externalId:t})}async deletePost(e,t){let s=t?.externalId??this.getUserContext()?.externalId;if(!s)throw new Error("No user identified. Call kookee.identify() first or pass externalId in params.");return this.http.delete(`/v1/feedback/${encodeURIComponent(e)}`,{externalId:s})}async deleteComment(e,t){let s=t?.externalId??this.getUserContext()?.externalId;if(!s)throw new Error("No user identified. Call kookee.identify() first or pass externalId in params.");return this.http.delete(`/v1/feedback/comments/${encodeURIComponent(e)}`,{externalId:s})}};var d=class{http;entries;constructor(e,t){this.http=e,this.entries=t;}async categories(e){return this.entries.getCategories("help_article",e)}async list(e){return this.entries.list({type:"help_article",...e})}async getBySlug(e,t){return this.entries.getBySlug(e,{type:"help_article",...t})}async getById(e,t){return this.entries.getById(e,t)}async search(e){return this.http.get("/v1/help/search",e)}async getTranslationsById(e){return this.entries.getTranslationsById(e)}async getTranslationsBySlug(e){return this.entries.getTranslationsBySlug(e)}async getComments(e,t){return this.entries.getComments(e,t)}async react(e,t){return this.entries.react(e,t)}async chat(e){return this.http.post("/v1/help/chat",e)}chatStream(e){return this.http.streamPost("/v1/help/chat/stream",e)}};var P=class{constructor(e){this.entries=e;}async list(e){return this.entries.list({type:"page",...e})}async getBySlug(e,t){return this.entries.getBySlug(e,{type:"page",...t})}async getById(e,t){return this.entries.getById(e,t)}async getTranslationsById(e){return this.entries.getTranslationsById(e)}async getTranslationsBySlug(e){return this.entries.getTranslationsBySlug(e)}async getComments(e,t){return this.entries.getComments(e,t)}};var f=class{http;user=null;entries;announcements;blog;changelog;config;feedback;help;pages;constructor(e){if(!e.apiKey&&!e.projectId)throw new Error("Either apiKey or projectId is required");this.http=new C({apiKey:e.apiKey,projectId:e.projectId,baseUrl:e.baseUrl}),this.entries=new g(this.http),this.announcements=new m(this.entries),this.blog=new p(this.entries),this.changelog=new l(this.entries),this.config=new c(this.http),this.feedback=new y(this.http,()=>this.user),this.help=new d(this.http,this.entries),this.pages=new P(this.entries);}identify(e){this.user=e;}reset(){this.user=null;}getUser(){return this.user}async health(){return this.http.get("/v1/health")}};export{m as AnnouncementModule,p as BlogModule,l as ChangelogModule,c as ConfigModule,g as EntriesModule,y as FeedbackModule,d as HelpModule,f as Kookee,i as KookeeApiError,P as PagesModule};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kookee/sdk",
-  "version": "0.0.36",
+  "version": "0.0.38",
   "description": "Official Kookee SDK - Access your blog, changelog, help center, and more",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",