@cstar.help/js 0.10.3 → 0.11.0

package/README.md

@@ -30,7 +30,7 @@ cStar has one package with **six entry points**, each designed for a different c
 
 ### The Security Model
 
-cStar uses **two key types** to control access — the same pattern as Stripe and Supabase:
+cStar uses **two key types** to control access — the same pattern as Stripe:
 
 ```
 Secret keys (sk_live_*, sk_test_*)
@@ -211,8 +211,8 @@ await chat.identify(
 	hmacSignature
 );
 
-// List conversations
-const { conversations } = await chat.conversations.list();
+// List tickets
+const { tickets } = await chat.tickets.list();
 
 // Send a message
 await chat.messages.send('tkt_abc123', 'Thanks for the help!');

package/dist/chat/index.cjs

@@ -45,8 +45,8 @@ var RealtimeManager = class {
     this.options = options;
   }
   /**
-   * Initialize the Supabase client and authenticate with a realtime token.
-   * Returns true if successful, false if @supabase/supabase-js is unavailable.
+   * Initialize the realtime client and authenticate with a token.
+   * Returns true if successful, false if the realtime runtime is unavailable.
    */
   init() {
     if (this.initPromise) return this.initPromise;
@@ -55,15 +55,15 @@ var RealtimeManager = class {
   }
   async doInit() {
     try {
+      const tokenData = await this.options.fetchToken();
       const { createClient } = await import(
         /* webpackIgnore: true */
         "@supabase/supabase-js"
       );
-      this.client = createClient(this.options.supabaseUrl, this.options.supabaseAnonKey, {
+      this.client = createClient(tokenData.realtimeUrl, tokenData.realtimeKey, {
         auth: { persistSession: false, autoRefreshToken: false },
         realtime: { params: { eventsPerSecond: 10 } }
       });
-      const tokenData = await this.options.fetchToken();
       this.setToken(tokenData);
       return true;
     } catch {
@@ -121,7 +121,8 @@ var RealtimeManager = class {
           sender_name: row.sender_name ?? "",
           created_at: row.created_at,
           read_at: row.read_at ?? null,
-          attachments: row.attachments ?? []
+          attachments: row.attachments ?? [],
+          payload: row.payload ?? null
         };
         callback(message);
       }
@@ -129,7 +130,7 @@ var RealtimeManager = class {
     this.channels.set(channelName, channel);
     return () => this.removeChannel(channelName);
   }
-  /** Get the underlying Supabase client (for sharing with PresenceManager). */
+  /** Get the underlying realtime client (for sharing with PresenceManager). */
   getClient() {
     return this.client;
   }
@@ -171,7 +172,7 @@ var PresenceManager = class {
     this.typingClearTimers = /* @__PURE__ */ new Map();
     this.options = options;
   }
-  /** Set the Supabase client (shared from RealtimeManager). */
+  /** Set the realtime client (shared from RealtimeManager). */
   setClient(client) {
     this.client = client;
   }
@@ -290,18 +291,17 @@ var ChatClient = class {
     this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
     this.teamSlug = config.teamSlug;
     this.pollingInterval = config.pollingInterval ?? DEFAULT_POLLING_INTERVAL;
-    this.supabaseUrl = config.supabaseUrl;
-    this.supabaseAnonKey = config.supabaseAnonKey;
-    this.conversations = new ConversationsApi(this);
+    this.realtimeEnabled = config.realtime !== false;
+    this.tickets = new TicketsApi(this);
     this.messages = new MessagesApi(this);
     this.community = new ChatCommunityApi(this);
   }
   /**
    * Identify a customer using HMAC signature verification.
-   * Must be called before accessing conversations or messages.
+   * Must be called before accessing tickets or messages.
    *
-   * If `supabaseUrl` and `supabaseAnonKey` were provided in the config,
-   * this will also initialize real-time subscriptions (non-blocking).
+   * Real-time subscriptions are initialized automatically (non-blocking)
+   * unless `realtime: false` was passed in config.
    *
    * @param customer - Customer identity fields
    * @param signature - HMAC-SHA256 hex signature of the signed fields
@@ -323,7 +323,7 @@ var ChatClient = class {
     this.sessionToken = response.data.sessionToken;
     this.teamId = response.data.teamId;
     this.customerId = response.data.customer.id;
-    if (this.supabaseUrl && this.supabaseAnonKey) {
+    if (this.realtimeEnabled) {
       this.realtimeInitPromise = this.initRealtime(
         response.data.customer.id,
         response.data.customer.name || customer.name || customer.email
@@ -332,8 +332,8 @@ var ChatClient = class {
     return response.data;
   }
   /**
-   * Subscribe to new messages on a conversation.
-   * Uses Supabase Realtime (Postgres Changes) when available, falls back to polling.
+   * Subscribe to new messages on a ticket.
+   * Uses real-time delivery when available, falls back to polling.
    *
    * @returns Unsubscribe function
    */
@@ -345,7 +345,7 @@ var ChatClient = class {
   }
   /**
    * Subscribe to typing indicator events.
-   * Requires Supabase Realtime — returns a no-op if unavailable.
+   * Requires real-time — returns a no-op when unavailable.
    *
    * @returns Unsubscribe function
    */
@@ -357,8 +357,8 @@ var ChatClient = class {
     };
   }
   /**
-   * Send a customer typing indicator (requires realtime).
-   * No-op if realtime is not available.
+   * Send a customer typing indicator (requires real-time).
+   * No-op when real-time is unavailable.
    */
   async sendTyping(ticketId, isTyping) {
     if (this.presenceManager) {
@@ -422,8 +422,6 @@ var ChatClient = class {
   async initRealtime(customerId, customerName) {
     try {
       this.realtimeManager = new RealtimeManager({
-        supabaseUrl: this.supabaseUrl,
-        supabaseAnonKey: this.supabaseAnonKey,
         fetchToken: () => this.fetchRealtimeToken()
       });
       const ready = await this.realtimeManager.init();
@@ -490,28 +488,29 @@ var ChatClient = class {
     return qs ? `${base}?${qs}` : base;
   }
 };
-var ConversationsApi = class {
+var TicketsApi = class {
   constructor(chat) {
     this.chat = chat;
   }
-  /** List conversations for the identified customer. */
+  /** List tickets for the identified customer. */
   async list(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/conversations",
-      {
-        method: "GET",
-        query: {
-          teamId,
-          limit: params?.limit?.toString(),
-          cursor: params?.cursor
-        }
+    const response = await this.chat.fetch("/api/widget/conversations", {
+      method: "GET",
+      query: {
+        teamId,
+        limit: params?.limit?.toString(),
+        cursor: params?.cursor
       }
-    );
-    return response.data;
+    });
+    return {
+      tickets: response.data.tickets ?? response.data.conversations ?? [],
+      cursor: response.data.cursor,
+      hasMore: response.data.hasMore
+    };
   }
-  /** Create a new conversation (ticket). */
+  /** Create a new ticket. */
   async create(params) {
     const teamId = this.chat.getTeamId();
     if (!teamId) throw new Error("Not identified. Call chat.identify() first.");
@@ -669,7 +668,7 @@ var MessagesApi = class {
   constructor(chat) {
     this.chat = chat;
   }
-  /** List messages for a conversation. */
+  /** List messages for a ticket. */
   async list(ticketId) {
     const teamId = this.chat.getTeamId();
     const response = await this.chat.fetch(
@@ -684,7 +683,7 @@ var MessagesApi = class {
     );
     return response.data.messages;
   }
-  /** Send a message to a conversation. */
+  /** Send a message to a ticket. */
   async send(ticketId, content) {
     const teamId = this.chat.getTeamId();
     const response = await this.chat.fetch(

package/dist/chat/index.d.cts

@@ -4,11 +4,12 @@ interface ChatConfig {
     teamSlug: string;
     /** Override the base URL (defaults to https://www.cstar.help). */
     baseUrl?: string;
-    /** Supabase project URL for realtime subscriptions (optional). */
-    supabaseUrl?: string;
-    /** Supabase anon key for realtime subscriptions (optional). */
-    supabaseAnonKey?: string;
-    /** Polling interval in ms when Supabase Realtime is not available (defaults to 3000). */
+    /**
+     * Enable real-time messages and typing indicators. Defaults to true.
+     * When false, the SDK falls back to polling.
+     */
+    realtime?: boolean;
+    /** Polling interval in ms when realtime is disabled or unavailable (defaults to 3000). */
     pollingInterval?: number;
 }
 /** Parameters for identifying a customer via HMAC signature verification. */
@@ -43,14 +44,16 @@ interface IdentifyResult {
     /** Team UUID — used for realtime token requests. */
     teamId: string;
 }
-/** Response from the realtime-token endpoint. */
+/** @internal Response from the realtime-token endpoint. */
 interface RealtimeTokenResponse {
     token: string;
     expiresAt: string;
     refreshAt: string;
+    realtimeUrl: string;
+    realtimeKey: string;
 }
-/** A customer conversation (maps to a ticket). */
-interface Conversation {
+/** A ticket — a customer's support thread. */
+interface Ticket {
     id: string;
     ticketNumber: string;
     subject: string;
@@ -60,14 +63,14 @@ interface Conversation {
     updatedAt: string;
     closedAt: string | null;
 }
-/** Paginated conversation list response. */
-interface ConversationListResponse {
-    conversations: Conversation[];
+/** Paginated ticket list response. */
+interface TicketListResponse {
+    tickets: Ticket[];
     cursor: string | null;
     hasMore: boolean;
 }
-/** A message in a conversation. */
-interface WidgetMessage {
+/** A message on a ticket. */
+interface Message {
     id: string;
     content: string;
     sender: 'customer' | 'agent';
@@ -75,25 +78,30 @@ interface WidgetMessage {
     created_at: string;
     read_at: string | null;
     attachments: unknown[];
+    /** Raw AI SDK response payload for agent messages. Widgets can use this
+     * with `extractToolCallsFromPayload` to render customer-safe tool chips. */
+    payload?: Record<string, unknown> | null;
+    /** Whether this message was sent by an AI agent. */
+    is_bot?: boolean;
 }
-/** Parameters for listing conversations. */
-interface ConversationListParams {
+/** Parameters for listing tickets. */
+interface TicketListParams {
     limit?: number;
     cursor?: string;
 }
-/** Parameters for creating a new conversation. */
-interface ConversationCreateParams {
+/** Parameters for creating a new ticket. */
+interface TicketCreateParams {
     subject: string;
     message?: string;
 }
-/** Typing indicator payload from realtime subscription. */
+/** Typing indicator payload. */
 interface TypingPayload {
     agent_id: string;
     agent_name: string;
     is_typing: boolean;
 }
 /** Callback for message events. */
-type MessageCallback = (message: WidgetMessage) => void;
+type MessageCallback = (message: Message) => void;
 /** Callback for typing indicator events. */
 type TypingCallback = (payload: TypingPayload) => void;
 
@@ -183,16 +191,13 @@ interface CommunityFollowResult {
 /**
  * Customer-facing chat client for the cStar widget API.
  *
- * Supports real-time messages and typing indicators when `supabaseUrl`
- * and `supabaseAnonKey` are provided and `@supabase/supabase-js` is installed.
- * Falls back to polling otherwise.
+ * Real-time messages and typing indicators are enabled by default and
+ * fall back to polling automatically. No additional configuration is
+ * required — everything the SDK needs is fetched from the cStar API
+ * after `identify()`.
  *
  * ```typescript
