featurebase-node 0.10.0 → 0.12.0

package/resources/feedback/posts/posts.js

@@ -289,6 +289,161 @@ class Posts extends resource_1.APIResource {
             ]),
         });
     }
+    /**
+     * Search feedback posts with a structured filter AST, full-text search, sorting,
+     * and cursor pagination.
+     *
+     * ### Two modes (combinable)
+     *
+     * - **Filter mode** — pass a structured `query` AST (and/or `sort`) and the
+     *   endpoint returns posts matching the filter, ordered by `sort` (default
+     *   `created_at:desc`). Same shape as `/v2/conversations/search`,
+     *   `/v2/companies/search`, `/v2/contacts/search`.
+     * - **Search mode** — pass a top-level `search` string and the endpoint runs a
+     *   hybrid full-text + vector search (BM25 + embeddings, semanticRatio 0.5) over
+     *   post `title` and `content`, returning matches ranked by relevance. Optional:
+     *   combine with `query` to constrain the search to a board / status / time
+     *   window, and/or `sort` to override relevance ranking with chronological order.
+     *
+     * ```json
+     * {
+     *   "search": "mobile dark mode",
+     *   "query": {
+     *     "operator": "AND",
+     *     "value": [
+     *       {
+     *         "field": "board_id",
+     *         "operator": "IN",
+     *         "value": ["507f1f77bcf86cd799439011"]
+     *       }
+     *     ]
+     *   },
+     *   "limit": 20
+     * }
+     * ```
+     *
+     * `search` is server-managed: no operators, no field selection, no special syntax
+     * — same plain-text contract as `/v2/conversations/search`. The string must be
+     * 1–500 characters; up to ~1024 BM25-tokenizer characters are forwarded to
+     * Turbopuffer (longer queries are truncated at a word boundary).
+     *
+     * ### Structured query AST
+     *
+     * Each clause has the shape `{ field, operator, value }`. You can pass a single
+     * clause or wrap up to 15 in a top-level `AND` group:
+     *
+     * ```json
+     * {
+     *   "query": {
+     *     "operator": "AND",
+     *     "value": [
+     *       {
+     *         "field": "board_id",
+     *         "operator": "IN",
+     *         "value": ["507f1f77bcf86cd799439011"]
+     *       },
+     *       { "field": "upvotes", "operator": ">", "value": 10 }
+     *     ]
+     *   },
+     *   "sort": "upvotes:desc",
+     *   "limit": 20
+     * }
+     * ```
+     *
+     * Top-level `OR` groups and nested groups are not supported in this version.
+     *
+     * ### Supported fields and operators
+     *
+     * | Field                                                             | Type                         | Operators                                          |
+     * | ----------------------------------------------------------------- | ---------------------------- | -------------------------------------------------- |
+     * | `board_id`                                                        | id (categoryId)              | `=`, `!=`, `IN`, `NIN`                             |
+     * | `status_id`                                                       | id (postStatus)              | `=`, `!=`, `IN`, `NIN`                             |
+     * | `tag_id`                                                          | id (postTags)                | `=`, `!=`, `IN`, `NIN`                             |
+     * | `author_id`                                                       | string (user id)             | `=`, `!=`, `IN`, `NIN`                             |
+     * | `assignee_id`                                                     | id or null (admin)           | `=`, `!=`, `IN`, `NIN` (use `null` for unassigned) |
+     * | `company_id`                                                      | string (external company id) | `=`, `!=`, `IN`, `NIN`                             |
+     * | `created_at`, `updated_at`, `eta`                                 | unix seconds                 | `=`, `!=`, `>`, `<`, `>=`, `<=`                    |
+     * | `upvotes`, `comment_count`, `monthly_spend`, `opportunity_amount` | number                       | `=`, `!=`, `>`, `<`, `>=`, `<=`                    |
+     * | `in_review`, `is_pinned`                                          | boolean                      | `=`, `!=`                                          |
+     *
+     * Use the top-level `search` field for full-text search across `title` and
+     * `content` (see "Search mode" above). The clause-level operators `~`, `!~`, `^`,
+     * `$` are reserved for future use and currently return `400`.
+     *
+     * A filter-mode query (no `search`) consisting only of `!=` or `NIN` clauses on
+     * unbounded fields is rejected with `query_too_broad` to prevent full-org scans.
+     * Combine the negation with at least one positive clause (`=`, `IN`, `>`, `<`)
+     * instead. Boolean fields (`in_review`, `is_pinned`) are bounded so a standalone
+     * negation on them is allowed. Search mode (with `search` set) relaxes this — the
+     * FTS query itself acts as the positive constraint.
+     *
+     * ### Sort
+     *
+     * Allowed values:
+     *
+     * - `created_at:desc` (default), `created_at:asc`
+     * - `updated_at:desc`, `updated_at:asc`
+     * - `upvotes:desc`, `upvotes:asc`
+     * - `eta:desc`, `eta:asc`
+     * - `trending_score:desc`, `trending_score:asc`
+     * - `monthly_spend:desc`, `monthly_spend:asc` (sum of upvoters' monthly spend)
+     * - `opportunity_amount:desc`, `opportunity_amount:asc` (linked HubSpot/Salesforce
+     *   value)
+     * - `comment_count:desc`, `comment_count:asc`
+     *
+     * When `search` is set, results are ranked by relevance unless `sort` is also set,
+     * in which case the matching posts are returned in the requested order. The chosen
+     * sort axis (or relevance) is encoded in the cursor; switching `sort` (or toggling
+     * `search` on/off) mid-pagination returns `400 invalid_cursor`. Restart pagination
+     * without a cursor when changing the sort or search shape.
+     *
+     * ### Pagination
+     *
+     * Cursor-based, `limit` between 1 and 100 (default 10). In filter mode,
+     * `totalCount` is approximate and capped at 5000; `totalCountCapped` is `true`
+     * when the real count may be higher. In search mode, `totalCount` reflects the
+     * matching survivor set after the AST filter and is capped at 200 (the Turbopuffer
+     * top-K).
+     *
+     * ### Server-side guards
+     *
+     * These exclusions are always applied and CANNOT be disabled via the AST:
+     *
+     * - Spam posts (`isSpam: true`) are excluded.
+     * - Merged posts (those rolled into another post) are excluded — the canonical row
+     *   is what's returned.
+     * - Support-board (ticket) categories are excluded — tickets have their own
+     *   `/v2/tickets` surface.
+     *
+     * ### Response
+     *
+     * Returns a standard list envelope with post rows identical to
+     * `GET /v2/posts/{id}`.
+     *
+     * ### Version Availability
+     *
+     * This endpoint is only available in API version 2026-01-01.nova and newer.
+     *
+     * @example
+     * ```ts
+     * const response = await client.feedback.posts.search();
+     * ```
+     */
+    search(params, options) {
+        const { 'Featurebase-Version': featurebaseVersion, ...body } = params;
+        return this._client.post('/v2/posts/search', {
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                {
+                    ...(featurebaseVersion?.toString() != null ?
+                        { 'Featurebase-Version': featurebaseVersion?.toString() }
+                        : undefined),
+                },
+                options?.headers,
+            ]),
+        });
+    }
 }
 exports.Posts = Posts;
 Posts.Voters = voters_1.Voters;

