@cstar.help/js 0.18.2 → 0.18.4

package/README.md

@@ -404,11 +404,12 @@ const event = await constructEventAsync(rawBody, signature, secret);
 ```typescript
 const cstar = new CStarClient({
 	apiKey: 'sk_live_...', // Required: must be a secret key (sk_*)
-	teamId: 'tm_...', // Required: your team ID
+	teamId: '8f14e45f-ea2b-4c8b-9f1e-2a6b3c4d5e6f', // Required: your team ID (a UUID; GET /api/v1/auth/whoami returns it)
 	baseUrl: 'https://...', // Optional: defaults to https://www.cstar.help
 	version: '2026-03-01', // Optional: API version header
 	maxRetries: 3, // Optional: retry attempts for retry-safe failures and 429
-	timeout: 30000 // Optional: request timeout in ms
+	timeout: 30000, // Optional: request timeout in ms
+	realtime: { types: ['ticket.created', 'message.created'] } // Optional: realtime stream options (types, eventSource polyfill, autoReconnect, maxRetries)
 });
 ```
 
@@ -432,7 +433,7 @@ Test mode is auto-detected from your API key prefix:
 ```typescript
 const cstar = new CStarClient({
 	apiKey: 'sk_test_abc123...',
-	teamId: 'tm_your_team_id'
+	teamId: process.env.CSTAR_TEAM_ID! // a UUID
 });
 
 console.log(cstar.isTestMode); // true
@@ -447,6 +448,7 @@ All API errors throw typed exceptions:
 import {
 	CStarError,
 	CStarAuthenticationError,
+	CStarConflictError,
 	CStarRateLimitError,
 	CStarNotFoundError,
 	CStarValidationError
@@ -461,6 +463,10 @@ try {
 		console.log('Invalid param:', err.param);
 	} else if (err instanceof CStarRateLimitError) {
 		console.log('Rate limited, retry after:', err.retryAfter, 'seconds');
+	} else if (err instanceof CStarConflictError) {
+		// A unique-key conflict, an Idempotency-Key still in use, or the team's
+		// webhook limit (code 'webhook_limit_reached': delete unused webhooks first).
+		console.log('Conflict:', err.code);
 	} else if (err instanceof CStarAuthenticationError) {
 		console.log('Bad API key');
 	} else if (err instanceof CStarError) {

package/dist/auth/index.cjs

@@ -59,7 +59,7 @@ var ErrorType = {
   API_ERROR: "api_error",
   SERVER_ERROR: "server_error"
 };
-var DEFAULT_DOC_URL = "https://cstar.help/developers/api/errors";
+var DEFAULT_DOC_URL = "https://www.cstar.help/developers/errors";
 function normalizeArgs(messageOrStatus, maybeBody, defaults) {
   if (typeof messageOrStatus === "string") {
     return {
@@ -102,7 +102,7 @@ var CStarAuthenticationErrorImpl = class extends CStarErrorImpl {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.AUTHENTICATION_ERROR,
       code: "authentication_failed",
-      doc_url: `${DEFAULT_DOC_URL}#authentication-error`
+      doc_url: `${DEFAULT_DOC_URL}#authentication-errors`
     });
     super(statusCode, resolved);
     this.name = "CStarAuthenticationError";
@@ -113,11 +113,11 @@ var CStarRateLimitErrorImpl = class extends CStarErrorImpl {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.RATE_LIMIT_ERROR,
       code: "rate_limit_exceeded",
-      doc_url: `${DEFAULT_DOC_URL}#rate-limit-error`
+      doc_url: `${DEFAULT_DOC_URL}#rate_limit_exceeded`
     });
     super(statusCode === 0 ? 429 : statusCode, resolved);
     this.name = "CStarRateLimitError";