- * const chat = new ChatClient({
- *   teamSlug: 'acme',
- *   supabaseUrl: 'https://xxx.supabase.co',
- *   supabaseAnonKey: 'eyJ...',
- * });
+ * const chat = new ChatClient({ teamSlug: 'acme' });
  * await chat.identify(
  *   { externalId: 'usr_123', email: 'jane@co.com', name: 'Jane', timestamp: Date.now() / 1000 },
  *   'hmac_signature_hex'
@@ -205,8 +210,7 @@ declare class ChatClient {
     private readonly baseUrl;
     private readonly teamSlug;
     private readonly pollingInterval;
-    private readonly supabaseUrl?;
-    private readonly supabaseAnonKey?;
+    private readonly realtimeEnabled;
     private sessionToken;
     private teamId;
     private customerId;
@@ -215,8 +219,8 @@ declare class ChatClient {
     private presenceManager;
     private realtimeReady;
     private realtimeInitPromise;
-    /** Sub-resource for managing conversations. */
-    readonly conversations: ConversationsApi;
+    /** Sub-resource for managing tickets. */
+    readonly tickets: TicketsApi;
     /** Sub-resource for managing messages. */
     readonly messages: MessagesApi;
     /** Sub-resource for community actions (create posts, vote, comment). Uses the same session as chat. */
@@ -224,10 +228,10 @@ declare class ChatClient {
     constructor(config: ChatConfig);
     /**
      * Identify a customer using HMAC signature verification.
-     * Must be called before accessing conversations or messages.
+     * Must be called before accessing tickets or messages.
      *
-     * If `supabaseUrl` and `supabaseAnonKey` were provided in the config,
-     * this will also initialize real-time subscriptions (non-blocking).
+     * Real-time subscriptions are initialized automatically (non-blocking)
+     * unless `realtime: false` was passed in config.
      *
      * @param customer - Customer identity fields
      * @param signature - HMAC-SHA256 hex signature of the signed fields
@@ -235,22 +239,22 @@ declare class ChatClient {
      */
     identify(customer: IdentifyParams, signature: string, testMode?: boolean): Promise<IdentifyResult>;
     /**
-     * Subscribe to new messages on a conversation.
-     * Uses Supabase Realtime (Postgres Changes) when available, falls back to polling.
+     * Subscribe to new messages on a ticket.
+     * Uses real-time delivery when available, falls back to polling.
      *
      * @returns Unsubscribe function
      */
     onMessage(ticketId: string, callback: MessageCallback): () => void;
     /**
      * Subscribe to typing indicator events.
-     * Requires Supabase Realtime — returns a no-op if unavailable.
+     * Requires real-time — returns a no-op when unavailable.
      *
      * @returns Unsubscribe function
      */
     onTyping(ticketId: string, callback: TypingCallback): () => void;
     /**
-     * Send a customer typing indicator (requires realtime).
-     * No-op if realtime is not available.
+     * Send a customer typing indicator (requires real-time).
+     * No-op when real-time is unavailable.
      */
     sendTyping(ticketId: string, isTyping: boolean): Promise<void>;
     /** Disconnect all subscriptions and clean up. */
@@ -272,14 +276,14 @@ declare class ChatClient {
     private pollMessages;
     private buildUrl;
 }
-/** Conversations sub-resource on ChatClient. */
-declare class ConversationsApi {
+/** Tickets sub-resource on ChatClient. */
+declare class TicketsApi {
     private readonly chat;
     constructor(chat: ChatClient);
-    /** List conversations for the identified customer. */
-    list(params?: ConversationListParams): Promise<ConversationListResponse>;
-    /** Create a new conversation (ticket). */
-    create(params: ConversationCreateParams): Promise<Conversation>;
+    /** List tickets for the identified customer. */
+    list(params?: TicketListParams): Promise<TicketListResponse>;
+    /** Create a new ticket. */
+    create(params: TicketCreateParams): Promise<Ticket>;
 }
 /**
  * Community sub-resource on ChatClient.
@@ -313,10 +317,10 @@ declare class ChatCommunityApi {
 declare class MessagesApi {
     private readonly chat;
     constructor(chat: ChatClient);
-    /** List messages for a conversation. */
-    list(ticketId: string): Promise<WidgetMessage[]>;
-    /** Send a message to a conversation. */
-    send(ticketId: string, content: string): Promise<WidgetMessage>;
+    /** List messages for a ticket. */
+    list(ticketId: string): Promise<Message[]>;
+    /** Send a message to a ticket. */
+    send(ticketId: string, content: string): Promise<Message>;
 }
 
-export { ChatClient, type ChatConfig, type Conversation, type ConversationCreateParams, type ConversationListParams, type ConversationListResponse, type IdentifyParams, type IdentifyResult, type MessageCallback, type RealtimeTokenResponse, type TypingCallback, type TypingPayload, type WidgetMessage };
+export { ChatClient, type ChatConfig, type IdentifyParams, type IdentifyResult, type Message, type MessageCallback, type RealtimeTokenResponse, type Ticket, type TicketCreateParams, type TicketListParams, type TicketListResponse, type TypingCallback, type TypingPayload };

package/dist/chat/index.d.ts

@@ -4,11 +4,12 @@ interface ChatConfig {
     teamSlug: string;
     /** Override the base URL (defaults to https://www.cstar.help). */
     baseUrl?: string;
-    /** Supabase project URL for realtime subscriptions (optional). */
-    supabaseUrl?: string;
-    /** Supabase anon key for realtime subscriptions (optional). */
-    supabaseAnonKey?: string;
-    /** Polling interval in ms when Supabase Realtime is not available (defaults to 3000). */
+    /**
+     * Enable real-time messages and typing indicators. Defaults to true.
+     * When false, the SDK falls back to polling.
+     */
+    realtime?: boolean;
+    /** Polling interval in ms when realtime is disabled or unavailable (defaults to 3000). */
     pollingInterval?: number;
 }
 /** Parameters for identifying a customer via HMAC signature verification. */
@@ -43,14 +44,16 @@ interface IdentifyResult {
     /** Team UUID — used for realtime token requests. */
     teamId: string;
 }
-/** Response from the realtime-token endpoint. */
+/** @internal Response from the realtime-token endpoint. */
 interface RealtimeTokenResponse {
     token: string;
     expiresAt: string;
     refreshAt: string;
+    realtimeUrl: string;
+    realtimeKey: string;
 }
-/** A customer conversation (maps to a ticket). */
-interface Conversation {
+/** A ticket — a customer's support thread. */
+interface Ticket {
     id: string;
     ticketNumber: string;
     subject: string;
@@ -60,14 +63,14 @@ interface Conversation {
     updatedAt: string;
     closedAt: string | null;
 }
-/** Paginated conversation list response. */
-interface ConversationListResponse {
-    conversations: Conversation[];
+/** Paginated ticket list response. */
+interface TicketListResponse {
+    tickets: Ticket[];
     cursor: string | null;
     hasMore: boolean;
 }
-/** A message in a conversation. */
-interface WidgetMessage {
+/** A message on a ticket. */
+interface Message {
     id: string;
     content: string;
     sender: 'customer' | 'agent';
@@ -75,25 +78,30 @@ interface WidgetMessage {
     created_at: string;
     read_at: string | null;
     attachments: unknown[];
+    /** Raw AI SDK response payload for agent messages. Widgets can use this
+     * with `extractToolCallsFromPayload` to render customer-safe tool chips. */
+    payload?: Record<string, unknown> | null;
+    /** Whether this message was sent by an AI agent. */
+    is_bot?: boolean;
 }
-/** Parameters for listing conversations. */
-interface ConversationListParams {
+/** Parameters for listing tickets. */
+interface TicketListParams {
     limit?: number;
     cursor?: string;
 }
-/** Parameters for creating a new conversation. */
-interface ConversationCreateParams {
+/** Parameters for creating a new ticket. */
+interface TicketCreateParams {
     subject: string;
     message?: string;
 }
-/** Typing indicator payload from realtime subscription. */
+/** Typing indicator payload. */
 interface TypingPayload {
     agent_id: string;
     agent_name: string;
     is_typing: boolean;
 }
 /** Callback for message events. */
-type MessageCallback = (message: WidgetMessage) => void;
+type MessageCallback = (message: Message) => void;
 /** Callback for typing indicator events. */
 type TypingCallback = (payload: TypingPayload) => void;
 
@@ -183,16 +191,13 @@ interface CommunityFollowResult {
 /**
  * Customer-facing chat client for the cStar widget API.
  *
- * Supports real-time messages and typing indicators when `supabaseUrl`
- * and `supabaseAnonKey` are provided and `@supabase/supabase-js` is installed.
- * Falls back to polling otherwise.
+ * Real-time messages and typing indicators are enabled by default and
+ * fall back to polling automatically. No additional configuration is
+ * required — everything the SDK needs is fetched from the cStar API
+ * after `identify()`.
  *
  * ```typescript
- * const chat = new ChatClient({
- *   teamSlug: 'acme',
- *   supabaseUrl: 'https://xxx.supabase.co',
- *   supabaseAnonKey: 'eyJ...',
- * });
+ * const chat = new ChatClient({ teamSlug: 'acme' });
  * await chat.identify(
  *   { externalId: 'usr_123', email: 'jane@co.com', name: 'Jane', timestamp: Date.now() / 1000 },
  *   'hmac_signature_hex'
@@ -205,8 +210,7 @@ declare class ChatClient {
     private readonly baseUrl;
     private readonly teamSlug;
     private readonly pollingInterval;
-    private readonly supabaseUrl?;
-    private readonly supabaseAnonKey?;
+    private readonly realtimeEnabled;
     private sessionToken;
     private teamId;
     private customerId;
@@ -215,8 +219,8 @@ declare class ChatClient {
     private presenceManager;
     private realtimeReady;
     private realtimeInitPromise;
-    /** Sub-resource for managing conversations. */
-    readonly conversations: ConversationsApi;
+    /** Sub-resource for managing tickets. */
+    readonly tickets: TicketsApi;
     /** Sub-resource for managing messages. */
     readonly messages: MessagesApi;
     /** Sub-resource for community actions (create posts, vote, comment). Uses the same session as chat. */
@@ -224,10 +228,10 @@ declare class ChatClient {
     constructor(config: ChatConfig);
     /**
      * Identify a customer using HMAC signature verification.
-     * Must be called before accessing conversations or messages.
+     * Must be called before accessing tickets or messages.
      *
-     * If `supabaseUrl` and `supabaseAnonKey` were provided in the config,
-     * this will also initialize real-time subscriptions (non-blocking).
+     * Real-time subscriptions are initialized automatically (non-blocking)
+     * unless `realtime: false` was passed in config.
      *
      * @param customer - Customer identity fields
      * @param signature - HMAC-SHA256 hex signature of the signed fields
@@ -235,22 +239,22 @@ declare class ChatClient {
      */
     identify(customer: IdentifyParams, signature: string, testMode?: boolean): Promise<IdentifyResult>;
     /**
-     * Subscribe to new messages on a conversation.
-     * Uses Supabase Realtime (Postgres Changes) when available, falls back to polling.
+     * Subscribe to new messages on a ticket.
+     * Uses real-time delivery when available, falls back to polling.
      *
      * @returns Unsubscribe function
      */
     onMessage(ticketId: string, callback: MessageCallback): () => void;
     /**
      * Subscribe to typing indicator events.
-     * Requires Supabase Realtime — returns a no-op if unavailable.
+     * Requires real-time — returns a no-op when unavailable.
      *
      * @returns Unsubscribe function
      */
     onTyping(ticketId: string, callback: TypingCallback): () => void;
     /**
-     * Send a customer typing indicator (requires realtime).
-     * No-op if realtime is not available.
+     * Send a customer typing indicator (requires real-time).
+     * No-op when real-time is unavailable.
      */
     sendTyping(ticketId: string, isTyping: boolean): Promise<void>;
     /** Disconnect all subscriptions and clean up. */
@@ -272,14 +276,14 @@ declare class ChatClient {
     private pollMessages;
     private buildUrl;
 }
-/** Conversations sub-resource on ChatClient. */
-declare class ConversationsApi {
+/** Tickets sub-resource on ChatClient. */
+declare class TicketsApi {
     private readonly chat;
     constructor(chat: ChatClient);
-    /** List conversations for the identified customer. */
-    list(params?: ConversationListParams): Promise<ConversationListResponse>;
-    /** Create a new conversation (ticket). */
-    create(params: ConversationCreateParams): Promise<Conversation>;
+    /** List tickets for the identified customer. */
+    list(params?: TicketListParams): Promise<TicketListResponse>;
+    /** Create a new ticket. */
+    create(params: TicketCreateParams): Promise<Ticket>;
 }
 /**
  * Community sub-resource on ChatClient.
@@ -313,10 +317,10 @@ declare class ChatCommunityApi {
 declare class MessagesApi {
     private readonly chat;
     constructor(chat: ChatClient);
-    /** List messages for a conversation. */
-    list(ticketId: string): Promise<WidgetMessage[]>;
-    /** Send a message to a conversation. */
-    send(ticketId: string, content: string): Promise<WidgetMessage>;
+    /** List messages for a ticket. */
+    list(ticketId: string): Promise<Message[]>;
+    /** Send a message to a ticket. */
+    send(ticketId: string, content: string): Promise<Message>;
 }
 
-export { ChatClient, type ChatConfig, type Conversation, type ConversationCreateParams, type ConversationListParams, type ConversationListResponse, type IdentifyParams, type IdentifyResult, type MessageCallback, type RealtimeTokenResponse, type TypingCallback, type TypingPayload, type WidgetMessage };
+export { ChatClient, type ChatConfig, type IdentifyParams, type IdentifyResult, type Message, type MessageCallback, type RealtimeTokenResponse, type Ticket, type TicketCreateParams, type TicketListParams, type TicketListResponse, type TypingCallback, type TypingPayload };

package/dist/chat/index.js

@@ -9,8 +9,8 @@ var RealtimeManager = class {
     this.options = options;
   }
   /**
-   * Initialize the Supabase client and authenticate with a realtime token.
-   * Returns true if successful, false if @supabase/supabase-js is unavailable.
+   * Initialize the realtime client and authenticate with a token.
+   * Returns true if successful, false if the realtime runtime is unavailable.
    */
   init() {
     if (this.initPromise) return this.initPromise;
@@ -19,15 +19,15 @@ var RealtimeManager = class {
   }
   async doInit() {
     try {
+      const tokenData = await this.options.fetchToken();
       const { createClient } = await import(
         /* webpackIgnore: true */
         "@supabase/supabase-js"
       );
-      this.client = createClient(this.options.supabaseUrl, this.options.supabaseAnonKey, {
+      this.client = createClient(tokenData.realtimeUrl, tokenData.realtimeKey, {
         auth: { persistSession: false, autoRefreshToken: false },
         realtime: { params: { eventsPerSecond: 10 } }
       });
-      const tokenData = await this.options.fetchToken();
       this.setToken(tokenData);
       return true;
     } catch {
@@ -85,7 +85,8 @@ var RealtimeManager = class {
           sender_name: row.sender_name ?? "",
           created_at: row.created_at,
           read_at: row.read_at ?? null,
-          attachments: row.attachments ?? []
+          attachments: row.attachments ?? [],
+          payload: row.payload ?? null
         };
         callback(message);
       }
@@ -93,7 +94,7 @@ var RealtimeManager = class {
     this.channels.set(channelName, channel);
     return () => this.removeChannel(channelName);
   }
-  /** Get the underlying Supabase client (for sharing with PresenceManager). */
+  /** Get the underlying realtime client (for sharing with PresenceManager). */
   getClient() {
     return this.client;
   }
@@ -135,7 +136,7 @@ var PresenceManager = class {
     this.typingClearTimers = /* @__PURE__ */ new Map();
     this.options = options;
   }
-  /** Set the Supabase client (shared from RealtimeManager). */
+  /** Set the realtime client (shared from RealtimeManager). */
   setClient(client) {
     this.client = client;
   }
@@ -254,18 +255,17 @@ var ChatClient = class {
     this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
     this.teamSlug = config.teamSlug;
     this.pollingInterval = config.pollingInterval ?? DEFAULT_POLLING_INTERVAL;
-    this.supabaseUrl = config.supabaseUrl;
-    this.supabaseAnonKey = config.supabaseAnonKey;
-    this.conversations = new ConversationsApi(this);
+    this.realtimeEnabled = config.realtime !== false;
+    this.tickets = new TicketsApi(this);
     this.messages = new MessagesApi(this);
     this.community = new ChatCommunityApi(this);
   }
   /**
    * Identify a customer using HMAC signature verification.
-   * Must be called before accessing conversations or messages.
+   * Must be called before accessing tickets or messages.
    *
-   * If `supabaseUrl` and `supabaseAnonKey` were provided in the config,
-   * this will also initialize real-time subscriptions (non-blocking).
+   * Real-time subscriptions are initialized automatically (non-blocking)
+   * unless `realtime: false` was passed in config.
    *
    * @param customer - Customer identity fields
    * @param signature - HMAC-SHA256 hex signature of the signed fields
@@ -287,7 +287,7 @@ var ChatClient = class {
     this.sessionToken = response.data.sessionToken;
     this.teamId = response.data.teamId;
     this.customerId = response.data.customer.id;
-    if (this.supabaseUrl && this.supabaseAnonKey) {
+    if (this.realtimeEnabled) {
       this.realtimeInitPromise = this.initRealtime(
         response.data.customer.id,
         response.data.customer.name || customer.name || customer.email
@@ -296,8 +296,8 @@ var ChatClient = class {
     return response.data;
   }
   /**
-   * Subscribe to new messages on a conversation.
-   * Uses Supabase Realtime (Postgres Changes) when available, falls back to polling.
+   * Subscribe to new messages on a ticket.
+   * Uses real-time delivery when available, falls back to polling.
    *
    * @returns Unsubscribe function
    */
@@ -309,7 +309,7 @@ var ChatClient = class {
   }
   /**
    * Subscribe to typing indicator events.
-   * Requires Supabase Realtime — returns a no-op if unavailable.
+   * Requires real-time — returns a no-op when unavailable.
    *
    * @returns Unsubscribe function
    */
@@ -321,8 +321,8 @@ var ChatClient = class {
     };
   }
   /**
-   * Send a customer typing indicator (requires realtime).
-   * No-op if realtime is not available.
+   * Send a customer typing indicator (requires real-time).
+   * No-op when real-time is unavailable.
    */
   async sendTyping(ticketId, isTyping) {
     if (this.presenceManager) {
@@ -386,8 +386,6 @@ var ChatClient = class {
   async initRealtime(customerId, customerName) {
     try {
       this.realtimeManager = new RealtimeManager({
-        supabaseUrl: this.supabaseUrl,
-        supabaseAnonKey: this.supabaseAnonKey,
         fetchToken: () => this.fetchRealtimeToken()
       });
       const ready = await this.realtimeManager.init();
@@ -454,28 +452,29 @@ var ChatClient = class {
     return qs ? `${base}?${qs}` : base;
   }
 };
-var ConversationsApi = class {
+var TicketsApi = class {
   constructor(chat) {
     this.chat = chat;
   }
-  /** List conversations for the identified customer. */
+  /** List tickets for the identified customer. */
   async list(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/conversations",
-      {
-        method: "GET",
-        query: {
-          teamId,
-          limit: params?.limit?.toString(),
-          cursor: params?.cursor
-        }
+    const response = await this.chat.fetch("/api/widget/conversations", {
+      method: "GET",
+      query: {
+        teamId,
+        limit: params?.limit?.toString(),
+        cursor: params?.cursor
       }
-    );
-    return response.data;
+    });
+    return {
+      tickets: response.data.tickets ?? response.data.conversations ?? [],
+      cursor: response.data.cursor,
+      hasMore: response.data.hasMore
+    };
   }
-  /** Create a new conversation (ticket). */
+  /** Create a new ticket. */
   async create(params) {
     const teamId = this.chat.getTeamId();
     if (!teamId) throw new Error("Not identified. Call chat.identify() first.");
@@ -633,7 +632,7 @@ var MessagesApi = class {
   constructor(chat) {
     this.chat = chat;
   }
-  /** List messages for a conversation. */
+  /** List messages for a ticket. */
   async list(ticketId) {
     const teamId = this.chat.getTeamId();
     const response = await this.chat.fetch(
@@ -648,7 +647,7 @@ var MessagesApi = class {
     );
     return response.data.messages;
   }
-  /** Send a message to a conversation. */
+  /** Send a message to a ticket. */
   async send(ticketId, content) {
     const teamId = this.chat.getTeamId();
     const response = await this.chat.fetch(

package/dist/index.cjs

@@ -140,6 +140,16 @@ var DEFAULT_MAX_RETRIES = 3;
 var DEFAULT_TIMEOUT = 3e4;
 var HttpClient = class {
   constructor(config) {
+    if (!config || typeof config.apiKey !== "string" || config.apiKey.length === 0) {
+      throw new Error(
+        "[cStar] CStarClient: apiKey is required. Pass a secret key (sk_live_... / sk_test_...) or a publishable key (pk_live_... / pk_test_...). See https://cstar.help/developers/quickstart"
+      );
+    }
+    if (typeof config.teamId !== "string" || config.teamId.length === 0) {
+      throw new Error(
+        "[cStar] CStarClient: teamId is required. Find your team ID in Settings \u2192 General or via `cstar status`."
+      );
+    }
     this.config = {
       apiKey: config.apiKey,
       teamId: config.teamId,
@@ -1956,10 +1966,12 @@ var GameResource = class {
   subscribeLeaderboard(realtime, params) {
     const fetchFn = async () => {
       const res = await this.leaderboard(params);
+      const envelope = res.data;
+      const entries = Array.isArray(envelope) ? envelope : envelope?.entries ?? [];
       return {
         success: true,
-        data: res.data,
-        pagination: { total: res.data.length, page: 1, pageSize: 100, hasMore: false },
+        data: entries,
+        pagination: { total: entries.length, page: 1, pageSize: 100, hasMore: false },
         meta: { requestId: "", timestamp: (/* @__PURE__ */ new Date()).toISOString() }
       };
     };

package/dist/index.js

@@ -102,6 +102,16 @@ var DEFAULT_MAX_RETRIES = 3;
 var DEFAULT_TIMEOUT = 3e4;
 var HttpClient = class {
   constructor(config) {
+    if (!config || typeof config.apiKey !== "string" || config.apiKey.length === 0) {
+      throw new Error(
+        "[cStar] CStarClient: apiKey is required. Pass a secret key (sk_live_... / sk_test_...) or a publishable key (pk_live_... / pk_test_...). See https://cstar.help/developers/quickstart"
+      );
+    }
+    if (typeof config.teamId !== "string" || config.teamId.length === 0) {
+      throw new Error(
+        "[cStar] CStarClient: teamId is required. Find your team ID in Settings \u2192 General or via `cstar status`."
+      );
+    }
     this.config = {
       apiKey: config.apiKey,
       teamId: config.teamId,
@@ -1918,10 +1928,12 @@ var GameResource = class {
   subscribeLeaderboard(realtime, params) {
     const fetchFn = async () => {
       const res = await this.leaderboard(params);
+      const envelope = res.data;
+      const entries = Array.isArray(envelope) ? envelope : envelope?.entries ?? [];
       return {
         success: true,
-        data: res.data,
-        pagination: { total: res.data.length, page: 1, pageSize: 100, hasMore: false },
+        data: entries,
+        pagination: { total: entries.length, page: 1, pageSize: 100, hasMore: false },
         meta: { requestId: "", timestamp: (/* @__PURE__ */ new Date()).toISOString() }
       };
     };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@cstar.help/js",
-	"version": "0.10.3",
+	"version": "0.11.0",
 	"description": "Official TypeScript SDK for the cStar customer support platform",
 	"type": "module",
 	"main": "./dist/index.cjs",
@@ -108,13 +108,8 @@
 	"engines": {
 		"node": ">=18.0.0"
 	},
-	"peerDependencies": {
-		"@supabase/supabase-js": ">=2.0.0"
-	},
-	"peerDependenciesMeta": {
-		"@supabase/supabase-js": {
-			"optional": true
-		}
+	"dependencies": {
+		"@supabase/supabase-js": "^2.0.0"
 	},
 	"devDependencies": {
 		"tsup": "^8.0.0",