@curviate/sdk 0.19.0 → 0.20.1

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() {
@@ -285,15 +291,46 @@ async function execute(method, path, opts) {
   }
 }
 
+// src/internal/path.ts
+function encodePathParam(value) {
+  return encodeURIComponent(String(value));
+}
+var UNSAFE_SEGMENT = /^(?:\.{1,2})?$/;
+function assertPathIsSendable(path) {
+  const segments = path.split("/").slice(1);
+  for (const segment of segments) {
+    if (!UNSAFE_SEGMENT.test(segment)) continue;
+    throw new CurviateError({
+      code: "INVALID_REQUEST",
+      message: `A path parameter cannot be ${segment === "" ? "empty" : `"${segment}"`}. The URL parser resolves that away before the request is sent, so the call would reach a different endpoint. Pass the id itself.`,
+      userFixable: true,
+      retryLikelyToSucceed: false
+    });
+  }
+}
+function apiPath(strings, ...values) {
+  let out = strings[0] ?? "";
+  for (let i = 0; i < values.length; i++) {
+    out += encodePathParam(values[i]) + (strings[i + 1] ?? "");
+  }
+  return out;
+}
+
 // src/internal/context.ts
 var ACCOUNT_ID_PLACEHOLDER = "{account_id}";
 function injectAccountIdIntoPath(path, accountId) {
   if (accountId === void 0) return path;
-  return path.split(ACCOUNT_ID_PLACEHOLDER).join(accountId);
+  return path.split(ACCOUNT_ID_PLACEHOLDER).join(encodePathParam(accountId));
 }
 function createContext(config, accountId) {
   const request = (args) => {
-    const path = injectAccountIdIntoPath(args.path, accountId);
+    let path;
+    try {
+      path = injectAccountIdIntoPath(args.path, accountId);
+      assertPathIsSendable(path);
+    } catch (err) {
+      return Promise.reject(err);
+    }
     return execute(args.method, path, {
       apiKey: config.apiKey,
       baseUrl: config.baseUrl,
@@ -332,10 +369,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 +391,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`,
@@ -364,13 +401,13 @@ var AccountsResource = class {
   get(accountId) {
     return this.ctx.request({
       method: "GET",
-      path: `/v1/accounts/${accountId}`
+      path: apiPath`/v1/accounts/${accountId}`
     });
   }
   /**
    * 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
@@ -379,7 +416,7 @@ var AccountsResource = class {
   update(accountId, body) {
     return this.ctx.request({
       method: "PATCH",
-      path: `/v1/accounts/${accountId}`,
+      path: apiPath`/v1/accounts/${accountId}`,
       body
     });
   }
@@ -389,7 +426,7 @@ var AccountsResource = class {
   disconnect(accountId) {
     return this.ctx.request({
       method: "DELETE",
-      path: `/v1/accounts/${accountId}`
+      path: apiPath`/v1/accounts/${accountId}`
     });
   }
 };
@@ -405,17 +442,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 +478,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 +495,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,17 +525,17 @@ 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({
       method: "GET",
-      path: `/v1/auth/sessions/${sessionId}`
+      path: apiPath`/v1/auth/sessions/${sessionId}`
     });
   }
 };
@@ -536,7 +573,7 @@ var MessagingResource = class {
   getChat(chatId) {
     return this.ctx.request({
       method: "GET",
-      path: `/v1/{account_id}/chats/${chatId}`
+      path: apiPath`/v1/{account_id}/chats/${chatId}`
     });
   }
   /**
@@ -546,7 +583,7 @@ var MessagingResource = class {
   markChatRead(chatId, body) {
     return this.ctx.request({
       method: "PATCH",
-      path: `/v1/{account_id}/chats/${chatId}`,
+      path: apiPath`/v1/{account_id}/chats/${chatId}`,
       body
     });
   }
@@ -557,7 +594,7 @@ var MessagingResource = class {
   listMessages(chatId, params) {
     return this.ctx.request({
       method: "GET",
-      path: `/v1/{account_id}/chats/${chatId}/messages`,
+      path: apiPath`/v1/{account_id}/chats/${chatId}/messages`,
       ...params ? { query: params } : {}
     });
   }
@@ -592,7 +629,7 @@ var MessagingResource = class {
   sendMessage(chatId, body) {
     return this.ctx.request({
       method: "POST",
-      path: `/v1/{account_id}/chats/${chatId}/messages`,
+      path: apiPath`/v1/{account_id}/chats/${chatId}/messages`,
       body
     });
   }
@@ -603,7 +640,7 @@ var MessagingResource = class {
   getMessage(chatId, messageId) {
     return this.ctx.request({
       method: "GET",
-      path: `/v1/{account_id}/chats/${chatId}/messages/${messageId}`
+      path: apiPath`/v1/{account_id}/chats/${chatId}/messages/${messageId}`
     });
   }
   /**
@@ -613,7 +650,7 @@ var MessagingResource = class {
   editMessage(chatId, messageId, body) {
     return this.ctx.request({
       method: "PATCH",
-      path: `/v1/{account_id}/chats/${chatId}/messages/${messageId}`,
+      path: apiPath`/v1/{account_id}/chats/${chatId}/messages/${messageId}`,
       body
     });
   }
@@ -624,7 +661,7 @@ var MessagingResource = class {
   deleteMessage(chatId, messageId) {
     return this.ctx.request({
       method: "DELETE",
-      path: `/v1/{account_id}/chats/${chatId}/messages/${messageId}`
+      path: apiPath`/v1/{account_id}/chats/${chatId}/messages/${messageId}`
     });
   }
   /**
@@ -634,19 +671,19 @@ var MessagingResource = class {
   addReaction(chatId, messageId, body) {
     return this.ctx.request({
       method: "POST",
-      path: `/v1/{account_id}/chats/${chatId}/messages/${messageId}/reactions`,
+      path: apiPath`/v1/{account_id}/chats/${chatId}/messages/${messageId}/reactions`,
       body
     });
   }
   /**
    * 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({
       method: "GET",
-      path: `/v1/{account_id}/chats/${chatId}/messages/${messageId}/attachments/${attachmentId}`
+      path: apiPath`/v1/{account_id}/chats/${chatId}/messages/${messageId}/attachments/${attachmentId}`
     });
   }
   /** Send an InMail. `POST /v1/{account_id}/messages/inmail` */
@@ -658,7 +695,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
@@ -687,25 +724,25 @@ var UsersResource = class {
   get(userId, params) {
     return this.ctx.request({
       method: "GET",
-      path: `/v1/{account_id}/users/${userId}`,
+      path: apiPath`/v1/{account_id}/users/${userId}`,
       ...params ? { query: params } : {}
     });
   }
   /**
    * 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) {
     const { description: _description, ...safeBody } = body;
     return this.ctx.request({
       method: "PATCH",
-      path: `/v1/{account_id}/users/${userId}`,
+      path: apiPath`/v1/{account_id}/users/${userId}`,
       body: safeBody
     });
   }
@@ -725,7 +762,7 @@ var UsersResource = class {
   listFollowers(userId, params) {
     return this.ctx.request({
       method: "GET",
-      path: `/v1/{account_id}/users/${userId}/followers`,
+      path: apiPath`/v1/{account_id}/users/${userId}/followers`,
       ...params ? { query: params } : {}
     });
   }
@@ -733,7 +770,7 @@ var UsersResource = class {
   listFollowing(userId, params) {
     return this.ctx.request({
       method: "GET",
-      path: `/v1/{account_id}/users/${userId}/following`,
+      path: apiPath`/v1/{account_id}/users/${userId}/following`,
       ...params ? { query: params } : {}
     });
   }
@@ -745,18 +782,18 @@ var UsersResource = class {
   follow(userId) {
     return this.ctx.request({
       method: "POST",
-      path: `/v1/{account_id}/users/${userId}/follow`
+      path: apiPath`/v1/{account_id}/users/${userId}/follow`
     });
   }
   /**
    * 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) {
     return this.ctx.request({
       method: "DELETE",
-      path: `/v1/{account_id}/users/${userId}/follow`
+      path: apiPath`/v1/{account_id}/users/${userId}/follow`
     });
   }
   /**
@@ -780,7 +817,7 @@ var UsersResource = class {
   endorseSkill(userId, body) {
     return this.ctx.request({
       method: "POST",
-      path: `/v1/{account_id}/users/${userId}/endorse-skill`,
+      path: apiPath`/v1/{account_id}/users/${userId}/endorse-skill`,
       body
     });
   }
@@ -823,7 +860,7 @@ var InvitesResource = class {
   accept(invitationId) {
     return this.ctx.request({
       method: "POST",
-      path: `/v1/{account_id}/invites/received/${invitationId}/accept`
+      path: apiPath`/v1/{account_id}/invites/received/${invitationId}/accept`
     });
   }
   /**
@@ -834,7 +871,7 @@ var InvitesResource = class {
   decline(invitationId) {
     return this.ctx.request({
       method: "POST",
-      path: `/v1/{account_id}/invites/received/${invitationId}/decline`
+      path: apiPath`/v1/{account_id}/invites/received/${invitationId}/decline`
     });
   }
   /**
@@ -845,7 +882,7 @@ var InvitesResource = class {
   cancel(invitationId) {
     return this.ctx.request({
       method: "DELETE",
-      path: `/v1/{account_id}/invites/sent/${invitationId}`
+      path: apiPath`/v1/{account_id}/invites/sent/${invitationId}`
     });
   }
 };
@@ -936,7 +973,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 +1009,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);
@@ -1009,26 +1046,39 @@ var PostsResource = class {
   listComments(postId, params) {
     return this.ctx.request({
       method: "GET",
-      path: `/v1/{account_id}/posts/${postId}/comments`,
+      path: apiPath`/v1/{account_id}/posts/${postId}/comments`,
       ...params ? { query: params } : {}
     });
   }
-  /** Get a single post. `GET /v1/{account_id}/posts/{post_id}` */
+  /**
+   * Get a single post. `GET /v1/{account_id}/posts/{post_id}`
+   *
+   * @param postId - the post's `id` as returned by {@link listUserPosts} or
+   *   {@link create}. A bare numeric id (`7332661864792854528`), a URN
+   *   (`urn:li:activity:N`, `urn:li:ugcPost:N`, `urn:li:share:N`), and a full
+   *   share URL (`https://www.linkedin.com/posts/...` or
+   *   `https://www.linkedin.com/feed/update/urn:li:activity:N`) all resolve to
+   *   the same post. Pass the value as-is; it is percent-encoded into the path
+   *   for you, so do not encode it yourself.
+   *
+   *   {@link listComments} and the reaction operations are stricter: they take
+   *   the opaque `id` form only.
+   */
   get(postId) {
     return this.ctx.request({
       method: "GET",
-      path: `/v1/{account_id}/posts/${postId}`
+      path: apiPath`/v1/{account_id}/posts/${postId}`
     });
   }
   /** Delete a post (bodyless, 204). `DELETE /v1/{account_id}/posts/{post_id}` */
   delete(postId) {
     return this.ctx.request({
       method: "DELETE",
-      path: `/v1/{account_id}/posts/${postId}`
+      path: apiPath`/v1/{account_id}/posts/${postId}`
     });
   }
   /**
-   * 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`
    */
@@ -1046,7 +1096,7 @@ var PostsResource = class {
   listUserPosts(userId, params) {
     return this.ctx.request({
       method: "GET",
-      path: `/v1/{account_id}/users/${userId}/posts`,
+      path: apiPath`/v1/{account_id}/users/${userId}/posts`,
       ...params ? { query: params } : {}
     });
   }
@@ -1054,7 +1104,7 @@ var PostsResource = class {
   listReactions(postId, params) {
     return this.ctx.request({
       method: "GET",
-      path: `/v1/{account_id}/posts/${postId}/reactions`,
+      path: apiPath`/v1/{account_id}/posts/${postId}/reactions`,
       ...params ? { query: params } : {}
     });
   }
@@ -1062,19 +1112,19 @@ var PostsResource = class {
   react(postId, body) {
     return this.ctx.request({
       method: "POST",
-      path: `/v1/{account_id}/posts/${postId}/reactions`,
+      path: apiPath`/v1/{account_id}/posts/${postId}/reactions`,
       body
     });
   }
   /**
-   * 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`
    */
   unreact(postId, body) {
     return this.ctx.request({
       method: "DELETE",
-      path: `/v1/{account_id}/posts/${postId}/reactions`,
+      path: apiPath`/v1/{account_id}/posts/${postId}/reactions`,
       body
     });
   }
@@ -1085,15 +1135,15 @@ var PostsResource = class {
   listUserReactions(userId, params) {
     return this.ctx.request({
       method: "GET",
-      path: `/v1/{account_id}/users/${userId}/reactions`,
+      path: apiPath`/v1/{account_id}/users/${userId}/reactions`,
       ...params ? { query: params } : {}
     });
   }
   /**
-   * 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 +1158,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 +1177,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`.
@@ -1138,7 +1188,7 @@ var PostsResource = class {
   unsave(postId) {
     return this.ctx.request({
       method: "DELETE",
-      path: `/v1/{account_id}/saved-posts/${postId}`
+      path: apiPath`/v1/{account_id}/saved-posts/${postId}`
     });
   }
 };
@@ -1156,7 +1206,7 @@ var CommentsResource = class {
   listUserComments(userId, params) {
     return this.ctx.request({
       method: "GET",
-      path: `/v1/{account_id}/users/${userId}/comments`,
+      path: apiPath`/v1/{account_id}/users/${userId}/comments`,
       ...params ? { query: params } : {}
     });
   }
@@ -1168,7 +1218,7 @@ var CommentsResource = class {
   create(postId, body) {
     return this.ctx.request({
       method: "POST",
-      path: `/v1/{account_id}/posts/${postId}/comments`,
+      path: apiPath`/v1/{account_id}/posts/${postId}/comments`,
       body
     });
   }
@@ -1179,7 +1229,7 @@ var CommentsResource = class {
   edit(postId, commentId, body) {
     return this.ctx.request({
       method: "PATCH",
-      path: `/v1/{account_id}/posts/${postId}/comments/${commentId}`,
+      path: apiPath`/v1/{account_id}/posts/${postId}/comments/${commentId}`,
       body
     });
   }
@@ -1190,18 +1240,18 @@ var CommentsResource = class {
   delete(postId, commentId) {
     return this.ctx.request({
       method: "DELETE",
-      path: `/v1/{account_id}/posts/${postId}/comments/${commentId}`
+      path: apiPath`/v1/{account_id}/posts/${postId}/comments/${commentId}`
     });
   }
   /**
-   * 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}`
    */
   reply(postId, commentId, body) {
     return this.ctx.request({
       method: "POST",
-      path: `/v1/{account_id}/posts/${postId}/comments/${commentId}`,
+      path: apiPath`/v1/{account_id}/posts/${postId}/comments/${commentId}`,
       body
     });
   }
@@ -1212,7 +1262,7 @@ var CommentsResource = class {
   listReplies(postId, commentId, params) {
     return this.ctx.request({
       method: "GET",
-      path: `/v1/{account_id}/posts/${postId}/comments/${commentId}/replies`,
+      path: apiPath`/v1/{account_id}/posts/${postId}/comments/${commentId}/replies`,
       ...params ? { query: params } : {}
     });
   }
@@ -1223,7 +1273,7 @@ var CommentsResource = class {
   listReactions(postId, commentId, params) {
     return this.ctx.request({
       method: "GET",
-      path: `/v1/{account_id}/posts/${postId}/comments/${commentId}/reactions`,
+      path: apiPath`/v1/{account_id}/posts/${postId}/comments/${commentId}/reactions`,
       ...params ? { query: params } : {}
     });
   }
@@ -1233,19 +1283,19 @@ var CommentsResource = class {
   addReaction(postId, commentId, body) {
     return this.ctx.request({
       method: "POST",
-      path: `/v1/{account_id}/posts/${postId}/comments/${commentId}/reactions`,
+      path: apiPath`/v1/{account_id}/posts/${postId}/comments/${commentId}/reactions`,
       body
     });
   }
   /**
-   * 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`
    */
   removeReaction(postId, commentId, body) {
     return this.ctx.request({
       method: "DELETE",
-      path: `/v1/{account_id}/posts/${postId}/comments/${commentId}/reactions`,
+      path: apiPath`/v1/{account_id}/posts/${postId}/comments/${commentId}/reactions`,
       body
     });
   }
@@ -1257,7 +1307,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 +1323,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 +1343,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 +1360,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 +1400,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}`
    *
@@ -1359,14 +1409,14 @@ var GroupsResource = class {
   get(group) {
     return this.ctx.request({
       method: "GET",
-      path: `/v1/{account_id}/groups/${group}`
+      path: apiPath`/v1/{account_id}/groups/${group}`
     });
   }
   /**
    * 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.
@@ -1376,7 +1426,7 @@ var GroupsResource = class {
   members(group, params) {
     return this.ctx.request({
       method: "GET",
-      path: `/v1/{account_id}/groups/${group}/members`,
+      path: apiPath`/v1/{account_id}/groups/${group}/members`,
       ...params ? { query: params } : {}
     });
   }
@@ -1393,11 +1443,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,13 +1522,13 @@ 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) {
     return this.ctx.request({
       method: "GET",
-      path: `/v1/{account_id}/inboxes/${inboxId}/chats`,
+      path: apiPath`/v1/{account_id}/inboxes/${inboxId}/chats`,
       ...params ? { query: params } : {}
     });
   }
@@ -1490,8 +1540,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,45 +1560,45 @@ 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.
    */
   delete(cardUrn) {
     return this.ctx.request({
       method: "DELETE",
-      path: `/v1/{account_id}/notifications/${encodeURIComponent(cardUrn)}`
+      path: apiPath`/v1/{account_id}/notifications/${cardUrn}`
     });
   }
   /**
    * 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.
    *
@@ -1560,7 +1610,7 @@ var NotificationsResource = class {
   showLess(cardUrn) {
     return this.ctx.request({
       method: "POST",
-      path: `/v1/{account_id}/notifications/${encodeURIComponent(cardUrn)}/show-less`
+      path: apiPath`/v1/{account_id}/notifications/${cardUrn}/show-less`
     });
   }
 };
@@ -1608,7 +1658,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) {
@@ -1625,7 +1675,7 @@ var SalesNavigatorResource = class {
   getProfile(identifier, query) {
     return this.ctx.request({
       method: "GET",
-      path: `/v1/{account_id}/sales-navigator/profiles/${identifier}`,
+      path: apiPath`/v1/{account_id}/sales-navigator/profiles/${identifier}`,
       // cast needed: with_sections is string[] but transport encodes arrays as repeated params
       ...query ? { query } : {}
     });
@@ -1660,7 +1710,7 @@ var SalesNavigatorResource = class {
   browseAccountList(listId, body, query) {
     return this.ctx.request({
       method: "POST",
-      path: `/v1/{account_id}/sales-navigator/account-lists/${listId}`,
+      path: apiPath`/v1/{account_id}/sales-navigator/account-lists/${listId}`,
       body: body ?? {},
       ...query ? { query } : {}
     });
@@ -1673,37 +1723,37 @@ var SalesNavigatorResource = class {
   browseLeadList(listId, body, query) {
     return this.ctx.request({
       method: "POST",
-      path: `/v1/{account_id}/sales-navigator/lead-lists/${listId}`,
+      path: apiPath`/v1/{account_id}/sales-navigator/lead-lists/${listId}`,
       body: body ?? {},
       ...query ? { query } : {}
     });
   }
   /**
-   * 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) {
     const { list_id, ...body } = input;
     return this.ctx.request({
       method: "POST",
-      path: `/v1/{account_id}/sales-navigator/account-lists/${list_id}/save`,
+      path: apiPath`/v1/{account_id}/sales-navigator/account-lists/${list_id}/save`,
       body
     });
   }
   /**
-   * 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) {
     const { list_id, ...body } = input;
     return this.ctx.request({
       method: "POST",
-      path: `/v1/{account_id}/sales-navigator/lead-lists/${list_id}/save`,
+      path: apiPath`/v1/{account_id}/sales-navigator/lead-lists/${list_id}/save`,
       body
     });
   }
@@ -1752,12 +1802,12 @@ var RecruiterResource = class {
   getProfile(identifier, params) {
     return this.ctx.request({
       method: "GET",
-      path: `/v1/{account_id}/recruiter/profiles/${identifier}`,
+      path: apiPath`/v1/{account_id}/recruiter/profiles/${identifier}`,
       ...params ? { query: params } : {}
     });
   }
   /**
-   * 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 +1832,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) {
@@ -1802,13 +1852,13 @@ var RecruiterResource = class {
   searchTalentPool(projectId, body, params) {
     return this.ctx.request({
       method: "POST",
-      path: `/v1/{account_id}/recruiter/projects/${projectId}/talent-pool/search`,
+      path: apiPath`/v1/{account_id}/recruiter/projects/${projectId}/talent-pool/search`,
       body,
       ...params ? { query: params } : {}
     });
   }
   /**
-   * 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`
@@ -1839,18 +1889,18 @@ var RecruiterResource = class {
   getProject(projectId) {
     return this.ctx.request({
       method: "GET",
-      path: `/v1/{account_id}/recruiter/projects/${projectId}`
+      path: apiPath`/v1/{account_id}/recruiter/projects/${projectId}`
     });
   }
   /**
-   * 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}`
    */
   updateProject(projectId, body) {
     return this.ctx.request({
       method: "PATCH",
-      path: `/v1/{account_id}/recruiter/projects/${projectId}`,
+      path: apiPath`/v1/{account_id}/recruiter/projects/${projectId}`,
       body
     });
   }
@@ -1863,48 +1913,48 @@ var RecruiterResource = class {
   listPipeline(projectId, body = {}, params) {
     return this.ctx.request({
       method: "POST",
-      path: `/v1/{account_id}/recruiter/projects/${projectId}/pipeline`,
+      path: apiPath`/v1/{account_id}/recruiter/projects/${projectId}/pipeline`,
       body,
       ...params ? { query: params } : {}
     });
   }
   /**
    * 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) {
     return this.ctx.request({
       method: "GET",
-      path: `/v1/{account_id}/recruiter/projects/${projectId}/jobs`
+      path: apiPath`/v1/{account_id}/recruiter/projects/${projectId}/jobs`
     });
   }
   /**
-   * 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`
    */
   createProjectJob(projectId, body) {
     return this.ctx.request({
       method: "POST",
-      path: `/v1/{account_id}/recruiter/projects/${projectId}/jobs`,
+      path: apiPath`/v1/{account_id}/recruiter/projects/${projectId}/jobs`,
       body
     });
   }
   /**
-   * 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`
    */
   getProjectJobBudget(projectId, jobId) {
     return this.ctx.request({
       method: "GET",
-      path: `/v1/{account_id}/recruiter/projects/${projectId}/jobs/${jobId}/budget`
+      path: apiPath`/v1/{account_id}/recruiter/projects/${projectId}/jobs/${jobId}/budget`
     });
   }
   /**
-   * 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 +1981,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.
@@ -1940,11 +1990,11 @@ var RecruiterResource = class {
     const jobId = resolveJobId(jobIdOrUrl);
     return this.ctx.request({
       method: "GET",
-      path: `/v1/{account_id}/recruiter/jobs/${jobId}`
+      path: apiPath`/v1/{account_id}/recruiter/jobs/${jobId}`
     });
   }
   /**
-   * 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}`
@@ -1952,14 +2002,14 @@ var RecruiterResource = class {
   updateProjectJob(projectId, jobId, body) {
     return this.ctx.request({
       method: "PATCH",
-      path: `/v1/{account_id}/recruiter/projects/${projectId}/jobs/${jobId}`,
+      path: apiPath`/v1/{account_id}/recruiter/projects/${projectId}/jobs/${jobId}`,
       body
     });
   }
   /**
    * 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`
@@ -1967,31 +2017,31 @@ var RecruiterResource = class {
   publishJob(projectId, jobId, body) {
     return this.ctx.request({
       method: "POST",
-      path: `/v1/{account_id}/recruiter/projects/${projectId}/jobs/${jobId}/publish`,
+      path: apiPath`/v1/{account_id}/recruiter/projects/${projectId}/jobs/${jobId}/publish`,
       body
     });
   }
   /**
    * 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) {
     return this.ctx.request({
       method: "POST",
-      path: `/v1/{account_id}/recruiter/projects/${projectId}/jobs/${jobId}/close`
+      path: apiPath`/v1/{account_id}/recruiter/projects/${projectId}/jobs/${jobId}/close`
     });
   }
   /**
    * 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) {
     return this.ctx.request({
       method: "POST",
-      path: `/v1/{account_id}/recruiter/projects/${projectId}/pipeline/candidate/save`,
+      path: apiPath`/v1/{account_id}/recruiter/projects/${projectId}/pipeline/candidate/save`,
       body
     });
   }
@@ -2004,7 +2054,7 @@ var RecruiterResource = class {
   listApplicants(projectId, body, params) {
     return this.ctx.request({
       method: "POST",
-      path: `/v1/{account_id}/recruiter/projects/${projectId}/talent-pool/applicants`,
+      path: apiPath`/v1/{account_id}/recruiter/projects/${projectId}/talent-pool/applicants`,
       body,
       ...params ? { query: params } : {}
     });
@@ -2016,18 +2066,18 @@ var RecruiterResource = class {
   getApplicant(projectId, applicantId) {
     return this.ctx.request({
       method: "GET",
-      path: `/v1/{account_id}/recruiter/projects/${projectId}/talent-pool/applicants/${applicantId}`
+      path: apiPath`/v1/{account_id}/recruiter/projects/${projectId}/talent-pool/applicants/${applicantId}`
     });
   }
   /**
    * 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({
       method: "GET",
-      path: `/v1/{account_id}/recruiter/projects/${projectId}/talent-pool/applicants/${applicantId}/resume`
+      path: apiPath`/v1/{account_id}/recruiter/projects/${projectId}/talent-pool/applicants/${applicantId}/resume`
     });
   }
 };
@@ -2040,7 +2090,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 +2116,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.
@@ -2075,43 +2125,43 @@ var JobsResource = class {
     const jobId = resolveJobId(jobIdOrUrl);
     return this.ctx.request({
       method: "GET",
-      path: `/v1/{account_id}/jobs/${jobId}`,
+      path: apiPath`/v1/{account_id}/jobs/${jobId}`,
       ...params ? { query: params } : {}
     });
   }
   /**
-   * 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}`
    */
   update(jobId, body) {
     return this.ctx.request({
       method: "PATCH",
-      path: `/v1/{account_id}/jobs/${jobId}`,
+      path: apiPath`/v1/{account_id}/jobs/${jobId}`,
       body
     });
   }
   /**
-   * 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) {
     return this.ctx.request({
       method: "GET",
-      path: `/v1/{account_id}/jobs/${jobId}/budget`
+      path: apiPath`/v1/{account_id}/jobs/${jobId}/budget`
     });
   }
   /**
    * 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`
    */
   publish(jobId, body) {
     return this.ctx.request({
       method: "POST",
-      path: `/v1/{account_id}/jobs/${jobId}/publish`,
+      path: apiPath`/v1/{account_id}/jobs/${jobId}/publish`,
       body
     });
   }
@@ -2123,11 +2173,11 @@ var JobsResource = class {
   close(jobId) {
     return this.ctx.request({
       method: "POST",
-      path: `/v1/{account_id}/jobs/${jobId}/close`
+      path: apiPath`/v1/{account_id}/jobs/${jobId}/close`
     });
   }
   /**
-   * 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.
@@ -2138,7 +2188,7 @@ var JobsResource = class {
     const hasQuery = cursor !== void 0 || limit !== void 0;
     return this.ctx.request({
       method: "POST",
-      path: `/v1/{account_id}/jobs/${jobId}/applicants`,
+      path: apiPath`/v1/{account_id}/jobs/${jobId}/applicants`,
       body,
       ...hasQuery ? {
         query: {
@@ -2155,18 +2205,18 @@ var JobsResource = class {
   getApplicant(jobId, applicantId) {
     return this.ctx.request({
       method: "GET",
-      path: `/v1/{account_id}/jobs/${jobId}/applicants/${applicantId}`
+      path: apiPath`/v1/{account_id}/jobs/${jobId}/applicants/${applicantId}`
     });
   }
   /**
    * 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({
       method: "GET",
-      path: `/v1/{account_id}/jobs/${jobId}/applicants/${applicantId}/resume`
+      path: apiPath`/v1/{account_id}/jobs/${jobId}/applicants/${applicantId}/resume`
     });
   }
 };
@@ -2186,22 +2236,22 @@ var CompaniesResource = class {
   get(identifier) {
     return this.ctx.request({
       method: "GET",
-      path: `/v1/{account_id}/companies/${identifier}`
+      path: apiPath`/v1/{account_id}/companies/${identifier}`
     });
   }
   /**
    * 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) {
     return this.ctx.request({
       method: "GET",
-      path: `/v1/{account_id}/companies/${identifier}/employees`,
+      path: apiPath`/v1/{account_id}/companies/${identifier}/employees`,
       ...params ? { query: params } : {}
     });
   }
@@ -2215,7 +2265,7 @@ var CompaniesResource = class {
   posts(identifier, params) {
     return this.ctx.request({
       method: "GET",
-      path: `/v1/{account_id}/companies/${identifier}/posts`,
+      path: apiPath`/v1/{account_id}/companies/${identifier}/posts`,
       ...params ? { query: params } : {}
     });
   }
@@ -2223,7 +2273,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.
@@ -2231,7 +2281,7 @@ var CompaniesResource = class {
   jobs(identifier, params) {
     return this.ctx.request({
       method: "GET",
-      path: `/v1/{account_id}/companies/${identifier}/jobs`,
+      path: apiPath`/v1/{account_id}/companies/${identifier}/jobs`,
       ...params ? { query: params } : {}
     });
   }
@@ -2241,7 +2291,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({
@@ -2260,7 +2310,7 @@ var CompaniesResource = class {
   followers(identifier, params) {
     return this.ctx.request({
       method: "GET",
-      path: `/v1/{account_id}/companies/${identifier}/followers`,
+      path: apiPath`/v1/{account_id}/companies/${identifier}/followers`,
       ...params ? { query: params } : {}
     });
   }
@@ -2269,13 +2319,13 @@ 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) {
     return this.ctx.request({
       method: "GET",
-      path: `/v1/{account_id}/companies/${identifier}/invitable-followers`,
+      path: apiPath`/v1/{account_id}/companies/${identifier}/invitable-followers`,
       ...params ? { query: params } : {}
     });
   }
@@ -2285,7 +2335,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.
@@ -2295,7 +2345,7 @@ var CompaniesResource = class {
   followInvite(identifier, body) {
     return this.ctx.request({
       method: "POST",
-      path: `/v1/{account_id}/companies/${identifier}/follow-invite`,
+      path: apiPath`/v1/{account_id}/companies/${identifier}/follow-invite`,
       body
     });
   }
@@ -2306,14 +2356,14 @@ 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.
    */
   chats(identifier, params) {
     return this.ctx.request({
       method: "GET",
-      path: `/v1/{account_id}/companies/${identifier}/chats`,
+      path: apiPath`/v1/{account_id}/companies/${identifier}/chats`,
       ...params ? { query: params } : {}
     });
   }
@@ -2321,12 +2371,12 @@ 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({
       method: "GET",
-      path: `/v1/{account_id}/companies/${identifier}/chats/${chatId}`
+      path: apiPath`/v1/{account_id}/companies/${identifier}/chats/${chatId}`
     });
   }
   /**
@@ -2334,12 +2384,12 @@ 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({
       method: "GET",
-      path: `/v1/{account_id}/companies/${identifier}/chats/${chatId}/messages`,
+      path: apiPath`/v1/{account_id}/companies/${identifier}/chats/${chatId}/messages`,
       ...params ? { query: params } : {}
     });
   }
@@ -2347,12 +2397,12 @@ 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({
       method: "GET",
-      path: `/v1/{account_id}/companies/${identifier}/chats/${chatId}/messages/${messageId}`
+      path: apiPath`/v1/{account_id}/companies/${identifier}/chats/${chatId}/messages/${messageId}`
     });
   }
   /**
@@ -2360,14 +2410,14 @@ 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({
       method: "GET",
-      path: `/v1/{account_id}/companies/${identifier}/chats/search`,
+      path: apiPath`/v1/{account_id}/companies/${identifier}/chats/search`,
       ...params ? { query: params } : {}
     });
   }
@@ -2375,7 +2425,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.
@@ -2404,7 +2454,7 @@ var CompaniesResource = class {
   sendMessage(identifier, chatId, body) {
     return this.ctx.request({
       method: "POST",
-      path: `/v1/{account_id}/companies/${identifier}/chats/${chatId}/messages`,
+      path: apiPath`/v1/{account_id}/companies/${identifier}/chats/${chatId}/messages`,
       body
     });
   }
@@ -2440,7 +2490,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,12 +2504,12 @@ 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({
       method: "GET",
-      path: `/v1/webhooks/${id}`
+      path: apiPath`/v1/webhooks/${id}`
     });
   }
   /**
@@ -2467,7 +2519,7 @@ var WebhooksResource = class {
   update(id, body) {
     return this.ctx.request({
       method: "PATCH",
-      path: `/v1/webhooks/${id}`,
+      path: apiPath`/v1/webhooks/${id}`,
       body
     });
   }
@@ -2478,7 +2530,7 @@ var WebhooksResource = class {
   delete(id) {
     return this.ctx.request({
       method: "DELETE",
-      path: `/v1/webhooks/${id}`
+      path: apiPath`/v1/webhooks/${id}`
     });
   }
 };
@@ -2540,7 +2592,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