@cstar.help/js 0.13.0 → 0.15.0

package/dist/chat/index.cjs

@@ -343,6 +343,7 @@ var ChatClient = class {
     this.customerId = null;
     this.authMode = null;
     this.pollingTimers = /* @__PURE__ */ new Map();
+    this.stateListeners = /* @__PURE__ */ new Set();
     this.realtimeManager = null;
     this.presenceManager = null;
     this.realtimeReady = false;
@@ -383,6 +384,7 @@ var ChatClient = class {
     this.teamId = response.data.teamId;
     this.customerId = response.data.customer.id;
     this.authMode = "hmac";
+    this.notifyStateChanged();
     if (this.realtimeEnabled) {
       this.realtimeInitPromise = this.initRealtime(
         response.data.customer.id,
@@ -442,11 +444,35 @@ var ChatClient = class {
       this.teamId = params.teamId;
     }
     this.authMode = "session";
+    this.notifyStateChanged();
     if (this.realtimeEnabled) {
       const customerName = params.customerName ?? "";
       this.realtimeInitPromise = this.initRealtimeFromSession(customerName);
     }
   }
+  /**
+   * Subscribe to client state changes (auth mode flips, identify, disconnect).
+   * Fires after the mutation, so listeners reading `getAuthMode()` /
+   * `getCustomerId()` see the new value.
+   *
+   * Returns an unsubscribe function. Closes F-041 — used by `useChat` (React)
+   * and `ChatState` (Svelte) to re-render when consumers mutate the client
+   * outside of the framework wrappers.
+   */
+  subscribe(listener) {
+    this.stateListeners.add(listener);
+    return () => {
+      this.stateListeners.delete(listener);
+    };
+  }
+  notifyStateChanged() {
+    for (const listener of this.stateListeners) {
+      try {
+        listener();
+      } catch {
+      }
+    }
+  }
   /**
    * Returns the auth mode the client is currently using, or `null` before
    * any authenticated call has resolved one. Useful for branching UI
@@ -509,6 +535,7 @@ var ChatClient = class {
     this.teamId = null;
     this.customerId = null;
     this.authMode = null;
+    this.notifyStateChanged();
   }
   /**
    * @internal Make an authenticated request to the widget API.
@@ -546,7 +573,9 @@ var ChatClient = class {
     const responseHeaders = response.headers && typeof response.headers.get === "function" ? response.headers : null;
     const headerMode = responseHeaders?.get("X-Cstar-Auth-Mode") ?? null;
     if (headerMode === "hmac" || headerMode === "session") {
+      const previous = this.authMode;
       this.authMode = headerMode;
+      if (previous !== headerMode) this.notifyStateChanged();
     }
     const requestId = responseHeaders?.get("X-Request-Id") ?? null;
     if (!response.ok) {
@@ -633,6 +662,27 @@ var ChatClient = class {
   getTeamId() {
     return this.teamId;
   }
+  /**
+   * Resolve a team ID, lazily looking it up from `teamSlug` if no team ID
+   * has been cached yet. Used by `tickets.list` and friends so that a
+   * caller who constructed `new ChatClient({ teamSlug, publishableKey })`
+   * doesn't have to manually call `loginWithCredentials` before reading
+   * public data.
+   *
+   * Closes NEW-v3-05 — `TicketsState(chatClient)` previously errored
+   * `"Missing teamId"` when the chat client was teamSlug-only because the
+   * tickets sub-resource read `getTeamId()` synchronously and bailed.
+   */
+  async ensureTeamId() {
+    if (this.teamId) return this.teamId;
+    if (!this.teamSlug) {
+      throw new ChatClientAuthError(
+        "Missing teamId. Construct ChatClient with `teamSlug` or call `setTeamId()` / `identify()` / `loginWithCredentials()` first."
+      );
+    }
+    this.teamId = await this.resolveTeamIdFromSlug();
+    return this.teamId;
+  }
   /** @internal Set team ID from identify response or other source. */
   setTeamId(teamId) {
     this.teamId = teamId;
@@ -718,8 +768,10 @@ var TicketsApi = class {
   }
   /** List tickets for the identified customer. */
   async list(params) {
-    const teamId = this.chat.getTeamId();
-    if (!teamId) throw new ChatClientAuthError("Not identified. Call chat.identify() first.");
+    if (this.chat.getAuthMode() === null) {
+      throw new ChatClientAuthError("Not identified. Call chat.identify() first.");
+    }
+    const teamId = await this.chat.ensureTeamId();
     const response = await this.chat.fetch("/api/widget/conversations", {
       method: "GET",
       query: {
@@ -728,16 +780,21 @@ var TicketsApi = class {
         cursor: params?.cursor
       }
     });
+    const data = response.data.tickets ?? response.data.conversations ?? [];
+    const cursor = response.data.cursor;
+    const hasMore = response.data.hasMore;
     return {
-      tickets: response.data.tickets ?? response.data.conversations ?? [],
-      cursor: response.data.cursor,
-      hasMore: response.data.hasMore
+      data,
+      pagination: { cursor, hasMore },
+      hasMore
     };
   }
   /** Create a new ticket. */
   async create(params) {
-    const teamId = this.chat.getTeamId();
-    if (!teamId) throw new ChatClientAuthError("Not identified. Call chat.identify() first.");
+    if (this.chat.getAuthMode() === null) {
+      throw new ChatClientAuthError("Not identified. Call chat.identify() first.");
+    }
+    const teamId = await this.chat.ensureTeamId();
     const response = await this.chat.fetch("/api/widget/tickets", {
       method: "POST",
       body: {

package/dist/chat/index.d.cts

@@ -107,10 +107,24 @@ interface Ticket {
      */
     messages?: Message[];
 }
-/** Paginated ticket list response. */
+/**
+ * Paginated ticket list response.
+ *
+ * As of `@cstar.help/js@0.14.0` the canonical fields match the admin SDK and
+ * library SDK envelopes (`{ data, pagination, hasMore }`). Closes F-037.
+ *
+ * Breaking change in 0.15.0 (B-11): the deprecated `tickets` and `cursor`
+ * top-level aliases are removed. Read `data` and `pagination.cursor`.
+ */
 interface TicketListResponse {
-    tickets: Ticket[];
-    cursor: string | null;
+    /** Tickets on this page. */
+    data: Ticket[];
+    /** Pagination cursor + a flag for whether more pages exist. */
+    pagination: {
+        cursor: string | null;
+        hasMore: boolean;
+    };
+    /** Convenience copy of `pagination.hasMore`. */
     hasMore: boolean;
 }
 /** A message on a ticket. */
@@ -345,6 +359,12 @@ declare class ChatClientNetworkError extends ChatClientError {
  * `ChatClientServerError`, `ChatClientNetworkError`. Each carries
  * `requestId` for correlating with server-side logs.
  */
+/**
+ * Listener for client-state changes (auth-mode flips, identity assignment,
+ * disconnects). Fires once after the underlying state mutates so a UI layer
+ * can re-read `getAuthMode()` / `getCustomerId()` and re-render. Closes F-041.
+ */
+type ChatStateListener = () => void;
 declare class ChatClient {
     private readonly baseUrl;
     private readonly teamSlug;
@@ -355,6 +375,7 @@ declare class ChatClient {
     private customerId;
     private authMode;
     private pollingTimers;
+    private stateListeners;
     private realtimeManager;
     private presenceManager;
     private realtimeReady;
@@ -397,6 +418,17 @@ declare class ChatClient {
      * every request — there is no client-side validation here.
      */
     loginWithSession(params: LoginWithSessionParams): Promise<void>;
+    /**
+     * Subscribe to client state changes (auth mode flips, identify, disconnect).
+     * Fires after the mutation, so listeners reading `getAuthMode()` /
+     * `getCustomerId()` see the new value.
+     *
+     * Returns an unsubscribe function. Closes F-041 — used by `useChat` (React)
+     * and `ChatState` (Svelte) to re-render when consumers mutate the client
+     * outside of the framework wrappers.
+     */
+    subscribe(listener: ChatStateListener): () => void;
+    private notifyStateChanged;
     /**
      * Returns the auth mode the client is currently using, or `null` before
      * any authenticated call has resolved one. Useful for branching UI
@@ -453,6 +485,18 @@ declare class ChatClient {
     private initRealtimeFromSession;
     /** @internal Get the stored team ID for requests that need it. */
     getTeamId(): string | null;
+    /**
+     * Resolve a team ID, lazily looking it up from `teamSlug` if no team ID
+     * has been cached yet. Used by `tickets.list` and friends so that a
+     * caller who constructed `new ChatClient({ teamSlug, publishableKey })`
+     * doesn't have to manually call `loginWithCredentials` before reading
+     * public data.
+     *
+     * Closes NEW-v3-05 — `TicketsState(chatClient)` previously errored
+     * `"Missing teamId"` when the chat client was teamSlug-only because the
+     * tickets sub-resource read `getTeamId()` synchronously and bailed.
+     */
+    ensureTeamId(): Promise<string>;
     /** @internal Set team ID from identify response or other source. */
     setTeamId(teamId: string): void;
     /** @internal Wait for realtime to be initialized (for testing). */
@@ -509,4 +553,4 @@ declare class MessagesApi {
     send(ticketId: string, content: string): Promise<Message>;
 }
 
-export { type ChatAuthMode, ChatClient, ChatClientAuthError, ChatClientError, ChatClientNetworkError, ChatClientRateLimitError, ChatClientServerError, type ChatConfig, type IdentifyParams, type IdentifyResult, type LoginWithCredentialsParams, type LoginWithCredentialsResult, type LoginWithSessionParams, type Message, type MessageCallback, type RealtimeTokenResponse, type Ticket, type TicketCreateParams, type TicketListParams, type TicketListResponse, type TypingCallback, type TypingPayload };
+export { type ChatAuthMode, ChatClient, ChatClientAuthError, ChatClientError, ChatClientNetworkError, ChatClientRateLimitError, ChatClientServerError, type ChatConfig, type ChatStateListener, type IdentifyParams, type IdentifyResult, type LoginWithCredentialsParams, type LoginWithCredentialsResult, type LoginWithSessionParams, type Message, type MessageCallback, type RealtimeTokenResponse, type Ticket, type TicketCreateParams, type TicketListParams, type TicketListResponse, type TypingCallback, type TypingPayload };

package/dist/chat/index.d.ts

@@ -107,10 +107,24 @@ interface Ticket {
      */
     messages?: Message[];
 }
-/** Paginated ticket list response. */
+/**
+ * Paginated ticket list response.
+ *
+ * As of `@cstar.help/js@0.14.0` the canonical fields match the admin SDK and
+ * library SDK envelopes (`{ data, pagination, hasMore }`). Closes F-037.
+ *
+ * Breaking change in 0.15.0 (B-11): the deprecated `tickets` and `cursor`
+ * top-level aliases are removed. Read `data` and `pagination.cursor`.
+ */
 interface TicketListResponse {
-    tickets: Ticket[];
-    cursor: string | null;
+    /** Tickets on this page. */
+    data: Ticket[];
+    /** Pagination cursor + a flag for whether more pages exist. */
+    pagination: {
+        cursor: string | null;
+        hasMore: boolean;
+    };
+    /** Convenience copy of `pagination.hasMore`. */
     hasMore: boolean;
 }
 /** A message on a ticket. */
@@ -345,6 +359,12 @@ declare class ChatClientNetworkError extends ChatClientError {
  * `ChatClientServerError`, `ChatClientNetworkError`. Each carries
  * `requestId` for correlating with server-side logs.
  */
+/**
+ * Listener for client-state changes (auth-mode flips, identity assignment,
+ * disconnects). Fires once after the underlying state mutates so a UI layer
+ * can re-read `getAuthMode()` / `getCustomerId()` and re-render. Closes F-041.
+ */
+type ChatStateListener = () => void;
 declare class ChatClient {
     private readonly baseUrl;
     private readonly teamSlug;
@@ -355,6 +375,7 @@ declare class ChatClient {
     private customerId;
     private authMode;
     private pollingTimers;
+    private stateListeners;
     private realtimeManager;
     private presenceManager;
     private realtimeReady;
@@ -397,6 +418,17 @@ declare class ChatClient {
      * every request — there is no client-side validation here.
      */
     loginWithSession(params: LoginWithSessionParams): Promise<void>;
+    /**
+     * Subscribe to client state changes (auth mode flips, identify, disconnect).
+     * Fires after the mutation, so listeners reading `getAuthMode()` /
+     * `getCustomerId()` see the new value.
+     *
+     * Returns an unsubscribe function. Closes F-041 — used by `useChat` (React)
+     * and `ChatState` (Svelte) to re-render when consumers mutate the client
+     * outside of the framework wrappers.
+     */
+    subscribe(listener: ChatStateListener): () => void;
+    private notifyStateChanged;
     /**
      * Returns the auth mode the client is currently using, or `null` before
      * any authenticated call has resolved one. Useful for branching UI
@@ -453,6 +485,18 @@ declare class ChatClient {
     private initRealtimeFromSession;
     /** @internal Get the stored team ID for requests that need it. */
     getTeamId(): string | null;
+    /**
+     * Resolve a team ID, lazily looking it up from `teamSlug` if no team ID
+     * has been cached yet. Used by `tickets.list` and friends so that a
+     * caller who constructed `new ChatClient({ teamSlug, publishableKey })`
+     * doesn't have to manually call `loginWithCredentials` before reading
+     * public data.
+     *
+     * Closes NEW-v3-05 — `TicketsState(chatClient)` previously errored
+     * `"Missing teamId"` when the chat client was teamSlug-only because the
+     * tickets sub-resource read `getTeamId()` synchronously and bailed.
+     */
+    ensureTeamId(): Promise<string>;
     /** @internal Set team ID from identify response or other source. */
     setTeamId(teamId: string): void;
     /** @internal Wait for realtime to be initialized (for testing). */
@@ -509,4 +553,4 @@ declare class MessagesApi {
     send(ticketId: string, content: string): Promise<Message>;
 }
 
-export { type ChatAuthMode, ChatClient, ChatClientAuthError, ChatClientError, ChatClientNetworkError, ChatClientRateLimitError, ChatClientServerError, type ChatConfig, type IdentifyParams, type IdentifyResult, type LoginWithCredentialsParams, type LoginWithCredentialsResult, type LoginWithSessionParams, type Message, type MessageCallback, type RealtimeTokenResponse, type Ticket, type TicketCreateParams, type TicketListParams, type TicketListResponse, type TypingCallback, type TypingPayload };
+export { type ChatAuthMode, ChatClient, ChatClientAuthError, ChatClientError, ChatClientNetworkError, ChatClientRateLimitError, ChatClientServerError, type ChatConfig, type ChatStateListener, type IdentifyParams, type IdentifyResult, type LoginWithCredentialsParams, type LoginWithCredentialsResult, type LoginWithSessionParams, type Message, type MessageCallback, type RealtimeTokenResponse, type Ticket, type TicketCreateParams, type TicketListParams, type TicketListResponse, type TypingCallback, type TypingPayload };

package/dist/chat/index.js

@@ -302,6 +302,7 @@ var ChatClient = class {
     this.customerId = null;
     this.authMode = null;
     this.pollingTimers = /* @__PURE__ */ new Map();
+    this.stateListeners = /* @__PURE__ */ new Set();
     this.realtimeManager = null;
     this.presenceManager = null;
     this.realtimeReady = false;
@@ -342,6 +343,7 @@ var ChatClient = class {
     this.teamId = response.data.teamId;
     this.customerId = response.data.customer.id;
     this.authMode = "hmac";
+    this.notifyStateChanged();
     if (this.realtimeEnabled) {
       this.realtimeInitPromise = this.initRealtime(
         response.data.customer.id,
@@ -401,11 +403,35 @@ var ChatClient = class {
       this.teamId = params.teamId;
     }
     this.authMode = "session";
+    this.notifyStateChanged();
     if (this.realtimeEnabled) {
       const customerName = params.customerName ?? "";
       this.realtimeInitPromise = this.initRealtimeFromSession(customerName);
     }
   }
+  /**
+   * Subscribe to client state changes (auth mode flips, identify, disconnect).
+   * Fires after the mutation, so listeners reading `getAuthMode()` /
+   * `getCustomerId()` see the new value.
+   *
+   * Returns an unsubscribe function. Closes F-041 — used by `useChat` (React)
+   * and `ChatState` (Svelte) to re-render when consumers mutate the client
+   * outside of the framework wrappers.
+   */
+  subscribe(listener) {
+    this.stateListeners.add(listener);
+    return () => {
+      this.stateListeners.delete(listener);
+    };
+  }
+  notifyStateChanged() {
+    for (const listener of this.stateListeners) {
+      try {
+        listener();
+      } catch {
+      }
+    }
+  }
   /**
    * Returns the auth mode the client is currently using, or `null` before
    * any authenticated call has resolved one. Useful for branching UI
@@ -468,6 +494,7 @@ var ChatClient = class {
     this.teamId = null;
     this.customerId = null;
     this.authMode = null;
+    this.notifyStateChanged();
   }
   /**
    * @internal Make an authenticated request to the widget API.
@@ -505,7 +532,9 @@ var ChatClient = class {
     const responseHeaders = response.headers && typeof response.headers.get === "function" ? response.headers : null;
     const headerMode = responseHeaders?.get("X-Cstar-Auth-Mode") ?? null;
     if (headerMode === "hmac" || headerMode === "session") {
+      const previous = this.authMode;
       this.authMode = headerMode;
+      if (previous !== headerMode) this.notifyStateChanged();
     }
     const requestId = responseHeaders?.get("X-Request-Id") ?? null;
     if (!response.ok) {
@@ -592,6 +621,27 @@ var ChatClient = class {
   getTeamId() {
     return this.teamId;
   }
+  /**
+   * Resolve a team ID, lazily looking it up from `teamSlug` if no team ID
+   * has been cached yet. Used by `tickets.list` and friends so that a
+   * caller who constructed `new ChatClient({ teamSlug, publishableKey })`
+   * doesn't have to manually call `loginWithCredentials` before reading
+   * public data.
+   *
+   * Closes NEW-v3-05 — `TicketsState(chatClient)` previously errored
+   * `"Missing teamId"` when the chat client was teamSlug-only because the
+   * tickets sub-resource read `getTeamId()` synchronously and bailed.
+   */
+  async ensureTeamId() {
+    if (this.teamId) return this.teamId;
+    if (!this.teamSlug) {
+      throw new ChatClientAuthError(
+        "Missing teamId. Construct ChatClient with `teamSlug` or call `setTeamId()` / `identify()` / `loginWithCredentials()` first."
+      );
+    }
+    this.teamId = await this.resolveTeamIdFromSlug();
+    return this.teamId;
+  }
   /** @internal Set team ID from identify response or other source. */
   setTeamId(teamId) {
     this.teamId = teamId;
@@ -677,8 +727,10 @@ var TicketsApi = class {
   }
   /** List tickets for the identified customer. */
   async list(params) {
-    const teamId = this.chat.getTeamId();
-    if (!teamId) throw new ChatClientAuthError("Not identified. Call chat.identify() first.");
+    if (this.chat.getAuthMode() === null) {
+      throw new ChatClientAuthError("Not identified. Call chat.identify() first.");
+    }
+    const teamId = await this.chat.ensureTeamId();
     const response = await this.chat.fetch("/api/widget/conversations", {
       method: "GET",
       query: {
@@ -687,16 +739,21 @@ var TicketsApi = class {
         cursor: params?.cursor
       }
     });
+    const data = response.data.tickets ?? response.data.conversations ?? [];
+    const cursor = response.data.cursor;
+    const hasMore = response.data.hasMore;
     return {
-      tickets: response.data.tickets ?? response.data.conversations ?? [],
-      cursor: response.data.cursor,
-      hasMore: response.data.hasMore
+      data,
+      pagination: { cursor, hasMore },
+      hasMore
     };
   }
   /** Create a new ticket. */
   async create(params) {
-    const teamId = this.chat.getTeamId();
-    if (!teamId) throw new ChatClientAuthError("Not identified. Call chat.identify() first.");
+    if (this.chat.getAuthMode() === null) {
+      throw new ChatClientAuthError("Not identified. Call chat.identify() first.");
+    }
+    const teamId = await this.chat.ensureTeamId();
     const response = await this.chat.fetch("/api/widget/tickets", {
       method: "POST",
       body: {

package/dist/community/index.cjs

@@ -20,7 +20,20 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/community/index.ts
 var community_exports = {};
 __export(community_exports, {
-  CommunityClient: () => CommunityClient
+  CStarAuthenticationError: () => CStarAuthenticationError,
+  CStarConflictError: () => CStarConflictError,
+  CStarError: () => CStarError,
+  CStarFeatureDisabledError: () => CStarFeatureDisabledError,
+  CStarNotFoundError: () => CStarNotFoundError,
+  CStarPermissionError: () => CStarPermissionError,
+  CStarRateLimitError: () => CStarRateLimitError,
+  CStarRealtimeUnavailableError: () => CStarRealtimeUnavailableError,
+  CStarServerError: () => CStarServerError,
+  CStarValidationError: () => CStarValidationError,
+  CommunityClient: () => CommunityClient,
+  ErrorType: () => ErrorType,
+  parseError: () => parseError,
+  parsePublicError: () => parsePublicError
 });
 module.exports = __toCommonJS(community_exports);
 
@@ -61,7 +74,7 @@ function normalizeArgs(messageOrStatus, maybeBody, defaults) {
     }
   };
 }
-var CStarError = class extends Error {
+var CStarErrorImpl = class extends Error {
   constructor(messageOrStatus, body) {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body);
     super(resolved.message);
@@ -74,7 +87,7 @@ var CStarError = class extends Error {
     this.statusCode = statusCode;
   }
 };
-var CStarAuthenticationError = class extends CStarError {
+var CStarAuthenticationErrorImpl = class extends CStarErrorImpl {
   constructor(messageOrStatus, body) {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.AUTHENTICATION_ERROR,
@@ -85,7 +98,7 @@ var CStarAuthenticationError = class extends CStarError {
     this.name = "CStarAuthenticationError";
   }
 };
-var CStarRateLimitError = class extends CStarError {
+var CStarRateLimitErrorImpl = class extends CStarErrorImpl {
   constructor(messageOrStatus, body, retryAfter) {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.RATE_LIMIT_ERROR,
@@ -97,7 +110,7 @@ var CStarRateLimitError = class extends CStarError {
     this.retryAfter = retryAfter ?? 60;
   }
 };
-var CStarNotFoundError = class extends CStarError {
+var CStarNotFoundErrorImpl = class extends CStarErrorImpl {
   constructor(messageOrStatus, body) {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.NOT_FOUND_ERROR,
@@ -108,7 +121,7 @@ var CStarNotFoundError = class extends CStarError {
     this.name = "CStarNotFoundError";
   }
 };
-var CStarValidationError = class extends CStarError {
+var CStarValidationErrorImpl = class extends CStarErrorImpl {
   constructor(messageOrStatus, body) {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.INVALID_REQUEST_ERROR,
@@ -119,7 +132,7 @@ var CStarValidationError = class extends CStarError {
     this.name = "CStarValidationError";
   }
 };
-var CStarPermissionError = class extends CStarError {
+var CStarPermissionErrorImpl = class extends CStarErrorImpl {
   constructor(messageOrStatus, body) {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.PERMISSION_ERROR,
@@ -130,7 +143,7 @@ var CStarPermissionError = class extends CStarError {
     this.name = "CStarPermissionError";
   }
 };
-var CStarConflictError = class extends CStarError {
+var CStarConflictErrorImpl = class extends CStarErrorImpl {
   constructor(messageOrStatus, body) {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.CONFLICT_ERROR,
@@ -141,7 +154,7 @@ var CStarConflictError = class extends CStarError {
     this.name = "CStarConflictError";
   }
 };
-var CStarServerError = class extends CStarError {
+var CStarServerErrorImpl = class extends CStarErrorImpl {
   constructor(messageOrStatus, body) {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.SERVER_ERROR,
@@ -152,7 +165,7 @@ var CStarServerError = class extends CStarError {
     this.name = "CStarServerError";
   }
 };
-var CStarFeatureDisabledError = class extends CStarError {
+var CStarFeatureDisabledErrorImpl = class extends CStarErrorImpl {
   constructor(messageOrStatus, body) {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.FEATURE_NOT_CONFIGURED,
@@ -165,6 +178,42 @@ var CStarFeatureDisabledError = class extends CStarError {
     this.enableUrl = resolved.enable_url ?? "";
   }
 };
+var CStarRealtimeUnavailableErrorImpl = class extends CStarErrorImpl {
+  constructor(message) {
+    const resolved = message ?? "EventSource is not available in this environment. Real-time subscriptions only work in the browser. Move the call to a client-only path (`useEffect` / `onMount`), or pass an `eventSource` polyfill via the realtime options. See https://cstar.help/developers/sdk/realtime#ssr";
+    super(0, {
+      type: ErrorType.API_ERROR,
+      code: "realtime_unavailable",
+      message: resolved,
+      doc_url: "https://cstar.help/developers/sdk/realtime#ssr"
+    });
+    this.name = "CStarRealtimeUnavailableError";
+  }
+};
+var REGISTRY_KEY = /* @__PURE__ */ Symbol.for("@cstar.help/js/errors/v1");
+var globalSlot = globalThis;
+var registry = globalSlot[REGISTRY_KEY] ?? (globalSlot[REGISTRY_KEY] = {
+  CStarError: CStarErrorImpl,
+  CStarAuthenticationError: CStarAuthenticationErrorImpl,
+  CStarRateLimitError: CStarRateLimitErrorImpl,
+  CStarNotFoundError: CStarNotFoundErrorImpl,
+  CStarValidationError: CStarValidationErrorImpl,
+  CStarPermissionError: CStarPermissionErrorImpl,
+  CStarConflictError: CStarConflictErrorImpl,
+  CStarServerError: CStarServerErrorImpl,
+  CStarFeatureDisabledError: CStarFeatureDisabledErrorImpl,
+  CStarRealtimeUnavailableError: CStarRealtimeUnavailableErrorImpl
+});
+var CStarError = registry.CStarError;
+var CStarAuthenticationError = registry.CStarAuthenticationError;
+var CStarRateLimitError = registry.CStarRateLimitError;
+var CStarNotFoundError = registry.CStarNotFoundError;
+var CStarValidationError = registry.CStarValidationError;
+var CStarPermissionError = registry.CStarPermissionError;
+var CStarConflictError = registry.CStarConflictError;
+var CStarServerError = registry.CStarServerError;
+var CStarFeatureDisabledError = registry.CStarFeatureDisabledError;
+var CStarRealtimeUnavailableError = registry.CStarRealtimeUnavailableError;
 function parsePublicError(status, body, fallbackMessage) {
   const obj = body && typeof body === "object" ? body : null;
   const errVal = obj?.error;
@@ -529,5 +578,18 @@ var CommunityClient = class {
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  CommunityClient
+  CStarAuthenticationError,
+  CStarConflictError,
+  CStarError,
+  CStarFeatureDisabledError,
+  CStarNotFoundError,
+  CStarPermissionError,
+  CStarRateLimitError,
+  CStarRealtimeUnavailableError,
+  CStarServerError,
+  CStarValidationError,
+  CommunityClient,
+  ErrorType,
+  parseError,
+  parsePublicError
 });