@secondlayer/sdk 6.46.0 → 6.47.0

package/dist/index.d.ts

@@ -567,13 +567,18 @@ type StreamsReorg = {
 	*/
 	new_canonical_tip: string
 };
-type StreamsEventsEnvelope = {
-	events: StreamsEvent[]
+type StreamsEventsEnvelope<TEvent = StreamsEvent> = {
+	events: TEvent[]
 	next_cursor: string | null
 	tip: StreamsTip
 	reorgs: StreamsReorg[]
 };
 type StreamsEventsListEnvelope = Omit<StreamsEventsEnvelope, "next_cursor">;
+/** The StreamsEvent union narrowed to a `types` selection — what a
+*  const-generic `types: ["ft_transfer"]` buys at the type level. */
+type StreamsEventOfTypes<T extends readonly StreamsEventType[]> = Extract<StreamsEvent, {
+	event_type: T[number]
+}>;
 type StreamsReorgsListParams = {
 	since: string
 	limit?: number
@@ -817,9 +822,9 @@ type StreamsEventsConsumeParams<
 * `GET /v1/streams/events` envelope verbatim, with `next_cursor` renamed to
 * `cursor` (the checkpoint to persist and resume from).
 */
-type StreamsBatch = {
+type StreamsBatch<TEvent = StreamsEvent> = {
 	/** Canonical events of this page, in cursor order. */
-	events: StreamsEvent[]
+	events: TEvent[]
 	/** Checkpoint after this page — pass back as `consume({ cursor })` to resume. */
 	cursor: string | null
 	tip: StreamsTip
@@ -835,6 +840,9 @@ type StreamsConsumeParams = {
 	sender?: StreamsFilterValue
 	recipient?: StreamsFilterValue
 	assetIdentifier?: string
+	/** Labelled OR-groups — same semantics as `events.consume`; each returned
+	*  event echoes the labels it matched. */
+	filters?: StreamsFilterMap
 	/** Events per page (the `limit` query param). Default 100. */
 	batchSize?: number
 	/** Poll interval while caught up at the tip, in ms. Default 2000. */
@@ -871,6 +879,13 @@ type StreamsEventsReplayParams = {
 	maxPages?: number
 	maxEmptyPolls?: number
 	signal?: AbortSignal
+	/** Narrow the LIVE TAIL after the dump phase. The dump files themselves are
+	*  always all-type (block-partitioned parquet) — filter those in your own
+	*  tooling while processing each file. */
+	types?: readonly StreamsEventType[]
+	notTypes?: readonly StreamsEventType[]
+	/** Labelled OR-groups for the live tail, like `consume`. */
+	filters?: StreamsFilterMap
 };
 type FetchLike2 = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
 /** One bulk parquet file in the dumps manifest. `path` is the object key under
@@ -931,8 +946,17 @@ type StreamsClient = {
 	* rewound automatically — use `events.consume` with `onReorg` for managed
 	* rollback semantics.
 	*/
+	/** Narrowing overload: a literal `types` array narrows every batch's
+	*  event union to exactly those members. */
+	consume<const T extends readonly StreamsEventType[]>(params: StreamsConsumeParams & {
+		types: T
+	}): AsyncIterableIterator<StreamsBatch<StreamsEventOfTypes<T>>>
 	consume(params?: StreamsConsumeParams): AsyncIterableIterator<StreamsBatch>
 	events: {
+		/** Narrowing overload, matching `consume`. */
+		list<const T extends readonly StreamsEventType[]>(params: StreamsEventsListParams & {
+			types: T
+		}): Promise<StreamsEventsEnvelope<StreamsEventOfTypes<T>>>
 		list(params?: StreamsEventsListParams): Promise<StreamsEventsEnvelope>
 		byTxId(txId: string): Promise<StreamsEventsListEnvelope>
 		/**
@@ -966,6 +990,10 @@ type StreamsClient = {
 		* indefinitely by default and stops when its `AbortSignal`, `maxPages`, or
 		* `maxEmptyPolls` stops it.
 		*/
+		/** Narrowing overload, matching `consume`. */
+		stream<const T extends readonly StreamsEventType[]>(params: StreamsEventsStreamParams & {
+			types: T
+		}): AsyncIterable<StreamsEventOfTypes<T>>
 		stream(params?: StreamsEventsStreamParams): AsyncIterable<StreamsEvent>
 		/**
 		* Subscribe to the real-time SSE push surface. Calls `onEvent` for each new

package/dist/index.js

@@ -1949,6 +1949,7 @@ function createStreamsClient(options) {
         sender: params.sender,
         recipient: params.recipient,
         assetIdentifier: params.assetIdentifier,
+        filters: params.filters,
         signal: params.signal,
         fetchEvents
       });
@@ -1968,6 +1969,7 @@ function createStreamsClient(options) {
           sender: params.sender,
           recipient: params.recipient,
           assetIdentifier: params.assetIdentifier,
+          filters: params.filters,
           batchSize: params.batchSize ?? 100,
           emptyBackoffMs: params.emptyBackoffMs,
           maxPages: params.maxPages,
@@ -2001,6 +2003,9 @@ function createStreamsClient(options) {
           fromCursor: seam,
           mode: params.mode ?? "tail",
           batchSize: params.batchSize ?? 100,
+          types: params.types,
+          notTypes: params.notTypes,
+          filters: params.filters,
           fetchEvents,
           onBatch: params.onBatch,
           onReorg: params.onReorg,
@@ -2887,5 +2892,5 @@ export {
   ApiError
 };
 
-//# debugId=558D930AE661BCE364756E2164756E21
+//# debugId=8DFD8103C4A93D9164756E2164756E21
 //# sourceMappingURL=index.js.map