@cascade-fyi/sati-sdk 0.12.0 → 0.13.0

package/CHANGELOG.md

@@ -5,6 +5,19 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.13.0] - 2026-03-05
+
+### Added
+
+- **`searchAllFeedback()`** - search feedback across all deployed schemas (FeedbackV1 + FeedbackPublicV1), merging results
+- **`listAllFeedbacks()`** - async generator for bulk feedback pagination across all schemas
+- **`feedbackCacheTtlMs` option** - configurable feedback cache TTL on `SATIClientOptions` (default 30s, 0 to disable)
+
+### Changed
+
+- Removed `@coral-xyz/anchor` from peer dependencies (not needed by SDK consumers)
+- Extracted shared feedback search logic into `_searchFeedbackForSchema()` internal helper
+
 ## [0.12.0] - 2026-02-21
 
 ### Added
@@ -228,6 +241,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Compressed attestation storage via Light Protocol
 - Basic querying via Photon RPC
 
+[0.13.0]: https://github.com/cascade-protocol/sati/compare/@cascade-fyi/sati-sdk@0.12.0...@cascade-fyi/sati-sdk@0.13.0
 [0.12.0]: https://github.com/cascade-protocol/sati/compare/@cascade-fyi/sati-sdk@0.11.0...@cascade-fyi/sati-sdk@0.12.0
 [0.11.0]: https://github.com/cascade-protocol/sati/compare/@cascade-fyi/sati-sdk@0.10.1...@cascade-fyi/sati-sdk@0.11.0
 [0.10.1]: https://github.com/cascade-protocol/sati/compare/@cascade-fyi/sati-sdk@0.10.0...@cascade-fyi/sati-sdk@0.10.1

package/dist/index.cjs