-    this.retryAfter = retryAfter ?? 60;
+    this.retryAfter = retryAfter;
   }
 };
 var CStarNotFoundErrorImpl = class extends CStarErrorImpl {
@@ -125,7 +125,7 @@ var CStarNotFoundErrorImpl = class extends CStarErrorImpl {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.NOT_FOUND_ERROR,
       code: "resource_not_found",
-      doc_url: `${DEFAULT_DOC_URL}#not-found-error`
+      doc_url: `${DEFAULT_DOC_URL}#resource_not_found`
     });
     super(statusCode, resolved);
     this.name = "CStarNotFoundError";
@@ -136,7 +136,7 @@ var CStarValidationErrorImpl = class extends CStarErrorImpl {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.INVALID_REQUEST_ERROR,
       code: "validation_error",
-      doc_url: `${DEFAULT_DOC_URL}#validation-error`
+      doc_url: `${DEFAULT_DOC_URL}#invalid-request-errors`
     });
     super(statusCode, resolved);
     this.name = "CStarValidationError";
@@ -147,7 +147,7 @@ var CStarPermissionErrorImpl = class extends CStarErrorImpl {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.PERMISSION_ERROR,
       code: "permission_denied",
-      doc_url: `${DEFAULT_DOC_URL}#permission-error`
+      doc_url: `${DEFAULT_DOC_URL}#insufficient_permissions`
     });
     super(statusCode, resolved);
     this.name = "CStarPermissionError";
@@ -158,7 +158,7 @@ var CStarConflictErrorImpl = class extends CStarErrorImpl {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.CONFLICT_ERROR,
       code: "conflict",
-      doc_url: `${DEFAULT_DOC_URL}#conflict-error`
+      doc_url: `${DEFAULT_DOC_URL}#resource_conflict`
     });
     super(statusCode, resolved);
     this.name = "CStarConflictError";
@@ -169,7 +169,7 @@ var CStarServerErrorImpl = class extends CStarErrorImpl {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.SERVER_ERROR,
       code: "server_error",
-      doc_url: `${DEFAULT_DOC_URL}#server-error`
+      doc_url: `${DEFAULT_DOC_URL}#server-errors`
     });
     super(statusCode, resolved);
     this.name = "CStarServerError";
@@ -180,7 +180,7 @@ var CStarFeatureDisabledErrorImpl = class extends CStarErrorImpl {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.FEATURE_NOT_CONFIGURED,
       code: "feature_not_configured",
-      doc_url: `${DEFAULT_DOC_URL}#feature-not-configured`
+      doc_url: `${DEFAULT_DOC_URL}#feature_disabled`
     });
     super(statusCode, resolved);
     this.name = "CStarFeatureDisabledError";
@@ -190,12 +190,12 @@ var CStarFeatureDisabledErrorImpl = class extends CStarErrorImpl {
 };
 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";
+    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://www.cstar.help/developers/sdk/js/realtime#ssr";
     super(0, {
       type: ErrorType.API_ERROR,
       code: "realtime_unavailable",
       message: resolved,
-      doc_url: "https://cstar.help/developers/sdk/realtime#ssr"
+      doc_url: "https://www.cstar.help/developers/sdk/js/realtime#ssr"
     });
     this.name = "CStarRealtimeUnavailableError";
   }
