@cstar.help/js 0.18.1 → 0.18.4

package/dist/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";
   }
@@ -222,7 +222,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) {
@@ -237,7 +240,7 @@ function parseError(statusCode, body, retryAfter) {
 }
 
 // src/client.ts
-var SDK_VERSION = "0.18.1";
+var SDK_VERSION = "0.18.4";
 var DEFAULT_BASE_URL = "https://www.cstar.help";
 var DEFAULT_API_VERSION = "2026-03-01";
 var DEFAULT_MAX_RETRIES = 3;
@@ -257,7 +260,7 @@ var HttpClient = class {
     this.lastMeta = { requestId: null, timestamp: null, pagination: null };
     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_...). Publishable keys (pk_...) cannot read team endpoints; use them with LibraryClient or CommunityClient. See https://cstar.help/developers/quickstart"
+        "[cStar] CStarClient: apiKey is required. Pass a secret key (sk_live_... / sk_test_...). Publishable keys (pk_...) cannot read team endpoints; use them with LibraryClient or CommunityClient. See https://www.cstar.help/developers/quickstart"
       );
     }
     if (typeof config.teamId !== "string" || config.teamId.length === 0) {
@@ -320,7 +323,7 @@ var HttpClient = class {
     let inProgressWaitMs = null;
     for (let attempt = 0; attempt <= this.config.maxRetries; attempt++) {
       if (attempt > 0 && lastError) {
-        const delay = inProgressWaitMs ?? (lastError instanceof CStarRateLimitError ? Math.min(lastError.retryAfter * 1e3, RATE_LIMIT_RETRY_CAP_MS) : this.getBackoffDelay(attempt));
+        const delay = inProgressWaitMs ?? (lastError instanceof CStarRateLimitError ? Math.min((lastError.retryAfter ?? 1) * 1e3, RATE_LIMIT_RETRY_CAP_MS) : this.getBackoffDelay(attempt));
         inProgressWaitMs = null;
         await this.sleep(delay);
       }
@@ -338,7 +341,7 @@ var HttpClient = class {
           type: "connection_error",
           code: "network_error",
           message: `Network request failed: ${networkErr.message}`,
-          doc_url: "https://www.cstar.help/developers/errors#connection-errors"
+          doc_url: "https://www.cstar.help/developers/errors#network_error"
         });
         if (canRetryAmbiguousFailure && attempt < this.config.maxRetries) continue;
         throw lastError;
@@ -374,7 +377,8 @@ var HttpClient = class {
       }
       if (response.status === 429) {
         lastError = parseError(429, errorBody, retryAfter);
-        if (attempt < this.config.maxRetries) continue;
+        const worthWaiting = retryAfter !== void 0 && retryAfter * 1e3 <= RATE_LIMIT_RETRY_CAP_MS;
+        if (worthWaiting && attempt < this.config.maxRetries) continue;
         throw lastError;
       }
       lastError = parseError(response.status, errorBody);
@@ -1211,6 +1215,15 @@ var WebhooksResource = class extends BaseResource {
   constructor(client) {
     super(client, "/webhooks");
   }
+  /**
+   * Create a webhook endpoint. Its answer carries the signing secret, so the
+   * API keeps it out of the Idempotency-Key cache: an `idempotencyKey` is
+   * not sent, and a network error or 5xx is not retried, since the webhook
+   * may already exist. List webhooks before creating it again.
+   */
+  async create(params, _options) {
+    return this.client.request("POST", this.basePath, { body: params });
+  }
   /** Send a test delivery to a webhook endpoint. */
   async test(webhookId, params) {
     return this.client.request(
@@ -1245,11 +1258,14 @@ var WebhooksResource = class extends BaseResource {
   async unsubscribe(subscriptionId) {
     await this.client.request("DELETE", `/webhooks/subscribe/${subscriptionId}`);
   }
-  /** Register a CLI listener (returns listenerId and signing secret). */
-  async listen(params, options) {
+  /**
+   * Register a CLI listener (returns listenerId and signing secret). The API
+   * ignores Idempotency-Key here (the answer is a secret), so an
+   * `idempotencyKey` is not sent and a network error or 5xx is not retried.
+   */
+  async listen(params, _options) {
     return this.client.request("POST", "/webhooks/listen", {
-      body: params,
-      idempotencyKey: options?.idempotencyKey
+      body: params
     });
   }
   /** Deregister a CLI listener. */
@@ -1659,11 +1675,15 @@ var AttachmentsResource = class {
       params?.bucket ? { query: { bucket: params.bucket } } : void 0
     );
   }
-  /** Delete an attachment. */
-  async del(attachmentId) {
+  /**
+   * Delete a stored file. Pass `storagePath` and `bucket` from `list()`, as
+   * for `get()`. A path with no file in that bucket is a 404.
+   */
+  async del(storagePath, params) {
     return this.client.request(
       "DELETE",
-      `/attachments/${attachmentId}`
+      `/attachments/${storagePath}`,
+      params?.bucket ? { query: { bucket: params.bucket } } : void 0
     );
   }
 };
@@ -1837,10 +1857,9 @@ var ExportResource = class {
   constructor(client) {
     this.client = client;
   }
-  async create(params, options) {
+  async create(params, _options) {
     return this.client.request("POST", "/export", {
       body: params,
-      idempotencyKey: options?.idempotencyKey,
       responseType: params.format === "csv" ? "text" : "json"
     });
   }
@@ -2056,7 +2075,10 @@ var GameActivityResource = class {
       query: params ? { ...params } : void 0
     });
   }
-  /** Get activity for a specific member. */
+  /**
+   * Get activity for a specific member. `memberId` is the player's user id:
+   * the `memberId` game responses return, and `userId` on `members.list()`.
+   */
   async forMember(memberId, params) {
     return this.client.request("GET", `/game/activity/member/${memberId}`, {
       query: params ? { ...params } : void 0
@@ -2245,7 +2267,10 @@ var GameResource = class {
       query: params ? { ...params } : void 0
     });
   }
-  /** Get a specific player's stats by membership ID. */
+  /**
+   * Get a specific player's stats. `memberId` is the player's user id: the
+   * `memberId` game responses return, and `userId` on `members.list()`.
+   */
   async getPlayer(memberId) {
     return this.client.request("GET", `/game/player/${memberId}`);
   }
@@ -2534,9 +2559,9 @@ var OfflineQueue = class {
 // src/types/generated/webhookEvents.ts
 var WEBHOOK_EVENT_SAMPLES = {
   "agent.preferences_updated": {
-    "team_id": "team_01H8X9YZ7E0J3K4M5N6U",
-    "member_id": "mem_01H8X9YZ7E0J3K4M5N6U",
-    "agent_id": "agt_01H8X9YZ7E0J3K4M5N6U",
+    "team_id": "550e8400-e29b-41d4-a716-446655440000",
+    "member_id": "550e8400-e29b-41d4-a716-446655440010",
+    "agent_id": "550e8400-e29b-41d4-a716-446655440001",
     "changed": [
       "boringMode"
     ],
@@ -2546,143 +2571,197 @@ var WEBHOOK_EVENT_SAMPLES = {
   },
   "article.created": {
     "article": {
-      "id": "art_01H8X9YZ7E0J3K4M5N6U",
+      "id": "art_Yb3kQ9mT2pLx",
       "title": "How to reset your password",
       "slug": "how-to-reset-your-password",
+      "status": "draft",
       "is_public": false,
-      "created_at": "2026-04-27T18:42:11.000Z"
+      "published_at": "2026-04-27T19:00:00.000Z",
+      "created_at": "2026-04-27T18:42:11.000Z",
+      "updated_at": "2026-04-27T19:00:00.000Z"
     }
   },
   "article.deleted": {
-    "id": "art_01H8X9YZ7E0J3K4M5N6U"
+    "id": "art_Yb3kQ9mT2pLx"
   },
   "article.published": {
     "article": {
-      "id": "art_01H8X9YZ7E0J3K4M5N6U",
+      "id": "art_Yb3kQ9mT2pLx",
       "title": "How to reset your password",
       "slug": "how-to-reset-your-password",
+      "status": "published",
       "is_public": true,
-      "published_at": "2026-04-27T19:00:00.000Z"
+      "published_at": "2026-04-27T19:00:00.000Z",
+      "created_at": "2026-04-27T18:42:11.000Z",
+      "updated_at": "2026-04-27T19:00:00.000Z"
     }
   },
   "article.updated": {
     "article": {
-      "id": "art_01H8X9YZ7E0J3K4M5N6U",
+      "id": "art_Yb3kQ9mT2pLx",
       "title": "How to reset your password (updated)",
       "slug": "how-to-reset-your-password",
-      "is_public": true
+      "status": "published",
+      "is_public": true,
+      "published_at": "2026-04-27T19:00:00.000Z",
+      "created_at": "2026-04-27T18:42:11.000Z",
+      "updated_at": "2026-04-27T19:00:00.000Z"
+    },
+    "changes": {
+      "title": {
+        "from": "How to reset your password",
+        "to": "How to reset your password (updated)"
+      },
+      "slug": {
+        "from": "reset-password",
+        "to": "how-to-reset-your-password"
+      },
+      "status": {
+        "from": "draft",
+        "to": "published"
+      },
+      "is_public": {
+        "from": false,
+        "to": true
+      }
     }
   },
   "boss.damaged": {
     "boss": {
-      "id": "boss_thunder_drake",
+      "name": "The Thunder Drake",
       "current_hp": 740
     },
     "damage": 120,
+    "defeated": false,
     "by": {
-      "agent_id": "usr_01H8X9YZ7E0J3K4M5N6S",
-      "name": "Riley"
+      "agent_id": "550e8400-e29b-41d4-a716-446655440001"
     }
   },
   "boss.defeated": {
     "boss": {
-      "id": "boss_thunder_drake",
-      "name": "The Thunder Drake"
+      "name": "The Thunder Drake",
+      "level": 4
     },
     "final_blow_by": {
-      "agent_id": "usr_01H8X9YZ7E0J3K4M5N6S",
+      "agent_id": "550e8400-e29b-41d4-a716-446655440001",
       "name": "Riley"
-    },
-    "team_xp_awarded": 1500
+    }
   },
   "boss.spawned": {
     "boss": {
       "id": "boss_thunder_drake",
       "name": "The Thunder Drake",
       "level": 4,
+      "type": "dragon",
+      "difficulty": "hard",
       "max_hp": 1200
     }
   },
   "community_post.commented": {
+    "post": {
+      "id": "550e8400-e29b-41d4-a716-446655440040"
+    },
     "comment": {
-      "id": "cmt_01H8X9YZ7E0J3K4M5N6X",
-      "post_id": "post_01H8X9YZ7E0J3K4M5N6W",
-      "content": "I would love this. Bumping for visibility.",
-      "author_id": "cus_01H8X9YZ7E0J3K4M5N6Q",
+      "id": "550e8400-e29b-41d4-a716-446655440041",
+      "post_id": "550e8400-e29b-41d4-a716-446655440040",
+      "body": "I would love this. Bumping for visibility.",
+      "is_official": false,
+      "author_name": "Casey Patel",
       "created_at": "2026-04-27T18:55:02.000Z"
     }
   },
   "community_post.created": {
     "post": {
-      "id": "post_01H8X9YZ7E0J3K4M5N6W",
-      "prefixed_id": "IDEA-42",
+      "id": "550e8400-e29b-41d4-a716-446655440040",
       "title": "Add Slack-style threading to tickets",
       "status": "open",
       "visibility": "public",
-      "topic": "feature-requests",
       "created_at": "2026-04-27T18:42:11.000Z"
     }
   },
   "community_post.deleted": {
     "post": {
-      "id": "post_01H8X9YZ7E0J3K4M5N6W",
-      "prefixed_id": "IDEA-42",
+      "id": "550e8400-e29b-41d4-a716-446655440040",
       "title": "Add Slack-style threading to tickets"
     }
   },
   "community_post.status_changed": {
     "post": {
-      "id": "post_01H8X9YZ7E0J3K4M5N6W",
+      "id": "550e8400-e29b-41d4-a716-446655440040",
       "title": "Add Slack-style threading to tickets",
       "status": "planned",
-      "visibility": "public"
-    }
+      "visibility": "public",
+      "created_at": "2026-04-27T18:42:11.000Z"
+    },
+    "previous_status": "open"
   },
   "community_post.updated": {
     "post": {
-      "id": "post_01H8X9YZ7E0J3K4M5N6W",
+      "id": "550e8400-e29b-41d4-a716-446655440040",
       "title": "Add Slack-style threading to tickets (revised)",
       "status": "open",
-      "visibility": "public"
+      "visibility": "public",
+      "created_at": "2026-04-27T18:42:11.000Z"
     }
   },
   "community_post.voted": {
     "post": {
-      "id": "post_01H8X9YZ7E0J3K4M5N6W",
+      "id": "550e8400-e29b-41d4-a716-446655440040",
       "vote_count": 13
     },
     "voter": {
-      "id": "cus_01H8X9YZ7E0J3K4M5N6Q"
+      "id": "cus_no9EfYa0dg5O"
     },
     "direction": "up"
   },
   "customer.created": {
     "customer": {
-      "id": "cus_01H8X9YZ7E0J3K4M5N6Q",
+      "id": "cus_no9EfYa0dg5O",
       "name": "Casey Patel",
       "email": "casey@example.com",
       "status": "active",
+      "sentiment": "neutral",
       "tags": [
         "trial"
       ],
-      "created_at": "2026-04-27T18:42:11.000Z"
+      "created_at": "2026-04-27T18:42:11.000Z",
+      "updated_at": "2026-04-27T18:42:11.000Z"
     }
   },
   "customer.deleted": {
-    "id": "cus_01H8X9YZ7E0J3K4M5N6Q"
+    "id": "cus_no9EfYa0dg5O"
   },
   "customer.updated": {
     "customer": {
-      "id": "cus_01H8X9YZ7E0J3K4M5N6Q",
+      "id": "cus_no9EfYa0dg5O",
       "name": "Casey Patel",
       "email": "casey@example.com",
       "status": "active",
+      "sentiment": "neutral",
       "tags": [
         "trial",
         "paying"
-      ]
+      ],
+      "created_at": "2026-04-27T18:42:11.000Z",
+      "updated_at": "2026-04-27T18:42:11.000Z"
     },
     "changes": {
+      "name": {
+        "from": "Casey",
+        "to": "Casey Patel"
+      },
+      "email": {
+        "from": "casey@old.example.com",
+        "to": "casey@example.com"
+      },
+      "status": {
+        "from": "active",
+        "to": "inactive"
+      },
+      "sentiment": {
+        "from": "neutral",
+        "to": "happy"
+      },
       "tags": {
         "from": [
           "trial"
@@ -2695,51 +2774,59 @@ var WEBHOOK_EVENT_SAMPLES = {
     }
   },
   "customer_group.created": {
-    "group": {
-      "id": "grp_01H8X9YZ7E0J3K4M5N6T",
+    "customer_group": {
+      "id": "550e8400-e29b-41d4-a716-446655440030",
       "name": "Pro Plan",
-      "color": "indigo",
-      "member_count": 0
+      "slug": "pro-plan",
+      "description": "Customers on the Pro plan",
+      "customer_count": 0,
+      "created_at": "2026-04-27T18:42:11.000Z",
+      "updated_at": "2026-04-27T18:42:11.000Z"
     }
   },
   "customer_group.deleted": {
     "customer_group": {
-      "id": "grp_01H8X9YZ7E0J3K4M5N6T"
+      "id": "550e8400-e29b-41d4-a716-446655440030"
     }
   },
   "customer_group.updated": {
-    "group": {
-      "id": "grp_01H8X9YZ7E0J3K4M5N6T",
+    "customer_group": {
+      "id": "550e8400-e29b-41d4-a716-446655440030",
       "name": "Pro Plan (Annual)",
-      "color": "indigo",
-      "member_count": 38
+      "slug": "pro-plan",
+      "description": "Customers on the Pro plan",
+      "customer_count": 38,
+      "created_at": "2026-04-27T18:42:11.000Z",
+      "updated_at": "2026-04-27T18:42:11.000Z"
     }
   },
   "player.achievement_unlocked": {
     "player": {
-      "agent_id": "usr_01H8X9YZ7E0J3K4M5N6S",
+      "agent_id": "550e8400-e29b-41d4-a716-446655440001",
       "name": "Riley"
     },
     "achievement": {
       "id": "first_resolve",
       "name": "First Resolve",
+      "description": "Resolve your first ticket",
+      "rarity": "common",
       "xp": 50
     }
   },
   "player.level_up": {
     "player": {
-      "agent_id": "usr_01H8X9YZ7E0J3K4M5N6S",
+      "agent_id": "550e8400-e29b-41d4-a716-446655440001",
       "name": "Riley"
     },
     "level": {
       "from": 7,
       "to": 8
     },
-    "title_unlocked": "Apprentice Healer"
+    "total_xp": 4200
   },
   "player.quest_completed": {
     "player": {
-      "agent_id": "usr_01H8X9YZ7E0J3K4M5N6S",
+      "agent_id": "550e8400-e29b-41d4-a716-446655440001",
       "name": "Riley"
     },
     "quest": {
@@ -2750,7 +2837,7 @@ var WEBHOOK_EVENT_SAMPLES = {
   },
   "player.streak_milestone": {
     "player": {
-      "agent_id": "usr_01H8X9YZ7E0J3K4M5N6S",
+      "agent_id": "550e8400-e29b-41d4-a716-446655440001",
       "name": "Riley"
     },
     "streak_days": 5,
@@ -2758,51 +2845,56 @@ var WEBHOOK_EVENT_SAMPLES = {
   },
   "player.xp_gained": {
     "player": {
-      "agent_id": "usr_01H8X9YZ7E0J3K4M5N6S",
+      "agent_id": "550e8400-e29b-41d4-a716-446655440001",
       "name": "Riley"
     },
     "amount": 75,
     "reason": "ticket.resolved",
-    "ticket_id": "tkt_01H8X9YZ7E0J3K4M5N6P"
+    "ticket_id": "tkt_UR8A3OR3Vshq"
   },
   "social.high_five_sent": {
+    "id": "550e8400-e29b-41d4-a716-446655440051",
     "from_team": {
-      "id": "team_acme",
+      "id": "550e8400-e29b-41d4-a716-446655440000",
       "name": "Acme Support"
     },
     "to_team": {
-      "id": "team_globex",
+      "id": "550e8400-e29b-41d4-a716-446655440003",
       "name": "Globex Support"
     },
-    "message": "Thanks for the assist!"
+    "sent_by": {
+      "agent_id": "550e8400-e29b-41d4-a716-446655440001",
+      "name": "Riley"
+    },
+    "message": "Thanks for the assist!",
+    "created_at": "2026-04-27T18:55:02.000Z"
   },
   "social.one_up_sent": {
+    "id": "550e8400-e29b-41d4-a716-446655440050",
     "from": {
-      "agent_id": "usr_01H8X9YZ7E0J3K4M5N6S",
+      "agent_id": "550e8400-e29b-41d4-a716-446655440001",
       "name": "Riley"
     },
     "to": {
-      "agent_id": "usr_01H8X9YZ7E0J3K4M5N6V",
+      "agent_id": "550e8400-e29b-41d4-a716-446655440002",
       "name": "Sam"
     },
-    "ticket_id": "tkt_01H8X9YZ7E0J3K4M5N6P",
-    "message": "Great empathy on this one"
+    "message": "Great empathy on this one",
+    "gold_amount": 0,
+    "created_at": "2026-04-27T18:55:02.000Z"
   },
   "survey.submitted": {
     "survey": {
-      "id": "svy_01H8X9YZ7E0J3K4M5N6Y",
-      "ticket_id": "tkt_01H8X9YZ7E0J3K4M5N6P",
-      "score": 5,
+      "id": "550e8400-e29b-41d4-a716-446655440060",
+      "ticket_id": "tkt_UR8A3OR3Vshq",
+      "rating": 5,
       "comment": "Resolved fast, thank you!",
+      "agent_id": "550e8400-e29b-41d4-a716-446655440001",
       "submitted_at": "2026-04-27T19:30:00.000Z"
-    },
-    "customer": {
-      "id": "cus_01H8X9YZ7E0J3K4M5N6Q",
-      "email": "casey@example.com"
     }
   },
   "team.preferences_updated": {
-    "team_id": "team_01H8X9YZ7E0J3K4M5N6U",
+    "team_id": "550e8400-e29b-41d4-a716-446655440000",
     "changed": [
       "bossBattlesEnabled"
     ],
@@ -2812,91 +2904,159 @@ var WEBHOOK_EVENT_SAMPLES = {
   },
   "ticket.assigned": {
     "ticket": {
-      "id": "tkt_01H8X9YZ7E0J3K4M5N6P",
-      "prefixed_id": "CST-1024"
+      "id": "tkt_UR8A3OR3Vshq",
+      "title": "Cannot reset password",
+      "status": "open",
+      "priority": "normal",
+      "channel": "widget",
+      "tags": [
+        "billing"
+      ],
+      "customer_id": "cus_no9EfYa0dg5O",
+      "assigned_to": "550e8400-e29b-41d4-a716-446655440001",
+      "dashboard_url": "https://www.cstar.help/team/acme/tickets?selected=3d3c850d-b6ff-4117-9dea-87e8dc4ba108",
+      "created_at": "2026-04-27T18:42:11.000Z",
+      "updated_at": "2026-04-27T18:50:02.000Z"
     },
     "assignee": {
-      "id": "usr_01H8X9YZ7E0J3K4M5N6S",
+      "id": "550e8400-e29b-41d4-a716-446655440001",
       "name": "Riley",
       "email": "riley@acme.test"
     },
-    "previous_assignee": null
+    "previous_assignee": {
+      "id": "550e8400-e29b-41d4-a716-446655440002",
+      "name": "Sam",
+      "email": "sam@acme.test"
+    }
   },
   "ticket.closed": {
     "ticket": {
-      "id": "tkt_01H8X9YZ7E0J3K4M5N6P",
-      "prefixed_id": "CST-1024",
+      "id": "tkt_UR8A3OR3Vshq",
       "title": "Cannot reset password",
       "status": "closed",
       "priority": "normal",
-      "channel": "widget"
+      "channel": "widget",
+      "tags": [
+        "billing"
+      ],
+      "customer_id": "cus_no9EfYa0dg5O",
+      "assigned_to": "550e8400-e29b-41d4-a716-446655440001",
+      "dashboard_url": "https://www.cstar.help/team/acme/tickets?selected=3d3c850d-b6ff-4117-9dea-87e8dc4ba108",
+      "created_at": "2026-04-27T18:42:11.000Z",
+      "updated_at": "2026-04-27T18:50:02.000Z"
     },
     "changes": {
+      "title": {
+        "from": "Cannot reset password",
+        "to": "Password reset link expired"
+      },
       "status": {
         "from": "open",
         "to": "closed"
+      },
+      "priority": {
+        "from": "normal",
+        "to": "high"
+      },
+      "assigned_to": {
+        "from": "550e8400-e29b-41d4-a716-446655440002",
+        "to": "550e8400-e29b-41d4-a716-446655440001"
+      },
+      "tags": {
+        "from": [
+          "billing"
+        ],
+        "to": [
+          "billing",
+          "urgent"
+        ]
       }
     }
   },
   "ticket.created": {
     "ticket": {
-      "id": "tkt_01H8X9YZ7E0J3K4M5N6P",
-      "prefixed_id": "CST-1024",
+      "id": "tkt_UR8A3OR3Vshq",
       "title": "Cannot reset password",
       "status": "new",
       "priority": "normal",
       "channel": "widget",
-      "customer_id": "cus_01H8X9YZ7E0J3K4M5N6Q",
-      "created_at": "2026-04-27T18:42:11.000Z"
+      "tags": [
+        "billing"
+      ],
+      "customer_id": "cus_no9EfYa0dg5O",
+      "assigned_to": "550e8400-e29b-41d4-a716-446655440001",
+      "dashboard_url": "https://www.cstar.help/team/acme/tickets?selected=3d3c850d-b6ff-4117-9dea-87e8dc4ba108",
+      "created_at": "2026-04-27T18:42:11.000Z",
+      "updated_at": "2026-04-27T18:50:02.000Z"
     },
     "customer": {
-      "id": "cus_01H8X9YZ7E0J3K4M5N6Q",
+      "id": "cus_no9EfYa0dg5O",
       "name": "Casey Patel",
       "email": "casey@example.com"
     }
   },
   "ticket.deleted": {
-    "id": "CST-1024"
+    "id": "tkt_UR8A3OR3Vshq"
   },
   "ticket.message_added": {
     "ticket": {
-      "id": "tkt_01H8X9YZ7E0J3K4M5N6P",
-      "dashboard_url": "https://www.cstar.help/team/acme/tickets?selected=tkt_01H8X9YZ7E0J3K4M5N6P"
+      "id": "tkt_UR8A3OR3Vshq",
+      "dashboard_url": "https://www.cstar.help/team/acme/tickets?selected=3d3c850d-b6ff-4117-9dea-87e8dc4ba108"
     },
     "message": {
-      "id": "msg_01H8X9YZ7E0J3K4M5N6R",
+      "id": "msg_Hq2Lm8Xc4RtZ",
       "sender": "agent",
       "sender_name": "Riley",
+      "message_type": "public",
       "content": "I just sent a reset link to your inbox. Let me know if it lands.",
       "created_at": "2026-04-27T18:55:02.000Z"
     },
     "customer": {
-      "id": "cus_01H8X9YZ7E0J3K4M5N6Q",
+      "id": "cus_no9EfYa0dg5O",
       "name": "Casey Patel",
       "email": "casey@example.com"
     }
   },
   "ticket.updated": {
     "ticket": {
-      "id": "tkt_01H8X9YZ7E0J3K4M5N6P",
-      "prefixed_id": "CST-1024",
+      "id": "tkt_UR8A3OR3Vshq",
       "title": "Cannot reset password",
       "status": "open",
       "priority": "high",
-      "channel": "widget"
+      "channel": "widget",
+      "tags": [
+        "billing"
+      ],
+      "customer_id": "cus_no9EfYa0dg5O",
+      "assigned_to": "550e8400-e29b-41d4-a716-446655440001",
+      "dashboard_url": "https://www.cstar.help/team/acme/tickets?selected=3d3c850d-b6ff-4117-9dea-87e8dc4ba108",
+      "created_at": "2026-04-27T18:42:11.000Z",
+      "updated_at": "2026-04-27T18:50:02.000Z"
     },
     "changes": {
+      "title": {
+        "from": "Cannot reset password",
+        "to": "Password reset link expired"
+      },
+      "status": {
+        "from": "open",
+        "to": "pending"
+      },
       "priority": {
         "from": "normal",
         "to": "high"
       },
+      "assigned_to": {
+        "from": "550e8400-e29b-41d4-a716-446655440002",
+        "to": "550e8400-e29b-41d4-a716-446655440001"
+      },
       "tags": {
         "from": [
-          "bug"
+          "billing"
         ],
         "to": [
-          "bug",
-          "feature-request"
+          "billing",
+          "urgent"
         ]
       }
     }
@@ -2975,7 +3135,7 @@ var CStarClient = class {
     this.ai = new AiResource(this._httpClient);
     this.views = new ViewsResource(this._httpClient);
     this.billing = new BillingResource(this._httpClient);
-    this.realtime = new CStarRealtime(this._httpClient);
+    this.realtime = new CStarRealtime(this._httpClient, config.realtime);
     if (config.offline) {
       const queueOpts = typeof config.offline === "object" ? config.offline : void 0;
       this.offlineQueue = new OfflineQueue(this._httpClient, queueOpts);