@@ -5530,7 +5530,7 @@ var Sati = class {
 	sendAndConfirm;
 	lightClient;
 	_deployedConfig;
-	_feedbackCache = new FeedbackCache();
+	_feedbackCache;
 	_onWarning;
 	txConfig;
 	/** Network configuration */
@@ -5548,6 +5548,7 @@ var Sati = class {
 		this.lightClient = createSATILightClient(options.photonRpcUrl ?? PHOTON_URLS[options.network]);
 		this._deployedConfig = loadDeployedConfig(options.network);
 		this._onWarning = options.onWarning;
+		this._feedbackCache = new FeedbackCache(options.feedbackCacheTtlMs);
 		this.txConfig = {
 			priorityFeeMicroLamports: options.transactionConfig?.priorityFeeMicroLamports ?? (options.network === "mainnet" ? 5e4 : 0),
 			computeUnitLimit: options.transactionConfig?.computeUnitLimit ?? 4e5,
@@ -6929,6 +6930,81 @@ var Sati = class {
 	async searchFeedback(options) {
 		const schema = this._deployedConfig?.schemas.feedbackPublic ?? this._deployedConfig?.schemas.feedback;
 		if (!schema) throw new Error(`No feedback schema deployed for network "${this.network}"`);
+		const feedbacks = await this._searchFeedbackForSchema(schema, options);
+		if (options?.includeTxHash) {
+			const photon = this.getLightClient().getRpc();
+			await Promise.all(feedbacks.map(async (fb) => {
+				try {
+					fb.txSignature = (await photon.getCompressionSignaturesForAddress(fb.compressedAddress, { limit: 1 })).items[0]?.signature;
+				} catch (error) {
+					this._warn({
+						code: "SIGNATURE_LOOKUP_FAILED",
+						message: "Failed to fetch tx signature",
+						context: fb.compressedAddress,
+						cause: error
+					});
+				}
+			}));
+		}
+		return feedbacks;
+	}
+	/**
+	* Search feedback across ALL deployed feedback schemas (FeedbackV1 + FeedbackPublicV1).
+	*
+	* Unlike `searchFeedback` which queries a single schema, this method merges
+	* results from both the dual-signature (blind) and counterparty-signed schemas.
+	*
+	* @example
+	* ```typescript
+	* const allFeedback = await sati.searchAllFeedback({
+	*   agentMint: address("Agent..."),
+	* });
+	* ```
+	*/
+	async searchAllFeedback(options) {
+		const schemas = [this._deployedConfig?.schemas.feedbackPublic, this._deployedConfig?.schemas.feedback].filter((s) => s != null);
+		if (schemas.length === 0) throw new Error(`No feedback schemas deployed for network "${this.network}"`);
+		const allFeedbacks = [];
+		for (const schema of schemas) try {
+			const feedbacks = await this._searchFeedbackForSchema(schema, options);
+			allFeedbacks.push(...feedbacks);
+		} catch {}
+		return allFeedbacks;
+	}
+	/**
+	* Auto-paginating iterator for bulk feedback ingestion.
+	*
+	* Yields pages of raw feedback attestations. Handles cursor-based
+	* pagination automatically. For indexers and scoring providers.
+	*
+	* @example
+	* ```typescript
+	* for await (const page of sati.listAllFeedbacks({ agentMint: address("Agent...") })) {
+	*   for (const item of page.items) {
+	*     console.log(item.data.counterparty, item.data.outcome);
+	*   }
+	* }
+	* ```
+	*/
+	async *listAllFeedbacks(filter) {
+		const schemas = [this._deployedConfig?.schemas.feedbackPublic, this._deployedConfig?.schemas.feedback].filter((s) => s != null);
+		if (schemas.length === 0) throw new Error(`No feedback schemas deployed for network "${this.network}"`);
+		for (const schema of schemas) {
+			let cursor;
+			do {
+				const page = await this.listFeedbacks({
+					...filter,
+					sasSchema: schema,
+					cursor,
+					limit: filter?.limit ?? 1e3
+				});
+				if (page.items.length > 0) yield page;
+				cursor = page.cursor ?? void 0;
+			} while (cursor);
+		}
+	}
+	/** @internal Search feedback for a specific schema (shared logic). */
+	async _searchFeedbackForSchema(schema, options) {
 		const filter = { sasSchema: schema };
 		if (options?.agentMint) filter.agentMint = options.agentMint;
 		if (options?.counterparty) filter.counterparty = options.counterparty;
@@ -6968,21 +7044,6 @@ var Sati = class {
 				createdAt
 			});
 		}
-		if (options?.includeTxHash) {
-			const photon = this.getLightClient().getRpc();
-			await Promise.all(feedbacks.map(async (fb) => {
-				try {
-					fb.txSignature = (await photon.getCompressionSignaturesForAddress(fb.compressedAddress, { limit: 1 })).items[0]?.signature;
-				} catch (error) {
-					this._warn({
-						code: "SIGNATURE_LOOKUP_FAILED",
-						message: "Failed to fetch tx signature",
-						context: fb.compressedAddress,
-						cause: error
-					});
-				}
-			}));
-		}
 		return feedbacks;
 	}
 	/**

package/dist/index.d.cts

@@ -3016,6 +3016,8 @@ interface SATIClientOptions {
   onWarning?: (warning: SatiWarning) => void;
   /** Transaction sending configuration */
   transactionConfig?: TransactionConfig;
+  /** Feedback cache TTL in milliseconds (default: 30000). Set to 0 to disable caching. */
+  feedbackCacheTtlMs?: number;
 }
 /**
  * SAS configuration with credential and schema addresses
@@ -4538,6 +4540,38 @@ declare class Sati {
    * ```
    */
   searchFeedback(options?: FeedbackSearchOptions): Promise<ParsedFeedback[]>;
+  /**
+   * Search feedback across ALL deployed feedback schemas (FeedbackV1 + FeedbackPublicV1).
+   *
+   * Unlike `searchFeedback` which queries a single schema, this method merges
+   * results from both the dual-signature (blind) and counterparty-signed schemas.
+   *
+   * @example
+   * ```typescript
+   * const allFeedback = await sati.searchAllFeedback({
+   *   agentMint: address("Agent..."),
+   * });
+   * ```
+   */
+  searchAllFeedback(options?: FeedbackSearchOptions): Promise<ParsedFeedback[]>;
+  /**
+   * Auto-paginating iterator for bulk feedback ingestion.
+   *
+   * Yields pages of raw feedback attestations. Handles cursor-based
+   * pagination automatically. For indexers and scoring providers.
+   *
+   * @example
+   * ```typescript
+   * for await (const page of sati.listAllFeedbacks({ agentMint: address("Agent...") })) {
+   *   for (const item of page.items) {
+   *     console.log(item.data.counterparty, item.data.outcome);
+   *   }
+   * }
+   * ```
+   */
+  listAllFeedbacks(filter?: Partial<Omit<AttestationFilter, "sasSchema">>): AsyncGenerator<PaginatedAttestations<ParsedFeedbackAttestation>>;
+  /** @internal Search feedback for a specific schema (shared logic). */
+  private _searchFeedbackForSchema;
   /**
    * Get reputation summary for an agent.
    *