@0xinsider/mcp 2.1.0 → 2.4.0

package/dist/sdk/index.d.ts

@@ -12,15 +12,46 @@
  * const client = new OxinsiderApiClient({ apiKey: process.env.OXINSIDER_API_KEY });
  * const board = await client.listLeaderboard({ strategy: "swing_trader", limit: 100 });
  */
-export { API_CLIENT_OPERATIONS, DEFAULT_BASE_URL, DEFAULT_MAX_RETRIES, DEFAULT_TIMEOUT_MS, assertTrustedBaseUrl, composeSignals, GRADES, LEADERBOARD_STRATEGIES, OxinsiderApiClient, interpolatePath, isApiNotModifiedResponse, isListEnvelope, } from "./client.js";
-export type { ApiClientMethod, ApiClientOperation, ApiClientOptions, ApiClientResponse, ApiEnvelope, ApiListEnvelope, ApiNotModifiedResponse, ApiOperationId, ApiQueryValue, ApiRequestOptions, AuthMode, CategorySkillStatus, CategorySkillStatusCounts, Grade, ListParams, PickQualifyingExpert, SportsEdgeSignalsParams, SportsEdgeObservationBoardUnavailableScope, SportsEdgeObservationBoardUpcomingStatus, SportsEdgeObservationCohort, SportsEdgeObservationDirectionalStatus, SportsEdgeObservationOutcomeIndex, SportsEdgeObservationProviderSource, SportsEdgeObservationSport, SportsEdgeObservationTopGrade, SportsEdgeObservationsParams, SportsEdgeObservationsResponse, TennisTour, WhaleTradeHistoryParams, LeaderboardListParams, LeaderboardStrategy, TrendingWalletsParams, WhaleTradeListParams, } from "./client.js";
-export { API_ERROR_CODES, API_ERROR_REASONS, AccountLockedError, BadRequestError, CursorExpiredError, ForbiddenError, IdempotencyInProgressError, InternalServerError, InvalidApiKeyError, NotFoundError, OxinsiderApiError, PickNotReleasedError, RateLimitUnavailableError, RequestTimeoutError, RateLimitedError, ReadModelWarmingError, DatabaseUnavailableError, RequestAccountingUnavailableError, SandboxApiKeyError, ApiKeyInQueryError, SubscriptionRequiredError, TraderNotTrackedError, UnknownEndpointError, WebhookDeliveryInProgressError, errorFromResponse, extractApiErrorBody, } from "./errors.js";
+export { API_CLIENT_OPERATIONS, BATCH_TRADER_EXPANSIONS, DEFAULT_BASE_URL, IDEMPOTENT_WRITE_OPERATIONS, MCP_METHODS, READ_ONLY_POST_OPERATIONS, REDIRECT_OPERATIONS, UNSUPPORTED_OPERATIONS, retryEligibility, DEFAULT_MAX_RETRIES, DEFAULT_TIMEOUT_MS, SANDBOX_BASE_URL, assertTrustedBaseUrl, resolveApiUrl, composeSignals, GRADES, LEADERBOARD_STRATEGIES, OxinsiderApiClient, interpolatePath, isApiNotModifiedResponse, isListEnvelope, } from "./client.js";
+export type { ApiClientMethod, ApiClientOperation, ApiClientOptions, ApiClientResponse, ApiEnvelope, ApiListEnvelope, ApiNotModifiedResponse, ApiOperationId, ApiQueryValue, ApiRedirectOperation, ApiRequestOptions, ApiUnsupportedOperation, AuthMode, BatchGetTradersOptions, BatchTraderExpand, CategorySkillStatus, CategorySkillStatusCounts, ClientMeta, ConvenienceOptions, EnvelopeOperationId, ExploreMarketsParams, Game, GamesListParams, Grade, IdempotentWriteOperationId, InsiderRadarListParams, JsonRpcOperationId, LargePositionsListParams, ListOperationId, ListParams, McpJsonRpcRequest, McpJsonRpcResponse, McpMethod, McpOptions, McpResult, OperationEnvelope, OperationItem, OperationMeta, OperationOptionsArgs, OperationRequestOptions, OperationRequiresOptions, OptionalInputOperationId, RuntimeOperationId, OperationResult, PositionsListParams, ResponseKind, RetryEligibility, SseOperationId, TextOperationId, TraderExportDownload, TraderExportDownloadOptions, TraderExportDownloadTarget, SharpMoneyFlowsParams, PickQualifyingExpert, PreGameSidesParams, PreGameSideObservationsParams, PreGameSideObservationsResponse, SportsEdgeSignalsParams, SportsEdgeObservationBoardUnavailableScope, SportsEdgeObservationBoardUpcomingStatus, SportsEdgeObservationCohort, SportsEdgeObservationDirectionalStatus, SportsEdgeObservationOutcomeIndex, SportsEdgeObservationProviderSource, SportsEdgeObservationSport, SportsEdgeObservationTopGrade, SportsEdgeObservationsParams, SportsEdgeObservationsResponse, SuspiciousTradesListParams, TennisTour, LargeTradeHistoryParams, WhaleTradeHistoryParams, LeaderboardListParams, LeaderboardStrategy, TrendingWalletsParams, LargeTradeListParams, WhaleTradeListParams, } from "./client.js";
+export { API_ERROR_CODES, API_ERROR_REASONS, AccountLockedError, BadRequestError, CursorExpiredError, ForbiddenError, IdempotencyInProgressError, InternalServerError, InvalidApiKeyError, InvalidResponseError, NotFoundError, OxinsiderApiError, PickNotReleasedError, RateLimitUnavailableError, RequestTimeoutError, ServerTimeoutError, RateLimitedError, ReadModelWarmingError, DatabaseUnavailableError, RequestAccountingUnavailableError, SandboxApiKeyError, ApiKeyInQueryError, SubscriptionRequiredError, TraderNotTrackedError, UnknownEndpointError, UnknownQueryParameterError, WebhookDeliveryInProgressError, errorFromResponse, extractApiErrorBody, } from "./errors.js";
 export type { ApiErrorCode, ApiErrorMeta, ApiErrorReason, } from "./errors.js";
