@curviate/sdk 0.35.0 → 0.36.0

package/CHANGELOG.md

@@ -9,6 +9,30 @@ Versioning: semantic. Minor for additive changes, patch for bug fixes; no stabil
 
 ## [Unreleased]
 
+## [0.36.0] - 2026-09-20
+
+Fixture and types regenerated against the deployed production document
+(`https://api.curviate.com`, 127 paths, server
+`41d48ed451280c29b0fb6b4b15c44ca70b76af98`). One additive shape change.
+
+### Added
+
+- **`search.getParameters()` accepts `cursor`.** The filter-ID resolver
+  paginates: `SearchParametersQuery` gains an optional `cursor`, and the
+  response's `cursor` field is the token to send back for the next page. Walk
+  until it comes back `null`. `offset` still works and is now described as the
+  numeric fallback for `cursor`. A malformed cursor is a `400`. Additive and
+  backward compatible: a call that passes no `cursor` behaves exactly as
+  before.
+
+### Changed
+
+- Regenerated descriptions on `GET /v1/{account_id}/search/parameters`: the
+  operation description now states how the pages are walked, `offset` names
+  itself the numeric fallback, and the `400` description names a malformed
+  cursor among its causes.
+- `search.getParameters()` carries a paging `@example` in its JSDoc.
+
 ## [0.35.0] - 2026-09-19
 
 Fixture and types regenerated a second time against the deployed production
@@ -25,7 +49,7 @@ nothing added, removed or retyped.
   Present when populated. Reading it back through Curviate stores it in your
   tenant's entity records, with no expiry."
 
-First refresh in this Unreleased batch, against production server
+First refresh in this release, against production server
 `00a1388d42b09db54424de12ecf1c7cbebe2ec12`: 23 description strings and 3
 example values changed, nothing added, removed or retyped.
 

package/dist/index.d.ts

@@ -661,7 +661,7 @@ interface paths {
         };
         /**
          * Resolve search filter IDs
-         * @description Resolves human-readable terms (e.g. 'software development') to opaque filter IDs for use in structured search filters. The type parameter selects the filter category; keywords is required for every type, including EMPLOYMENT_TYPE.
+         * @description Resolves human-readable terms (e.g. 'software development') to opaque filter IDs for use in structured search filters. The type parameter selects the filter category; keywords is required for every type, including EMPLOYMENT_TYPE. Results paginate: send the cursor from the previous response to get the next page, and stop when it comes back null.
          */
         get: operations["getV1AccountIdSearchParameters"];
         put?: never;
@@ -8420,10 +8420,12 @@ interface operations {
                 type: "LOCATION" | "PEOPLE" | "RELATION" | "COMPANY" | "SCHOOL" | "INDUSTRY" | "SERVICE" | "JOB_FUNCTION" | "JOB_TITLE" | "EMPLOYMENT_TYPE" | "SKILL";
                 /** @description Human term to resolve to opaque filter IDs (e.g. 'software development'). Required for every type, including EMPLOYMENT_TYPE. */
                 keywords: string;
-                /** @description Zero-based pagination offset (default 0). */
+                /** @description Zero-based pagination offset; a numeric fallback for cursor (default 0). */
                 offset?: number;
                 /** @description Number of parameters to return (1-100, default 10). */
                 limit?: number;
+                /** @description Opaque pagination cursor returned from a previous response. */
+                cursor?: string;
             };
             header?: never;
             path: {
@@ -8461,7 +8463,7 @@ interface operations {
                     };
                 };
             };
-            /** @description Missing or empty account_id, missing or empty type, missing keywords, or type not in the classic allowlist. */
+            /** @description Missing or empty account_id, missing or empty type, missing keywords, type not in the classic allowlist, or malformed cursor. */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -32138,6 +32140,24 @@ declare class SearchResource {
     /**
      * Resolve human-readable terms to opaque filter IDs for structured search.
      * `GET /v1/{account_id}/search/parameters`
+     *
+     * Paginated: the response carries a `cursor`, and sending it back as
+     * `cursor` returns the next page. Stop when it comes back `null`. `offset`
+     * stays available as the numeric fallback. A malformed cursor is a `400`.
+     *
+     * @example
+     * ```ts
+     * let cursor: string | null | undefined;
+     * do {
+     *   const page = await acc.search.getParameters({
+     *     type: "SKILL",
+     *     keywords: "software development",
+     *     ...(cursor ? { cursor } : {}),
+     *   });
+     *   for (const item of page.items) console.log(item.id, item.name);
+     *   cursor = page.cursor;
+     * } while (cursor);
+     * ```
      */
     getParameters(query: SearchParametersQuery): Promise<SearchParametersResult>;
     /**

package/dist/index.js

@@ -1132,6 +1132,24 @@ var SearchResource = class {
   /**
    * Resolve human-readable terms to opaque filter IDs for structured search.
    * `GET /v1/{account_id}/search/parameters`
+   *
+   * Paginated: the response carries a `cursor`, and sending it back as
+   * `cursor` returns the next page. Stop when it comes back `null`. `offset`
+   * stays available as the numeric fallback. A malformed cursor is a `400`.
+   *
+   * @example
+   * ```ts
+   * let cursor: string | null | undefined;
+   * do {
+   *   const page = await acc.search.getParameters({
+   *     type: "SKILL",
+   *     keywords: "software development",
+   *     ...(cursor ? { cursor } : {}),
+   *   });
+   *   for (const item of page.items) console.log(item.id, item.name);
+   *   cursor = page.cursor;
+   * } while (cursor);
+   * ```
    */
   getParameters(query) {
     return this.ctx.request({

package/package.json

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

package/src/generated/types.ts

@@ -563,7 +563,7 @@ export interface paths {
         };
         /**
          * Resolve search filter IDs
-         * @description Resolves human-readable terms (e.g. 'software development') to opaque filter IDs for use in structured search filters. The type parameter selects the filter category; keywords is required for every type, including EMPLOYMENT_TYPE.
+         * @description Resolves human-readable terms (e.g. 'software development') to opaque filter IDs for use in structured search filters. The type parameter selects the filter category; keywords is required for every type, including EMPLOYMENT_TYPE. Results paginate: send the cursor from the previous response to get the next page, and stop when it comes back null.
          */
         get: operations["getV1AccountIdSearchParameters"];
         put?: never;
@@ -8324,10 +8324,12 @@ export interface operations {
                 type: "LOCATION" | "PEOPLE" | "RELATION" | "COMPANY" | "SCHOOL" | "INDUSTRY" | "SERVICE" | "JOB_FUNCTION" | "JOB_TITLE" | "EMPLOYMENT_TYPE" | "SKILL";
                 /** @description Human term to resolve to opaque filter IDs (e.g. 'software development'). Required for every type, including EMPLOYMENT_TYPE. */
                 keywords: string;
-                /** @description Zero-based pagination offset (default 0). */
+                /** @description Zero-based pagination offset; a numeric fallback for cursor (default 0). */
                 offset?: number;
                 /** @description Number of parameters to return (1-100, default 10). */
                 limit?: number;
+                /** @description Opaque pagination cursor returned from a previous response. */
+                cursor?: string;
             };
             header?: never;
             path: {
@@ -8365,7 +8367,7 @@ export interface operations {
                     };
                 };
             };
-            /** @description Missing or empty account_id, missing or empty type, missing keywords, or type not in the classic allowlist. */
+            /** @description Missing or empty account_id, missing or empty type, missing keywords, type not in the classic allowlist, or malformed cursor. */
             400: {
                 headers: {
                     [name: string]: unknown;