@bitbitpress/client 0.1.8 → 0.1.9

package/dist/user/synthesize.d.ts

@@ -1,25 +1,31 @@
 import type { RequestConfig } from '../request.js';
-import type { SynthesizeRequest } from './typeDefs.js';
+import type { SynthesizeItems } from './typeDefs.js';
+export type SynthesizeItemResponse = {
+    data?: unknown;
+    error?: string;
+};
 /**
- * Type for synthesize stream events
- * Derived from the synthesize function's return type
+ * Synthesize stream event types (SSE). Per OpenAPI spec:
+ * - Connection: `{ type: 'connected' | 'complete' }`
+ * - Data: `{ index: number, data?: unknown, error?: string }` (data matches your output schema when present; error set on failure)
  */
 export type SynthesizeEvent = {
-    type: 'DAILY_SUMMARY' | 'CUSTOM' | 'connected' | 'complete';
-    index?: number;
+    type: 'connected';
+} | {
+    type: 'complete';
+} | {
+    index: number;
     data?: unknown;
+    error?: string;
 };
 /**
- * Synthesize user content (streaming)
+ * 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 to synthesize (type: SynthesizeRequest['items'])
- * @returns AsyncIterable that yields synthesis events (DAILY_SUMMARY, CUSTOM, connected, complete)
- */
-export declare function synthesize(config: RequestConfig, items: SynthesizeRequest['items']): Promise<AsyncIterable<SynthesizeEvent>>;
-/**
- * Extract the event type from the synthesize function's return type
- * This provides a type-safe way to reference the event type
+ * @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
+ * @returns AsyncIterable yielding connection events (connected, complete) and data events (index, data?, error?)
  */
+export declare function synthesize(config: RequestConfig, items: SynthesizeItems): Promise<AsyncIterable<SynthesizeEvent>>;
+/** Event type inferred from synthesize stream (for type-safe usage). */
 export type SynthesizeEventFromReturn = Awaited<ReturnType<typeof synthesize>> extends AsyncIterable<infer T> ? T : never;
 //# sourceMappingURL=synthesize.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"synthesize.d.ts","sourceRoot":"","sources":["../../src/user/synthesize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,eAAe,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,CAAC;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC,GAChC,OAAO,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC,CAMzC;AAED;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GACnC,OAAO,CAAC,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC,SAAS,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC"}