-export { collect, paginate, paginatePages, paginationResumePoint, } from "./pagination.js";
-export type { PaginateOptions, PaginationResumePoint } from "./pagination.js";
-export { DEFAULT_MAX_STREAM_RECONNECTS, StreamReconnectsExhaustedError, consumeStream, parseSseFrame, streamFeed, streamFeedResilient, } from "./stream.js";
-export type { FeedEnvelope, ResilientStreamOptions, ResyncMarker, StreamEvent, StreamFilters, StreamOptions, } from "./stream.js";
+export { CURSOR_HISTORY_LIMIT, PaginationError, collect, paginate, paginatePages, paginationResumePoint, } from "./pagination.js";
+export type { OperationPaginateOptions, PaginateOptions, PaginationErrorReason, PaginationProgress, PaginationResumePoint, PaginationStop, } from "./pagination.js";
+export { MAX_TIMER_DELAY_MS, RETRY_AFTER_CEILING_MS, parseRetryAfter, } from "./retry.js";
+export { DEFAULT_MAX_HANDLER_RETRIES, DEFAULT_MAX_STREAM_FRAME_BYTES, DEFAULT_MAX_STREAM_RECONNECTS, DEFAULT_MAX_STREAM_RETRY_AFTER_MS, StreamHandlerFailedError, StreamProtocolError, StreamReconnectsExhaustedError, StreamRetryDeferredError, consumeStream, consumeStreamCheckpointed, decodeStreamFrame, isEventStreamMediaType, parseSseFrame, streamFeed, streamFeedResilient, } from "./stream.js";
+export type { CheckpointedStreamHandlers, CheckpointedStreamOptions, FeedEnvelope, ParsedSseFrame, ResilientStreamOptions, ResyncMarker, StreamCheckpoint, StreamCheckpointReason, StreamEvent, StreamFilters, StreamHandlerFailure, StreamHandlerStage, StreamOptions, StreamProtocolErrorReason, } from "./stream.js";
 export { SIGNATURE_HEADER, SIGNATURE_TOLERANCE_SECONDS, TIMESTAMP_HEADER, WEBHOOK_EVENT_TYPES, computeSignature, parseWebhookEvent, verifySignature, } from "./webhooks.js";
-export type { InsiderRadarFlagRaisedData, InsiderRadarFlagRaisedEvent, LargePositionsUpdatedData, LargePositionsUpdatedEvent, SmartMoneyFlowDetectedData, SmartMoneyFlowDetectedEvent, VerifySignatureInput, WalletGradeChangedData, WalletGradeChangedEvent, WebhookEvent, WebhookEventEnvelope, WhaleTradesInsertedData, WhaleTradesInsertedEvent, WhaleTraderSyncedData, WhaleTraderSyncedEvent, } from "./webhooks.js";
-export type { AgentRegistration, ApiDiscovery, ApiError, BatchMarketIntelItem, BatchRateLimitMeta, BatchResponseMeta, BatchTraderItem, Candle, ContentSearchResult, CounterpartyAnalysis, CounterpartyExecution, CounterpartyMakerPage, CounterpartyMatchBreakdown, CounterpartyParticipant, CreateWebhookRequest, EventReplayEvent, EventReplayFreshness, EventReplayMeta, EventReplaySource, ExploreEntry, ExploreFacetValue, ExploreFacets, ExploreGroup, ExploreMarket, ExploreStandalone, ExportCompleteness, ExportCounts, ExportSourceRange, ExportVolumeReconciliation, LargeExportPolicy, LargePosition, LeaderboardEntry, MarketCandles, MarketIntel, MarketSearchResult, MarketSnapshot, MarketSnapshotFreshness, MarketSnapshotTopOfBook, MarketSnapshotTrust, McpJsonRpcError, OutcomeCandles, PickHolder, PickOfTheDay, PickOfTheDayArchive, PickOfTheDayArchiveDay, PickOfTheDayArchiveEntry, PickOfTheDayCommitmentPayload, PickOfTheDayHitRate, PickOfTheDayLedger, PickOfTheDayLedgerEntry, PickOfTheDayLedgerOpenedEntry, PickOfTheDayLedgerSealedEntry, PickOfTheDayLedgerUncommittedEntry, PickOfTheDayUncommittedPayload, PickSportsContext, PickSportsTeam, PickTrust, PlatformCapabilities, PlatformCapabilityStatus, Platforms, Position, PositionTimelineEvent, PotdEntryAuthorization, ProofPendingPickSlot, RadarFlag, ReportPayload, ReportReconciliation, ReportSnapshot, ReportSourceRange, ResponseMeta, ScheduledPickSlot, ScoreCell, ScoreFormat, SmartMoneyFlowMarket, SnapshotCompleteness, SnapshotState, SportsEdgeFunnelReport, SportsEdgeObservation, SportsEdgeObservationTerminalReason, SportsEdgeSignal, SportsEdgeSignalCategorySkill, SportsEdgeSportFunnelReport, Trader, TraderContext, TraderExportJob, TraderExportSnapshot, TraderPnl, TraderTrust, TrendingWallet, TrustCompleteness, TrustFreshness, TrustMetadata, TrustReconciliation, TrustSource, UpdateWebhookRequest, Usage, VerifyWebhookRequest, WebhookDelivery, WebhookEndpoint, WebhookEventDescriptor, WebhookRetryPolicy, WebhookStatus, WebhookVerification, WhaleTrade, WhaleTradeDetail, WhaleTradeHistoryMeta, OperationData, OperationQuery, } from "./schema.js";
+export type { InsiderRadarFlagRaisedData, InsiderRadarFlagRaisedEvent, LargePositionsUpdatedData, LargePositionsUpdatedEvent, LiveSportsScoreEntry, LiveSportsUpdatedData, LiveSportsUpdatedEvent, SmartMoneyFlowDetectedData, SmartMoneyFlowDetectedEvent, SuspiciousTradeFlaggedData, SuspiciousTradeFlaggedEvent, VerifySignatureInput, WalletGradeChangedData, WalletGradeChangedEvent, WebhookEvent, WebhookEventEnvelope, WhaleTradesInsertedData, WhaleTradesInsertedEvent, WhaleTraderSyncedData, WhaleTraderSyncedEvent, } from "./webhooks.js";
+export type { AgentRegistration, ApiDiscovery, ApiError, BatchMarketIntelItem, BatchRateLimitMeta, BatchResponseMeta, BatchTraderItem, Candle, ContentSearchResult, CounterpartyAnalysis, CounterpartyExecution, CounterpartyMakerPage, CounterpartyMatchBreakdown, CounterpartyParticipant, CreateWebhookRequest, EventReplayEvent, EventReplayFreshness, EventReplayMeta, EventReplaySource, ExploreEntry, ExploreFacetValue, ExploreFacets, ExploreGroup, ExploreMarket, ExploreStandalone, ExportCompleteness, ExportCounts, ExportSourceRange, ExportVolumeReconciliation, LargeExportPolicy, LargePosition, LeaderboardEntry, MarketCandles, MarketIntel, MarketSearchResult, MarketSnapshot, MarketSnapshotFreshness, MarketSnapshotTopOfBook, MarketSnapshotTrust, McpJsonRpcError, OutcomeCandles, PickHolder, PickOfTheDay, PickOfTheDayArchive, PickOfTheDayArchiveDay, PickOfTheDayArchiveEntry, PickOfTheDayCommitmentPayload, PickOfTheDayHitRate, PickOfTheDayLedger, PickOfTheDayLedgerEntry, PickOfTheDayLedgerOpenedEntry, PickOfTheDayLedgerSealedEntry, PickOfTheDayLedgerUncommittedEntry, PickOfTheDayUncommittedPayload, PickSportsContext, PickSportsTeam, PickTrust, PlatformCapabilities, PlatformCapabilityStatus, Platforms, Position, PositionTimelineEvent, PotdEntryAuthorization, ProofPendingPickSlot, ReportPayload, ReportReconciliation, ReportSnapshot, ReportSourceRange, ResponseMeta, ScheduledPickSlot, ScoreCell, ScoreFormat, SmartMoneyFlowMarket, SnapshotCompleteness, SnapshotState, PreGameSideFunnelReport, PreGameSideObservation, PreGameSideObservationTerminalReason, PreGameSide, PreGameSideCategorySkill, PreGameSideSportFunnelReport, SuspiciousTrade, Trader, TraderCategoryRecord, TraderCategoryRecords, TraderContext, TraderEsportsGameRecord, TraderExportJob, TraderExportSnapshot, TraderPnl, TraderTrust, TrendingWallet, TrustCompleteness, TrustFreshness, TrustMetadata, TrustReconciliation, TrustSource, UpdateWebhookRequest, Usage, VerifyWebhookRequest, WebhookDelivery, WebhookEndpoint, WebhookEventDescriptor, WebhookRetryPolicy, WebhookStatus, WebhookVerification, LargeTrade, LargeTradeDetail, LargeTradeHistoryMeta, OperationBody, OperationData, OperationPath, OperationQuery, OperationResponse, } from "./schema.js";
+/**
+ * @deprecated Use `SuspiciousTrade`. The OpenAPI component schema `RadarFlag`
+ * was renamed to `SuspiciousTrade` in #16301 and the generated types no longer
+ * spell it, so the name is kept here as an alias: an existing
+ * `import type { RadarFlag } from "@0xinsider/sdk"` keeps compiling and keeps
+ * describing the same payload. The deprecated
+ * `GET /api/v1/insider-radar/{id}` still returns it under
+ * `object: "radar_flag"`.
+ */
+export type RadarFlag = import("./schema.js").SuspiciousTrade;
+import type { LargeTrade, LargeTradeDetail, LargeTradeHistoryMeta } from "./schema.js";
+/** @deprecated Use {@link LargeTrade} (#16304). */
+export type WhaleTrade = LargeTrade;
+/** @deprecated Use {@link LargeTradeDetail} (#16304). */
+export type WhaleTradeDetail = LargeTradeDetail;
+/** @deprecated Use {@link LargeTradeHistoryMeta} (#16304). */
+export type WhaleTradeHistoryMeta = LargeTradeHistoryMeta;
+import type { PreGameSide, PreGameSideCategorySkill, PreGameSideFunnelReport, PreGameSideObservation, PreGameSideObservationTerminalReason, PreGameSideSportFunnelReport } from "./schema.js";
+/** @deprecated Use {@link PreGameSide} (#16310). */
+export type SportsEdgeSignal = PreGameSide;
+/** @deprecated Use {@link PreGameSideCategorySkill} (#16310). */
+export type SportsEdgeSignalCategorySkill = PreGameSideCategorySkill;
+/** @deprecated Use {@link PreGameSideObservation} (#16310). */
+export type SportsEdgeObservation = PreGameSideObservation;
+/** @deprecated Use {@link PreGameSideObservationTerminalReason} (#16310). */
+export type SportsEdgeObservationTerminalReason = PreGameSideObservationTerminalReason;
+/** @deprecated Use {@link PreGameSideFunnelReport} (#16310). */
+export type SportsEdgeFunnelReport = PreGameSideFunnelReport;
+/** @deprecated Use {@link PreGameSideSportFunnelReport} (#16310). */
+export type SportsEdgeSportFunnelReport = PreGameSideSportFunnelReport;
 //# sourceMappingURL=index.d.ts.map

