@bitbitpress/client 0.1.12 → 0.1.13

package/README.md

@@ -447,7 +447,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 `staleAfter`), optional `configurationKeyName`, optional `sourceAssetFields`, optional `sourceBitFields`
+- `item` (required): A single synthesize item (same shape as items in `synthesize`): `inputs`, `output` (schema as JSON string or Zod 4 schema, optional `staleAfter`), optional `configurationKeyName`, optional `sourceAssetFields`, optional `sourceBitFields`, 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
@@ -506,10 +506,11 @@ client.user.synthesize(
 
 - `items` (required): Array of items. Each item has:
   - `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, staleAfter?: string }` — output schema as a JSON string or Zod 4 schema (top-level type must be `"object"`); optional staleness (e.g. `"1h"`, `"30m"`, `"1d"`)
+  - `output`: `{ schema: string | ZodType, staleAfter?: string }` — output schema as a JSON string or Zod 4 schema (top-level type must be `"object"`; supports object, string, number, boolean, array, and enum); optional staleness (e.g. `"1h"`, `"30m"`, `"1d"`)
   - `configurationKeyName` (optional): Key name for configuration
   - `sourceAssetFields` (optional): Asset fields to return for sources used for generation (dot or bracket notation). Allowed: `title`, `tags`, `images`, `videos`, `publishedAt`, `externalId`, `externalData`, and subfields. Returned as JSON string of an array of objects in `sourceAssets`.
   - `sourceBitFields` (optional): Bit fields to return for sources used for generation. Allowed: `text`. Returned as JSON string of an array of objects in `sourceBits`.
+  - `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
 
 ##### Returns
@@ -706,7 +707,7 @@ type SignalResponse = {
 
 #### SynthesizeRequest
 
-Request body for POST `/v1/user/synthesize` (from OpenAPI). Each item has `inputs`, `output`, optional `configurationKeyName`, optional `sourceAssetFields`, and optional `sourceBitFields`.
+Request body for POST `/v1/user/synthesize` (from OpenAPI). Each item has `inputs`, `output`, optional `configurationKeyName`, optional `sourceAssetFields`, optional `sourceBitFields`, and optional `searchOptionsOverrides`.
 
 ```typescript
 type SynthesizeRequest = {
@@ -714,9 +715,10 @@ type SynthesizeRequest = {
     configurationKeyName?: string;
     sourceAssetFields?: string[];
     sourceBitFields?: string[];
+    searchOptionsOverrides?: { lookbackMinutes?: number };
     inputs?: Array<{ type: 'externalId' | 'text' | 'excludeExternalIds'; value: string }>;
     output: {
-      schema: string; // JSON schema string; top-level type must be "object"
+      schema: string; // JSON schema string; top-level type must be "object"; supports object, string, number, boolean, array, enum
       staleAfter?: string;
     };
   }>;

package/dist/generated/openapi.d.ts

@@ -679,6 +679,11 @@ export interface paths {
                             sourceBitFields?: string[];
                             /** @description Optional configuration key name. Loads an existing synthesis config by this name; omit for default configuration. */
                             configurationKeyName?: string;
+                            /** @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?: {
                                 /**
@@ -691,7 +696,7 @@ export interface paths {
                             }[];
                             /** @description Output definition: schema and optional staleness. */
                             output: {
-                                /** @description Output schema as a JSON string. Top-level type must be "object". Example: {"type":"object","properties":{"title":{"type":"string","description":"title"}}} */
+                                /** @description Output schema as a JSON string. Top-level type must be "object". Supports object, string, number, boolean, array, and enum. Example: {"type":"object","properties":{"title":{"type":"string","description":"title"},"status":{"type":"string","enum":["draft","published"]}}} */
                                 schema: string;
                                 /** @description Time after which the result is considered stale and will be regenerated again. Examples: "1h", "30m", "1d", "3600" (seconds). */
                                 staleAfter?: string;

package/dist/user/index.d.ts

@@ -69,7 +69,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 staleAfter), optional configurationKeyName
+     * @param items - Array of items: optional inputs (type: externalId | text | excludeExternalIds, value), output (schema, optional staleAfter), optional configurationKeyName, 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?)
      */

package/dist/user/synthesize.d.ts

@@ -38,7 +38,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 staleAfter), optional configurationKeyName
+ * @param items - Array of items: each has optional inputs (`type`: externalId | text | excludeExternalIds, `value`), output (schema as JSON string or Zod 4 schema, optional staleAfter), optional configurationKeyName, 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 staleAfter), optional configurationKeyName
+ * @param items - Array of items: each has optional inputs (`type`: externalId | text | excludeExternalIds, `value`), output (schema as JSON string or Zod 4 schema, optional staleAfter), optional configurationKeyName, 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": "0.1.12",
+  "version": "0.1.13",
   "description": "BitBitPress TypeScript client library",
   "type": "module",
   "main": "./dist/index.js",