@@ -302,7 +302,10 @@ function parseError(statusCode, body, retryAfter) {
     doc_url: DEFAULT_DOC_URL
   };
   if (statusCode === 429) {
-    return new CStarRateLimitError(statusCode, errorBody, retryAfter ?? 60);
+    return new CStarRateLimitError(statusCode, errorBody, retryAfter);
+  }
+  if (errorBody.code === "feature_disabled") {
+    return new CStarFeatureDisabledError(statusCode, errorBody);
   }
   const StatusCls = STATUS_TO_CLASS[statusCode];
   if (StatusCls) {

package/dist/auth/index.d.cts

@@ -1,4 +1,4 @@
-export { A as ApiErrorBody, C as CStarAuthenticationError, a as CStarConflictError, b as CStarError, c as CStarFeatureDisabledError, d as CStarNotFoundError, e as CStarPermissionError, f as CStarRateLimitError, g as CStarRealtimeUnavailableError, h as CStarServerError, i as CStarValidationError, E as ErrorType, p as parseError, j as parsePublicError } from '../errors-bW8CwTn4.cjs';
+export { A as ApiErrorBody, C as CStarAuthenticationError, a as CStarConflictError, b as CStarError, c as CStarFeatureDisabledError, d as CStarNotFoundError, e as CStarPermissionError, f as CStarRateLimitError, g as CStarRealtimeUnavailableError, h as CStarServerError, i as CStarValidationError, E as ErrorType, p as parseError, j as parsePublicError } from '../errors-BnUUTVlT.cjs';
 
 /** Configuration for the AuthClient. */
 interface AuthConfig {

package/dist/auth/index.d.ts

@@ -1,4 +1,4 @@
-export { A as ApiErrorBody, C as CStarAuthenticationError, a as CStarConflictError, b as CStarError, c as CStarFeatureDisabledError, d as CStarNotFoundError, e as CStarPermissionError, f as CStarRateLimitError, g as CStarRealtimeUnavailableError, h as CStarServerError, i as CStarValidationError, E as ErrorType, p as parseError, j as parsePublicError } from '../errors-bW8CwTn4.js';
+export { A as ApiErrorBody, C as CStarAuthenticationError, a as CStarConflictError, b as CStarError, c as CStarFeatureDisabledError, d as CStarNotFoundError, e as CStarPermissionError, f as CStarRateLimitError, g as CStarRealtimeUnavailableError, h as CStarServerError, i as CStarValidationError, E as ErrorType, p as parseError, j as parsePublicError } from '../errors-BnUUTVlT.js';
 
 /** Configuration for the AuthClient. */
 interface AuthConfig {

package/dist/auth/index.js

@@ -10,7 +10,7 @@ var ErrorType = {
   API_ERROR: "api_error",
   SERVER_ERROR: "server_error"
 };
-var DEFAULT_DOC_URL = "https://cstar.help/developers/api/errors";
+var DEFAULT_DOC_URL = "https://www.cstar.help/developers/errors";
 function normalizeArgs(messageOrStatus, maybeBody, defaults) {
   if (typeof messageOrStatus === "string") {
     return {
@@ -53,7 +53,7 @@ var CStarAuthenticationErrorImpl = class extends CStarErrorImpl {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.AUTHENTICATION_ERROR,
       code: "authentication_failed",
-      doc_url: `${DEFAULT_DOC_URL}#authentication-error`
+      doc_url: `${DEFAULT_DOC_URL}#authentication-errors`
     });
     super(statusCode, resolved);
     this.name = "CStarAuthenticationError";
@@ -64,11 +64,11 @@ var CStarRateLimitErrorImpl = class extends CStarErrorImpl {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.RATE_LIMIT_ERROR,
       code: "rate_limit_exceeded",
-      doc_url: `${DEFAULT_DOC_URL}#rate-limit-error`
+      doc_url: `${DEFAULT_DOC_URL}#rate_limit_exceeded`
     });
     super(statusCode === 0 ? 429 : statusCode, resolved);
     this.name = "CStarRateLimitError";
-    this.retryAfter = retryAfter ?? 60;
+    this.retryAfter = retryAfter;
   }
 };
 var CStarNotFoundErrorImpl = class extends CStarErrorImpl {
@@ -76,7 +76,7 @@ var CStarNotFoundErrorImpl = class extends CStarErrorImpl {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.NOT_FOUND_ERROR,
       code: "resource_not_found",
-      doc_url: `${DEFAULT_DOC_URL}#not-found-error`
+      doc_url: `${DEFAULT_DOC_URL}#resource_not_found`
     });
     super(statusCode, resolved);
     this.name = "CStarNotFoundError";
@@ -87,7 +87,7 @@ var CStarValidationErrorImpl = class extends CStarErrorImpl {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.INVALID_REQUEST_ERROR,
       code: "validation_error",
-      doc_url: `${DEFAULT_DOC_URL}#validation-error`
+      doc_url: `${DEFAULT_DOC_URL}#invalid-request-errors`
     });
     super(statusCode, resolved);
     this.name = "CStarValidationError";
@@ -98,7 +98,7 @@ var CStarPermissionErrorImpl = class extends CStarErrorImpl {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.PERMISSION_ERROR,
       code: "permission_denied",
-      doc_url: `${DEFAULT_DOC_URL}#permission-error`
+      doc_url: `${DEFAULT_DOC_URL}#insufficient_permissions`
     });
     super(statusCode, resolved);
     this.name = "CStarPermissionError";