package/dist/sdk/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../sdk/src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../sdk/src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,gBAAgB,EAChB,2BAA2B,EAC3B,WAAW,EACX,yBAAyB,EACzB,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,EACb,cAAc,EACd,MAAM,EACN,sBAAsB,EACtB,kBAAkB,EAClB,eAAe,EACf,wBAAwB,EACxB,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,sBAAsB,EACtB,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EACjB,uBAAuB,EACvB,QAAQ,EACR,sBAAsB,EACtB,iBAAiB,EACjB,mBAAmB,EACnB,yBAAyB,EACzB,UAAU,EACV,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,IAAI,EACJ,eAAe,EACf,KAAK,EACL,0BAA0B,EAC1B,sBAAsB,EACtB,kBAAkB,EAClB,wBAAwB,EACxB,eAAe,EACf,UAAU,EACV,iBAAiB,EACjB,kBAAkB,EAClB,SAAS,EACT,UAAU,EACV,SAAS,EACT,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,oBAAoB,EACpB,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,2BAA2B,EAC3B,0BAA0B,EAC1B,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,6BAA6B,EAC7B,+BAA+B,EAC/B,uBAAuB,EACvB,0CAA0C,EAC1C,wCAAwC,EACxC,2BAA2B,EAC3B,sCAAsC,EACtC,iCAAiC,EACjC,mCAAmC,EACnC,0BAA0B,EAC1B,6BAA6B,EAC7B,4BAA4B,EAC5B,8BAA8B,EAC9B,0BAA0B,EAC1B,UAAU,EACV,uBAAuB,EACvB,uBAAuB,EACvB,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,0BAA0B,EAC1B,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,EACb,iBAAiB,EACjB,oBAAoB,EACpB,yBAAyB,EACzB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,wBAAwB,EACxB,iCAAiC,EACjC,kBAAkB,EAClB,kBAAkB,EAClB,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,EACpB,0BAA0B,EAC1B,8BAA8B,EAC9B,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,cAAc,GACf,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,OAAO,EACP,QAAQ,EACR,aAAa,EACb,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,wBAAwB,EACxB,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,EACrB,cAAc,GACf,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,eAAe,GAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,2BAA2B,EAC3B,8BAA8B,EAC9B,6BAA6B,EAC7B,iCAAiC,EACjC,wBAAwB,EACxB,mBAAmB,EACnB,8BAA8B,EAC9B,wBAAwB,EACxB,aAAa,EACb,yBAAyB,EACzB,iBAAiB,EACjB,sBAAsB,EACtB,aAAa,EACb,UAAU,EACV,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,0BAA0B,EAC1B,yBAAyB,EACzB,YAAY,EACZ,cAAc,EACd,sBAAsB,EACtB,YAAY,EACZ,gBAAgB,EAChB,sBAAsB,EACtB,WAAW,EACX,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,EACb,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,gBAAgB,EAChB,2BAA2B,EAC3B,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,GAChB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,0BAA0B,EAC1B,2BAA2B,EAC3B,yBAAyB,EACzB,0BAA0B,EAC1B,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,2BAA2B,EAC3B,0BAA0B,EAC1B,2BAA2B,EAC3B,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,EACvB,YAAY,EACZ,oBAAoB,EACpB,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAQvB,YAAY,EACV,iBAAiB,EACjB,YAAY,EACZ,QAAQ,EACR,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,MAAM,EACN,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,0BAA0B,EAC1B,uBAAuB,EACvB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,EACjB,0BAA0B,EAC1B,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,kBAAkB,EAClB,cAAc,EACd,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,UAAU,EACV,YAAY,EACZ,mBAAmB,EACnB,sBAAsB,EACtB,wBAAwB,EACxB,6BAA6B,EAC7B,mBAAmB,EACnB,kBAAkB,EAClB,uBAAuB,EACvB,6BAA6B,EAC7B,6BAA6B,EAC7B,kCAAkC,EAClC,8BAA8B,EAC9B,iBAAiB,EACjB,cAAc,EACd,SAAS,EACT,oBAAoB,EACpB,wBAAwB,EACxB,SAAS,EACT,QAAQ,EACR,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,aAAa,EACb,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,SAAS,EACT,WAAW,EACX,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,uBAAuB,EACvB,sBAAsB,EACtB,oCAAoC,EACpC,WAAW,EACX,wBAAwB,EACxB,4BAA4B,EAC5B,eAAe,EACf,MAAM,EACN,oBAAoB,EACpB,qBAAqB,EACrB,aAAa,EACb,uBAAuB,EACvB,eAAe,EACf,oBAAoB,EACpB,SAAS,EACT,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,WAAW,EACX,oBAAoB,EACpB,KAAK,EACL,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,sBAAsB,EACtB,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,UAAU,EACV,gBAAgB,EAChB,qBAAqB,EACrB,aAAa,EACb,aAAa,EACb,aAAa,EACb,cAAc,EACd,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAErB;;;;;;;;GAQG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,aAAa,EAAE,eAAe,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACvF,mDAAmD;AACnD,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC;AACpC,yDAAyD;AACzD,MAAM,MAAM,gBAAgB,GAAG,gBAAgB,CAAC;AAChD,8DAA8D;AAC9D,MAAM,MAAM,qBAAqB,GAAG,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EACV,WAAW,EACX,wBAAwB,EACxB,uBAAuB,EACvB,sBAAsB,EACtB,oCAAoC,EACpC,4BAA4B,EAC7B,MAAM,aAAa,CAAC;AACrB,oDAAoD;AACpD,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAC;AAC3C,iEAAiE;AACjE,MAAM,MAAM,6BAA6B,GAAG,wBAAwB,CAAC;AACrE,+DAA+D;AAC/D,MAAM,MAAM,qBAAqB,GAAG,sBAAsB,CAAC;AAC3D,6EAA6E;AAC7E,MAAM,MAAM,mCAAmC,GAAG,oCAAoC,CAAC;AACvF,gEAAgE;AAChE,MAAM,MAAM,sBAAsB,GAAG,uBAAuB,CAAC;AAC7D,qEAAqE;AACrE,MAAM,MAAM,2BAA2B,GAAG,4BAA4B,CAAC"}

