@secondlayer/sdk 6.38.0 → 6.39.0

package/dist/subgraphs/index.d.ts

@@ -1153,8 +1153,19 @@ type IndexPrint = IndexEventBase & {
 /** Decoded chain event, discriminated by `event_type`. */
 type IndexEvent = IndexFtTransfer | IndexNftTransfer | IndexStxTransfer | IndexStxMint | IndexStxBurn | IndexStxLock | IndexFtMint | IndexFtBurn | IndexNftMint | IndexNftBurn | IndexPrint;
 type IndexEventType = IndexEvent["event_type"];
-type EventsEnvelope<T extends IndexEventType = IndexEventType> = {
-	events: IndexEventOf<T>[]
+/** Fields every read returns regardless of `fields` — the consume contract
+*  (`cursor`, `block_height`) plus the union discriminant. */
+type IndexAlwaysFields = "cursor" | "block_height" | "event_type";
+/** An event row narrowed to a `fields` selection (plus what always ships). */
+type IndexEventFields<
+	T extends IndexEventType,
+	F extends keyof IndexEventOf<T> & string
+> = Pick<IndexEventOf<T>, (F | IndexAlwaysFields) & keyof IndexEventOf<T>>;
+type EventsEnvelope<
+	T extends IndexEventType = IndexEventType,
+	TRow = IndexEventOf<T>
+> = {
+	events: TRow[]
 	next_cursor: string | null
 	tip: IndexTip
 	reorgs: IndexReorg[]
@@ -1187,6 +1198,21 @@ type EventsListParams<T extends IndexEventType = IndexEventType> = {
 	*  Avoids a `/v1/index/transactions` call per event; for `print` events it's
 	*  the only source of the submitting sender. */
 	txContext?: boolean
+	/**
+	* Return only these columns. The server projects the SELECT, so an
+	* unrequested field is physically absent — and the returned row type
+	* narrows to match, making a read of one a compile error rather than
+	* `undefined`.
+	*
+	* `cursor`, `block_height`, and `event_type` come back regardless: the
+	* first two are the consume contract, the third carries the discriminant.
+	* Don't list them.
+	*
+	* Cost note: this does NOT change your bill — Index meters per row read,
+	* not per field. What it buys is wire bytes, plus skipping the `blocks`
+	* join when `block_time` is omitted.
+	*/
+	fields?: readonly (keyof IndexEventOf<T> & string)[]
 };
 type EventsWalkParams<T extends IndexEventType = IndexEventType> = Omit<EventsListParams<T>, "limit"> & {
 	batchSize?: number
@@ -1887,6 +1913,15 @@ interface NftTransfersResource {
 /** `index.events` — callable shorthand for `.list()`; `eventType` is required. */
 interface IndexEventsResource {
 	<T extends IndexEventType>(params: EventsListParams<T>): Promise<EventsEnvelope<T>>;
+	/** Narrowing overload: `fields` shrinks the returned row type to exactly
+	*  the requested columns plus {@link IndexAlwaysFields}. `const F` means no
+	*  `as const` at the call site. */
+	list<
+		T extends IndexEventType,
+		const F extends keyof IndexEventOf<T> & string
+	>(params: EventsListParams<T> & {
+		fields: readonly F[]
+	}): Promise<EventsEnvelope<T, IndexEventFields<T, F>>>;
 	list<T extends IndexEventType>(params: EventsListParams<T>): Promise<EventsEnvelope<T>>;
 	walk<T extends IndexEventType>(params: EventsWalkParams<T>): AsyncIterable<IndexEventOf<T>>;
 	consume<

package/dist/subgraphs/index.js

@@ -1113,7 +1113,8 @@ class Index extends BaseClient {
       from_height: params.fromHeight,
       to_height: params.toHeight,
       trait: params.trait,
-      tx_context: params.txContext ? "true" : undefined
+      tx_context: params.txContext ? "true" : undefined,
+      fields: params.fields?.join(",")
     })}`);
   }
   walkEvents(params) {
@@ -2148,5 +2149,5 @@ export {
   Subgraphs
 };
 
-//# debugId=E16E22A43378758864756E2164756E21
+//# debugId=F62665719058CC2664756E2164756E21
 //# sourceMappingURL=index.js.map