@@ -109,7 +109,7 @@ var CStarConflictErrorImpl = class extends CStarErrorImpl {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.CONFLICT_ERROR,
       code: "conflict",
-      doc_url: `${DEFAULT_DOC_URL}#conflict-error`
+      doc_url: `${DEFAULT_DOC_URL}#resource_conflict`
     });
     super(statusCode, resolved);
     this.name = "CStarConflictError";
@@ -120,7 +120,7 @@ var CStarServerErrorImpl = class extends CStarErrorImpl {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.SERVER_ERROR,
       code: "server_error",
-      doc_url: `${DEFAULT_DOC_URL}#server-error`
+      doc_url: `${DEFAULT_DOC_URL}#server-errors`
     });
     super(statusCode, resolved);
     this.name = "CStarServerError";
@@ -131,7 +131,7 @@ var CStarFeatureDisabledErrorImpl = class extends CStarErrorImpl {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.FEATURE_NOT_CONFIGURED,
       code: "feature_not_configured",
-      doc_url: `${DEFAULT_DOC_URL}#feature-not-configured`
+      doc_url: `${DEFAULT_DOC_URL}#feature_disabled`
     });
     super(statusCode, resolved);
     this.name = "CStarFeatureDisabledError";
@@ -141,12 +141,12 @@ var CStarFeatureDisabledErrorImpl = class extends CStarErrorImpl {
 };
 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";
+    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://www.cstar.help/developers/sdk/js/realtime#ssr";
     super(0, {
       type: ErrorType.API_ERROR,
       code: "realtime_unavailable",
       message: resolved,
-      doc_url: "https://cstar.help/developers/sdk/realtime#ssr"
+      doc_url: "https://www.cstar.help/developers/sdk/js/realtime#ssr"
     });
     this.name = "CStarRealtimeUnavailableError";
   }
