@bitbitpress/client 1.0.0 → 1.0.2

package/README.md

@@ -51,6 +51,8 @@ More details can also be found in your control room's API docs @ https://your-co
   - [signalItem](#signalitem)
   - [synthesizeItem](#synthesizeitem)
   - [synthesize](#synthesize)
+  - [interactions](#interactions)
+  - [respondToInteraction](#respondtointeraction)
 - [Data Methods](#data-methods)
   - [assets](#assets)
 - [Types](#types)
@@ -453,7 +455,7 @@ client.user.synthesizeItem(
 
 ##### Parameters
 
-- `item` (required): A single synthesize item (same shape as items in `synthesize`): `inputs`, `output` (schema as JSON string or Zod 4 schema), optional `configurationKeyName`, optional `searchOptionsOverrides` (e.g. `{ lookbackMinutes: 1440 }` for 24-hour lookback)
+- `item` (required): A single synthesize item (same shape as items in `synthesize`): `inputs`, `output` (schema as JSON string or Zod 4 schema), optional `configurationKeyName`, optional `limit` (number of results to return; defaults to `1`), optional `searchOptionsOverrides` (e.g. `{ lookbackMinutes: 1440 }` for 24-hour lookback)
 - `onStreamingData` (optional): Callback invoked with streaming data whenever a stream event has `complete: false` for this item. Type: `(data: unknown) => void`.
 
 ##### Returns
@@ -513,6 +515,7 @@ client.user.synthesize(
   - `inputs` (optional): Context for synthesis — array of `{ type: "externalId" | "text" | "excludeExternalIds", value: string }` (article ID, freeform text, or comma-separated external IDs to exclude)
   - `output`: `{ schema: string | ZodType }` — output schema as a JSON string or Zod 4 schema (top-level type must be `"object"`; supports object, string, number, boolean, array, and enum)
   - `configurationKeyName` (optional): Key name for configuration
+  - `limit` (optional): Number of results to return. Defaults to `1`.
   - `searchOptionsOverrides` (optional): Per-request overrides, e.g. `{ lookbackMinutes: 1440 }` for 24-hour lookback.
 - `options` (optional): `{ onStreamingData?: (index: number, data: unknown) => void }` — if provided, `onStreamingData` is called for each data event with `complete: false`, with the item's index and streaming data
 
@@ -578,6 +581,98 @@ for await (const event of stream) {
 
 ---
 
+#### interactions
+
+Batch-resolve interaction state for items from a synthesis output. Returns aggregates and whether the current user has already responded to each.
+
+```typescript
+client.user.interactions(options: InteractionsRequest): Promise<InteractionsResponse>
+```
+
+##### Parameters
+
+- `options.synthesisConfigKeyName` (required): Key name of the synthesis config these interactions belong to
+- `options.interactions` (required): Array of interactions to resolve, each with:
+  - `type` (required): Interaction type — `"POLL"`
+  - `content` (required): Canonical JSON string of the interaction content (e.g. question + options for a POLL)
+
+##### Returns
+
+- `Promise<InteractionsResponse>`: Array of resolved interaction items, each with:
+  - `id: string`: Interaction ID
+  - `type: string`: Interaction type
+  - `content: string`: Canonical JSON string of the interaction content
+  - `hasResponded: boolean`: Whether the current user has already responded
+  - `aggregates: Record<string, unknown>`: Current aggregate data (e.g. vote counts)
+
+##### Example
+
+```typescript
+const interactions = await client.user.interactions({
+  synthesisConfigKeyName: 'my-synthesis-config',
+  interactions: [
+    {
+      type: 'POLL',
+      content: JSON.stringify({ question: 'Which do you prefer?', options: [{ id: 'a', text: 'Option A' }, { id: 'b', text: 'Option B' }] }),
+    },
+  ],
+});
+
+for (const item of interactions) {
+  console.log('Interaction ID:', item.id);
+  console.log('Has responded:', item.hasResponded);
+  console.log('Aggregates:', item.aggregates);
+}
+```
+
+##### Throws
+
+- `Error`: If the request fails or no data is returned
+
+---
+
+#### respondToInteraction
+
+Submit or update a response to an interaction (e.g. a poll answer). Returns updated aggregates.
+
+```typescript
+client.user.respondToInteraction(
+  interactionId: string,
+  options: InteractionResponseRequest,
+): Promise<InteractionResponseResponse>
+```
+
+##### Parameters
+
+- `interactionId` (required): ID of the interaction to respond to (from `interactions()`)
+- `options.type` (required): Interaction type — `"POLL"`
+- `options.responseData` (required): Response data:
+  - `response` (required): Selected option ID
+
+##### Returns
+
+- `Promise<InteractionResponseResponse>`: Response containing:
+  - `aggregates: Record<string, unknown>`: Updated aggregate data after recording the response
+  - `appUserResponse: Record<string, unknown>`: The user's recorded response
+
+##### Example
+
+```typescript
+const result = await client.user.respondToInteraction('interaction-id-123', {
+  type: 'POLL',
+  responseData: { response: 'option-a-id' },
+});
+
+console.log('Updated aggregates:', result.aggregates);
+console.log('Recorded response:', result.appUserResponse);
+```
+
+##### Throws
+
+- `Error`: If the request fails or no data is returned
+
+---
+
 ### Data Methods
 
 Data methods require authentication. Call `client.user.authenticate()` before using them.
@@ -745,12 +840,13 @@ type SignalResponse = {
 
 #### SynthesizeRequest
 
-Request body for POST `/v1/user/synthesize` (from OpenAPI). Each item has `inputs`, `output`, optional `configurationKeyName`, and optional `searchOptionsOverrides`.
+Request body for POST `/v1/user/synthesize` (from OpenAPI). Each item has `inputs`, `output`, optional `configurationKeyName`, optional `limit` (defaults to `1`), and optional `searchOptionsOverrides`.
 
 ```typescript
 type SynthesizeRequest = {
   items: Array<{
     configurationKeyName?: string;
+    limit?: number; // number of results to return; defaults to 1
     searchOptionsOverrides?: { lookbackMinutes?: number };
     inputs?: Array<{ type: 'externalId' | 'text' | 'excludeExternalIds'; value: string }>;
     output: {
@@ -830,3 +926,63 @@ interface SynthesizeOptions {
   onStreamingData?: (index: number, data: unknown) => void;
 }
 ```
+
+#### InteractionsRequest
+
+Request body for POST `/v1/user/interactions`.
+
+```typescript
+type InteractionsRequest = {
+  synthesisConfigKeyName: string;
+  interactions: Array<{
+    type: 'POLL';
+    content: string; // canonical JSON string of the interaction content
+  }>;
+}
+```
+
+#### InteractionItem
+
+A single resolved interaction item returned in `InteractionsResponse`.
+
+```typescript
+type InteractionItem = {
+  id: string;
+  type: string;
+  content: string;
+  hasResponded: boolean;
+  aggregates: Record<string, unknown>;
+}
+```
+
+#### InteractionsResponse
+
+Return type of `interactions`. Array of `InteractionItem`.
+
+```typescript
+type InteractionsResponse = InteractionItem[];
+```
+
+#### InteractionResponseRequest
+
+Request body for POST `/v1/user/interactions/:interactionId/responses`.
+
+```typescript
+type InteractionResponseRequest = {
+  type: 'POLL';
+  responseData: {
+    response: string; // selected option id
+  };
+}
+```
+
+#### InteractionResponseResponse
+
+Return type of `respondToInteraction`.
+
+```typescript
+type InteractionResponseResponse = {
+  aggregates: Record<string, unknown>;
+  appUserResponse: Record<string, unknown>;
+}
+```

package/dist/generated/openapi.d.ts

@@ -14,7 +14,7 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Get Authentication Bearer Token
+         * Auth - Exchange Token
          * @description **POST** `/v1/auth/token`
          *
          *     Exchange a token from your SSO provider (OIDC) for a BitBitPress authentication token required to use other endpoints.
@@ -123,7 +123,7 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Get User Profile
+         * Profile - Get User Profile
          * @description **GET** `/v1/user/profile` Returns the user's profile, including interest tags.
          */
         get: {
@@ -208,7 +208,7 @@ export interface paths {
             };
         };
         /**
-         * Update User Profile
+         * Profile - Update User Profile
          * @description **PUT** `/v1/user/profile` Updates the user's interest tags. Supports full replace via `interestTags`, or add/remove via `addInterestTags` and `removeInterestTags` arrays.
          */
         put: {
@@ -313,7 +313,7 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Retrieve User Recommendations
+         * User - Get Recommendations
          * @description **POST** `/v1/user/recommendations` Returns recommended articles for the authenticated user based on their interests.
          *
          *     #### Available fields (`fields` in request body)
@@ -438,7 +438,7 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Report Bit
+         * User - Create Report
          * @description **POST** `/v1/user/report` Creates a user-provided bit to be ingested into the system. This may include news or any other content that the user wants to share.
          */
         post: {
@@ -534,7 +534,7 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Record User Signals
+         * Profile - Record Signals
          * @description **POST** `/v1/user/signal` Records user signals (e.g. clicked topic, read article) to inform profile interests. Signals power the user's recommendations.
          */
         post: {
@@ -653,7 +653,7 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Synthesize User Content
+         * Synthesis - Synthesize Content
          * @description **POST** `/v1/user/synthesize`
          *
          *     Synthesize content items personalized to the user.
@@ -675,6 +675,8 @@ export interface paths {
                         items: {
                             /** @description Optional configuration key name. Loads an existing synthesis config by this name; omit for default configuration. */
                             configurationKeyName?: string;
+                            /** @description Number of results to return. Defaults to 1. */
+                            limit?: number;
                             /** @description Per-request overrides for search options. */
                             searchOptionsOverrides?: {
                                 /** @description Override for search lookback window in minutes (e.g. 1440 for last 24 hours). */
@@ -784,6 +786,240 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/user/interactions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Synthesis - Get User Interactions
+         * @description **POST** `/v1/user/interactions`
+         *
+         *     Batch-resolve interaction state for items from a synthesis output. Returns aggregates and whether the current user has already responded to each.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header: {
+                    authorization: string;
+                };
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /** @description keyName of the synthesis config these interactions belong to. */
+                        synthesisConfigKeyName: string;
+                        /** @description Interactions to resolve, in order. */
+                        interactions: {
+                            /**
+                             * @description Interaction type.
+                             * @enum {string}
+                             */
+                            type: "POLL";
+                            /** @description Canonical JSON string of the interaction content (e.g. question + options for a POLL). */
+                            content: string;
+                        }[];
+                    };
+                };
+            };
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            success: boolean;
+                            data: {
+                                id: string;
+                                type: string;
+                                content: string;
+                                hasResponded: boolean;
+                                aggregates: {
+                                    [key: string]: unknown;
+                                };
+                            }[];
+                        };
+                    };
+                };
+                /** @description Bad request - missing or invalid parameters */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example Bad request */
+                            error?: string;
+                        };
+                    };
+                };
+                /** @description Unauthorized errors */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /**
+                             * @example Unauthorized: No authentication token provided
+                             * @enum {string}
+                             */
+                            error?: "Unauthorized: No authentication token provided" | "Unauthorized: Token has expired" | "Unauthorized: Invalid token" | "Unauthorized: Authentication failed";
+                        };
+                    };
+                };
+                /** @description Internal server error */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example false */
+                            success?: boolean;
+                            /** @example Internal server error: An unknown error occurred */
+                            error?: string;
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/user/interactions/{interactionId}/responses": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Synthesis - Create User Interaction Response
+         * @description **POST** `/v1/user/interactions/:interactionId/responses`
+         *
+         *     Submit or update a response to an interaction. Returns updated aggregates.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header: {
+                    authorization: string;
+                };
+                path: {
+                    interactionId: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /**
+                         * @description Interaction type.
+                         * @enum {string}
+                         */
+                        type: "POLL";
+                        /** @description For POLL: the selected option id. */
+                        responseData: {
+                            /** @description Selected option id. */
+                            response: string;
+                        };
+                    };
+                };
+            };
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            success: boolean;
+                            data: {
+                                aggregates: {
+                                    [key: string]: unknown;
+                                };
+                                appUserResponse: {
+                                    [key: string]: unknown;
+                                };
+                            };
+                        };
+                    };
+                };
+                /** @description Bad request - missing or invalid parameters */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example Bad request */
+                            error?: string;
+                        };
+                    };
+                };
+                /** @description Unauthorized errors */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /**
+                             * @example Unauthorized: No authentication token provided
+                             * @enum {string}
+                             */
+                            error?: "Unauthorized: No authentication token provided" | "Unauthorized: Token has expired" | "Unauthorized: Invalid token" | "Unauthorized: Authentication failed";
+                        };
+                    };
+                };
+                /** @description Default Response */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error?: string;
+                        };
+                    };
+                };
+                /** @description Internal server error */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example false */
+                            success?: boolean;
+                            /** @example Internal server error: An unknown error occurred */
+                            error?: string;
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/data/assets": {
         parameters: {
             query?: never;
@@ -794,7 +1030,7 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Fetch Assets by IDs
+         * Data - Get Assets
          * @description **POST** `/v1/data/assets` Fetches assets by IDs and returns requested fields.
          *
          *     #### Request body
@@ -802,7 +1038,7 @@ export interface paths {
          *     | Field | Type | Required | Description |
          *     |-------|------|----------|-------------|
          *     | `assetIds` | string[] | yes | List of asset IDs to fetch |
-         *     | `assetFields` | string[] | yes | Fields to return (dot or bracket notation, e.g. tags[0], images[1].src). Allowed: title, tags, images, videos, publishedAt, externalId, externalData, and subfields. Empty array returns objects with only `assetId`. |
+         *     | `assetFields` | string[] | yes | Fields to return (dot or bracket notation, e.g. tags[0], images[1].src). Allowed: assetId, title, tags, images, videos, publishedAt, externalId, externalData, sourceUrl, dataSource.name, and subfields. Empty array returns objects with only `assetId`. `externalData`'s subfields are unique to your source data. |
          */
         post: {
             parameters: {
@@ -819,7 +1055,7 @@ export interface paths {
                     "application/json": {
                         /** @description List of asset IDs to fetch */
                         assetIds: string[];
-                        /** @description Asset fields to return (dot or bracket notation). Allowed: title, tags, images, videos, publishedAt, externalId, externalData, and subfields. Empty array returns objects with only assetId. */
+                        /** @description Asset fields to return (dot or bracket notation). Allowed: assetId, title, tags, images, videos, publishedAt, externalId, externalData, assetType, sourceUrl, dataSource.name, and subfields. Empty array returns objects with only assetId. */
                         assetFields: string[];
                     };
                 };
@@ -893,6 +1129,159 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/admin/v1/assets/upsert": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Upsert Asset
+         * @description **POST** `/admin/v1/assets/upsert` Creates or updates an asset in the system. If an asset with the same `externalId` already exists it will be updated; otherwise a new asset is created and queued for ingestion.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /** @description Key name of the Admin API data source to associate this asset with */
+                        dataSourceKey: string;
+                        /** @description Unique identifier for the asset in your system */
+                        externalId: string;
+                        /** @description Title of the asset */
+                        title: string;
+                        /** @description Full text content of the asset */
+                        content: string;
+                        /**
+                         * @description Format of the content field. Defaults to text/plain.
+                         * @enum {string}
+                         */
+                        mimeType?: "text/plain" | "text/markdown" | "text/html";
+                        /** @description Canonical URL of the original source */
+                        sourceUrl?: string;
+                        /** @description ISO 8601 publication timestamp */
+                        publishedAt?: string;
+                        /** @description Author or byline */
+                        byline?: string;
+                        /** @description List of tags or categories */
+                        tags?: string[];
+                        /** @description Images associated with the asset */
+                        images?: {
+                            /** @description Image URL */
+                            src: string;
+                            /** @description Alt text */
+                            alt?: string;
+                            /** @description External identifier for the image */
+                            externalId?: string;
+                            /** @description Image width in pixels */
+                            width?: number;
+                            /** @description Image height in pixels */
+                            height?: number;
+                            /** @description Photo credit or attribution */
+                            credit?: string;
+                        }[];
+                        /** @description Videos associated with the asset */
+                        videos?: {
+                            /** @description One or more video source URLs with MIME types */
+                            sources: {
+                                /** @description MIME type of the video source (e.g. video/mp4) */
+                                mimeType: string;
+                                /** @description Video source URL */
+                                src: string;
+                            }[];
+                            /** @description Alt text for the video */
+                            alt?: string;
+                            /** @description External identifier for the video */
+                            externalId?: string;
+                            /** @description Video credit or attribution */
+                            credit?: string;
+                            /** @description Poster image URL */
+                            posterUrl?: string;
+                            /** @description Video caption */
+                            caption?: string;
+                            /** @description Video width in pixels */
+                            width?: number;
+                            /** @description Video height in pixels */
+                            height?: number;
+                        }[];
+                        /** @description Arbitrary additional data to store with the asset */
+                        externalData?: {
+                            [key: string]: unknown;
+                        };
+                    };
+                };
+            };
+            responses: {
+                /** @description Successful response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            success: boolean;
+                            data: {
+                                /** @description Internal asset identifier */
+                                assetId: string;
+                                /** @description True if a new asset was created */
+                                created: boolean;
+                                /** @description True if the asset was queued for ingestion */
+                                queued: boolean;
+                            };
+                        };
+                    };
+                };
+                /** @description Bad request - missing or invalid parameters */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error?: string;
+                        };
+                    };
+                };
+                /** @description Unauthorized errors */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @enum {string} */
+                            error?: "Unauthorized: No API key provided" | "Unauthorized: Invalid or revoked API key";
+                        };
+                    };
+                };
+                /** @description Internal server error */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            success?: boolean;
+                            error?: string;
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
 }
 export type webhooks = Record<string, never>;
 export interface components {

package/dist/index.d.ts

@@ -19,4 +19,5 @@ export type { TokenRequest, TokenResponse } from './user/token.js';
 export type { BitBitPressSynthesizeRequest, RecommendationsRequestBody, SynthesizeInput, SynthesizeItem, SynthesizeItems, SynthesizeOutputSchema, SynthesizeRequest, } from './user/typeDefs.js';
 export type { SynthesizeEvent, SynthesizeItemResponse, SynthesizeOptions } from './user/synthesize.js';
 export type { SynthesizeOnStreamingData } from './user/synthesize-batch-manager.js';
+export type { InteractionItem, InteractionResponseRequest, InteractionResponseResponse, InteractionsRequest, InteractionsResponse, } from './user/interaction.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACrF,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EACnB,yBAAyB,EACzB,WAAW,EACX,QAAQ,GACT,MAAM,cAAc,CAAC;AAGtB,mBAAmB,wBAAwB,CAAC;AAG5C,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACtE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC9E,YAAY,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACjG,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACtE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACnE,YAAY,EACV,4BAA4B,EAC5B,0BAA0B,EAC1B,eAAe,EACf,cAAc,EACd,eAAe,EACf,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,eAAe,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACvG,YAAY,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACrF,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EACnB,yBAAyB,EACzB,WAAW,EACX,QAAQ,GACT,MAAM,cAAc,CAAC;AAGtB,mBAAmB,wBAAwB,CAAC;AAG5C,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACtE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC9E,YAAY,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACjG,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACtE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACnE,YAAY,EACV,4BAA4B,EAC5B,0BAA0B,EAC1B,eAAe,EACf,cAAc,EACd,eAAe,EACf,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,eAAe,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACvG,YAAY,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AACpF,YAAY,EACV,eAAe,EACf,0BAA0B,EAC1B,2BAA2B,EAC3B,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC"}

package/dist/user/index.d.ts

@@ -8,6 +8,7 @@ import { type Signal, type SignalRequest, type SignalResponse } from './signal.j
 import { type SynthesizeEvent, type SynthesizeItemResponse } from './synthesize.js';
 import { type TokenRequest, type TokenResponse } from './token.js';
 import type { SynthesizeItem, SynthesizeItems } from './typeDefs.js';
+import { type InteractionResponseRequest, type InteractionResponseResponse, type InteractionsRequest, type InteractionsResponse } from './interaction.js';
 /**
  * User-related API methods interface (aligned with OpenAPI spec paths).
  */
@@ -70,7 +71,7 @@ export interface UserMethods {
     /**
      * Synthesize content items personalized to the user (streaming SSE).
      *
-     * @param items - Array of items: optional inputs (type: externalId | text | excludeExternalIds, value), output (schema), optional configurationKeyName, optional searchOptionsOverrides (e.g. lookbackMinutes)
+     * @param items - Array of items: optional inputs (type: externalId | text | excludeExternalIds, value), output (schema), optional configurationKeyName, optional limit (number of results to return; defaults to 1), optional searchOptionsOverrides (e.g. lookbackMinutes)
      * @param options - Optional: onStreamingData(index, data) called for each streaming data update per item index
      * @returns AsyncIterable yielding connection events (connected, complete) and data events (index, data?, complete, error?)
      */
@@ -85,6 +86,22 @@ export interface UserMethods {
      * @returns Promise that resolves with the synthesized data for that item's index
      */
     synthesizeItem(item: SynthesizeItem, onStreamingData?: SynthesizeOnStreamingData): Promise<SynthesizeItemResponse>;
+    /**
+     * Batch-resolve interaction state for items from a synthesis output.
+     * Returns aggregates and whether the current user has already responded to each.
+     *
+     * @param options - synthesisConfigKeyName and interactions array (type + content)
+     * @returns Array of resolved interaction items (id, type, content, hasResponded, aggregates)
+     */
+    interactions(options: InteractionsRequest): Promise<NonNullable<InteractionsResponse>>;
+    /**
+     * Submit or update a response to an interaction (e.g. a poll answer). Returns updated aggregates.
+     *
+     * @param interactionId - ID of the interaction to respond to
+     * @param options - type (e.g. 'POLL') and responseData (e.g. { response: 'optionId' })
+     * @returns Updated aggregates and the user's recorded response
+     */
+    respondToInteraction(interactionId: string, options: InteractionResponseRequest): Promise<NonNullable<InteractionResponseResponse>>;
 }
 /**
  * User-related API methods (uses shared auth store).

package/dist/user/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/user/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAA0B,KAAK,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AACvG,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC7B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAA0B,KAAK,eAAe,EAAE,KAAK,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACvG,OAAO,EAAa,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAgB,KAAK,MAAM,EAAE,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAEjG,OAAO,EAAc,KAAK,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAChG,OAAO,EAAiB,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAClF,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;OAKG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9C;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,EAAE,YAAY,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAElE;;;;OAIG;IACH,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC,CAAC;IAEjD;;;;;OAKG;IACH,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC,CAAC;IAEpF;;;;;OAKG;IACH,eAAe,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,WAAW,CAAC,uBAAuB,CAAC,CAAC,CAAC;IAEjG;;;;;OAKG;IACH,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC,CAAC;IAErE;;;;;OAKG;IACH,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC,CAAC;IAErE;;;;;OAKG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC,CAAC;IAEjE;;;;;;OAMG;IACH,UAAU,CACR,KAAK,EAAE,eAAe,EACtB,OAAO,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;KAAE,GACrE,OAAO,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC,CAAC;IAE3C;;;;;;OAMG;IACH,cAAc,CACZ,IAAI,EAAE,cAAc,EACpB,eAAe,CAAC,EAAE,yBAAyB,GAC1C,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,aAAa,EACrB,sBAAsB,GAAE,MAAY,EACpC,kBAAkB,GAAE,MAAY,GAC/B,WAAW,CA0Cb"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/user/index.ts"],"names":[],"mappings":"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"}

package/dist/user/index.js

@@ -9,6 +9,7 @@ const signal_js_1 = require("./signal.js");
 const signal_batch_manager_js_1 = require("./signal-batch-manager.js");
 const synthesize_js_1 = require("./synthesize.js");
 const token_js_1 = require("./token.js");
+const interaction_js_1 = require("./interaction.js");
 /**
  * User-related API methods (uses shared auth store).
  */
@@ -27,6 +28,8 @@ function createUserMethods(authStore, config, synthesizeBatchTimeout = 250, sign
         signalItem: (signal) => signalBatchManager.addSignal(signal),
         synthesize: (items, options) => getConfigWithToken().then((cfg) => (0, synthesize_js_1.synthesize)(cfg, items, options)),
         synthesizeItem: (item, onStreamingData) => synthesizeBatchManager.addItem(item, onStreamingData),
+        interactions: (options) => getConfigWithToken().then((cfg) => (0, interaction_js_1.getInteractions)(cfg, options)),
+        respondToInteraction: (interactionId, options) => getConfigWithToken().then((cfg) => (0, interaction_js_1.respondToInteraction)(cfg, interactionId, options)),
     };
 }
 //# sourceMappingURL=index.js.map

package/dist/user/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/user/index.ts"],"names":[],"mappings":";;AA+GA,8CA+CC;AA5JD,+EAAuG;AACvG,6DAI8B;AAC9B,6CAAuG;AACvG,2CAAiF;AACjF,2CAAiG;AACjG,uEAA+D;AAC/D,mDAAgG;AAChG,yCAAkF;AA+FlF;;GAEG;AACH,SAAgB,iBAAiB,CAC/B,SAAoB,EACpB,MAAqB,EACrB,yBAAiC,GAAG,EACpC,qBAA6B,GAAG;IAEhC,MAAM,kBAAkB,GAAG,SAAS,CAAC,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAExE,MAAM,sBAAsB,GAAG,IAAI,oDAAsB,CACvD,kBAAkB,EAClB,sBAAsB,CACvB,CAAC;IACF,MAAM,kBAAkB,GAAG,IAAI,4CAAkB,CAC/C,kBAAkB,EAClB,kBAAkB,CACnB,CAAC;IAEF,OAAO;QACL,YAAY,EAAE,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC;QAEpD,KAAK,EAAE,CAAC,QAAkC,EAAE,EAAE,CAAC,IAAA,wBAAa,EAAC,MAAM,EAAE,QAAQ,CAAC;QAE9E,OAAO,EAAE,GAAG,EAAE,CAAC,kBAAkB,EAAE,CAAC,IAAI,CAAC,uBAAU,CAAC;QAEpD,aAAa,EAAE,CAAC,OAA6B,EAAE,EAAE,CAC/C,kBAAkB,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAA,uBAAU,EAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAE9D,eAAe,EAAE,CAAC,OAAgC,EAAE,EAAE,CACpD,kBAAkB,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAA,uCAAkB,EAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAEtE,MAAM,EAAE,CAAC,OAAsB,EAAE,EAAE,CACjC,kBAAkB,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAA,qBAAS,EAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAE7D,MAAM,EAAE,CAAC,OAAsB,EAAE,EAAE,CACjC,kBAAkB,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAA,wBAAY,EAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAEhE,UAAU,EAAE,CAAC,MAAc,EAAwC,EAAE,CACnE,kBAAkB,CAAC,SAAS,CAAC,MAAM,CAAC;QAEtC,UAAU,EAAE,CAAC,KAAsB,EAAE,OAAsE,EAAE,EAAE,CAC7G,kBAAkB,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAA,0BAAU,EAAC,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QAErE,cAAc,EAAE,CACd,IAAoB,EACpB,eAA2C,EACV,EAAE,CAAC,sBAAsB,CAAC,OAAO,CAAC,IAAI,EAAE,eAAe,CAAC;KAC5F,CAAC;AACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/user/index.ts"],"names":[],"mappings":";;AA6IA,8CAqDC;AAhMD,+EAAuG;AACvG,6DAI8B;AAC9B,6CAAuG;AACvG,2CAAiF;AACjF,2CAAiG;AACjG,uEAA+D;AAC/D,mDAAgG;AAChG,yCAAkF;AAElF,qDAQ0B;AAmH1B;;GAEG;AACH,SAAgB,iBAAiB,CAC/B,SAAoB,EACpB,MAAqB,EACrB,yBAAiC,GAAG,EACpC,qBAA6B,GAAG;IAEhC,MAAM,kBAAkB,GAAG,SAAS,CAAC,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAExE,MAAM,sBAAsB,GAAG,IAAI,oDAAsB,CACvD,kBAAkB,EAClB,sBAAsB,CACvB,CAAC;IACF,MAAM,kBAAkB,GAAG,IAAI,4CAAkB,CAC/C,kBAAkB,EAClB,kBAAkB,CACnB,CAAC;IAEF,OAAO;QACL,YAAY,EAAE,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC;QAEpD,KAAK,EAAE,CAAC,QAAkC,EAAE,EAAE,CAAC,IAAA,wBAAa,EAAC,MAAM,EAAE,QAAQ,CAAC;QAE9E,OAAO,EAAE,GAAG,EAAE,CAAC,kBAAkB,EAAE,CAAC,IAAI,CAAC,uBAAU,CAAC;QAEpD,aAAa,EAAE,CAAC,OAA6B,EAAE,EAAE,CAC/C,kBAAkB,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAA,uBAAU,EAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAE9D,eAAe,EAAE,CAAC,OAAgC,EAAE,EAAE,CACpD,kBAAkB,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAA,uCAAkB,EAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAEtE,MAAM,EAAE,CAAC,OAAsB,EAAE,EAAE,CACjC,kBAAkB,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAA,qBAAS,EAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAE7D,MAAM,EAAE,CAAC,OAAsB,EAAE,EAAE,CACjC,kBAAkB,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAA,wBAAY,EAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAEhE,UAAU,EAAE,CAAC,MAAc,EAAwC,EAAE,CACnE,kBAAkB,CAAC,SAAS,CAAC,MAAM,CAAC;QAEtC,UAAU,EAAE,CAAC,KAAsB,EAAE,OAAsE,EAAE,EAAE,CAC7G,kBAAkB,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAA,0BAAU,EAAC,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QAErE,cAAc,EAAE,CACd,IAAoB,EACpB,eAA2C,EACV,EAAE,CAAC,sBAAsB,CAAC,OAAO,CAAC,IAAI,EAAE,eAAe,CAAC;QAE3F,YAAY,EAAE,CAAC,OAA4B,EAAE,EAAE,CAC7C,kBAAkB,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAA,gCAAe,EAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAEnE,oBAAoB,EAAE,CAAC,aAAqB,EAAE,OAAmC,EAAE,EAAE,CACnF,kBAAkB,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAA,qCAAoB,EAAC,GAAG,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC;KACxF,CAAC;AACJ,CAAC"}

package/dist/user/interaction.d.ts

@@ -0,0 +1,27 @@
+import type { paths } from '../generated/openapi.js';
+import type { RequestConfig } from '../request.js';
+export type InteractionsRequest = paths['/v1/user/interactions']['post']['requestBody']['content']['application/json'];
+export type InteractionsResponse = paths['/v1/user/interactions']['post']['responses'][200]['content']['application/json']['data'];
+export type InteractionResponseRequest = paths['/v1/user/interactions/{interactionId}/responses']['post']['requestBody']['content']['application/json'];
+export type InteractionResponseResponse = paths['/v1/user/interactions/{interactionId}/responses']['post']['responses'][200]['content']['application/json']['data'];
+/** Single resolved interaction item (id, type, content, hasResponded, aggregates). */
+export type InteractionItem = InteractionsResponse[number];
+/**
+ * Batch-resolve interaction state for items from a synthesis output.
+ * Returns aggregates and whether the current user has already responded to each.
+ *
+ * @param config - Request configuration with base URL, timeout, fetch, and optional token
+ * @param options - synthesisConfigKeyName and interactions array (type + content)
+ * @returns Array of resolved interaction items (id, type, content, hasResponded, aggregates)
+ */
+export declare function getInteractions(config: RequestConfig, options: InteractionsRequest): Promise<NonNullable<InteractionsResponse>>;
+/**
+ * Submit or update a response to an interaction (e.g. a poll answer). Returns updated aggregates.
+ *
+ * @param config - Request configuration with base URL, timeout, fetch, and optional token
+ * @param interactionId - ID of the interaction to respond to
+ * @param options - type (e.g. 'POLL') and responseData (e.g. { response: 'optionId' })
+ * @returns Updated aggregates and the user's recorded response
+ */
+export declare function respondToInteraction(config: RequestConfig, interactionId: string, options: InteractionResponseRequest): Promise<NonNullable<InteractionResponseResponse>>;
+//# sourceMappingURL=interaction.d.ts.map

package/dist/user/interaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction.d.ts","sourceRoot":"","sources":["../../src/user/interaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnD,MAAM,MAAM,mBAAmB,GAC7B,KAAK,CAAC,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC,SAAS,CAAC,CAAC,kBAAkB,CAAC,CAAC;AACvF,MAAM,MAAM,oBAAoB,GAC9B,KAAK,CAAC,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElG,MAAM,MAAM,0BAA0B,GACpC,KAAK,CAAC,iDAAiD,CAAC,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC,SAAS,CAAC,CAAC,kBAAkB,CAAC,CAAC;AACjH,MAAM,MAAM,2BAA2B,GACrC,KAAK,CAAC,iDAAiD,CAAC,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5H,sFAAsF;AACtF,MAAM,MAAM,eAAe,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAE3D;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC,CAY5C;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,aAAa,EACrB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,WAAW,CAAC,2BAA2B,CAAC,CAAC,CAYnD"}

package/dist/user/interaction.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getInteractions = getInteractions;
+exports.respondToInteraction = respondToInteraction;
+const request_js_1 = require("../request.js");
+/**
+ * Batch-resolve interaction state for items from a synthesis output.
+ * Returns aggregates and whether the current user has already responded to each.
+ *
+ * @param config - Request configuration with base URL, timeout, fetch, and optional token
+ * @param options - synthesisConfigKeyName and interactions array (type + content)
+ * @returns Array of resolved interaction items (id, type, content, hasResponded, aggregates)
+ */
+async function getInteractions(config, options) {
+    const response = await (0, request_js_1.makeRequest)(config, {
+        method: 'POST',
+        path: '/v1/user/interactions',
+        body: options,
+    });
+    if (!response) {
+        throw new Error('Failed to get interactions: no data in response');
+    }
+    return response;
+}
+/**
+ * Submit or update a response to an interaction (e.g. a poll answer). Returns updated aggregates.
+ *
+ * @param config - Request configuration with base URL, timeout, fetch, and optional token
+ * @param interactionId - ID of the interaction to respond to
+ * @param options - type (e.g. 'POLL') and responseData (e.g. { response: 'optionId' })
+ * @returns Updated aggregates and the user's recorded response
+ */
+async function respondToInteraction(config, interactionId, options) {
+    const response = await (0, request_js_1.makeRequest)(config, {
+        method: 'POST',
+        path: `/v1/user/interactions/${interactionId}/responses`,
+        body: options,
+    });
+    if (!response) {
+        throw new Error('Failed to respond to interaction: no data in response');
+    }
+    return response;
+}
+//# sourceMappingURL=interaction.js.map

package/dist/user/interaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction.js","sourceRoot":"","sources":["../../src/user/interaction.ts"],"names":[],"mappings":";;AAyBA,0CAeC;AAUD,oDAgBC;AAhED,8CAA4C;AAe5C;;;;;;;GAOG;AACI,KAAK,UAAU,eAAe,CACnC,MAAqB,EACrB,OAA4B;IAE5B,MAAM,QAAQ,GAAG,MAAM,IAAA,wBAAW,EAAuB,MAAM,EAAE;QAC/D,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,uBAAuB;QAC7B,IAAI,EAAE,OAAO;KACd,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;GAOG;AACI,KAAK,UAAU,oBAAoB,CACxC,MAAqB,EACrB,aAAqB,EACrB,OAAmC;IAEnC,MAAM,QAAQ,GAAG,MAAM,IAAA,wBAAW,EAA8B,MAAM,EAAE;QACtE,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,yBAAyB,aAAa,YAAY;QACxD,IAAI,EAAE,OAAO;KACd,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC3E,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/user/synthesize.d.ts

@@ -30,7 +30,7 @@ export interface SynthesizeOptions {
  * Synthesize content items personalized to the user (streaming SSE).
  *
  * @param config - Request configuration with base URL, timeout, fetch, and optional token
- * @param items - Array of items: each has optional inputs (`type`: externalId | text | excludeExternalIds, `value`), output (schema as JSON string or Zod 4 schema), optional configurationKeyName, optional searchOptionsOverrides (e.g. lookbackMinutes)
+ * @param items - Array of items: each has optional inputs (`type`: externalId | text | excludeExternalIds, `value`), output (schema as JSON string or Zod 4 schema), optional configurationKeyName, optional limit (number of results to return; defaults to 1), optional searchOptionsOverrides (e.g. lookbackMinutes)
  * @param options - Optional: onStreamingData(index, data) called for each streaming data update per item index
  * @returns AsyncIterable yielding connection events (connected, complete) and data events (index, data?, complete, error?). Data may be partial until an event with complete: true for that index.
  */

package/dist/user/synthesize.js

@@ -27,7 +27,7 @@ function normalizeSynthesizeItems(items) {
  * Synthesize content items personalized to the user (streaming SSE).
  *
  * @param config - Request configuration with base URL, timeout, fetch, and optional token
- * @param items - Array of items: each has optional inputs (`type`: externalId | text | excludeExternalIds, `value`), output (schema as JSON string or Zod 4 schema), optional configurationKeyName, optional searchOptionsOverrides (e.g. lookbackMinutes)
+ * @param items - Array of items: each has optional inputs (`type`: externalId | text | excludeExternalIds, `value`), output (schema as JSON string or Zod 4 schema), optional configurationKeyName, optional limit (number of results to return; defaults to 1), optional searchOptionsOverrides (e.g. lookbackMinutes)
  * @param options - Optional: onStreamingData(index, data) called for each streaming data update per item index
  * @returns AsyncIterable yielding connection events (connected, complete) and data events (index, data?, complete, error?). Data may be partial until an event with complete: true for that index.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bitbitpress/client",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "BitBitPress TypeScript client library",
   "type": "module",
   "main": "./dist/index.js",