package/dist/sdk/index.js

@@ -13,13 +13,15 @@
  * const board = await client.listLeaderboard({ strategy: "swing_trader", limit: 100 });
  */
 // Client + core request/response types
-export { API_CLIENT_OPERATIONS, DEFAULT_BASE_URL, DEFAULT_MAX_RETRIES, DEFAULT_TIMEOUT_MS, assertTrustedBaseUrl, composeSignals, GRADES, LEADERBOARD_STRATEGIES, OxinsiderApiClient, interpolatePath, isApiNotModifiedResponse, isListEnvelope, } from "./client.js";
+export { API_CLIENT_OPERATIONS, BATCH_TRADER_EXPANSIONS, DEFAULT_BASE_URL, IDEMPOTENT_WRITE_OPERATIONS, MCP_METHODS, READ_ONLY_POST_OPERATIONS, REDIRECT_OPERATIONS, UNSUPPORTED_OPERATIONS, retryEligibility, DEFAULT_MAX_RETRIES, DEFAULT_TIMEOUT_MS, SANDBOX_BASE_URL, assertTrustedBaseUrl, resolveApiUrl, composeSignals, GRADES, LEADERBOARD_STRATEGIES, OxinsiderApiClient, interpolatePath, isApiNotModifiedResponse, isListEnvelope, } from "./client.js";
 // Error hierarchy
-export { API_ERROR_CODES, API_ERROR_REASONS, AccountLockedError, BadRequestError, CursorExpiredError, ForbiddenError, IdempotencyInProgressError, InternalServerError, InvalidApiKeyError, NotFoundError, OxinsiderApiError, PickNotReleasedError, RateLimitUnavailableError, RequestTimeoutError, RateLimitedError, ReadModelWarmingError, DatabaseUnavailableError, RequestAccountingUnavailableError, SandboxApiKeyError, ApiKeyInQueryError, SubscriptionRequiredError, TraderNotTrackedError, UnknownEndpointError, WebhookDeliveryInProgressError, errorFromResponse, extractApiErrorBody, } from "./errors.js";
+export { API_ERROR_CODES, API_ERROR_REASONS, AccountLockedError, BadRequestError, CursorExpiredError, ForbiddenError, IdempotencyInProgressError, InternalServerError, InvalidApiKeyError, InvalidResponseError, NotFoundError, OxinsiderApiError, PickNotReleasedError, RateLimitUnavailableError, RequestTimeoutError, ServerTimeoutError, RateLimitedError, ReadModelWarmingError, DatabaseUnavailableError, RequestAccountingUnavailableError, SandboxApiKeyError, ApiKeyInQueryError, SubscriptionRequiredError, TraderNotTrackedError, UnknownEndpointError, UnknownQueryParameterError, WebhookDeliveryInProgressError, errorFromResponse, extractApiErrorBody, } from "./errors.js";
 // Pagination
-export { collect, paginate, paginatePages, paginationResumePoint, } from "./pagination.js";
+export { CURSOR_HISTORY_LIMIT, PaginationError, collect, paginate, paginatePages, paginationResumePoint, } from "./pagination.js";
+// Retry-After parsing and bounded waits, shared by REST and SSE (#16249)
+export { MAX_TIMER_DELAY_MS, RETRY_AFTER_CEILING_MS, parseRetryAfter, } from "./retry.js";
 // SSE stream
-export { DEFAULT_MAX_STREAM_RECONNECTS, StreamReconnectsExhaustedError, consumeStream, parseSseFrame, streamFeed, streamFeedResilient, } from "./stream.js";
+export { DEFAULT_MAX_HANDLER_RETRIES, DEFAULT_MAX_STREAM_FRAME_BYTES, DEFAULT_MAX_STREAM_RECONNECTS, DEFAULT_MAX_STREAM_RETRY_AFTER_MS, StreamHandlerFailedError, StreamProtocolError, StreamReconnectsExhaustedError, StreamRetryDeferredError, consumeStream, consumeStreamCheckpointed, decodeStreamFrame, isEventStreamMediaType, parseSseFrame, streamFeed, streamFeedResilient, } from "./stream.js";
 // Webhooks
 export { SIGNATURE_HEADER, SIGNATURE_TOLERANCE_SECONDS, TIMESTAMP_HEADER, WEBHOOK_EVENT_TYPES, computeSignature, parseWebhookEvent, verifySignature, } from "./webhooks.js";
 //# sourceMappingURL=index.js.map

