@curviate/sdk 0.30.0 → 0.32.0

package/dist/index.js

@@ -49,31 +49,17 @@ var ERROR_CODES = [
   "NO_ACTIVE_SEAT",
   "LINKEDIN_FEATURE_NOT_SUBSCRIBED",
   "BETA_NOT_ENABLED",
-  /**
-   * @deprecated Replaced by {@link NO_ACTIVE_SEAT}. Product tiers are retired,
-   * so no refusal names one any more.
-   *
-   * STILL EXPORTED ON PURPOSE, and this is not a courtesy: API deployments
-   * that predate the seat-based entitlement rollout still emit this code, and
-   * a client that stopped recognising it would decode it to `INTERNAL`: a
-   * fixable billing refusal arriving as a server fault, against the very
-   * deployments most likely to send it. It is withdrawn in the first release
-   * after every deployment carries the new contract.
-   *
-   * Handle both while that is true: `NO_ACTIVE_SEAT` from a current
-   * deployment, this from an older one. They mean the same thing to a caller.
-   */
-  "TIER_NOT_ACTIVE",
   // Rate limits
   "RATE_LIMIT_ACCOUNT",
   "RATE_LIMIT_TENANT",
   "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
@@ -91,17 +77,6 @@ var ERROR_CODES = [
   "CHECKPOINT_ALREADY_RESOLVED",
   "CHECKPOINT_UNSUPPORTED",
   "CONNECTION_IN_PROGRESS",
-  /**
-   * @deprecated Withdrawn with no replacement. The one-premium conflict it
-   * reported cannot be expressed on the current input, because
-   * `linkedin_premium` is single-valued.
-   *
-   * STILL EXPORTED for the same reason as {@link TIER_NOT_ACTIVE}: deployments
-   * that predate the connect rework can still emit it, and dropping it early
-   * would turn a fixable refusal into `INTERNAL` on exactly those. Withdrawn
-   * in the first release after every deployment carries the new contract.
-   */
-  "PREMIUM_CONFLICT",
   // A reconnect whose seat-derived scope differs from the account's recorded
   // scope was attempted with cookie auth; a cookie replay cannot change
   // scope, so a full credentials re-authentication is required. user_fixable,
@@ -182,6 +157,14 @@ var ERROR_CODES = [
   // returned by `/v1` billing routes at nine sites; it was previously cited
   // in this file as a code that never reaches a caller, which was wrong.
   "ADMIN_BYPASS",
+  // Checkout refused closed (503): Curviate's own seat-price configuration
+  // disagrees with the price it displays, so completing checkout would charge
+  // an amount you were never shown. A misconfiguration on Curviate's side, not
+  // a mistake in the request and not a transient fault: user_fixable false,
+  // and a retry fails the same way until Curviate corrects the price. Nothing
+  // was charged. Stop and surface it to a human (or support) rather than
+  // backing off.
+  "STRIPE_DRIFT_DETECTED",
   // Generic
   "INTERNAL"
 ];
@@ -529,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`
@@ -605,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

package/package.json

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