@@ -253,7 +253,10 @@ function parseError(statusCode, body, retryAfter) {
     doc_url: DEFAULT_DOC_URL
   };
   if (statusCode === 429) {
-    return new CStarRateLimitError(statusCode, errorBody, retryAfter ?? 60);
+    return new CStarRateLimitError(statusCode, errorBody, retryAfter);
+  }
+  if (errorBody.code === "feature_disabled") {
+    return new CStarFeatureDisabledError(statusCode, errorBody);
   }
   const StatusCls = STATUS_TO_CLASS[statusCode];
   if (StatusCls) {

package/dist/chat/index.d.cts

@@ -303,7 +303,7 @@ declare class ChatClientNetworkError extends ChatClientError {
  * // HMAC mode
  * const chat = new ChatClient({ teamSlug: 'acme' });
  * await chat.identify(
- *   { externalId: 'usr_123', email: 'jane@co.com', name: 'Jane', timestamp: Date.now() / 1000 },
+ *   { externalId: 'user_123', email: 'jane@co.com', name: 'Jane', timestamp: Date.now() / 1000 },
  *   'hmac_signature_hex'
  * );
  *

package/dist/chat/index.d.ts

@@ -303,7 +303,7 @@ declare class ChatClientNetworkError extends ChatClientError {
  * // HMAC mode
  * const chat = new ChatClient({ teamSlug: 'acme' });
  * await chat.identify(
- *   { externalId: 'usr_123', email: 'jane@co.com', name: 'Jane', timestamp: Date.now() / 1000 },
+ *   { externalId: 'user_123', email: 'jane@co.com', name: 'Jane', timestamp: Date.now() / 1000 },
  *   'hmac_signature_hex'
  * );
  *

package/dist/community/index.cjs

@@ -49,7 +49,7 @@ var ErrorType = {
   API_ERROR: "api_error",
   SERVER_ERROR: "server_error"
 };
-var DEFAULT_DOC_URL = "https://cstar.help/developers/api/errors";
+var DEFAULT_DOC_URL = "https://www.cstar.help/developers/errors";
 function normalizeArgs(messageOrStatus, maybeBody, defaults) {
   if (typeof messageOrStatus === "string") {
     return {
@@ -92,7 +92,7 @@ var CStarAuthenticationErrorImpl = class extends CStarErrorImpl {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.AUTHENTICATION_ERROR,
       code: "authentication_failed",
-      doc_url: `${DEFAULT_DOC_URL}#authentication-error`
+      doc_url: `${DEFAULT_DOC_URL}#authentication-errors`
     });
     super(statusCode, resolved);
     this.name = "CStarAuthenticationError";
@@ -103,11 +103,11 @@ var CStarRateLimitErrorImpl = class extends CStarErrorImpl {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.RATE_LIMIT_ERROR,
       code: "rate_limit_exceeded",
-      doc_url: `${DEFAULT_DOC_URL}#rate-limit-error`
+      doc_url: `${DEFAULT_DOC_URL}#rate_limit_exceeded`
     });
     super(statusCode === 0 ? 429 : statusCode, resolved);
     this.name = "CStarRateLimitError";
-    this.retryAfter = retryAfter ?? 60;
+    this.retryAfter = retryAfter;
   }
 };
 var CStarNotFoundErrorImpl = class extends CStarErrorImpl {
@@ -115,7 +115,7 @@ var CStarNotFoundErrorImpl = class extends CStarErrorImpl {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.NOT_FOUND_ERROR,
       code: "resource_not_found",
-      doc_url: `${DEFAULT_DOC_URL}#not-found-error`
+      doc_url: `${DEFAULT_DOC_URL}#resource_not_found`
     });
     super(statusCode, resolved);
     this.name = "CStarNotFoundError";
@@ -126,7 +126,7 @@ var CStarValidationErrorImpl = class extends CStarErrorImpl {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.INVALID_REQUEST_ERROR,
       code: "validation_error",
-      doc_url: `${DEFAULT_DOC_URL}#validation-error`
+      doc_url: `${DEFAULT_DOC_URL}#invalid-request-errors`
     });
     super(statusCode, resolved);
     this.name = "CStarValidationError";
@@ -137,7 +137,7 @@ var CStarPermissionErrorImpl = class extends CStarErrorImpl {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.PERMISSION_ERROR,
       code: "permission_denied",
-      doc_url: `${DEFAULT_DOC_URL}#permission-error`
+      doc_url: `${DEFAULT_DOC_URL}#insufficient_permissions`
     });
     super(statusCode, resolved);
     this.name = "CStarPermissionError";
@@ -148,7 +148,7 @@ var CStarConflictErrorImpl = class extends CStarErrorImpl {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.CONFLICT_ERROR,
       code: "conflict",
-      doc_url: `${DEFAULT_DOC_URL}#conflict-error`
+      doc_url: `${DEFAULT_DOC_URL}#resource_conflict`
     });
     super(statusCode, resolved);
     this.name = "CStarConflictError";
