@secondlayer/sdk 16.2.1 → 16.3.0

package/dist/index.d.ts

@@ -324,6 +324,33 @@ declare function resolveApiKey(apiKey?: string, baseUrl?: string): string | unde
 *  Precedence: explicit `accountKey` → `SECONDLAYER_API_KEY`. Does not read
 *  `INSTANCE_TOKEN`. */
 declare function resolveAccountKey(accountKey?: string): string | undefined;
+/** Hosted account API for credits, archive fetches and login. Not the
+*  operator's loopback box. `SL_CREDITS_API_URL` (or the older
+*  `ARCHIVE_OPS_API_URL`) points it elsewhere, e.g. at a staging stack. */
+declare function resolveAccountUrl(): string;
+/** Where a resolved credential came from. `none` = nothing usable was found. */
+type IdentitySource = "env" | "session" | "none";
+interface Identity {
+	source: IdentitySource;
+	/** Bearer token, `undefined` when `source` is `none`. */
+	token: string | undefined;
+	/** The server this credential is for. */
+	url: string;
+}
+/**
+* The one credential resolver the CLI and MCP share. One precedence, highest
+* first: an env key, then the stored login session (`session`, supplied by
+* callers that have one; the SDK itself never touches the filesystem).
+*
+*   target "account"  env = `SECONDLAYER_API_KEY` when it is an account
+*                     credential (`sk-sl_` / `ss-sl_`); url = {@link resolveAccountUrl}
+*   target "instance" env = `INSTANCE_TOKEN`; url = {@link resolveBaseUrl}
+*
+* An env key of the wrong kind is ignored rather than sent to the wrong host.
+*/
+declare function resolveIdentity(target: "account" | "instance", options?: {
+	session?: string | null;
+}): Identity;
 declare abstract class BaseClient {
 	protected baseUrl: string;
 	protected apiKey?: string;
@@ -832,6 +859,8 @@ type StreamsEventsStreamBitcoinParams = StreamsEventsStreamCommon & {
 	address?: string;
 };
 type StreamsEventsStreamParams = StreamsEventsStreamStacksParams | StreamsEventsStreamBitcoinParams;
+/** Where a `subscribe` connection is in its lifecycle. */
+type StreamsSubscriptionState = "connecting" | "open" | "reconnecting" | "closed";
 type StreamsEventsSubscribeCommon = {
 	/** Resume strictly after this cursor; omit to live-tail from the tip. */
 	fromCursor?: string | null;
@@ -845,6 +874,13 @@ type StreamsEventsSubscribeCommon = {
 	*/
 	onError?: (err: unknown) => void;
 	/**
+	* Lifecycle observer. `connecting` before each connection attempt, `open`
+	* once the server answers, `reconnecting` while backing off after a drop
+	* or error, `closed` once, when the subscription ends (unsubscribed,
+	* aborted, or stopped by an error a retry cannot fix).
+	*/
+	onState?: (state: StreamsSubscriptionState) => void;
+	/**
 	* First reconnect pause in ms (default 1000). Doubles per consecutive
 	* failure up to 30 s with jitter, resets once a frame arrives, and never
 	* undercuts a `Retry-After`.
@@ -2378,6 +2414,9 @@ type IndexSbtcWithdrawal = {
 	btc_block_height: number | null;
 	/** When the sweep crossed the confirmation threshold (ISO), null otherwise. */
 	confirmed_at: string | null;
+	/** Monotonic stamp taken when the sweep became confirmed; resume a scan
+	*  from it with `confirmed_after_seq`. Null while unsettled. */
+	settlement_seq: number | null;
 	requested_at?: string | null;
 	resolved_at?: string | null;
 };
@@ -3985,11 +4024,11 @@ declare function buildDoctorReport(input: {
 * The list page's own reduced detector: computed from `WebhookSummary` alone
 * (no deliveries, no dead-letter rows — the list endpoint returns neither,
 * and fetching per-row detail or deliveries here would fan out one request
-* per row). Only `status` and `circuitOpenedAt` distinguish a real problem
+* per row). Only `status` and `pauseReason` distinguish a real problem
 * from a manual pause at this level; deliveries-based rules (rate limits,
 * downtime, rejects, slowness, lag) only ever show on the detail page.
 */
-declare function buildListIssue(webhook: Pick<WebhookSummary3, "status" | "circuitOpenedAt" | "lastSuccessAt">): DoctorIssue | null;
+declare function buildListIssue(webhook: Pick<WebhookSummary3, "status" | "pauseReason" | "circuitOpenedAt" | "lastSuccessAt">): DoctorIssue | null;
 /**
 * The two pieces every "deploy a consumer" guide leaves out, packaged:
 * a liveness endpoint and a graceful-shutdown signal. Both are
@@ -4325,6 +4364,13 @@ type CreateStreamsClientOptions = {
 	origin?: "cli" | "mcp" | "session";
 	fetchImpl?: FetchLike2;
 	/**
+	* Give up on a request that has not connected and returned response headers
+	* within this many ms (default 30000; `0` disables). Retryable: the consume
+	* loops retry it and `subscribe` reconnects. Body reads are not covered, so
+	* a healthy long-lived stream is never cut off.
+	*/
+	connectTimeoutMs?: number;
+	/**
 	* Public base URL for bulk parquet dumps (the R2/CDN bucket root). Required
 	* to use `client.dumps`. See `GET /public/streams/dumps/manifest`.
 	*/
@@ -4423,4 +4469,4 @@ declare const Cursor: {
 	};
 };
 import { decodeClarityValue, toJsonSafe } from "@secondlayer/shared/streams-rows";
-export { ACCOUNT_KEY_ENV, ActiveSubgraphOperation, ApiError, ArchiveAuthError, ArchiveClient, ArchiveCreditsBalance, ArchiveDataset, ArchiveFetchItem, ArchiveFetchResult, ArchiveFlow, ArchiveGateNotConfiguredError, ArchiveLoadOptions, ArchiveManifest, ArchivePartition, ArchiveQuote, ArchiveSignatureError, ArchiveStatus, ArchiveVerifyInput, ArchiveVerifyRangeStatus, ArchiveVerifyResult, AuthError, BitcoinOutputSpent, BitcoinOutputUnspent, BitcoinOutspend, BitcoinResource, BlockEnvelope, BlocksEnvelope, BlocksListParams, BlocksWalkParams, CanonicalEnvelope, CanonicalListParams, CanonicalWalkParams, ChainApplyDeliveryOf, ChainApplyEnvelope, ChainApplyEnvelopeOf, ChainEventEnvelope, ChainFtBurnData, ChainFtMintData, ChainFtTransferData, ChainNftBurnData, ChainNftMintData, ChainNftTransferData, ChainPrintEventData, ChainReorgOrphanedEntry, ChainReorgRollbackDelivery, ChainReorgRollbackEnvelope, ChainStxBurnData, ChainStxLockData, ChainStxMintData, ChainStxTransferData, ChainTestDelivery, ChainTrigger, ChainTriggerType, ChainTxLevelEvent, ChainWebhookDelivery2 as ChainWebhookDelivery, ChainWebhookEnvelope, ConsumerBatchContext, ConsumerHealth, ConsumerSink, ContextAccount, ContextField, ContextFieldError, ContextSnapshot, ContractCallsConsumeParams, ContractCallsEnvelope, ContractCallsListParams, ContractCallsWalkParams, ContractConformance, ContractSummary, Contracts, ContractsEnvelope, ContractsListParams, CreateArchiveClientOptions, CreateWebhookRequest2 as CreateWebhookRequest, CreateWebhookResponse2 as CreateWebhookResponse, Cursor, DEFAULT_REQUEST_TIMEOUT_MS, DOWN_MIN_CONSECUTIVE, DeadRow2 as DeadRow, DecodedEventColumns, DecodedEventRow, DecodedFtBurn, DecodedFtBurnPayload, DecodedFtMint, DecodedFtMintPayload, DecodedFtTransfer, DecodedFtTransferPayload, DecodedNftBurn, DecodedNftBurnPayload, DecodedNftMint, DecodedNftMintPayload, DecodedNftTransfer, DecodedNftTransferPayload, DecodedPrint, DecodedPrintPayload, DecodedPrintValue, DecodedStxBurn, DecodedStxBurnPayload, DecodedStxLock, DecodedStxLockPayload, DecodedStxMint, DecodedStxMintPayload, DecodedStxTransfer, DecodedStxTransferPayload, DeliveryRow2 as DeliveryRow, DoctorEvidence, DoctorFix, DoctorIssue, DoctorIssueCode, DoctorReport, DoctorSeverity, EtagCache, EtagEntry, EventsConsumeParams, EventsEnvelope, EventsListParams, EventsWalkParams, FetchLike2 as FetchLike, FtTransfer, FtTransferEvent, FtTransferPayload2 as FtTransferPayload, FtTransfersEnvelope, FtTransfersListParams, FtTransfersResource, FtTransfersWalkParams, INDEX_MAX_PAGE_SIZE, INSTANCE_TOKEN_ENV, Index, IndexAlwaysFields, IndexBitcoinTip, IndexBlock, IndexBtcReorg, IndexCanonicalBlock, IndexConsumeOptions, IndexContractCall, IndexDiscovery, IndexEvent, IndexEventFields, IndexEventOf, IndexEventType, IndexEventTypeFilters, IndexEventsResource, IndexFeedEnvelope, IndexFeedFetcher, IndexFeedItem, IndexFtBurn, IndexFtMint, IndexFtTransfer, IndexMapDelete, IndexMapInsert, IndexMapSet, IndexMempoolTransaction, IndexNestedContractCall, IndexNftBurn, IndexNftMint, IndexNftTransfer, IndexOrder, IndexPostCondition, IndexPox5Event, IndexPox5EventTopic, IndexPoxCycle, IndexPoxCycleSigner, IndexPrint, IndexReorg, IndexRuneBalance, IndexRuneEntry, IndexRuneEvent, IndexRuneEventKind, IndexRuneRefSummary, IndexRuneTerms, IndexSbtcDeposit, IndexSbtcDepositDetail, IndexSbtcEvent, IndexSbtcSummary, IndexSbtcWithdrawal, IndexSbtcWithdrawalDetail, IndexSbtcWithdrawalPhase, IndexStackingAction, IndexStateWrite, IndexStxBurn, IndexStxLock, IndexStxMint, IndexStxTransfer, IndexTip, IndexTransaction, IndexVarSet, InstanceClient, InstanceDiagnosis3 as InstanceDiagnosis, InstanceIssue, InstanceState, InstanceStatus, InsufficientArchiveCreditsError, LOCAL_API_URL, LoadedArchive, MemoryEtagCache, MempoolEnvelope, MempoolListParams, MempoolTransactionEnvelope, MempoolWalkParams, NftTransfer, NftTransferEvent, NftTransferPayload2 as NftTransferPayload, NftTransfersEnvelope, NftTransfersListParams, NftTransfersResource, NftTransfersWalkParams, Pox5EventsConsumeParams, Pox5EventsEnvelope, Pox5EventsListParams, Pox5EventsWalkParams, Pox5Resource, PoxCycleEnvelope, PoxCyclesEnvelope, PoxCyclesListParams, PoxCyclesWalkParams, PoxResource, PrintSchemaResponse, PublicStatus2 as PublicStatus, RateLimitError, ReplayResult2 as ReplayResult, RequestOptions, RewardSet2 as RewardSet, RotateSecretResponse2 as RotateSecretResponse, RuneActivityEnvelope, RuneActivityListParams, RuneActivityWalkParams, RuneApplyDeliveryOf, RuneApplyEnvelope, RuneBalancesEnvelope, RuneBalancesListParams, RuneEnvelope, RuneEtchEntry, RuneEventPayload, RuneEventType, RuneId, RuneRef, RuneStreamsEvent, RunesEnvelope, RunesListParams, RunesResource, SbtcDepositEnvelope, SbtcDepositEvent, SbtcDepositsConsumeParams, SbtcDepositsEnvelope, SbtcDepositsListParams, SbtcDepositsWalkParams, SbtcEventTopic2 as SbtcEventTopic, SbtcEventsConsumeParams, SbtcEventsEnvelope, SbtcEventsListParams, SbtcEventsWalkParams, SbtcResource, SbtcSummaryEnvelope, SbtcWithdrawalEnvelope, SbtcWithdrawalEvent, SbtcWithdrawalStatus, SbtcWithdrawalSweptConfirmedEvent, SbtcWithdrawalsEnvelope, SbtcWithdrawalsListParams, SbtcWithdrawalsWalkParams, SecondLayer, SecondLayerArchive, SecondLayerError, SecondLayerErrorOptions, SecondLayerOptions, SinkTx, StackingEnvelope, StackingListParams, StackingWalkParams, StandardWebhooksHeaders2 as StandardWebhooksHeaders, StateWritesEnvelope, StateWritesListParams, StateWritesWalkParams, StreamsBatch, StreamsBitcoinCanonicalBlock, StreamsBitcoinTip, StreamsCanonicalBlock, StreamsClient, StreamsConsumeBitcoinParams, StreamsConsumeParams, StreamsConsumeStacksParams, StreamsDumpFile, StreamsDumps, StreamsDumpsManifest, StreamsEvent, StreamsEventPayload, StreamsEventType, StreamsEventsBitcoinListParams, StreamsEventsConsumeBitcoinParams, StreamsEventsConsumeParams, StreamsEventsConsumeResult, StreamsEventsEnvelope, StreamsEventsListEnvelope, StreamsEventsListParams, StreamsEventsStacksListParams, StreamsEventsStreamBitcoinParams, StreamsEventsStreamParams, StreamsEventsStreamStacksParams, StreamsEventsSubscribeBitcoinParams, StreamsEventsSubscribeParams, StreamsEventsSubscribeStacksParams, StreamsReorg, StreamsReorgContext, StreamsReorgsListEnvelope, StreamsReorgsListParams, StreamsServerError, StreamsSignatureError, StreamsSubscription, StreamsTip, StreamsWireEvent2 as StreamsWireEvent, SubgraphAgentSchema3 as SubgraphAgentSchema, SubgraphOperationStatus, SubgraphSpecFormat2 as SubgraphSpecFormat, SubgraphSpecOptions3 as SubgraphSpecOptions, Subgraphs, TransactionEnvelope, TransactionProof, TransactionProofVerifyResult, TransactionsEnvelope, TransactionsListParams, TransactionsWalkParams, UpdateWebhookRequest2 as UpdateWebhookRequest, ValidationError, VmStreamsEvent, WalkOptions, WebhookActivity2 as WebhookActivity, WebhookActivityHour, WebhookAuth, WebhookDeliveryDetail2 as WebhookDeliveryDetail, WebhookDetail2 as WebhookDetail, WebhookFormat, WebhookHeaderInput, WebhookKind, WebhookStatus, WebhookSummary2 as WebhookSummary, WebhookTestResult2 as WebhookTestResult, Webhooks, WithSinkTx, buildDoctorReport, buildListIssue, consumeIndexFeed, consumerHealth, contextField, createArchiveClient, createStreamsClient, decode, decodeChainWebhook, decodeClarityValue, fetchRewardSet, getSubgraph, isHostedApiUrl, isSuccessDelivery, parseRetryAfter, resolveAccountKey, resolveApiKey, resolveBaseUrl, shutdownSignal, toJsonSafe, trigger, verifySecondlayerSignature, verify as verifyStandardWebhooksHeaders, verifyTransactionProof, verifyWebhookSignature };
+export { ACCOUNT_KEY_ENV, ActiveSubgraphOperation, ApiError, ArchiveAuthError, ArchiveClient, ArchiveCreditsBalance, ArchiveDataset, ArchiveFetchItem, ArchiveFetchResult, ArchiveFlow, ArchiveGateNotConfiguredError, ArchiveLoadOptions, ArchiveManifest, ArchivePartition, ArchiveQuote, ArchiveSignatureError, ArchiveStatus, ArchiveVerifyInput, ArchiveVerifyRangeStatus, ArchiveVerifyResult, AuthError, BitcoinOutputSpent, BitcoinOutputUnspent, BitcoinOutspend, BitcoinResource, BlockEnvelope, BlocksEnvelope, BlocksListParams, BlocksWalkParams, CanonicalEnvelope, CanonicalListParams, CanonicalWalkParams, ChainApplyDeliveryOf, ChainApplyEnvelope, ChainApplyEnvelopeOf, ChainEventEnvelope, ChainFtBurnData, ChainFtMintData, ChainFtTransferData, ChainNftBurnData, ChainNftMintData, ChainNftTransferData, ChainPrintEventData, ChainReorgOrphanedEntry, ChainReorgRollbackDelivery, ChainReorgRollbackEnvelope, ChainStxBurnData, ChainStxLockData, ChainStxMintData, ChainStxTransferData, ChainTestDelivery, ChainTrigger, ChainTriggerType, ChainTxLevelEvent, ChainWebhookDelivery2 as ChainWebhookDelivery, ChainWebhookEnvelope, ConsumerBatchContext, ConsumerHealth, ConsumerSink, ContextAccount, ContextField, ContextFieldError, ContextSnapshot, ContractCallsConsumeParams, ContractCallsEnvelope, ContractCallsListParams, ContractCallsWalkParams, ContractConformance, ContractSummary, Contracts, ContractsEnvelope, ContractsListParams, CreateArchiveClientOptions, CreateWebhookRequest2 as CreateWebhookRequest, CreateWebhookResponse2 as CreateWebhookResponse, Cursor, DEFAULT_REQUEST_TIMEOUT_MS, DOWN_MIN_CONSECUTIVE, DeadRow2 as DeadRow, DecodedEventColumns, DecodedEventRow, DecodedFtBurn, DecodedFtBurnPayload, DecodedFtMint, DecodedFtMintPayload, DecodedFtTransfer, DecodedFtTransferPayload, DecodedNftBurn, DecodedNftBurnPayload, DecodedNftMint, DecodedNftMintPayload, DecodedNftTransfer, DecodedNftTransferPayload, DecodedPrint, DecodedPrintPayload, DecodedPrintValue, DecodedStxBurn, DecodedStxBurnPayload, DecodedStxLock, DecodedStxLockPayload, DecodedStxMint, DecodedStxMintPayload, DecodedStxTransfer, DecodedStxTransferPayload, DeliveryRow2 as DeliveryRow, DoctorEvidence, DoctorFix, DoctorIssue, DoctorIssueCode, DoctorReport, DoctorSeverity, EtagCache, EtagEntry, EventsConsumeParams, EventsEnvelope, EventsListParams, EventsWalkParams, FetchLike2 as FetchLike, FtTransfer, FtTransferEvent, FtTransferPayload2 as FtTransferPayload, FtTransfersEnvelope, FtTransfersListParams, FtTransfersResource, FtTransfersWalkParams, INDEX_MAX_PAGE_SIZE, INSTANCE_TOKEN_ENV, Identity, IdentitySource, Index, IndexAlwaysFields, IndexBitcoinTip, IndexBlock, IndexBtcReorg, IndexCanonicalBlock, IndexConsumeOptions, IndexContractCall, IndexDiscovery, IndexEvent, IndexEventFields, IndexEventOf, IndexEventType, IndexEventTypeFilters, IndexEventsResource, IndexFeedEnvelope, IndexFeedFetcher, IndexFeedItem, IndexFtBurn, IndexFtMint, IndexFtTransfer, IndexMapDelete, IndexMapInsert, IndexMapSet, IndexMempoolTransaction, IndexNestedContractCall, IndexNftBurn, IndexNftMint, IndexNftTransfer, IndexOrder, IndexPostCondition, IndexPox5Event, IndexPox5EventTopic, IndexPoxCycle, IndexPoxCycleSigner, IndexPrint, IndexReorg, IndexRuneBalance, IndexRuneEntry, IndexRuneEvent, IndexRuneEventKind, IndexRuneRefSummary, IndexRuneTerms, IndexSbtcDeposit, IndexSbtcDepositDetail, IndexSbtcEvent, IndexSbtcSummary, IndexSbtcWithdrawal, IndexSbtcWithdrawalDetail, IndexSbtcWithdrawalPhase, IndexStackingAction, IndexStateWrite, IndexStxBurn, IndexStxLock, IndexStxMint, IndexStxTransfer, IndexTip, IndexTransaction, IndexVarSet, InstanceClient, InstanceDiagnosis3 as InstanceDiagnosis, InstanceIssue, InstanceState, InstanceStatus, InsufficientArchiveCreditsError, LOCAL_API_URL, LoadedArchive, MemoryEtagCache, MempoolEnvelope, MempoolListParams, MempoolTransactionEnvelope, MempoolWalkParams, NftTransfer, NftTransferEvent, NftTransferPayload2 as NftTransferPayload, NftTransfersEnvelope, NftTransfersListParams, NftTransfersResource, NftTransfersWalkParams, Pox5EventsConsumeParams, Pox5EventsEnvelope, Pox5EventsListParams, Pox5EventsWalkParams, Pox5Resource, PoxCycleEnvelope, PoxCyclesEnvelope, PoxCyclesListParams, PoxCyclesWalkParams, PoxResource, PrintSchemaResponse, PublicStatus2 as PublicStatus, RateLimitError, ReplayResult2 as ReplayResult, RequestOptions, RewardSet2 as RewardSet, RotateSecretResponse2 as RotateSecretResponse, RuneActivityEnvelope, RuneActivityListParams, RuneActivityWalkParams, RuneApplyDeliveryOf, RuneApplyEnvelope, RuneBalancesEnvelope, RuneBalancesListParams, RuneEnvelope, RuneEtchEntry, RuneEventPayload, RuneEventType, RuneId, RuneRef, RuneStreamsEvent, RunesEnvelope, RunesListParams, RunesResource, SbtcDepositEnvelope, SbtcDepositEvent, SbtcDepositsConsumeParams, SbtcDepositsEnvelope, SbtcDepositsListParams, SbtcDepositsWalkParams, SbtcEventTopic2 as SbtcEventTopic, SbtcEventsConsumeParams, SbtcEventsEnvelope, SbtcEventsListParams, SbtcEventsWalkParams, SbtcResource, SbtcSummaryEnvelope, SbtcWithdrawalEnvelope, SbtcWithdrawalEvent, SbtcWithdrawalStatus, SbtcWithdrawalSweptConfirmedEvent, SbtcWithdrawalsEnvelope, SbtcWithdrawalsListParams, SbtcWithdrawalsWalkParams, SecondLayer, SecondLayerArchive, SecondLayerError, SecondLayerErrorOptions, SecondLayerOptions, SinkTx, StackingEnvelope, StackingListParams, StackingWalkParams, StandardWebhooksHeaders2 as StandardWebhooksHeaders, StateWritesEnvelope, StateWritesListParams, StateWritesWalkParams, StreamsBatch, StreamsBitcoinCanonicalBlock, StreamsBitcoinTip, StreamsCanonicalBlock, StreamsClient, StreamsConsumeBitcoinParams, StreamsConsumeParams, StreamsConsumeStacksParams, StreamsDumpFile, StreamsDumps, StreamsDumpsManifest, StreamsEvent, StreamsEventPayload, StreamsEventType, StreamsEventsBitcoinListParams, StreamsEventsConsumeBitcoinParams, StreamsEventsConsumeParams, StreamsEventsConsumeResult, StreamsEventsEnvelope, StreamsEventsListEnvelope, StreamsEventsListParams, StreamsEventsStacksListParams, StreamsEventsStreamBitcoinParams, StreamsEventsStreamParams, StreamsEventsStreamStacksParams, StreamsEventsSubscribeBitcoinParams, StreamsEventsSubscribeParams, StreamsEventsSubscribeStacksParams, StreamsReorg, StreamsReorgContext, StreamsReorgsListEnvelope, StreamsReorgsListParams, StreamsServerError, StreamsSignatureError, StreamsSubscription, StreamsSubscriptionState, StreamsTip, StreamsWireEvent2 as StreamsWireEvent, SubgraphAgentSchema3 as SubgraphAgentSchema, SubgraphOperationStatus, SubgraphSpecFormat2 as SubgraphSpecFormat, SubgraphSpecOptions3 as SubgraphSpecOptions, Subgraphs, TransactionEnvelope, TransactionProof, TransactionProofVerifyResult, TransactionsEnvelope, TransactionsListParams, TransactionsWalkParams, UpdateWebhookRequest2 as UpdateWebhookRequest, ValidationError, VmStreamsEvent, WalkOptions, WebhookActivity2 as WebhookActivity, WebhookActivityHour, WebhookAuth, WebhookDeliveryDetail2 as WebhookDeliveryDetail, WebhookDetail2 as WebhookDetail, WebhookFormat, WebhookHeaderInput, WebhookKind, WebhookStatus, WebhookSummary2 as WebhookSummary, WebhookTestResult2 as WebhookTestResult, Webhooks, WithSinkTx, buildDoctorReport, buildListIssue, consumeIndexFeed, consumerHealth, contextField, createArchiveClient, createStreamsClient, decode, decodeChainWebhook, decodeClarityValue, fetchRewardSet, getSubgraph, isHostedApiUrl, isSuccessDelivery, parseRetryAfter, resolveAccountKey, resolveAccountUrl, resolveApiKey, resolveBaseUrl, resolveIdentity, shutdownSignal, toJsonSafe, trigger, verifySecondlayerSignature, verify as verifyStandardWebhooksHeaders, verifyTransactionProof, verifyWebhookSignature };

package/dist/index.js

@@ -251,6 +251,22 @@ function resolveAccountKey(accountKey) {
     return;
   return process.env?.SECONDLAYER_API_KEY || undefined;
 }
+function resolveAccountUrl() {
+  const env = typeof process !== "undefined" ? process.env : undefined;
+  return (env?.SL_CREDITS_API_URL || env?.ARCHIVE_OPS_API_URL || HOSTED_API_URL).replace(/\/+$/, "");
+}
+var ACCOUNT_CREDENTIAL_RE = /^s[ks]-sl_/;
+function resolveIdentity(target, options = {}) {
+  const url = target === "account" ? resolveAccountUrl() : resolveBaseUrl();
+  const envKey = target === "account" ? resolveAccountKey() : typeof process !== "undefined" ? process.env?.[INSTANCE_TOKEN_ENV] || undefined : undefined;
+  if (envKey && (target === "instance" || ACCOUNT_CREDENTIAL_RE.test(envKey))) {
+    return { source: "env", token: envKey, url };
+  }
+  if (options.session) {
+    return { source: "session", token: options.session, url };
+  }
+  return { source: "none", token: undefined, url };
+}
 function seg(value) {
   return encodeURIComponent(String(value));
 }
@@ -1006,13 +1022,70 @@ async function consumeStreamsEvents(opts) {
   }
   return { cursor, pages, emptyPolls };
 }
+async function* pullFromLoop(start, external) {
+  const controller = new AbortController;
+  if (external) {
+    if (external.aborted)
+      controller.abort();
+    else
+      external.addEventListener("abort", () => controller.abort(), {
+        once: true
+      });
+  }
+  const state = {
+    delivered: null,
+    held: null,
+    finished: false,
+    failure: null,
+    wake: null
+  };
+  const notify = () => {
+    const resolve = state.wake;
+    state.wake = null;
+    resolve?.();
+  };
+  const loop = start((value) => new Promise((release) => {
+    state.delivered = { value, release };
+    notify();
+  }), controller.signal).then(() => {
+    state.finished = true;
+  }, (error) => {
+    state.failure = { error };
+    state.finished = true;
+  }).finally(notify);
+  try {
+    while (true) {
+      if (state.delivered) {
+        const { value, release } = state.delivered;
+        state.delivered = null;
+        state.held = release;
+        yield value;
+        state.held = null;
+        release();
+        continue;
+      }
+      if (state.finished)
+        break;
+      await new Promise((resolve) => {
+        state.wake = resolve;
+        if (state.delivered || state.finished)
+          notify();
+      });
+    }
+    if (state.failure)
+      throw state.failure.error;
+  } finally {
+    controller.abort();
+    state.held?.();
+    state.delivered?.release();
+    await loop;
+  }
+}
 async function* iterateStreamsBatches(opts) {
-  const sleep = opts.sleep ?? defaultSleep;
-  let cursor = opts.fromCursor ?? null;
-  while (!opts.signal?.aborted) {
-    const envelope = await opts.fetchEvents({
-      cursor,
-      limit: opts.batchSize,
+  yield* pullFromLoop(async (deliver, signal) => {
+    const result = await consumeStreamsEvents({
+      fromCursor: opts.fromCursor,
+      batchSize: opts.batchSize,
       chain: opts.chain,
       types: opts.types,
       notTypes: opts.notTypes,
@@ -1022,38 +1095,41 @@ async function* iterateStreamsBatches(opts) {
       assetIdentifier: opts.assetIdentifier,
       rune: opts.rune,
       address: opts.address,
-      filters: opts.filters
+      filters: opts.filters,
+      fetchEvents: opts.fetchEvents,
+      sleep: opts.sleep,
+      emptyBackoffMs: opts.intervalMs,
+      signal,
+      onBatch: async (events, ctx) => {
+        if (events.length === 0 && ctx.reorgs.length === 0)
+          return;
+        await deliver({
+          events,
+          cursor: ctx.cursor,
+          tip: ctx.tip,
+          reorgs: [...ctx.reorgs]
+        });
+      }
     });
-    const checkpoint = envelope.next_cursor ?? cursor;
-    if (envelope.events.length > 0 || envelope.reorgs.length > 0) {
-      yield {
-        events: envelope.events,
-        cursor: checkpoint,
-        tip: envelope.tip,
-        reorgs: envelope.reorgs
-      };
-    }
-    const advanced = checkpoint !== null && checkpoint !== cursor;
-    cursor = checkpoint;
-    if (!advanced && envelope.events.length === 0) {
-      if (opts.signal?.aborted)
-        return;
-      await sleep(opts.intervalMs, opts.signal);
-    }
+    assertNotStalled(result, signal);
+  }, opts.signal);
+}
+function assertNotStalled(result, signal, bounds = {}) {
+  if (signal.aborted)
+    return;
+  if (bounds.maxPages !== undefined && (bounds.pages ?? 0) >= bounds.maxPages) {
+    return;
+  }
+  if (bounds.maxEmptyPolls !== undefined && result.emptyPolls >= bounds.maxEmptyPolls) {
+    return;
   }
+  throw new StreamsServerError(`Streams returned events at cursor ${result.cursor ?? "(start)"} but the cursor did not advance, so the stream stopped instead of re-reading the same page.`, 0, undefined, "CURSOR_STALLED");
 }
 async function* streamStreamsEvents(opts) {
-  const sleep = opts.sleep ?? defaultSleep;
-  const emptyBackoffMs = opts.emptyBackoffMs ?? 500;
-  const maxPages = opts.maxPages ?? Number.POSITIVE_INFINITY;
-  const maxEmptyPolls = opts.maxEmptyPolls ?? Number.POSITIVE_INFINITY;
-  let cursor = opts.fromCursor ?? null;
-  let pages = 0;
-  let emptyPolls = 0;
-  while (pages < maxPages && emptyPolls < maxEmptyPolls && !opts.signal?.aborted) {
-    const envelope = await opts.fetchEvents({
-      cursor,
-      limit: opts.batchSize,
+  yield* pullFromLoop(async (deliver, signal) => {
+    const result = await consumeStreamsEvents({
+      fromCursor: opts.fromCursor,
+      batchSize: opts.batchSize,
       chain: opts.chain,
       types: opts.types,
       notTypes: opts.notTypes,
@@ -1063,29 +1139,27 @@ async function* streamStreamsEvents(opts) {
       assetIdentifier: opts.assetIdentifier,
       rune: opts.rune,
       address: opts.address,
-      filters: opts.filters
+      filters: opts.filters,
+      fetchEvents: opts.fetchEvents,
+      sleep: opts.sleep,
+      emptyBackoffMs: opts.emptyBackoffMs,
+      maxPages: opts.maxPages,
+      maxEmptyPolls: opts.maxEmptyPolls,
+      signal,
+      onBatch: async (events) => {
+        for (const event of events) {
+          if (signal.aborted)
+            return;
+          await deliver(event);
+        }
+      }
     });
-    pages++;
-    for (const event of envelope.events) {
-      if (opts.signal?.aborted)
-        return;
-      yield event;
-    }
-    const nextCursor = envelope.next_cursor;
-    if (nextCursor && nextCursor !== cursor) {
-      cursor = nextCursor;
-      emptyPolls = 0;
-      continue;
-    }
-    if (envelope.events.length === 0) {
-      emptyPolls++;
-      if (emptyPolls >= maxEmptyPolls || pages >= maxPages)
-        return;
-      await sleep(emptyBackoffMs, opts.signal);
-      continue;
-    }
-    return;
-  }
+    assertNotStalled(result, signal, {
+      maxPages: opts.maxPages,
+      maxEmptyPolls: opts.maxEmptyPolls,
+      pages: result.pages
+    });
+  }, opts.signal);
 }
 
 // src/index-api/consumer.ts
@@ -1878,8 +1952,14 @@ function subscribeStreamsEvents(opts) {
   const baseDelayMs = opts.reconnectDelayMs ?? params.reconnectDelayMs ?? 1000;
   const staleAfterMs = opts.staleAfterMs ?? params.staleAfterMs ?? SUBSCRIBE_DEFAULT_STALE_AFTER_MS;
   let attempt = 0;
+  const emit = (state) => {
+    try {
+      params.onState?.(state);
+    } catch {}
+  };
   const run = async () => {
     while (!controller.signal.aborted) {
+      emit("connecting");
       try {
         const url = `${opts.baseUrl}/v1/streams/events/stream${buildQuery({
           chain: params.chain === "bitcoin" ? "bitcoin" : undefined,
@@ -1901,6 +1981,7 @@ function subscribeStreamsEvents(opts) {
           fetchImpl: opts.fetchImpl,
           staleAfterMs,
           mapError: mapStreamsError,
+          onOpen: () => emit("open"),
           onFrame: async (frame) => {
             attempt = 0;
             if (frame.event === "ping" || !frame.data)
@@ -1929,6 +2010,8 @@ function subscribeStreamsEvents(opts) {
             cursor = parsed.event.cursor ?? cursor;
           }
         });
+        if (!controller.signal.aborted)
+          emit("reconnecting");
         await sleep(reconnectDelay(attempt, baseDelayMs, undefined, opts.random), controller.signal);
         attempt += 1;
       } catch (err) {
@@ -1937,13 +2020,14 @@ function subscribeStreamsEvents(opts) {
         params.onError?.(err);
         if (isTerminal(err))
           throw err;
+        emit("reconnecting");
         const retryAfterSeconds = err.retryAfterSeconds;
         await sleep(reconnectDelay(attempt, baseDelayMs, retryAfterSeconds, opts.random), controller.signal);
         attempt += 1;
       }
     }
   };
-  const done = run();
+  const done = run().finally(() => emit("closed"));
   done.catch(() => {});
   const unsubscribe = () => controller.abort();
   return Object.assign(unsubscribe, { done });
@@ -1961,6 +2045,7 @@ async function readSse(opts) {
   if (!res.body) {
     throw new StreamsServerError("Streams SSE response has no body.", 0);
   }
+  opts.onOpen?.();
   for await (const frame of parseSseFrames(res.body, opts.signal, opts.staleAfterMs)) {
     await opts.onFrame(frame);
   }
@@ -2036,6 +2121,33 @@ function parseFrame(raw) {
 `) : undefined };
 }
 
+// src/streams/timeout-fetch.ts
+var STREAMS_CONNECT_TIMEOUT_MS = 30000;
+function withConnectTimeout(fetchImpl, timeoutMs) {
+  if (!(timeoutMs > 0) || !Number.isFinite(timeoutMs))
+    return fetchImpl;
+  return async (input, init) => {
+    const callerSignal = init?.signal ?? undefined;
+    const timeout = new AbortController;
+    let timedOut = false;
+    const timer = setTimeout(() => {
+      timedOut = true;
+      timeout.abort();
+    }, timeoutMs);
+    const signal = callerSignal ? AbortSignal.any([callerSignal, timeout.signal]) : timeout.signal;
+    try {
+      return await fetchImpl(input, { ...init, signal });
+    } catch (err) {
+      if (timedOut && !callerSignal?.aborted) {
+        throw new StreamsServerError(`No response headers within ${timeoutMs}ms. Retryable.`, 0, undefined, "REQUEST_TIMEOUT");
+      }
+      throw err;
+    } finally {
+      clearTimeout(timer);
+    }
+  };
+}
+
 // src/streams/client.ts
 function cursorTuple(cursor) {
   if (!cursor)
@@ -2081,7 +2193,7 @@ function createStreamsClient(options) {
     "x-sl-origin": origin,
     ...apiKey ? { Authorization: `Bearer ${apiKey}` } : {}
   });
-  const fetchImpl = options.fetchImpl ?? ((input, init) => fetch(input, init));
+  const fetchImpl = withConnectTimeout(options.fetchImpl ?? ((input, init) => fetch(input, init)), options.connectTimeoutMs ?? STREAMS_CONNECT_TIMEOUT_MS);
   const verify = options.verify;
   const verifyMode = verify === false ? "off" : verify === undefined ? "lenient" : "strict";
   if (verify === true && baseUrl.startsWith("http:") && !isLoopbackUrl(baseUrl)) {
@@ -2856,6 +2968,7 @@ import {
   SLOW_TIMEOUT_RATIO,
   SLOW_WINDOW
 } from "@secondlayer/shared/insights/thresholds";
+import { pauseReasonOf } from "@secondlayer/shared/webhooks/health";
 function isSuccessDelivery(row) {
   return row.statusCode !== null && row.statusCode >= 200 && row.statusCode < 300;
 }
@@ -3142,16 +3255,17 @@ function buildDoctorReport(input) {
   };
 }
 function buildListIssue(webhook) {
-  if (webhook.status !== "paused")
+  const reason = pauseReasonOf(webhook);
+  if (reason === null)
     return null;
-  if (webhook.circuitOpenedAt) {
+  if (reason === "circuit") {
     return {
       code: "circuit",
       severity: "bad",
       evidence: [
         {
           label: "circuit opened",
-          value: formatShortDate(webhook.circuitOpenedAt)
+          value: webhook.circuitOpenedAt ? formatShortDate(webhook.circuitOpenedAt) : "unknown"
         },
         {
           label: "last success",
@@ -3410,8 +3524,10 @@ export {
   isSuccessDelivery,
   parseRetryAfter,
   resolveAccountKey,
+  resolveAccountUrl,
   resolveApiKey,
   resolveBaseUrl,
+  resolveIdentity,
   shutdownSignal,
   toJsonSafe,
   trigger,
@@ -3421,5 +3537,5 @@ export {
   verifyWebhookSignature
 };
 
-//# debugId=F50384CF029DB60E64756E2164756E21
+//# debugId=7941E39982D460D764756E2164756E21
 //# sourceMappingURL=index.js.map