@cstar.help/js 0.12.0 → 0.13.0

package/dist/chat/index.cjs

@@ -289,37 +289,45 @@ var PresenceManager = class {
 };
 
 // src/chat/errors.ts
+function normalizeChatArgs(arg, fallbackCode) {
+  if (typeof arg === "string") {
+    return { message: arg, code: fallbackCode, statusCode: 0, requestId: null };
+  }
+  return { ...arg, code: arg.code ?? fallbackCode };
+}
 var ChatClientError = class extends Error {
-  constructor(message, opts) {
-    super(message);
+  constructor(arg) {
+    const opts = normalizeChatArgs(arg, "UNKNOWN");
+    super(opts.message);
     this.name = "ChatClientError";
     this.code = opts.code ?? "UNKNOWN";
-    this.statusCode = opts.statusCode;
+    this.statusCode = opts.statusCode ?? 0;
     this.requestId = opts.requestId ?? null;
   }
 };
 var ChatClientAuthError = class extends ChatClientError {
-  constructor(opts) {
-    super(opts.message, opts);
+  constructor(arg) {
+    super(normalizeChatArgs(arg, "AUTH_ERROR"));
     this.name = "ChatClientAuthError";
   }
 };
 var ChatClientRateLimitError = class extends ChatClientError {
-  constructor(opts) {
-    super(opts.message, opts);
+  constructor(arg) {
+    const opts = typeof arg === "string" ? { message: arg, code: "RATE_LIMIT", statusCode: 429, requestId: null, retryAfter: null } : { ...arg, code: arg.code ?? "RATE_LIMIT" };
+    super(opts);
     this.name = "ChatClientRateLimitError";
     this.retryAfter = opts.retryAfter ?? null;
   }
 };
 var ChatClientServerError = class extends ChatClientError {
-  constructor(opts) {
-    super(opts.message, opts);
+  constructor(arg) {
+    super(normalizeChatArgs(arg, "SERVER_ERROR"));
     this.name = "ChatClientServerError";
   }
 };
 var ChatClientNetworkError = class extends ChatClientError {
   constructor(opts) {
-    super(opts.message, { code: "NETWORK_ERROR", statusCode: 0, requestId: null });
+    super({ message: opts.message, code: "NETWORK_ERROR", statusCode: 0, requestId: null });
     this.name = "ChatClientNetworkError";
     this.originalError = opts.originalError;
   }
@@ -374,6 +382,7 @@ var ChatClient = class {
     this.sessionToken = response.data.sessionToken;
     this.teamId = response.data.teamId;
     this.customerId = response.data.customer.id;
+    this.authMode = "hmac";
     if (this.realtimeEnabled) {
       this.realtimeInitPromise = this.initRealtime(
         response.data.customer.id,
@@ -571,7 +580,8 @@ var ChatClient = class {
           requestId
         });
       }
-      throw new ChatClientError(message, {
+      throw new ChatClientError({
+        message,
         code,
         statusCode: response.status,
         requestId
@@ -709,7 +719,7 @@ var TicketsApi = class {
   /** 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.");
+    if (!teamId) throw new ChatClientAuthError("Not identified. Call chat.identify() first.");
     const response = await this.chat.fetch("/api/widget/conversations", {
       method: "GET",
       query: {
@@ -727,7 +737,7 @@ var TicketsApi = class {
   /** Create a new ticket. */
   async create(params) {
     const teamId = this.chat.getTeamId();
-    if (!teamId) throw new Error("Not identified. Call chat.identify() first.");
+    if (!teamId) throw new ChatClientAuthError("Not identified. Call chat.identify() first.");
     const response = await this.chat.fetch("/api/widget/tickets", {
       method: "POST",
       body: {
@@ -736,15 +746,25 @@ var TicketsApi = class {
         message: params.message
       }
     });
+    const messages = (response.data.messages ?? []).map((m) => ({
+      id: m.id,
+      content: m.content,
+      sender: m.sender,
+      sender_name: m.sender_name,
+      created_at: m.created_at,
+      read_at: m.read_at,
+      attachments: m.attachments ?? []
+    }));
     return {
       id: response.data.id,
-      ticketNumber: "",
+      ticketNumber: null,
       subject: response.data.subject,
       status: response.data.status,
-      messageCount: params.message ? 1 : 0,
+      messageCount: messages.length,
       createdAt: (/* @__PURE__ */ new Date()).toISOString(),
       updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
-      closedAt: null
+      closedAt: null,
+      messages
     };
   }
 };
@@ -755,7 +775,7 @@ var ChatCommunityApi = class {
   /** 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.");
+    if (!teamId) throw new ChatClientAuthError("Not identified. Call chat.identify() first.");
     const response = await this.chat.fetch("/api/widget/community", {
       method: "POST",
       body: {
@@ -772,7 +792,7 @@ var ChatCommunityApi = class {
   /** Update a post. Only the original author can edit. */
   async updatePost(postId, params) {
     const teamId = this.chat.getTeamId();
-    if (!teamId) throw new Error("Not identified. Call chat.identify() first.");
+    if (!teamId) throw new ChatClientAuthError("Not identified. Call chat.identify() first.");
     const response = await this.chat.fetch("/api/widget/community", {
       method: "POST",
       body: {
@@ -789,7 +809,7 @@ var ChatCommunityApi = class {
   /** Delete a post (soft delete). Only the original author can delete. */
   async deletePost(postId) {
     const teamId = this.chat.getTeamId();
-    if (!teamId) throw new Error("Not identified. Call chat.identify() first.");
+    if (!teamId) throw new ChatClientAuthError("Not identified. Call chat.identify() first.");
     await this.chat.fetch("/api/widget/community", {
       method: "POST",
       body: { teamId, action: "deletePost", postId }
@@ -798,7 +818,7 @@ var ChatCommunityApi = class {
   /** Update a comment. Only the original author can edit. */
   async updateComment(postId, commentId, params) {
     const teamId = this.chat.getTeamId();
-    if (!teamId) throw new Error("Not identified. Call chat.identify() first.");
+    if (!teamId) throw new ChatClientAuthError("Not identified. Call chat.identify() first.");
     const response = await this.chat.fetch("/api/widget/community", {
       method: "POST",
       body: {
@@ -814,7 +834,7 @@ var ChatCommunityApi = class {
   /** Delete a comment (soft delete). Only the original author can delete. */
   async deleteComment(postId, commentId) {
     const teamId = this.chat.getTeamId();
-    if (!teamId) throw new Error("Not identified. Call chat.identify() first.");
+    if (!teamId) throw new ChatClientAuthError("Not identified. Call chat.identify() first.");
     await this.chat.fetch("/api/widget/community", {
       method: "POST",
       body: { teamId, action: "deleteComment", postId, commentId }
@@ -823,7 +843,7 @@ var ChatCommunityApi = class {
   /** 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.");
+    if (!teamId) throw new ChatClientAuthError("Not identified. Call chat.identify() first.");
     const response = await this.chat.fetch("/api/widget/community", {
       method: "POST",
       body: { teamId, action: "vote", postId }
@@ -833,7 +853,7 @@ var ChatCommunityApi = class {
   /** 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.");
+    if (!teamId) throw new ChatClientAuthError("Not identified. Call chat.identify() first.");
     const response = await this.chat.fetch("/api/widget/community", {
       method: "POST",
       body: {
@@ -849,7 +869,7 @@ var ChatCommunityApi = class {
   /** Toggle follow on a post. */
   async follow(postId) {
     const teamId = this.chat.getTeamId();
-    if (!teamId) throw new Error("Not identified. Call chat.identify() first.");
+    if (!teamId) throw new ChatClientAuthError("Not identified. Call chat.identify() first.");
     const response = await this.chat.fetch("/api/widget/community", {
       method: "POST",
       body: { teamId, action: "follow", postId }
@@ -859,7 +879,7 @@ var ChatCommunityApi = class {
   /** 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.");
+    if (!teamId) throw new ChatClientAuthError("Not identified. Call chat.identify() first.");
     const response = await this.chat.fetch("/api/widget/community", {
       method: "GET",
       query: { teamId, postId }
@@ -870,7 +890,7 @@ var ChatCommunityApi = class {
   async bulkVoteStatus(postIds) {
     if (postIds.length === 0) return {};
     const teamId = this.chat.getTeamId();
-    if (!teamId) throw new Error("Not identified. Call chat.identify() first.");
+    if (!teamId) throw new ChatClientAuthError("Not identified. Call chat.identify() first.");
     const response = await this.chat.fetch("/api/widget/community", {
       method: "GET",
       query: { teamId, postIds: postIds.join(",") }

package/dist/chat/index.d.cts

@@ -88,13 +88,24 @@ interface RealtimeTokenResponse {
 /** A ticket — a customer's support thread. */
 interface Ticket {
     id: string;
-    ticketNumber: string;
+    /**
+     * Server-issued display ID (e.g. `CST-1024`). `null` immediately after
+     * `tickets.create` (the prefix is assigned asynchronously); populated on
+     * subsequent `tickets.list` / single fetches.
+     */
+    ticketNumber: string | null;
     subject: string;
     status: string;
     messageCount: number;
     createdAt: string;
     updatedAt: string;
     closedAt: string | null;
+    /**
+     * Set on `tickets.create` responses — contains the first message the
+     * widget sent, so callers don't need a round-trip `messages.list(...)`
+     * to echo it back. `undefined` on list/get responses.
+     */
+    messages?: Message[];
 }
 /** Paginated ticket list response. */
 interface TicketListResponse {
@@ -244,46 +255,39 @@ interface CommunityFollowResult {
  *   }
  * }
  * ```
+ *
+ * Constructors accept either a full opts object (used by the SDK's HTTP
+ * paths) or a bare message string — handy for SDK precondition checks
+ * (`throw new ChatClientAuthError('Not identified...')`) and tests.
+ * Closes F-032's spirit for the chat-client classes.
  */
+interface ChatErrorOpts {
+    message: string;
+    code?: string;
+    statusCode?: number;
+    requestId?: string | null;
+}
 /** Base class. Thrown by `ChatClient.fetch()` for any non-2xx response. */
 declare class ChatClientError extends Error {
     readonly code: string;
     readonly statusCode: number;
     readonly requestId: string | null;
-    constructor(message: string, opts: {
-        code?: string;
-        statusCode: number;
-        requestId?: string | null;
-    });
+    constructor(arg: ChatErrorOpts | string);
 }
 /** 401 / 403 — auth failed (bad/expired token, wrong team, etc.). */
 declare class ChatClientAuthError extends ChatClientError {
-    constructor(opts: {
-        message: string;
-        code?: string;
-        statusCode: number;
-        requestId?: string | null;
-    });
+    constructor(arg: ChatErrorOpts | string);
 }
 /** 429 — too many requests. Inspect `retryAfter` (seconds) before retrying. */
 declare class ChatClientRateLimitError extends ChatClientError {
     readonly retryAfter: number | null;
-    constructor(opts: {
-        message: string;
-        code?: string;
-        statusCode: number;
-        requestId?: string | null;
+    constructor(arg: (ChatErrorOpts & {
         retryAfter?: number | null;
-    });
+    }) | string);
 }
 /** 5xx — the cStar server hit an internal error. Usually transient. */
 declare class ChatClientServerError extends ChatClientError {
-    constructor(opts: {
-        message: string;
-        code?: string;
-        statusCode: number;
-        requestId?: string | null;
-    });
+    constructor(arg: ChatErrorOpts | string);
 }
 /**
  * `fetch()` itself failed before a response was received — DNS, TLS,

package/dist/chat/index.d.ts

@@ -88,13 +88,24 @@ interface RealtimeTokenResponse {
 /** A ticket — a customer's support thread. */
 interface Ticket {
     id: string;
-    ticketNumber: string;
+    /**
+     * Server-issued display ID (e.g. `CST-1024`). `null` immediately after
+     * `tickets.create` (the prefix is assigned asynchronously); populated on
+     * subsequent `tickets.list` / single fetches.
+     */
+    ticketNumber: string | null;
     subject: string;
     status: string;
     messageCount: number;
     createdAt: string;
     updatedAt: string;
     closedAt: string | null;
+    /**
+     * Set on `tickets.create` responses — contains the first message the
+     * widget sent, so callers don't need a round-trip `messages.list(...)`
+     * to echo it back. `undefined` on list/get responses.
+     */
+    messages?: Message[];
 }
 /** Paginated ticket list response. */
 interface TicketListResponse {
@@ -244,46 +255,39 @@ interface CommunityFollowResult {
  *   }
  * }
  * ```
+ *
+ * Constructors accept either a full opts object (used by the SDK's HTTP
+ * paths) or a bare message string — handy for SDK precondition checks
+ * (`throw new ChatClientAuthError('Not identified...')`) and tests.
+ * Closes F-032's spirit for the chat-client classes.
  */
+interface ChatErrorOpts {
+    message: string;
+    code?: string;
+    statusCode?: number;
+    requestId?: string | null;
+}
 /** Base class. Thrown by `ChatClient.fetch()` for any non-2xx response. */
 declare class ChatClientError extends Error {
     readonly code: string;
     readonly statusCode: number;
     readonly requestId: string | null;
-    constructor(message: string, opts: {
-        code?: string;
-        statusCode: number;
-        requestId?: string | null;
-    });
+    constructor(arg: ChatErrorOpts | string);
 }
 /** 401 / 403 — auth failed (bad/expired token, wrong team, etc.). */
 declare class ChatClientAuthError extends ChatClientError {
-    constructor(opts: {
-        message: string;
-        code?: string;
-        statusCode: number;
-        requestId?: string | null;
-    });
+    constructor(arg: ChatErrorOpts | string);
 }
 /** 429 — too many requests. Inspect `retryAfter` (seconds) before retrying. */
 declare class ChatClientRateLimitError extends ChatClientError {
     readonly retryAfter: number | null;
-    constructor(opts: {
-        message: string;
-        code?: string;
-        statusCode: number;
-        requestId?: string | null;
+    constructor(arg: (ChatErrorOpts & {
         retryAfter?: number | null;
-    });
+    }) | string);
 }
 /** 5xx — the cStar server hit an internal error. Usually transient. */
 declare class ChatClientServerError extends ChatClientError {
-    constructor(opts: {
-        message: string;
-        code?: string;
-        statusCode: number;
-        requestId?: string | null;
-    });
+    constructor(arg: ChatErrorOpts | string);
 }
 /**
  * `fetch()` itself failed before a response was received — DNS, TLS,

package/dist/chat/index.js

@@ -248,37 +248,45 @@ var PresenceManager = class {
 };
 
 // src/chat/errors.ts
+function normalizeChatArgs(arg, fallbackCode) {
+  if (typeof arg === "string") {
+    return { message: arg, code: fallbackCode, statusCode: 0, requestId: null };
+  }
+  return { ...arg, code: arg.code ?? fallbackCode };
+}
 var ChatClientError = class extends Error {
-  constructor(message, opts) {
-    super(message);
+  constructor(arg) {
+    const opts = normalizeChatArgs(arg, "UNKNOWN");
+    super(opts.message);
     this.name = "ChatClientError";
     this.code = opts.code ?? "UNKNOWN";
-    this.statusCode = opts.statusCode;
+    this.statusCode = opts.statusCode ?? 0;
     this.requestId = opts.requestId ?? null;
   }
 };
 var ChatClientAuthError = class extends ChatClientError {
-  constructor(opts) {
-    super(opts.message, opts);
+  constructor(arg) {
+    super(normalizeChatArgs(arg, "AUTH_ERROR"));
     this.name = "ChatClientAuthError";
   }
 };
 var ChatClientRateLimitError = class extends ChatClientError {
-  constructor(opts) {
-    super(opts.message, opts);
+  constructor(arg) {
+    const opts = typeof arg === "string" ? { message: arg, code: "RATE_LIMIT", statusCode: 429, requestId: null, retryAfter: null } : { ...arg, code: arg.code ?? "RATE_LIMIT" };
+    super(opts);
     this.name = "ChatClientRateLimitError";
     this.retryAfter = opts.retryAfter ?? null;
   }
 };
 var ChatClientServerError = class extends ChatClientError {
-  constructor(opts) {
-    super(opts.message, opts);
+  constructor(arg) {
+    super(normalizeChatArgs(arg, "SERVER_ERROR"));
     this.name = "ChatClientServerError";
   }
 };
 var ChatClientNetworkError = class extends ChatClientError {
   constructor(opts) {
-    super(opts.message, { code: "NETWORK_ERROR", statusCode: 0, requestId: null });
+    super({ message: opts.message, code: "NETWORK_ERROR", statusCode: 0, requestId: null });
     this.name = "ChatClientNetworkError";
     this.originalError = opts.originalError;
   }
@@ -333,6 +341,7 @@ var ChatClient = class {
     this.sessionToken = response.data.sessionToken;
     this.teamId = response.data.teamId;
     this.customerId = response.data.customer.id;
+    this.authMode = "hmac";
     if (this.realtimeEnabled) {
       this.realtimeInitPromise = this.initRealtime(
         response.data.customer.id,
@@ -530,7 +539,8 @@ var ChatClient = class {
           requestId
         });
       }
-      throw new ChatClientError(message, {
+      throw new ChatClientError({
+        message,
         code,
         statusCode: response.status,
         requestId
@@ -668,7 +678,7 @@ var TicketsApi = class {
   /** 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.");
+    if (!teamId) throw new ChatClientAuthError("Not identified. Call chat.identify() first.");
     const response = await this.chat.fetch("/api/widget/conversations", {
       method: "GET",
       query: {
@@ -686,7 +696,7 @@ var TicketsApi = class {
   /** Create a new ticket. */
   async create(params) {
     const teamId = this.chat.getTeamId();
-    if (!teamId) throw new Error("Not identified. Call chat.identify() first.");
+    if (!teamId) throw new ChatClientAuthError("Not identified. Call chat.identify() first.");
     const response = await this.chat.fetch("/api/widget/tickets", {
       method: "POST",
       body: {
@@ -695,15 +705,25 @@ var TicketsApi = class {
         message: params.message
       }
     });
+    const messages = (response.data.messages ?? []).map((m) => ({
+      id: m.id,
+      content: m.content,
+      sender: m.sender,
+      sender_name: m.sender_name,
+      created_at: m.created_at,
+      read_at: m.read_at,
+      attachments: m.attachments ?? []
+    }));
     return {
       id: response.data.id,
-      ticketNumber: "",
+      ticketNumber: null,
       subject: response.data.subject,
       status: response.data.status,
-      messageCount: params.message ? 1 : 0,
+      messageCount: messages.length,
       createdAt: (/* @__PURE__ */ new Date()).toISOString(),
       updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
-      closedAt: null
+      closedAt: null,
+      messages
     };
   }
 };
@@ -714,7 +734,7 @@ var ChatCommunityApi = class {
   /** 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.");
+    if (!teamId) throw new ChatClientAuthError("Not identified. Call chat.identify() first.");
     const response = await this.chat.fetch("/api/widget/community", {
       method: "POST",
       body: {
@@ -731,7 +751,7 @@ var ChatCommunityApi = class {
   /** Update a post. Only the original author can edit. */
   async updatePost(postId, params) {
     const teamId = this.chat.getTeamId();
-    if (!teamId) throw new Error("Not identified. Call chat.identify() first.");
+    if (!teamId) throw new ChatClientAuthError("Not identified. Call chat.identify() first.");
     const response = await this.chat.fetch("/api/widget/community", {
       method: "POST",
       body: {
@@ -748,7 +768,7 @@ var ChatCommunityApi = class {
   /** Delete a post (soft delete). Only the original author can delete. */
   async deletePost(postId) {
     const teamId = this.chat.getTeamId();
-    if (!teamId) throw new Error("Not identified. Call chat.identify() first.");
+    if (!teamId) throw new ChatClientAuthError("Not identified. Call chat.identify() first.");
     await this.chat.fetch("/api/widget/community", {
       method: "POST",
       body: { teamId, action: "deletePost", postId }
@@ -757,7 +777,7 @@ var ChatCommunityApi = class {
   /** Update a comment. Only the original author can edit. */
   async updateComment(postId, commentId, params) {
     const teamId = this.chat.getTeamId();
-    if (!teamId) throw new Error("Not identified. Call chat.identify() first.");
+    if (!teamId) throw new ChatClientAuthError("Not identified. Call chat.identify() first.");
     const response = await this.chat.fetch("/api/widget/community", {
       method: "POST",
       body: {
@@ -773,7 +793,7 @@ var ChatCommunityApi = class {
   /** Delete a comment (soft delete). Only the original author can delete. */
   async deleteComment(postId, commentId) {
     const teamId = this.chat.getTeamId();
-    if (!teamId) throw new Error("Not identified. Call chat.identify() first.");
+    if (!teamId) throw new ChatClientAuthError("Not identified. Call chat.identify() first.");
     await this.chat.fetch("/api/widget/community", {
       method: "POST",
       body: { teamId, action: "deleteComment", postId, commentId }
@@ -782,7 +802,7 @@ var ChatCommunityApi = class {
   /** 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.");
+    if (!teamId) throw new ChatClientAuthError("Not identified. Call chat.identify() first.");
     const response = await this.chat.fetch("/api/widget/community", {
       method: "POST",
       body: { teamId, action: "vote", postId }
@@ -792,7 +812,7 @@ var ChatCommunityApi = class {
   /** 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.");
+    if (!teamId) throw new ChatClientAuthError("Not identified. Call chat.identify() first.");
     const response = await this.chat.fetch("/api/widget/community", {
       method: "POST",
       body: {
@@ -808,7 +828,7 @@ var ChatCommunityApi = class {
   /** Toggle follow on a post. */
   async follow(postId) {
     const teamId = this.chat.getTeamId();
-    if (!teamId) throw new Error("Not identified. Call chat.identify() first.");
+    if (!teamId) throw new ChatClientAuthError("Not identified. Call chat.identify() first.");
     const response = await this.chat.fetch("/api/widget/community", {
       method: "POST",
       body: { teamId, action: "follow", postId }
@@ -818,7 +838,7 @@ var ChatCommunityApi = class {
   /** 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.");
+    if (!teamId) throw new ChatClientAuthError("Not identified. Call chat.identify() first.");
     const response = await this.chat.fetch("/api/widget/community", {
       method: "GET",
       query: { teamId, postId }
@@ -829,7 +849,7 @@ var ChatCommunityApi = class {
   async bulkVoteStatus(postIds) {
     if (postIds.length === 0) return {};
     const teamId = this.chat.getTeamId();
-    if (!teamId) throw new Error("Not identified. Call chat.identify() first.");
+    if (!teamId) throw new ChatClientAuthError("Not identified. Call chat.identify() first.");
     const response = await this.chat.fetch("/api/widget/community", {
       method: "GET",
       query: { teamId, postIds: postIds.join(",") }