@secondlayer/shared 6.24.0 → 6.26.0

package/dist/src/index.d.ts

@@ -977,6 +977,733 @@ declare const SOURCE_READ_COLUMNS: {
 	readonly events: readonly ["block_height", "data", "event_index", "tx_id", "type"]
 	readonly chain_reorgs: readonly ["detected_at"]
 };
+/** Portable column type for the Index read domain (a lean, ORM-agnostic vocab). */
+type IndexColumnType = "text" | "int" | "boolean" | "timestamp" | "jsonb";
+interface IndexColumn {
+	type: IndexColumnType;
+	/** SELECT type includes `| null`. Omitted = NOT NULL. */
+	nullable?: boolean;
+}
+declare const SOURCE_READ_TYPES: {
+	readonly blocks: {
+		readonly burn_block_hash: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly burn_block_height: {
+			readonly type: "int"
+		}
+		readonly canonical: {
+			readonly type: "boolean"
+		}
+		readonly hash: {
+			readonly type: "text"
+		}
+		readonly height: {
+			readonly type: "int"
+		}
+		readonly parent_hash: {
+			readonly type: "text"
+		}
+		readonly timestamp: {
+			readonly type: "int"
+		}
+	}
+	readonly decoded_events: {
+		readonly amount: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly asset_identifier: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly block_height: {
+			readonly type: "int"
+		}
+		readonly canonical: {
+			readonly type: "boolean"
+		}
+		readonly contract_id: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly cursor: {
+			readonly type: "text"
+		}
+		readonly event_index: {
+			readonly type: "int"
+		}
+		readonly event_type: {
+			readonly type: "text"
+		}
+		readonly memo: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly payload: {
+			readonly type: "jsonb"
+			readonly nullable: true
+		}
+		readonly recipient: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly sender: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly tx_id: {
+			readonly type: "text"
+		}
+		readonly tx_index: {
+			readonly type: "int"
+		}
+		readonly value: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+	}
+	readonly transactions: {
+		readonly block_height: {
+			readonly type: "int"
+		}
+		readonly contract_id: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly function_args: {
+			readonly type: "jsonb"
+			readonly nullable: true
+		}
+		readonly function_name: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly raw_result: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly raw_tx: {
+			readonly type: "text"
+		}
+		readonly sender: {
+			readonly type: "text"
+		}
+		readonly status: {
+			readonly type: "text"
+		}
+		readonly tx_id: {
+			readonly type: "text"
+		}
+		readonly tx_index: {
+			readonly type: "int"
+		}
+		readonly type: {
+			readonly type: "text"
+		}
+	}
+	readonly mempool_transactions: {
+		readonly contract_id: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly function_args: {
+			readonly type: "jsonb"
+			readonly nullable: true
+		}
+		readonly function_name: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly raw_tx: {
+			readonly type: "text"
+		}
+		readonly received_at: {
+			readonly type: "timestamp"
+		}
+		readonly sender: {
+			readonly type: "text"
+		}
+		readonly seq: {
+			readonly type: "text"
+		}
+		readonly tx_id: {
+			readonly type: "text"
+		}
+		readonly type: {
+			readonly type: "text"
+		}
+	}
+	readonly pox4_calls: {
+		readonly aggregated_amount_ustx: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly aggregated_signer_index: {
+			readonly type: "int"
+			readonly nullable: true
+		}
+		readonly amount_ustx: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly auth_allowed: {
+			readonly type: "boolean"
+			readonly nullable: true
+		}
+		readonly auth_id: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly auth_period: {
+			readonly type: "int"
+			readonly nullable: true
+		}
+		readonly auth_topic: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly block_height: {
+			readonly type: "int"
+		}
+		readonly block_time: {
+			readonly type: "timestamp"
+		}
+		readonly burn_block_height: {
+			readonly type: "int"
+		}
+		readonly caller: {
+			readonly type: "text"
+		}
+		readonly canonical: {
+			readonly type: "boolean"
+		}
+		readonly cursor: {
+			readonly type: "text"
+		}
+		readonly delegate_to: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly end_cycle: {
+			readonly type: "int"
+			readonly nullable: true
+		}
+		readonly function_name: {
+			readonly type: "text"
+		}
+		readonly lock_period: {
+			readonly type: "int"
+			readonly nullable: true
+		}
+		readonly max_amount: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly pox_addr_btc: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly pox_addr_hashbytes: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly pox_addr_version: {
+			readonly type: "int"
+			readonly nullable: true
+		}
+		readonly result_ok: {
+			readonly type: "boolean"
+		}
+		readonly reward_cycle: {
+			readonly type: "int"
+			readonly nullable: true
+		}
+		readonly signer_key: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly signer_signature: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly source_cursor: {
+			readonly type: "text"
+		}
+		readonly stacker: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly start_cycle: {
+			readonly type: "int"
+			readonly nullable: true
+		}
+		readonly tx_id: {
+			readonly type: "text"
+		}
+		readonly tx_index: {
+			readonly type: "int"
+		}
+	}
+	readonly sbtc_events: {
+		readonly amount: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly bitcoin_txid: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly block_height: {
+			readonly type: "int"
+		}
+		readonly block_time: {
+			readonly type: "timestamp"
+		}
+		readonly burn_hash: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly burn_height: {
+			readonly type: "int"
+			readonly nullable: true
+		}
+		readonly canonical: {
+			readonly type: "boolean"
+		}
+		readonly cursor: {
+			readonly type: "text"
+		}
+		readonly event_index: {
+			readonly type: "int"
+		}
+		readonly fee: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly governance_contract_type: {
+			readonly type: "int"
+			readonly nullable: true
+		}
+		readonly governance_new_contract: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly max_fee: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly output_index: {
+			readonly type: "int"
+			readonly nullable: true
+		}
+		readonly recipient_btc_hashbytes: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly recipient_btc_version: {
+			readonly type: "int"
+			readonly nullable: true
+		}
+		readonly request_id: {
+			readonly type: "int"
+			readonly nullable: true
+		}
+		readonly sender: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly signer_address: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly signer_aggregate_pubkey: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly signer_bitmap: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly signer_keys_count: {
+			readonly type: "int"
+			readonly nullable: true
+		}
+		readonly signer_threshold: {
+			readonly type: "int"
+			readonly nullable: true
+		}
+		readonly sweep_txid: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly topic: {
+			readonly type: "text"
+		}
+		readonly tx_id: {
+			readonly type: "text"
+		}
+		readonly tx_index: {
+			readonly type: "int"
+		}
+	}
+	readonly sbtc_token_events: {
+		readonly amount: {
+			readonly type: "text"
+		}
+		readonly block_height: {
+			readonly type: "int"
+		}
+		readonly block_time: {
+			readonly type: "timestamp"
+		}
+		readonly canonical: {
+			readonly type: "boolean"
+		}
+		readonly cursor: {
+			readonly type: "text"
+		}
+		readonly event_index: {
+			readonly type: "int"
+		}
+		readonly event_type: {
+			readonly type: "text"
+		}
+		readonly memo: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly recipient: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly sender: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly tx_id: {
+			readonly type: "text"
+		}
+		readonly tx_index: {
+			readonly type: "int"
+		}
+	}
+	readonly bns_name_events: {
+		readonly block_height: {
+			readonly type: "int"
+		}
+		readonly block_time: {
+			readonly type: "timestamp"
+		}
+		readonly bns_id: {
+			readonly type: "text"
+		}
+		readonly canonical: {
+			readonly type: "boolean"
+		}
+		readonly cursor: {
+			readonly type: "text"
+		}
+		readonly event_index: {
+			readonly type: "int"
+		}
+		readonly fqn: {
+			readonly type: "text"
+		}
+		readonly hashed_salted_fqn_preorder: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly imported_at: {
+			readonly type: "int"
+			readonly nullable: true
+		}
+		readonly name: {
+			readonly type: "text"
+		}
+		readonly namespace: {
+			readonly type: "text"
+		}
+		readonly owner: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly preordered_by: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly registered_at: {
+			readonly type: "int"
+			readonly nullable: true
+		}
+		readonly renewal_height: {
+			readonly type: "int"
+			readonly nullable: true
+		}
+		readonly stx_burn: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly topic: {
+			readonly type: "text"
+		}
+		readonly tx_id: {
+			readonly type: "text"
+		}
+		readonly tx_index: {
+			readonly type: "int"
+		}
+	}
+	readonly bns_namespace_events: {
+		readonly block_height: {
+			readonly type: "int"
+		}
+		readonly block_time: {
+			readonly type: "timestamp"
+		}
+		readonly canonical: {
+			readonly type: "boolean"
+		}
+		readonly cursor: {
+			readonly type: "text"
+		}
+		readonly event_index: {
+			readonly type: "int"
+		}
+		readonly launched_at: {
+			readonly type: "int"
+			readonly nullable: true
+		}
+		readonly lifetime: {
+			readonly type: "int"
+			readonly nullable: true
+		}
+		readonly manager: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly manager_frozen: {
+			readonly type: "boolean"
+			readonly nullable: true
+		}
+		readonly manager_transfers_disabled: {
+			readonly type: "boolean"
+			readonly nullable: true
+		}
+		readonly namespace: {
+			readonly type: "text"
+		}
+		readonly price_frozen: {
+			readonly type: "boolean"
+			readonly nullable: true
+		}
+		readonly price_function: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly revealed_at: {
+			readonly type: "int"
+			readonly nullable: true
+		}
+		readonly status: {
+			readonly type: "text"
+		}
+		readonly tx_id: {
+			readonly type: "text"
+		}
+		readonly tx_index: {
+			readonly type: "int"
+		}
+	}
+	readonly bns_marketplace_events: {
+		readonly action: {
+			readonly type: "text"
+		}
+		readonly block_height: {
+			readonly type: "int"
+		}
+		readonly block_time: {
+			readonly type: "timestamp"
+		}
+		readonly bns_id: {
+			readonly type: "text"
+		}
+		readonly canonical: {
+			readonly type: "boolean"
+		}
+		readonly commission: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly cursor: {
+			readonly type: "text"
+		}
+		readonly event_index: {
+			readonly type: "int"
+		}
+		readonly price_ustx: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly tx_id: {
+			readonly type: "text"
+		}
+		readonly tx_index: {
+			readonly type: "int"
+		}
+	}
+	readonly bns_names: {
+		readonly bns_id: {
+			readonly type: "text"
+		}
+		readonly fqn: {
+			readonly type: "text"
+		}
+		readonly last_event_at: {
+			readonly type: "timestamp"
+		}
+		readonly last_event_cursor: {
+			readonly type: "text"
+		}
+		readonly name: {
+			readonly type: "text"
+		}
+		readonly namespace: {
+			readonly type: "text"
+		}
+		readonly owner: {
+			readonly type: "text"
+		}
+		readonly registered_at: {
+			readonly type: "int"
+			readonly nullable: true
+		}
+		readonly renewal_height: {
+			readonly type: "int"
+			readonly nullable: true
+		}
+	}
+	readonly bns_namespaces: {
+		readonly last_event_at: {
+			readonly type: "timestamp"
+		}
+		readonly last_event_cursor: {
+			readonly type: "text"
+		}
+		readonly launched_at: {
+			readonly type: "int"
+			readonly nullable: true
+		}
+		readonly lifetime: {
+			readonly type: "int"
+			readonly nullable: true
+		}
+		readonly manager: {
+			readonly type: "text"
+			readonly nullable: true
+		}
+		readonly manager_frozen: {
+			readonly type: "boolean"
+		}
+		readonly name_count: {
+			readonly type: "int"
+		}
+		readonly namespace: {
+			readonly type: "text"
+		}
+		readonly price_frozen: {
+			readonly type: "boolean"
+		}
+	}
+	readonly burn_block_rewards: {
+		readonly amount_sats: {
+			readonly type: "text"
+		}
+		readonly burn_amount: {
+			readonly type: "text"
+		}
+		readonly burn_block_hash: {
+			readonly type: "text"
+		}
+		readonly burn_block_height: {
+			readonly type: "int"
+		}
+		readonly canonical: {
+			readonly type: "boolean"
+		}
+		readonly cursor: {
+			readonly type: "text"
+		}
+		readonly recipient_btc: {
+			readonly type: "text"
+		}
+		readonly reward_index: {
+			readonly type: "int"
+		}
+	}
+	readonly burn_block_reward_slots: {
+		readonly burn_block_hash: {
+			readonly type: "text"
+		}
+		readonly burn_block_height: {
+			readonly type: "int"
+		}
+		readonly canonical: {
+			readonly type: "boolean"
+		}
+		readonly cursor: {
+			readonly type: "text"
+		}
+		readonly holder_btc: {
+			readonly type: "text"
+		}
+		readonly slot_index: {
+			readonly type: "int"
+		}
+	}
+	readonly events: {
+		readonly block_height: {
+			readonly type: "int"
+		}
+		readonly data: {
+			readonly type: "jsonb"
+		}
+		readonly event_index: {
+			readonly type: "int"
+		}
+		readonly tx_id: {
+			readonly type: "text"
+		}
+		readonly type: {
+			readonly type: "text"
+		}
+	}
+	readonly chain_reorgs: {
+		readonly detected_at: {
+			readonly type: "timestamp"
+		}
+	}
+};
+type IndexPrimaryKey = readonly string[] | null;
+declare const SOURCE_READ_PKS: {
+	readonly blocks: readonly ["height"]
+	readonly decoded_events: readonly ["cursor"]
+	readonly transactions: readonly ["tx_id"]
+	readonly mempool_transactions: readonly ["seq"]
+	readonly pox4_calls: readonly ["cursor"]
+	readonly sbtc_events: readonly ["cursor"]
+	readonly sbtc_token_events: readonly ["cursor"]
+	readonly bns_name_events: readonly ["cursor"]
+	readonly bns_namespace_events: readonly ["cursor"]
+	readonly bns_marketplace_events: readonly ["cursor"]
+	readonly bns_names: readonly ["fqn"]
+	readonly bns_namespaces: readonly ["namespace"]
+	readonly burn_block_rewards: readonly ["cursor"]
+	readonly burn_block_reward_slots: readonly ["cursor"]
+	readonly events: readonly ["tx_id", "event_index"]
+	readonly chain_reorgs: null
+};
 /**
 * Per-migration DB-plane gating for the source/target split.
 *
@@ -1170,13 +1897,16 @@ type ErrorCode = (typeof ErrorCodes)[keyof typeof ErrorCodes];
 declare class SecondLayerError extends Error {
 	code: ErrorCode;
 	cause?: unknown;
-	constructor(code: ErrorCode, message: string, cause?: unknown);
+	/** Optional structured payload merged into the HTTP error body (machine-readable hints). */
+	details?: Record<string, unknown>;
+	constructor(code: ErrorCode, message: string, cause?: unknown, details?: Record<string, unknown>);
 	toJSON(): {
 		name: string
 		code: string
 		message: string
 		stack: string | undefined
 		cause: unknown
+		details: Record<string, unknown> | undefined
 	};
 }
 declare class NotFoundError extends SecondLayerError {
@@ -1192,7 +1922,7 @@ declare class AuthenticationError extends SecondLayerError {
 	constructor(message: string);
 }
 declare class AuthorizationError extends SecondLayerError {
-	constructor(message: string);
+	constructor(message: string, details?: Record<string, unknown>);
 }
 declare class RateLimitError extends SecondLayerError {
 	constructor(message: string);
@@ -1482,6 +2212,32 @@ interface SubgraphQueryParams {
 	fields?: string;
 	filters?: Record<string, string>;
 }
+/**
+* Request shape for `GET /api/subgraphs/:subgraphName/:tableName/aggregate`.
+* `filters` reuses the list/count where-surface; the rest name the columns to
+* aggregate. SUM/MIN/MAX columns must be numeric (uint/int, plus `_block_height`).
+*/
+interface SubgraphAggregateParams {
+	filters?: Record<string, string>;
+	count?: boolean;
+	countDistinct?: string[];
+	sum?: string[];
+	min?: string[];
+	max?: string[];
+}
+/**
+* Aggregate response. Keys are present only for requested aggregates.
+* `count`/`countDistinct` are JSON numbers (counts << 2^53); `sum`/`min`/`max`
+* are lossless strings (NUMERIC `::text`). `sum` of an empty set is `"0"`;
+* `min`/`max` are `null` when the filtered set is empty or all-null.
+*/
+interface SubgraphAggregateResponse {
+	count?: number;
+	countDistinct?: Record<string, number>;
+	sum?: Record<string, string>;
+	min?: Record<string, string | null>;
+	max?: Record<string, string | null>;
+}
 import { z as z4 } from "zod/v4";
 declare const SUBSCRIPTION_FORMATS: readonly ["standard-webhooks", "inngest", "trigger", "cloudflare", "cloudevents", "raw"];
 declare const SUBSCRIPTION_RUNTIMES: readonly ["inngest", "trigger", "cloudflare", "node"];
@@ -1852,4 +2608,41 @@ type StreamsCursor = {
 declare const EMPTY_RANGE_EVENT_INDEX_SENTINEL = 2147483647;
 declare function encodeStreamsCursor(cursor: StreamsCursor): string;
 declare function decodeStreamsCursor(cursor: string): StreamsCursor;
-export { validateSubscriptionFilterForTable, sql, setMigrationRole, parseJsonb, onControlPlane, onChainPlane, logger, jsonb, isPox4DecoderEnabled, getTargetDb, getSourceDb, getRawClientFor, getRawClient, getMigrationRole, getErrorMessage, getEnv, getDbSplitStatus, getDb, generateSubgraphSpec, generateSubgraphOpenApi, generateSubgraphMarkdown, generateSubgraphAgentSchema, formatSubscriptionSchemaErrors, finalizedBurnHeight, encodeStreamsCursor, exports_ed25519 as ed25519, decodeStreamsCursor, exports_hmac as crypto, closeDb, assertDbSplit, VersionConflictError, ValidationError, UsageSnapshotsTable, UsageSnapshot, UsageDailyTable, UsageDaily, UpdateTransaction, UpdateTenantUsageMonthly, UpdateTenantComputeAddon, UpdateTenant, UpdateSubscriptionRequestSchema, UpdateSubscriptionRequest, UpdateSubscriptionOutbox, UpdateSubscription, UpdateSubgraphOperation, UpdateSubgraph, UpdateProject, UpdateIndexProgress, UpdateEvent, UpdateContract, UpdateChatSession, UpdateBlock, UpdateApiKey, UpdateAccountSpendCap, TriggerEvaluatorStateTable, TriggerEvaluatorState, TransactionsTable, TransactionsArchiveTable, Transaction, TenantsTable, TenantUsageMonthlyTable, TenantUsageMonthly, TenantSuspendedError, TenantStatus, TenantComputeAddonsTable, TenantComputeAddon, Tenant, TeamMembersTable, TeamMember, TeamInvitationsTable, TeamInvitation, TABLE_TO_DB, SubscriptionsTable, SubscriptionSummary, SubscriptionStatusSchema, SubscriptionStatus, SubscriptionSchemaTables, SubscriptionSchemaTable, SubscriptionSchemaColumn, SubscriptionRuntimeSchema, SubscriptionRuntime, SubscriptionOutboxTable, SubscriptionOutbox, SubscriptionKind, SubscriptionFormatSchema, SubscriptionFormat, SubscriptionFilterSchema, SubscriptionFilterPrimitiveSchema, SubscriptionFilterPrimitive, SubscriptionFilterOperatorSchema, SubscriptionFilterOperator, SubscriptionFilterClauseSchema, SubscriptionFilterClause, SubscriptionFilter, SubscriptionDetail, SubscriptionDelivery, SubscriptionDeliveriesTable, Subscription, SubgraphsTable, SubgraphUsageDailyTable, SubgraphUsageDaily, SubgraphTableSnapshotsTable, SubgraphSyncInfo, SubgraphSummary, SubgraphSpecOptions, SubgraphSpecFormat, SubgraphResourceWarning, SubgraphQueryParams, SubgraphProcessingStatsTable, SubgraphOperationsTable, SubgraphOperationStatus, SubgraphOperationKind, SubgraphOperation, SubgraphHealthSnapshotsTable, SubgraphHealthSnapshot, SubgraphGapsTable, SubgraphGapsResponse, SubgraphGapRange, SubgraphGapEntry, SubgraphGap, SubgraphDetail, SubgraphAgentSchema, Subgraph, StxTransferFilterSchema, StxTransferFilter, StxMintFilterSchema, StxMintFilter, StxLockFilterSchema, StxLockFilter, StxBurnFilterSchema, StxBurnFilter, StreamsEventType, StreamsDbEventType, StreamsCursor, SessionsTable, Session, ServiceHeartbeatsTable, SecondLayerError, SbtcTokenEventsTable, SbtcTokenEventType, SbtcSupplySnapshotsTable, SbtcEventsTable, SbtcEventTopic, SUBSCRIPTION_STATUSES, SUBSCRIPTION_RUNTIMES, SUBSCRIPTION_FORMATS, SUBSCRIPTION_FILTER_OPERATORS, STREAMS_TO_DB_EVENT_TYPES, STREAMS_EVENT_TYPES, STREAMS_DB_EVENT_TYPES, SOURCE_READ_COLUMNS, RotateSecretResponse, ReplaySubscriptionRequestSchema, ReplaySubscriptionRequest, ReplayResult, ReindexResponse, RateLimitError, ProvisioningAuditStatus, ProvisioningAuditLogTable, ProvisioningAuditLog, ProvisioningAuditEvent, ProjectsTable, Project, ProcessedStripeEventsTable, PrintEventFilterSchema, PrintEventFilter, Pox4SignersDailyTable, Pox4FunctionName, Pox4CyclesDailyTable, Pox4CallsTable, ParsedUpdateSubscriptionRequest, ParsedReplaySubscriptionRequest, ParsedCreateSubscriptionRequest, OutboxStatus, NumericAsText, NotFoundError, NftTransferFilterSchema, NftTransferFilter, NftMintFilterSchema, NftMintFilter, NftBurnFilterSchema, NftBurnFilter, MigrationRole, MempoolTransactionsTable, MempoolTransaction, MagicLinksTable, MagicLink, L2DecoderCheckpointsTable, KeyRotatedError, InsertTransaction, InsertTenantUsageMonthly, InsertTenantComputeAddon, InsertTenant, InsertTeamMember, InsertTeamInvitation, InsertSubscriptionOutbox, InsertSubscriptionDelivery, InsertSubscription, InsertSubgraphUsageDaily, InsertSubgraphOperation, InsertSubgraphHealthSnapshot, InsertSubgraphGap, InsertSubgraph, InsertSession, InsertProvisioningAuditLog, InsertProject, InsertMempoolTransaction, InsertMagicLink, InsertIndexProgress, InsertEvent, InsertContract, InsertChatSession, InsertChatMessage, InsertBlock, InsertApiKey, InsertAccountSpendCap, InsertAccountInsight, InsertAccountAgentRun, InsertAccount, IndexProgressTable, IndexProgress, FtTransferFilterSchema, FtTransferFilter, FtMintFilterSchema, FtMintFilter, FtBurnFilterSchema, FtBurnFilter, ForbiddenError, EventsTable, EventsArchiveTable, EventFilterSchema, EventFilter, Event, ErrorCodes, ErrorCode, Env, EMPTY_RANGE_EVENT_INDEX_SENTINEL, DeploySubgraphResponse, DeploySubgraphRequestSchema, DeploySubgraphRequest, DeliveryRow, DecodedEventsTable, DecodedEventType, DeadRow, DeadLetterEventsTable, DbSplitStatus, DbReadRow, DbPlane, DatabaseError, Database, DEFAULT_BTC_CONFIRMATIONS, DECODED_EVENT_TYPES, DB_TO_STREAMS_EVENT_TYPE, CreateSubscriptionResponse, CreateSubscriptionRequestSchema, CreateSubscriptionRequest, ContractsTable, ContractDeployFilterSchema, ContractDeployFilter, ContractCallFilterSchema, ContractCallFilter, Contract, ChatSessionsTable, ChatSession, ChatMessagesTable, ChatMessage, ChainReorgsTable, CODE_TO_STATUS, CHAIN_TRIGGER_TYPES, BurnBlockRewardsTable, BurnBlockRewardSlotsTable, BnsNamespacesTable, BnsNamespaceEventsTable, BnsNamespaceEventStatus, BnsNamesTable, BnsNameEventsTable, BnsNameEventTopic, BnsMarketplaceEventsTable, BnsMarketplaceAction, BlocksTable, Block, AuthorizationError, AuthenticationError, ApiKeysTable, ApiKey, AccountsTable, AccountSpendCapsTable, AccountSpendCap, AccountInsightsTable, AccountInsight, AccountAgentRunsTable, AccountAgentRun, Account };
+/**
+* Delivered when a matched chain event lands in a canonical block
+* (`event_type: "chain.<trigger>.apply"`). Tx-level triggers (contract_call /
+* contract_deploy) carry the tx as `event`; event-level triggers carry the event.
+*/
+interface ChainApplyEnvelope {
+	action: "apply";
+	/** Canonical block hash this delivery is anchored to. */
+	block_hash: string;
+	block_height: number;
+	tx_id: string;
+	/** Always true — only canonical applies are delivered. */
+	canonical: true;
+	/** The chain-trigger type that matched. */
+	trigger: ChainTrigger["type"];
+	event: Record<string, unknown>;
+}
+/** One orphaned delivery recalled by a reorg rollback. */
+interface ChainReorgOrphanedEntry {
+	tx_id: string | null;
+	/** The event body from the original `apply` delivery. */
+	event: unknown;
+}
+/**
+* Delivered once per affected subscription on a reorg
+* (`event_type: "chain.reorg.rollback"`). Lists the previously-delivered applies
+* at or above `fork_point_height` that are now orphaned, so the consumer can undo
+* them precisely. `orphaned` is capped (currently 500); `truncated` flags overflow.
+*/
+interface ChainReorgRollbackEnvelope {
+	action: "rollback";
+	fork_point_height: number;
+	orphaned: ChainReorgOrphanedEntry[];
+	truncated: boolean;
+}
+/** Any chain-subscription webhook body. Discriminate on `action`. */
+type ChainWebhookEnvelope = ChainApplyEnvelope | ChainReorgRollbackEnvelope;
+export { validateSubscriptionFilterForTable, sql, setMigrationRole, parseJsonb, onControlPlane, onChainPlane, logger, jsonb, isPox4DecoderEnabled, getTargetDb, getSourceDb, getRawClientFor, getRawClient, getMigrationRole, getErrorMessage, getEnv, getDbSplitStatus, getDb, generateSubgraphSpec, generateSubgraphOpenApi, generateSubgraphMarkdown, generateSubgraphAgentSchema, formatSubscriptionSchemaErrors, finalizedBurnHeight, encodeStreamsCursor, exports_ed25519 as ed25519, decodeStreamsCursor, exports_hmac as crypto, closeDb, assertDbSplit, VersionConflictError, ValidationError, UsageSnapshotsTable, UsageSnapshot, UsageDailyTable, UsageDaily, UpdateTransaction, UpdateTenantUsageMonthly, UpdateTenantComputeAddon, UpdateTenant, UpdateSubscriptionRequestSchema, UpdateSubscriptionRequest, UpdateSubscriptionOutbox, UpdateSubscription, UpdateSubgraphOperation, UpdateSubgraph, UpdateProject, UpdateIndexProgress, UpdateEvent, UpdateContract, UpdateChatSession, UpdateBlock, UpdateApiKey, UpdateAccountSpendCap, TriggerEvaluatorStateTable, TriggerEvaluatorState, TransactionsTable, TransactionsArchiveTable, Transaction, TenantsTable, TenantUsageMonthlyTable, TenantUsageMonthly, TenantSuspendedError, TenantStatus, TenantComputeAddonsTable, TenantComputeAddon, Tenant, TeamMembersTable, TeamMember, TeamInvitationsTable, TeamInvitation, TABLE_TO_DB, SubscriptionsTable, SubscriptionSummary, SubscriptionStatusSchema, SubscriptionStatus, SubscriptionSchemaTables, SubscriptionSchemaTable, SubscriptionSchemaColumn, SubscriptionRuntimeSchema, SubscriptionRuntime, SubscriptionOutboxTable, SubscriptionOutbox, SubscriptionKind, SubscriptionFormatSchema, SubscriptionFormat, SubscriptionFilterSchema, SubscriptionFilterPrimitiveSchema, SubscriptionFilterPrimitive, SubscriptionFilterOperatorSchema, SubscriptionFilterOperator, SubscriptionFilterClauseSchema, SubscriptionFilterClause, SubscriptionFilter, SubscriptionDetail, SubscriptionDelivery, SubscriptionDeliveriesTable, Subscription, SubgraphsTable, SubgraphUsageDailyTable, SubgraphUsageDaily, SubgraphTableSnapshotsTable, SubgraphSyncInfo, SubgraphSummary, SubgraphSpecOptions, SubgraphSpecFormat, SubgraphResourceWarning, SubgraphQueryParams, SubgraphProcessingStatsTable, SubgraphOperationsTable, SubgraphOperationStatus, SubgraphOperationKind, SubgraphOperation, SubgraphHealthSnapshotsTable, SubgraphHealthSnapshot, SubgraphGapsTable, SubgraphGapsResponse, SubgraphGapRange, SubgraphGapEntry, SubgraphGap, SubgraphDetail, SubgraphAggregateResponse, SubgraphAggregateParams, SubgraphAgentSchema, Subgraph, StxTransferFilterSchema, StxTransferFilter, StxMintFilterSchema, StxMintFilter, StxLockFilterSchema, StxLockFilter, StxBurnFilterSchema, StxBurnFilter, StreamsEventType, StreamsDbEventType, StreamsCursor, SessionsTable, Session, ServiceHeartbeatsTable, SecondLayerError, SbtcTokenEventsTable, SbtcTokenEventType, SbtcSupplySnapshotsTable, SbtcEventsTable, SbtcEventTopic, SUBSCRIPTION_STATUSES, SUBSCRIPTION_RUNTIMES, SUBSCRIPTION_FORMATS, SUBSCRIPTION_FILTER_OPERATORS, STREAMS_TO_DB_EVENT_TYPES, STREAMS_EVENT_TYPES, STREAMS_DB_EVENT_TYPES, SOURCE_READ_TYPES, SOURCE_READ_PKS, SOURCE_READ_COLUMNS, RotateSecretResponse, ReplaySubscriptionRequestSchema, ReplaySubscriptionRequest, ReplayResult, ReindexResponse, RateLimitError, ProvisioningAuditStatus, ProvisioningAuditLogTable, ProvisioningAuditLog, ProvisioningAuditEvent, ProjectsTable, Project, ProcessedStripeEventsTable, PrintEventFilterSchema, PrintEventFilter, Pox4SignersDailyTable, Pox4FunctionName, Pox4CyclesDailyTable, Pox4CallsTable, ParsedUpdateSubscriptionRequest, ParsedReplaySubscriptionRequest, ParsedCreateSubscriptionRequest, OutboxStatus, NumericAsText, NotFoundError, NftTransferFilterSchema, NftTransferFilter, NftMintFilterSchema, NftMintFilter, NftBurnFilterSchema, NftBurnFilter, MigrationRole, MempoolTransactionsTable, MempoolTransaction, MagicLinksTable, MagicLink, L2DecoderCheckpointsTable, KeyRotatedError, InsertTransaction, InsertTenantUsageMonthly, InsertTenantComputeAddon, InsertTenant, InsertTeamMember, InsertTeamInvitation, InsertSubscriptionOutbox, InsertSubscriptionDelivery, InsertSubscription, InsertSubgraphUsageDaily, InsertSubgraphOperation, InsertSubgraphHealthSnapshot, InsertSubgraphGap, InsertSubgraph, InsertSession, InsertProvisioningAuditLog, InsertProject, InsertMempoolTransaction, InsertMagicLink, InsertIndexProgress, InsertEvent, InsertContract, InsertChatSession, InsertChatMessage, InsertBlock, InsertApiKey, InsertAccountSpendCap, InsertAccountInsight, InsertAccountAgentRun, InsertAccount, IndexProgressTable, IndexProgress, IndexPrimaryKey, IndexColumnType, IndexColumn, FtTransferFilterSchema, FtTransferFilter, FtMintFilterSchema, FtMintFilter, FtBurnFilterSchema, FtBurnFilter, ForbiddenError, EventsTable, EventsArchiveTable, EventFilterSchema, EventFilter, Event, ErrorCodes, ErrorCode, Env, EMPTY_RANGE_EVENT_INDEX_SENTINEL, DeploySubgraphResponse, DeploySubgraphRequestSchema, DeploySubgraphRequest, DeliveryRow, DecodedEventsTable, DecodedEventType, DeadRow, DeadLetterEventsTable, DbSplitStatus, DbReadRow, DbPlane, DatabaseError, Database, DEFAULT_BTC_CONFIRMATIONS, DECODED_EVENT_TYPES, DB_TO_STREAMS_EVENT_TYPE, CreateSubscriptionResponse, CreateSubscriptionRequestSchema, CreateSubscriptionRequest, ContractsTable, ContractDeployFilterSchema, ContractDeployFilter, ContractCallFilterSchema, ContractCallFilter, Contract, ChatSessionsTable, ChatSession, ChatMessagesTable, ChatMessage, ChainWebhookEnvelope, ChainReorgsTable, ChainReorgRollbackEnvelope, ChainReorgOrphanedEntry, ChainApplyEnvelope, CODE_TO_STATUS, CHAIN_TRIGGER_TYPES, BurnBlockRewardsTable, BurnBlockRewardSlotsTable, BnsNamespacesTable, BnsNamespaceEventsTable, BnsNamespaceEventStatus, BnsNamesTable, BnsNameEventsTable, BnsNameEventTopic, BnsMarketplaceEventsTable, BnsMarketplaceAction, BlocksTable, Block, AuthorizationError, AuthenticationError, ApiKeysTable, ApiKey, AccountsTable, AccountSpendCapsTable, AccountSpendCap, AccountInsightsTable, AccountInsight, AccountAgentRunsTable, AccountAgentRun, Account };