package/dist/sdk/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../sdk/src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,uCAAuC;AACvC,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,MAAM,EACN,sBAAsB,EACtB,kBAAkB,EAClB,eAAe,EACf,wBAAwB,EACxB,cAAc,GACf,MAAM,aAAa,CAAC;AAqCrB,kBAAkB;AAClB,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,0BAA0B,EAC1B,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,oBAAoB,EACpB,yBAAyB,EACzB,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,EACrB,wBAAwB,EACxB,iCAAiC,EACjC,kBAAkB,EAClB,kBAAkB,EAClB,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,EACpB,8BAA8B,EAC9B,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAOrB,aAAa;AACb,OAAO,EACL,OAAO,EACP,QAAQ,EACR,aAAa,EACb,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAGzB,aAAa;AACb,OAAO,EACL,6BAA6B,EAC7B,8BAA8B,EAC9B,aAAa,EACb,aAAa,EACb,UAAU,EACV,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAUrB,WAAW;AACX,OAAO,EACL,gBAAgB,EAChB,2BAA2B,EAC3B,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,GAChB,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../sdk/src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,uCAAuC;AACvC,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,gBAAgB,EAChB,2BAA2B,EAC3B,WAAW,EACX,yBAAyB,EACzB,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,EACb,cAAc,EACd,MAAM,EACN,sBAAsB,EACtB,kBAAkB,EAClB,eAAe,EACf,wBAAwB,EACxB,cAAc,GACf,MAAM,aAAa,CAAC;AAiFrB,kBAAkB;AAClB,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,0BAA0B,EAC1B,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,EACb,iBAAiB,EACjB,oBAAoB,EACpB,yBAAyB,EACzB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,wBAAwB,EACxB,iCAAiC,EACjC,kBAAkB,EAClB,kBAAkB,EAClB,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,EACpB,0BAA0B,EAC1B,8BAA8B,EAC9B,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAOrB,aAAa;AACb,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,OAAO,EACP,QAAQ,EACR,aAAa,EACb,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAUzB,yEAAyE;AACzE,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,aAAa;AACb,OAAO,EACL,2BAA2B,EAC3B,8BAA8B,EAC9B,6BAA6B,EAC7B,iCAAiC,EACjC,wBAAwB,EACxB,mBAAmB,EACnB,8BAA8B,EAC9B,wBAAwB,EACxB,aAAa,EACb,yBAAyB,EACzB,iBAAiB,EACjB,sBAAsB,EACtB,aAAa,EACb,UAAU,EACV,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAkBrB,WAAW;AACX,OAAO,EACL,gBAAgB,EAChB,2BAA2B,EAC3B,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,GAChB,MAAM,eAAe,CAAC"}

package/dist/sdk/pagination.d.ts

@@ -1,26 +1,108 @@
 /**
  * Cursor pagination over the Stripe-style V1 list envelope.
  *
- * Every list endpoint returns `{ object: "list", data, has_more, next_cursor }`.
- * `paginate()` yields each `data[]` item across pages, following `next_cursor`
- * while `has_more` is true. `paginatePages()` yields whole pages when you need
- * the envelope (e.g. to read `meta.cost` or `total`).
+ * Every list endpoint returns `{ object: "list", data, has_more, next_cursor }`
+ * (`backend/src/api_v1/types.rs` `ApiList`: `has_more` is always a boolean,
+ * `next_cursor` is a string or omitted). `paginate()` yields each `data[]`
+ * item across pages, following `next_cursor` while `has_more` is true.
+ * `paginatePages()` yields whole pages when you need the envelope (e.g. to
+ * read `meta.cost` or `total`).
  *
- * The loop stops on the first page where `has_more` is false OR `next_cursor`
- * is null/absent, so a buggy server that returns `has_more: true` with no
- * cursor cannot spin forever.
+ * The walker is a progress-checked consumer of that protocol (#16246):
+ *
+ * - A page is validated BEFORE it is yielded. `has_more: true` with no usable
+ *   `next_cursor` is a `PaginationError` (`missing_cursor`); the backend's own
+ *   cursor builders refuse to produce that page ("has_more is true for an
+ *   empty page", `insider_radar.rs`), so a client seeing it is looking at a
+ *   malformed response, not the end of the collection. Before #16246 the
+ *   walk returned as if the collection were exhausted.
+ * - A `next_cursor` that repeats a cursor this walk already requested is a
+ *   `PaginationError` (`repeated_cursor`), thrown before the duplicate
+ *   request. The last `CURSOR_HISTORY_LIMIT` cursors are remembered; a cycle
+ *   longer than that is not detected, which bounds memory on a long walk.
+ * - `maxPages` is validated before any request: a positive integer or
+ *   `Infinity`; `0`, a negative, fractional or `NaN` value throws `RangeError`.
+ * - `has_more: false` ends the walk normally, whatever `next_cursor` says.
+ * - A `PaginationError` carries the offending `page`, so its data is not lost,
+ *   and registers a resume point like any other failure.
+ *
+ * `options.progress`, when passed, is updated as the walk goes: how many
+ * pages were fetched, the last cursor requested, the `next_cursor` of the
+ * last page, and why the walk stopped, so a caller that stops at `maxPages`
+ * can tell "the collection has more" from "the collection is exhausted" and
+ * keep the continuation.
  */
-import type { ApiListEnvelope, ApiOperationId, ApiRequestOptions, ListParams, OxinsiderApiClient } from "./client.js";
+import type { ApiListEnvelope, ApiOperationId, ApiRequestOptions, ListOperationId, ListParams, OperationEnvelope, OperationItem, OperationOptionsArgs, OxinsiderApiClient, RuntimeOperationId } from "./client.js";
+import type { OperationPath, OperationQuery } from "./schema.js";
+/**
+ * How many requested cursors a walk remembers for the repeat check. A cycle
+ * longer than this is not detected; the bound keeps a long walk's memory
+ * flat instead of growing with every page.
+ */
+export declare const CURSOR_HISTORY_LIMIT = 1024;
+/** Why a walk ended; see `PaginationProgress.stoppedBy`. */
+export type PaginationStop = 
+/** The server said `has_more: false`: the collection is exhausted. */
+"exhausted"
+/** The caller's `maxPages` was reached; `nextCursor` continues the walk. */
+ | "max_pages";
+/**
+ * Live progress of a walk (#16246). Pass an object as `options.progress`
+ * and read it after the loop; it is updated before each page is yielded and
+ * when the walk ends. On a throw it holds the state at the failed page, the
+ * same information `paginationResumePoint(error)` returns.
+ */
+export interface PaginationProgress {
+    /** Pages fetched and yielded so far. */
+    pagesFetched?: number;
+    /** The cursor the most recent page was requested with; `undefined` for the first page. */
+    cursor?: string;
+    /**
+     * The most recent page's `next_cursor`. After `stoppedBy: "max_pages"`
+     * this is the continuation: pass it as `query.cursor` to carry on.
+     * `null` or `undefined` once the collection is exhausted.
+     */
+    nextCursor?: string | null;
+    /** Set when the walk ends without throwing. */
+    stoppedBy?: PaginationStop;
+}
 export interface PaginateOptions {
     /** Path parameters for templated list paths (e.g. `{ id }` for deliveries). */
     path?: ApiRequestOptions["path"];
     /** Initial query params (filters, `limit`, an initial `cursor`, ...). */
     query?: ListParams;
+    /** Reject query names the operation does not publish before the first request. */
+    strictQuery?: ApiRequestOptions["strictQuery"];
     /** Forwarded to each request for cooperative cancellation. */
     signal?: AbortSignal;
-    /** Hard cap on pages fetched; defaults to unbounded. */
+    /** Per-request deadline, forwarded to each page; see `ApiRequestOptions.timeoutMs`. */
+    timeoutMs?: number | null;
+    /** Retries per page, forwarded to each request; see `ApiRequestOptions.maxRetries`. */
+    maxRetries?: number;
+    /** Extra headers on every page, such as a conditional read's `If-None-Match`. */
+    headers?: Record<string, string>;
+    /**
+     * Hard cap on pages fetched. A positive integer, or `Infinity` / omitted
+     * for no cap. Anything else (`0`, negative, fractional, `NaN`) throws a
+     * `RangeError` before any request. Reaching it is a caller choice, not
+     * exhaustion: `progress.stoppedBy` reads `"max_pages"` and
+     * `progress.nextCursor` holds the continuation.
+     */
     maxPages?: number;
+    /** Updated as the walk goes; see `PaginationProgress`. */
+    progress?: PaginationProgress;
 }
