featurebase-node 0.12.0 → 0.14.0

package/resources/users/contacts/contacts.d.ts

@@ -1,5 +1,6 @@
 import { APIResource } from "../../../core/resource.js";
 import * as ContactsAPI from "./contacts.js";
+import * as PostsAPI from "../../feedback/posts/posts.js";
 import * as CompaniesAPI from "../companies/companies.js";
 import * as EmailPreferencesAPI from "./email-preferences.js";
 import { EmailPreferenceRetrieveParams, EmailPreferenceUpdateParams, EmailPreferences, PreferenceState, PreferencesOutput, UpdatePreferenceBody } from "./email-preferences.js";
@@ -15,19 +16,27 @@ export declare class Contacts extends APIResource {
     byUserID: ByUserIDAPI.ByUserID;
     emailPreferences: EmailPreferencesAPI.EmailPreferences;
     /**
-     * Retrieves a single contact by their Featurebase ID.
-     *
-     * Returns both customers and leads.
+     * Returns a list of contacts (customers and leads) in your organization using
+     * cursor-based pagination.
      *
-     * ### Path Parameters
+     * ### Query Parameters
      *
-     * - `id` - The Featurebase contact ID (24-character ObjectId)
+     * - `limit` - Number of contacts to return (1-100, default 10)
+     * - `cursor` - Cursor from previous response for pagination
+     * - `contactType` - Filter by contact type: "customer" (default), "lead", or "all"
      *
      * ### Response Format
      *
-     * Returns a single contact object with:
+     * Returns a list object with:
+     *
+     * - `object` - Always "list"
+     * - `data` - Array of contact objects
+     * - `nextCursor` - Cursor for the next page, or null if no more results
+     *
+     * ### Contact Object
+     *
+     * Each contact includes:
      *
-     * - `object` - Always "contact"
      * - `id` - Unique contact identifier
      * - `userId` - External user ID from SSO (if set)
      * - `email` - Contact email address
@@ -44,11 +53,115 @@ export declare class Contacts extends APIResource {
      *
      * ```json
      * {
+     *   "object": "list",
+     *   "data": [
+     *     {
+     *       "object": "contact",
+     *       "id": "676f0f6765bdaa7d7d760f88",
+     *       "email": "john@example.com",
+     *       "name": "John Doe",
+     *       "type": "customer",
+     *       ...
+     *     }
+     *   ],
+     *   "nextCursor": "eyJpZCI6IjUwN2YxZjc3YmNmODZjZDc5OTQzOTAxMSJ9"
+     * }
+     * ```
+     *
+     * ### Version Availability
+     *
+     * This endpoint is only available in API version 2026-01-01.nova and newer.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const contact of client.users.contacts.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(params?: ContactListParams | null | undefined, options?: RequestOptions): PagePromise<ContactListDataCursorPage, ContactList.Data>;
+    /**
+     * Creates a new contact or updates an existing one.
+     *
+     * If a contact with the given `email` or `userId` already exists, it will be
+     * updated. Otherwise, a new contact will be created.
+     *
+     * **At least one of `email` or `userId` must be provided for identification.**
+     *
+     * ### Request Body
+     *
+     * | Field                   | Type    | Required            | Description                             |
+     * | ----------------------- | ------- | ------------------- | --------------------------------------- |
+     * | `email`                 | string  | One of email/userId | Contact email address                   |
+     * | `userId`                | string  | One of email/userId | External user ID from your system       |
+     * | `name`                  | string  | No                  | Contact display name                    |
+     * | `profilePicture`        | string  | No                  | Profile picture URL                     |
+     * | `companies`             | array   | No                  | Companies the contact belongs to        |
+     * | `customFields`          | object  | No                  | Custom field values                     |
+     * | `subscribedToChangelog` | boolean | No                  | Whether subscribed to changelog         |
+     * | `locale`                | string  | No                  | Contact locale/language                 |
+     * | `phone`                 | string  | No                  | Contact phone number                    |
+     * | `roles`                 | array   | No                  | Role IDs to assign                      |
+     * | `userHash`              | string  | No                  | HMAC hash for identity verification     |
+     * | `createdAt`             | string  | No                  | When the contact was created (ISO 8601) |
+     *
+     * ### Company Object
+     *
+     * Each company in the `companies` array can have:
+     *
+     * - `id` (required) - External company ID from your system
+     * - `name` (required) - Company name
+     * - `monthlySpend` - Monthly spend/revenue
+     * - `customFields` - Custom field values
+     * - `industry` - Industry
+     * - `website` - Company website URL
+     * - `plan` - Current plan/subscription
+     * - `companySize` - Number of employees
+     * - `createdAt` - When the company was created
+     *
+     * ### Response
+     *
+     * Returns the created or updated contact object.
+     *
+     * - **201 Created** - A new contact was created
+     * - **200 OK** - An existing contact was updated
+     *
+     * ### Example Request
+     *
+     * ```json
+     * {
+     *   "email": "john@example.com",
+     *   "name": "John Doe",
+     *   "userId": "usr_12345",
+     *   "companies": [
+     *     {
+     *       "id": "company_123",
+     *       "name": "Acme Inc",
+     *       "monthlySpend": 500,
+     *       "plan": "enterprise"
+     *     }
+     *   ],
+     *   "customFields": {
+     *     "plan": "pro",
+     *     "signupSource": "website"
+     *   },
+     *   "subscribedToChangelog": true
+     * }
+     * ```
+     *
+     * ### Example Response
+     *
+     * ```json
+     * {
      *   "object": "contact",
      *   "id": "676f0f6765bdaa7d7d760f88",
      *   "email": "john@example.com",
      *   "name": "John Doe",
+     *   "userId": "usr_12345",
      *   "type": "customer",
+     *   "companies": [...],
+     *   "customFields": {...},
      *   ...
      * }
      * ```
@@ -59,34 +172,25 @@ export declare class Contacts extends APIResource {
      *
      * @example
      * ```ts
-     * const contact = await client.users.contacts.retrieve(
-     *   '507f1f77bcf86cd799439011',
-     * );
+     * const response =
+     *   await client.users.contacts.createOrUpdate();
      * ```
      */
-    retrieve(id: string, params?: ContactRetrieveParams | null | undefined, options?: RequestOptions): APIPromise<ContactRetrieveResponse>;
+    createOrUpdate(params: ContactCreateOrUpdateParams, options?: RequestOptions): APIPromise<ContactCreateOrUpdateResponse>;
     /**
-     * Returns a list of contacts (customers and leads) in your organization using
-     * cursor-based pagination.
-     *
-     * ### Query Parameters
-     *
-     * - `limit` - Number of contacts to return (1-100, default 10)
-     * - `cursor` - Cursor from previous response for pagination
-     * - `contactType` - Filter by contact type: "customer" (default), "lead", or "all"
+     * Retrieves a single contact by their Featurebase ID.
      *
-     * ### Response Format
+     * Returns both customers and leads.
      *
-     * Returns a list object with:
+     * ### Path Parameters
      *
-     * - `object` - Always "list"
-     * - `data` - Array of contact objects
-     * - `nextCursor` - Cursor for the next page, or null if no more results
+     * - `id` - The Featurebase contact ID (24-character ObjectId)
      *
-     * ### Contact Object
+     * ### Response Format
      *
-     * Each contact includes:
+     * Returns a single contact object with:
      *
+     * - `object` - Always "contact"
      * - `id` - Unique contact identifier
      * - `userId` - External user ID from SSO (if set)
      * - `email` - Contact email address
@@ -103,18 +207,12 @@ export declare class Contacts extends APIResource {
      *
      * ```json
      * {
-     *   "object": "list",
-     *   "data": [
-     *     {
-     *       "object": "contact",
-     *       "id": "676f0f6765bdaa7d7d760f88",
-     *       "email": "john@example.com",
-     *       "name": "John Doe",
-     *       "type": "customer",
-     *       ...
-     *     }
-     *   ],
-     *   "nextCursor": "eyJpZCI6IjUwN2YxZjc3YmNmODZjZDc5OTQzOTAxMSJ9"
+     *   "object": "contact",
+     *   "id": "676f0f6765bdaa7d7d760f88",
+     *   "email": "john@example.com",
+     *   "name": "John Doe",
+     *   "type": "customer",
+     *   ...
      * }
      * ```
      *
@@ -124,13 +222,12 @@ export declare class Contacts extends APIResource {
      *
      * @example
      * ```ts
-     * // Automatically fetches more pages as needed.
-     * for await (const contact of client.users.contacts.list()) {
-     *   // ...
-     * }
+     * const contact = await client.users.contacts.retrieve(
+     *   '507f1f77bcf86cd799439011',
+     * );
      * ```
      */
-    list(params?: ContactListParams | null | undefined, options?: RequestOptions): PagePromise<ContactListDataCursorPage, ContactList.Data>;
+    retrieve(id: string, params?: ContactRetrieveParams | null | undefined, options?: RequestOptions): APIPromise<ContactRetrieveResponse>;
     /**
      * Permanently deletes a contact by their Featurebase ID.
      *
@@ -180,7 +277,7 @@ export declare class Contacts extends APIResource {
      */
     delete(id: string, params?: ContactDeleteParams | null | undefined, options?: RequestOptions): APIPromise<DeletedContact>;
     /**
-     * Blocks a contact by their Featurebase ID from the messenger/inbox.
+     * Blocks a contact by their Featurebase ID using the global moderation system.
      *
      * ### Path Parameters
      *
@@ -198,6 +295,8 @@ export declare class Contacts extends APIResource {
      * When a contact is blocked:
      *
      * - The contact cannot send new messages via messenger
+     * - The contact cannot interact with feedback/changelog surfaces for this
+     *   organization
      * - Existing conversations are not deleted but no new messages can be added by the
      *   blocked user
      * - The block can be removed by unblocking the contact
@@ -233,87 +332,42 @@ export declare class Contacts extends APIResource {
      */
     block(id: string, params?: ContactBlockParams | null | undefined, options?: RequestOptions): APIPromise<ContactBlockResponse>;
     /**
-     * Creates a new contact or updates an existing one.
-     *
-     * If a contact with the given `email` or `userId` already exists, it will be
-     * updated. Otherwise, a new contact will be created.
+     * Unblocks a contact by their Featurebase ID from the global moderation system.
      *
-     * **At least one of `email` or `userId` must be provided for identification.**
+     * ### Path Parameters
      *
-     * ### Request Body
+     * - `id` - The Featurebase internal ID of the contact (MongoDB ObjectId)
      *
-     * | Field                   | Type    | Required            | Description                             |
-     * | ----------------------- | ------- | ------------------- | --------------------------------------- |
-     * | `email`                 | string  | One of email/userId | Contact email address                   |
-     * | `userId`                | string  | One of email/userId | External user ID from your system       |
-     * | `name`                  | string  | No                  | Contact display name                    |
-     * | `profilePicture`        | string  | No                  | Profile picture URL                     |
-     * | `companies`             | array   | No                  | Companies the contact belongs to        |
-     * | `customFields`          | object  | No                  | Custom field values                     |
-     * | `subscribedToChangelog` | boolean | No                  | Whether subscribed to changelog         |
-     * | `locale`                | string  | No                  | Contact locale/language                 |
-     * | `phone`                 | string  | No                  | Contact phone number                    |
-     * | `roles`                 | array   | No                  | Role IDs to assign                      |
-     * | `userHash`              | string  | No                  | HMAC hash for identity verification     |
-     * | `createdAt`             | string  | No                  | When the contact was created (ISO 8601) |
+     * ### Supported Contact Types
      *
-     * ### Company Object
+     * This endpoint unblocks both:
      *
-     * Each company in the `companies` array can have:
+     * - **Customers** - Users with registered accounts
+     * - **Leads** - Anonymous or unregistered visitors
      *
-     * - `id` (required) - External company ID from your system
-     * - `name` (required) - Company name
-     * - `monthlySpend` - Monthly spend/revenue
-     * - `customFields` - Custom field values
-     * - `industry` - Industry
-     * - `website` - Company website URL
-     * - `plan` - Current plan/subscription
-     * - `companySize` - Number of employees
-     * - `createdAt` - When the company was created
+     * ### Unblocking Behavior
      *
-     * ### Response
+     * When a contact is unblocked:
      *
-     * Returns the created or updated contact object.
+     * - The contact can resume sending messages via messenger
+     * - Previously blocked conversations remain intact
+     * - The contact regains full messenger functionality
      *
-     * - **201 Created** - A new contact was created
-     * - **200 OK** - An existing contact was updated
+     * ### Response
      *
-     * ### Example Request
+     * Returns an unblock confirmation object:
      *
-     * ```json
-     * {
-     *   "email": "john@example.com",
-     *   "name": "John Doe",
-     *   "userId": "usr_12345",
-     *   "companies": [
-     *     {
-     *       "id": "company_123",
-     *       "name": "Acme Inc",
-     *       "monthlySpend": 500,
-     *       "plan": "enterprise"
-     *     }
-     *   ],
-     *   "customFields": {
-     *     "plan": "pro",
-     *     "signupSource": "website"
-     *   },
-     *   "subscribedToChangelog": true
-     * }
-     * ```
+     * - `id` - The ID of the unblocked contact
+     * - `object` - Always "contact"
+     * - `unblocked` - Always `true`
      *
      * ### Example Response
      *
      * ```json
      * {
+     *   "id": "507f1f77bcf86cd799439011",
      *   "object": "contact",
-     *   "id": "676f0f6765bdaa7d7d760f88",
-     *   "email": "john@example.com",
-     *   "name": "John Doe",
-     *   "userId": "usr_12345",
-     *   "type": "customer",
-     *   "companies": [...],
-     *   "customFields": {...},
-     *   ...
+     *   "unblocked": true
      * }
      * ```
      *
@@ -323,11 +377,12 @@ export declare class Contacts extends APIResource {
      *
      * @example
      * ```ts
-     * const response =
-     *   await client.users.contacts.createOrUpdate();
+     * const response = await client.users.contacts.unblock(
+     *   '507f1f77bcf86cd799439011',
+     * );
      * ```
      */
-    createOrUpdate(params: ContactCreateOrUpdateParams, options?: RequestOptions): APIPromise<ContactCreateOrUpdateResponse>;
+    unblock(id: string, params?: ContactUnblockParams | null | undefined, options?: RequestOptions): APIPromise<ContactUnblockResponse>;
     /**
      * Search contacts (customers and leads) with a structured filter AST, sorting, and
      * cursor pagination.
@@ -343,10 +398,10 @@ export declare class Contacts extends APIResource {
      *     "operator": "AND",
      *     "value": [
      *       { "field": "type", "operator": "=", "value": "customer" },
-     *       { "field": "last_activity", "operator": ">", "value": 1735689600 }
+     *       { "field": "lastActivity", "operator": ">", "value": 1735689600 }
      *     ]
      *   },
-     *   "sort": "last_activity:desc",
+     *   "sort": "lastActivity:desc",
      *   "limit": 20
      * }
      * ```
@@ -355,17 +410,23 @@ export declare class Contacts extends APIResource {
      *
      * ### Supported fields and operators
      *
-     * | Field              | Type                             | Operators                   |
-     * | ------------------ | -------------------------------- | --------------------------- |
-     * | `external_id`      | string (caller-provided user id) | `=`, `!=`, `IN`, `NIN`      |
-     * | `email`            | string                           | `=`, `!=`, `IN`, `NIN`      |
-     * | `name`             | string                           | `=`, `!=`, `IN`, `NIN`, `~` |
-     * | `type`             | enum (`customer`, `lead`)        | `=`, `!=`, `IN`, `NIN`      |
-     * | `company_ids`      | id (Featurebase company `id`)    | `=`, `!=`, `IN`, `NIN`      |
-     * | `posts_created`    | number                           | `=`, `!=`, `>`, `<`         |
-     * | `comments_created` | number                           | `=`, `!=`, `>`, `<`         |
-     * | `last_activity`    | unix seconds                     | `=`, `!=`, `>`, `<`         |
-     * | `created_at`       | unix seconds                     | `=`, `!=`, `>`, `<`         |
+     * Field names are camelCase, matching the rest of the v2 public API. Snake_case
+     * names that this endpoint originally shipped with (`external_id`, `company_ids`,
+     * `posts_created`, `comments_created`, `last_activity`, `created_at`) are still
+     * accepted for back-compat but are deprecated — please migrate to camelCase in new
+     * code.
+     *
+     * | Field             | Type                             | Operators                   |
+     * | ----------------- | -------------------------------- | --------------------------- |
+     * | `externalId`      | string (caller-provided user id) | `=`, `!=`, `IN`, `NIN`      |
+     * | `email`           | string                           | `=`, `!=`, `IN`, `NIN`      |
+     * | `name`            | string                           | `=`, `!=`, `IN`, `NIN`, `~` |
+     * | `type`            | enum (`customer`, `lead`)        | `=`, `!=`, `IN`, `NIN`      |
+     * | `companyIds`      | id (Featurebase company `id`)    | `=`, `!=`, `IN`, `NIN`      |
+     * | `postsCreated`    | number                           | `=`, `!=`, `>`, `<`         |
+     * | `commentsCreated` | number                           | `=`, `!=`, `>`, `<`         |
+     * | `lastActivity`    | unix seconds                     | `=`, `!=`, `>`, `<`         |
+     * | `createdAt`       | unix seconds                     | `=`, `!=`, `>`, `<`         |
      *
      * The `name ~ "..."` operator runs a word-aware substring search via the
      * underlying text index. Other string operators (`!~`, `^`, `$`) are reserved for
@@ -383,10 +444,14 @@ export declare class Contacts extends APIResource {
      *
      * Allowed values:
      *
-     * - `last_activity:desc` (default), `last_activity:asc`
-     * - `created_at:desc`, `created_at:asc`
-     * - `posts_created:desc`, `posts_created:asc`
-     * - `comments_created:desc`, `comments_created:asc`
+     * - `lastActivity:desc` (default), `lastActivity:asc`
+     * - `createdAt:desc`, `createdAt:asc`
+     * - `postsCreated:desc`, `postsCreated:asc`
+     * - `commentsCreated:desc`, `commentsCreated:asc`
+     *
+     * Snake_case sort axes (`last_activity:desc`, `created_at:asc`, etc.) are accepted
+     * for back-compat — the cursor encodes the canonical camelCase identity, so a
+     * caller can switch naming conventions mid-pagination without restarting.
      *
      * The chosen sort axis is encoded in the cursor; switching `sort` mid-pagination
      * returns `400 invalid_cursor`. Restart pagination without a cursor when changing
@@ -413,58 +478,6 @@ export declare class Contacts extends APIResource {
      * ```
      */
     search(params: ContactSearchParams, options?: RequestOptions): APIPromise<ContactSearchResponse>;
-    /**
-     * Unblocks a contact by their Featurebase ID from the messenger/inbox.
-     *
-     * ### Path Parameters
-     *
-     * - `id` - The Featurebase internal ID of the contact (MongoDB ObjectId)
-     *
-     * ### Supported Contact Types
-     *
-     * This endpoint unblocks both:
-     *
-     * - **Customers** - Users with registered accounts
-     * - **Leads** - Anonymous or unregistered visitors
-     *
-     * ### Unblocking Behavior
-     *
-     * When a contact is unblocked:
-     *
-     * - The contact can resume sending messages via messenger
-     * - Previously blocked conversations remain intact
-     * - The contact regains full messenger functionality
-     *
-     * ### Response
-     *
-     * Returns an unblock confirmation object:
-     *
-     * - `id` - The ID of the unblocked contact
-     * - `object` - Always "contact"
-     * - `unblocked` - Always `true`
-     *
-     * ### Example Response
-     *
-     * ```json
-     * {
-     *   "id": "507f1f77bcf86cd799439011",
-     *   "object": "contact",
-     *   "unblocked": true
-     * }
-     * ```
-     *
-     * ### Version Availability
-     *
-     * This endpoint is only available in API version 2026-01-01.nova and newer.
-     *
-     * @example
-     * ```ts
-     * const response = await client.users.contacts.unblock(
-     *   '507f1f77bcf86cd799439011',
-     * );
-     * ```
-     */
-    unblock(id: string, params?: ContactUnblockParams | null | undefined, options?: RequestOptions): APIPromise<ContactUnblockResponse>;
 }
 export type ContactListDataCursorPage = CursorPage<ContactList.Data>;
 /**
@@ -726,13 +739,6 @@ export interface ContactUnblockResponse {
      */
     unblocked: true;
 }