@@ -159,7 +159,7 @@ var CStarServerErrorImpl = class extends CStarErrorImpl {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.SERVER_ERROR,
       code: "server_error",
-      doc_url: `${DEFAULT_DOC_URL}#server-error`
+      doc_url: `${DEFAULT_DOC_URL}#server-errors`
     });
     super(statusCode, resolved);
     this.name = "CStarServerError";
@@ -170,7 +170,7 @@ var CStarFeatureDisabledErrorImpl = class extends CStarErrorImpl {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.FEATURE_NOT_CONFIGURED,
       code: "feature_not_configured",
-      doc_url: `${DEFAULT_DOC_URL}#feature-not-configured`
+      doc_url: `${DEFAULT_DOC_URL}#feature_disabled`
     });
     super(statusCode, resolved);
     this.name = "CStarFeatureDisabledError";
@@ -180,12 +180,12 @@ var CStarFeatureDisabledErrorImpl = class extends CStarErrorImpl {
 };
 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";
+    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://www.cstar.help/developers/sdk/js/realtime#ssr";
     super(0, {
       type: ErrorType.API_ERROR,
       code: "realtime_unavailable",
       message: resolved,
-      doc_url: "https://cstar.help/developers/sdk/realtime#ssr"
+      doc_url: "https://www.cstar.help/developers/sdk/js/realtime#ssr"
     });
     this.name = "CStarRealtimeUnavailableError";
   }
