@blocks-network/sdk 0.1.61 → 0.1.63

package/dist/stream/types.d.ts

@@ -64,12 +64,51 @@ export interface StreamClientFromDescriptorOptions {
     gating?: boolean;
     /** Reorder buffer timeout in ms. Default: 750. Set to 0 to disable. */
     reorderTimeoutMs?: number;
+    /**
+     * Consumer's user ID. When set, used as the publisher-identity prefix in
+     * the StreamClient UUID so that consumer-side publishes carry an identity
+     * derived from the consumer rather than the provider's agentName. Required
+     * for correct self-echo filtering on bidirectional streams where the
+     * consumer and provider share the same agentName. Omitting it falls back
+     * to descriptor.agentName (legacy behavior — safe only for unidirectional
+     * streams).
+     */
+    consumerUserId?: string;
+}
+/**
+ * Normalized inbound message yielded by the inbound async iterator.
+ *
+ * Discriminated by `format`. `data` shape:
+ *  - `format: 'bytes'`  → `string[]` (chunks; `encoding` is `'utf8'` or `'base64'`)
+ *  - `format: 'events'` → `unknown[]` (one or more events from a single producer flush)
+ *  - `format: 'raw'`    → `Record<string, unknown>` (passthrough for unknown message types)
+ *
+ * Note: the array-vs-single shape is the SDK's own producer-side bundler
+ * (`stream-bundle.ts`) coalescing writes by size/latency — NOT PubNub transport
+ * batching. A single producer `write()` already yields a 1-element array on
+ * the wire. Application code should prefer `bytes()` / `events()` which
+ * flatten on the consumer's behalf; reach for `inbound` only when you
+ * need raw envelope metadata.
+ */
+export type InboundMessage = InboundBytesMessage | InboundEventsMessage | InboundRawMessage;
+export interface InboundBytesMessage {
+    format: 'bytes';
+    data: string[];
+    seq: number;
+    ts: number;
+    encoding: string;
+}
+export interface InboundEventsMessage {
+    format: 'events';
+    data: unknown[];
+    seq: number;
+    ts: number;
+    encoding: string;
 }
-/** Normalized inbound message yielded by the inbound async iterator. */
-export interface InboundMessage {
-    data: unknown;
+export interface InboundRawMessage {
+    format: 'raw';
+    data: Record<string, unknown>;
     seq: number;
     ts: number;
-    format: 'bytes' | 'events' | 'raw';
     encoding: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blocks-network/sdk",
-  "version": "0.1.61",
+  "version": "0.1.63",
   "type": "module",
   "description": "Blocks Network SDK",
   "exports": {