+/**
+ * `PaginateOptions` bound to one list operation (#16136): `path` required
+ * exactly when the route has path parameters, `query` the documented query.
+ */
+export type OperationPaginateOptions<K extends ListOperationId> = Omit<PaginateOptions, "path" | "query"> & (OperationPath[K] extends Record<string, never> ? {
+    path?: OperationPath[K];
+} : {
+    path: OperationPath[K];
+}) & {
+    query?: OperationQuery[K];
+};
 /** Where an interrupted walk can pick up again; see `paginationResumePoint`. */
 export interface PaginationResumePoint {
     /**
@@ -32,6 +114,34 @@ export interface PaginationResumePoint {
     /** Pages already yielded before the failure. */
     pagesFetched: number;
 }
+/** What a page did that the list protocol does not allow. */
+export type PaginationErrorReason = 
+/** `has_more: true` with no usable `next_cursor` (missing, `null` or empty). */
+"missing_cursor"
+/** `next_cursor` repeats a cursor this walk already requested: a cycle. */
+ | "repeated_cursor";
+/**
+ * The server's list response broke the pagination protocol (#16246). The
+ * walk stops before yielding the page and before any further request.
+ *
+ * `page` is the response as received, so its `data` is still available to
+ * you; `cursor` is what that page was requested with (`undefined` for the
+ * first page) and `nextCursor` is what it offered next. `pagesFetched`
+ * counts the pages already yielded. `paginationResumePoint(error)` returns
+ * `{ cursor, pagesFetched }` for this error too. Retrying the same page later
+ * is reasonable for a transient server fault; a repeat on the same cursor
+ * means the route's cursor is broken and is worth reporting with
+ * `page.meta.request_id`.
+ */
+export declare class PaginationError<T = unknown> extends Error {
+    readonly reason: PaginationErrorReason;
+    readonly operationId: ApiOperationId;
+    readonly cursor: string | undefined;
+    readonly nextCursor: string | null | undefined;
+    readonly pagesFetched: number;
+    readonly page: ApiListEnvelope<T>;
+    constructor(reason: PaginationErrorReason, operationId: ApiOperationId, page: ApiListEnvelope<T>, cursor: string | undefined, pagesFetched: number);
+}
 /**
  * The resume point of an error thrown out of `paginatePages`, `paginate` or
  * `collect`, or `undefined` for any other error (#14281).
@@ -40,6 +150,7 @@ export interface PaginationResumePoint {
  * retries are exhausted the ORIGINAL error is rethrown unchanged, so an
  * `instanceof RateLimitedError` check keeps working, and this function recovers
  * the cursor that the throw would otherwise have destroyed with the generator.
+ * A `PaginationError` (#16246) is registered the same way.
  *
  * @example
  * try {
@@ -54,23 +165,30 @@ export declare function paginationResumePoint(error: unknown): PaginationResumeP
  * Async-iterate whole list pages, following `next_cursor` until exhausted.
  * Yields the full envelope so callers can read `meta`/`total`/`has_more`.
  * A failed page throws its original error; `paginationResumePoint(error)`
- * returns the cursor to continue from.
+ * returns the cursor to continue from. A page that breaks the protocol
+ * throws `PaginationError` before it is yielded (#16246).
  */
-export declare function paginatePages<T>(client: OxinsiderApiClient, operationId: ApiOperationId, options?: PaginateOptions): AsyncGenerator<ApiListEnvelope<T>, void, undefined>;
+export declare function paginatePages<K extends ListOperationId>(client: OxinsiderApiClient, operationId: K, ...options: OperationOptionsArgs<K, OperationPaginateOptions<K>>): AsyncGenerator<OperationEnvelope<K>, void, undefined>;
+/** The untyped form: a runtime-chosen operation, or a caller-asserted `T`. */
+export declare function paginatePages<T = unknown, I extends ApiOperationId = ApiOperationId>(client: OxinsiderApiClient, operationId: RuntimeOperationId<I>, options?: PaginateOptions): AsyncGenerator<ApiListEnvelope<T>, void, undefined>;
 /**
  * Async-iterate individual `data[]` items across all pages.
  *
  * @example
- * for await (const trade of paginate<WhaleTrade>(client, "listWhaleTrades", {
+ * for await (const trade of paginate(client, "listWhaleTrades", {
  *   query: { min_grade: "S", limit: 100 },
  * })) {
- *   handle(trade);
+ *   handle(trade); // typed as the route's whale trade (#16136)
  * }
  */
-export declare function paginate<T>(client: OxinsiderApiClient, operationId: ApiOperationId, options?: PaginateOptions): AsyncGenerator<T, void, undefined>;
+export declare function paginate<K extends ListOperationId>(client: OxinsiderApiClient, operationId: K, ...options: OperationOptionsArgs<K, OperationPaginateOptions<K>>): AsyncGenerator<OperationItem<K>, void, undefined>;
+/** The untyped form: a runtime-chosen operation, or a caller-asserted `T`. */
+export declare function paginate<T = unknown, I extends ApiOperationId = ApiOperationId>(client: OxinsiderApiClient, operationId: RuntimeOperationId<I>, options?: PaginateOptions): AsyncGenerator<T, void, undefined>;
 /**
  * Collect every item across all pages into one array. Convenience over
  * `paginate()` for small result sets; prefer the iterator for large ones.
  */
-export declare function collect<T>(client: OxinsiderApiClient, operationId: ApiOperationId, options?: PaginateOptions): Promise<T[]>;
+export declare function collect<K extends ListOperationId>(client: OxinsiderApiClient, operationId: K, ...options: OperationOptionsArgs<K, OperationPaginateOptions<K>>): Promise<OperationItem<K>[]>;
+/** The untyped form: a runtime-chosen operation, or a caller-asserted `T`. */
+export declare function collect<T = unknown, I extends ApiOperationId = ApiOperationId>(client: OxinsiderApiClient, operationId: RuntimeOperationId<I>, options?: PaginateOptions): Promise<T[]>;
 //# sourceMappingURL=pagination.d.ts.map