-export interface ContactRetrieveParams {
-    /**
-     * API version for this request. Defaults to your organization's configured API
-     * version if not specified.
-     */
-    'Featurebase-Version'?: '2026-01-01.nova' | '2025-12-12.clover';
-}
 export interface ContactListParams extends CursorPageParams {
     /**
      * Query param: Filter contacts by type. Defaults to "customer".
@@ -744,20 +750,6 @@ export interface ContactListParams extends CursorPageParams {
      */
     'Featurebase-Version'?: '2026-01-01.nova' | '2025-12-12.clover';
 }
-export interface ContactDeleteParams {
-    /**
-     * API version for this request. Defaults to your organization's configured API
-     * version if not specified.
-     */
-    'Featurebase-Version'?: '2026-01-01.nova' | '2025-12-12.clover';
-}
-export interface ContactBlockParams {
-    /**
-     * API version for this request. Defaults to your organization's configured API
-     * version if not specified.
-     */
-    'Featurebase-Version'?: '2026-01-01.nova' | '2025-12-12.clover';
-}
 export interface ContactCreateOrUpdateParams {
     /**
      * Body param: Companies the contact belongs to
@@ -881,6 +873,34 @@ export declare namespace ContactCreateOrUpdateParams {
         signupSource?: string;
     }
 }
+export interface ContactRetrieveParams {
+    /**
+     * API version for this request. Defaults to your organization's configured API
+     * version if not specified.
+     */
+    'Featurebase-Version'?: '2026-01-01.nova' | '2025-12-12.clover';
+}
+export interface ContactDeleteParams {
+    /**
+     * API version for this request. Defaults to your organization's configured API
+     * version if not specified.
+     */
+    'Featurebase-Version'?: '2026-01-01.nova' | '2025-12-12.clover';
+}
+export interface ContactBlockParams {
+    /**
+     * API version for this request. Defaults to your organization's configured API
+     * version if not specified.
+     */
+    'Featurebase-Version'?: '2026-01-01.nova' | '2025-12-12.clover';
+}
+export interface ContactUnblockParams {
+    /**
+     * API version for this request. Defaults to your organization's configured API
+     * version if not specified.
+     */
+    'Featurebase-Version'?: '2026-01-01.nova' | '2025-12-12.clover';
+}
 export interface ContactSearchParams {
     /**
      * Body param: An opaque cursor for pagination. Use the `nextCursor` value from a
@@ -895,70 +915,23 @@ export interface ContactSearchParams {
      * Body param: Structured filter AST. Either a single filter clause or one
      * top-level AND group (max 15 clauses). Top-level OR groups are not yet supported.
      */
-    query?: ContactSearchParams.SearchFilter | ContactSearchParams.SearchFilterGroup;
+    query?: PostsAPI.SearchFilter | PostsAPI.SearchFilterGroup;
     /**
-     * Body param: Sort field + direction. Defaults to `last_activity:desc` (matches
-     * the dashboard's default contact ordering). The chosen sort axis is encoded in
-     * the cursor; switching `sort` mid-pagination returns `400 invalid_cursor`.
+     * Body param: Sort field + direction. Defaults to `lastActivity:desc` (matches the
+     * dashboard's default contact ordering). The chosen sort axis is encoded in the
+     * cursor; switching `sort` mid-pagination returns `400 invalid_cursor`. Snake_case
+     * names (`last_activity:desc`, `posts_created:asc`, …) are accepted for
+     * back-compat — prefer camelCase in new code.
      */
-    sort?: 'created_at:desc' | 'created_at:asc' | 'last_activity:desc' | 'last_activity:asc' | 'posts_created:desc' | 'posts_created:asc' | 'comments_created:desc' | 'comments_created:asc';
+    sort?: 'createdAt:desc' | 'createdAt:asc' | 'lastActivity:desc' | 'lastActivity:asc' | 'postsCreated:desc' | 'postsCreated:asc' | 'commentsCreated:desc' | 'commentsCreated:asc' | 'created_at:desc' | 'created_at:asc' | 'last_activity:desc' | 'last_activity:asc' | 'posts_created:desc' | 'posts_created:asc' | 'comments_created:desc' | 'comments_created:asc';
     /**
      * Header param: API version for this request. Defaults to your organization's
      * configured API version if not specified.
      */
     'Featurebase-Version'?: '2026-01-01.nova' | '2025-12-12.clover';
 }
