@curviate/sdk 0.4.1 → 0.5.0

package/CHANGELOG.md

@@ -7,6 +7,37 @@ Versioning: semantic — minor for additive changes, patch for bug fixes; no sta
 
 ---
 
+## [0.5.0] — 2026-07-01
+
+### Added
+
+- Posts search gains nested `posted_by`, `mentioning`, and `author` filter objects. `posted_by` and `mentioning` take `member` / `company` arrays of opaque IDs (from `GET /v1/search/parameters`); `posted_by` also accepts `me`, `first_connections`, and `people_you_follow` booleans; `author` filters by `industry`, `company`, or `keywords`.
+- Search-parameters items (`GET /v1/search/parameters`) now carry nullable company-disambiguation fields — `industry`, `location`, `headcount` (human-readable size range), and `followers_count` — populated only for `type=COMPANY` results.
+
+### Changed
+
+- **Breaking (typed consumers):** people-search `connections_of` and `followers_of` are now arrays of opaque member IDs (`string[]`) instead of a single `string`. Pass one or more IDs resolved from `GET /v1/search/parameters`.
+- **Breaking (typed consumers):** posts-search replaces the flat `member_urn` / `company_urn` filters with the nested `posted_by` / `mentioning` / `author` objects described above.
+- **Breaking (typed consumers):** jobs-search `location_within_area` is now a `number` (search radius in miles) instead of a `string`.
+- Company-size (`headcount`) bucket bounds are documented with their explicit valid values.
+- De-branded the four search method summaries in the SDK JSDoc (`Search people/companies/posts/jobs`).
+- Regenerated types from the current API surface.
+
+---
+
+## [0.4.2] — 2026-07-01
+
+### Added
+
+- Invitation item `specifics` now includes `provider: "LINKEDIN"` on both `InvitationSent` and `InvitationReceived` — the platform the invitation belongs to, passed through alongside `shared_secret`.
+
+### Changed
+
+- Removed the `422` response from `invites.cancel` (`DELETE /v1/invites/{invitation_id}`) and `invites.respond` (`POST /v1/invites/received/{invitation_id}`): cancel is idempotent (`canceled`/`not_found` only) and a non-pending handle returns `not_found`, so neither surfaces an account-restricted `422`.
+- Regenerated types from the current API surface, consolidating the invitation-item changes on top of the 0.4.1 people-search and 0.4.0 profile/messaging types.
+
+---
+
 ## [0.4.1] — 2026-06-30
 
 ### Added

package/dist/index.d.ts

@@ -1903,6 +1903,11 @@ interface paths {
                                 } | null;
                                 /** @description Platform-specific invitation metadata. */
                                 specifics?: {
+                                    /**
+                                     * @description The platform this invitation belongs to.
+                                     * @enum {string}
+                                     */
+                                    provider?: "LINKEDIN";
                                     /** @description Per-invitation token from the platform. Content pass-through — never stored. */
                                     shared_secret?: string | null;
                                 };
@@ -2083,6 +2088,11 @@ interface paths {
                                 } | null;
                                 /** @description Platform-specific invitation metadata. */
                                 specifics?: {
+                                    /**
+                                     * @description The platform this invitation belongs to.
+                                     * @enum {string}
+                                     */
+                                    provider?: "LINKEDIN";
                                     /** @description Per-invitation token required to accept or decline this invitation via POST /v1/invites/received/{invitation_id}. Content pass-through — never stored. */
                                     shared_secret?: string | null;
                                 };