package/dist/sdk/pagination.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../../sdk/src/pagination.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,UAAU,EACV,kBAAkB,EACnB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,eAAe;IAC9B,+EAA+E;IAC/E,IAAI,CAAC,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACjC,yEAAyE;IACzE,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,gFAAgF;AAChF,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,gDAAgD;IAChD,YAAY,EAAE,MAAM,CAAC;CACtB;AAID;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,GACb,qBAAqB,GAAG,SAAS,CAInC;AAED;;;;;GAKG;AACH,wBAAuB,aAAa,CAAC,CAAC,EACpC,MAAM,EAAE,kBAAkB,EAC1B,WAAW,EAAE,cAAc,EAC3B,OAAO,GAAE,eAAoB,GAC5B,cAAc,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAsCrD;AAED;;;;;;;;;GASG;AACH,wBAAuB,QAAQ,CAAC,CAAC,EAC/B,MAAM,EAAE,kBAAkB,EAC1B,WAAW,EAAE,cAAc,EAC3B,OAAO,GAAE,eAAoB,GAC5B,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAMpC;AAED;;;GAGG;AACH,wBAAsB,OAAO,CAAC,CAAC,EAC7B,MAAM,EAAE,kBAAkB,EAC1B,WAAW,EAAE,cAAc,EAC3B,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,CAAC,EAAE,CAAC,CAMd"}
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../../sdk/src/pagination.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,iBAAiB,EACjB,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEjE;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,OAAQ,CAAC;AAE1C,4DAA4D;AAC5D,MAAM,MAAM,cAAc;AACxB,sEAAsE;AACpE,WAAW;AACb,4EAA4E;GAC1E,WAAW,CAAC;AAEhB;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0FAA0F;IAC1F,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,+CAA+C;IAC/C,SAAS,CAAC,EAAE,cAAc,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,+EAA+E;IAC/E,IAAI,CAAC,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACjC,yEAAyE;IACzE,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,kFAAkF;IAClF,WAAW,CAAC,EAAE,iBAAiB,CAAC,aAAa,CAAC,CAAC;IAC/C,8DAA8D;IAC9D,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,uFAAuF;IACvF,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,uFAAuF;IACvF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,kBAAkB,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,MAAM,wBAAwB,CAAC,CAAC,SAAS,eAAe,IAAI,IAAI,CACpE,eAAe,EACf,MAAM,GAAG,OAAO,CACjB,GACC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,GAC3C;IAAE,IAAI,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAA;CAAE,GAC3B;IAAE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,CAAA;CAAE,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,CAAA;CAAE,CAAC;AAElE,gFAAgF;AAChF,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,gDAAgD;IAChD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,6DAA6D;AAC7D,MAAM,MAAM,qBAAqB;AAC/B,gFAAgF;AAC9E,gBAAgB;AAClB,2EAA2E;GACzE,iBAAiB,CAAC;AAEtB;;;;;;;;;;;;GAYG;AACH,qBAAa,eAAe,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,KAAK;IACrD,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IAElC,YACE,MAAM,EAAE,qBAAqB,EAC7B,WAAW,EAAE,cAAc,EAC3B,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,EACxB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,YAAY,EAAE,MAAM,EAerB;CACF;AAID;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,GACb,qBAAqB,GAAG,SAAS,CAInC;AAiBD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,eAAe,EACrD,MAAM,EAAE,kBAAkB,EAC1B,WAAW,EAAE,CAAC,EACd,GAAG,OAAO,EAAE,oBAAoB,CAAC,CAAC,EAAE,wBAAwB,CAAC,CAAC,CAAC,CAAC,GAC/D,cAAc,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;AACzD,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,SAAS,cAAc,GAAG,cAAc,EAClF,MAAM,EAAE,kBAAkB,EAC1B,WAAW,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAClC,OAAO,CAAC,EAAE,eAAe,GACxB,cAAc,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;AAuFvD;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,eAAe,EAChD,MAAM,EAAE,kBAAkB,EAC1B,WAAW,EAAE,CAAC,EACd,GAAG,OAAO,EAAE,oBAAoB,CAAC,CAAC,EAAE,wBAAwB,CAAC,CAAC,CAAC,CAAC,GAC/D,cAAc,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;AACrD,8EAA8E;AAC9E,wBAAgB,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,SAAS,cAAc,GAAG,cAAc,EAC7E,MAAM,EAAE,kBAAkB,EAC1B,WAAW,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAClC,OAAO,CAAC,EAAE,eAAe,GACxB,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;AAatC;;;GAGG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,eAAe,EAC/C,MAAM,EAAE,kBAAkB,EAC1B,WAAW,EAAE,CAAC,EACd,GAAG,OAAO,EAAE,oBAAoB,CAAC,CAAC,EAAE,wBAAwB,CAAC,CAAC,CAAC,CAAC,GAC/D,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAC/B,8EAA8E;AAC9E,wBAAgB,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,SAAS,cAAc,GAAG,cAAc,EAC5E,MAAM,EAAE,kBAAkB,EAC1B,WAAW,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAClC,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC"}

package/dist/sdk/pagination.js

@@ -1,15 +1,77 @@
 /**
  * Cursor pagination over the Stripe-style V1 list envelope.
  *
- * Every list endpoint returns `{ object: "list", data, has_more, next_cursor }`.
- * `paginate()` yields each `data[]` item across pages, following `next_cursor`
- * while `has_more` is true. `paginatePages()` yields whole pages when you need
- * the envelope (e.g. to read `meta.cost` or `total`).
+ * Every list endpoint returns `{ object: "list", data, has_more, next_cursor }`
+ * (`backend/src/api_v1/types.rs` `ApiList`: `has_more` is always a boolean,
+ * `next_cursor` is a string or omitted). `paginate()` yields each `data[]`
+ * item across pages, following `next_cursor` while `has_more` is true.
+ * `paginatePages()` yields whole pages when you need the envelope (e.g. to
+ * read `meta.cost` or `total`).
  *
- * The loop stops on the first page where `has_more` is false OR `next_cursor`
- * is null/absent, so a buggy server that returns `has_more: true` with no
- * cursor cannot spin forever.
+ * The walker is a progress-checked consumer of that protocol (#16246):
+ *
+ * - A page is validated BEFORE it is yielded. `has_more: true` with no usable
+ *   `next_cursor` is a `PaginationError` (`missing_cursor`); the backend's own
+ *   cursor builders refuse to produce that page ("has_more is true for an
+ *   empty page", `insider_radar.rs`), so a client seeing it is looking at a
+ *   malformed response, not the end of the collection. Before #16246 the
+ *   walk returned as if the collection were exhausted.
+ * - A `next_cursor` that repeats a cursor this walk already requested is a
+ *   `PaginationError` (`repeated_cursor`), thrown before the duplicate
+ *   request. The last `CURSOR_HISTORY_LIMIT` cursors are remembered; a cycle
+ *   longer than that is not detected, which bounds memory on a long walk.
+ * - `maxPages` is validated before any request: a positive integer or
+ *   `Infinity`; `0`, a negative, fractional or `NaN` value throws `RangeError`.
+ * - `has_more: false` ends the walk normally, whatever `next_cursor` says.
+ * - A `PaginationError` carries the offending `page`, so its data is not lost,
+ *   and registers a resume point like any other failure.
+ *
+ * `options.progress`, when passed, is updated as the walk goes: how many
+ * pages were fetched, the last cursor requested, the `next_cursor` of the
+ * last page, and why the walk stopped, so a caller that stops at `maxPages`
+ * can tell "the collection has more" from "the collection is exhausted" and
+ * keep the continuation.
+ */
+/**
+ * How many requested cursors a walk remembers for the repeat check. A cycle
+ * longer than this is not detected; the bound keeps a long walk's memory
+ * flat instead of growing with every page.
  */