package/resources/feedback/posts/posts.js.map

@@ -1 +1 @@
-{"version":3,"file":"posts.js","sourceRoot":"","sources":["../../../src/resources/feedback/posts/posts.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"posts.js","sourceRoot":"","sources":["../../../src/resources/feedback/posts/posts.ts"],"names":[],"mappings":"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"}

package/resources/feedback/posts/posts.mjs

@@ -285,6 +285,161 @@ export class Posts extends APIResource {
             ]),
         });
     }
+    /**
+     * Search feedback posts with a structured filter AST, full-text search, sorting,
+     * and cursor pagination.
+     *
+     * ### Two modes (combinable)
+     *
+     * - **Filter mode** — pass a structured `query` AST (and/or `sort`) and the
+     *   endpoint returns posts matching the filter, ordered by `sort` (default
+     *   `created_at:desc`). Same shape as `/v2/conversations/search`,
+     *   `/v2/companies/search`, `/v2/contacts/search`.
+     * - **Search mode** — pass a top-level `search` string and the endpoint runs a
+     *   hybrid full-text + vector search (BM25 + embeddings, semanticRatio 0.5) over
+     *   post `title` and `content`, returning matches ranked by relevance. Optional:
+     *   combine with `query` to constrain the search to a board / status / time
+     *   window, and/or `sort` to override relevance ranking with chronological order.
+     *
+     * ```json
+     * {
+     *   "search": "mobile dark mode",
+     *   "query": {
+     *     "operator": "AND",
+     *     "value": [
+     *       {
+     *         "field": "board_id",
+     *         "operator": "IN",
+     *         "value": ["507f1f77bcf86cd799439011"]
+     *       }
+     *     ]
+     *   },
+     *   "limit": 20
+     * }
+     * ```
+     *
+     * `search` is server-managed: no operators, no field selection, no special syntax
+     * — same plain-text contract as `/v2/conversations/search`. The string must be
+     * 1–500 characters; up to ~1024 BM25-tokenizer characters are forwarded to
+     * Turbopuffer (longer queries are truncated at a word boundary).
+     *
+     * ### Structured query AST
+     *
+     * Each clause has the shape `{ field, operator, value }`. You can pass a single
+     * clause or wrap up to 15 in a top-level `AND` group:
+     *
+     * ```json
+     * {
+     *   "query": {
+     *     "operator": "AND",
+     *     "value": [
+     *       {
+     *         "field": "board_id",
+     *         "operator": "IN",
+     *         "value": ["507f1f77bcf86cd799439011"]
+     *       },
+     *       { "field": "upvotes", "operator": ">", "value": 10 }
+     *     ]
+     *   },
+     *   "sort": "upvotes:desc",
+     *   "limit": 20
+     * }
+     * ```
+     *
+     * Top-level `OR` groups and nested groups are not supported in this version.
+     *
+     * ### Supported fields and operators
+     *
+     * | Field                                                             | Type                         | Operators                                          |
+     * | ----------------------------------------------------------------- | ---------------------------- | -------------------------------------------------- |
+     * | `board_id`                                                        | id (categoryId)              | `=`, `!=`, `IN`, `NIN`                             |
+     * | `status_id`                                                       | id (postStatus)              | `=`, `!=`, `IN`, `NIN`                             |
+     * | `tag_id`                                                          | id (postTags)                | `=`, `!=`, `IN`, `NIN`                             |
+     * | `author_id`                                                       | string (user id)             | `=`, `!=`, `IN`, `NIN`                             |
+     * | `assignee_id`                                                     | id or null (admin)           | `=`, `!=`, `IN`, `NIN` (use `null` for unassigned) |
+     * | `company_id`                                                      | string (external company id) | `=`, `!=`, `IN`, `NIN`                             |
+     * | `created_at`, `updated_at`, `eta`                                 | unix seconds                 | `=`, `!=`, `>`, `<`, `>=`, `<=`                    |
+     * | `upvotes`, `comment_count`, `monthly_spend`, `opportunity_amount` | number                       | `=`, `!=`, `>`, `<`, `>=`, `<=`                    |
+     * | `in_review`, `is_pinned`                                          | boolean                      | `=`, `!=`                                          |
+     *
+     * Use the top-level `search` field for full-text search across `title` and
+     * `content` (see "Search mode" above). The clause-level operators `~`, `!~`, `^`,
+     * `$` are reserved for future use and currently return `400`.
+     *
+     * A filter-mode query (no `search`) consisting only of `!=` or `NIN` clauses on
+     * unbounded fields is rejected with `query_too_broad` to prevent full-org scans.
+     * Combine the negation with at least one positive clause (`=`, `IN`, `>`, `<`)
+     * instead. Boolean fields (`in_review`, `is_pinned`) are bounded so a standalone
+     * negation on them is allowed. Search mode (with `search` set) relaxes this — the
+     * FTS query itself acts as the positive constraint.
+     *
+     * ### Sort
+     *
+     * Allowed values:
+     *
+     * - `created_at:desc` (default), `created_at:asc`
+     * - `updated_at:desc`, `updated_at:asc`
+     * - `upvotes:desc`, `upvotes:asc`
+     * - `eta:desc`, `eta:asc`
+     * - `trending_score:desc`, `trending_score:asc`
+     * - `monthly_spend:desc`, `monthly_spend:asc` (sum of upvoters' monthly spend)
+     * - `opportunity_amount:desc`, `opportunity_amount:asc` (linked HubSpot/Salesforce
+     *   value)
+     * - `comment_count:desc`, `comment_count:asc`
+     *
+     * When `search` is set, results are ranked by relevance unless `sort` is also set,
+     * in which case the matching posts are returned in the requested order. The chosen
+     * sort axis (or relevance) is encoded in the cursor; switching `sort` (or toggling
+     * `search` on/off) mid-pagination returns `400 invalid_cursor`. Restart pagination
+     * without a cursor when changing the sort or search shape.
+     *
+     * ### Pagination
+     *
+     * Cursor-based, `limit` between 1 and 100 (default 10). In filter mode,
+     * `totalCount` is approximate and capped at 5000; `totalCountCapped` is `true`
+     * when the real count may be higher. In search mode, `totalCount` reflects the
+     * matching survivor set after the AST filter and is capped at 200 (the Turbopuffer
+     * top-K).
+     *
+     * ### Server-side guards
+     *
+     * These exclusions are always applied and CANNOT be disabled via the AST:
+     *
+     * - Spam posts (`isSpam: true`) are excluded.
+     * - Merged posts (those rolled into another post) are excluded — the canonical row
+     *   is what's returned.
+     * - Support-board (ticket) categories are excluded — tickets have their own
+     *   `/v2/tickets` surface.
+     *
+     * ### Response
+     *
+     * Returns a standard list envelope with post rows identical to
+     * `GET /v2/posts/{id}`.
+     *
+     * ### Version Availability
+     *
+     * This endpoint is only available in API version 2026-01-01.nova and newer.
+     *
+     * @example
+     * ```ts
+     * const response = await client.feedback.posts.search();
+     * ```
+     */
+    search(params, options) {
+        const { 'Featurebase-Version': featurebaseVersion, ...body } = params;
+        return this._client.post('/v2/posts/search', {
+            body,
+            ...options,
+            headers: buildHeaders([
+                {
+                    ...(featurebaseVersion?.toString() != null ?
+                        { 'Featurebase-Version': featurebaseVersion?.toString() }
+                        : undefined),
+                },
+                options?.headers,
+            ]),
+        });
+    }
 }
 Posts.Voters = Voters;
 //# sourceMappingURL=posts.mjs.map

package/resources/feedback/posts/posts.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"posts.mjs","sourceRoot":"","sources":["../../../src/resources/feedback/posts/posts.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"posts.mjs","sourceRoot":"","sources":["../../../src/resources/feedback/posts/posts.ts"],"names":[],"mappings":"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"}