@cstar.help/js 0.1.1 → 0.2.1

package/README.md

@@ -140,7 +140,7 @@ const event = await constructEventAsync(rawBody, signature, secret);
 const cstar = new CStarClient({
 	apiKey: 'sk_live_...', // Required — secret or publishable key
 	teamId: 'tm_...', // Required — your team ID
-	baseUrl: 'https://...', // Optional — defaults to https://app.cstar.help
+	baseUrl: 'https://...', // Optional — defaults to https://www.cstar.help
 	version: '2026-03-01', // Optional — API version header
 	maxRetries: 3, // Optional — retry attempts for 5xx/429
 	timeout: 30000 // Optional — request timeout in ms

package/dist/auth/index.cjs

@@ -0,0 +1,127 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/auth/index.ts
+var auth_exports = {};
+__export(auth_exports, {
+  AuthClient: () => AuthClient
+});
+module.exports = __toCommonJS(auth_exports);
+var DEFAULT_BASE_URL = "https://app.cstar.help";
+var AuthClient = class {
+  constructor(config) {
+    this.session = null;
+    this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+    this.teamSlug = config.teamSlug;
+  }
+  /**
+   * Create a new customer account.
+   *
+   * If the team requires email confirmation, returns a `SignupConfirmationResult`
+   * instead of tokens. Check for `requiresConfirmation` in the response.
+   *
+   * @throws Error on validation failure, duplicate email, or server error
+   */
+  async signup(params) {
+    const response = await this.fetch(
+      "/widget/api/auth/signup",
+      {
+        method: "POST",
+        body: {
+          team_id: this.teamSlug,
+          email: params.email,
+          password: params.password,
+          name: params.name
+        }
+      }
+    );
+    if ("access_token" in response && response.access_token && response.customer) {
+      this.session = {
+        customer: response.customer,
+        accessToken: response.access_token,
+        refreshToken: response.refresh_token
+      };
+    }
+    return response;
+  }
+  /**
+   * Log in an existing customer with email and password.
+   *
+   * On success, stores the session internally so subsequent
+   * ChatClient requests can use `auth.getSession()` for tokens.
+   *
+   * @throws Error on invalid credentials, unconfirmed email, or server error
+   */
+  async login(params) {
+    const response = await this.fetch("/widget/api/auth/login", {
+      method: "POST",
+      body: {
+        team_id: this.teamSlug,
+        email: params.email,
+        password: params.password
+      }
+    });
+    if (response.access_token && response.customer) {
+      this.session = {
+        customer: response.customer,
+        accessToken: response.access_token,
+        refreshToken: response.refresh_token
+      };
+    }
+    return response;
+  }
+  /** Clear the stored session. */
+  logout() {
+    this.session = null;
+  }
+  /** Get the current session, or null if not authenticated. */
+  getSession() {
+    return this.session;
+  }
+  /** Get the authenticated customer, or null if not logged in. */
+  getCustomer() {
+    return this.session?.customer ?? null;
+  }
+  /** Whether a customer is currently authenticated. */
+  get isAuthenticated() {
+    return this.session !== null;
+  }
+  /** Get the current access token, or null. Useful for passing to ChatClient. */
+  get accessToken() {
+    return this.session?.accessToken ?? null;
+  }
+  async fetch(path, options) {
+    const url = `${this.baseUrl}${path}`;
+    const response = await globalThis.fetch(url, {
+      method: options.method,
+      headers: { "Content-Type": "application/json" },
+      body: options.body ? JSON.stringify(options.body) : void 0
+    });
+    if (!response.ok) {
+      const errorBody = await response.json().catch(() => ({ error: "Request failed" }));
+      const message = errorBody.error ?? errorBody.message ?? `Auth API error: ${response.status}`;
+      throw new Error(message);
+    }
+    return response.json();
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AuthClient
+});

package/dist/auth/index.d.cts

@@ -0,0 +1,123 @@
+/** Configuration for the AuthClient. */
+interface AuthConfig {
+    /** Team slug (e.g., 'acme'). Identifies which team's customers to authenticate. */
+    teamSlug: string;
+    /** Override the base URL (defaults to https://app.cstar.help). */
+    baseUrl?: string;
+}
+/** A customer identity returned from auth endpoints. */
+interface AuthCustomer {
+    id: string;
+    email: string;
+    name: string;
+}
+/** Parameters for signing up a new customer. */
+interface SignupParams {
+    /** Customer email address. */
+    email: string;
+    /** Password (minimum 6 characters). */
+    password: string;
+    /** Customer display name. */
+    name?: string;
+}
+/** Response from a successful signup. */
+interface SignupResult {
+    customer: AuthCustomer;
+    /** Access token for authenticated requests. Null if email confirmation is required. */
+    access_token: string | null;
+    /** Refresh token for renewing the session. Null if email confirmation is required. */
+    refresh_token: string | null;
+}
+/** Response when email confirmation is required after signup. */
+interface SignupConfirmationResult {
+    success: true;
+    message: string;
+    requiresConfirmation: true;
+}
+/** Parameters for logging in an existing customer. */
+interface LoginParams {
+    /** Customer email address. */
+    email: string;
+    /** Customer password. */
+    password: string;
+}
+/** Response from a successful login. */
+interface LoginResult {
+    customer: AuthCustomer;
+    /** Access token for authenticated requests. */
+    access_token: string | null;
+    /** Refresh token for renewing the session. */
+    refresh_token: string | null;
+}
+/** Stored session with tokens and customer identity. */
+interface AuthSession {
+    customer: AuthCustomer;
+    accessToken: string;
+    refreshToken: string;
+}
+
+/**
+ * Customer authentication client for the cStar widget API.
+ *
+ * Provides signup, login, and session management for end-customers
+ * interacting with your support widget or custom integration.
+ *
+ * ```typescript
+ * import { AuthClient } from '@cstar.help/js/auth';
+ *
+ * const auth = new AuthClient({ teamSlug: 'acme' });
+ *
+ * // Sign up a new customer
+ * const result = await auth.signup({
+ *   email: 'jane@example.com',
+ *   password: 'securepass123',
+ *   name: 'Jane Doe',
+ * });
+ *
+ * // Log in an existing customer
+ * const session = await auth.login({
+ *   email: 'jane@example.com',
+ *   password: 'securepass123',
+ * });
+ *
+ * // Check current session
+ * const current = auth.getSession();
+ * ```
+ */
+declare class AuthClient {
+    private readonly baseUrl;
+    private readonly teamSlug;
+    private session;
+    constructor(config: AuthConfig);
+    /**
+     * Create a new customer account.
+     *
+     * If the team requires email confirmation, returns a `SignupConfirmationResult`
+     * instead of tokens. Check for `requiresConfirmation` in the response.
+     *
+     * @throws Error on validation failure, duplicate email, or server error
+     */
+    signup(params: SignupParams): Promise<SignupResult | SignupConfirmationResult>;
+    /**
+     * Log in an existing customer with email and password.
+     *
+     * On success, stores the session internally so subsequent
+     * ChatClient requests can use `auth.getSession()` for tokens.
+     *
+     * @throws Error on invalid credentials, unconfirmed email, or server error
+     */
+    login(params: LoginParams): Promise<LoginResult>;
+    /** Clear the stored session. */
+    logout(): void;
+    /** Get the current session, or null if not authenticated. */
+    getSession(): AuthSession | null;
+    /** Get the authenticated customer, or null if not logged in. */
+    getCustomer(): AuthCustomer | null;
+    /** Whether a customer is currently authenticated. */
+    get isAuthenticated(): boolean;
+    /** Get the current access token, or null. Useful for passing to ChatClient. */
+    get accessToken(): string | null;
+    private fetch;
+}
+
+export { AuthClient, type AuthConfig, type AuthCustomer, type AuthSession, type LoginParams, type LoginResult, type SignupConfirmationResult, type SignupParams, type SignupResult };

package/dist/auth/index.d.ts

@@ -0,0 +1,123 @@
+/** Configuration for the AuthClient. */
+interface AuthConfig {
+    /** Team slug (e.g., 'acme'). Identifies which team's customers to authenticate. */
+    teamSlug: string;
+    /** Override the base URL (defaults to https://app.cstar.help). */
+    baseUrl?: string;
+}
+/** A customer identity returned from auth endpoints. */
+interface AuthCustomer {
+    id: string;
+    email: string;
+    name: string;
+}
+/** Parameters for signing up a new customer. */
+interface SignupParams {
+    /** Customer email address. */
+    email: string;
+    /** Password (minimum 6 characters). */
+    password: string;
+    /** Customer display name. */
+    name?: string;
+}
+/** Response from a successful signup. */
+interface SignupResult {
+    customer: AuthCustomer;
+    /** Access token for authenticated requests. Null if email confirmation is required. */
+    access_token: string | null;
+    /** Refresh token for renewing the session. Null if email confirmation is required. */
+    refresh_token: string | null;
+}
+/** Response when email confirmation is required after signup. */
+interface SignupConfirmationResult {
+    success: true;
+    message: string;
+    requiresConfirmation: true;
+}
+/** Parameters for logging in an existing customer. */
+interface LoginParams {
+    /** Customer email address. */
+    email: string;
+    /** Customer password. */
+    password: string;
+}
+/** Response from a successful login. */
+interface LoginResult {
+    customer: AuthCustomer;
+    /** Access token for authenticated requests. */
+    access_token: string | null;
+    /** Refresh token for renewing the session. */
+    refresh_token: string | null;
+}
+/** Stored session with tokens and customer identity. */
+interface AuthSession {
+    customer: AuthCustomer;
+    accessToken: string;
+    refreshToken: string;
+}
+
+/**
+ * Customer authentication client for the cStar widget API.
+ *
+ * Provides signup, login, and session management for end-customers
+ * interacting with your support widget or custom integration.
+ *
+ * ```typescript
+ * import { AuthClient } from '@cstar.help/js/auth';
+ *
+ * const auth = new AuthClient({ teamSlug: 'acme' });
+ *
+ * // Sign up a new customer
+ * const result = await auth.signup({
+ *   email: 'jane@example.com',
+ *   password: 'securepass123',
+ *   name: 'Jane Doe',
+ * });
+ *
+ * // Log in an existing customer
+ * const session = await auth.login({
+ *   email: 'jane@example.com',
+ *   password: 'securepass123',
+ * });
+ *
+ * // Check current session
+ * const current = auth.getSession();
+ * ```
+ */
+declare class AuthClient {
+    private readonly baseUrl;
+    private readonly teamSlug;
+    private session;
+    constructor(config: AuthConfig);
+    /**
+     * Create a new customer account.
+     *
+     * If the team requires email confirmation, returns a `SignupConfirmationResult`
+     * instead of tokens. Check for `requiresConfirmation` in the response.
+     *
+     * @throws Error on validation failure, duplicate email, or server error
+     */
+    signup(params: SignupParams): Promise<SignupResult | SignupConfirmationResult>;
+    /**
+     * Log in an existing customer with email and password.
+     *
+     * On success, stores the session internally so subsequent
+     * ChatClient requests can use `auth.getSession()` for tokens.
+     *
+     * @throws Error on invalid credentials, unconfirmed email, or server error
+     */
+    login(params: LoginParams): Promise<LoginResult>;
+    /** Clear the stored session. */
+    logout(): void;
+    /** Get the current session, or null if not authenticated. */
+    getSession(): AuthSession | null;
+    /** Get the authenticated customer, or null if not logged in. */
+    getCustomer(): AuthCustomer | null;
+    /** Whether a customer is currently authenticated. */
+    get isAuthenticated(): boolean;
+    /** Get the current access token, or null. Useful for passing to ChatClient. */
+    get accessToken(): string | null;
+    private fetch;
+}
+
+export { AuthClient, type AuthConfig, type AuthCustomer, type AuthSession, type LoginParams, type LoginResult, type SignupConfirmationResult, type SignupParams, type SignupResult };

package/dist/auth/index.js

@@ -0,0 +1,102 @@
+// src/auth/index.ts
+var DEFAULT_BASE_URL = "https://app.cstar.help";
+var AuthClient = class {
+  constructor(config) {
+    this.session = null;
+    this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+    this.teamSlug = config.teamSlug;
+  }
+  /**
+   * Create a new customer account.
+   *
+   * If the team requires email confirmation, returns a `SignupConfirmationResult`
+   * instead of tokens. Check for `requiresConfirmation` in the response.
+   *
+   * @throws Error on validation failure, duplicate email, or server error
+   */
+  async signup(params) {
+    const response = await this.fetch(
+      "/widget/api/auth/signup",
+      {
+        method: "POST",
+        body: {
+          team_id: this.teamSlug,
+          email: params.email,
+          password: params.password,
+          name: params.name
+        }
+      }
+    );
+    if ("access_token" in response && response.access_token && response.customer) {
+      this.session = {
+        customer: response.customer,
+        accessToken: response.access_token,
+        refreshToken: response.refresh_token
+      };
+    }
+    return response;
+  }
+  /**
+   * Log in an existing customer with email and password.
+   *
+   * On success, stores the session internally so subsequent
+   * ChatClient requests can use `auth.getSession()` for tokens.
+   *
+   * @throws Error on invalid credentials, unconfirmed email, or server error
+   */
+  async login(params) {
+    const response = await this.fetch("/widget/api/auth/login", {
+      method: "POST",
+      body: {
+        team_id: this.teamSlug,
+        email: params.email,
+        password: params.password
+      }
+    });
+    if (response.access_token && response.customer) {
+      this.session = {
+        customer: response.customer,
+        accessToken: response.access_token,
+        refreshToken: response.refresh_token
+      };
+    }
+    return response;
+  }
+  /** Clear the stored session. */
+  logout() {
+    this.session = null;
+  }
+  /** Get the current session, or null if not authenticated. */
+  getSession() {
+    return this.session;
+  }
+  /** Get the authenticated customer, or null if not logged in. */
+  getCustomer() {
+    return this.session?.customer ?? null;
+  }
+  /** Whether a customer is currently authenticated. */
+  get isAuthenticated() {
+    return this.session !== null;
+  }
+  /** Get the current access token, or null. Useful for passing to ChatClient. */
+  get accessToken() {
+    return this.session?.accessToken ?? null;
+  }
+  async fetch(path, options) {
+    const url = `${this.baseUrl}${path}`;
+    const response = await globalThis.fetch(url, {
+      method: options.method,
+      headers: { "Content-Type": "application/json" },
+      body: options.body ? JSON.stringify(options.body) : void 0
+    });
+    if (!response.ok) {
+      const errorBody = await response.json().catch(() => ({ error: "Request failed" }));
+      const message = errorBody.error ?? errorBody.message ?? `Auth API error: ${response.status}`;
+      throw new Error(message);
+    }
+    return response.json();
+  }
+};
+export {
+  AuthClient
+};

package/dist/chat/index.cjs

@@ -512,17 +512,14 @@ var ConversationsApi = class {
   /** Create a new conversation (ticket). */
   async create(params) {
     const teamId = this.chat.getTeamId();
-    const response = await this.chat.fetch(
-      "/api/widget/tickets",
-      {
-        method: "POST",
-        body: {
-          teamId,
-          subject: params.subject,
-          message: params.message
-        }
+    const response = await this.chat.fetch("/api/widget/tickets", {
+      method: "POST",
+      body: {
+        teamId,
+        subject: params.subject,
+        message: params.message
       }
-    );
+    });
     return {
       id: response.data.id,
       ticketNumber: "",

package/dist/chat/index.js

@@ -476,17 +476,14 @@ var ConversationsApi = class {
   /** Create a new conversation (ticket). */
   async create(params) {
     const teamId = this.chat.getTeamId();
-    const response = await this.chat.fetch(
-      "/api/widget/tickets",
-      {
-        method: "POST",
-        body: {
-          teamId,
-          subject: params.subject,
-          message: params.message
-        }
+    const response = await this.chat.fetch("/api/widget/tickets", {
+      method: "POST",
+      body: {
+        teamId,
+        subject: params.subject,
+        message: params.message
       }
-    );
+    });
     return {
       id: response.data.id,
       ticketNumber: "",

package/dist/index.cjs

@@ -97,7 +97,7 @@ function parseError(statusCode, body, retryAfter) {
 }
 
 // src/client.ts
-var SDK_VERSION = "0.1.0";
+var SDK_VERSION = "0.2.0";
 var DEFAULT_BASE_URL = "https://app.cstar.help";
 var DEFAULT_API_VERSION = "2026-03-01";
 var DEFAULT_MAX_RETRIES = 3;
@@ -179,7 +179,7 @@ var HttpClient = class {
   }
   buildHeaders(idempotencyKey) {
     const headers = {
-      "Authorization": `Bearer ${this.config.apiKey}`,
+      Authorization: `Bearer ${this.config.apiKey}`,
       "Content-Type": "application/json",
       "CStar-Version": this.config.version,
       "User-Agent": `@cstar.help/js/${SDK_VERSION}`
@@ -235,10 +235,7 @@ var BaseResource = class {
   }
   /** Delete a resource by ID. */
   async del(id) {
-    return this.client.request(
-      "DELETE",
-      `${this.basePath}/${id}`
-    );
+    return this.client.request("DELETE", `${this.basePath}/${id}`);
   }
   /**
    * Auto-paginating async iterator that yields every item across all pages.
@@ -285,21 +282,14 @@ var TicketMessagesResource = class {
   }
   /** List all messages on a ticket. */
   async list(ticketId) {
-    return this.client.request(
-      "GET",
-      `/tickets/${ticketId}/messages`
-    );
+    return this.client.request("GET", `/tickets/${ticketId}/messages`);
   }
   /** Add a message to a ticket. */
   async create(ticketId, params, options) {
-    return this.client.request(
-      "POST",
-      `/tickets/${ticketId}/messages`,
-      {
-        body: params,
-        idempotencyKey: options?.idempotencyKey
-      }
-    );
+    return this.client.request("POST", `/tickets/${ticketId}/messages`, {
+      body: params,
+      idempotencyKey: options?.idempotencyKey
+    });
   }
 };
 var TicketsResource = class extends BaseResource {

package/dist/index.js

@@ -65,7 +65,7 @@ function parseError(statusCode, body, retryAfter) {
 }
 
 // src/client.ts
-var SDK_VERSION = "0.1.0";
+var SDK_VERSION = "0.2.0";
 var DEFAULT_BASE_URL = "https://app.cstar.help";
 var DEFAULT_API_VERSION = "2026-03-01";
 var DEFAULT_MAX_RETRIES = 3;
@@ -147,7 +147,7 @@ var HttpClient = class {
   }
   buildHeaders(idempotencyKey) {
     const headers = {
-      "Authorization": `Bearer ${this.config.apiKey}`,
+      Authorization: `Bearer ${this.config.apiKey}`,
       "Content-Type": "application/json",
       "CStar-Version": this.config.version,
       "User-Agent": `@cstar.help/js/${SDK_VERSION}`
@@ -203,10 +203,7 @@ var BaseResource = class {
   }
   /** Delete a resource by ID. */
   async del(id) {
-    return this.client.request(
-      "DELETE",
-      `${this.basePath}/${id}`
-    );
+    return this.client.request("DELETE", `${this.basePath}/${id}`);
   }
   /**
    * Auto-paginating async iterator that yields every item across all pages.
@@ -253,21 +250,14 @@ var TicketMessagesResource = class {
   }
   /** List all messages on a ticket. */
   async list(ticketId) {
-    return this.client.request(
-      "GET",
-      `/tickets/${ticketId}/messages`
-    );
+    return this.client.request("GET", `/tickets/${ticketId}/messages`);
   }
   /** Add a message to a ticket. */
   async create(ticketId, params, options) {
-    return this.client.request(
-      "POST",
-      `/tickets/${ticketId}/messages`,
-      {
-        body: params,
-        idempotencyKey: options?.idempotencyKey
-      }
-    );
+    return this.client.request("POST", `/tickets/${ticketId}/messages`, {
+      body: params,
+      idempotencyKey: options?.idempotencyKey
+    });
   }
 };
 var TicketsResource = class extends BaseResource {

package/dist/library/index.cjs

@@ -65,10 +65,24 @@ var LibraryClient = class {
       q: query
     };
     if (params?.limit) queryParams.limit = String(params.limit);
-    return this.fetch(
-      `/api/library/${this.teamSlug}/search`,
-      queryParams
-    );
+    return this.fetch(`/api/library/${this.teamSlug}/search`, queryParams);
+  }
+  /** Get the most viewed articles, sorted by view count descending. */
+  async popularArticles(limit = 5) {
+    const articles = await this.articles({ limit: 50 });
+    return articles.sort((a, b) => (b.view_count ?? 0) - (a.view_count ?? 0)).slice(0, limit);
+  }
+  /** Get aggregate stats for this knowledge base (article count, category count, total views). */
+  async stats() {
+    const [categories, articles] = await Promise.all([
+      this.categories(),
+      this.articles({ limit: 1e3 })
+    ]);
+    return {
+      totalArticles: articles.length,
+      totalCategories: categories.length,
+      totalViews: articles.reduce((sum, a) => sum + (a.view_count ?? 0), 0)
+    };
   }
   async fetch(path, query) {
     let url = `${this.baseUrl}${path}`;

package/dist/library/index.d.cts

@@ -50,6 +50,12 @@ interface LibrarySearchResult {
     count: number;
     query: string;
 }
+/** Aggregate stats for a public knowledge base. */
+interface LibraryStats {
+    totalArticles: number;
+    totalCategories: number;
+    totalViews: number;
+}
 
 /**
  * Public knowledge base client. No authentication required.
@@ -76,7 +82,11 @@ declare class LibraryClient {
      * Returns matching articles with relevance ranking.
      */
     search(query: string, params?: LibrarySearchParams): Promise<LibrarySearchResult>;
+    /** Get the most viewed articles, sorted by view count descending. */
+    popularArticles(limit?: number): Promise<LibraryArticle[]>;
+    /** Get aggregate stats for this knowledge base (article count, category count, total views). */
+    stats(): Promise<LibraryStats>;
     private fetch;
 }
 
-export { type Category, type LibraryArticle, type LibraryArticleListParams, LibraryClient, type LibraryConfig, type LibrarySearchParams, type LibrarySearchResult };
+export { type Category, type LibraryArticle, type LibraryArticleListParams, LibraryClient, type LibraryConfig, type LibrarySearchParams, type LibrarySearchResult, type LibraryStats };

package/dist/library/index.d.ts

@@ -50,6 +50,12 @@ interface LibrarySearchResult {
     count: number;
     query: string;
 }
+/** Aggregate stats for a public knowledge base. */
+interface LibraryStats {
+    totalArticles: number;
+    totalCategories: number;
+    totalViews: number;
+}
 
 /**
  * Public knowledge base client. No authentication required.
@@ -76,7 +82,11 @@ declare class LibraryClient {
      * Returns matching articles with relevance ranking.
      */
     search(query: string, params?: LibrarySearchParams): Promise<LibrarySearchResult>;
+    /** Get the most viewed articles, sorted by view count descending. */
+    popularArticles(limit?: number): Promise<LibraryArticle[]>;
+    /** Get aggregate stats for this knowledge base (article count, category count, total views). */
+    stats(): Promise<LibraryStats>;
     private fetch;
 }
 
-export { type Category, type LibraryArticle, type LibraryArticleListParams, LibraryClient, type LibraryConfig, type LibrarySearchParams, type LibrarySearchResult };
+export { type Category, type LibraryArticle, type LibraryArticleListParams, LibraryClient, type LibraryConfig, type LibrarySearchParams, type LibrarySearchResult, type LibraryStats };

package/dist/library/index.js

@@ -41,10 +41,24 @@ var LibraryClient = class {
       q: query
     };
     if (params?.limit) queryParams.limit = String(params.limit);
-    return this.fetch(
-      `/api/library/${this.teamSlug}/search`,
-      queryParams
-    );
+    return this.fetch(`/api/library/${this.teamSlug}/search`, queryParams);
+  }
+  /** Get the most viewed articles, sorted by view count descending. */
+  async popularArticles(limit = 5) {
+    const articles = await this.articles({ limit: 50 });
+    return articles.sort((a, b) => (b.view_count ?? 0) - (a.view_count ?? 0)).slice(0, limit);
+  }
+  /** Get aggregate stats for this knowledge base (article count, category count, total views). */
+  async stats() {
+    const [categories, articles] = await Promise.all([
+      this.categories(),
+      this.articles({ limit: 1e3 })
+    ]);
+    return {
+      totalArticles: articles.length,
+      totalCategories: categories.length,
+      totalViews: articles.reduce((sum, a) => sum + (a.view_count ?? 0), 0)
+    };
   }
   async fetch(path, query) {
     let url = `${this.baseUrl}${path}`;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@cstar.help/js",
-	"version": "0.1.1",
+	"version": "0.2.1",
 	"description": "Official TypeScript SDK for the cStar customer support platform",
 	"type": "module",
 	"main": "./dist/index.cjs",
@@ -46,6 +46,16 @@
 				"types": "./dist/webhook/index.d.cts",
 				"default": "./dist/webhook/index.cjs"
 			}
+		},
+		"./auth": {
+			"import": {
+				"types": "./dist/auth/index.d.ts",
+				"default": "./dist/auth/index.js"
+			},
+			"require": {
+				"types": "./dist/auth/index.d.cts",
+				"default": "./dist/auth/index.cjs"
+			}
 		}
 	},
 	"files": [