+{"version":3,"file":"synthesize.d.ts","sourceRoot":"","sources":["../../src/user/synthesize.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,KAAK,EAAE,eAAe,EAAqB,MAAM,eAAe,CAAC;AAGxE,MAAM,MAAM,sBAAsB,GAAG;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAExE;;;;GAIG;AACH,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GACpB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AA0BtD;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC,CAOzC;AAED,wEAAwE;AACxE,MAAM,MAAM,yBAAyB,GACnC,OAAO,CAAC,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC,SAAS,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC"}

package/dist/user/synthesize.js

@@ -1,19 +1,41 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.synthesize = synthesize;
+const zod_1 = require("zod");
 const request_js_1 = require("../request.js");
+/** Detect Zod 4 schema (has _zod internals). */
+function isZodSchema(value) {
+    return typeof value === 'object' && value !== null && '_zod' in value;
+}
+/** Normalize items so output.schema is always a JSON schema string (Zod schemas are converted via toJSONSchema). */
+function normalizeSynthesizeItems(items) {
+    return items.map((item) => {
+        const schema = item.output.schema;
+        const schemaString = isZodSchema(schema)
+            ? JSON.stringify((0, zod_1.toJSONSchema)(schema))
+            : schema;
+        return {
+            ...item,
+            output: {
+                ...item.output,
+                schema: schemaString,
+            },
+        };
+    });
+}
 /**
- * Synthesize user content (streaming)
+ * 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 to synthesize (type: SynthesizeRequest['items'])
- * @returns AsyncIterable that yields synthesis events (DAILY_SUMMARY, CUSTOM, connected, complete)
+ * @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
+ * @returns AsyncIterable yielding connection events (connected, complete) and data events (index, data?, error?)
  */
 async function synthesize(config, items) {
+    const normalizedItems = normalizeSynthesizeItems(items);
     return (0, request_js_1.makeRequest)(config, {
         method: 'POST',
         path: '/v1/user/synthesize',
-        body: { items },
+        body: { items: normalizedItems },
     });
 }
 //# sourceMappingURL=synthesize.js.map

package/dist/user/synthesize.js.map

@@ -1 +1 @@
-{"version":3,"file":"synthesize.js","sourceRoot":"","sources":["../../src/user/synthesize.ts"],"names":[],"mappings":";;AAqBA,gCASC;AA7BD,8CAA4C;AAa5C;;;;;;GAMG;AACI,KAAK,UAAU,UAAU,CAC9B,MAAqB,EACrB,KAAiC;IAEjC,OAAO,IAAA,wBAAW,EAAC,MAAM,EAAE;QACzB,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,qBAAqB;QAC3B,IAAI,EAAE,EAAE,KAAK,EAAE;KAChB,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"synthesize.js","sourceRoot":"","sources":["../../src/user/synthesize.ts"],"names":[],"mappings":";;AAiDA,gCAUC;AA3DD,6BAAmC;AAEnC,8CAA4C;AAgB5C,gDAAgD;AAChD,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,CAAC;AACxE,CAAC;AAED,oHAAoH;AACpH,SAAS,wBAAwB,CAC/B,KAAsB;IAEtB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACxB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;QAClC,MAAM,YAAY,GAAG,WAAW,CAAC,MAAM,CAAC;YACtC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAA,kBAAY,EAAC,MAAM,CAAC,CAAC;YACtC,CAAC,CAAC,MAAM,CAAC;QACX,OAAO;YACL,GAAG,IAAI;YACP,MAAM,EAAE;gBACN,GAAG,IAAI,CAAC,MAAM;gBACd,MAAM,EAAE,YAAY;aACrB;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,UAAU,CAC9B,MAAqB,EACrB,KAAsB;IAEtB,MAAM,eAAe,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;IACxD,OAAO,IAAA,wBAAW,EAAC,MAAM,EAAE;QACzB,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,qBAAqB;QAC3B,IAAI,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE;KACjC,CAAC,CAAC;AACL,CAAC"}

package/dist/user/token.d.ts

@@ -3,11 +3,11 @@ import type { RequestConfig } from '../request.js';
 export type TokenRequest = paths['/v1/auth/token']['post']['requestBody']['content']['application/json'];
 export type TokenResponse = paths['/v1/auth/token']['post']['responses'][200]['content']['application/json']['data'];
 /**
- * Exchange SSO token for authentication token
+ * Exchange SSO token for a BitBitPress authentication token (required for other endpoints).
  *
  * @param config - Request configuration with base URL, timeout, and fetch
- * @param ssoToken - The SSO token to exchange for an authentication token
- * @returns Promise that resolves with token response containing idToken or accessToken
+ * @param ssoToken - The token from your authentication provider (OIDC)
+ * @returns Promise that resolves with token data (idToken, accessToken, refreshToken, expiresIn)
  */
 export declare function exchangeToken(config: RequestConfig, ssoToken: TokenRequest['ssoToken']): Promise<NonNullable<TokenResponse>>;
 //# sourceMappingURL=token.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../src/user/token.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAInD,MAAM,MAAM,YAAY,GACtB,KAAK,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC,SAAS,CAAC,CAAC,kBAAkB,CAAC,CAAC;AAChF,MAAM,MAAM,aAAa,GACvB,KAAK,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3F;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,YAAY,CAAC,UAAU,CAAC,GACjC,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAcrC"}
+{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../src/user/token.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAInD,MAAM,MAAM,YAAY,GACtB,KAAK,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC,SAAS,CAAC,CAAC,kBAAkB,CAAC,CAAC;AAChF,MAAM,MAAM,aAAa,GACvB,KAAK,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3F;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,YAAY,CAAC,UAAU,CAAC,GACjC,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAYrC"}

package/dist/user/token.js

@@ -3,11 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.exchangeToken = exchangeToken;
 const request_js_1 = require("../request.js");
 /**
- * Exchange SSO token for authentication token
+ * Exchange SSO token for a BitBitPress authentication token (required for other endpoints).
  *
  * @param config - Request configuration with base URL, timeout, and fetch
- * @param ssoToken - The SSO token to exchange for an authentication token
- * @returns Promise that resolves with token response containing idToken or accessToken
+ * @param ssoToken - The token from your authentication provider (OIDC)
+ * @returns Promise that resolves with token data (idToken, accessToken, refreshToken, expiresIn)
  */
 async function exchangeToken(config, ssoToken) {
     const response = await (0, request_js_1.makeRequest)(config, {

package/dist/user/token.js.map

@@ -1 +1 @@
-{"version":3,"file":"token.js","sourceRoot":"","sources":["../../src/user/token.ts"],"names":[],"mappings":";;AAiBA,sCAiBC;AAhCD,8CAA4C;AAQ5C;;;;;;GAMG;AACI,KAAK,UAAU,aAAa,CACjC,MAAqB,EACrB,QAAkC;IAElC,MAAM,QAAQ,GAAG,MAAM,IAAA,wBAAW,EAEhC,MAAM,EAAE;QACR,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,EAAE,QAAQ,EAAE;KACnB,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"token.js","sourceRoot":"","sources":["../../src/user/token.ts"],"names":[],"mappings":";;AAiBA,sCAeC;AA9BD,8CAA4C;AAQ5C;;;;;;GAMG;AACI,KAAK,UAAU,aAAa,CACjC,MAAqB,EACrB,QAAkC;IAElC,MAAM,QAAQ,GAAG,MAAM,IAAA,wBAAW,EAAgB,MAAM,EAAE;QACxD,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,EAAE,QAAQ,EAAE;KACnB,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/user/typeDefs.d.ts

@@ -1,3 +1,21 @@
+import type { ZodType } from 'zod';
 import type { paths } from '../generated/openapi.js';
+/** Request body for POST /v1/user/synthesize */
 export type SynthesizeRequest = paths['/v1/user/synthesize']['post']['requestBody']['content']['application/json'];
+/** Request body for POST /v1/user/synthesize (alias for SynthesizeRequest). */
+export type BitBitPressSynthesizeRequest = SynthesizeRequest;
+/** Array of synthesize items (API shape). */
+export type SynthesizeItems = SynthesizeItem[];
+/** Single synthesize item (API shape). */
+export type SynthesizeItem = Omit<SynthesizeRequest['items'][number], 'output'> & {
+    output: Omit<SynthesizeRequest['items'][number]['output'], 'schema'> & {
+        schema: SynthesizeOutputSchema;
+    };
+};
+/** Single input in an item's inputs array (externalId, text, or excludeExternalIds). */
+export type SynthesizeInput = NonNullable<SynthesizeItem['inputs']>[number];
+/** Output schema for a synthesize item: JSON schema as string, or a Zod 4 schema (converted to JSON schema string when sending). */
+export type SynthesizeOutputSchema = string | ZodType;
+/** Request body for POST /v1/user/recommendations (optional body) */
+export type RecommendationsRequestBody = NonNullable<paths['/v1/user/recommendations']['post']['requestBody']>['content']['application/json'];
 //# sourceMappingURL=typeDefs.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"typeDefs.d.ts","sourceRoot":"","sources":["../../src/user/typeDefs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAGrD,MAAM,MAAM,iBAAiB,GAC3B,KAAK,CAAC,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC,SAAS,CAAC,CAAC,kBAAkB,CAAC,CAAC"}
+{"version":3,"file":"typeDefs.d.ts","sourceRoot":"","sources":["../../src/user/typeDefs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AACnC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAErD,gDAAgD;AAChD,MAAM,MAAM,iBAAiB,GAC3B,KAAK,CAAC,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC,SAAS,CAAC,CAAC,kBAAkB,CAAC,CAAC;AAErF,+EAA+E;AAC/E,MAAM,MAAM,4BAA4B,GAAG,iBAAiB,CAAC;AAE7D,6CAA6C;AAC7C,MAAM,MAAM,eAAe,GAAG,cAAc,EAAE,CAAC;AAE/C,0CAA0C;AAC1C,MAAM,MAAM,cAAc,GAAG,IAAI,CAC/B,iBAAiB,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,EAClC,QAAQ,CACP,GAAG;IACJ,MAAM,EAAE,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,GAAG;QACrE,MAAM,EAAE,sBAAsB,CAAC;KAChC,CAAC;CACH,CAAC;AAEF,wFAAwF;AACxF,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5E,oIAAoI;AACpI,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,OAAO,CAAC;AAEtD,qEAAqE;AACrE,MAAM,MAAM,0BAA0B,GAAG,WAAW,CAClD,KAAK,CAAC,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CACzD,CAAC,SAAS,CAAC,CAAC,kBAAkB,CAAC,CAAC"}

package/package.json

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