@proveanything/smartlinks 1.14.10 → 1.14.11

package/dist/api/contact.d.ts

@@ -1,4 +1,4 @@
-import { ContactResponse, ContactCreateRequest, ContactUpdateRequest, ContactListResponse, PublicContactUpsertRequest, PublicContactUpsertResponse, UserSearchResponse, ContactPatch, PublicGetMyContactResponse, PublicUpdateMyContactResponse, ContactSchemaResponse } from "../types";
+import { ContactResponse, ContactCreateRequest, ContactUpdateRequest, ContactListResponse, ContactSearchParams, ContactSearchResponse, PublicContactUpsertRequest, PublicContactUpsertResponse, UserSearchResponse, ContactPatch, PublicGetMyContactResponse, PublicUpdateMyContactResponse, ContactSchemaResponse } from "../types";
 export declare namespace contact {
     function create(collectionId: string, data: ContactCreateRequest): Promise<ContactResponse>;
     function list(collectionId: string, params?: {
@@ -6,6 +6,7 @@ export declare namespace contact {
         offset?: number;
         includeDeleted?: boolean;
     }): Promise<ContactListResponse>;
+    function search({ collectionId, q, typeahead, email, phone, id, userId, tags, tagsAll, source, locale, createdFrom, createdTo, externalIdKey, externalIdValue, customFieldKey, customFieldValue, limit, offset, }: ContactSearchParams): Promise<ContactSearchResponse>;
     function get(collectionId: string, contactId: string, params?: {
         includeDeleted?: boolean;
     }): Promise<ContactResponse>;

package/dist/api/contact.js

@@ -19,6 +19,52 @@ export var contact;
         return request(path);
     }
     contact.list = list;
+    async function search({ collectionId, q, typeahead, email, phone, id, userId, tags, tagsAll, source, locale, createdFrom, createdTo, externalIdKey, externalIdValue, customFieldKey, customFieldValue, limit, offset, }) {
+        const query = new URLSearchParams();
+        if (q !== undefined)
+            query.set("q", q);
+        if (typeahead !== undefined)
+            query.set("typeahead", String(typeahead));
+        if (email !== undefined)
+            query.set("email", email);
+        if (phone !== undefined)
+            query.set("phone", phone);
+        if (id !== undefined)
+            query.set("id", id);
+        if (userId !== undefined)
+            query.set("userId", userId);
+        if (tags !== undefined) {
+            const arr = Array.isArray(tags) ? tags : tags.split(",").map(t => t.trim());
+            arr.forEach(t => query.append("tags", t));
+        }
+        if (tagsAll !== undefined) {
+            const arr = Array.isArray(tagsAll) ? tagsAll : tagsAll.split(",").map(t => t.trim());
+            arr.forEach(t => query.append("tagsAll", t));
+        }
+        if (source !== undefined)
+            query.set("source", source);
+        if (locale !== undefined)
+            query.set("locale", locale);
+        if (createdFrom !== undefined)
+            query.set("createdFrom", createdFrom);
+        if (createdTo !== undefined)
+            query.set("createdTo", createdTo);
+        if (externalIdKey !== undefined)
+            query.set("externalIdKey", externalIdKey);
+        if (externalIdValue !== undefined)
+            query.set("externalIdValue", externalIdValue);
+        if (customFieldKey !== undefined)
+            query.set("customFieldKey", customFieldKey);
+        if (customFieldValue !== undefined)
+            query.set("customFieldValue", customFieldValue);
+        if (limit !== undefined)
+            query.set("limit", String(limit));
+        if (offset !== undefined)
+            query.set("offset", String(offset));
+        const path = `/admin/collection/${encodeURIComponent(collectionId)}/contacts/search?${query.toString()}`;
+        return request(path);
+    }
+    contact.search = search;
     async function get(collectionId, contactId, params) {
         const query = new URLSearchParams();
         if ((params === null || params === void 0 ? void 0 : params.includeDeleted) !== undefined)

package/dist/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 1.14.10  |  Generated: 2026-05-16T17:03:23.904Z
+Version: 1.14.11  |  Generated: 2026-05-19T10:35:51.071Z
 
 This is a concise summary of all available API functions and types.
 
@@ -4460,6 +4460,40 @@ interface ContactListResponse {
 }
 ```
 
+**ContactSearchParams** (interface)
+```typescript
+interface ContactSearchParams {
+  collectionId: string
+  q?: string
+  typeahead?: boolean
+  email?: string
+  phone?: string
+  id?: string
+  userId?: string
+  tags?: string | string[]
+  tagsAll?: string | string[]
+  source?: string
+  locale?: string
+  createdFrom?: string
+  createdTo?: string
+  externalIdKey?: string
+  externalIdValue?: string
+  customFieldKey?: string
+  customFieldValue?: string
+  limit?: number
+  offset?: number
+}
+```
+
+**ContactSearchResponse** (interface)
+```typescript
+interface ContactSearchResponse {
+  items: Contact[]
+  limit: number
+  offset: number
+}
+```
+
 **PublicContactUpsertResponse** (interface)
 ```typescript
 interface PublicContactUpsertResponse {
@@ -8629,6 +8663,28 @@ Returns all proof type definitions. Proof types are templates that specify which
 **list**(collectionId: string,
     params?: { limit?: number; offset?: number; includeDeleted?: boolean }) → `Promise<ContactListResponse>`
 
+**search**({
+    collectionId,
+    q,
+    typeahead,
+    email,
+    phone,
+    id,
+    userId,
+    tags,
+    tagsAll,
+    source,
+    locale,
+    createdFrom,
+    createdTo,
+    externalIdKey,
+    externalIdValue,
+    customFieldKey,
+    customFieldValue,
+    limit,
+    offset,
+  }: ContactSearchParams) → `Promise<ContactSearchResponse>`
+
 **get**(collectionId: string,
     contactId: string,
     params?: { includeDeleted?: boolean }) → `Promise<ContactResponse>`

package/dist/docs/contact-search.md

@@ -0,0 +1,162 @@
+# Contact Search
+
+Admin-scoped endpoint for querying contacts within a collection. Supports
+free-text search, type-ahead, identity lookup, structured filters, and JSONB
+field queries. All parameters are optional and composable.
+
+**Base path:** `GET /api/admin/:collectionId/contacts/search`
+
+---
+
+## Quick examples
+
+```ts
+// Type-ahead while user types "joh" into a search box
+await contact.search({ collectionId, q: "joh", typeahead: true })
+
+// Find contacts by partial email
+await contact.search({ collectionId, email: "acme.com" })
+
+// Exact contact by UUID
+await contact.search({ collectionId, id: "uuid-here" })
+
+// All contacts tagged "vip" created this year
+await contact.search({
+  collectionId,
+  tags: ["vip"],
+  createdFrom: "2026-01-01",
+})
+
+// Find by external ID (e.g. Shopify customer ID)
+await contact.search({
+  collectionId,
+  externalIdKey: "shopify_id",
+  externalIdValue: "123456",
+})
+```
+
+---
+
+## Parameters
+
+### Free-text
+
+| Param | Type | Description |
+|---|---|---|
+| `q` | `string` | General search term. Searches `first_name`, `last_name`, `display_name`, `company`, and all identity values (`email`, `phone`). When the value contains `@` only email identities are searched; when it matches a phone pattern only phone identities are searched. |
+| `typeahead` | `boolean` | When `true`, uses prefix (`startsWith`) operators instead of substring (`contains`). Significantly cheaper per keystroke. Default limit becomes `10`; minimum `q` length is 2 characters. Use this for live search-as-you-type UIs. |
+
+### Identity filters
+
+| Param | Type | Description |
+|---|---|---|
+| `email` | `string` | Partial match against normalised email identity values. Case-insensitive. |
+| `phone` | `string` | Partial match against normalised phone identity values. |
+
+### Exact lookups
+
+These short-circuit all text/filter logic and return at most one contact.
+
+| Param | Type | Description |
+|---|---|---|
+| `id` | `string` (UUID) | Contact primary key. |
+| `userId` | `string` | Firebase auth UID linked to the contact. |
+
+### Structured filters
+
+All filters are ANDed with each other and with any text search.
+
+| Param | Type | Description |
+|---|---|---|
+| `tags` | `string \| string[]` | Comma-separated string or repeated param. Contacts must have **any** of these tags. |
+| `tagsAll` | `string \| string[]` | Contacts must have **all** of these tags. |
+| `source` | `string` | Exact match on the `source` field. |
+| `locale` | `string` | Exact match on the `locale` field (e.g. `"en-US"`). |
+| `createdFrom` | `string` (ISO-8601) | Lower bound on `created_at`. |
+| `createdTo` | `string` (ISO-8601) | Upper bound on `created_at`. |
+
+### JSONB field filters
+
+Searches inside the `external_ids` or `custom_fields` JSONB columns by
+key/value pair. Both params in a pair must be supplied together.
+
+| Param | Type | Description |
+|---|---|---|
+| `externalIdKey` | `string` | Top-level key in `externalIds` (e.g. `"shopify_id"`). |
+| `externalIdValue` | `string` | Expected value at that key. |
+| `customFieldKey` | `string` | Top-level key in `customFields`. |
+| `customFieldValue` | `string` | Expected value at that key. |
+
+### Pagination
+
+| Param | Type | Default | Max |
+|---|---|---|---|
+| `limit` | `number` | `20` (`10` in typeahead mode) | `100` (`10` in typeahead mode) |
+| `offset` | `number` | `0` | — |
+
+---
+
+## Response
+
+```ts
+{
+  items: Contact[],
+  limit: number,
+  offset: number,
+}
+```
+
+Each `Contact` item follows the shape defined in `src/types/contact.ts`.
+
+---
+
+## SDK usage
+
+```ts
+import { contact } from '@proveanything/smartlinks'
+
+const results = await contact.search({
+  collectionId: "my-collection",
+  q: "jane",
+  tags: ["vip"],
+  limit: 20,
+})
+
+for (const c of results.items) {
+  console.log(c.displayName, c.email)
+}
+```
+
+---
+
+## Performance notes
+
+The search endpoint is backed by **PostgreSQL trigram GIN indexes** via the
+`pg_trgm` extension (migration `20260519000001`). This makes `ILIKE '%query%'`
+scans fast even with millions of contacts per org.
+
+**What is a trigram?** PostgreSQL decomposes every string into overlapping
+3-character windows ("trigrams") and stores them in an inverted index. A query
+for `"acme"` is converted into trigrams `" ac", "acm", "cme", "me "` and the
+index returns only rows containing those windows — so Postgres never scans rows
+that can't match, regardless of whether the query is a prefix, suffix, or
+middle-of-word substring.
+
+**Type-ahead mode** (`typeahead: true`) is the recommended pattern for
+keystroke-by-keystroke UI. It emits `LIKE 'query%'` (prefix) operators instead
+of `LIKE '%query%'` (substring). Prefix scans are cheaper because they require
+fewer trigram lookups, making them safe to call on every keypress. Minimum query
+length is enforced at 2 characters server-side to prevent over-broad scans.
+
+**Future scale path:** At very high volumes, routing `search` through
+Elasticsearch would add typo-tolerance and relevance ranking. The API surface is
+intentionally implementation-agnostic so the backing engine can be swapped
+without client changes.
+
+---
+
+## Error codes
+
+| Code | HTTP | Meaning |
+|---|---|---|
+| `SEARCH_REQUIRED` | 400 | No searchable parameter was provided. |

package/dist/openapi.yaml

@@ -2586,6 +2586,113 @@ paths:
           description: Unauthorized
         404:
           description: Not found
+  /admin/collection/{collectionId}/contacts/search:
+    get:
+      tags:
+        - contact
+      summary: contact.search
+      operationId: contact_search
+      security:
+        - bearerAuth: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: q
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: typeahead
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: email
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: phone
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: id
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: userId
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: source
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: locale
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: createdFrom
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: createdTo
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: externalIdKey
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: externalIdValue
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: customFieldKey
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: customFieldValue
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: limit
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: offset
+          in: query
+          required: false
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ContactSearchResponse"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
   /admin/collection/{collectionId}/contacts/upsert:
     post:
       tags:
@@ -19580,6 +19687,70 @@ components:
         - items
         - limit
         - offset
+    ContactSearchParams:
+      type: object
+      properties:
+        collectionId:
+          type: string
+        q:
+          type: string
+        typeahead:
+          type: boolean
+        email:
+          type: string
+        phone:
+          type: string
+        id:
+          type: string
+        userId:
+          type: string
+        tags:
+          type: array
+          items:
+            type: object
+            additionalProperties: true
+        tagsAll:
+          type: array
+          items:
+            type: object
+            additionalProperties: true
+        source:
+          type: string
+        locale:
+          type: string
+        createdFrom:
+          type: string
+        createdTo:
+          type: string
+        externalIdKey:
+          type: string
+        externalIdValue:
+          type: string
+        customFieldKey:
+          type: string
+        customFieldValue:
+          type: string
+        limit:
+          type: number
+        offset:
+          type: number
+      required:
+        - collectionId
+    ContactSearchResponse:
+      type: object
+      properties:
+        items:
+          type: array
+          items:
+            $ref: "#/components/schemas/Contact"
+        limit:
+          type: number
+        offset:
+          type: number
+      required:
+        - items
+        - limit
+        - offset
     PublicContactUpsertResponse:
       type: object
       properties:

package/dist/types/contact.d.ts

@@ -34,6 +34,32 @@ export interface ContactListResponse {
     limit: number;
     offset: number;
 }
+export interface ContactSearchParams {
+    collectionId: string;
+    q?: string;
+    typeahead?: boolean;
+    email?: string;
+    phone?: string;
+    id?: string;
+    userId?: string;
+    tags?: string | string[];
+    tagsAll?: string | string[];
+    source?: string;
+    locale?: string;
+    createdFrom?: string;
+    createdTo?: string;
+    externalIdKey?: string;
+    externalIdValue?: string;
+    customFieldKey?: string;
+    customFieldValue?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface ContactSearchResponse {
+    items: Contact[];
+    limit: number;
+    offset: number;
+}
 export type PublicContactUpsertRequest = Partial<Pick<Contact, "email" | "phone" | "userId" | "firstName" | "lastName" | "displayName" | "company" | "tags" | "source" | "notes" | "avatarUrl" | "locale" | "timezone" | "externalIds">> & {
     customFields?: ContactCustomFields;
 };

package/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 1.14.10  |  Generated: 2026-05-16T17:03:23.904Z
+Version: 1.14.11  |  Generated: 2026-05-19T10:35:51.071Z
 
 This is a concise summary of all available API functions and types.
 
@@ -4460,6 +4460,40 @@ interface ContactListResponse {
 }
 ```
 
+**ContactSearchParams** (interface)
+```typescript
+interface ContactSearchParams {
+  collectionId: string
+  q?: string
+  typeahead?: boolean
+  email?: string
+  phone?: string
+  id?: string
+  userId?: string
+  tags?: string | string[]
+  tagsAll?: string | string[]
+  source?: string
+  locale?: string
+  createdFrom?: string
+  createdTo?: string
+  externalIdKey?: string
+  externalIdValue?: string
+  customFieldKey?: string
+  customFieldValue?: string
+  limit?: number
+  offset?: number
+}
+```
+
+**ContactSearchResponse** (interface)
+```typescript
+interface ContactSearchResponse {
+  items: Contact[]
+  limit: number
+  offset: number
+}
+```
+
 **PublicContactUpsertResponse** (interface)
 ```typescript
 interface PublicContactUpsertResponse {
@@ -8629,6 +8663,28 @@ Returns all proof type definitions. Proof types are templates that specify which
 **list**(collectionId: string,
     params?: { limit?: number; offset?: number; includeDeleted?: boolean }) → `Promise<ContactListResponse>`
 
+**search**({
+    collectionId,
+    q,
+    typeahead,
+    email,
+    phone,
+    id,
+    userId,
+    tags,
+    tagsAll,
+    source,
+    locale,
+    createdFrom,
+    createdTo,
+    externalIdKey,
+    externalIdValue,
+    customFieldKey,
+    customFieldValue,
+    limit,
+    offset,
+  }: ContactSearchParams) → `Promise<ContactSearchResponse>`
+
 **get**(collectionId: string,
     contactId: string,
     params?: { includeDeleted?: boolean }) → `Promise<ContactResponse>`

package/docs/contact-search.md

@@ -0,0 +1,162 @@
+# Contact Search
+
+Admin-scoped endpoint for querying contacts within a collection. Supports
+free-text search, type-ahead, identity lookup, structured filters, and JSONB
+field queries. All parameters are optional and composable.
+
+**Base path:** `GET /api/admin/:collectionId/contacts/search`
+
+---
+
+## Quick examples
+
+```ts
+// Type-ahead while user types "joh" into a search box
+await contact.search({ collectionId, q: "joh", typeahead: true })
+
+// Find contacts by partial email
+await contact.search({ collectionId, email: "acme.com" })
+
+// Exact contact by UUID
+await contact.search({ collectionId, id: "uuid-here" })
+
+// All contacts tagged "vip" created this year
+await contact.search({
+  collectionId,
+  tags: ["vip"],
+  createdFrom: "2026-01-01",
+})
+
+// Find by external ID (e.g. Shopify customer ID)
+await contact.search({
+  collectionId,
+  externalIdKey: "shopify_id",
+  externalIdValue: "123456",
+})
+```
+
+---
+
+## Parameters
+
+### Free-text
+
+| Param | Type | Description |
+|---|---|---|
+| `q` | `string` | General search term. Searches `first_name`, `last_name`, `display_name`, `company`, and all identity values (`email`, `phone`). When the value contains `@` only email identities are searched; when it matches a phone pattern only phone identities are searched. |
+| `typeahead` | `boolean` | When `true`, uses prefix (`startsWith`) operators instead of substring (`contains`). Significantly cheaper per keystroke. Default limit becomes `10`; minimum `q` length is 2 characters. Use this for live search-as-you-type UIs. |
+
+### Identity filters
+
+| Param | Type | Description |
+|---|---|---|
+| `email` | `string` | Partial match against normalised email identity values. Case-insensitive. |
+| `phone` | `string` | Partial match against normalised phone identity values. |
+
+### Exact lookups
+
+These short-circuit all text/filter logic and return at most one contact.
+
+| Param | Type | Description |
+|---|---|---|
+| `id` | `string` (UUID) | Contact primary key. |
+| `userId` | `string` | Firebase auth UID linked to the contact. |
+
+### Structured filters
+
+All filters are ANDed with each other and with any text search.
+
+| Param | Type | Description |
+|---|---|---|
+| `tags` | `string \| string[]` | Comma-separated string or repeated param. Contacts must have **any** of these tags. |
+| `tagsAll` | `string \| string[]` | Contacts must have **all** of these tags. |
+| `source` | `string` | Exact match on the `source` field. |
+| `locale` | `string` | Exact match on the `locale` field (e.g. `"en-US"`). |
+| `createdFrom` | `string` (ISO-8601) | Lower bound on `created_at`. |
+| `createdTo` | `string` (ISO-8601) | Upper bound on `created_at`. |
+
+### JSONB field filters
+
+Searches inside the `external_ids` or `custom_fields` JSONB columns by
+key/value pair. Both params in a pair must be supplied together.
+
+| Param | Type | Description |
+|---|---|---|
+| `externalIdKey` | `string` | Top-level key in `externalIds` (e.g. `"shopify_id"`). |
+| `externalIdValue` | `string` | Expected value at that key. |
+| `customFieldKey` | `string` | Top-level key in `customFields`. |
+| `customFieldValue` | `string` | Expected value at that key. |
+
+### Pagination
+
+| Param | Type | Default | Max |
+|---|---|---|---|
+| `limit` | `number` | `20` (`10` in typeahead mode) | `100` (`10` in typeahead mode) |
+| `offset` | `number` | `0` | — |
+
+---
+
+## Response
+
+```ts
+{
+  items: Contact[],
+  limit: number,
+  offset: number,
+}
+```
+
+Each `Contact` item follows the shape defined in `src/types/contact.ts`.
+
+---
+
+## SDK usage
+
+```ts
+import { contact } from '@proveanything/smartlinks'
+
+const results = await contact.search({
+  collectionId: "my-collection",
+  q: "jane",
+  tags: ["vip"],
+  limit: 20,
+})
+
+for (const c of results.items) {
+  console.log(c.displayName, c.email)
+}
+```
+
+---
+
+## Performance notes
+
+The search endpoint is backed by **PostgreSQL trigram GIN indexes** via the
+`pg_trgm` extension (migration `20260519000001`). This makes `ILIKE '%query%'`
+scans fast even with millions of contacts per org.
+
+**What is a trigram?** PostgreSQL decomposes every string into overlapping
+3-character windows ("trigrams") and stores them in an inverted index. A query
+for `"acme"` is converted into trigrams `" ac", "acm", "cme", "me "` and the
+index returns only rows containing those windows — so Postgres never scans rows
+that can't match, regardless of whether the query is a prefix, suffix, or
+middle-of-word substring.
+
+**Type-ahead mode** (`typeahead: true`) is the recommended pattern for
+keystroke-by-keystroke UI. It emits `LIKE 'query%'` (prefix) operators instead
+of `LIKE '%query%'` (substring). Prefix scans are cheaper because they require
+fewer trigram lookups, making them safe to call on every keypress. Minimum query
+length is enforced at 2 characters server-side to prevent over-broad scans.
+
+**Future scale path:** At very high volumes, routing `search` through
+Elasticsearch would add typo-tolerance and relevance ranking. The API surface is
+intentionally implementation-agnostic so the backing engine can be swapped
+without client changes.
+
+---
+
+## Error codes
+
+| Code | HTTP | Meaning |
+|---|---|---|
+| `SEARCH_REQUIRED` | 400 | No searchable parameter was provided. |

package/openapi.yaml

@@ -2586,6 +2586,113 @@ paths:
           description: Unauthorized
         404:
           description: Not found
+  /admin/collection/{collectionId}/contacts/search:
+    get:
+      tags:
+        - contact
+      summary: contact.search
+      operationId: contact_search
+      security:
+        - bearerAuth: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: q
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: typeahead
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: email
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: phone
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: id
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: userId
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: source
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: locale
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: createdFrom
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: createdTo
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: externalIdKey
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: externalIdValue
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: customFieldKey
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: customFieldValue
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: limit
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: offset
+          in: query
+          required: false
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ContactSearchResponse"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
   /admin/collection/{collectionId}/contacts/upsert:
     post:
       tags:
@@ -19580,6 +19687,70 @@ components:
         - items
         - limit
         - offset
+    ContactSearchParams:
+      type: object
+      properties:
+        collectionId:
+          type: string
+        q:
+          type: string
+        typeahead:
+          type: boolean
+        email:
+          type: string
+        phone:
+          type: string
+        id:
+          type: string
+        userId:
+          type: string
+        tags:
+          type: array
+          items:
+            type: object
+            additionalProperties: true
+        tagsAll:
+          type: array
+          items:
+            type: object
+            additionalProperties: true
+        source:
+          type: string
+        locale:
+          type: string
+        createdFrom:
+          type: string
+        createdTo:
+          type: string
+        externalIdKey:
+          type: string
+        externalIdValue:
+          type: string
+        customFieldKey:
+          type: string
+        customFieldValue:
+          type: string
+        limit:
+          type: number
+        offset:
+          type: number
+      required:
+        - collectionId
+    ContactSearchResponse:
+      type: object
+      properties:
+        items:
+          type: array
+          items:
+            $ref: "#/components/schemas/Contact"
+        limit:
+          type: number
+        offset:
+          type: number
+      required:
+        - items
+        - limit
+        - offset
     PublicContactUpsertResponse:
       type: object
       properties:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proveanything/smartlinks",
-  "version": "1.14.10",
+  "version": "1.14.11",
   "description": "Official JavaScript/TypeScript SDK for the Smartlinks API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",