+export const CURSOR_HISTORY_LIMIT = 1_024;
+/**
+ * The server's list response broke the pagination protocol (#16246). The
+ * walk stops before yielding the page and before any further request.
+ *
+ * `page` is the response as received, so its `data` is still available to
+ * you; `cursor` is what that page was requested with (`undefined` for the
+ * first page) and `nextCursor` is what it offered next. `pagesFetched`
+ * counts the pages already yielded. `paginationResumePoint(error)` returns
+ * `{ cursor, pagesFetched }` for this error too. Retrying the same page later
+ * is reasonable for a transient server fault; a repeat on the same cursor
+ * means the route's cursor is broken and is worth reporting with
+ * `page.meta.request_id`.
+ */
+export class PaginationError extends Error {
+    reason;
+    operationId;
+    cursor;
+    nextCursor;
+    pagesFetched;
+    page;
+    constructor(reason, operationId, page, cursor, pagesFetched) {
+        const requestId = page.meta?.request_id;
+        super(reason === "missing_cursor"
+            ? `0xinsider API ${operationId} page ${String(pagesFetched + 1)} says has_more but carries no next_cursor${requestId ? ` (request ${requestId})` : ""}; the walk cannot continue safely`
+            : `0xinsider API ${operationId} page ${String(pagesFetched + 1)} offers next_cursor ${JSON.stringify(page.next_cursor)}, which this walk already requested${requestId ? ` (request ${requestId})` : ""}; stopping before the duplicate request`);
+        this.name = "PaginationError";
+        this.reason = reason;
+        this.operationId = operationId;
+        this.cursor = cursor;
+        this.nextCursor = page.next_cursor;
+        this.pagesFetched = pagesFetched;
+        this.page = page;
+    }
+}
 const resumePoints = new WeakMap();
 /**
  * The resume point of an error thrown out of `paginatePages`, `paginate` or
@@ -19,6 +81,7 @@ const resumePoints = new WeakMap();
  * retries are exhausted the ORIGINAL error is rethrown unchanged, so an
  * `instanceof RateLimitedError` check keeps working, and this function recovers
  * the cursor that the throw would otherwise have destroyed with the generator.
+ * A `PaginationError` (#16246) is registered the same way.
  *
  * @example
  * try {
@@ -33,58 +96,97 @@ export function paginationResumePoint(error) {
         ? resumePoints.get(error)
         : undefined;
 }
-/**
- * Async-iterate whole list pages, following `next_cursor` until exhausted.
- * Yields the full envelope so callers can read `meta`/`total`/`has_more`.
- * A failed page throws its original error; `paginationResumePoint(error)`
- * returns the cursor to continue from.
- */
+function assertMaxPages(value) {
+    if (value === undefined || value === Infinity)
+        return Infinity;
+    if (!Number.isInteger(value) || value < 1) {
+        throw new RangeError(`maxPages must be a positive integer or Infinity, got ${String(value)}`);
+    }
+    return value;
+}
+/** A `next_cursor` the walk can request: a non-empty string. */
+function usableCursor(value) {
+    return typeof value === "string" && value !== "";
+}
 export async function* paginatePages(client, operationId, options = {}) {
-    const { path, query, signal, maxPages } = options;
+    const { path, query, strictQuery, signal, progress, timeoutMs, maxRetries, headers } = options;
+    const maxPages = assertMaxPages(options.maxPages);
     let cursor = query?.cursor;
     let pages = 0;
+    // Every cursor requested so far, newest last, capped at CURSOR_HISTORY_LIMIT.
+    const requested = new Set();
+    const requestedOrder = [];
+    const remember = (value) => {
+        if (requested.has(value))
+            return;
+        requested.add(value);
+        requestedOrder.push(value);
+        if (requestedOrder.length > CURSOR_HISTORY_LIMIT) {
+            const oldest = requestedOrder.shift();
+            if (oldest !== undefined)
+                requested.delete(oldest);
+        }
+    };
+    const record = (fields) => {
+        if (progress)
+            Object.assign(progress, fields);
+    };
+    const fail = (error) => {
+        if (!resumePoints.has(error)) {
+            resumePoints.set(error, { cursor, pagesFetched: pages });
+        }
+        return error;
+    };
     for (;;) {
         if (signal?.aborted) {
             throw signal.reason instanceof Error
                 ? signal.reason
                 : new DOMException("The pagination was aborted", "AbortError");
         }
+        if (cursor !== undefined)
+            remember(cursor);
         let page;
         try {
             page = await client.list(operationId, {
                 path,
                 query: { ...query, ...(cursor === undefined ? {} : { cursor }) },
+                strictQuery,
                 signal,
+                ...(timeoutMs === undefined ? {} : { timeoutMs }),
+                ...(maxRetries === undefined ? {} : { maxRetries }),
+                ...(headers === undefined ? {} : { headers }),
             });
         }
         catch (error) {
-            if (typeof error === "object" && error !== null && !resumePoints.has(error)) {
-                resumePoints.set(error, { cursor, pagesFetched: pages });
-            }
+            if (typeof error === "object" && error !== null)
+                fail(error);
             throw error;
         }
+        record({ pagesFetched: pages, cursor, nextCursor: page.next_cursor });
+        const next = page.next_cursor;
+        if (page.has_more) {
+            if (!usableCursor(next)) {
+                throw fail(new PaginationError("missing_cursor", operationId, page, cursor, pages));
+            }
+            if (requested.has(next)) {
+                throw fail(new PaginationError("repeated_cursor", operationId, page, cursor, pages));
+            }
+        }
         yield page;
         pages += 1;
-        const next = page.next_cursor;
-        if (!page.has_more || next === null || next === undefined || next === "") {
+        record({ pagesFetched: pages, cursor, nextCursor: next });
+        if (!page.has_more) {
+            record({ pagesFetched: pages, cursor, nextCursor: next, stoppedBy: "exhausted" });
             return;
         }
-        if (maxPages !== undefined && pages >= maxPages) {
+        if (pages >= maxPages) {
+            record({ pagesFetched: pages, cursor, nextCursor: next, stoppedBy: "max_pages" });
             return;
         }
+        // `has_more` was true and `next` passed both checks above.
         cursor = next;
     }
 }
-/**
- * Async-iterate individual `data[]` items across all pages.
- *
- * @example
- * for await (const trade of paginate<WhaleTrade>(client, "listWhaleTrades", {
- *   query: { min_grade: "S", limit: 100 },
- * })) {
- *   handle(trade);
- * }
- */
 export async function* paginate(client, operationId, options = {}) {
     for await (const page of paginatePages(client, operationId, options)) {
         for (const item of page.data) {
@@ -92,10 +194,6 @@ export async function* paginate(client, operationId, options = {}) {
         }
     }
 }
-/**
- * Collect every item across all pages into one array. Convenience over
- * `paginate()` for small result sets; prefer the iterator for large ones.
- */
 export async function collect(client, operationId, options = {}) {
     const items = [];
     for await (const item of paginate(client, operationId, options)) {

package/dist/sdk/pagination.js.map

@@ -1 +1 @@
-{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../../sdk/src/pagination.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../../sdk/src/pagination.ts"],"names":[],"mappings":"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"}