@curviate/sdk 0.31.0 → 0.33.0

package/dist/index.js

@@ -55,10 +55,11 @@ var ERROR_CODES = [
   "PLATFORM_RATE_LIMIT",
   // Curviate's OWN account-safety ceiling, not a request-rate limit and not
   // LinkedIn refusing. A 429 that never reached LinkedIn and spent nothing:
-  // the budget row named by `budgetRow` is at the ceiling configured on
-  // `PATCH /v1/{account_id}/safety-policy`, or the account is outside its
-  // activity window. Deliberately absent from RETRYABLE_CODES: a monthly
-  // row's reset can be weeks out, so backing off is the wrong recovery.
+  // the budget row named by `budgetRow` is at its ceiling, set by the account's
+  // safety policy or else the tenant default (`GET`/`PATCH /v1/safety-policy`),
+  // or the account is outside its activity window. Deliberately absent from
+  // RETRYABLE_CODES: a monthly row's reset can be weeks out, so backing off
+  // is the wrong recovery.
   // Read `resetAt`, `safetyReason` and `safetyHint` instead.
   "BUDGET_EXHAUSTED",
   // Platform errors
@@ -511,6 +512,28 @@ var AccountsResource = class {
       ...params !== void 0 ? { query: params } : {}
     });
   }
+  /**
+   * List the workspace's live seats: each `seat_id`, whether an account
+   * `occupied` it, and that `account_id` (`null` when free). Not paginated.
+   *
+   * Only live seats are listed, and an empty seat is listed only when
+   * connecting an account to it would be accepted right now. So an empty seat
+   * that is provisional, cancelling, on an ended trial, or blocked by billing
+   * does not appear, and `items` can be `[]` even though the workspace has
+   * seats. Any seat with `occupied: false` is a valid `seat_id` for connecting
+   * a new account with `auth.intent`. Carries no billing fields.
+   *
+   * @returns `{ object: "seat_list", items: { seat_id, occupied, account_id }[] }`.
+   *
+   * @example
+   * const { items } = await curviate.accounts.listSeats();
+   * const free = items.find((seat) => !seat.occupied);
+   * if (!free) throw new Error("No seat is free to connect to right now (add a seat, or check billing).");
+   * await curviate.auth.intent({ seat_id: free.seat_id, auth_method: "cookie", cookie: { li_at }, user_agent });
+   */
+  listSeats() {
+    return this.ctx.request({ method: "GET", path: "/v1/accounts/seats" });
+  }
   /**
    * Return metadata and current state for one connected account, including the
    * central `quotas[]` account-safety view, `account_states[]` and `seat_id`
@@ -587,7 +610,8 @@ var AuthResource = class {
   /**
    * Authenticate a LinkedIn account with credentials or a session cookie.
    *
-   * Omit `account_id` to connect a NEW account into an empty seat; include it
+   * Omit `account_id` to connect a NEW account into an empty seat (find one
+   * with `accounts.listSeats()`: any seat with `occupied: false`); include it
    * to re-authenticate an EXISTING account in place. Returns the account on
    * success (200 re-authenticated in place / 201 new), or a checkpoint
    * challenge (202) when LinkedIn requires verification; resolve it with
@@ -761,6 +785,19 @@ var MessagingResource = class {
   /**
    * List messages in a chat, cursor-paginated.
    * `GET /v1/{account_id}/chats/{chat_id}/messages`
+   *
+   * An InMail thread's subject line arrives on a MESSAGE, as
+   * `message.specifics.subject`, carried by the thread's opening message. The
+   * chat object has no subject of its own, and `chat.name` is the counterpart's
+   * display name rather than a folded-in subject, so read the subject from the
+   * first message rather than from the chat. Ordinary (non-InMail) messages
+   * return `specifics: {}`.
+   *
+   * A CHAT READ CARRIES NO SUBJECT AT ALL, including on its embedded
+   * `last_message`: the preview is deliberately narrower than a message read, so
+   * that a chat read returns the same fields whether it was answered from
+   * LinkedIn or from Curviate's stored copy. Getting a subject means reading the
+   * chat's messages.
    */
   listMessages(chatId, params) {
     return this.ctx.request({
@@ -807,6 +844,11 @@ var MessagingResource = class {
   /**
    * Get a single message by ID, re-homed under its chat.
    * `GET /v1/{account_id}/chats/{chat_id}/messages/{message_id}`
+   *
+   * `specifics` carries the InMail subject when the platform set one on this
+   * message (`specifics.subject`), and is `{}` otherwise. It is narrowed to
+   * that one field on purpose: the platform's other `specifics` keys are not
+   * part of the published surface.
    */
   getMessage(chatId, messageId) {
     return this.ctx.request({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@curviate/sdk",
-  "version": "0.31.0",
+  "version": "0.33.0",
   "private": false,
   "description": "TypeScript SDK for the Curviate API.",
   "license": "MIT",