-export declare namespace ContactSearchParams {
-    interface SearchFilter {
-        /**
-         * Field name to filter on (e.g. `state`, `tag_ids`, `created_at`)
-         */
-        field: string;
-        /**
-         * Comparison operator
-         */
-        operator: '=' | '!=' | 'IN' | 'NIN' | '>' | '<' | '>=' | '<=' | '~' | '!~' | '^' | '$';
-        /**
-         * Value to compare against (primitive or array of primitives)
-         */
-        value: string | number | boolean | Array<string | number> | null;
-    }
-    interface SearchFilterGroup {
-        /**
-         * Group operator: AND (all match) or OR (any match)
-         */
-        operator: 'AND' | 'OR';
-        /**
-         * Array of filter clauses (1-15 entries)
-         */
-        value: Array<SearchFilterGroup.Value>;
-    }
-    namespace SearchFilterGroup {
-        interface Value {
-            /**
-             * Field name to filter on (e.g. `state`, `tag_ids`, `created_at`)
-             */
-            field: string;
-            /**
-             * Comparison operator
-             */
-            operator: '=' | '!=' | 'IN' | 'NIN' | '>' | '<' | '>=' | '<=' | '~' | '!~' | '^' | '$';
-            /**
-             * Value to compare against (primitive or array of primitives)
-             */
-            value: string | number | boolean | Array<string | number> | null;
-        }
-    }
-}
-export interface ContactUnblockParams {
-    /**
-     * API version for this request. Defaults to your organization's configured API
-     * version if not specified.
-     */
-    'Featurebase-Version'?: '2026-01-01.nova' | '2025-12-12.clover';
-}
 export declare namespace Contacts {
-    export { type Contact as Contact, type ContactList as ContactList, type DeletedContact as DeletedContact, type ContactRetrieveResponse as ContactRetrieveResponse, type ContactBlockResponse as ContactBlockResponse, type ContactCreateOrUpdateResponse as ContactCreateOrUpdateResponse, type ContactSearchResponse as ContactSearchResponse, type ContactUnblockResponse as ContactUnblockResponse, type ContactListDataCursorPage as ContactListDataCursorPage, type ContactRetrieveParams as ContactRetrieveParams, type ContactListParams as ContactListParams, type ContactDeleteParams as ContactDeleteParams, type ContactBlockParams as ContactBlockParams, type ContactCreateOrUpdateParams as ContactCreateOrUpdateParams, type ContactSearchParams as ContactSearchParams, type ContactUnblockParams as ContactUnblockParams, };
+    export { type Contact as Contact, type ContactList as ContactList, type DeletedContact as DeletedContact, type ContactRetrieveResponse as ContactRetrieveResponse, type ContactBlockResponse as ContactBlockResponse, type ContactCreateOrUpdateResponse as ContactCreateOrUpdateResponse, type ContactSearchResponse as ContactSearchResponse, type ContactUnblockResponse as ContactUnblockResponse, type ContactListDataCursorPage as ContactListDataCursorPage, type ContactListParams as ContactListParams, type ContactCreateOrUpdateParams as ContactCreateOrUpdateParams, type ContactRetrieveParams as ContactRetrieveParams, type ContactDeleteParams as ContactDeleteParams, type ContactBlockParams as ContactBlockParams, type ContactUnblockParams as ContactUnblockParams, type ContactSearchParams as ContactSearchParams, };
     export { ByUserID as ByUserID, type ByUserIDRetrieveResponse as ByUserIDRetrieveResponse, type ByUserIDRetrieveParams as ByUserIDRetrieveParams, type ByUserIDDeleteParams as ByUserIDDeleteParams, };
     export { EmailPreferences as EmailPreferences, type PreferenceState as PreferenceState, type PreferencesOutput as PreferencesOutput, type UpdatePreferenceBody as UpdatePreferenceBody, type EmailPreferenceRetrieveParams as EmailPreferenceRetrieveParams, type EmailPreferenceUpdateParams as EmailPreferenceUpdateParams, };
 }