@bitbitpress/client 1.1.1 → 1.1.3

package/README.md

@@ -56,8 +56,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)
+  - [interactions (deprecated)](#interactions)
+  - [respondToInteraction (deprecated)](#respondtointeraction)
 - [Data Methods](#data-methods)
   - [assets](#assets)
 - [Types](#types)
@@ -450,6 +450,7 @@ client.user.submit(options: SubmitRequest): Promise<SubmitResponse>
 
 ```typescript
 const { synthesisOutputId } = await client.user.synthesizeItem(pollItem);
+if (!synthesisOutputId) throw new Error('Poll output is missing synthesisOutputId');
 await client.user.submit({ synthesisOutputId, data: { response: 'yes' } });
 ```
 
@@ -625,12 +626,12 @@ 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 `synthesisHistoryLimit` (how many recent stored outputs to expose in `synthesisHistory`; defaults to `0` — no history emitted), 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 `synthesisHistoryLimit` (how many recent stored outputs to expose in `synthesisHistoryEntries`; defaults to `0` — no history emitted), 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
 
-- `Promise<SynthesizeItemResponse>`: Resolves with the final data event for this item — `data` is the synthesized object (keys match your output schema) when present; `synthesisHistory` is an array of recent stored `data` payloads when `synthesisHistoryLimit > 0` (most-recent first; the first entry is the current synthesis itself); `error` is set on failure
+- `Promise<SynthesizeItemResponse>`: Resolves with the final data event for this item — `data` is the synthesized object (keys match your output schema) when present; `synthesisOutputId` identifies the current output for submissions; `synthesisHistoryEntries` is an array of recent stored `{ synthesisOutputId, data }` entries when `synthesisHistoryLimit > 0` (most-recent first; the first entry is the current synthesis itself); deprecated `synthesisHistory` may also be present as bare payloads; `error` is set on failure
 
 ##### Behavior
 
@@ -685,7 +686,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
-  - `synthesisHistoryLimit` (optional): How many recent stored synthesis outputs to expose in the final data event's `synthesisHistory` field. Defaults to `0` (no history emitted). When `> 0`, the final event includes a `synthesisHistory` array of up to N `data` payloads (most-recent first; first entry is the current synthesis itself).
+  - `synthesisHistoryLimit` (optional): How many recent stored synthesis outputs to expose in the final data event's `synthesisHistoryEntries` field. Defaults to `0` (no history emitted). When `> 0`, the final event includes a `synthesisHistoryEntries` array of up to N `{ synthesisOutputId, data }` entries (most-recent first; first entry is the current synthesis itself). A deprecated `synthesisHistory` array of bare payloads may also be present for retrocompatibility.
   - `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
 
@@ -697,7 +698,7 @@ client.user.synthesize(
 
 - `{ type: "connected" }`: Connection established
 - `{ type: "complete" }`: Stream complete
-- `{ index, data?, synthesisHistory?, complete, error? }`: Data event for that item. Multiple events may be sent per index as partial updates; the final event has `complete: true` and the validated object. When `complete` is false, `data` is streaming data (partial object). `synthesisHistory` (only on the final event, only when `synthesisHistoryLimit > 0`) is an array of recent stored `data` payloads, most-recent first. `error` is set on failure.
+- `{ index, data?, synthesisOutputId?, synthesisHistoryEntries?, synthesisHistory?, complete, error? }`: Data event for that item. Multiple events may be sent per index as partial updates; the final event has `complete: true` and the validated object. When `complete` is false, `data` is streaming data (partial object). `synthesisHistoryEntries` (only on the final event, only when `synthesisHistoryLimit > 0`) is an array of recent stored `{ synthesisOutputId, data }` entries, most-recent first. `synthesisHistory` is deprecated and contains the same entries as bare payloads. `error` is set on failure.
 
 ##### Example
 
@@ -753,6 +754,8 @@ for await (const event of stream) {
 
 #### interactions
 
+**Deprecated:** use `client.user.submissionState({ synthesisOutputId })`, keyed by the poll's synthesis output. This legacy method is kept for retrocompatibility.
+
 Batch-resolve interaction state for items from a synthesis output. Returns aggregates and whether the current user has already responded to each.
 
 ```typescript
@@ -803,6 +806,8 @@ for (const item of interactions) {
 
 #### respondToInteraction
 
+**Deprecated:** use `client.user.submit({ synthesisOutputId, data })`, keyed by the poll's synthesis output. This legacy method is kept for retrocompatibility.
+
 Submit or update a response to an interaction (e.g. a poll answer). Returns updated aggregates.
 
 ```typescript
@@ -849,7 +854,7 @@ Data methods require authentication. Call `client.user.authenticate()` before us
 
 #### assets
 
-Fetch assets by IDs and return requested fields.
+Fetch assets by internal IDs or external IDs, and return requested fields.
 
 ```typescript
 client.data.assets(options: AssetsRequest): Promise<AssetsResponse>
@@ -857,7 +862,8 @@ client.data.assets(options: AssetsRequest): Promise<AssetsResponse>
 
 ##### Parameters
 
-- `options.assetIds` (required): List of asset IDs to fetch
+- `options.assetIds` (required unless `externalIds` is provided): List of BitBitPress asset IDs to fetch
+- `options.externalIds` (required unless `assetIds` is provided): List of source-system external IDs to fetch
 - `options.assetFields` (required): Asset fields to return (dot or bracket notation, e.g. `tags[0]`, `images[1].src`). Allowed: `assetId`, `title`, `tags`, `images`, `videos`, `audios`, `publishedAt`, `externalId`, `externalData`, `assetType`, `sourceUrl`, `dataSource.name`, and subfields. Empty array returns objects with only `assetId`.
 
 ##### Returns
@@ -1072,7 +1078,7 @@ Request body for POST `/v1/user/synthesize` (from OpenAPI). Each item has `input
 type SynthesizeRequest = {
   items: Array<{
     configurationKeyName?: string;
-    synthesisHistoryLimit?: number; // how many recent stored outputs to include in synthesisHistory; defaults to 0 (no history emitted)
+    synthesisHistoryLimit?: number; // how many recent stored outputs to include in synthesisHistoryEntries; defaults to 0 (no history emitted)
     searchOptionsOverrides?: { lookbackMinutes?: number };
     inputs?: Array<{ type: 'externalId' | 'text' | 'excludeExternalIds'; value: string }>;
     output: {
@@ -1092,16 +1098,24 @@ Same shape as the request items above, but `output.schema` may be a **string or
 
 #### SynthesizeEvent
 
-Stream events (SSE). Connection events use `type`; data events use `index`, optional `data`, required `complete`, and optional `error`. Multiple data events may be sent per index as partial object updates; the final event for an index has `complete: true` and the validated object.
+Stream events (SSE). Connection events use `type`; data events use `index`, optional `data`, optional `synthesisOutputId`, optional history fields, required `complete`, and optional `error`. Multiple data events may be sent per index as partial object updates; the final event for an index has `complete: true` and the validated object.
 
 ```typescript
 type SynthesizeEvent =
   | { type: 'connected' }
   | { type: 'complete' }
-  | { index: number; data?: unknown; synthesisHistory?: unknown[]; complete: boolean; error?: string };
+  | {
+      index: number;
+      data?: unknown;
+      synthesisOutputId?: string;
+      synthesisHistoryEntries?: Array<{ synthesisOutputId: string; data: unknown }>;
+      synthesisHistory?: unknown[]; // deprecated bare-payload history
+      complete: boolean;
+      error?: string;
+    };
 ```
 
-When `complete` is true, `data` is the full synthesized object (keys match your output schema). When `complete` is false, `data` is streaming data (partial update). When the request set `synthesisHistoryLimit > 0`, the final event also includes `synthesisHistory`: an array of recent stored `data` payloads (most-recent first; first entry is the current synthesis itself — identical to `data` unless user reranking is configured server-side). `error` is set on failure.
+When `complete` is true, `data` is the full synthesized object (keys match your output schema). When `complete` is false, `data` is streaming data (partial update). `synthesisOutputId` identifies the current output and can be passed to `submit`, `submissionState`, or `submissionFeed`. When the request set `synthesisHistoryLimit > 0`, the final event also includes `synthesisHistoryEntries`: an array of recent stored `{ synthesisOutputId, data }` entries (most-recent first; first entry is the current synthesis itself). Deprecated `synthesisHistory` may also be present as index-aligned bare payloads. `error` is set on failure.
 
 #### SynthesizeItemResponse
 
@@ -1109,9 +1123,11 @@ Return type of `synthesizeItem`. Same shape as a data event payload (without `in
 
 ```typescript
 type SynthesizeItemResponse = {
-  data?: unknown;              // synthesized object when present
-  synthesisHistory?: unknown[]; // recent stored outputs when synthesisHistoryLimit > 0; most-recent first
-  error?: string;               // set on failure
+  data?: unknown; // synthesized object when present
+  synthesisOutputId?: string; // current output id for submissions
+  synthesisHistoryEntries?: Array<{ synthesisOutputId: string; data: unknown }>; // preferred history with output ids
+  synthesisHistory?: unknown[]; // deprecated bare-payload history
+  error?: string; // set on failure
 };
 ```
 
@@ -1121,9 +1137,13 @@ Request body for POST `/v1/data/assets`.
 
 ```typescript
 type AssetsRequest = {
-  assetIds: string[];
+  assetIds?: string[];
+  externalIds?: string[];
   assetFields: string[];
-}
+} & (
+  | { assetIds: string[]; externalIds?: string[] }
+  | { assetIds?: string[]; externalIds: string[] }
+);
 ```
 
 #### AssetsResponse
@@ -1156,7 +1176,7 @@ interface SynthesizeOptions {
 
 #### InteractionsRequest
 
-Request body for POST `/v1/user/interactions`.
+Deprecated request body for POST `/v1/user/interactions`. Prefer `submissionState({ synthesisOutputId })`.
 
 ```typescript
 type InteractionsRequest = {
@@ -1192,7 +1212,7 @@ type InteractionsResponse = InteractionItem[];
 
 #### InteractionResponseRequest
 
-Request body for POST `/v1/user/interactions/:interactionId/responses`.
+Deprecated request body for POST `/v1/user/interactions/:interactionId/responses`. Prefer `submit({ synthesisOutputId, data })`.
 
 ```typescript
 type InteractionResponseRequest = {

package/dist/data/assets.d.ts

@@ -1,13 +1,21 @@
 import type { paths } from '../generated/openapi.js';
 import type { RequestConfig } from '../request.js';
-export type AssetsRequest = paths['/v1/data/assets']['post']['requestBody']['content']['application/json'];
+type OpenApiAssetsRequest = paths['/v1/data/assets']['post']['requestBody']['content']['application/json'];
+export type AssetsRequest = OpenApiAssetsRequest & ({
+    assetIds: string[];
+    externalIds?: string[];
+} | {
+    assetIds?: string[];
+    externalIds: string[];
+});
 export type AssetsResponse = paths['/v1/data/assets']['post']['responses'][200]['content']['application/json']['data'];
 /**
- * Fetch assets by IDs and return requested fields.
+ * Fetch assets by internal and/or external IDs and return requested fields.
  *
  * @param config - Request configuration with base URL, timeout, fetch, and token
- * @param options - assetIds (required) and assetFields (required)
+ * @param options - assetFields and at least one of assetIds or externalIds
  * @returns Promise that resolves with assets array
  */
 export declare function assets(config: RequestConfig, options: AssetsRequest): Promise<AssetsResponse>;
+export {};
 //# sourceMappingURL=assets.d.ts.map

package/dist/data/assets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../src/data/assets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnD,MAAM,MAAM,aAAa,GACvB,KAAK,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC,SAAS,CAAC,CAAC,kBAAkB,CAAC,CAAC;AAEjF,MAAM,MAAM,cAAc,GACxB,KAAK,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5F;;;;;;GAMG;AACH,wBAAsB,MAAM,CAC1B,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,cAAc,CAAC,CAYzB"}
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../src/data/assets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnD,KAAK,oBAAoB,GACvB,KAAK,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC,SAAS,CAAC,CAAC,kBAAkB,CAAC,CAAC;AAEjF,MAAM,MAAM,aAAa,GAAG,oBAAoB,GAC9C,CAAC;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAAC;AAEpG,MAAM,MAAM,cAAc,GACxB,KAAK,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5F;;;;;;GAMG;AACH,wBAAsB,MAAM,CAC1B,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,cAAc,CAAC,CAYzB"}

package/dist/data/assets.js

@@ -3,10 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.assets = assets;
 const request_js_1 = require("../request.js");
 /**
- * Fetch assets by IDs and return requested fields.
+ * Fetch assets by internal and/or external IDs and return requested fields.
  *
  * @param config - Request configuration with base URL, timeout, fetch, and token
- * @param options - assetIds (required) and assetFields (required)
+ * @param options - assetFields and at least one of assetIds or externalIds
  * @returns Promise that resolves with assets array
  */
 async function assets(config, options) {

package/dist/data/assets.js.map

@@ -1 +1 @@
-{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../src/data/assets.ts"],"names":[],"mappings":";;AAiBA,wBAeC;AA9BD,8CAA4C;AAQ5C;;;;;;GAMG;AACI,KAAK,UAAU,MAAM,CAC1B,MAAqB,EACrB,OAAsB;IAEtB,MAAM,QAAQ,GAAG,MAAM,IAAA,wBAAW,EAAiB,MAAM,EAAE;QACzD,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,iBAAiB;QACvB,IAAI,EAAE,OAAO;KACd,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../src/data/assets.ts"],"names":[],"mappings":";;AAoBA,wBAeC;AAjCD,8CAA4C;AAW5C;;;;;;GAMG;AACI,KAAK,UAAU,MAAM,CAC1B,MAAqB,EACrB,OAAsB;IAEtB,MAAM,QAAQ,GAAG,MAAM,IAAA,wBAAW,EAAiB,MAAM,EAAE;QACzD,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,iBAAiB;QACvB,IAAI,EAAE,OAAO;KACd,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/data/index.d.ts

@@ -5,9 +5,9 @@ import { type AssetsRequest, type AssetsResponse } from './assets.js';
  */
 export interface DataMethods {
     /**
-     * Fetch assets by IDs and return requested fields.
+     * Fetch assets by internal and/or external IDs and return requested fields.
      *
-     * @param options - assetIds (required) and assetFields (required)
+     * @param options - assetFields and at least one of assetIds or externalIds
      * @returns Promise that resolves with assets array
      */
     assets(options: AssetsRequest): Promise<AssetsResponse>;

package/dist/generated/openapi.d.ts

@@ -799,7 +799,7 @@ export interface paths {
                         items: {
                             /** @description Optional configuration key name. Loads an existing synthesis config by this name; omit for default configuration. */
                             configurationKeyName?: string;
-                            /** @description How many recent stored synthesis outputs to expose in the streamed `synthesisHistory` field. Defaults to 0 (no history emitted). When > 0, the final data event includes a `synthesisHistory` array of up to N `data` payloads (most-recent first). The first entry is the current synthesis itself — the same payload `data` is derived from — and the remaining entries are older stored rows. */
+                            /** @description How many recent stored synthesis outputs to expose in the streamed `synthesisHistory` / `synthesisHistoryEntries` fields. Defaults to 0 (no history emitted). When > 0, the final data event includes a `synthesisHistoryEntries` array of up to N `{ synthesisOutputId, data }` (most-recent first; each row's payload paired with its output id, so submissions can attach to a specific historical output), and — DEPRECATED, for older app builds — an index-aligned `synthesisHistory` array of the same bare `data` payloads. The first entry is the current synthesis itself — the same payload `data` is derived from — and the remaining entries are older stored rows. */
                             synthesisHistoryLimit?: number;
                             /** @description Per-request overrides for search options. */
                             searchOptionsOverrides?: {
@@ -845,7 +845,7 @@ export interface paths {
                  *     ```
                  *     `data` is always a single synthesized object (keys match your output schema). `complete` is `false` for partial streaming updates and `true` for the final validated payload.
                  *
-                 *     When `synthesisHistoryLimit > 0`, the final event additionally includes `synthesisHistory`: an array of up to N `data` payloads (most-recent first). The first entry is the current synthesis itself — the raw payload `data` is derived from (identical to `data` when reranking isn't configured; the unreranked source when it is) — and the remaining entries are older stored rows. The primary `data` field stays a single object — when user reranking is configured, it is built by pooling items at the reranking field across the fetched rows and scoring against the user profile.
+                 *     When `synthesisHistoryLimit > 0`, the final event additionally includes `synthesisHistoryEntries`: an array of up to N entries (most-recent first), each `{ synthesisOutputId, data }`, so a client can attach submissions (e.g. poll votes) to a specific historical output. The first entry is the current synthesis itself — the raw payload `data` is derived from (identical to `data` when reranking isn't configured; the unreranked source when it is) — and the remaining entries are older stored rows. A DEPRECATED `synthesisHistory` field (index-aligned bare `data` payloads) is also included for older app builds. The primary `data` field stays a single object — when user reranking is configured, it is built by pooling items at the reranking field across the fetched rows and scoring against the user profile.
                  *
                  *     **Data Events (error):**
                  *     ```json
@@ -926,9 +926,9 @@ export interface paths {
          * Synthesis - Synthesize UI
          * @description **POST** `/v1/user/synthesize-ui`
          *
-         *     Resolve one or more generated UIs in a single request, each identified by its `keyName`. Streams results as Server-Sent Events so the client can load the (cacheable) code bundle immediately and render synthesis `data` as it arrives — the same streaming model as `/v1/user/synthesize`.
+         *     Resolve one or more generated UIs in a single request, each identified by its `keyName`. Works exactly like `/v1/user/synthesize` — same per-item synthesis inputs (`inputs`, `output.schema`, `searchOptionsOverrides`, `synthesisHistoryLimit`) and the same personalized, streamed `data` — except it additionally returns the UI code bundle to render that data. The synthesis runs against the config attached to each UI.
          *
-         *     The code bundle is immutable per published version and identical for every app user, so it is served from a CDN by versioned `bundleUrl` and cached once across renders and users. `data` is the per-request, per-user piece and may stream in partials before a final `complete: true` event. `theme` is deployment-level and emitted once in the `manifest`. (`bundleSource` is an inlined fallback used only while bundles are served inline, before CDN delivery.)
+         *     Streams as Server-Sent Events so the client can load the (cacheable) code bundle immediately and render synthesis `data` as it arrives. The code bundle is immutable per published version and identical for every app user, so it is served from a CDN by versioned `bundleUrl` and cached once across renders and users. `data` is the per-request, per-user piece and may stream in partials before a final `complete: true` event. `theme` is deployment-level and emitted once in the `manifest`. (`bundleSource` is an inlined fallback used only while bundles are served inline, before CDN delivery.)
          */
         post: {
             parameters: {
@@ -952,6 +952,28 @@ export interface paths {
                         items: {
                             /** @description Stable identifier of the UI to load. Configured in the CMS. */
                             keyName: string;
+                            /** @description How many recent stored synthesis outputs to expose in the streamed `synthesisHistory` / `synthesisHistoryEntries` fields. Defaults to 0. See `/v1/user/synthesize` for the full semantics. */
+                            synthesisHistoryLimit?: number;
+                            /** @description Per-request overrides for search options. */
+                            searchOptionsOverrides?: {
+                                /** @description Override for search lookback window in minutes (e.g. 1440 for last 24 hours). */
+                                lookbackMinutes?: number;
+                            };
+                            /** @description Inputs used as context for the synthesis: externalId (article ID), or text (freeform text). */
+                            inputs?: {
+                                /**
+                                 * @description Type of input: externalId (article) or text (freeform).
+                                 * @enum {string}
+                                 */
+                                type: "externalId" | "text" | "excludeExternalIds";
+                                /** @description External ID (e.g. article) for externalId, freeform text for text, or comma-separated list of external IDs to exclude */
+                                value: string;
+                            }[];
+                            /** @description Optional output definition. Omit to use the output schema declared on the UI's attached config (`output.outputSchema`). */
+                            output?: {
+                                /** @description Output schema as a JSON string. Top-level type must be "object". See `/v1/user/synthesize` for the format. */
+                                schema: string;
+                            };
                         }[];
                     };
                 };
@@ -1053,8 +1075,10 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Synthesis - Get User Interactions
-         * @description **POST** `/v1/user/interactions`
+         * Synthesis - Get User Interactions (DEPRECATED)
+         * @description **DEPRECATED** — use `GET /v1/user/submissions` (submission state), keyed by the poll's `synthesisOutputId`. Kept for older app builds.
+         *
+         *     **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.
          */
@@ -1165,8 +1189,10 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Synthesis - Create User Interaction Response
-         * @description **POST** `/v1/user/interactions/:interactionId/responses`
+         * Synthesis - Create User Interaction Response (DEPRECATED)
+         * @description **DEPRECATED** — use `POST /v1/user/submissions` (submit), keyed by the poll's `synthesisOutputId`. Kept for older app builds.
+         *
+         *     **POST** `/v1/user/interactions/:interactionId/responses`
          *
          *     Submit or update a response to an interaction. Returns updated aggregates.
          */
@@ -1501,13 +1527,14 @@ export interface paths {
         put?: never;
         /**
          * Data - Get Assets
-         * @description **POST** `/v1/data/assets` Fetches assets by IDs and returns requested fields.
+         * @description **POST** `/v1/data/assets` Fetches assets by internal or external IDs and returns requested fields.
          *
          *     #### Request body
          *
          *     | Field | Type | Required | Description |
          *     |-------|------|----------|-------------|
-         *     | `assetIds` | string[] | yes | List of asset IDs to fetch |
+         *     | `assetIds` | string[] | yes, unless `externalIds` is provided | List of internal asset IDs to fetch |
+         *     | `externalIds` | string[] | yes, unless `assetIds` is provided | List of external IDs to fetch |
          *     | `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: {
@@ -1524,10 +1551,12 @@ export interface paths {
                 content: {
                     "application/json": {
                         /** @description List of asset IDs to fetch */
-                        assetIds: string[];
+                        assetIds?: string[];
+                        /** @description List of external IDs to fetch */
+                        externalIds?: string[];
                         /** @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[];
-                    };
+                    } & (unknown | unknown);
                 };
             };
             responses: {

package/dist/index.d.ts

@@ -17,7 +17,7 @@ export type { RecommendationsRequest, RecommendationsResponse } from './user/rec
 export type { ReportRequest, ReportResponse } from './user/report.js';
 export type { Signal, SignalRequest, SignalResponse } from './user/signal.js';
 export type { CreateUserSubmissionRequest, CreateUserSubmissionResponse, ListUserSubmissionsRequest, ListUserSubmissionsResponse, PublicSubmission, SubmissionAggregate, SubmissionFeed, SubmissionFile, SubmissionState, SubmitRequest, SubmitResponse, } from './user/submissions.js';
-export type { SynthesizeEvent, SynthesizeItemResponse, SynthesizeOptions, } from './user/synthesize.js';
+export type { SynthesisHistoryEntry, SynthesizeEvent, SynthesizeItemResponse, SynthesizeOptions, } from './user/synthesize.js';
 export type { SynthesizeOnStreamingData } from './user/synthesize-batch-manager.js';
 export type { TokenRequest, TokenResponse } from './user/token.js';
 export type { BitBitPressSynthesizeRequest, RecommendationsRequestBody, SynthesizeInput, SynthesizeItem, SynthesizeItems, SynthesizeOutputSchema, SynthesizeRequest, } from './user/typeDefs.js';

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,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACtE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,mBAAmB,wBAAwB,CAAC;AAC5C,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EACnB,yBAAyB,EACzB,WAAW,EACX,QAAQ,GACT,MAAM,cAAc,CAAC;AAEtB,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,YAAY,EACV,eAAe,EACf,0BAA0B,EAC1B,2BAA2B,EAC3B,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,YAAY,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACjG,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACtE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC9E,YAAY,EACV,2BAA2B,EAC3B,4BAA4B,EAC5B,0BAA0B,EAC1B,2BAA2B,EAC3B,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,eAAe,EACf,aAAa,EACb,cAAc,GACf,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,eAAe,EACf,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AACpF,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"}
+{"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,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACtE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,mBAAmB,wBAAwB,CAAC;AAC5C,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EACnB,yBAAyB,EACzB,WAAW,EACX,QAAQ,GACT,MAAM,cAAc,CAAC;AAEtB,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,YAAY,EACV,eAAe,EACf,0BAA0B,EAC1B,2BAA2B,EAC3B,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,YAAY,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACjG,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACtE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC9E,YAAY,EACV,2BAA2B,EAC3B,4BAA4B,EAC5B,0BAA0B,EAC1B,2BAA2B,EAC3B,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,eAAe,EACf,aAAa,EACb,cAAc,GACf,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,qBAAqB,EACrB,eAAe,EACf,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AACpF,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"}

package/dist/react/index.d.ts

@@ -1,14 +1,19 @@
-import type { SynthesisUiPlatform, SynthesisUiStreamEvent, SynthesizeUiFetcher } from '../synthesisUi/types.js';
+import type { SynthesisUiPlatform, SynthesisUiRequestInputs, SynthesisUiStreamEvent, SynthesizeUiFetcher } from '../synthesisUi/types.js';
 export type { BitBitViewContext, GeneratedUiModule, GeneratedUiViewHandle, } from '../runtime/index.js';
 export { type BitBitContextValue, BitBitProvider } from '../synthesisUi/context.js';
-export type { SynthesisUiPlatform, SynthesisUiStreamEvent, SynthesizeUiFetcher };
-export interface BitBitSynthesisProps {
+export type { SynthesisUiPlatform, SynthesisUiRequestInputs, SynthesisUiStreamEvent, SynthesizeUiFetcher, };
+/** `SynthesisUiRequestInputs` (`inputs`, `output`, `searchOptionsOverrides`,
+ *  `synthesisHistoryLimit`) are forwarded to the synthesis request. Non-primitive
+ *  values (e.g. `inputs`) should be stable/memoized — a new identity re-subscribes
+ *  the stream (re-synthesizes). */
+export interface BitBitViewProps extends SynthesisUiRequestInputs {
     /** Client to fetch the UI through. Optional when a `<BitBitProvider client>`
      *  is in scope. */
     client?: SynthesizeUiFetcher;
     keyName: string;
-    /** Target platform. Defaults to `web`; the studio passes `mobile` to
-     *  preview the react-native-web bundle. */
+    /** Target platform. Defaults to `web`. The CMS studio passes `mobile` to
+     *  preview the mobile bundle in a browser; a real native app renders mobile
+     *  through the `react-native-expo` entry (a WebView), not this one. */
     platform?: SynthesisUiPlatform;
     /** Brand analytics / link tracking. */
     onTrack?: (event: string, payload?: unknown) => void;
@@ -20,13 +25,13 @@ export interface BitBitSynthesisProps {
 /**
  * Web view for a server-generated SynthesisUI. Streams the UI by `keyName`
  * through `client` (or the `<BitBitProvider client>` in scope): loads and
- * mounts the built bundle (which owns its React) on the `manifest`, then pushes
- * `data` into the mounted view as it streams in. Web mounts in a Shadow DOM;
- * the `mobile` preview (react-native-web) mounts in the light DOM so rn-web's
- * global stylesheet applies. Native delivery (React Native via Re.Pack) is a
- * separate entry.
+ * mounts the built bundle (which owns its own framework) on the `manifest`, then
+ * pushes `data` into the mounted view as it streams in. Both web and mobile
+ * bundles are plain DOM, so both mount here (web in a Shadow DOM; the studio's
+ * `mobile` preview in the light DOM). Native delivery renders the same mobile
+ * bundle in a WebView via the `react-native-expo` entry.
  */
-export declare function BitBitSynthesis({ client: clientProp, keyName, platform, onTrack, onEvent, onNavigate, }: BitBitSynthesisProps): import("react").DetailedReactHTMLElement<{
+export declare function BitBitView({ client: clientProp, keyName, platform, onTrack, onEvent, onNavigate, inputs, output, searchOptionsOverrides, synthesisHistoryLimit, }: BitBitViewProps): import("react").DetailedReactHTMLElement<{
     ref: import("react").RefObject<HTMLDivElement>;
     style: {
         height: string;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACpB,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,KAAK,kBAAkB,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AACpF,YAAY,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,CAAC;AAEjF,MAAM,WAAW,oBAAoB;IACnC;uBACmB;IACnB,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB;+CAC2C;IAC3C,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B,uCAAuC;IACvC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACrD,+DAA+D;IAC/D,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACpD,0CAA0C;IAC1C,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC;AAID;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,EAC9B,MAAM,EAAE,UAAU,EAClB,OAAO,EACP,QAAgB,EAChB,OAAO,EACP,OAAO,EACP,UAAU,GACX,EAAE,oBAAoB;;;;;mBAkEtB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,EACtB,mBAAmB,EACpB,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,KAAK,kBAAkB,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AACpF,YAAY,EACV,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,EACtB,mBAAmB,GACpB,CAAC;AAEF;;;mCAGmC;AACnC,MAAM,WAAW,eAAgB,SAAQ,wBAAwB;IAC/D;uBACmB;IACnB,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB;;2EAEuE;IACvE,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B,uCAAuC;IACvC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACrD,+DAA+D;IAC/D,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACpD,0CAA0C;IAC1C,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC;AAID;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,EACzB,MAAM,EAAE,UAAU,EAClB,OAAO,EACP,QAAgB,EAChB,OAAO,EACP,OAAO,EACP,UAAU,EACV,MAAM,EACN,MAAM,EACN,sBAAsB,EACtB,qBAAqB,GACtB,EAAE,eAAe;;;;;mBAwFjB"}

package/dist/react/index.js

@@ -6,13 +6,13 @@ const noop = () => { };
 /**
  * Web view for a server-generated SynthesisUI. Streams the UI by `keyName`
  * through `client` (or the `<BitBitProvider client>` in scope): loads and
- * mounts the built bundle (which owns its React) on the `manifest`, then pushes
- * `data` into the mounted view as it streams in. Web mounts in a Shadow DOM;
- * the `mobile` preview (react-native-web) mounts in the light DOM so rn-web's
- * global stylesheet applies. Native delivery (React Native via Re.Pack) is a
- * separate entry.
+ * mounts the built bundle (which owns its own framework) on the `manifest`, then
+ * pushes `data` into the mounted view as it streams in. Both web and mobile
+ * bundles are plain DOM, so both mount here (web in a Shadow DOM; the studio's
+ * `mobile` preview in the light DOM). Native delivery renders the same mobile
+ * bundle in a WebView via the `react-native-expo` entry.
  */
-export function BitBitSynthesis({ client: clientProp, keyName, platform = 'web', onTrack, onEvent, onNavigate, }) {
+export function BitBitView({ client: clientProp, keyName, platform = 'web', onTrack, onEvent, onNavigate, inputs, output, searchOptionsOverrides, synthesisHistoryLimit, }) {
     const contextClient = useBitBitContext()?.client;
     const client = clientProp ?? contextClient;
     const hostRef = useRef(null);
@@ -41,7 +41,14 @@ export function BitBitSynthesis({ client: clientProp, keyName, platform = 'web',
             navigate: onNavigate,
         });
         void (async () => {
-            const stream = await client.user.synthesizeUi({ keyName, platform });
+            const stream = await client.user.synthesizeUi({
+                keyName,
+                platform,
+                inputs,
+                output,
+                searchOptionsOverrides,
+                synthesisHistoryLimit,
+            });
             for await (const event of stream) {
                 if (cancelled)
                     break;
@@ -53,11 +60,20 @@ export function BitBitSynthesis({ client: clientProp, keyName, platform = 'web',
                 }
                 else if (event.type === 'data' && mod) {
                     // Mount on the first data event (bundle is ready); update thereafter.
+                    const props = {
+                        data: event.data,
+                        history: event.synthesisHistoryEntries,
+                        ctx: makeCtx(),
+                    };
                     if (handle) {
-                        handle.update({ data: event.data, ctx: makeCtx() });
+                        handle.update(props);
                     }
                     else {
-                        handle = mountGeneratedView(host, mod, { data: event.data, ctx: makeCtx() }, { isolateStyles: platform !== 'mobile' });
+                        // Web isolates styles in a Shadow DOM; the studio's mobile preview
+                        // mounts in the light DOM.
+                        handle = mountGeneratedView(host, mod, props, {
+                            isolateStyles: platform !== 'mobile',
+                        });
                         beacon('VIEW');
                     }
                 }
@@ -67,7 +83,18 @@ export function BitBitSynthesis({ client: clientProp, keyName, platform = 'web',
             cancelled = true;
             handle?.unmount();
         };
-    }, [client, keyName, platform, onTrack, onEvent, onNavigate]);
+    }, [
+        client,
+        keyName,
+        platform,
+        onTrack,
+        onEvent,
+        onNavigate,
+        inputs,
+        output,
+        searchOptionsOverrides,
+        synthesisHistoryLimit,
+    ]);
     return createElement('div', { ref: hostRef, style: { height: '100%' } });
 }
 //# sourceMappingURL=index.js.map

package/dist/react/index.js.map

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

package/dist/react-native-expo/BitBitView.d.ts

@@ -0,0 +1,32 @@
+import { WebView } from 'react-native-webview';
+import type { SynthesisUiPlatform, SynthesisUiRequestInputs, SynthesizeUiFetcher } from '../synthesisUi/types.js';
+/** `SynthesisUiRequestInputs` (`inputs`, `output`, `searchOptionsOverrides`,
+ *  `synthesisHistoryLimit`) are forwarded to the synthesis request. Non-primitive
+ *  values (e.g. `inputs`) should be stable/memoized — a new identity re-subscribes
+ *  the stream (re-synthesizes). */
+export interface BitBitViewProps extends SynthesisUiRequestInputs {
+    /** Client to fetch the UI through. Optional when a `<BitBitProvider client>`
+     *  is in scope. */
+    client?: SynthesizeUiFetcher;
+    keyName: string;
+    /** Target platform. Defaults to `mobile` (the DOM bundle hosted in the
+     *  WebView). */
+    platform?: SynthesisUiPlatform;
+    /** Brand analytics / link tracking. */
+    onTrack?: (event: string, payload?: unknown) => void;
+    /** Host slot callbacks (developer-supplied event handlers). */
+    onEvent?: (name: string, payload?: unknown) => void;
+    /** Navigate a link the view requested (the WebView never navigates itself). */
+    onNavigate?: (href: string) => void;
+    /** Style for the hosting WebView. Defaults to `{ flex: 1 }`. */
+    style?: Record<string, unknown>;
+}
+/**
+ * React Native view for a server-generated mobile SynthesisUI. The generated
+ * bundle is plain DOM (Preact + htm), so it runs in a `WebView`: this streams
+ * the UI by `keyName`, loads the bundle in the WebView, pushes `data` in as it
+ * streams, and relays the view's `track`/`onEvent`/`navigate` back out. Mirrors
+ * the web `<BitBitView>` API + auto-beaconing.
+ */
+export declare function BitBitView({ client: clientProp, keyName, platform, onTrack, onEvent, onNavigate, style, inputs, output, searchOptionsOverrides, synthesisHistoryLimit, }: BitBitViewProps): import("react").CElement<import("react-native-webview").WebViewProps, WebView> | null;
+//# sourceMappingURL=BitBitView.d.ts.map

package/dist/react-native-expo/BitBitView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BitBitView.d.ts","sourceRoot":"","sources":["../../src/react-native-expo/BitBitView.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAA4B,MAAM,sBAAsB,CAAC;AAEzE,OAAO,KAAK,EACV,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,EACpB,MAAM,yBAAyB,CAAC;AAGjC;;;mCAGmC;AACnC,MAAM,WAAW,eAAgB,SAAQ,wBAAwB;IAC/D;uBACmB;IACnB,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB;oBACgB;IAChB,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B,uCAAuC;IACvC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACrD,+DAA+D;IAC/D,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACpD,+EAA+E;IAC/E,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAUD;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,EACzB,MAAM,EAAE,UAAU,EAClB,OAAO,EACP,QAAmB,EACnB,OAAO,EACP,OAAO,EACP,UAAU,EACV,KAAK,EACL,MAAM,EACN,MAAM,EACN,sBAAsB,EACtB,qBAAqB,GACtB,EAAE,eAAe,yFAsIjB"}