@@ -292,7 +292,10 @@ function parseError(statusCode, body, retryAfter) {
     doc_url: DEFAULT_DOC_URL
   };
   if (statusCode === 429) {
-    return new CStarRateLimitError(statusCode, errorBody, retryAfter ?? 60);
+    return new CStarRateLimitError(statusCode, errorBody, retryAfter);
+  }
+  if (errorBody.code === "feature_disabled") {
+    return new CStarFeatureDisabledError(statusCode, errorBody);
   }
   const StatusCls = STATUS_TO_CLASS[statusCode];
   if (StatusCls) {

package/dist/community/index.d.cts

@@ -1,6 +1,6 @@
 import { h as CommunityConfig, i as CommunityTopic, j as CommunityPostListParams, k as CommunityPost, l as CommunityPostDetail, m as CommunitySearchResult, C as CommunityCreatePostParams, a as CommunityCreatedPost, b as CommunityUpdatePostParams, c as CommunityUpdateCommentParams, d as CommunityCreatedComment, e as CommunityVoteResult, f as CommunityCreateCommentParams, g as CommunityFollowResult } from '../types-BHCahwev.cjs';
 export { n as CommunityComment } from '../types-BHCahwev.cjs';
-export { A as ApiErrorBody, C as CStarAuthenticationError, a as CStarConflictError, b as CStarError, c as CStarFeatureDisabledError, d as CStarNotFoundError, e as CStarPermissionError, f as CStarRateLimitError, g as CStarRealtimeUnavailableError, h as CStarServerError, i as CStarValidationError, E as ErrorType, p as parseError, j as parsePublicError } from '../errors-bW8CwTn4.cjs';
+export { A as ApiErrorBody, C as CStarAuthenticationError, a as CStarConflictError, b as CStarError, c as CStarFeatureDisabledError, d as CStarNotFoundError, e as CStarPermissionError, f as CStarRateLimitError, g as CStarRealtimeUnavailableError, h as CStarServerError, i as CStarValidationError, E as ErrorType, p as parseError, j as parsePublicError } from '../errors-BnUUTVlT.cjs';
 
 /**
  * Public community client. No authentication required.

package/dist/community/index.d.ts

@@ -1,6 +1,6 @@
 import { h as CommunityConfig, i as CommunityTopic, j as CommunityPostListParams, k as CommunityPost, l as CommunityPostDetail, m as CommunitySearchResult, C as CommunityCreatePostParams, a as CommunityCreatedPost, b as CommunityUpdatePostParams, c as CommunityUpdateCommentParams, d as CommunityCreatedComment, e as CommunityVoteResult, f as CommunityCreateCommentParams, g as CommunityFollowResult } from '../types-BHCahwev.js';
 export { n as CommunityComment } from '../types-BHCahwev.js';
-export { A as ApiErrorBody, C as CStarAuthenticationError, a as CStarConflictError, b as CStarError, c as CStarFeatureDisabledError, d as CStarNotFoundError, e as CStarPermissionError, f as CStarRateLimitError, g as CStarRealtimeUnavailableError, h as CStarServerError, i as CStarValidationError, E as ErrorType, p as parseError, j as parsePublicError } from '../errors-bW8CwTn4.js';
+export { A as ApiErrorBody, C as CStarAuthenticationError, a as CStarConflictError, b as CStarError, c as CStarFeatureDisabledError, d as CStarNotFoundError, e as CStarPermissionError, f as CStarRateLimitError, g as CStarRealtimeUnavailableError, h as CStarServerError, i as CStarValidationError, E as ErrorType, p as parseError, j as parsePublicError } from '../errors-BnUUTVlT.js';
 
 /**
  * Public community client. No authentication required.

package/dist/community/index.js

@@ -10,7 +10,7 @@ var ErrorType = {
   API_ERROR: "api_error",
   SERVER_ERROR: "server_error"
 };
-var DEFAULT_DOC_URL = "https://cstar.help/developers/api/errors";
+var DEFAULT_DOC_URL = "https://www.cstar.help/developers/errors";
 function normalizeArgs(messageOrStatus, maybeBody, defaults) {
   if (typeof messageOrStatus === "string") {
     return {
@@ -53,7 +53,7 @@ var CStarAuthenticationErrorImpl = class extends CStarErrorImpl {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.AUTHENTICATION_ERROR,
       code: "authentication_failed",
-      doc_url: `${DEFAULT_DOC_URL}#authentication-error`
+      doc_url: `${DEFAULT_DOC_URL}#authentication-errors`
     });
     super(statusCode, resolved);
     this.name = "CStarAuthenticationError";
@@ -64,11 +64,11 @@ var CStarRateLimitErrorImpl = class extends CStarErrorImpl {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.RATE_LIMIT_ERROR,
       code: "rate_limit_exceeded",
-      doc_url: `${DEFAULT_DOC_URL}#rate-limit-error`
+      doc_url: `${DEFAULT_DOC_URL}#rate_limit_exceeded`
     });
     super(statusCode === 0 ? 429 : statusCode, resolved);
     this.name = "CStarRateLimitError";
-    this.retryAfter = retryAfter ?? 60;
+    this.retryAfter = retryAfter;
   }
 };
 var CStarNotFoundErrorImpl = class extends CStarErrorImpl {
@@ -76,7 +76,7 @@ var CStarNotFoundErrorImpl = class extends CStarErrorImpl {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.NOT_FOUND_ERROR,
       code: "resource_not_found",
-      doc_url: `${DEFAULT_DOC_URL}#not-found-error`
+      doc_url: `${DEFAULT_DOC_URL}#resource_not_found`
     });
     super(statusCode, resolved);
     this.name = "CStarNotFoundError";
@@ -87,7 +87,7 @@ var CStarValidationErrorImpl = class extends CStarErrorImpl {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.INVALID_REQUEST_ERROR,
       code: "validation_error",
-      doc_url: `${DEFAULT_DOC_URL}#validation-error`
+      doc_url: `${DEFAULT_DOC_URL}#invalid-request-errors`
     });
     super(statusCode, resolved);
     this.name = "CStarValidationError";
@@ -98,7 +98,7 @@ var CStarPermissionErrorImpl = class extends CStarErrorImpl {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.PERMISSION_ERROR,
       code: "permission_denied",
-      doc_url: `${DEFAULT_DOC_URL}#permission-error`
+      doc_url: `${DEFAULT_DOC_URL}#insufficient_permissions`
     });
     super(statusCode, resolved);
     this.name = "CStarPermissionError";
@@ -109,7 +109,7 @@ var CStarConflictErrorImpl = class extends CStarErrorImpl {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.CONFLICT_ERROR,
       code: "conflict",
-      doc_url: `${DEFAULT_DOC_URL}#conflict-error`
+      doc_url: `${DEFAULT_DOC_URL}#resource_conflict`
     });
     super(statusCode, resolved);
     this.name = "CStarConflictError";
@@ -120,7 +120,7 @@ var CStarServerErrorImpl = class extends CStarErrorImpl {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.SERVER_ERROR,
       code: "server_error",
-      doc_url: `${DEFAULT_DOC_URL}#server-error`
+      doc_url: `${DEFAULT_DOC_URL}#server-errors`
     });
     super(statusCode, resolved);
     this.name = "CStarServerError";
@@ -131,7 +131,7 @@ var CStarFeatureDisabledErrorImpl = class extends CStarErrorImpl {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.FEATURE_NOT_CONFIGURED,
       code: "feature_not_configured",
-      doc_url: `${DEFAULT_DOC_URL}#feature-not-configured`
+      doc_url: `${DEFAULT_DOC_URL}#feature_disabled`
     });
     super(statusCode, resolved);
     this.name = "CStarFeatureDisabledError";
@@ -141,12 +141,12 @@ var CStarFeatureDisabledErrorImpl = class extends CStarErrorImpl {
 };
 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";
+    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://www.cstar.help/developers/sdk/js/realtime#ssr";
     super(0, {
       type: ErrorType.API_ERROR,
       code: "realtime_unavailable",
       message: resolved,
-      doc_url: "https://cstar.help/developers/sdk/realtime#ssr"
+      doc_url: "https://www.cstar.help/developers/sdk/js/realtime#ssr"
     });
     this.name = "CStarRealtimeUnavailableError";
   }
@@ -253,7 +253,10 @@ function parseError(statusCode, body, retryAfter) {
     doc_url: DEFAULT_DOC_URL
   };
   if (statusCode === 429) {
-    return new CStarRateLimitError(statusCode, errorBody, retryAfter ?? 60);
+    return new CStarRateLimitError(statusCode, errorBody, retryAfter);
+  }
+  if (errorBody.code === "feature_disabled") {
+    return new CStarFeatureDisabledError(statusCode, errorBody);
   }
   const StatusCls = STATUS_TO_CLASS[statusCode];
   if (StatusCls) {

package/dist/{errors-bW8CwTn4.d.cts → errors-BnUUTVlT.d.cts}

@@ -57,7 +57,8 @@ declare class CStarAuthenticationErrorImpl extends CStarErrorImpl {
     constructor(messageOrStatus: string | number, body?: ApiErrorBody);
 }
 declare class CStarRateLimitErrorImpl extends CStarErrorImpl {
-    readonly retryAfter: number;
+    /** Seconds to wait, from the response's Retry-After; undefined when it gave none. */
+    readonly retryAfter: number | undefined;
     constructor(messageOrStatus: string | number, body?: ApiErrorBody, retryAfter?: number);
 }
 declare class CStarNotFoundErrorImpl extends CStarErrorImpl {

package/dist/{errors-bW8CwTn4.d.ts → errors-BnUUTVlT.d.ts}

@@ -57,7 +57,8 @@ declare class CStarAuthenticationErrorImpl extends CStarErrorImpl {
     constructor(messageOrStatus: string | number, body?: ApiErrorBody);
 }
 declare class CStarRateLimitErrorImpl extends CStarErrorImpl {
-    readonly retryAfter: number;
+    /** Seconds to wait, from the response's Retry-After; undefined when it gave none. */
+    readonly retryAfter: number | undefined;
     constructor(messageOrStatus: string | number, body?: ApiErrorBody, retryAfter?: number);
 }
 declare class CStarNotFoundErrorImpl extends CStarErrorImpl {