@secondlayer/shared 13.2.1 → 13.4.0

package/dist/src/index.d.ts

@@ -577,8 +577,26 @@ interface SubgraphHealthSnapshotsTable {
 	total_processed: number;
 	total_errors: number;
 	last_processed_block: number | null;
+	chain_tip: string | number | null;
+	rows_written_total: string | number | null;
+	storage_bytes: string | number | null;
 	captured_at: Generated<Date>;
 }
+/** Handler errors grouped by fingerprint. Cap 50/subgraph. */
+interface SubgraphErrorGroupsTable {
+	id: Generated<string>;
+	subgraph_name: string;
+	fingerprint: string;
+	source_name: string;
+	event_type: string | null;
+	message: string;
+	frame: string | null;
+	count: Generated<string | number>;
+	sample_tx_id: string | null;
+	sample_block_height: string | number | null;
+	first_seen: Generated<Date>;
+	last_seen: Generated<Date>;
+}
 interface ProcessedStripeEventsTable {
 	event_id: string;
 	event_type: string;
@@ -1055,6 +1073,7 @@ interface Database {
 	subgraph_processing_stats: SubgraphProcessingStatsTable;
 	subgraph_gaps: SubgraphGapsTable;
 	subgraph_violations: SubgraphViolationsTable;
+	subgraph_error_groups: SubgraphErrorGroupsTable;
 	subgraph_operations: SubgraphOperationsTable;
 	processed_stripe_events: ProcessedStripeEventsTable;
 	account_spend_caps: AccountSpendCapsTable;
@@ -1098,6 +1117,7 @@ interface Database {
 	waitlist_signups: WaitlistSignupsTable;
 	contact_requests: ContactRequestsTable;
 	api_failed_requests: ApiFailedRequestsTable;
+	api_request_log: ApiRequestLogTable;
 	feedback_tickets: FeedbackTicketsTable;
 }
 interface ServiceHeartbeatsTable {
@@ -1171,6 +1191,8 @@ interface UsageLedgerTable {
 	usd_micros: string | number | bigint;
 	debited: Generated<boolean>;
 	source: string;
+	/** API key behind a metered read; null for non-read units and older rows. */
+	api_key_id: string | null;
 	idempotency_key: string;
 	occurred_at: Generated<Date>;
 	recorded_at: Generated<Date>;
@@ -1269,6 +1291,9 @@ interface WebhooksTable {
 	last_delivery_at: Date | null;
 	last_success_at: Date | null;
 	last_error: string | null;
+	/** Receiver TLS leaf certificate expiry, from the emitter's periodic probe. */
+	receiver_cert_expires_at: Date | null;
+	receiver_cert_checked_at: Date | null;
 	created_at: Generated<Date>;
 	updated_at: Generated<Date>;
 }
@@ -1398,6 +1423,28 @@ interface ApiFailedRequestsTable {
 type ApiFailedRequest = Selectable<ApiFailedRequestsTable>;
 type InsertApiFailedRequest = Insertable<ApiFailedRequestsTable>;
 /**
+* 7-day hosted log of account-attributed Index/Streams reads. Query values
+* are stored only as hashes; never bodies, headers or tokens.
+*/
+interface ApiRequestLogTable {
+	id: Generated<string>;
+	request_id: string | null;
+	account_id: string;
+	api_key_id: string | null;
+	method: string;
+	path: string;
+	path_template: string;
+	params_hash: string | null;
+	cursor_hash: string | null;
+	page_size: number | null;
+	rows: number | null;
+	status: number;
+	duration_ms: number;
+	created_at: Generated<Date>;
+}
+type ApiRequestLogRow = Selectable<ApiRequestLogTable>;
+type InsertApiRequestLogRow = Insertable<ApiRequestLogTable>;
+/**
 * Hosted problem report. `attempted` is the server's own copy of the failed
 * request (never caller-supplied); `status` starts `new` until classified.
 */
@@ -2447,6 +2494,7 @@ declare const TABLE_TO_DB: {
 	subgraph_health_snapshots: string
 	subgraph_gaps: string
 	subgraph_violations: string
+	subgraph_error_groups: string
 	subgraph_processing_stats: string
 	account_credits: string
 	archive_fetches: string
@@ -2457,6 +2505,7 @@ declare const TABLE_TO_DB: {
 	waitlist_signups: string
 	contact_requests: string
 	api_failed_requests: string
+	api_request_log: string
 	feedback_tickets: string
 	service_heartbeats: string
 };
@@ -2900,6 +2949,9 @@ interface WebhookSummary {
 	*  summary so the list can show a failing receiver per row without a
 	*  per-row fetch. */
 	circuitFailures: number;
+	/** Owning product, derived from the name prefix (`MANAGED_NAME_PREFIXES`).
+	*  When non-null the API refuses to rename the webhook. */
+	managedBy: string | null;
 	createdAt: string;
 	updatedAt: string;
 }
@@ -2924,6 +2976,10 @@ interface WebhookDetail extends WebhookSummary {
 	timeoutMs: number;
 	concurrency: number;
 	lastError: string | null;
+	/** When the receiver's TLS certificate expires, from the periodic probe.
+	*  Null for http receivers, refused or unreachable hosts, and webhooks not
+	*  probed yet. */
+	receiverCertExpiresAt: string | null;
 	/** Set when this instance's chain-trigger
 	*  evaluator isn't running (`SUBGRAPH_SOURCE` != `streams-index`) — the
 	*  webhook will never fire until that's fixed. Null otherwise. Surfaced
@@ -3030,6 +3086,27 @@ declare function generateSubgraphAgentSchema(detail: SubgraphDetail, options?: S
 declare function generateSubgraphOpenApi(detail: SubgraphDetail, options?: SubgraphSpecOptions): Record<string, unknown>;
 declare function generateSubgraphMarkdown(detail: SubgraphDetail, options?: SubgraphSpecOptions): string;
 declare function generateSubgraphSpec(detail: SubgraphDetail, format: SubgraphSpecFormat, options?: SubgraphSpecOptions): Record<string, unknown> | SubgraphAgentSchema | string;
+interface HealthSnapshotPoint {
+	captured_at: Date | string;
+	chain_tip: string | number | null;
+	last_processed_block: string | number | null;
+	rows_written_total: string | number | null;
+	total_errors: string | number;
+	total_processed: string | number;
+}
+interface HealthHour {
+	hour: string;
+	lagBlocks: number | null;
+	rowsWritten: number;
+	errors: number;
+	eventsHandled: number;
+}
+/**
+* Bucket snapshots into the last `hours` UTC hours (oldest first, ending with
+* the hour containing `now`). The delta for an hour also spans the boundary
+* from the previous hour's last snapshot, so no growth falls between buckets.
+*/
+declare function bucketHourly(snapshots: HealthSnapshotPoint[], hours: number, now?: number): HealthHour[];
 /** The etch a `rune_etch` event created — everything a consumer needs to
 *  render a fresh rune without a second lookup, minus what the envelope
 *  already carries (`rune_id`). Mirrors 058's `RuneEntry` shape
@@ -3420,4 +3497,4 @@ declare function publicKeyPemFromPrivate(privateKeyPem: string): string;
 declare function ed25519KeyId(publicKeyPem: string): string;
 declare function signEd25519(payload: string, privateKey: KeyObject): string;
 declare function verifyEd25519(payload: string, signatureBase64: string, publicKey: KeyObject): boolean;
-export { Account, AccountBalanceAlerts, AccountBalanceAlertsTable, AccountCredits, AccountCreditsTable, AccountSpendCap, AccountSpendCapsTable, AccountsTable, ApiFailedRequest, ApiFailedRequestsTable, ApiKey, ApiKeysTable, ArchiveFetch, ArchiveFetchesTable, AuthenticationError, AuthorizationError, BILLING_PAUSED_PREFIX, Block, BlocksTable, BnsMarketplaceAction, BnsMarketplaceEventsTable, BnsNameEventTopic, BnsNameEventsTable, BnsNamesTable, BnsNamespaceEventStatus, BnsNamespaceEventsTable, BnsNamespacesTable, BurnBlockRewardSlotsTable, BurnBlockRewardsTable, CHAIN_TRIGGER_FIELDS, CHAIN_TRIGGER_TYPES, CODE_TO_STATUS, ChainApplyDeliveryOf, ChainApplyEnvelope, ChainApplyEnvelopeOf, ChainEventEnvelope, ChainFtBurnData, ChainFtMintData, ChainFtTransferData, ChainNftBurnData, ChainNftMintData, ChainNftTransferData, ChainPrintEventData, ChainReadCacheTable, ChainReorgOrphanedEntry, ChainReorgRollbackDelivery, ChainReorgRollbackEnvelope, ChainReorgsTable, ChainStxBurnData, ChainStxLockData, ChainStxMintData, ChainStxTransferData, ChainTestDelivery, ChainTxLevelEvent, ChainWebhookDelivery, ChainWebhookEnvelope, ContactRequest, ContactRequestsTable, Contract, ContractsTable, CoverageSegmentsTable, CreateWebhookRequest, CreateWebhookRequestSchema, CreateWebhookResponse, DB_TO_STREAMS_EVENT_TYPE, DECODED_EVENT_TYPES2 as DECODED_EVENT_TYPES, DEFAULT_BTC_CONFIRMATIONS, Database, DatabaseError, DbPlane, DbReadRow, DbSplitStatus, DeadLetterEventsTable, DeadRow, DecodedEventType2 as DecodedEventType, DecodedEventsTable, DecoderCheckpointsTable, DeliveryRow, DeploySubgraphRequest, DeploySubgraphRequestSchema, DeploySubgraphResponse, EMPTY_RANGE_EVENT_INDEX_SENTINEL, Env, ErrorCode, ErrorCodes, Event, EventsArchiveTable, EventsTable, FailureClass, FailureUnit, FeedbackTicket, FeedbackTicketsTable, ForbiddenError, IndexColumn, IndexColumnType, IndexPrimaryKey, IndexProgress, IndexProgressTable, InsertAccount, InsertAccountBalanceAlerts, InsertAccountCredits, InsertAccountSpendCap, InsertApiFailedRequest, InsertApiKey, InsertArchiveFetch, InsertBlock, InsertContactRequest, InsertContract, InsertEvent, InsertFeedbackTicket, InsertIndexProgress, InsertMagicLink, InsertMempoolTransaction, InsertSession, InsertStateWrite, InsertSubgraph, InsertSubgraphGap, InsertSubgraphHealthSnapshot, InsertSubgraphOperation, InsertTransaction, InsertUsageLedgerRow, InsertVmEvent, InsertWaitlistSignup, InsertWebhook, InsertWebhookDelivery, InsertWebhookOutbox, InstancesTable, KeyRotatedError, MagicLink, MagicLinksTable, MempoolTransaction, MempoolTransactionsTable, MigrationRole, NativeClock, NotFoundError, NumericAsText, ObserverJournalStatus, ObserverJournalTable, OutboxStatus, ParsedCreateWebhookRequest, ParsedReplayWebhookRequest, ParsedUpdateWebhookRequest, PaymentRequiredError, PendingForkBlocksTable, Pox4CallsTable, Pox4FunctionName, Pox5CycleSignersTable, Pox5CyclesTable, Pox5EventTopic, Pox5EventsTable, ProcessedStripeEventsTable, RUNE_EVENT_TYPES, RateLimitError, ReindexResponse, RepairMode, ReplayResult, ReplayWebhookRequest, ReplayWebhookRequestSchema, RetryState, RotateSecretResponse, RunStatus, RuneApplyDeliveryOf, RuneApplyEnvelope, RuneEventType, SOURCE_READ_COLUMNS, SOURCE_READ_PKS, SOURCE_READ_TYPES, STREAMS_DB_EVENT_TYPES, STREAMS_EVENT_TYPES, STREAMS_TO_DB_EVENT_TYPES, SbtcDepositEvent, SbtcEventTopic, SbtcEventsTable, SbtcSettlementsTable, SbtcTokenEventType, SbtcTokenEventsTable, SbtcWithdrawalEvent, SbtcWithdrawalSweptConfirmedEvent, SecondLayerError, SentinelAccount, SentinelAccountsTable, ServiceHeartbeatsTable, Session, SessionsTable, StageBlockReceiptsTable, StageFailuresTable, StageKind, StageRegistryTable, StageRunsTable, StateWrite, StateWritesArchiveTable, StateWritesTable, StreamsCursor, StreamsDbEventType, StreamsEventType, Subgraph, SubgraphAgentSchema, SubgraphAggregateParams, SubgraphAggregateResponse, SubgraphDetail, SubgraphGap, SubgraphGapEntry, SubgraphGapRange, SubgraphGapsResponse, SubgraphGapsTable, SubgraphHealthSnapshot, SubgraphHealthSnapshotsTable, SubgraphOperation, SubgraphOperationKind, SubgraphOperationStatus, SubgraphOperationsTable, SubgraphProcessingStatsTable, SubgraphQueryParams, SubgraphSpecFormat, SubgraphSpecOptions, SubgraphSummary, SubgraphSyncInfo, SubgraphVerification, SubgraphViolationsTable, SubgraphsTable, SyncScopesTable, TABLE_TO_DB, TenantSuspendedError, Transaction, TransactionsArchiveTable, TransactionsTable, TriggerEvaluatorState, TriggerEvaluatorStateTable, UpdateAccountBalanceAlerts, UpdateAccountCredits, UpdateAccountSpendCap, UpdateApiKey, UpdateArchiveFetch, UpdateBlock, UpdateContract, UpdateEvent, UpdateIndexProgress, UpdateSubgraph, UpdateSubgraphOperation, UpdateTransaction, UpdateUsageLedgerRow, UpdateVmEvent, UpdateWebhook, UpdateWebhookOutbox, UpdateWebhookRequest, UpdateWebhookRequestSchema, UsageLedgerRow, UsageLedgerTable, VM_EVENT_TYPES, VM_NODE_TO_STORED_TYPE2 as VM_NODE_TO_STORED_TYPE, VM_STORED_TO_NODE_TYPE, ValidationError, VersionConflictError, VmEvent, VmEventType, VmEventsArchiveTable, VmEventsTable, VmNodeEventType, WEBHOOK_FORMATS, WEBHOOK_STATUSES, Waitlist, WaitlistSignup, WaitlistSignupsTable, WaitlistsTable, Webhook, WebhookDeliveriesTable, WebhookDelivery, WebhookDetail, WebhookFormat, WebhookFormatSchema, WebhookKind, WebhookOutbox, WebhookOutboxTable, WebhookStatus, WebhookStatusSchema, WebhookSummary, WebhooksTable, applicationDatabaseUrl, assertDbSplit, billingPausedCode, blockEndCursor, closeDb, closeDbOrTimeout, committedHeight, compareStreamsCursor, exports_hmac as crypto, decodeStreamsCursor, describeDbUrl, exports_ed25519 as ed25519, encodeStreamsCursor, finalizedBurnHeight, formatWebhookSchemaErrors, generateSubgraphAgentSchema, generateSubgraphMarkdown, generateSubgraphOpenApi, generateSubgraphSpec, getDb, getDbSplitStatus, getEnv, getErrorMessage, getMigrationRole, getRawClient, getSourceDb, getTargetDb, isBnsDecoderEnabled, isEmptyRangeCursor, isPox4DecoderEnabled, isPox5DecoderEnabled, isSbtcDecoderEnabled, jsonb, logger, onChainPlane, onControlPlane, parseJsonb, resolveSourceUrl, resolveTargetUrl, setMigrationRole, sql };
+export { Account, AccountBalanceAlerts, AccountBalanceAlertsTable, AccountCredits, AccountCreditsTable, AccountSpendCap, AccountSpendCapsTable, AccountsTable, ApiFailedRequest, ApiFailedRequestsTable, ApiKey, ApiKeysTable, ApiRequestLogRow, ApiRequestLogTable, ArchiveFetch, ArchiveFetchesTable, AuthenticationError, AuthorizationError, BILLING_PAUSED_PREFIX, Block, BlocksTable, BnsMarketplaceAction, BnsMarketplaceEventsTable, BnsNameEventTopic, BnsNameEventsTable, BnsNamesTable, BnsNamespaceEventStatus, BnsNamespaceEventsTable, BnsNamespacesTable, BurnBlockRewardSlotsTable, BurnBlockRewardsTable, CHAIN_TRIGGER_FIELDS, CHAIN_TRIGGER_TYPES, CODE_TO_STATUS, ChainApplyDeliveryOf, ChainApplyEnvelope, ChainApplyEnvelopeOf, ChainEventEnvelope, ChainFtBurnData, ChainFtMintData, ChainFtTransferData, ChainNftBurnData, ChainNftMintData, ChainNftTransferData, ChainPrintEventData, ChainReadCacheTable, ChainReorgOrphanedEntry, ChainReorgRollbackDelivery, ChainReorgRollbackEnvelope, ChainReorgsTable, ChainStxBurnData, ChainStxLockData, ChainStxMintData, ChainStxTransferData, ChainTestDelivery, ChainTxLevelEvent, ChainWebhookDelivery, ChainWebhookEnvelope, ContactRequest, ContactRequestsTable, Contract, ContractsTable, CoverageSegmentsTable, CreateWebhookRequest, CreateWebhookRequestSchema, CreateWebhookResponse, DB_TO_STREAMS_EVENT_TYPE, DECODED_EVENT_TYPES2 as DECODED_EVENT_TYPES, DEFAULT_BTC_CONFIRMATIONS, Database, DatabaseError, DbPlane, DbReadRow, DbSplitStatus, DeadLetterEventsTable, DeadRow, DecodedEventType2 as DecodedEventType, DecodedEventsTable, DecoderCheckpointsTable, DeliveryRow, DeploySubgraphRequest, DeploySubgraphRequestSchema, DeploySubgraphResponse, EMPTY_RANGE_EVENT_INDEX_SENTINEL, Env, ErrorCode, ErrorCodes, Event, EventsArchiveTable, EventsTable, FailureClass, FailureUnit, FeedbackTicket, FeedbackTicketsTable, ForbiddenError, HealthHour, HealthSnapshotPoint, IndexColumn, IndexColumnType, IndexPrimaryKey, IndexProgress, IndexProgressTable, InsertAccount, InsertAccountBalanceAlerts, InsertAccountCredits, InsertAccountSpendCap, InsertApiFailedRequest, InsertApiKey, InsertApiRequestLogRow, InsertArchiveFetch, InsertBlock, InsertContactRequest, InsertContract, InsertEvent, InsertFeedbackTicket, InsertIndexProgress, InsertMagicLink, InsertMempoolTransaction, InsertSession, InsertStateWrite, InsertSubgraph, InsertSubgraphGap, InsertSubgraphHealthSnapshot, InsertSubgraphOperation, InsertTransaction, InsertUsageLedgerRow, InsertVmEvent, InsertWaitlistSignup, InsertWebhook, InsertWebhookDelivery, InsertWebhookOutbox, InstancesTable, KeyRotatedError, MagicLink, MagicLinksTable, MempoolTransaction, MempoolTransactionsTable, MigrationRole, NativeClock, NotFoundError, NumericAsText, ObserverJournalStatus, ObserverJournalTable, OutboxStatus, ParsedCreateWebhookRequest, ParsedReplayWebhookRequest, ParsedUpdateWebhookRequest, PaymentRequiredError, PendingForkBlocksTable, Pox4CallsTable, Pox4FunctionName, Pox5CycleSignersTable, Pox5CyclesTable, Pox5EventTopic, Pox5EventsTable, ProcessedStripeEventsTable, RUNE_EVENT_TYPES, RateLimitError, ReindexResponse, RepairMode, ReplayResult, ReplayWebhookRequest, ReplayWebhookRequestSchema, RetryState, RotateSecretResponse, RunStatus, RuneApplyDeliveryOf, RuneApplyEnvelope, RuneEventType, SOURCE_READ_COLUMNS, SOURCE_READ_PKS, SOURCE_READ_TYPES, STREAMS_DB_EVENT_TYPES, STREAMS_EVENT_TYPES, STREAMS_TO_DB_EVENT_TYPES, SbtcDepositEvent, SbtcEventTopic, SbtcEventsTable, SbtcSettlementsTable, SbtcTokenEventType, SbtcTokenEventsTable, SbtcWithdrawalEvent, SbtcWithdrawalSweptConfirmedEvent, SecondLayerError, SentinelAccount, SentinelAccountsTable, ServiceHeartbeatsTable, Session, SessionsTable, StageBlockReceiptsTable, StageFailuresTable, StageKind, StageRegistryTable, StageRunsTable, StateWrite, StateWritesArchiveTable, StateWritesTable, StreamsCursor, StreamsDbEventType, StreamsEventType, Subgraph, SubgraphAgentSchema, SubgraphAggregateParams, SubgraphAggregateResponse, SubgraphDetail, SubgraphErrorGroupsTable, SubgraphGap, SubgraphGapEntry, SubgraphGapRange, SubgraphGapsResponse, SubgraphGapsTable, SubgraphHealthSnapshot, SubgraphHealthSnapshotsTable, SubgraphOperation, SubgraphOperationKind, SubgraphOperationStatus, SubgraphOperationsTable, SubgraphProcessingStatsTable, SubgraphQueryParams, SubgraphSpecFormat, SubgraphSpecOptions, SubgraphSummary, SubgraphSyncInfo, SubgraphVerification, SubgraphViolationsTable, SubgraphsTable, SyncScopesTable, TABLE_TO_DB, TenantSuspendedError, Transaction, TransactionsArchiveTable, TransactionsTable, TriggerEvaluatorState, TriggerEvaluatorStateTable, UpdateAccountBalanceAlerts, UpdateAccountCredits, UpdateAccountSpendCap, UpdateApiKey, UpdateArchiveFetch, UpdateBlock, UpdateContract, UpdateEvent, UpdateIndexProgress, UpdateSubgraph, UpdateSubgraphOperation, UpdateTransaction, UpdateUsageLedgerRow, UpdateVmEvent, UpdateWebhook, UpdateWebhookOutbox, UpdateWebhookRequest, UpdateWebhookRequestSchema, UsageLedgerRow, UsageLedgerTable, VM_EVENT_TYPES, VM_NODE_TO_STORED_TYPE2 as VM_NODE_TO_STORED_TYPE, VM_STORED_TO_NODE_TYPE, ValidationError, VersionConflictError, VmEvent, VmEventType, VmEventsArchiveTable, VmEventsTable, VmNodeEventType, WEBHOOK_FORMATS, WEBHOOK_STATUSES, Waitlist, WaitlistSignup, WaitlistSignupsTable, WaitlistsTable, Webhook, WebhookDeliveriesTable, WebhookDelivery, WebhookDetail, WebhookFormat, WebhookFormatSchema, WebhookKind, WebhookOutbox, WebhookOutboxTable, WebhookStatus, WebhookStatusSchema, WebhookSummary, WebhooksTable, applicationDatabaseUrl, assertDbSplit, billingPausedCode, blockEndCursor, bucketHourly, closeDb, closeDbOrTimeout, committedHeight, compareStreamsCursor, exports_hmac as crypto, decodeStreamsCursor, describeDbUrl, exports_ed25519 as ed25519, encodeStreamsCursor, finalizedBurnHeight, formatWebhookSchemaErrors, generateSubgraphAgentSchema, generateSubgraphMarkdown, generateSubgraphOpenApi, generateSubgraphSpec, getDb, getDbSplitStatus, getEnv, getErrorMessage, getMigrationRole, getRawClient, getSourceDb, getTargetDb, isBnsDecoderEnabled, isEmptyRangeCursor, isPox4DecoderEnabled, isPox5DecoderEnabled, isSbtcDecoderEnabled, jsonb, logger, onChainPlane, onControlPlane, parseJsonb, resolveSourceUrl, resolveTargetUrl, setMigrationRole, sql };

package/dist/src/index.js

@@ -854,6 +854,7 @@ var TABLE_TO_DB = {
   subgraph_health_snapshots: "target",
   subgraph_gaps: "target",
   subgraph_violations: "target",
+  subgraph_error_groups: "target",
   subgraph_processing_stats: "target",
   account_credits: "target",
   archive_fetches: "target",
@@ -864,6 +865,7 @@ var TABLE_TO_DB = {
   waitlist_signups: "target",
   contact_requests: "target",
   api_failed_requests: "target",
+  api_request_log: "target",
   feedback_tickets: "target",
   service_heartbeats: "both"
 };
@@ -1308,6 +1310,16 @@ function timeoutMsField() {
 }
 var webhookUrl = z3.string().trim().min(1).refine((value) => value.startsWith("http://") || value.startsWith("https://"), "must be an http(s) URL");
 var name = z3.string().trim().min(1).max(128);
+var MANAGED_NAME_PREFIXES = {
+  "sentinel:": "Sentinel"
+};
+function managedByForName(name) {
+  for (const [prefix, owner] of Object.entries(MANAGED_NAME_PREFIXES)) {
+    if (name.startsWith(prefix))
+      return owner;
+  }
+  return null;
+}
 var WebhookStatusSchema = z3.enum(WEBHOOK_STATUSES);
 var WebhookFormatSchema = z3.enum(WEBHOOK_FORMATS);
 var CHAIN_TRIGGER_TYPES = [
@@ -1986,6 +1998,61 @@ function generateSubgraphSpec(detail, format, options = {}) {
     return generateSubgraphAgentSchema(detail, options);
   return generateSubgraphMarkdown(detail, options);
 }
+// src/subgraphs/health.ts
+var HOUR_MS = 3600000;
+function positiveDeltas(values) {
+  let total = 0;
+  let prev = null;
+  for (const value of values) {
+    if (value === null)
+      continue;
+    if (prev !== null && value > prev)
+      total += value - prev;
+    prev = value;
+  }
+  return total;
+}
+function toNumber(value) {
+  if (value === null)
+    return null;
+  const n = Number(value);
+  return Number.isFinite(n) ? n : null;
+}
+function bucketHourly(snapshots, hours, now = Date.now()) {
+  const sorted = snapshots.map((s) => ({ ...s, at: new Date(s.captured_at).getTime() })).sort((a, b) => a.at - b.at);
+  const currentHourStart = Math.floor(now / HOUR_MS) * HOUR_MS;
+  const out = [];
+  for (let i = hours - 1;i >= 0; i--) {
+    const start = currentHourStart - i * HOUR_MS;
+    const end = start + HOUR_MS;
+    const inHour = sorted.filter((s) => s.at >= start && s.at < end);
+    if (inHour.length === 0) {
+      out.push({
+        hour: new Date(start).toISOString(),
+        lagBlocks: null,
+        rowsWritten: 0,
+        errors: 0,
+        eventsHandled: 0
+      });
+      continue;
+    }
+    const before = sorted.filter((s) => s.at < start).at(-1);
+    const series = before ? [before, ...inHour] : inHour;
+    const lags = inHour.map((s) => {
+      const tip = toNumber(s.chain_tip);
+      const cursor = toNumber(s.last_processed_block);
+      return tip === null || cursor === null ? null : Math.max(0, tip - cursor);
+    }).filter((lag) => lag !== null);
+    out.push({
+      hour: new Date(start).toISOString(),
+      lagBlocks: lags.length > 0 ? Math.max(...lags) : null,
+      rowsWritten: positiveDeltas(series.map((s) => toNumber(s.rows_written_total))),
+      errors: positiveDeltas(series.map((s) => toNumber(s.total_errors))),
+      eventsHandled: positiveDeltas(series.map((s) => toNumber(s.total_processed)))
+    });
+  }
+  return out;
+}
 // src/crypto/hmac.ts
 var exports_hmac = {};
 __export(exports_hmac, {
@@ -2136,6 +2203,7 @@ export {
   assertDbSplit,
   billingPausedCode,
   blockEndCursor,
+  bucketHourly,
   closeDb,
   closeDbOrTimeout,
   committedHeight,
@@ -2175,5 +2243,5 @@ export {
   sql2 as sql
 };
 
-//# debugId=ED936767BF724EC464756E2164756E21
+//# debugId=E1550FF128BCB8A064756E2164756E21
 //# sourceMappingURL=index.js.map