@curviate/sdk 0.19.0 → 0.20.0

package/dist/index.js

@@ -8,11 +8,17 @@ var ERROR_CODES = [
   // Account state
   "ACCOUNT_NOT_FOUND",
   "ACCOUNT_RESTRICTED",
-  // Duplicate connect — reconnect or adopt the existing account instead of
+  // Duplicate connect: reconnect or adopt the existing account instead of
   // linking again. Not retryable.
   "ACCOUNT_ALREADY_LINKED",
   "RESOURCE_NOT_FOUND",
   "RESOURCE_ACCESS_RESTRICTED",
+  // Search filter resolution: a plain-string filter value matched several
+  // LinkedIn taxonomy options and one has to be picked (422). The body carries
+  // `unresolved[]` naming every offending field with its candidate ids, plus a
+  // `next_action` sentence. user_fixable, never retryable as sent; re-send
+  // with a chosen id.
+  "FILTER_CANDIDATES_REQUIRED",
   // Tier / subscription gating
   "TIER_NOT_ACTIVE",
   "LINKEDIN_FEATURE_NOT_SUBSCRIBED",
@@ -23,13 +29,13 @@ var ERROR_CODES = [
   // LinkedIn-platform-level throttling on the Recruiter / Sales Navigator read
   // surface (carries dedicated RateLimit-Policy / RateLimit / Retry-After
   // response headers). Distinct from the account/tenant/platform trio above.
-  // Always retry-safe (retry_likely_to_succeed: true) — see RETRYABLE_CODES.
+  // Always retry-safe (retry_likely_to_succeed: true); see RETRYABLE_CODES.
   "RATE_LIMITED",
   // Platform errors
   "PLATFORM_ERROR",
   "PLATFORM_NOT_IMPLEMENTED",
   // Permanent LinkedIn platform limitation for the attempted operation (e.g.
-  // listing a non-self user's following list). Not a transient failure —
+  // listing a non-self user's following list). Not a transient failure,
   // retrying will not help.
   "LINKEDIN_OPERATION_NOT_SUPPORTED",
   // Checkpoint (account connect flow)
@@ -40,15 +46,15 @@ var ERROR_CODES = [
   "CHECKPOINT_ALREADY_RESOLVED",
   "CHECKPOINT_UNSUPPORTED",
   "CONNECTION_IN_PROGRESS",
-  // One-premium boundary rejection — LinkedIn permits only one individual
+  // One-premium boundary rejection: LinkedIn permits only one individual
   // Premium subscription per profile. Surfaces on connect/reconnect (a seat
   // resolving to both premiums) and on the billing seat/tier endpoints (a
   // "naked enable" of one premium while the seat already holds the other).
-  // user_fixable, never retryable — the remedy is two seats, or pairing
+  // user_fixable, never retryable; the remedy is two seats, or pairing
   // enable with disable of the current premium in one call.
   "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 was attempted with cookie auth; a cookie replay cannot change
   // scope, so a full credentials re-authentication is required. user_fixable,
   // never retryable.
   "REAUTH_REQUIRED",
@@ -62,7 +68,7 @@ var ERROR_CODES = [
   "RECIPIENT_UNREACHABLE",
   // Duplicate / already-connected connect-request conflict: a send to a
   // recipient who already has a pending request from this account, or is already
-  // a first-degree connection. user_fixable, never retryable — do not re-send.
+  // a first-degree connection. user_fixable, never retryable; do not re-send.
   "CONNECTION_REQUEST_CONFLICT",
   // Billing (surface: tenant-management)
   "PAYMENT_REQUIRED",
@@ -92,7 +98,7 @@ var CurviateError = class _CurviateError extends Error {
   }
   /**
    * Explicit, credential-safe serialization. Only the documented structured
-   * fields are emitted — never a credential, auth header, or any reference to
+   * fields are emitted, never a credential, auth header, or any reference to
    * the client. `JSON.stringify(error)` calls this automatically.
    */
   toJSON() {
@@ -332,10 +338,10 @@ var AccountsResource = class {
    *
    * Each item also carries a small set of cached account-detail fields
    * (`username`, `premium_id`, `public_identifier`, `substrate_created_at`,
-   * `signatures`, `groups`) populated by an async background enrichment —
+   * `signatures`, `groups`) populated by an async background enrichment,
    * `null`/`[]` until the account's first enrichment pass completes.
    *
-   * @param params - optional `limit` (1–250) and `cursor` (from a prior page).
+   * @param params - optional `limit` (1-250) and `cursor` (from a prior page).
    * @returns a page of accounts and the next-page `cursor` (null when exhausted).
    *
    * @example
@@ -354,7 +360,7 @@ var AccountsResource = class {
    * central `quotas[]` view for all tracked quota families and `seat_id` (the
    * seat this account occupies, `null` for an admin seatless account).
    *
-   * This is a stale-while-revalidate read — it always returns immediately
+   * This is a stale-while-revalidate read; it always returns immediately
    * from the cached row (never blocks on a live substrate call). The cached
    * enrichment fields `full_name` and `substrate_created_at` are populated by
    * a background enrichment pass; `username`, `premium_id`,
@@ -370,7 +376,7 @@ var AccountsResource = class {
   /**
    * Update an account's configuration.
    *
-   * `metadata` is a flat string→string map that **replaces** the account's
+   * `metadata` is a flat string->string map that **replaces** the account's
    * custom-data store wholesale (keys not provided are removed). `proxy` sets a
    * custom egress proxy, or clears it (reverting to automatic proxy protection)
    * when passed as `null`. The `proxy.password`, if given, is stored securely
@@ -405,17 +411,17 @@ var AuthResource = class {
    * Omit `account_id` to connect a NEW account into an empty seat; 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
+   * challenge (202) when LinkedIn requires verification; resolve it with
    * {@link solveCheckpoint} (code) or {@link pollCheckpoint} (mobile-app
    * approval).
    *
-   * For `auth_method: "cookie"`, `user_agent` is **required** — connecting by
+   * For `auth_method: "cookie"`, `user_agent` is **required**; connecting by
    * session cookie without one is rejected with `INVALID_REQUEST`. It stays
    * optional for `auth_method: "credentials"`.
    *
    * On a 201 account, `recovered` is `true` only when the connect reclaimed a
    * LinkedIn identity already present on the workspace (claiming it into your
-   * account) rather than connecting a brand-new one — it is absent on a normal
+   * account) rather than connecting a brand-new one; it is absent on a normal
    * connect.
    *
    * Connection scope (which LinkedIn products are enabled: classic, company,
@@ -441,7 +447,7 @@ var AuthResource = class {
    * special value `TRY_ANOTHER_WAY` to switch challenge method).
    *
    * Returns the connected account (201) or, when LinkedIn chains a second
-   * challenge, another checkpoint (202) — resolve that one with a further
+   * challenge (another checkpoint, 202); resolve that one with a further
    * `solveCheckpoint` call for the same `accountId`.
    *
    * @param accountId - the (provisional) `account_id` from the 202 response.
@@ -458,7 +464,7 @@ var AuthResource = class {
    * Re-request the pending checkpoint notification (OTP / 2FA / mobile-app
    * push). `resent` is honest: `true` once the notification was actually
    * re-sent, `false` when there was nothing to re-send for that challenge
-   * type (e.g. an authenticator-app code) — this call never throws just
+   * type (e.g. an authenticator-app code); this call never throws just
    * because a re-send wasn't applicable. Does not reset the checkpoint's
    * expiry.
    *
@@ -488,12 +494,12 @@ var AuthResource = class {
     });
   }
   /**
-   * Poll a credential connect session by its account id — a pure status read
+   * Poll a credential connect session by its account id, a pure status read
    * that makes no external call and does not itself complete the connection.
    * `status` is `checkpoint_required` until resolved, then `done` (with
    * `account_id`), or `expired` / `failed`.
    *
-   * @param sessionId - the acc_… id returned by {@link intent} or a checkpoint response.
+   * @param sessionId - the acc_... id returned by {@link intent} or a checkpoint response.
    */
   getSession(sessionId) {
     return this.ctx.request({
@@ -641,7 +647,7 @@ var MessagingResource = class {
   /**
    * Download a message attachment. Returns raw binary.
    * `GET /v1/{account_id}/chats/{chat_id}/messages/{message_id}/attachments/{attachment_id}`
-   * Returns `ArrayBuffer` — binary response; the SDK does not cache or store it.
+   * Returns `ArrayBuffer`, binary response; the SDK does not cache or store it.
    */
   getAttachment(chatId, messageId, attachmentId) {
     return this.ctx.request({
@@ -658,7 +664,7 @@ var MessagingResource = class {
     });
   }
   /**
-   * Free-text search the account's own inbox — matches participant names
+   * Free-text search the account's own inbox; matches participant names
    * and message content. `GET /v1/{account_id}/chats/search`
    *
    * @param params - `query` (required free-text term) plus `limit` and an
@@ -694,11 +700,11 @@ var UsersResource = class {
   /**
    * Update the caller's own profile. `PATCH /v1/{account_id}/users/{user_id}`
    * Only `first_name`, `last_name`, `bio`, `headline`, `skills`, `picture`,
-   * `background_picture` are accepted — there is no `description` key.
+   * `background_picture` are accepted; there is no `description` key.
    * `description` is not part of the update contract: TypeScript already
    * rejects it at the call site, but an untyped/JS caller (or an `as`-cast)
    * could still smuggle it onto the object, so it is also stripped
-   * defensively at runtime before the request goes out — the caller's
+   * defensively at runtime before the request goes out, the caller's
    * object is never mutated.
    */
   update(userId, body) {
@@ -750,7 +756,7 @@ var UsersResource = class {
   }
   /**
    * Unfollow a user (bodyless). `DELETE /v1/{account_id}/users/{user_id}/follow`
-   * Idempotent — unfollowing a user this account does not currently follow
+   * Idempotent: unfollowing a user this account does not currently follow
    * still returns 200.
    */
   unfollow(userId) {
@@ -936,7 +942,7 @@ var SearchResource = class {
   /**
    * Run a pasted LinkedIn search/saved-search/lead-list URL directly.
    * `POST /v1/{account_id}/search`
-   * `url` is the ONLY accepted body field — the sole home of URL-mode search;
+   * `url` is the ONLY accepted body field, the sole home of URL-mode search;
    * the structured endpoints above no longer accept `url`. The response is
    * polymorphic, each item discriminated individually by its own `object`.
    */
@@ -972,7 +978,7 @@ var SearchResource = class {
    * `POST /v1/{account_id}/search/services`
    * `limit`/`cursor` are top-level query params, never in the body. Resolve
    * `service_category`/`location` filter values with `getServiceParameters()`
-   * first — both take opaque ids, not free text.
+   * first, both take opaque ids, not free text.
    */
   services(body) {
     const split = splitPagination(body);
@@ -1028,7 +1034,7 @@ var PostsResource = class {
     });
   }
   /**
-   * Publish a new post. Always `application/json` — attachments (if any) are
+   * Publish a new post. Always `application/json`; attachments (if any) are
    * base64-encoded objects, never `FormData`/multipart.
    * `POST /v1/{account_id}/posts`
    */
@@ -1067,7 +1073,7 @@ var PostsResource = class {
     });
   }
   /**
-   * Remove this account's reaction from a post — a **DELETE-with-body**:
+   * Remove this account's reaction from a post, a **DELETE-with-body**:
    * the reaction value to remove travels in the JSON body, not the path.
    * `DELETE /v1/{account_id}/posts/{post_id}/reactions`
    */
@@ -1090,10 +1096,10 @@ var PostsResource = class {
     });
   }
   /**
-   * List the connected account's own saved posts (a private bookmark list)
-   * — newest-saved-first. A self resource: there is no other-member
+   * List the connected account's own saved posts (a private bookmark list),
+   * newest-saved-first. A self resource: there is no other-member
    * saved-posts view, so this takes no target param. Each item is a
-   * PREVIEW — `snippet` capped at ≤140 chars, never the full post body.
+   * PREVIEW, `snippet` capped at <=140 chars, never the full post body.
    * `GET /v1/{account_id}/saved-posts`
    *
    * @param params - optional `limit` (default 20, a page-aligned lower
@@ -1108,14 +1114,14 @@ var PostsResource = class {
   }
   /**
    * Save a post to the connected account's private bookmark list. Any post
-   * may be saved — it does not notify the author and is never visible to
+   * may be saved; it does not notify the author and is never visible to
    * third parties. Idempotent: saving an already-saved post re-asserts
    * `saved:true`.
    * `POST /v1/{account_id}/saved-posts`
    *
    * @param postId - the post to save. Accepts `urn:li:activity:<id>` or a
-   *   bare numeric `<id>` — both normalize to the same target. Any other
-   *   shape (`urn:li:ugcPost:…`, `urn:li:share:…`, a URL) is rejected with
+   *   bare numeric `<id>`, both normalize to the same target. Any other
+   *   shape (`urn:li:ugcPost:...`, `urn:li:share:...`, a URL) is rejected with
    *   `400 INVALID_REQUEST`.
    */
   save(postId) {
@@ -1127,7 +1133,7 @@ var PostsResource = class {
     });
   }
   /**
-   * Unsave a post — the reverse of {@link save}, over the SAME underlying
+   * Unsave a post, the reverse of {@link save}, over the SAME underlying
    * save-state call (a distinct product endpoint, one substrate call).
    * Idempotent: unsaving a not-currently-saved post re-asserts
    * `saved:false`.
@@ -1194,7 +1200,7 @@ var CommentsResource = class {
     });
   }
   /**
-   * Reply to a comment. Shares its path with `edit` — POST creates a reply
+   * Reply to a comment. Shares its path with `edit`; POST creates a reply
    * under the target comment, PATCH edits the target comment's own text.
    * `POST /v1/{account_id}/posts/{post_id}/comments/{comment_id}`
    */
@@ -1238,7 +1244,7 @@ var CommentsResource = class {
     });
   }
   /**
-   * Remove this account's reaction from a comment — a **DELETE-with-body**:
+   * Remove this account's reaction from a comment, a **DELETE-with-body**:
    * the reaction value to remove travels in the JSON body, not the path.
    * `DELETE /v1/{account_id}/posts/{post_id}/comments/{comment_id}/reactions`
    */
@@ -1257,7 +1263,7 @@ var ProfileResource = class {
     this.ctx = ctx;
   }
   /**
-   * Read the connected account's premium subscription — its full entitlement
+   * Read the connected account's premium subscription: its full entitlement
    * inventory, primary plan title, and LinkedIn management links.
    * `GET /v1/{account_id}/profile/subscription`
    *
@@ -1273,7 +1279,7 @@ var ProfileResource = class {
     });
   }
   /**
-   * Read the connected account's performance headline metrics — profile
+   * Read the connected account's performance headline metrics, profile
    * viewers, followers, post impressions, and search appearances.
    * `GET /v1/{account_id}/profile/analytics`
    *
@@ -1293,13 +1299,13 @@ var ProfileResource = class {
    * cursor-paginated and classified by disclosure fidelity.
    * `GET /v1/{account_id}/profile/visitors`
    *
-   * Each item's `kind` is `identified`, `semi-anonymous`, or `aggregate` —
+   * Each item's `kind` is `identified`, `semi-anonymous`, or `aggregate`,
    * a Premium account sees identified viewers, a free account is capped at a
    * lower fidelity (still a `200`, never a permission error). Page with the
    * returned `cursor`: a non-null `cursor` means more may exist, even if a
    * page held zero identified individuals; `cursor: null` means exhausted.
    *
-   * @param params - `limit` (1–100, default 20) and an opaque `cursor` from
+   * @param params - `limit` (1-100, default 20) and an opaque `cursor` from
    *   a prior response.
    */
   visitors(params) {
@@ -1310,7 +1316,7 @@ var ProfileResource = class {
     });
   }
   /**
-   * Read the connected account's Social Selling Index — the overall score,
+   * Read the connected account's Social Selling Index, the overall score,
    * its four pillar breakdowns, and industry/network percentile ranks.
    * `GET /v1/{account_id}/profile/ssi`
    *
@@ -1350,7 +1356,7 @@ var GroupsResource = class {
     });
   }
   /**
-   * Retrieve a single LinkedIn group's full detail — its name, description,
+   * Retrieve a single LinkedIn group's full detail: its name, description,
    * member count, membership status, and admin contact.
    * `GET /v1/{account_id}/groups/{group}`
    *
@@ -1366,7 +1372,7 @@ var GroupsResource = class {
    * List a group's members, cursor-paginated, each carrying its profile URL,
    * name, and headline. `GET /v1/{account_id}/groups/{group}/members`
    *
-   * Pass `{ name }` to search the roster by member name — the folded-in
+   * Pass `{ name }` to search the roster by member name, the folded-in
    * member search, not a separate endpoint.
    *
    * @param group - the group's id or LinkedIn group URL.
@@ -1393,11 +1399,11 @@ var FeedResource = class {
    *
    * Pass `{ sort }` to choose the order: `recent` (reverse-chronological,
    * the default) or `relevant` (LinkedIn's ranked "top" feed). The feed is an
-   * unbounded, reordering stream with no total count — walk it with the
+   * unbounded, reordering stream with no total count; walk it with the
    * returned `cursor` until `cursor` is null. When a `cursor` is supplied its
    * carrier is authoritative and `sort` is ignored.
    *
-   * @param params - optional `{ sort }`, `limit` (1–100, default 20), and an
+   * @param params - optional `{ sort }`, `limit` (1-100, default 20), and an
    *   opaque `cursor` from a prior response.
    */
   home(params) {
@@ -1472,7 +1478,7 @@ var InboxesResource = class {
    *
    * @param inboxId - the inbox id from `list()` (e.g. `"CLASSIC_PRIMARY"`
    *   or `"COMPANY_83734124_PRIMARY"`).
-   * @param params - optional `limit` (1–25, default 20) and an opaque
+   * @param params - optional `limit` (1-25, default 20) and an opaque
    *   `cursor` for pagination.
    */
   listChats(inboxId, params) {
@@ -1490,8 +1496,8 @@ var NotificationsResource = class {
     this.ctx = ctx;
   }
   /**
-   * List the connected account's notification cards — newest first, plus
-   * the account-level `unread_count` (the unseen badge — NOT a count of
+   * List the connected account's notification cards, newest first, plus
+   * the account-level `unread_count` (the unseen badge, NOT a count of
    * `items`) and `latest_published_at` (a cheap poll watermark). Injected
    * promo/suggestion cards are included and flagged (`injected:true`),
    * never filtered.
@@ -1510,24 +1516,24 @@ var NotificationsResource = class {
   }
   /**
    * Delete one of the connected account's own notification cards by its
-   * card urn. A self-action — no third party is notified. This cannot be
+   * card urn. A self-action, no third party is notified. This cannot be
    * undone.
    *
    * **Safe to retry.** Idempotent: deleting a card you already deleted
-   * succeeds with `200`, not an error — a client that retries after a
+   * succeeds with `200`, not an error; a client that retries after a
    * timeout is never punished for it. Only a `card_urn` that never existed
    * on this account 404s.
    *
    * **Timing.** The removal takes effect within a few seconds; a
    * {@link list} read immediately after this call may still include the
-   * card for a moment. That is not a failure signal — the `200` is already
+   * card for a moment. That is not a failure signal; the `200` is already
    * confirmation the card was resolved and the removal accepted. Re-read
    * after a short delay, not instantly, if you need to visually confirm.
    *
    * `DELETE /v1/{account_id}/notifications/{card_urn}`
    *
    * @param cardUrn - the card's entity urn, raw/unencoded (the `card_urn`
-   *   field of a {@link list} item — `urn:li:fsd_notificationCard:(…)`,
+   *   field of a {@link list} item, `urn:li:fsd_notificationCard:(...)`,
    *   NOT `object_urn`, which targets the wrong notification). The SDK
    *   percent-encodes it into the path.
    */
@@ -1539,16 +1545,16 @@ var NotificationsResource = class {
   }
   /**
    * Apply "show less like this" to the source of one of the connected
-   * account's own notification cards — a self-action, same card handle and
+   * account's own notification cards, a self-action, same card handle and
    * timing/retry contract as {@link delete}. For network-activity cards (a
    * repost, comment, or reaction by your network) this **removes the
-   * card**, the same effect as `delete` — LinkedIn exposes no separate,
+   * card**, the same effect as `delete`; LinkedIn exposes no separate,
    * softer signal for these cards; this method exists so the calling
    * intent reads clearly, not because it behaves differently. This cannot
    * be undone.
    *
    * **Safe to retry**, same timing as {@link delete}: idempotent (a repeat
-   * is a `200`, not an error), effective within a few seconds — a
+   * is a `200`, not an error), effective within a few seconds, a
    * still-visible card on an immediate {@link list} re-read is not a
    * failure signal.
    *
@@ -1608,7 +1614,7 @@ var SalesNavigatorResource = class {
   }
   /**
    * Start a new Sales Navigator chat. `attachments[]`, when supplied, carry
-   * base64-encoded file bytes — always sent as JSON, never multipart.
+   * base64-encoded file bytes, always sent as JSON, never multipart.
    * `POST /v1/{account_id}/sales-navigator/chats`
    */
   startChat(body) {
@@ -1679,11 +1685,11 @@ var SalesNavigatorResource = class {
     });
   }
   /**
-   * Save a LinkedIn company into an account list. Body is just `{company_id}`
-   * — `account_id` lives in the path, not the body.
+   * Save a LinkedIn company into an account list. Body is just `{company_id}`;
+   * `account_id` lives in the path, not the body.
    * `POST /v1/{account_id}/sales-navigator/account-lists/{list_id}/save`
    *
-   * No `saved` boolean is invented — a `2xx` response body is the success
+   * No `saved` boolean is invented; a `2xx` response body is the success
    * signal (the substrate returns no success flag).
    */
   saveAccount(input) {
@@ -1695,8 +1701,8 @@ var SalesNavigatorResource = class {
     });
   }
   /**
-   * Save a Sales Navigator member into a lead list. Body is just `{user_id}`
-   * — `account_id` lives in the path, not the body.
+   * Save a Sales Navigator member into a lead list. Body is just `{user_id}`;
+   * `account_id` lives in the path, not the body.
    * `POST /v1/{account_id}/sales-navigator/lead-lists/{list_id}/save`
    */
   saveLead(input) {
@@ -1757,7 +1763,7 @@ var RecruiterResource = class {
     });
   }
   /**
-   * Start a Recruiter chat (InMail). JSON-only — `subject` and `signature`
+   * Start a Recruiter chat (InMail). JSON-only, `subject` and `signature`
    * are REQUIRED; optional attachments ride the body as base64-encoded
    * objects (no multipart). `POST /v1/{account_id}/recruiter/chats`
    */
@@ -1782,7 +1788,7 @@ var RecruiterResource = class {
   }
   /**
    * Resolve human-readable terms to opaque Recruiter filter ids. POST (was
-   * GET): the body is a `source`-discriminated oneOf — `APPLICANTS`/`PIPELINE`
+   * GET): the body is a `source`-discriminated oneOf, `APPLICANTS`/`PIPELINE`
    * require `project_id`. `POST /v1/{account_id}/recruiter/search/parameters`
    */
   searchParameters(body, params) {
@@ -1808,7 +1814,7 @@ var RecruiterResource = class {
     });
   }
   /**
-   * Search from a pasted Recruiter search / talent-pool / applicant URL —
+   * Search from a pasted Recruiter search / talent-pool / applicant URL,
    * nothing else in the body. The response is a 3-way oneOf (people-search,
    * job-applicant list, or pipeline-candidate list) keyed by the URL kind.
    * `POST /v1/{account_id}/recruiter/search`
@@ -1843,7 +1849,7 @@ var RecruiterResource = class {
     });
   }
   /**
-   * Edit a Recruiter project's config — all fields optional; omitted fields
+   * Edit a Recruiter project's config: all fields optional; omitted fields
    * are left unchanged. Returns a thin acknowledgement only.
    * `PATCH /v1/{account_id}/recruiter/projects/{project_id}`
    */
@@ -1870,7 +1876,7 @@ var RecruiterResource = class {
   }
   /**
    * Get the single job posting attached to a Recruiter project (the surface
-   * returns one posting, not a list — a project with no attached job 404s).
+   * returns one posting, not a list; a project with no attached job 404s).
    * `GET /v1/{account_id}/recruiter/projects/{project_id}/jobs`
    */
   getProjectJob(projectId) {
@@ -1880,7 +1886,7 @@ var RecruiterResource = class {
     });
   }
   /**
-   * Create a job-posting DRAFT attached to an EXISTING project — `project_name`
+   * Create a job-posting DRAFT attached to an EXISTING project, `project_name`
    * is not accepted (the project comes from the path). Never publishes, never
    * spends money. `POST /v1/{account_id}/recruiter/projects/{project_id}/jobs`
    */
@@ -1892,7 +1898,7 @@ var RecruiterResource = class {
     });
   }
   /**
-   * Get pricing to publish a project's job posting — price a publish before
+   * Get pricing to publish a project's job posting; price a publish before
    * committing any money.
    * `GET /v1/{account_id}/recruiter/projects/{project_id}/jobs/{job_id}/budget`
    */
@@ -1903,8 +1909,8 @@ var RecruiterResource = class {
     });
   }
   /**
-   * Create a job-posting DRAFT together with a brand-new hiring project —
-   * `project_name` is REQUIRED; `description` must be ≥ 200 characters. Never
+   * Create a job-posting DRAFT together with a brand-new hiring project,
+   * `project_name` is REQUIRED; `description` must be >= 200 characters. Never
    * publishes, never spends money. `POST /v1/{account_id}/recruiter/jobs`
    */
   createJob(body) {
@@ -1931,7 +1937,7 @@ var RecruiterResource = class {
    * `GET /v1/{account_id}/recruiter/jobs/{job_id}`
    *
    * Accepts a bare numeric job id or a full LinkedIn job URL
-   * (`https://www.linkedin.com/jobs/view/{id}`) — the id is extracted
+   * (`https://www.linkedin.com/jobs/view/{id}`); the id is extracted
    * client-side; the wire request always carries the numeric id. Throws
    * `CurviateError({ code: 'INVALID_REQUEST' })` synchronously if neither
    * form can be recognized.
@@ -1944,7 +1950,7 @@ var RecruiterResource = class {
     });
   }
   /**
-   * Apply a partial update to a project's job posting — only included fields
+   * Apply a partial update to a project's job posting, only included fields
    * change. MONEY WARNING: editing an already-published (LISTED) posting
    * mutates a live, money-spending listing.
    * `PATCH /v1/{account_id}/recruiter/projects/{project_id}/jobs/{job_id}`
@@ -1959,7 +1965,7 @@ var RecruiterResource = class {
   /**
    * Publish a project's job posting draft. `mode` is a discriminated oneOf:
    * `FREE` (requires free-posting eligibility, spends nothing) or
-   * `PROMOTED`/`PROMOTED_PLUS` (requires `budget` — THIS SPENDS REAL MONEY on
+   * `PROMOTED`/`PROMOTED_PLUS` (requires `budget`; THIS SPENDS REAL MONEY on
    * the connected account's LinkedIn payment method; supplying `budget` IS the
    * explicit opt-in).
    * `POST /v1/{account_id}/recruiter/projects/{project_id}/jobs/{job_id}/publish`
@@ -1974,7 +1980,7 @@ var RecruiterResource = class {
   /**
    * Close a project's job posting so it stops accepting applications
    * (bodyless). Closing an already-published (LISTED) posting cannot be
-   * undone — there is no re-open operation.
+   * undone; there is no re-open operation.
    * `POST /v1/{account_id}/recruiter/projects/{project_id}/jobs/{job_id}/close`
    */
   closeJob(projectId, jobId) {
@@ -1985,7 +1991,7 @@ var RecruiterResource = class {
   }
   /**
    * Save a candidate (or user profile) to a project's pipeline at the given
-   * stage — the sole surviving pipeline write.
+   * stage, the sole surviving pipeline write.
    * `POST /v1/{account_id}/recruiter/projects/{project_id}/pipeline/candidate/save`
    */
   saveCandidate(projectId, body) {
@@ -2022,7 +2028,7 @@ var RecruiterResource = class {
   /**
    * Download a talent-pool applicant's résumé as raw binary.
    * `GET /v1/{account_id}/recruiter/projects/{project_id}/talent-pool/applicants/{applicant_id}/resume`
-   * Returns `ArrayBuffer` — the SDK does not cache or store it.
+   * Returns `ArrayBuffer`; the SDK does not cache or store it.
    */
   downloadResume(projectId, applicantId) {
     return this.ctx.request({
@@ -2040,7 +2046,7 @@ var JobsResource = class {
   /**
    * List the connected account's own classic job postings.
    * `GET /v1/{account_id}/jobs`
-   * `state` is REQUIRED — filtering is LinkedIn-side and best-effort (see
+   * `state` is REQUIRED, filtering is LinkedIn-side and best-effort (see
    * the generated type's own field description).
    */
   list(params) {
@@ -2066,7 +2072,7 @@ var JobsResource = class {
    * `GET /v1/{account_id}/jobs/{job_id}`
    *
    * Accepts a bare numeric job id or a full job URL
-   * (`https://www.linkedin.com/jobs/view/{id}`) — the id is extracted
+   * (`https://www.linkedin.com/jobs/view/{id}`); the id is extracted
    * client-side; the wire request always carries the numeric id. Throws
    * `CurviateError({ code: 'INVALID_REQUEST' })` synchronously if neither
    * form can be recognized.
@@ -2080,7 +2086,7 @@ var JobsResource = class {
     });
   }
   /**
-   * Apply a partial update to a job posting this account owns — only
+   * Apply a partial update to a job posting this account owns, only
    * included fields change. Can affect real money on an already-published
    * (LISTED) posting. `PATCH /v1/{account_id}/jobs/{job_id}`
    */
@@ -2092,7 +2098,7 @@ var JobsResource = class {
     });
   }
   /**
-   * Get pricing to publish a job posting — price a publish before
+   * Get pricing to publish a job posting; price a publish before
    * committing any money. `GET /v1/{account_id}/jobs/{job_id}/budget`
    */
   getBudget(jobId) {
@@ -2104,7 +2110,7 @@ var JobsResource = class {
   /**
    * Publish a classic job posting draft. `mode` is a discriminated oneOf:
    * `FREE` (requires free-posting eligibility, spends nothing) or
-   * `PROMOTED`/`PROMOTED_PLUS` (requires `budget` — THIS SPENDS REAL MONEY
+   * `PROMOTED`/`PROMOTED_PLUS` (requires `budget`; THIS SPENDS REAL MONEY
    * on the connected account's LinkedIn payment method; supplying `budget`
    * IS the explicit opt-in). `POST /v1/{account_id}/jobs/{job_id}/publish`
    */
@@ -2127,7 +2133,7 @@ var JobsResource = class {
     });
   }
   /**
-   * List applicants to a job posting this account owns — a read; POST
+   * List applicants to a job posting this account owns, a read; POST
    * carries the filter body, matching the `/search/*` convention. Omit
    * `ratings` to see the full applicant funnel. `limit`/`cursor` stay
    * TOP-LEVEL query params, never in the body.
@@ -2161,7 +2167,7 @@ var JobsResource = class {
   /**
    * Download an applicant's résumé. Returns raw binary.
    * `GET /v1/{account_id}/jobs/{job_id}/applicants/{applicant_id}/resume`
-   * Returns `ArrayBuffer` — the SDK does not cache or store it.
+   * Returns `ArrayBuffer`; the SDK does not cache or store it.
    */
   downloadResume(jobId, applicantId) {
     return this.ctx.request({
@@ -2193,9 +2199,9 @@ var CompaniesResource = class {
    * List people who currently work at the company.
    * `GET /v1/{account_id}/companies/{identifier}/employees`
    *
-   * A facade over people search with the company filter applied — filter
+   * A facade over people search with the company filter applied, filter
    * further with `keywords` or `location`. `identifier` must be the
-   * company's numeric provider_id (the same `id` field `get()` returns) —
+   * company's numeric provider_id (the same `id` field `get()` returns),
    * a handle or URN is rejected before any upstream call.
    */
   employees(identifier, params) {
@@ -2223,7 +2229,7 @@ var CompaniesResource = class {
    * List the company's open job postings.
    * `GET /v1/{account_id}/companies/{identifier}/jobs`
    *
-   * A facade over job search with the company filter applied — filter
+   * A facade over job search with the company filter applied, filter
    * further with `keywords`. An empty `items[]` is a valid result (the
    * company currently has no open postings). `identifier` must be the
    * company's numeric provider_id.
@@ -2241,7 +2247,7 @@ var CompaniesResource = class {
    *
    * The `id` on each returned page is the numeric provider_id `followers()`,
    * `invitableFollowers()`, `employees()`, `posts()`, and `jobs()` consume.
-   * An empty `items[]` is valid — the account administers no pages.
+   * An empty `items[]` is valid; the account administers no pages.
    */
   managed(params) {
     return this.ctx.request({
@@ -2269,7 +2275,7 @@ var CompaniesResource = class {
    * company page. `GET /v1/{account_id}/companies/{identifier}/invitable-followers`
    *
    * The connected account must administer the page. `identifier` must be the
-   * company's numeric provider_id. An empty `items[]` is valid — nobody is
+   * company's numeric provider_id. An empty `items[]` is valid; nobody is
    * currently invitable.
    */
   invitableFollowers(identifier, params) {
@@ -2285,7 +2291,7 @@ var CompaniesResource = class {
    *
    * The account must administer the page with the invite-to-follow
    * entitlement (see `managed()`). `identifier` must be the company's numeric
-   * provider_id. Pass the `AC…` member ids from an `invitableFollowers()`
+   * provider_id. Pass the `AC...` member ids from an `invitableFollowers()`
    * read. All-or-nothing: for an all-valid request, resolves to one outcome
    * per requested invitee, in request order. If any invitee id is invalid,
    * the whole request rejects with a 404, not a partial result.
@@ -2306,7 +2312,7 @@ var CompaniesResource = class {
    *
    * The connected account must administer the page. `identifier` must be the
    * company's numeric provider_id. Content passes through verbatim and is
-   * never stored. Beta — single-page listing and termination are verified;
+   * never stored. Beta: single-page listing and termination are verified;
    * deep pagination (many pages / large cursor round-trips) is provisional
    * until validated against a busier inbox.
    */
@@ -2321,7 +2327,7 @@ var CompaniesResource = class {
    * Retrieve one conversation from a company page's admin inbox.
    * `GET /v1/{account_id}/companies/{identifier}/chats/{chat_id}`
    *
-   * The connected account must administer the page. Beta — see `chats()`.
+   * The connected account must administer the page. Beta: see `chats()`.
    */
   chat(identifier, chatId) {
     return this.ctx.request({
@@ -2334,7 +2340,7 @@ var CompaniesResource = class {
    * `GET /v1/{account_id}/companies/{identifier}/chats/{chat_id}/messages`
    *
    * The connected account must administer the page. Content passes through
-   * verbatim and is never stored. Beta — see `chats()`.
+   * verbatim and is never stored. Beta: see `chats()`.
    */
   messages(identifier, chatId, params) {
     return this.ctx.request({
@@ -2347,7 +2353,7 @@ var CompaniesResource = class {
    * Retrieve one message from a company-inbox conversation.
    * `GET /v1/{account_id}/companies/{identifier}/chats/{chat_id}/messages/{message_id}`
    *
-   * The connected account must administer the page. Beta — see `chats()`.
+   * The connected account must administer the page. Beta: see `chats()`.
    */
   message(identifier, chatId, messageId) {
     return this.ctx.request({
@@ -2360,9 +2366,9 @@ var CompaniesResource = class {
    * `GET /v1/{account_id}/companies/{identifier}/chats/search`
    *
    * Exactly one mode per call: free-text `query` (matches participant names
-   * and message content), a `topic` card, or `unread`-only — the three are
+   * and message content), a `topic` card, or `unread`-only; the three are
    * mutually exclusive and enforced server-side. The connected account must
-   * administer the page. Beta — see `chats()`.
+   * administer the page. Beta: see `chats()`.
    */
   searchChats(identifier, params) {
     return this.ctx.request({
@@ -2375,7 +2381,7 @@ var CompaniesResource = class {
    * Reply to a company-inbox conversation, AS THE PAGE.
    * `POST /v1/{account_id}/companies/{identifier}/chats/{chat_id}/messages`
    *
-   * `chatId` is the `2-…` conversation id that `chats()` / `chat()` /
+   * `chatId` is the `2-...` conversation id that `chats()` / `chat()` /
    * `searchChats()` return for this page. The endpoint resolves the page
    * mailbox internally from `identifier`, so no special send-ready id is
    * needed: pass the id straight from the company chat reads.
@@ -2440,7 +2446,9 @@ var WebhooksResource = class {
     });
   }
   /**
-   * Return the complete canonical webhook event catalogue (27 events, grouped by source).
+   * Return the complete canonical webhook event catalogue, grouped by source.
+   * The response counts itself; no size is stated here, because a hand-typed
+   * one is wrong the next time the catalogue grows.
    * `GET /v1/webhooks/events`
    */
   listEvents() {
@@ -2452,7 +2460,7 @@ var WebhooksResource = class {
   /**
    * Return a single webhook owned by the calling tenant.
    * `GET /v1/webhooks/{id}`
-   * The plaintext secret is never present on a read — only `secret_prefix`.
+   * The plaintext secret is never present on a read, only `secret_prefix`.
    */
   get(id) {
     return this.ctx.request({
@@ -2540,7 +2548,7 @@ var Curviate = class {
    * Return an account-scoped accessor that fixes `account_id` on every call,
    * so callers need not repeat it per method.
    *
-   * @param accountId - a Curviate account id (`acc_…`). Empty throws
+   * @param accountId - a Curviate account id (`acc_...`). Empty throws
    *   `CurviateError({ code: 'INVALID_REQUEST' })` synchronously, no network call.
    *
    * @example