@cstar.help/js 0.5.0 → 0.5.1

package/dist/chat/index.cjs

@@ -294,6 +294,7 @@ var ChatClient = class {
     this.supabaseAnonKey = config.supabaseAnonKey;
     this.conversations = new ConversationsApi(this);
     this.messages = new MessagesApi(this);
+    this.community = new ChatCommunityApi(this);
   }
   /**
    * Identify a customer using HMAC signature verification.
@@ -532,6 +533,84 @@ var ConversationsApi = class {
     };
   }
 };
+var ChatCommunityApi = class {
+  constructor(chat) {
+    this.chat = chat;
+  }
+  /** Create a new community post as the identified customer. */
+  async createPost(params) {
+    const teamId = this.chat.getTeamId();
+    if (!teamId) throw new Error("Not identified. Call chat.identify() first.");
+    const response = await this.chat.fetch("/api/widget/community", {
+      method: "POST",
+      body: {
+        teamId,
+        action: "createPost",
+        title: params.title,
+        body: params.body,
+        topicId: params.topicId
+      }
+    });
+    return response.data.post;
+  }
+  /** Toggle vote on a post. Returns new vote state and count. */
+  async vote(postId) {
+    const teamId = this.chat.getTeamId();
+    if (!teamId) throw new Error("Not identified. Call chat.identify() first.");
+    const response = await this.chat.fetch("/api/widget/community", {
+      method: "POST",
+      body: { teamId, action: "vote", postId }
+    });
+    return response.data;
+  }
+  /** Add a comment to a post. Supports 1-level nesting via parentCommentId. */
+  async comment(postId, params) {
+    const teamId = this.chat.getTeamId();
+    if (!teamId) throw new Error("Not identified. Call chat.identify() first.");
+    const response = await this.chat.fetch("/api/widget/community", {
+      method: "POST",
+      body: {
+        teamId,
+        action: "createComment",
+        postId,
+        commentBody: params.body,
+        parentCommentId: params.parentCommentId ?? null
+      }
+    });
+    return response.data.comment;
+  }
+  /** Toggle follow on a post. */
+  async follow(postId) {
+    const teamId = this.chat.getTeamId();
+    if (!teamId) throw new Error("Not identified. Call chat.identify() first.");
+    const response = await this.chat.fetch("/api/widget/community", {
+      method: "POST",
+      body: { teamId, action: "follow", postId }
+    });
+    return response.data;
+  }
+  /** Check if the current user has voted on a post. */
+  async getVoteStatus(postId) {
+    const teamId = this.chat.getTeamId();
+    if (!teamId) throw new Error("Not identified. Call chat.identify() first.");
+    const response = await this.chat.fetch("/api/widget/community", {
+      method: "GET",
+      query: { teamId, postId }
+    });
+    return response.data.voted;
+  }
+  /** Check vote status for multiple posts in one request. */
+  async bulkVoteStatus(postIds) {
+    if (postIds.length === 0) return {};
+    const teamId = this.chat.getTeamId();
+    if (!teamId) throw new Error("Not identified. Call chat.identify() first.");
+    const response = await this.chat.fetch("/api/widget/community", {
+      method: "GET",
+      query: { teamId, postIds: postIds.join(",") }
+    });
+    return response.data;
+  }
+};
 var MessagesApi = class {
   constructor(chat) {
     this.chat = chat;

package/dist/chat/index.d.cts

@@ -97,6 +97,61 @@ type MessageCallback = (message: WidgetMessage) => void;
 /** Callback for typing indicator events. */
 type TypingCallback = (payload: TypingPayload) => void;
 
+/** Parameters for creating a post as an identified customer. */
+interface CommunityCreatePostParams {
+    /** Post title. */
+    title: string;
+    /** Post body/content (optional). */
+    body?: string;
+    /** Topic UUID to post in. */
+    topicId: string;
+}
+/** Parameters for creating a comment as an identified customer. */
+interface CommunityCreateCommentParams {
+    /** Comment body text. */
+    body: string;
+    /** Parent comment ID for replies (optional, 1-level nesting). */
+    parentCommentId?: string | null;
+}
+/** Response from creating a post. */
+interface CommunityCreatedPost {
+    id: string;
+    title: string;
+    slug: string;
+    body: string;
+    status: string;
+    visibility: string;
+    voteCount: number;
+    commentCount: number;
+    topicName: string;
+    topicSlug: string;
+    authorName: string;
+    authorAvatar: string;
+    isTeamMember: boolean;
+    createdAt: string;
+}
+/** Response from creating a comment. */
+interface CommunityCreatedComment {
+    id: string;
+    body: string;
+    isOfficial: boolean;
+    voteScore: number;
+    parentCommentId: string | null;
+    authorName: string;
+    authorAvatar: string;
+    isTeamMember: boolean;
+    createdAt: string;
+}
+/** Response from toggling a vote. */
+interface CommunityVoteResult {
+    voted: boolean;
+    voteCount: number;
+}
+/** Response from toggling a follow. */
+interface CommunityFollowResult {
+    following: boolean;
+}
+
 /**
  * Customer-facing chat client for the cStar widget API.
  *
@@ -136,6 +191,8 @@ declare class ChatClient {
     readonly conversations: ConversationsApi;
     /** Sub-resource for managing messages. */
     readonly messages: MessagesApi;
+    /** Sub-resource for community actions (create posts, vote, comment). Uses the same session as chat. */
+    readonly community: ChatCommunityApi;
     constructor(config: ChatConfig);
     /**
      * Identify a customer using HMAC signature verification.
@@ -196,6 +253,26 @@ declare class ConversationsApi {
     /** Create a new conversation (ticket). */
     create(params: ConversationCreateParams): Promise<Conversation>;
 }
+/**
+ * Community sub-resource on ChatClient.
+ * Uses the same session token from `identify()` to authenticate community actions.
+ */
+declare class ChatCommunityApi {
+    private readonly chat;
+    constructor(chat: ChatClient);
+    /** Create a new community post as the identified customer. */
+    createPost(params: CommunityCreatePostParams): Promise<CommunityCreatedPost>;
+    /** Toggle vote on a post. Returns new vote state and count. */
+    vote(postId: string): Promise<CommunityVoteResult>;
+    /** Add a comment to a post. Supports 1-level nesting via parentCommentId. */
+    comment(postId: string, params: CommunityCreateCommentParams): Promise<CommunityCreatedComment>;
+    /** Toggle follow on a post. */
+    follow(postId: string): Promise<CommunityFollowResult>;
+    /** Check if the current user has voted on a post. */
+    getVoteStatus(postId: string): Promise<boolean>;
+    /** Check vote status for multiple posts in one request. */
+    bulkVoteStatus(postIds: string[]): Promise<Record<string, boolean>>;
+}
 /** Messages sub-resource on ChatClient. */
 declare class MessagesApi {
     private readonly chat;

package/dist/chat/index.d.ts

@@ -97,6 +97,61 @@ type MessageCallback = (message: WidgetMessage) => void;
 /** Callback for typing indicator events. */
 type TypingCallback = (payload: TypingPayload) => void;
 
+/** Parameters for creating a post as an identified customer. */
+interface CommunityCreatePostParams {
+    /** Post title. */
+    title: string;
+    /** Post body/content (optional). */
+    body?: string;
+    /** Topic UUID to post in. */
+    topicId: string;
+}
+/** Parameters for creating a comment as an identified customer. */
+interface CommunityCreateCommentParams {
+    /** Comment body text. */
+    body: string;
+    /** Parent comment ID for replies (optional, 1-level nesting). */
+    parentCommentId?: string | null;
+}
+/** Response from creating a post. */
+interface CommunityCreatedPost {
+    id: string;
+    title: string;
+    slug: string;
+    body: string;
+    status: string;
+    visibility: string;
+    voteCount: number;
+    commentCount: number;
+    topicName: string;
+    topicSlug: string;
+    authorName: string;
+    authorAvatar: string;
+    isTeamMember: boolean;
+    createdAt: string;
+}
+/** Response from creating a comment. */
+interface CommunityCreatedComment {
+    id: string;
+    body: string;
+    isOfficial: boolean;
+    voteScore: number;
+    parentCommentId: string | null;
+    authorName: string;
+    authorAvatar: string;
+    isTeamMember: boolean;
+    createdAt: string;
+}
+/** Response from toggling a vote. */
+interface CommunityVoteResult {
+    voted: boolean;
+    voteCount: number;
+}
+/** Response from toggling a follow. */
+interface CommunityFollowResult {
+    following: boolean;
+}
+
 /**
  * Customer-facing chat client for the cStar widget API.
  *
@@ -136,6 +191,8 @@ declare class ChatClient {
     readonly conversations: ConversationsApi;
     /** Sub-resource for managing messages. */
     readonly messages: MessagesApi;
+    /** Sub-resource for community actions (create posts, vote, comment). Uses the same session as chat. */
+    readonly community: ChatCommunityApi;
     constructor(config: ChatConfig);
     /**
      * Identify a customer using HMAC signature verification.
@@ -196,6 +253,26 @@ declare class ConversationsApi {
     /** Create a new conversation (ticket). */
     create(params: ConversationCreateParams): Promise<Conversation>;
 }
+/**
+ * Community sub-resource on ChatClient.
+ * Uses the same session token from `identify()` to authenticate community actions.
+ */
+declare class ChatCommunityApi {
+    private readonly chat;
+    constructor(chat: ChatClient);
+    /** Create a new community post as the identified customer. */
+    createPost(params: CommunityCreatePostParams): Promise<CommunityCreatedPost>;
+    /** Toggle vote on a post. Returns new vote state and count. */
+    vote(postId: string): Promise<CommunityVoteResult>;
+    /** Add a comment to a post. Supports 1-level nesting via parentCommentId. */
+    comment(postId: string, params: CommunityCreateCommentParams): Promise<CommunityCreatedComment>;
+    /** Toggle follow on a post. */
+    follow(postId: string): Promise<CommunityFollowResult>;
+    /** Check if the current user has voted on a post. */
+    getVoteStatus(postId: string): Promise<boolean>;
+    /** Check vote status for multiple posts in one request. */
+    bulkVoteStatus(postIds: string[]): Promise<Record<string, boolean>>;
+}
 /** Messages sub-resource on ChatClient. */
 declare class MessagesApi {
     private readonly chat;

package/dist/chat/index.js

@@ -258,6 +258,7 @@ var ChatClient = class {
     this.supabaseAnonKey = config.supabaseAnonKey;
     this.conversations = new ConversationsApi(this);
     this.messages = new MessagesApi(this);
+    this.community = new ChatCommunityApi(this);
   }
   /**
    * Identify a customer using HMAC signature verification.
@@ -496,6 +497,84 @@ var ConversationsApi = class {
     };
   }
 };
+var ChatCommunityApi = class {
+  constructor(chat) {
+    this.chat = chat;
+  }
+  /** Create a new community post as the identified customer. */
+  async createPost(params) {
+    const teamId = this.chat.getTeamId();
+    if (!teamId) throw new Error("Not identified. Call chat.identify() first.");
+    const response = await this.chat.fetch("/api/widget/community", {
+      method: "POST",
+      body: {
+        teamId,
+        action: "createPost",
+        title: params.title,
+        body: params.body,
+        topicId: params.topicId
+      }
+    });
+    return response.data.post;
+  }
+  /** Toggle vote on a post. Returns new vote state and count. */
+  async vote(postId) {
+    const teamId = this.chat.getTeamId();
+    if (!teamId) throw new Error("Not identified. Call chat.identify() first.");
+    const response = await this.chat.fetch("/api/widget/community", {
+      method: "POST",
+      body: { teamId, action: "vote", postId }
+    });
+    return response.data;
+  }
+  /** Add a comment to a post. Supports 1-level nesting via parentCommentId. */
+  async comment(postId, params) {
+    const teamId = this.chat.getTeamId();
+    if (!teamId) throw new Error("Not identified. Call chat.identify() first.");
+    const response = await this.chat.fetch("/api/widget/community", {
+      method: "POST",
+      body: {
+        teamId,
+        action: "createComment",
+        postId,
+        commentBody: params.body,
+        parentCommentId: params.parentCommentId ?? null
+      }
+    });
+    return response.data.comment;
+  }
+  /** Toggle follow on a post. */
+  async follow(postId) {
+    const teamId = this.chat.getTeamId();
+    if (!teamId) throw new Error("Not identified. Call chat.identify() first.");
+    const response = await this.chat.fetch("/api/widget/community", {
+      method: "POST",
+      body: { teamId, action: "follow", postId }
+    });
+    return response.data;
+  }
+  /** Check if the current user has voted on a post. */
+  async getVoteStatus(postId) {
+    const teamId = this.chat.getTeamId();
+    if (!teamId) throw new Error("Not identified. Call chat.identify() first.");
+    const response = await this.chat.fetch("/api/widget/community", {
+      method: "GET",
+      query: { teamId, postId }
+    });
+    return response.data.voted;
+  }
+  /** Check vote status for multiple posts in one request. */
+  async bulkVoteStatus(postIds) {
+    if (postIds.length === 0) return {};
+    const teamId = this.chat.getTeamId();
+    if (!teamId) throw new Error("Not identified. Call chat.identify() first.");
+    const response = await this.chat.fetch("/api/widget/community", {
+      method: "GET",
+      query: { teamId, postIds: postIds.join(",") }
+    });
+    return response.data;
+  }
+};
 var MessagesApi = class {
   constructor(chat) {
     this.chat = chat;

package/dist/community/index.cjs

@@ -26,9 +26,30 @@ module.exports = __toCommonJS(community_exports);
 var DEFAULT_BASE_URL = "https://www.cstar.help";
 var CommunityClient = class {
   constructor(config) {
+    this.sessionToken = null;
+    this.teamId = null;
     this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
     this.teamSlug = config.teamSlug;
   }
+  /**
+   * Set a session token from identity verification.
+   * This enables authenticated operations (create posts, vote, comment).
+   *
+   * The token is the same `sessionToken` returned by `ChatClient.identify()`.
+   */
+  setSessionToken(token, teamId) {
+    this.sessionToken = token;
+    if (teamId) this.teamId = teamId;
+  }
+  /** Clear the session token and return to read-only mode. */
+  clearSession() {
+    this.sessionToken = null;
+    this.teamId = null;
+  }
+  /** Whether the client has an active session token. */
+  get isAuthenticated() {
+    return this.sessionToken !== null;
+  }
   /** List all public community topics. */
   async topics() {
     const response = await this.fetch(
@@ -66,6 +87,134 @@ var CommunityClient = class {
       q: query
     });
   }
+  // ── Authenticated Actions (require setSessionToken) ──
+  /**
+   * Create a new community post. Requires an active session token.
+   *
+   * @throws Error if no session token is set or the request fails
+   */
+  async createPost(params) {
+    const teamId = this.resolveTeamId();
+    const response = await this.authenticatedFetch("/api/widget/community", {
+      method: "POST",
+      body: {
+        teamId,
+        action: "createPost",
+        title: params.title,
+        body: params.body,
+        topicId: params.topicId
+      }
+    });
+    return response.data.post;
+  }
+  /**
+   * Toggle vote on a post. Returns new vote state and count.
+   * Requires an active session token.
+   */
+  async vote(postId) {
+    const teamId = this.resolveTeamId();
+    const response = await this.authenticatedFetch("/api/widget/community", {
+      method: "POST",
+      body: { teamId, action: "vote", postId }
+    });
+    return response.data;
+  }
+  /**
+   * Add a comment to a post. Requires an active session token.
+   */
+  async comment(postId, params) {
+    const teamId = this.resolveTeamId();
+    const response = await this.authenticatedFetch("/api/widget/community", {
+      method: "POST",
+      body: {
+        teamId,
+        action: "createComment",
+        postId,
+        commentBody: params.body,
+        parentCommentId: params.parentCommentId ?? null
+      }
+    });
+    return response.data.comment;
+  }
+  /**
+   * Toggle follow on a post. Requires an active session token.
+   */
+  async follow(postId) {
+    const teamId = this.resolveTeamId();
+    const response = await this.authenticatedFetch("/api/widget/community", {
+      method: "POST",
+      body: { teamId, action: "follow", postId }
+    });
+    return response.data;
+  }
+  /**
+   * Check if the current user has voted on a specific post.
+   * Requires an active session token.
+   */
+  async getVoteStatus(postId) {
+    const teamId = this.resolveTeamId();
+    const response = await this.authenticatedFetch("/api/widget/community", {
+      method: "GET",
+      query: { teamId, postId }
+    });
+    return response.data.voted;
+  }
+  /**
+   * Check vote status for multiple posts in a single request.
+   * Returns a map of postId → voted boolean.
+   * Requires an active session token.
+   */
+  async bulkVoteStatus(postIds) {
+    if (postIds.length === 0) return {};
+    const teamId = this.resolveTeamId();
+    const response = await this.authenticatedFetch("/api/widget/community", {
+      method: "GET",
+      query: { teamId, postIds: postIds.join(",") }
+    });
+    return response.data;
+  }
+  // ── Internal Helpers ──
+  /**
+   * Resolve team slug to team ID (cached after first call).
+   * For authenticated operations that require teamId.
+   */
+  resolveTeamId() {
+    if (this.teamId) return this.teamId;
+    throw new Error(
+      "Team ID is required for authenticated operations. Pass it via setSessionToken(token, teamId) or use ChatClient.identify() which provides it automatically."
+    );
+  }
+  async authenticatedFetch(path, options) {
+    if (!this.sessionToken) {
+      throw new Error(
+        "Session token required. Call setSessionToken() or use ChatClient.identify() first."
+      );
+    }
+    let url = `${this.baseUrl}${path}`;
+    if (options.query) {
+      const params = new URLSearchParams();
+      for (const [key, value] of Object.entries(options.query)) {
+        if (value !== void 0) params.set(key, value);
+      }
+      const qs = params.toString();
+      if (qs) url += `?${qs}`;
+    }
+    const headers = {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${this.sessionToken}`
+    };
+    const response = await globalThis.fetch(url, {
+      method: options.method,
+      headers,
+      body: options.body ? JSON.stringify(options.body) : void 0
+    });
+    if (!response.ok) {
+      const errorBody = await response.json().catch(() => ({ error: { message: "Request failed" } }));
+      const message = typeof errorBody.error === "string" ? errorBody.error : errorBody.error?.message ?? `Community API error: ${response.status}`;
+      throw new Error(message);
+    }
+    return response.json();
+  }
   async fetch(path, query) {
     let url = `${this.baseUrl}${path}`;
     if (query) {