@@ -2281,15 +2291,6 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Account restricted from performing this operation. */
-                422: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
                 /** @description Quota exceeded — slow down and retry after the hinted delay. */
                 429: {
                     headers: {
@@ -2426,15 +2427,6 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Account restricted from performing this operation. */
-                422: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
                 /** @description Quota exceeded — slow down and retry after the hinted delay. */
                 429: {
                     headers: {
@@ -13085,6 +13077,14 @@ interface paths {
                                 title: string;
                                 /** @description Optional image URL for this filter value (e.g. company logo). Present when available. */
                                 picture_url?: string;
+                                /** @description Industry the company operates in. Present (nullable) only for type=COMPANY, to disambiguate same-named companies. */
+                                industry?: string | null;
+                                /** @description Company follower count. Present (nullable) only for type=COMPANY. */
+                                followers_count?: number | null;
+                                /** @description Human-readable company size range (e.g. '51-200'). Present (nullable) only for type=COMPANY. */
+                                headcount?: string | null;
+                                /** @description Company headquarters location. Present (nullable) only for type=COMPANY. */
+                                location?: string | null;
                             }[];
                             /** @description Paging metadata. */
                             paging: {
@@ -13198,7 +13198,7 @@ interface paths {
         get?: never;
         put?: never;
         /**
-         * Search LinkedIn people
+         * Search people
          * @description Searches LinkedIn profiles using structured filters or a pasted LinkedIn search URL. The two modes are mutually exclusive: supply either url or structured filters, not both. account_id and pagination live in query params; filters in the request body.
          */
         post: {
@@ -13247,10 +13247,10 @@ interface paths {
                         school?: string[];
                         /** @description Opaque service IDs from GET /v1/search/parameters?type=SERVICE. */
                         service?: string[];
-                        /** @description Filter to connections of a specific member URN. */
-                        connections_of?: string;
-                        /** @description Filter to followers of a specific member URN. */
-                        followers_of?: string;
+                        /** @description Filter to connections of the given members. Array of opaque member IDs from GET /v1/search/parameters?type=CONNECTIONS. */
+                        connections_of?: string[];
+                        /** @description Filter to followers of the given members. Array of opaque member IDs from GET /v1/search/parameters?type=PEOPLE. */
+                        followers_of?: string[];
                         /** @description Filter by network distance: 1 = 1st degree, 2 = 2nd degree, 3 = 3rd degree. */
                         network_distance?: (1 | 2 | 3)[];
                         /** @description Filter by profile language codes. */
@@ -13476,7 +13476,7 @@ interface paths {
         get?: never;
         put?: never;
         /**
-         * Search LinkedIn companies
+         * Search companies
          * @description Searches LinkedIn companies using structured filters or a pasted LinkedIn search URL. The two modes are mutually exclusive. No company description or tagline is returned.
          */
         post: {
@@ -13508,9 +13508,9 @@ interface paths {
                         has_job_offers?: boolean;
                         /** @description Filter by company size buckets. Each entry is a { min, max } object (e.g. { min: 51, max: 200 }). */
                         headcount?: {
-                            /** @description Minimum headcount for this bucket. */
+                            /** @description Lower bound of a company-size bucket. Valid values: 1, 11, 51, 201, 501, 1001, 5001, 10001. */
                             min: number;
-                            /** @description Maximum headcount for this bucket. */
+                            /** @description Upper bound of a company-size bucket. Valid values: 1, 10, 50, 200, 500, 1000, 5000, 10000. */
                             max: number;
                         }[];
                         /** @description Filter by network distance: 1 = 1st degree, 2 = 2nd degree, 3 = 3rd degree. */
@@ -13680,7 +13680,7 @@ interface paths {
         get?: never;
         put?: never;
         /**
-         * Search LinkedIn posts
+         * Search posts
          * @description Searches LinkedIn posts using structured filters or a pasted LinkedIn search URL. The two modes are mutually exclusive. Post body text is never returned — results carry the post URN and engagement metadata only.
          */
         post: {
@@ -13719,22 +13719,34 @@ interface paths {
                          * @enum {string}
                          */
                         content_type?: "videos" | "images" | "live_videos" | "collaborative_articles" | "documents";
-                        /** @description Filter to posts by a specific member. */
+                        /** @description Filter to posts by specific authors (members, companies, yourself, connections, or people you follow). */
                         posted_by?: {
-                            /** @description LinkedIn member URN (e.g. urn:li:member:123). */
-                            member_urn?: string;
-                        };
-                        /** @description Filter to posts mentioning a specific member. */
+                            /** @description Opaque member IDs from GET /v1/search/parameters?type=PEOPLE. */
+                            member?: string[];
+                            /** @description Opaque company IDs from GET /v1/search/parameters?type=COMPANY. */
+                            company?: string[];
+                            /** @description Restrict to your own posts. */
+                            me?: boolean;
+                            /** @description Restrict to posts by your 1st-degree connections. */
+                            first_connections?: boolean;
+                            /** @description Restrict to posts by people you follow. */
+                            people_you_follow?: boolean;
+                        };
+                        /** @description Filter to posts mentioning specific members or companies. */
                         mentioning?: {
-                            /** @description LinkedIn member URN (e.g. urn:li:member:123). */
-                            member_urn?: string;
+                            /** @description Opaque member IDs from GET /v1/search/parameters?type=PEOPLE. */
+                            member?: string[];
+                            /** @description Opaque company IDs from GET /v1/search/parameters?type=COMPANY. */
+                            company?: string[];
                         };
-                        /** @description Filter to posts from a specific author (company or member). */
+                        /** @description Filter to posts by author attributes (industry, company, or keywords). */
                         author?: {
-                            /** @description LinkedIn organization URN (e.g. urn:li:organization:456). */
-                            company_urn?: string;
-                            /** @description LinkedIn member URN (e.g. urn:li:member:123). */
-                            member_urn?: string;
+                            /** @description Opaque industry IDs from GET /v1/search/parameters?type=INDUSTRY. */
+                            industry?: string[];
+                            /** @description Opaque company IDs from GET /v1/search/parameters?type=COMPANY. */
+                            company?: string[];
+                            /** @description Free-text keyword match on the author. */
+                            keywords?: string;
                         };
                     };
                 };
@@ -13948,7 +13960,7 @@ interface paths {
         get?: never;
         put?: never;
         /**
-         * Search LinkedIn jobs
+         * Search jobs
          * @description Searches LinkedIn job postings using structured filters or a pasted LinkedIn jobs URL. The two modes are mutually exclusive. Job description text is never returned.
          */
         post: {
@@ -13983,8 +13995,8 @@ interface paths {
                         region?: string;
                         /** @description Opaque location IDs from GET /v1/search/parameters?type=LOCATION. */
                         location?: string[];
-                        /** @description Location area string filter. */
-                        location_within_area?: string;
+                        /** @description Search radius around the location, in miles (positive number). */
+                        location_within_area?: number;
                         /** @description Opaque industry IDs from GET /v1/search/parameters?type=INDUSTRY. */
                         industry?: string[];
                         /** @description Filter by seniority levels. */
@@ -15317,7 +15329,7 @@ declare class SearchResource {
      */
     getParameters(query: SearchParametersQuery): Promise<SearchParametersResult>;
     /**
-     * Search LinkedIn people with structured filters or a pasted URL.
+     * Search people with structured filters or a pasted URL.
      * `POST /v1/search/people`
      * Cursor passed via query param (not body) — matches the OpenAPI spec.
      */
@@ -15326,7 +15338,7 @@ declare class SearchResource {
         limit?: number;
     }): Promise<SearchPeopleResult>;
     /**
-     * Search LinkedIn companies.
+     * Search companies.
      * `POST /v1/search/companies`
      */
     companies(body: SearchCompaniesBody & {
@@ -15334,7 +15346,7 @@ declare class SearchResource {
         limit?: number;
     }): Promise<SearchCompaniesResult>;
     /**
-     * Search LinkedIn posts.
+     * Search posts.
      * `POST /v1/search/posts`
      */
     posts(body: SearchPostsBody & {
@@ -15342,7 +15354,7 @@ declare class SearchResource {
         limit?: number;
     }): Promise<SearchPostsResult>;
     /**
-     * Search LinkedIn jobs.
+     * Search jobs.
      * `POST /v1/search/jobs`
      */
     jobs(body: SearchJobsBody & {

package/dist/index.js

@@ -740,7 +740,7 @@ var SearchResource = class {
     });
   }
   /**
-   * Search LinkedIn people with structured filters or a pasted URL.
+   * Search people with structured filters or a pasted URL.
    * `POST /v1/search/people`
    * Cursor passed via query param (not body) — matches the OpenAPI spec.
    */
@@ -754,7 +754,7 @@ var SearchResource = class {
     });
   }
   /**
-   * Search LinkedIn companies.
+   * Search companies.
    * `POST /v1/search/companies`
    */
   companies(body) {
@@ -767,7 +767,7 @@ var SearchResource = class {
     });
   }
   /**
-   * Search LinkedIn posts.
+   * Search posts.
    * `POST /v1/search/posts`
    */
   posts(body) {
@@ -780,7 +780,7 @@ var SearchResource = class {
     });
   }
   /**
-   * Search LinkedIn jobs.
+   * Search jobs.
    * `POST /v1/search/jobs`
    */
   jobs(body) {

package/package.json

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

package/src/generated/types.ts

@@ -1794,6 +1794,11 @@ export interface paths {
                                 } | null;
                                 /** @description Platform-specific invitation metadata. */
                                 specifics?: {
+                                    /**
+                                     * @description The platform this invitation belongs to.
+                                     * @enum {string}
+                                     */
+                                    provider?: "LINKEDIN";
                                     /** @description Per-invitation token from the platform. Content pass-through — never stored. */
                                     shared_secret?: string | null;
                                 };
@@ -1974,6 +1979,11 @@ export interface paths {
                                 } | null;
                                 /** @description Platform-specific invitation metadata. */
                                 specifics?: {
+                                    /**
+                                     * @description The platform this invitation belongs to.
+                                     * @enum {string}
+                                     */
+                                    provider?: "LINKEDIN";
                                     /** @description Per-invitation token required to accept or decline this invitation via POST /v1/invites/received/{invitation_id}. Content pass-through — never stored. */
                                     shared_secret?: string | null;
                                 };
@@ -2172,15 +2182,6 @@ export interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Account restricted from performing this operation. */
-                422: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
                 /** @description Quota exceeded — slow down and retry after the hinted delay. */
                 429: {
                     headers: {
@@ -2317,15 +2318,6 @@ export interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Account restricted from performing this operation. */
-                422: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
                 /** @description Quota exceeded — slow down and retry after the hinted delay. */
                 429: {
                     headers: {
@@ -12976,6 +12968,14 @@ export interface paths {
                                 title: string;
                                 /** @description Optional image URL for this filter value (e.g. company logo). Present when available. */
                                 picture_url?: string;
+                                /** @description Industry the company operates in. Present (nullable) only for type=COMPANY, to disambiguate same-named companies. */
+                                industry?: string | null;
+                                /** @description Company follower count. Present (nullable) only for type=COMPANY. */
+                                followers_count?: number | null;
+                                /** @description Human-readable company size range (e.g. '51-200'). Present (nullable) only for type=COMPANY. */
+                                headcount?: string | null;
+                                /** @description Company headquarters location. Present (nullable) only for type=COMPANY. */
+                                location?: string | null;
                             }[];
                             /** @description Paging metadata. */
                             paging: {
@@ -13089,7 +13089,7 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Search LinkedIn people
+         * Search people
          * @description Searches LinkedIn profiles using structured filters or a pasted LinkedIn search URL. The two modes are mutually exclusive: supply either url or structured filters, not both. account_id and pagination live in query params; filters in the request body.
          */
         post: {
@@ -13138,10 +13138,10 @@ export interface paths {
                         school?: string[];
                         /** @description Opaque service IDs from GET /v1/search/parameters?type=SERVICE. */
                         service?: string[];
-                        /** @description Filter to connections of a specific member URN. */
-                        connections_of?: string;
-                        /** @description Filter to followers of a specific member URN. */
-                        followers_of?: string;
+                        /** @description Filter to connections of the given members. Array of opaque member IDs from GET /v1/search/parameters?type=CONNECTIONS. */
+                        connections_of?: string[];
+                        /** @description Filter to followers of the given members. Array of opaque member IDs from GET /v1/search/parameters?type=PEOPLE. */
+                        followers_of?: string[];
                         /** @description Filter by network distance: 1 = 1st degree, 2 = 2nd degree, 3 = 3rd degree. */
                         network_distance?: (1 | 2 | 3)[];
                         /** @description Filter by profile language codes. */
@@ -13367,7 +13367,7 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Search LinkedIn companies
+         * Search companies
          * @description Searches LinkedIn companies using structured filters or a pasted LinkedIn search URL. The two modes are mutually exclusive. No company description or tagline is returned.
          */
         post: {
@@ -13399,9 +13399,9 @@ export interface paths {
                         has_job_offers?: boolean;
                         /** @description Filter by company size buckets. Each entry is a { min, max } object (e.g. { min: 51, max: 200 }). */
                         headcount?: {
-                            /** @description Minimum headcount for this bucket. */
+                            /** @description Lower bound of a company-size bucket. Valid values: 1, 11, 51, 201, 501, 1001, 5001, 10001. */
                             min: number;
-                            /** @description Maximum headcount for this bucket. */
+                            /** @description Upper bound of a company-size bucket. Valid values: 1, 10, 50, 200, 500, 1000, 5000, 10000. */
                             max: number;
                         }[];
                         /** @description Filter by network distance: 1 = 1st degree, 2 = 2nd degree, 3 = 3rd degree. */
@@ -13571,7 +13571,7 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Search LinkedIn posts
+         * Search posts
          * @description Searches LinkedIn posts using structured filters or a pasted LinkedIn search URL. The two modes are mutually exclusive. Post body text is never returned — results carry the post URN and engagement metadata only.
          */
         post: {
@@ -13610,22 +13610,34 @@ export interface paths {
                          * @enum {string}
                          */
                         content_type?: "videos" | "images" | "live_videos" | "collaborative_articles" | "documents";
-                        /** @description Filter to posts by a specific member. */
+                        /** @description Filter to posts by specific authors (members, companies, yourself, connections, or people you follow). */
                         posted_by?: {
-                            /** @description LinkedIn member URN (e.g. urn:li:member:123). */
-                            member_urn?: string;
-                        };
-                        /** @description Filter to posts mentioning a specific member. */
+                            /** @description Opaque member IDs from GET /v1/search/parameters?type=PEOPLE. */
+                            member?: string[];
+                            /** @description Opaque company IDs from GET /v1/search/parameters?type=COMPANY. */
+                            company?: string[];
+                            /** @description Restrict to your own posts. */
+                            me?: boolean;
+                            /** @description Restrict to posts by your 1st-degree connections. */
+                            first_connections?: boolean;
+                            /** @description Restrict to posts by people you follow. */
+                            people_you_follow?: boolean;
+                        };
+                        /** @description Filter to posts mentioning specific members or companies. */
                         mentioning?: {
-                            /** @description LinkedIn member URN (e.g. urn:li:member:123). */
-                            member_urn?: string;
+                            /** @description Opaque member IDs from GET /v1/search/parameters?type=PEOPLE. */
+                            member?: string[];
+                            /** @description Opaque company IDs from GET /v1/search/parameters?type=COMPANY. */
+                            company?: string[];
                         };
-                        /** @description Filter to posts from a specific author (company or member). */
+                        /** @description Filter to posts by author attributes (industry, company, or keywords). */
                         author?: {
-                            /** @description LinkedIn organization URN (e.g. urn:li:organization:456). */
-                            company_urn?: string;
-                            /** @description LinkedIn member URN (e.g. urn:li:member:123). */
-                            member_urn?: string;
+                            /** @description Opaque industry IDs from GET /v1/search/parameters?type=INDUSTRY. */
+                            industry?: string[];
+                            /** @description Opaque company IDs from GET /v1/search/parameters?type=COMPANY. */
+                            company?: string[];
+                            /** @description Free-text keyword match on the author. */
+                            keywords?: string;
                         };
                     };
                 };
@@ -13839,7 +13851,7 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Search LinkedIn jobs
+         * Search jobs
          * @description Searches LinkedIn job postings using structured filters or a pasted LinkedIn jobs URL. The two modes are mutually exclusive. Job description text is never returned.
          */
         post: {
@@ -13874,8 +13886,8 @@ export interface paths {
                         region?: string;
                         /** @description Opaque location IDs from GET /v1/search/parameters?type=LOCATION. */
                         location?: string[];
-                        /** @description Location area string filter. */
-                        location_within_area?: string;
+                        /** @description Search radius around the location, in miles (positive number). */
+                        location_within_area?: number;
                         /** @description Opaque industry IDs from GET /v1/search/parameters?type=INDUSTRY. */
                         industry?: string[];
                         /** @description Filter by seniority levels. */